@agentskit/adapters 0.16.0 → 0.17.0

package/dist/cli/index.d.cts

@@ -1,7 +1,109 @@
-import { AdapterRequest, AdapterCapabilities, StreamChunk, TokenUsage, AdapterFactory } from '@agentskit/core';
+import { StreamChunk, AdapterRequest, AdapterCapabilities, TokenUsage, AdapterFactory } from '@agentskit/core';
+
+declare function parseCliJsonResponse(value: unknown): readonly StreamChunk[];
+
+/**
+ * Serializes an `AdapterRequest` as clearly labelled prompt blocks for
+ * agentic CLIs (Claude Code, Codex, ...) that read a natural-language prompt
+ * from stdin.
+ *
+ * The generic `createCliAdapter` default writes the raw `AdapterRequest` JSON
+ * to stdin, which is the right contract for a purpose-built CLI but is
+ * hostile to agentic CLIs: Claude Code, for example, treats a raw JSON blob
+ * containing `systemPrompt` as a prompt-injection attempt and refuses it.
+ * First-party manifests for those CLIs use this serializer instead; the
+ * Claude Code manifests go further and pass system instructions through
+ * `--append-system-prompt` (`claudeCodeRequestArgs`) with `serializeCliMessages`
+ * on stdin, because Claude Code also flags labelled `[system]`/`[tools]`
+ * blocks inside the user prompt.
+ *
+ * Output shape:
+ *
+ * ```text
+ * [system]
+ * ...system prompt...
+ *
+ * [tools]
+ * ...JSON list of tool definitions + response contract...
+ *
+ * [user]
+ * ...
+ *
+ * [assistant]
+ * ...
+ * ```
+ */
+declare function serializeCliPrompt(request: AdapterRequest, options?: SerializeCliPromptOptions): string;
+interface SerializeCliPromptOptions {
+    /** Include the `[system]` block and `system` messages. Default `true`. */
+    system?: boolean;
+    /** Include the `[tools]` block. Default `true`. */
+    tools?: boolean;
+}
+/**
+ * Conversation-only serializer for CLIs that take the system prompt through
+ * argv (see `buildCliSystemPrompt`). A single user message is written bare;
+ * multi-turn conversations use `[user]`/`[assistant]`/`[tool]` blocks.
+ */
+declare function serializeCliMessages(request: AdapterRequest): string;
+/**
+ * System instructions for a request: the system prompt plus, when tools are
+ * present, the tool list and the JSON tool-call contract. Returns `undefined`
+ * when the request carries neither. Intended for CLIs with a system-prompt
+ * flag; Claude Code treats the same text inside the user prompt as an
+ * injection attempt.
+ */
+declare function buildCliSystemPrompt(request: AdapterRequest): string | undefined;
+/** Extra `claude -p` argv: `--append-system-prompt` when the request has system instructions or tools. */
+declare function claudeCodeRequestArgs(request: AdapterRequest): readonly string[];
+
+/**
+ * Maps one `claude -p --output-format json` envelope to normalized stream
+ * chunks. Used by the `claude-code-json` manifest with `createJsonCliAdapter`.
+ *
+ * - `result` becomes a `text` chunk. When the result is itself a JSON object
+ *   following the `CliJsonResponse` shape (`text`, `reasoning`, `toolCalls`),
+ *   for instance because the prompt carried a `[tools]` block, it is parsed
+ *   with `parseCliJsonResponse` so tool calls surface as `tool_call` chunks.
+ * - `structured_output` (from `--json-schema`) is preferred over `result`
+ *   when it follows the same shape; otherwise it is emitted as JSON text.
+ * - `usage.input_tokens` (+ cache tokens) and `usage.output_tokens` become a
+ *   `usage` chunk; `session_id`, `total_cost_usd`, `duration_ms`, and
+ *   `num_turns` are attached as metadata on the last chunk.
+ * - `is_error: true` or a non-`success` subtype fails closed.
+ */
+declare function parseClaudeCodeJsonResponse(value: unknown): readonly StreamChunk[];
+/**
+ * Decodes Claude Code stdout before `parseClaudeCodeJsonResponse`. Claude
+ * Code prints a single JSON object, but a leading warning line or trailing
+ * whitespace is tolerated by taking the last complete JSON object.
+ */
+declare function parseClaudeCodeJsonOutput(stdout: string): unknown;
 
 type CliSecurityMode = 'review-safe' | 'trusted-local' | 'restricted-environment';
