a3292fb545
New runtime plugin registering runtimeId 'acp', mirroring the fusion-plugin-droid-runtime shape. Adds @agentclientprotocol/sdk@0.24.0 and an SDK smoke-import test that gates on the load-bearing exports (ClientSideConnection, ndJsonStream, PROTOCOL_VERSION=1) so a breaking SDK change surfaces at U1. Runtime adapter is a contract-conforming skeleton (incl. describeModel); session driving lands in U2/U3. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
51 lines
2.1 KiB
TypeScript
51 lines
2.1 KiB
TypeScript
// Resolves the ACP agent launch configuration from plugin settings.
|
|
//
|
|
// Unlike the Claude/Droid CLIs (one fixed binary per plugin), ACP is a protocol:
|
|
// the user points this runtime at *any* ACP-compatible agent binary plus the
|
|
// flag that puts it in ACP mode (e.g. `gemini --acp`). Settings therefore carry
|
|
// an arbitrary binary + args, plus the conservative-by-default fs capability
|
|
// toggles (KTD6: writes default OFF) and an env allow-list (KTD6b).
|
|
|
|
export interface AcpCliSettings {
|
|
/** Agent binary to spawn (e.g. "gemini", "npx", an absolute path). */
|
|
binaryPath: string;
|
|
/** Arguments that launch the agent in ACP/stdio mode (e.g. ["--acp"]). */
|
|
args: string[];
|
|
/** Optional model identifier reported via describeModel. */
|
|
model?: string;
|
|
/** Advertise `fs/read_text_file` capability. Default: false (opt-in). */
|
|
fsRead: boolean;
|
|
/** Advertise `fs/write_text_file` capability. Default: false (opt-in, KTD6). */
|
|
fsWrite: boolean;
|
|
/**
|
|
* Environment variables to forward to the agent subprocess (KTD6b allow-list).
|
|
* The agent is untrusted; inherited `process.env` is NOT forwarded. Empty by
|
|
* default — callers opt specific vars in by name.
|
|
*/
|
|
envAllowList: string[];
|
|
}
|
|
|
|
function asTrimmedString(value: unknown): string | undefined {
|
|
return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
|
|
}
|
|
|
|
function asStringArray(value: unknown): string[] | undefined {
|
|
if (!Array.isArray(value)) return undefined;
|
|
const out = value.filter((v): v is string => typeof v === "string");
|
|
return out.length === value.length ? out : undefined;
|
|
}
|
|
|
|
function asBool(value: unknown): boolean {
|
|
return value === true;
|
|
}
|
|
|
|
export function resolveCliSettings(settings?: Record<string, unknown>): AcpCliSettings {
|
|
const binaryPath = asTrimmedString(settings?.acpBinaryPath) ?? "acp-agent";
|
|
const args = asStringArray(settings?.acpArgs) ?? [];
|
|
const model = asTrimmedString(settings?.acpModel);
|
|
const fsRead = asBool(settings?.acpFsRead);
|
|
const fsWrite = asBool(settings?.acpFsWrite);
|
|
const envAllowList = asStringArray(settings?.acpEnvAllowList) ?? [];
|
|
return { binaryPath, args, model, fsRead, fsWrite, envAllowList };
|
|
}
|