+/**
+ * Transport protocol of a CLI manifest. The protocol bounds what the adapter
+ * can return:
+ *
+ * | Protocol    | Emits                                          | Never emits                                  |
+ * | ----------- | ---------------------------------------------- | -------------------------------------------- |
+ * | `exec-text` | streamed `text`                                | `tool_call`, `reasoning`, structured output, usage |
+ * | `exec-json` | one parsed `text`/`reasoning`/`tool_call`/`usage` | streaming                                  |
+ * | `acp`       | streamed `text`/`reasoning`                    | tool calls (rejected), MCP, plugins, terminal |
+ *
+ * `CliCapabilitiesFor<P>` encodes the same table at the type level so that a
+ * manifest, or a `requiredCapabilities` request against it, cannot claim a
+ * capability its protocol cannot deliver.
+ */
 type CliProtocol = 'exec-text' | 'exec-json' | 'acp';
+/** Capability keys each protocol can legitimately declare or be asked for. */
+interface CliProtocolCapabilityKeys {
+    'exec-text': 'streaming' | 'nativeAuth';
+    'exec-json': 'structuredOutput' | 'reasoning' | 'nativeAuth';
+    acp: 'streaming' | 'structuredOutput' | 'reasoning' | 'nativeAuth';
+}
+/** The subset of `CliCapabilityRequirements` that protocol `P` supports. */
+type CliCapabilitiesFor<P extends CliProtocol> = Pick<CliCapabilityRequirements, CliProtocolCapabilityKeys[P]>;
 type CliTerminationReason = 'aborted' | 'timeout' | 'output-limit';
 interface CliCapabilityRequirements {
     streaming?: boolean;
@@ -93,21 +195,53 @@ interface AcpCliAdapterOptions extends CliProcessOptions {
     toPrompt?: (request: AdapterRequest) => string;
 }
 
-interface CliProviderManifest {
+/**
+ * A CLI provider manifest for protocol `P`. `capabilities` is restricted to
+ * `CliCapabilitiesFor<P>`, so an `exec-text` manifest cannot declare
+ * `structuredOutput` and a consumer cannot request `tools` from it: both are
+ * compile-time errors, mirroring the runtime `validateCliProviderManifest`.
+ */
+interface CliProviderManifestFor<P extends CliProtocol = CliProtocol> {
     id: string;
     name: string;
     command: string;
     args: readonly string[];
     diagnosticArgs: readonly string[];
-    protocol: CliProtocol;
+    protocol: P;
     protocolVersion?: 1;
-    capabilities: CliCapabilityRequirements;
+    capabilities: CliCapabilitiesFor<P>;
     supportedModes: readonly CliSecurityMode[];
     credentialEnv?: readonly string[];
     docsUrl?: string;
     versionPattern?: string;
+    /**
+     * Serializes the request written to the CLI's stdin. Agentic CLIs that read
+     * a natural-language prompt use `serializeCliPrompt`; omit it to write the
+     * raw `AdapterRequest` JSON.
+     */
+    serializeRequest?: CliAdapterOptions['serializeRequest'];
+    /**
+     * Extra per-request argv appended after `args` and `CliManifestOptions.args`,
+     * e.g. `--append-system-prompt` for Claude Code. Still spawned without a shell.
+     */
+    requestArgs?: (request: AdapterRequest) => readonly string[];
+    /** `exec-json` only: decodes raw stdout before `parse`. */
+    parseOutput?: CliJsonAdapterOptions['parseOutput'];
+    /** `exec-json` only: maps the decoded JSON value to stream chunks. */
+    parse?: CliJsonAdapterOptions['parse'];
 }
-interface CliManifestOptions {
+/** Discriminated by `protocol`; see `CliProviderManifestFor`. */
+type CliProviderManifest = CliProviderManifestFor<'exec-text'> | CliProviderManifestFor<'exec-json'> | CliProviderManifestFor<'acp'>;
+/** Protocol of each built-in manifest id, used to type `getCliProviderManifest`. */
+interface BuiltInCliManifestProtocols {
+    codex: 'exec-text';
+    'claude-code': 'exec-text';
+    'claude-code-json': 'exec-json';
+    grok: 'acp';
+    opencode: 'acp';
+}
+type BuiltInCliManifestId = keyof BuiltInCliManifestProtocols;
+interface CliManifestOptions<P extends CliProtocol = CliProtocol> {
     args?: readonly string[];
     mode?: CliSecurityMode;
     cwd?: string;
@@ -116,22 +250,23 @@ interface CliManifestOptions {
     maxOutputBytes?: number;
     killGraceMs?: number;
     onDiagnostic?: CliProcessOptions['onDiagnostic'];
-    requiredCapabilities?: CliCapabilityRequirements;
+    /** Only capabilities the manifest's protocol can deliver are accepted. */
+    requiredCapabilities?: CliCapabilitiesFor<P>;
 }
 declare function validateCliProviderManifest(manifest: unknown): asserts manifest is CliProviderManifest;
 declare function listCliProviderManifests(): CliProviderManifest[];
-declare function getCliProviderManifest(id: string): CliProviderManifest | undefined;
-declare function resolveCliManifest(manifest: CliProviderManifest, options?: CliManifestOptions): CliAdapterOptions;
-declare function diagnoseCliProviderManifest(manifest: CliProviderManifest, options?: Omit<CliManifestOptions, 'args'>): Promise<CliDiagnostic>;
+/** Built-in ids resolve to their protocol-specific manifest type; unknown ids to the union. */
+declare function getCliProviderManifest<Id extends string>(id: Id): (Id extends BuiltInCliManifestId ? CliProviderManifestFor<BuiltInCliManifestProtocols[Id]> : CliProviderManifest) | undefined;
+declare function resolveCliManifest<M extends CliProviderManifest>(manifest: M, options?: CliManifestOptions<M['protocol']>): CliJsonAdapterOptions;
+declare function diagnoseCliProviderManifest<M extends CliProviderManifest>(manifest: M, options?: Omit<CliManifestOptions<M['protocol']>, 'args'>): Promise<CliDiagnostic>;
 declare function manifestCapabilities(manifest: CliProviderManifest): AdapterCapabilities;
 
 declare function diagnoseCliProvider(options: CliProcessOptions & {
     diagnosticArgs?: readonly string[];
 }): Promise<CliDiagnostic>;
 
-declare function standardJsonParser(value: unknown): readonly StreamChunk[];
 declare function createCliAdapter(options: CliAdapterOptions): AdapterFactory;
 declare function createJsonCliAdapter(options: CliJsonAdapterOptions): AdapterFactory;
 declare function createAcpCliAdapter(options: AcpCliAdapterOptions): AdapterFactory;
 
-export { type AcpCliAdapterOptions, type AcpClientInfo, type CliAdapterOptions, type CliCapabilityRequirements, type CliDiagnostic, type CliJsonAdapterOptions, type CliJsonParser, type CliJsonResponse, type CliManifestOptions, type CliProcessOptions, type CliProtocol, type CliProviderManifest, type CliSecurityMode, type CliTerminationReason, type CliToolCall, createAcpCliAdapter, createCliAdapter, createJsonCliAdapter, diagnoseCliProvider, diagnoseCliProviderManifest, getCliProviderManifest, listCliProviderManifests, manifestCapabilities, standardJsonParser as parseCliJsonResponse, resolveCliManifest, validateCliProviderManifest };
+export { type AcpCliAdapterOptions, type AcpClientInfo, type BuiltInCliManifestId, type BuiltInCliManifestProtocols, type CliAdapterOptions, type CliCapabilitiesFor, type CliCapabilityRequirements, type CliDiagnostic, type CliJsonAdapterOptions, type CliJsonParser, type CliJsonResponse, type CliManifestOptions, type CliProcessOptions, type CliProtocol, type CliProtocolCapabilityKeys, type CliProviderManifest, type CliProviderManifestFor, type CliSecurityMode, type CliTerminationReason, type CliToolCall, type SerializeCliPromptOptions, buildCliSystemPrompt, claudeCodeRequestArgs, createAcpCliAdapter, createCliAdapter, createJsonCliAdapter, diagnoseCliProvider, diagnoseCliProviderManifest, getCliProviderManifest, listCliProviderManifests, manifestCapabilities, parseClaudeCodeJsonOutput, parseClaudeCodeJsonResponse, parseCliJsonResponse, resolveCliManifest, serializeCliMessages, serializeCliPrompt, validateCliProviderManifest };

package/dist/cli/index.d.ts

@@ -1,7 +1,109 @@
-import { AdapterRequest, AdapterCapabilities, StreamChunk, TokenUsage, AdapterFactory } from '@agentskit/core';
+import { StreamChunk, AdapterRequest, AdapterCapabilities, TokenUsage, AdapterFactory } from '@agentskit/core';
+
+declare function parseCliJsonResponse(value: unknown): readonly StreamChunk[];
+
+/**
+ * Serializes an `AdapterRequest` as clearly labelled prompt blocks for
+ * agentic CLIs (Claude Code, Codex, ...) that read a natural-language prompt
+ * from stdin.
+ *
+ * The generic `createCliAdapter` default writes the raw `AdapterRequest` JSON
+ * to stdin, which is the right contract for a purpose-built CLI but is
+ * hostile to agentic CLIs: Claude Code, for example, treats a raw JSON blob
+ * containing `systemPrompt` as a prompt-injection attempt and refuses it.
+ * First-party manifests for those CLIs use this serializer instead; the
+ * Claude Code manifests go further and pass system instructions through
+ * `--append-system-prompt` (`claudeCodeRequestArgs`) with `serializeCliMessages`
+ * on stdin, because Claude Code also flags labelled `[system]`/`[tools]`
+ * blocks inside the user prompt.
+ *
+ * Output shape:
+ *
+ * ```text
+ * [system]
+ * ...system prompt...
+ *
+ * [tools]
+ * ...JSON list of tool definitions + response contract...
+ *
+ * [user]
+ * ...
+ *
+ * [assistant]
+ * ...
+ * ```
+ */
+declare function serializeCliPrompt(request: AdapterRequest, options?: SerializeCliPromptOptions): string;
+interface SerializeCliPromptOptions {
+    /** Include the `[system]` block and `system` messages. Default `true`. */
+    system?: boolean;
+    /** Include the `[tools]` block. Default `true`. */
+    tools?: boolean;
+}
+/**
+ * Conversation-only serializer for CLIs that take the system prompt through
+ * argv (see `buildCliSystemPrompt`). A single user message is written bare;
+ * multi-turn conversations use `[user]`/`[assistant]`/`[tool]` blocks.
+ */
+declare function serializeCliMessages(request: AdapterRequest): string;
+/**
+ * System instructions for a request: the system prompt plus, when tools are
+ * present, the tool list and the JSON tool-call contract. Returns `undefined`
+ * when the request carries neither. Intended for CLIs with a system-prompt
+ * flag; Claude Code treats the same text inside the user prompt as an
+ * injection attempt.
+ */
+declare function buildCliSystemPrompt(request: AdapterRequest): string | undefined;
+/** Extra `claude -p` argv: `--append-system-prompt` when the request has system instructions or tools. */
+declare function claudeCodeRequestArgs(request: AdapterRequest): readonly string[];
+
+/**
+ * Maps one `claude -p --output-format json` envelope to normalized stream
+ * chunks. Used by the `claude-code-json` manifest with `createJsonCliAdapter`.
+ *
+ * - `result` becomes a `text` chunk. When the result is itself a JSON object
+ *   following the `CliJsonResponse` shape (`text`, `reasoning`, `toolCalls`),
+ *   for instance because the prompt carried a `[tools]` block, it is parsed
+ *   with `parseCliJsonResponse` so tool calls surface as `tool_call` chunks.
+ * - `structured_output` (from `--json-schema`) is preferred over `result`
+ *   when it follows the same shape; otherwise it is emitted as JSON text.
+ * - `usage.input_tokens` (+ cache tokens) and `usage.output_tokens` become a
+ *   `usage` chunk; `session_id`, `total_cost_usd`, `duration_ms`, and
+ *   `num_turns` are attached as metadata on the last chunk.
+ * - `is_error: true` or a non-`success` subtype fails closed.
+ */
+declare function parseClaudeCodeJsonResponse(value: unknown): readonly StreamChunk[];
+/**
+ * Decodes Claude Code stdout before `parseClaudeCodeJsonResponse`. Claude
+ * Code prints a single JSON object, but a leading warning line or trailing
+ * whitespace is tolerated by taking the last complete JSON object.
+ */
+declare function parseClaudeCodeJsonOutput(stdout: string): unknown;
 
 type CliSecurityMode = 'review-safe' | 'trusted-local' | 'restricted-environment';
+/**
+ * Transport protocol of a CLI manifest. The protocol bounds what the adapter
+ * can return:
+ *
+ * | Protocol    | Emits                                          | Never emits                                  |
+ * | ----------- | ---------------------------------------------- | -------------------------------------------- |
+ * | `exec-text` | streamed `text`                                | `tool_call`, `reasoning`, structured output, usage |
+ * | `exec-json` | one parsed `text`/`reasoning`/`tool_call`/`usage` | streaming                                  |
+ * | `acp`       | streamed `text`/`reasoning`                    | tool calls (rejected), MCP, plugins, terminal |
+ *
+ * `CliCapabilitiesFor<P>` encodes the same table at the type level so that a
+ * manifest, or a `requiredCapabilities` request against it, cannot claim a
+ * capability its protocol cannot deliver.
+ */
 type CliProtocol = 'exec-text' | 'exec-json' | 'acp';
+/** Capability keys each protocol can legitimately declare or be asked for. */
+interface CliProtocolCapabilityKeys {
+    'exec-text': 'streaming' | 'nativeAuth';
+    'exec-json': 'structuredOutput' | 'reasoning' | 'nativeAuth';
+    acp: 'streaming' | 'structuredOutput' | 'reasoning' | 'nativeAuth';
+}
+/** The subset of `CliCapabilityRequirements` that protocol `P` supports. */
+type CliCapabilitiesFor<P extends CliProtocol> = Pick<CliCapabilityRequirements, CliProtocolCapabilityKeys[P]>;
 type CliTerminationReason = 'aborted' | 'timeout' | 'output-limit';
 interface CliCapabilityRequirements {
     streaming?: boolean;
@@ -93,21 +195,53 @@ interface AcpCliAdapterOptions extends CliProcessOptions {
     toPrompt?: (request: AdapterRequest) => string;
 }
 
-interface CliProviderManifest {
+/**
+ * A CLI provider manifest for protocol `P`. `capabilities` is restricted to
+ * `CliCapabilitiesFor<P>`, so an `exec-text` manifest cannot declare
+ * `structuredOutput` and a consumer cannot request `tools` from it: both are
+ * compile-time errors, mirroring the runtime `validateCliProviderManifest`.
+ */
+interface CliProviderManifestFor<P extends CliProtocol = CliProtocol> {
     id: string;
     name: string;
     command: string;
     args: readonly string[];
     diagnosticArgs: readonly string[];
-    protocol: CliProtocol;
+    protocol: P;
     protocolVersion?: 1;
-    capabilities: CliCapabilityRequirements;
+    capabilities: CliCapabilitiesFor<P>;
     supportedModes: readonly CliSecurityMode[];
     credentialEnv?: readonly string[];
     docsUrl?: string;
     versionPattern?: string;
+    /**
+     * Serializes the request written to the CLI's stdin. Agentic CLIs that read
+     * a natural-language prompt use `serializeCliPrompt`; omit it to write the
+     * raw `AdapterRequest` JSON.
+     */
+    serializeRequest?: CliAdapterOptions['serializeRequest'];
+    /**
+     * Extra per-request argv appended after `args` and `CliManifestOptions.args`,
+     * e.g. `--append-system-prompt` for Claude Code. Still spawned without a shell.
+     */
+    requestArgs?: (request: AdapterRequest) => readonly string[];
+    /** `exec-json` only: decodes raw stdout before `parse`. */
+    parseOutput?: CliJsonAdapterOptions['parseOutput'];
+    /** `exec-json` only: maps the decoded JSON value to stream chunks. */
+    parse?: CliJsonAdapterOptions['parse'];
 }
-interface CliManifestOptions {
+/** Discriminated by `protocol`; see `CliProviderManifestFor`. */
+type CliProviderManifest = CliProviderManifestFor<'exec-text'> | CliProviderManifestFor<'exec-json'> | CliProviderManifestFor<'acp'>;
+/** Protocol of each built-in manifest id, used to type `getCliProviderManifest`. */
+interface BuiltInCliManifestProtocols {
+    codex: 'exec-text';
+    'claude-code': 'exec-text';
+    'claude-code-json': 'exec-json';
+    grok: 'acp';
+    opencode: 'acp';
+}
+type BuiltInCliManifestId = keyof BuiltInCliManifestProtocols;
+interface CliManifestOptions<P extends CliProtocol = CliProtocol> {
     args?: readonly string[];
     mode?: CliSecurityMode;
     cwd?: string;
@@ -116,22 +250,23 @@ interface CliManifestOptions {
     maxOutputBytes?: number;
     killGraceMs?: number;
     onDiagnostic?: CliProcessOptions['onDiagnostic'];
-    requiredCapabilities?: CliCapabilityRequirements;
+    /** Only capabilities the manifest's protocol can deliver are accepted. */
+    requiredCapabilities?: CliCapabilitiesFor<P>;
 }
 declare function validateCliProviderManifest(manifest: unknown): asserts manifest is CliProviderManifest;
 declare function listCliProviderManifests(): CliProviderManifest[];
-declare function getCliProviderManifest(id: string): CliProviderManifest | undefined;
-declare function resolveCliManifest(manifest: CliProviderManifest, options?: CliManifestOptions): CliAdapterOptions;
-declare function diagnoseCliProviderManifest(manifest: CliProviderManifest, options?: Omit<CliManifestOptions, 'args'>): Promise<CliDiagnostic>;
+/** Built-in ids resolve to their protocol-specific manifest type; unknown ids to the union. */
+declare function getCliProviderManifest<Id extends string>(id: Id): (Id extends BuiltInCliManifestId ? CliProviderManifestFor<BuiltInCliManifestProtocols[Id]> : CliProviderManifest) | undefined;
+declare function resolveCliManifest<M extends CliProviderManifest>(manifest: M, options?: CliManifestOptions<M['protocol']>): CliJsonAdapterOptions;
+declare function diagnoseCliProviderManifest<M extends CliProviderManifest>(manifest: M, options?: Omit<CliManifestOptions<M['protocol']>, 'args'>): Promise<CliDiagnostic>;
 declare function manifestCapabilities(manifest: CliProviderManifest): AdapterCapabilities;
 
 declare function diagnoseCliProvider(options: CliProcessOptions & {
     diagnosticArgs?: readonly string[];
 }): Promise<CliDiagnostic>;
 
-declare function standardJsonParser(value: unknown): readonly StreamChunk[];
 declare function createCliAdapter(options: CliAdapterOptions): AdapterFactory;
 declare function createJsonCliAdapter(options: CliJsonAdapterOptions): AdapterFactory;
 declare function createAcpCliAdapter(options: AcpCliAdapterOptions): AdapterFactory;
 
-export { type AcpCliAdapterOptions, type AcpClientInfo, type CliAdapterOptions, type CliCapabilityRequirements, type CliDiagnostic, type CliJsonAdapterOptions, type CliJsonParser, type CliJsonResponse, type CliManifestOptions, type CliProcessOptions, type CliProtocol, type CliProviderManifest, type CliSecurityMode, type CliTerminationReason, type CliToolCall, createAcpCliAdapter, createCliAdapter, createJsonCliAdapter, diagnoseCliProvider, diagnoseCliProviderManifest, getCliProviderManifest, listCliProviderManifests, manifestCapabilities, standardJsonParser as parseCliJsonResponse, resolveCliManifest, validateCliProviderManifest };
+export { type AcpCliAdapterOptions, type AcpClientInfo, type BuiltInCliManifestId, type BuiltInCliManifestProtocols, type CliAdapterOptions, type CliCapabilitiesFor, type CliCapabilityRequirements, type CliDiagnostic, type CliJsonAdapterOptions, type CliJsonParser, type CliJsonResponse, type CliManifestOptions, type CliProcessOptions, type CliProtocol, type CliProtocolCapabilityKeys, type CliProviderManifest, type CliProviderManifestFor, type CliSecurityMode, type CliTerminationReason, type CliToolCall, type SerializeCliPromptOptions, buildCliSystemPrompt, claudeCodeRequestArgs, createAcpCliAdapter, createCliAdapter, createJsonCliAdapter, diagnoseCliProvider, diagnoseCliProviderManifest, getCliProviderManifest, listCliProviderManifests, manifestCapabilities, parseClaudeCodeJsonOutput, parseClaudeCodeJsonResponse, parseCliJsonResponse, resolveCliManifest, serializeCliMessages, serializeCliPrompt, validateCliProviderManifest };