@agentproto/acp 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agentproto contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chunk-5KZCEMZW.mjs

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/acp v0.1.0-alpha
+ * AIP-44 ACP.md `defineAcp` reference implementation.
+ */
+
+var ID_PATTERN = /^[a-z0-9][a-z0-9-]{1,63}$/;
+var SEMVER_PATTERN = /^\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/;
+var TAG_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
+var ACP_REV_PATTERN = /^[a-f0-9]{7,40}$/;
+var transportSchema = z.enum(["stdio", "websocket"]);
+var capabilitiesSchema = z.object({
+  client: z.object({
+    fs: z.object({
+      readTextFile: z.boolean().optional(),
+      writeTextFile: z.boolean().optional()
+    }).strict().optional(),
+    terminal: z.boolean().optional()
+  }).strict().optional(),
+  agent: z.object({
+    loadSession: z.boolean().optional(),
+    promptCapabilities: z.object({
+      image: z.boolean().optional(),
+      audio: z.boolean().optional(),
+      embeddedContext: z.boolean().optional()
+    }).strict().optional(),
+    mcpCapabilities: z.object({
+      http: z.boolean().optional(),
+      sse: z.boolean().optional()
+    }).strict().optional()
+  }).strict().optional()
+}).strict().describe(
+  "Mirror of upstream ACP `initialize` capabilities. Omitted keys MUST be treated as unsupported."
+);
+var aip44ExtensionsSchema = z.object({
+  acp_rev: z.string().regex(ACP_REV_PATTERN).describe(
+    "Commit SHA of agentclientprotocol/agent-client-protocol this manifest validates against."
+  ),
+  tier: z.enum(["basic", "governance-aware", "sandboxed"]).describe(
+    "Capability tier shorthand. basic = session/{new,prompt,update}; governance-aware = + loadSession + tool-call streaming; sandboxed = + mcpCapabilities + sandbox profile."
+  ),
+  capabilities: capabilitiesSchema.optional(),
+  operator: z.string().min(1).optional().describe(
+    "Workspace-relative ref to AIP-9 OPERATOR.md. REQUIRED when kind=server (cross-field rule in define-acp)."
+  ),
+  governance: z.string().min(1).optional(),
+  sandbox: z.string().min(1).optional().describe("Ref to AIP-36 SANDBOX.md. REQUIRED when tier=sandboxed."),
+  audit: z.object({
+    ref: z.string().optional(),
+    kind: z.enum(["governance", "external", "off"]).optional()
+  }).strict().optional(),
+  mcp_servers: z.array(
+    z.object({
+      name: z.string().min(1),
+      transport: z.enum(["stdio", "http", "sse"]),
+      ref: z.string().optional()
+    }).strict()
+  ).optional()
+}).loose();
+var acpFrontmatterSchema = z.object({
+  name: z.string().min(1).max(80).describe("Kebab id; MUST equal the parent directory name."),
+  id: z.string().regex(ID_PATTERN),
+  description: z.string().min(1).max(2e3),
+  version: z.string().regex(SEMVER_PATTERN),
+  kind: z.enum(["client", "server", "bridge"]),
+  transport: z.union([
+    transportSchema,
+    z.array(transportSchema).min(1)
+  ]),
+  metadata: z.object({ aip44: aip44ExtensionsSchema }).loose().describe(
+    "Free-form metadata. metadata.aip44.* hosts AIP-44 extensions; upstream ACP runtimes preserve unknown keys verbatim."
+  ),
+  tags: z.array(z.string().regex(TAG_PATTERN)).optional()
+}).loose().describe(
+  "Validates the YAML frontmatter portion of an AIP-44 ACP.md manifest."
+);
+var defineAcp = createDoctype({
+  aip: 44,
+  name: "acp",
+  readIdentity: (def) => def.id,
+  validate(def) {
+    const result = acpFrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `defineAcp (AIP-44): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+    const aip44 = result.data.metadata.aip44;
+    if (result.data.kind === "server" && !aip44.operator) {
+      throw new Error(
+        "defineAcp (AIP-44): metadata.aip44.operator is required when kind=server"
+      );
+    }
+    if (aip44.tier === "sandboxed" && !aip44.sandbox) {
+      throw new Error(
+        "defineAcp (AIP-44): metadata.aip44.sandbox is required when metadata.aip44.tier=sandboxed"
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+export { acpFrontmatterSchema, defineAcp };
+//# sourceMappingURL=chunk-5KZCEMZW.mjs.map
+//# sourceMappingURL=chunk-5KZCEMZW.mjs.map

package/dist/chunk-5KZCEMZW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-acp.ts"],"names":[],"mappings":"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","file":"chunk-5KZCEMZW.mjs","sourcesContent":["/**\n * AIP-44 ACP.md frontmatter zod schema.\n *\n * Mirrors `resources/aip-44/draft/ACP.schema.json` field-for-field.\n * AIP-44 is an agentproto profile of the upstream Agent Client\n * Protocol (agentclientprotocol.com) — the manifest declares an\n * agent or client's role/transport/conformance level, and AIP-44-\n * specific bindings live under `metadata.aip44.*` so plain ACP\n * runtimes preserve them verbatim.\n *\n * Both authoring paths (`define-acp.ts` for TS-authored manifests\n * and `manifest/index.ts` for ACP.md parsing) validate against this\n * schema, so every field-level constraint runs in both paths from a\n * single source of truth.\n *\n * Cross-field rules (tier=sandboxed ⇒ sandbox required) live in\n * `define-acp.ts`'s `validate(def)` body — they're harder to encode\n * in a flat zod schema and want a single error path.\n */\n\nimport { z } from \"zod\"\n\nconst ID_PATTERN = /^[a-z0-9][a-z0-9-]{1,63}$/\nconst SEMVER_PATTERN = /^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.-]+)?$/\nconst TAG_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/\nconst ACP_REV_PATTERN = /^[a-f0-9]{7,40}$/\n\nconst transportSchema = z.enum([\"stdio\", \"websocket\"])\n\nconst capabilitiesSchema = z\n  .object({\n    client: z\n      .object({\n        fs: z\n          .object({\n            readTextFile: z.boolean().optional(),\n            writeTextFile: z.boolean().optional(),\n          })\n          .strict()\n          .optional(),\n        terminal: z.boolean().optional(),\n      })\n      .strict()\n      .optional(),\n    agent: z\n      .object({\n        loadSession: z.boolean().optional(),\n        promptCapabilities: z\n          .object({\n            image: z.boolean().optional(),\n            audio: z.boolean().optional(),\n            embeddedContext: z.boolean().optional(),\n          })\n          .strict()\n          .optional(),\n        mcpCapabilities: z\n          .object({\n            http: z.boolean().optional(),\n            sse: z.boolean().optional(),\n          })\n          .strict()\n          .optional(),\n      })\n      .strict()\n      .optional(),\n  })\n  .strict()\n  .describe(\n    \"Mirror of upstream ACP `initialize` capabilities. Omitted keys MUST be treated as unsupported.\",\n  )\n\nconst aip44ExtensionsSchema = z\n  .object({\n    acp_rev: z\n      .string()\n      .regex(ACP_REV_PATTERN)\n      .describe(\n        \"Commit SHA of agentclientprotocol/agent-client-protocol this manifest validates against.\",\n      ),\n    tier: z\n      .enum([\"basic\", \"governance-aware\", \"sandboxed\"])\n      .describe(\n        \"Capability tier shorthand. basic = session/{new,prompt,update}; governance-aware = + loadSession + tool-call streaming; sandboxed = + mcpCapabilities + sandbox profile.\",\n      ),\n    capabilities: capabilitiesSchema.optional(),\n    operator: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\n        \"Workspace-relative ref to AIP-9 OPERATOR.md. REQUIRED when kind=server (cross-field rule in define-acp).\",\n      ),\n    governance: z.string().min(1).optional(),\n    sandbox: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Ref to AIP-36 SANDBOX.md. REQUIRED when tier=sandboxed.\"),\n    audit: z\n      .object({\n        ref: z.string().optional(),\n        kind: z.enum([\"governance\", \"external\", \"off\"]).optional(),\n      })\n      .strict()\n      .optional(),\n    mcp_servers: z\n      .array(\n        z\n          .object({\n            name: z.string().min(1),\n            transport: z.enum([\"stdio\", \"http\", \"sse\"]),\n            ref: z.string().optional(),\n          })\n          .strict(),\n      )\n      .optional(),\n  })\n  .loose()\n\nexport const acpFrontmatterSchema = z\n  .object({\n    name: z\n      .string()\n      .min(1)\n      .max(80)\n      .describe(\"Kebab id; MUST equal the parent directory name.\"),\n    id: z.string().regex(ID_PATTERN),\n    description: z.string().min(1).max(2000),\n    version: z.string().regex(SEMVER_PATTERN),\n    kind: z.enum([\"client\", \"server\", \"bridge\"]),\n    transport: z.union([\n      transportSchema,\n      z.array(transportSchema).min(1),\n    ]),\n    metadata: z\n      .object({ aip44: aip44ExtensionsSchema })\n      .loose()\n      .describe(\n        \"Free-form metadata. metadata.aip44.* hosts AIP-44 extensions; upstream ACP runtimes preserve unknown keys verbatim.\",\n      ),\n    tags: z.array(z.string().regex(TAG_PATTERN)).optional(),\n  })\n  .loose()\n  .describe(\n    \"Validates the YAML frontmatter portion of an AIP-44 ACP.md manifest.\",\n  )\n\nexport type AcpFrontmatter = z.infer<typeof acpFrontmatterSchema>\nexport type Aip44Extensions = z.infer<typeof aip44ExtensionsSchema>\nexport type AcpCapabilities = z.infer<typeof capabilitiesSchema>\nexport type AcpRole = AcpFrontmatter[\"kind\"]\nexport type AcpTransport = z.infer<typeof transportSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { acpFrontmatterSchema } from \"./schema.js\"\nimport type { AcpDefinition, AcpHandle } from \"./types.js\"\n\n/**\n * AIP-44 reference implementation of `defineAcp`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"defineAcp (AIP-44): …\"\n * error prefix) run uniformly with every other AIP defineX.\n *\n * Field-level validation runs the schema-derived zod from\n * `./schema.ts`. Same source of truth as the .md path uses\n * (`parseAcpManifest`), so a malformed TS-authored definition fails\n * with the same diagnostic as a malformed manifest.\n *\n * Cross-field rules (kind=server requires `metadata.aip44.operator`;\n * tier=sandboxed requires `metadata.aip44.sandbox`) run after the\n * zod check so callers see one consistent error path.\n */\nexport const defineAcp = createDoctype<AcpDefinition, AcpHandle>({\n  aip: 44,\n  name: \"acp\",\n  readIdentity: (def) => def.id,\n  validate(def) {\n    const result = acpFrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `defineAcp (AIP-44): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n\n    const aip44 = result.data.metadata.aip44\n\n    if (result.data.kind === \"server\" && !aip44.operator) {\n      throw new Error(\n        \"defineAcp (AIP-44): metadata.aip44.operator is required when kind=server\",\n      )\n    }\n\n    if (aip44.tier === \"sandboxed\" && !aip44.sandbox) {\n      throw new Error(\n        \"defineAcp (AIP-44): metadata.aip44.sandbox is required when metadata.aip44.tier=sandboxed\",\n      )\n    }\n  },\n  build(def) {\n    return { ...def } as AcpHandle\n  },\n})\n"]}

package/dist/client/index.d.ts

@@ -0,0 +1,76 @@
+import { ClientSideConnection, Client } from '@agentclientprotocol/sdk';
+import { S as StreamEvent } from '../types-BPyht7LH.js';
+
+/**
+ * AIP-44 ACP client — drives a subprocess agent via stdio JSON-RPC.
+ *
+ * Wraps `@agentclientprotocol/sdk`'s `ClientSideConnection`. Owns the
+ * connection lifecycle, runs `initialize` on construction, and exposes
+ * a session API where each `prompt()` call returns an
+ * `AsyncIterable<StreamEvent>` fed by the SDK's `session/update`
+ * notification handler.
+ */
+
+interface AcpClientOptions {
+    /** Output bytes go here (subprocess stdin). */
+    output: WritableStream<Uint8Array>;
+    /** Input bytes come from here (subprocess stdout). */
+    input: ReadableStream<Uint8Array>;
+    /** Client identity advertised during `initialize`. */
+    clientInfo?: {
+        name: string;
+        title?: string;
+        version?: string;
+    };
+    /** Client capabilities advertised during `initialize`. */
+    capabilities?: {
+        fs?: {
+            readTextFile?: boolean;
+            writeTextFile?: boolean;
+        };
+        terminal?: boolean;
+    };
+    /** Optional handlers for agent-initiated requests beyond fs / terminal. */
+    handlers?: Partial<Client>;
+    /** Protocol version to negotiate. Defaults to the SDK's current. */
+    protocolVersion?: number;
+}
+interface AcpClient {
+    readonly connection: ClientSideConnection;
+    /** Negotiated agent capabilities returned from `initialize`. */
+    readonly agentCapabilities: Record<string, unknown> | undefined;
+    newSession(params: {
+        cwd: string;
+        mcpServers?: unknown[];
+    }): Promise<AcpClientSession>;
+    /**
+     * Reattach to an existing session by id. Available only when the
+     * agent advertised `loadSession: true` in its capabilities (callers
+     * should check `agentCapabilities` first; we forward the SDK error
+     * verbatim if they don't).
+     *
+     * Drives the AIP-45 native-resume continuation strategy: the host
+     * persists the `sessionId` returned by `newSession`, then on a
+     * cold start (process restart, fresh sandbox, different machine)
+     * spawns a new subprocess and calls `loadSession` to pick up
+     * the conversation from the stored history.
+     */
+    loadSession(params: {
+        sessionId: string;
+        cwd: string;
+        mcpServers?: unknown[];
+    }): Promise<AcpClientSession>;
+    close(): Promise<void>;
+}
+interface AcpClientSession {
+    readonly sessionId: string;
+    prompt(input: {
+        messages: unknown[];
+        signal?: AbortSignal;
+    }): AsyncIterable<StreamEvent>;
+    cancel(): Promise<void>;
+    close(): Promise<void>;
+}
+declare function createAcpClient(options: AcpClientOptions): Promise<AcpClient>;
+
+export { type AcpClient, type AcpClientOptions, type AcpClientSession, createAcpClient };

package/dist/client/index.mjs

@@ -0,0 +1,248 @@
+import { ndJsonStream, ClientSideConnection } from '@agentclientprotocol/sdk';
+
+/**
+ * @agentproto/acp v0.1.0-alpha
+ * AIP-44 ACP.md `defineAcp` reference implementation.
+ */
+
+var PROTOCOL_VERSION_DEFAULT = 1;
+async function createAcpClient(options) {
+  const sessions = /* @__PURE__ */ new Map();
+  const stream = ndJsonStream(options.output, options.input);
+  const connection = new ClientSideConnection(
+    () => buildClientHandlers(options.handlers ?? {}, sessions),
+    stream
+  );
+  const initResponse = await connection.initialize({
+    protocolVersion: options.protocolVersion ?? PROTOCOL_VERSION_DEFAULT,
+    clientCapabilities: clientCapabilitiesFromOptions(options),
+    clientInfo: options.clientInfo ? {
+      name: options.clientInfo.name,
+      title: options.clientInfo.title ?? options.clientInfo.name,
+      version: options.clientInfo.version ?? "0.0.0"
+    } : void 0
+  });
+  return {
+    connection,
+    agentCapabilities: initResponse.agentCapabilities,
+    async newSession(params) {
+      const response = await connection.newSession({
+        cwd: params.cwd,
+        mcpServers: params.mcpServers ?? []
+      });
+      const sessionId = response.sessionId;
+      const state = {
+        events: [],
+        resolveNext: null,
+        done: false,
+        active: false
+      };
+      sessions.set(sessionId, state);
+      return buildSession(connection, sessionId, state, sessions);
+    },
+    async loadSession(params) {
+      await connection.loadSession({
+        sessionId: params.sessionId,
+        cwd: params.cwd,
+        mcpServers: params.mcpServers ?? []
+      });
+      const state = {
+        events: [],
+        resolveNext: null,
+        done: false,
+        active: false
+      };
+      sessions.set(params.sessionId, state);
+      return buildSession(connection, params.sessionId, state, sessions);
+    },
+    async close() {
+      sessions.clear();
+    }
+  };
+}
+function clientCapabilitiesFromOptions(options) {
+  const caps = options.capabilities ?? {};
+  return {
+    fs: {
+      readTextFile: caps.fs?.readTextFile ?? false,
+      writeTextFile: caps.fs?.writeTextFile ?? false
+    },
+    terminal: caps.terminal ?? false
+  };
+}
+function buildSession(connection, sessionId, state, sessions) {
+  return {
+    sessionId,
+    prompt(input) {
+      if (state.active) {
+        throw new Error(
+          `AcpClientSession.prompt: session ${sessionId} already has an in-flight prompt`
+        );
+      }
+      state.active = true;
+      state.done = false;
+      state.events.length = 0;
+      const iter = makeIterator(state);
+      connection.prompt({
+        sessionId,
+        prompt: input.messages
+      }).then((response) => {
+        enqueue(state, {
+          kind: "turn-end",
+          sessionId,
+          reason: response.stopReason === "cancelled" && "cancelled" || response.stopReason === "max_turns" && "max_turns" || "completed"
+        });
+      }).catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        enqueue(state, {
+          kind: "error",
+          sessionId,
+          error: { message }
+        });
+      }).finally(() => {
+        state.active = false;
+        state.done = true;
+        flush(state);
+      });
+      if (input.signal) {
+        input.signal.addEventListener(
+          "abort",
+          () => {
+            void connection.cancel({ sessionId });
+          },
+          { once: true }
+        );
+      }
+      return iter;
+    },
+    async cancel() {
+      if (!state.active) return;
+      await connection.cancel({ sessionId });
+    },
+    async close() {
+      sessions.delete(sessionId);
+    }
+  };
+}
+function makeIterator(state) {
+  return {
+    [Symbol.asyncIterator]() {
+      return {
+        async next() {
+          if (state.events.length > 0) {
+            const value2 = state.events.shift();
+            return { value: value2, done: false };
+          }
+          if (state.done) return { value: void 0, done: true };
+          const value = await new Promise(
+            (resolve) => {
+              state.resolveNext = resolve;
+            }
+          );
+          if (value === void 0) return { value: void 0, done: true };
+          return { value, done: false };
+        }
+      };
+    }
+  };
+}
+function enqueue(state, event) {
+  if (state.resolveNext) {
+    const r = state.resolveNext;
+    state.resolveNext = null;
+    r(event);
+    return;
+  }
+  state.events.push(event);
+}
+function flush(state) {
+  if (state.resolveNext) {
+    const r = state.resolveNext;
+    state.resolveNext = null;
+    r(void 0);
+  }
+}
+function buildClientHandlers(partial, sessions) {
+  return {
+    async sessionUpdate(params) {
+      const sid = params.sessionId;
+      if (!sid) return;
+      const state = sessions.get(sid);
+      if (!state) return;
+      const update = params.update;
+      if (!update) return;
+      const event = translateSessionUpdate(sid, update);
+      if (event) enqueue(state, event);
+      if (partial.sessionUpdate) await partial.sessionUpdate(params);
+    },
+    async requestPermission(params) {
+      if (partial.requestPermission) return partial.requestPermission(params);
+      throw new Error("AcpClient.requestPermission: no handler configured");
+    },
+    async readTextFile(params) {
+      if (partial.readTextFile) return partial.readTextFile(params);
+      throw new Error("AcpClient.readTextFile: capability not advertised");
+    },
+    async writeTextFile(params) {
+      if (partial.writeTextFile) return partial.writeTextFile(params);
+      throw new Error("AcpClient.writeTextFile: capability not advertised");
+    },
+    ...partial
+  };
+}
+function translateSessionUpdate(sessionId, update) {
+  switch (update.sessionUpdate) {
+    case "agent_message_chunk":
+      return {
+        kind: "text-delta",
+        sessionId,
+        text: extractText(update.content)
+      };
+    case "agent_thought_chunk":
+      return {
+        kind: "thought",
+        sessionId,
+        text: extractText(update.content)
+      };
+    case "tool_call": {
+      const toolCallId = update.toolCallId ?? "";
+      return {
+        kind: "tool-call",
+        sessionId,
+        toolCallId,
+        toolName: update.kind ?? update.title ?? "tool",
+        arguments: update.rawInput ?? update.content ?? {}
+      };
+    }
+    case "tool_call_update": {
+      const status = update.status;
+      if (status === "completed" || status === "failed") {
+        return {
+          kind: "tool-result",
+          sessionId,
+          toolCallId: update.toolCallId ?? "",
+          result: update.rawOutput ?? update.content ?? null,
+          isError: status === "failed"
+        };
+      }
+      return null;
+    }
+    case "user_message_chunk":
+      return null;
+    default:
+      return null;
+  }
+}
+function extractText(content) {
+  if (!content) return "";
+  if (typeof content === "string") return content;
+  if (typeof content === "object" && content !== null) {
+    const c = content;
+    if (c.type === "text" && typeof c.text === "string") return c.text;
+  }
+  return "";
+}
+
+export { createAcpClient };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/index.ts"],"names":["value"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * AIP-44 ACP client — drives a subprocess agent via stdio JSON-RPC.\n *\n * Wraps `@agentclientprotocol/sdk`'s `ClientSideConnection`. Owns the\n * connection lifecycle, runs `initialize` on construction, and exposes\n * a session API where each `prompt()` call returns an\n * `AsyncIterable<StreamEvent>` fed by the SDK's `session/update`\n * notification handler.\n */\n\nimport {\n  ClientSideConnection,\n  ndJsonStream,\n  type Client as AcpClientHandlers,\n  type Stream,\n} from \"@agentclientprotocol/sdk\"\nimport type { StreamEvent } from \"../types.js\"\n\nconst PROTOCOL_VERSION_DEFAULT = 1\n\nexport interface AcpClientOptions {\n  /** Output bytes go here (subprocess stdin). */\n  output: WritableStream<Uint8Array>\n  /** Input bytes come from here (subprocess stdout). */\n  input: ReadableStream<Uint8Array>\n  /** Client identity advertised during `initialize`. */\n  clientInfo?: {\n    name: string\n    title?: string\n    version?: string\n  }\n  /** Client capabilities advertised during `initialize`. */\n  capabilities?: {\n    fs?: { readTextFile?: boolean; writeTextFile?: boolean }\n    terminal?: boolean\n  }\n  /** Optional handlers for agent-initiated requests beyond fs / terminal. */\n  handlers?: Partial<AcpClientHandlers>\n  /** Protocol version to negotiate. Defaults to the SDK's current. */\n  protocolVersion?: number\n}\n\nexport interface AcpClient {\n  readonly connection: ClientSideConnection\n  /** Negotiated agent capabilities returned from `initialize`. */\n  readonly agentCapabilities: Record<string, unknown> | undefined\n  newSession(params: {\n    cwd: string\n    mcpServers?: unknown[]\n  }): Promise<AcpClientSession>\n  /**\n   * Reattach to an existing session by id. Available only when the\n   * agent advertised `loadSession: true` in its capabilities (callers\n   * should check `agentCapabilities` first; we forward the SDK error\n   * verbatim if they don't).\n   *\n   * Drives the AIP-45 native-resume continuation strategy: the host\n   * persists the `sessionId` returned by `newSession`, then on a\n   * cold start (process restart, fresh sandbox, different machine)\n   * spawns a new subprocess and calls `loadSession` to pick up\n   * the conversation from the stored history.\n   */\n  loadSession(params: {\n    sessionId: string\n    cwd: string\n    mcpServers?: unknown[]\n  }): Promise<AcpClientSession>\n  close(): Promise<void>\n}\n\nexport interface AcpClientSession {\n  readonly sessionId: string\n  prompt(input: {\n    messages: unknown[]\n    signal?: AbortSignal\n  }): AsyncIterable<StreamEvent>\n  cancel(): Promise<void>\n  close(): Promise<void>\n}\n\ninterface SessionState {\n  events: StreamEvent[]\n  resolveNext: ((evt: StreamEvent | undefined) => void) | null\n  done: boolean\n  active: boolean\n}\n\nexport async function createAcpClient(\n  options: AcpClientOptions,\n): Promise<AcpClient> {\n  const sessions = new Map<string, SessionState>()\n\n  const stream: Stream = ndJsonStream(options.output, options.input)\n\n  const connection: ClientSideConnection = new ClientSideConnection(\n    () => buildClientHandlers(options.handlers ?? {}, sessions),\n    stream,\n  )\n\n  const initResponse = await connection.initialize({\n    protocolVersion: options.protocolVersion ?? PROTOCOL_VERSION_DEFAULT,\n    clientCapabilities: clientCapabilitiesFromOptions(options),\n    clientInfo: options.clientInfo\n      ? {\n          name: options.clientInfo.name,\n          title: options.clientInfo.title ?? options.clientInfo.name,\n          version: options.clientInfo.version ?? \"0.0.0\",\n        }\n      : undefined,\n  } as never)\n\n  return {\n    connection,\n    agentCapabilities: (initResponse as { agentCapabilities?: Record<string, unknown> })\n      .agentCapabilities,\n    async newSession(params) {\n      const response = await connection.newSession({\n        cwd: params.cwd,\n        mcpServers: (params.mcpServers ?? []) as never,\n      } as never)\n      const sessionId = (response as { sessionId: string }).sessionId\n      const state: SessionState = {\n        events: [],\n        resolveNext: null,\n        done: false,\n        active: false,\n      }\n      sessions.set(sessionId, state)\n      return buildSession(connection, sessionId, state, sessions)\n    },\n    async loadSession(params) {\n      // SDK returns `LoadSessionResponse` (no body fields we need); the\n      // sessionId is what the caller already provided. We register a\n      // fresh `SessionState` so subsequent `prompt` calls have a slot\n      // to flush events into — same lifecycle shape as a brand-new\n      // session.\n      await connection.loadSession({\n        sessionId: params.sessionId,\n        cwd: params.cwd,\n        mcpServers: (params.mcpServers ?? []) as never,\n      } as never)\n      const state: SessionState = {\n        events: [],\n        resolveNext: null,\n        done: false,\n        active: false,\n      }\n      sessions.set(params.sessionId, state)\n      return buildSession(connection, params.sessionId, state, sessions)\n    },\n    async close() {\n      sessions.clear()\n    },\n  }\n}\n\nfunction clientCapabilitiesFromOptions(\n  options: AcpClientOptions,\n): Record<string, unknown> {\n  const caps = options.capabilities ?? {}\n  return {\n    fs: {\n      readTextFile: caps.fs?.readTextFile ?? false,\n      writeTextFile: caps.fs?.writeTextFile ?? false,\n    },\n    terminal: caps.terminal ?? false,\n  }\n}\n\nfunction buildSession(\n  connection: ClientSideConnection,\n  sessionId: string,\n  state: SessionState,\n  sessions: Map<string, SessionState>,\n): AcpClientSession {\n  return {\n    sessionId,\n    prompt(input) {\n      if (state.active) {\n        throw new Error(\n          `AcpClientSession.prompt: session ${sessionId} already has an in-flight prompt`,\n        )\n      }\n      state.active = true\n      state.done = false\n      state.events.length = 0\n\n      const iter = makeIterator(state)\n\n      const promise = connection\n        .prompt({\n          sessionId,\n          prompt: input.messages as never,\n        } as never)\n        .then((response) => {\n          enqueue(state, {\n            kind: \"turn-end\",\n            sessionId,\n            reason:\n              ((response as { stopReason?: string }).stopReason ===\n                \"cancelled\" && \"cancelled\") ||\n              ((response as { stopReason?: string }).stopReason ===\n                \"max_turns\" && \"max_turns\") ||\n              \"completed\",\n          })\n        })\n        .catch((err: unknown) => {\n          const message =\n            err instanceof Error ? err.message : String(err)\n          enqueue(state, {\n            kind: \"error\",\n            sessionId,\n            error: { message },\n          })\n        })\n        .finally(() => {\n          state.active = false\n          state.done = true\n          flush(state)\n        })\n\n      if (input.signal) {\n        input.signal.addEventListener(\n          \"abort\",\n          () => {\n            void connection.cancel({ sessionId } as never)\n          },\n          { once: true },\n        )\n      }\n\n      void promise\n      return iter\n    },\n    async cancel() {\n      if (!state.active) return\n      await connection.cancel({ sessionId } as never)\n    },\n    async close() {\n      sessions.delete(sessionId)\n    },\n  }\n}\n\nfunction makeIterator(state: SessionState): AsyncIterable<StreamEvent> {\n  return {\n    [Symbol.asyncIterator]() {\n      return {\n        async next() {\n          if (state.events.length > 0) {\n            const value = state.events.shift() as StreamEvent\n            return { value, done: false }\n          }\n          if (state.done) return { value: undefined, done: true }\n          const value = await new Promise<StreamEvent | undefined>(\n            (resolve) => {\n              state.resolveNext = resolve\n            },\n          )\n          if (value === undefined) return { value: undefined, done: true }\n          return { value, done: false }\n        },\n      }\n    },\n  }\n}\n\nfunction enqueue(state: SessionState, event: StreamEvent) {\n  if (state.resolveNext) {\n    const r = state.resolveNext\n    state.resolveNext = null\n    r(event)\n    return\n  }\n  state.events.push(event)\n}\n\nfunction flush(state: SessionState) {\n  if (state.resolveNext) {\n    const r = state.resolveNext\n    state.resolveNext = null\n    r(undefined)\n  }\n}\n\nfunction buildClientHandlers(\n  partial: Partial<AcpClientHandlers>,\n  sessions: Map<string, SessionState>,\n): AcpClientHandlers {\n  return {\n    async sessionUpdate(params) {\n      const sid = (params as { sessionId?: string }).sessionId\n      if (!sid) return\n      const state = sessions.get(sid)\n      if (!state) return\n\n      const update = (params as { update?: Record<string, unknown> }).update\n      if (!update) return\n      const event = translateSessionUpdate(sid, update)\n      if (event) enqueue(state, event)\n\n      if (partial.sessionUpdate) await partial.sessionUpdate(params)\n    },\n    async requestPermission(params) {\n      if (partial.requestPermission) return partial.requestPermission(params)\n      throw new Error(\"AcpClient.requestPermission: no handler configured\")\n    },\n    async readTextFile(params) {\n      if (partial.readTextFile) return partial.readTextFile(params)\n      throw new Error(\"AcpClient.readTextFile: capability not advertised\")\n    },\n    async writeTextFile(params) {\n      if (partial.writeTextFile) return partial.writeTextFile(params)\n      throw new Error(\"AcpClient.writeTextFile: capability not advertised\")\n    },\n    ...(partial as object),\n  } as AcpClientHandlers\n}\n\nfunction translateSessionUpdate(\n  sessionId: string,\n  update: Record<string, unknown>,\n): StreamEvent | null {\n  switch (update.sessionUpdate) {\n    case \"agent_message_chunk\":\n      return {\n        kind: \"text-delta\",\n        sessionId,\n        text: extractText(update.content),\n      }\n    case \"agent_thought_chunk\":\n      return {\n        kind: \"thought\",\n        sessionId,\n        text: extractText(update.content),\n      }\n    case \"tool_call\": {\n      const toolCallId = (update.toolCallId as string) ?? \"\"\n      return {\n        kind: \"tool-call\",\n        sessionId,\n        toolCallId,\n        toolName: (update.kind as string) ?? (update.title as string) ?? \"tool\",\n        arguments: update.rawInput ?? update.content ?? {},\n      }\n    }\n    case \"tool_call_update\": {\n      const status = update.status as string | undefined\n      if (status === \"completed\" || status === \"failed\") {\n        return {\n          kind: \"tool-result\",\n          sessionId,\n          toolCallId: (update.toolCallId as string) ?? \"\",\n          result: update.rawOutput ?? update.content ?? null,\n          isError: status === \"failed\",\n        }\n      }\n      return null\n    }\n    case \"user_message_chunk\":\n      return null\n    default:\n      return null\n  }\n}\n\nfunction extractText(content: unknown): string {\n  if (!content) return \"\"\n  if (typeof content === \"string\") return content\n  if (typeof content === \"object\" && content !== null) {\n    const c = content as { type?: string; text?: string }\n    if (c.type === \"text\" && typeof c.text === \"string\") return c.text\n  }\n  return \"\"\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { A as AcpDefinition } from './types-BPyht7LH.js';
+export { a as AcpAuditConfig, b as AcpCapabilities, c as AcpHandle, d as AcpMcpServer, e as AcpRole, f as AcpTier, g as AcpTransport, h as Aip44Extensions, S as StreamEvent } from './types-BPyht7LH.js';
+export { A as AcpFrontmatter, a as Aip44ExtensionsSchema, b as acpFrontmatterSchema } from './schema-CxWMGVy0.js';
+import 'zod';
+
+/**
+ * AIP-44 reference implementation of `defineAcp`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "defineAcp (AIP-44): …"
+ * error prefix) run uniformly with every other AIP defineX.
+ *
+ * Field-level validation runs the schema-derived zod from
+ * `./schema.ts`. Same source of truth as the .md path uses
+ * (`parseAcpManifest`), so a malformed TS-authored definition fails
+ * with the same diagnostic as a malformed manifest.
+ *
+ * Cross-field rules (kind=server requires `metadata.aip44.operator`;
+ * tier=sandboxed requires `metadata.aip44.sandbox`) run after the
+ * zod check so callers see one consistent error path.
+ */
+declare const defineAcp: (def: AcpDefinition) => Readonly<AcpDefinition>;
+
+/**
+ * @agentproto/acp — AIP-44 ACP.md `defineAcp` reference impl + thin
+ * wrappers around the upstream Agent Client Protocol SDK.
+ *
+ * Spec: https://agentproto.sh/docs/aip-44
+ * Upstream protocol: https://agentclientprotocol.com/
+ *
+ * Authoring paths:
+ *   - TS:  `defineAcp({...})` → `AcpHandle`
+ *   - MD:  `parseAcpManifest(src) → acpFromManifest({...})` → `AcpHandle`
+ *
+ * Runtime paths:
+ *   - Drive a subprocess agent: `createAcpClient({ output, input, ... })`
+ *   - Expose an operator as a server: `createAcpServer({ handle, ... })`
+ */
+declare const SPEC_NAME: "agentacp/v1";
+declare const SPEC_VERSION: "0.1.0-alpha";
+
+export { AcpDefinition, SPEC_NAME, SPEC_VERSION, defineAcp };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { acpFrontmatterSchema, defineAcp } from './chunk-5KZCEMZW.mjs';
+
+/**
+ * @agentproto/acp v0.1.0-alpha
+ * AIP-44 ACP.md `defineAcp` reference implementation.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentacp/v1";
+var SPEC_VERSION = "0.1.0-alpha";
+
+export { SPEC_NAME, SPEC_VERSION };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AAgBO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * @agentproto/acp — AIP-44 ACP.md `defineAcp` reference impl + thin\n * wrappers around the upstream Agent Client Protocol SDK.\n *\n * Spec: https://agentproto.sh/docs/aip-44\n * Upstream protocol: https://agentclientprotocol.com/\n *\n * Authoring paths:\n *   - TS:  `defineAcp({...})` → `AcpHandle`\n *   - MD:  `parseAcpManifest(src) → acpFromManifest({...})` → `AcpHandle`\n *\n * Runtime paths:\n *   - Drive a subprocess agent: `createAcpClient({ output, input, ... })`\n *   - Expose an operator as a server: `createAcpServer({ handle, ... })`\n */\n\nexport const SPEC_NAME = \"agentacp/v1\" as const\nexport const SPEC_VERSION = \"0.1.0-alpha\" as const\n\nexport { defineAcp } from \"./define-acp.js\"\nexport {\n  acpFrontmatterSchema,\n  type AcpFrontmatter,\n  type Aip44Extensions as Aip44ExtensionsSchema,\n} from \"./schema.js\"\nexport type {\n  AcpDefinition,\n  AcpHandle,\n  AcpRole,\n  AcpTransport,\n  AcpTier,\n  AcpCapabilities,\n  AcpAuditConfig,\n  AcpMcpServer,\n  Aip44Extensions,\n  StreamEvent,\n} from \"./types.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,22 @@
+import { A as AcpFrontmatter } from '../schema-CxWMGVy0.js';
+export { b as acpFrontmatterSchema } from '../schema-CxWMGVy0.js';
+import { c as AcpHandle } from '../types-BPyht7LH.js';
+import 'zod';
+
+/**
+ * AIP-44 ACP.md sidecar parser + manifest-to-handle constructor.
+ *
+ * Mirror of `@agentproto/skill/manifest`: the .md provides metadata;
+ * the TS module supplies any runtime bits the manifest can't carry.
+ * Both inputs end up in `defineAcp` so the cross-AIP invariants run
+ * uniformly.
+ */
+
+interface AcpManifest {
+    frontmatter: AcpFrontmatter;
+    body: string;
+}
+declare function parseAcpManifest(source: string): AcpManifest;
+declare function acpFromManifest(manifest: AcpManifest): AcpHandle;
+
+export { AcpFrontmatter, type AcpManifest, acpFromManifest, parseAcpManifest };

package/dist/manifest/index.mjs

@@ -0,0 +1,28 @@
+import { acpFrontmatterSchema, defineAcp } from '../chunk-5KZCEMZW.mjs';
+export { acpFrontmatterSchema } from '../chunk-5KZCEMZW.mjs';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/acp v0.1.0-alpha
+ * AIP-44 ACP.md `defineAcp` reference implementation.
+ */
+function parseAcpManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseAcpManifest: missing or empty frontmatter");
+  }
+  const result = acpFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseAcpManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function acpFromManifest(manifest) {
+  return defineAcp(manifest.frontmatter);
+}
+
+export { acpFromManifest, parseAcpManifest };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/manifest/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/manifest/index.ts"],"names":[],"mappings":";;;;;;;;AAqBO,SAAS,iBAAiB,MAAA,EAA6B;AAC5D,EAAA,MAAM,MAAA,GAAS,OAAO,MAAM,CAAA;AAC5B,EAAA,IAAI,OAAO,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,CAAE,WAAW,CAAA,EAAG;AACzC,IAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,EAClE;AACA,EAAA,MAAM,MAAA,GAAS,oBAAA,CAAqB,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AACzD,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,6CAAA,EAA2C,OAAO,KAAA,CAAM,MAAA,CACrD,IAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAC,KAAK,CAAA,CAAE,OAAO,EAAE,CAAA,CAC9C,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACf;AAAA,EACF;AACA,EAAA,OAAO,EAAE,WAAA,EAAa,MAAA,CAAO,IAAA,EAAM,IAAA,EAAM,OAAO,OAAA,EAAQ;AAC1D;AAEO,SAAS,gBAAgB,QAAA,EAAkC;AAChE,EAAA,OAAO,SAAA,CAAU,SAAS,WAAuC,CAAA;AACnE","file":"index.mjs","sourcesContent":["/**\n * AIP-44 ACP.md sidecar parser + manifest-to-handle constructor.\n *\n * Mirror of `@agentproto/skill/manifest`: the .md provides metadata;\n * the TS module supplies any runtime bits the manifest can't carry.\n * Both inputs end up in `defineAcp` so the cross-AIP invariants run\n * uniformly.\n */\n\nimport matter from \"gray-matter\"\nimport { acpFrontmatterSchema, type AcpFrontmatter } from \"../schema.js\"\nimport { defineAcp } from \"../define-acp.js\"\nimport type { AcpDefinition, AcpHandle } from \"../types.js\"\n\nexport { acpFrontmatterSchema, type AcpFrontmatter }\n\nexport interface AcpManifest {\n  frontmatter: AcpFrontmatter\n  body: string\n}\n\nexport function parseAcpManifest(source: string): AcpManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseAcpManifest: missing or empty frontmatter\")\n  }\n  const result = acpFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseAcpManifest: invalid frontmatter — ${result.error.issues\n        .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n        .join(\"; \")}`,\n    )\n  }\n  return { frontmatter: result.data, body: parsed.content }\n}\n\nexport function acpFromManifest(manifest: AcpManifest): AcpHandle {\n  return defineAcp(manifest.frontmatter as unknown as AcpDefinition)\n}\n"]}

package/dist/schema-CxWMGVy0.d.ts

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+
+/**
+ * AIP-44 ACP.md frontmatter zod schema.
+ *
+ * Mirrors `resources/aip-44/draft/ACP.schema.json` field-for-field.
+ * AIP-44 is an agentproto profile of the upstream Agent Client
+ * Protocol (agentclientprotocol.com) — the manifest declares an
+ * agent or client's role/transport/conformance level, and AIP-44-
+ * specific bindings live under `metadata.aip44.*` so plain ACP
+ * runtimes preserve them verbatim.
+ *
+ * Both authoring paths (`define-acp.ts` for TS-authored manifests
+ * and `manifest/index.ts` for ACP.md parsing) validate against this
+ * schema, so every field-level constraint runs in both paths from a
+ * single source of truth.
+ *
+ * Cross-field rules (tier=sandboxed ⇒ sandbox required) live in
+ * `define-acp.ts`'s `validate(def)` body — they're harder to encode
+ * in a flat zod schema and want a single error path.
+ */
+
+declare const aip44ExtensionsSchema: z.ZodObject<{
+    acp_rev: z.ZodString;
+    tier: z.ZodEnum<{
+        basic: "basic";
+        "governance-aware": "governance-aware";
+        sandboxed: "sandboxed";
+    }>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+        client: z.ZodOptional<z.ZodObject<{
+            fs: z.ZodOptional<z.ZodObject<{
+                readTextFile: z.ZodOptional<z.ZodBoolean>;
+                writeTextFile: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            terminal: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        agent: z.ZodOptional<z.ZodObject<{
+            loadSession: z.ZodOptional<z.ZodBoolean>;
+            promptCapabilities: z.ZodOptional<z.ZodObject<{
+                image: z.ZodOptional<z.ZodBoolean>;
+                audio: z.ZodOptional<z.ZodBoolean>;
+                embeddedContext: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            mcpCapabilities: z.ZodOptional<z.ZodObject<{
+                http: z.ZodOptional<z.ZodBoolean>;
+                sse: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    operator: z.ZodOptional<z.ZodString>;
+    governance: z.ZodOptional<z.ZodString>;
+    sandbox: z.ZodOptional<z.ZodString>;
+    audit: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            governance: "governance";
+            external: "external";
+            off: "off";
+        }>>;
+    }, z.core.$strict>>;
+    mcp_servers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        transport: z.ZodEnum<{
+            stdio: "stdio";
+            http: "http";
+            sse: "sse";
+        }>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$loose>;
+declare const acpFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    id: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    kind: z.ZodEnum<{
+        client: "client";
+        server: "server";
+        bridge: "bridge";
+    }>;
+    transport: z.ZodUnion<readonly [z.ZodEnum<{
+        stdio: "stdio";
+        websocket: "websocket";
+    }>, z.ZodArray<z.ZodEnum<{
+        stdio: "stdio";
+        websocket: "websocket";
+    }>>]>;
+    metadata: z.ZodObject<{
+        aip44: z.ZodObject<{
+            acp_rev: z.ZodString;
+            tier: z.ZodEnum<{
+                basic: "basic";
+                "governance-aware": "governance-aware";
+                sandboxed: "sandboxed";
+            }>;
+            capabilities: z.ZodOptional<z.ZodObject<{
+                client: z.ZodOptional<z.ZodObject<{
+                    fs: z.ZodOptional<z.ZodObject<{
+                        readTextFile: z.ZodOptional<z.ZodBoolean>;
+                        writeTextFile: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                    terminal: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
+                agent: z.ZodOptional<z.ZodObject<{
+                    loadSession: z.ZodOptional<z.ZodBoolean>;
+                    promptCapabilities: z.ZodOptional<z.ZodObject<{
+                        image: z.ZodOptional<z.ZodBoolean>;
+                        audio: z.ZodOptional<z.ZodBoolean>;
+                        embeddedContext: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                    mcpCapabilities: z.ZodOptional<z.ZodObject<{
+                        http: z.ZodOptional<z.ZodBoolean>;
+                        sse: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            operator: z.ZodOptional<z.ZodString>;
+            governance: z.ZodOptional<z.ZodString>;
+            sandbox: z.ZodOptional<z.ZodString>;
+            audit: z.ZodOptional<z.ZodObject<{
+                ref: z.ZodOptional<z.ZodString>;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    governance: "governance";
+                    external: "external";
+                    off: "off";
+                }>>;
+            }, z.core.$strict>>;
+            mcp_servers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                transport: z.ZodEnum<{
+                    stdio: "stdio";
+                    http: "http";
+                    sse: "sse";
+                }>;
+                ref: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+type AcpFrontmatter = z.infer<typeof acpFrontmatterSchema>;
+type Aip44Extensions = z.infer<typeof aip44ExtensionsSchema>;
+
+export { type AcpFrontmatter as A, type Aip44Extensions as a, acpFrontmatterSchema as b };

package/dist/server/index.d.ts

@@ -0,0 +1,38 @@
+import { AgentSideConnection } from '@agentclientprotocol/sdk';
+import { c as AcpHandle } from '../types-BPyht7LH.js';
+
+/**
+ * AIP-44 ACP server — exposes an AIP-9 operator to ACP-speaking clients.
+ *
+ * Thin wrapper around `@agentclientprotocol/sdk`'s `AgentSideConnection`.
+ * Hosts the connection, maps incoming `session/prompt` requests onto an
+ * `onPrompt` handler, and bridges `session/update` notifications to the
+ * caller's audit emitter via the per-session context.
+ */
+
+interface AcpServerOptions {
+    /** AIP-44 manifest describing the server's role + capabilities. */
+    handle: AcpHandle;
+    /** Output bytes go here (client stdin / WS write side). */
+    output: WritableStream<Uint8Array>;
+    /** Input bytes come from here (client stdout / WS read side). */
+    input: ReadableStream<Uint8Array>;
+    /** Hook invoked when a client calls `session/prompt`. */
+    onPrompt?: (params: unknown, ctx: AcpServerSessionContext) => Promise<unknown>;
+    /** Hook invoked on `session/cancel`. */
+    onCancel?: (sessionId: string) => Promise<void>;
+}
+interface AcpServerSessionContext {
+    readonly sessionId: string;
+    /** Push a `session/update` notification to the connected client. */
+    sendUpdate(update: unknown): Promise<void>;
+    /** Aborts when the client sends `session/cancel`. */
+    readonly signal: AbortSignal;
+}
+interface AcpServer {
+    readonly connection: AgentSideConnection;
+    close(): Promise<void>;
+}
+declare function createAcpServer(options: AcpServerOptions): AcpServer;
+
+export { type AcpServer, type AcpServerOptions, type AcpServerSessionContext, createAcpServer };

package/dist/server/index.mjs

@@ -0,0 +1,66 @@
+import { ndJsonStream, AgentSideConnection } from '@agentclientprotocol/sdk';
+
+/**
+ * @agentproto/acp v0.1.0-alpha
+ * AIP-44 ACP.md `defineAcp` reference implementation.
+ */
+
+function createAcpServer(options) {
+  const stream = ndJsonStream(options.output, options.input);
+  const connection = new AgentSideConnection(
+    (conn) => buildAgentHandlers(conn, options),
+    stream
+  );
+  return {
+    connection,
+    async close() {
+    }
+  };
+}
+function buildAgentHandlers(conn, options) {
+  void options.handle;
+  return {
+    async initialize(params) {
+      throw new Error("AcpServer.initialize: not yet implemented");
+    },
+    async authenticate(params) {
+      throw new Error("AcpServer.authenticate: not yet implemented");
+    },
+    async newSession(params) {
+      throw new Error("AcpServer.newSession: not yet implemented");
+    },
+    async loadSession(params) {
+      throw new Error("AcpServer.loadSession: not yet implemented");
+    },
+    async cancel(params) {
+      if (options.onCancel) {
+        await options.onCancel(params.sessionId);
+        return;
+      }
+    },
+    async prompt(params) {
+      if (!options.onPrompt) {
+        throw new Error("AcpServer.prompt: no onPrompt handler configured");
+      }
+      const sessionId = params.sessionId ?? "unknown";
+      const controller = new AbortController();
+      const ctx = {
+        sessionId,
+        signal: controller.signal,
+        sendUpdate: async (update) => {
+          await conn.sessionUpdate(update);
+        }
+      };
+      try {
+        return await options.onPrompt(params, ctx);
+      } catch (err) {
+        controller.abort();
+        throw err;
+      }
+    }
+  };
+}
+
+export { createAcpServer };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/index.ts"],"names":[],"mappings":";;;;;;;AA2CO,SAAS,gBAAgB,OAAA,EAAsC;AACpE,EAAA,MAAM,MAAA,GAAiB,YAAA,CAAa,OAAA,CAAQ,MAAA,EAAQ,QAAQ,KAAK,CAAA;AAEjE,EAAA,MAAM,aAAa,IAAI,mBAAA;AAAA,IACrB,CAAC,IAAA,KAAS,kBAAA,CAAmB,IAAA,EAAM,OAAO,CAAA;AAAA,IAC1C;AAAA,GACF;AAEA,EAAA,OAAO;AAAA,IACL,UAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AAAA,IAAC;AAAA,GACjB;AACF;AAEA,SAAS,kBAAA,CACP,MACA,OAAA,EACkB;AAClB,EAAA,KAAK,OAAA,CAAQ,MAAA;AAEb,EAAA,OAAO;AAAA,IACL,MAAM,WAAW,MAAA,EAAQ;AAEvB,MAAA,MAAM,IAAI,MAAM,2CAA2C,CAAA;AAAA,IAC7D,CAAA;AAAA,IACA,MAAM,aAAa,MAAA,EAAQ;AAEzB,MAAA,MAAM,IAAI,MAAM,6CAA6C,CAAA;AAAA,IAC/D,CAAA;AAAA,IACA,MAAM,WAAW,MAAA,EAAQ;AAEvB,MAAA,MAAM,IAAI,MAAM,2CAA2C,CAAA;AAAA,IAC7D,CAAA;AAAA,IACA,MAAM,YAAY,MAAA,EAAQ;AAExB,MAAA,MAAM,IAAI,MAAM,4CAA4C,CAAA;AAAA,IAC9D,CAAA;AAAA,IACA,MAAM,OAAO,MAAA,EAAQ;AACnB,MAAA,IAAI,QAAQ,QAAA,EAAU;AACpB,QAAA,MAAM,OAAA,CAAQ,QAAA,CAAS,MAAA,CAAO,SAAS,CAAA;AACvC,QAAA;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IACA,MAAM,OAAO,MAAA,EAAQ;AACnB,MAAA,IAAI,CAAC,QAAQ,QAAA,EAAU;AACrB,QAAA,MAAM,IAAI,MAAM,kDAAkD,CAAA;AAAA,MACpE;AACA,MAAA,MAAM,SAAA,GAAa,OAAkC,SAAA,IAAa,SAAA;AAClE,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,MAAM,GAAA,GAA+B;AAAA,QACnC,SAAA;AAAA,QACA,QAAQ,UAAA,CAAW,MAAA;AAAA,QACnB,UAAA,EAAY,OAAO,MAAA,KAAW;AAC5B,UAAA,MAAM,IAAA,CAAK,cAAc,MAAe,CAAA;AAAA,QAC1C;AAAA,OACF;AACA,MAAA,IAAI;AACF,QAAA,OAAQ,MAAM,OAAA,CAAQ,QAAA,CAAS,MAAA,EAAQ,GAAG,CAAA;AAAA,MAC5C,SAAS,GAAA,EAAK;AACZ,QAAA,UAAA,CAAW,KAAA,EAAM;AACjB,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["/**\n * AIP-44 ACP server — exposes an AIP-9 operator to ACP-speaking clients.\n *\n * Thin wrapper around `@agentclientprotocol/sdk`'s `AgentSideConnection`.\n * Hosts the connection, maps incoming `session/prompt` requests onto an\n * `onPrompt` handler, and bridges `session/update` notifications to the\n * caller's audit emitter via the per-session context.\n */\n\nimport {\n  AgentSideConnection,\n  ndJsonStream,\n  type Agent as AcpAgentHandlers,\n  type Stream,\n} from \"@agentclientprotocol/sdk\"\nimport type { AcpHandle } from \"../types.js\"\n\nexport interface AcpServerOptions {\n  /** AIP-44 manifest describing the server's role + capabilities. */\n  handle: AcpHandle\n  /** Output bytes go here (client stdin / WS write side). */\n  output: WritableStream<Uint8Array>\n  /** Input bytes come from here (client stdout / WS read side). */\n  input: ReadableStream<Uint8Array>\n  /** Hook invoked when a client calls `session/prompt`. */\n  onPrompt?: (params: unknown, ctx: AcpServerSessionContext) => Promise<unknown>\n  /** Hook invoked on `session/cancel`. */\n  onCancel?: (sessionId: string) => Promise<void>\n}\n\nexport interface AcpServerSessionContext {\n  readonly sessionId: string\n  /** Push a `session/update` notification to the connected client. */\n  sendUpdate(update: unknown): Promise<void>\n  /** Aborts when the client sends `session/cancel`. */\n  readonly signal: AbortSignal\n}\n\nexport interface AcpServer {\n  readonly connection: AgentSideConnection\n  close(): Promise<void>\n}\n\nexport function createAcpServer(options: AcpServerOptions): AcpServer {\n  const stream: Stream = ndJsonStream(options.output, options.input)\n\n  const connection = new AgentSideConnection(\n    (conn) => buildAgentHandlers(conn, options),\n    stream,\n  )\n\n  return {\n    connection,\n    async close() {},\n  }\n}\n\nfunction buildAgentHandlers(\n  conn: AgentSideConnection,\n  options: AcpServerOptions,\n): AcpAgentHandlers {\n  void options.handle\n\n  return {\n    async initialize(params) {\n      void params\n      throw new Error(\"AcpServer.initialize: not yet implemented\")\n    },\n    async authenticate(params) {\n      void params\n      throw new Error(\"AcpServer.authenticate: not yet implemented\")\n    },\n    async newSession(params) {\n      void params\n      throw new Error(\"AcpServer.newSession: not yet implemented\")\n    },\n    async loadSession(params) {\n      void params\n      throw new Error(\"AcpServer.loadSession: not yet implemented\")\n    },\n    async cancel(params) {\n      if (options.onCancel) {\n        await options.onCancel(params.sessionId)\n        return\n      }\n    },\n    async prompt(params) {\n      if (!options.onPrompt) {\n        throw new Error(\"AcpServer.prompt: no onPrompt handler configured\")\n      }\n      const sessionId = (params as { sessionId?: string }).sessionId ?? \"unknown\"\n      const controller = new AbortController()\n      const ctx: AcpServerSessionContext = {\n        sessionId,\n        signal: controller.signal,\n        sendUpdate: async (update) => {\n          await conn.sessionUpdate(update as never)\n        },\n      }\n      try {\n        return (await options.onPrompt(params, ctx)) as never\n      } catch (err) {\n        controller.abort()\n        throw err\n      }\n    },\n  } as AcpAgentHandlers\n}\n"]}

package/dist/types-BPyht7LH.d.ts

@@ -0,0 +1,141 @@
+/**
+ * AIP-44 AcpDefinition + AcpHandle.
+ *
+ * Mirrors `resources/aip-44/draft/ACP.schema.json`. AIP-44 is an
+ * agentproto profile of the Agent Client Protocol — top-level fields
+ * declare role/transport/version, and AIP-44 extensions live under
+ * `metadata.aip44.*`.
+ *
+ * `AcpHandle` is the readonly view of the same shape; tighten it by
+ * hand for fields that get defaults applied in build().
+ */
+type AcpRole = "client" | "server" | "bridge";
+type AcpTransport = "stdio" | "websocket";
+type AcpTier = "basic" | "governance-aware" | "sandboxed";
+/** Mirror of upstream ACP `initialize` capabilities. */
+interface AcpCapabilities {
+    client?: {
+        fs?: {
+            readTextFile?: boolean;
+            writeTextFile?: boolean;
+        };
+        terminal?: boolean;
+    };
+    agent?: {
+        loadSession?: boolean;
+        promptCapabilities?: {
+            image?: boolean;
+            audio?: boolean;
+            embeddedContext?: boolean;
+        };
+        mcpCapabilities?: {
+            http?: boolean;
+            sse?: boolean;
+        };
+    };
+}
+interface AcpAuditConfig {
+    ref?: string;
+    kind?: "governance" | "external" | "off";
+}
+interface AcpMcpServer {
+    name: string;
+    transport: "stdio" | "http" | "sse";
+    ref?: string;
+}
+/** AIP-44 extensions on the agentskills.io baseline. Lives under `metadata.aip44`. */
+interface Aip44Extensions {
+    /** Commit SHA of upstream ACP repository this manifest validates against. */
+    acp_rev: string;
+    /** Capability tier shorthand. */
+    tier: AcpTier;
+    /** Optional explicit capability map; overrides tier defaults when present. */
+    capabilities?: AcpCapabilities;
+    /** AIP-9 OPERATOR.md ref. REQUIRED when kind=server. */
+    operator?: string;
+    /** AIP-7 GOVERNANCE.md ref. */
+    governance?: string;
+    /** AIP-36 SANDBOX.md ref. REQUIRED when tier=sandboxed. */
+    sandbox?: string;
+    /** Audit log target override. */
+    audit?: AcpAuditConfig;
+    /** MCP servers to mount via session/new.mcpServers. */
+    mcp_servers?: AcpMcpServer[];
+    /** AIP-44 extensions stay open; vendors MAY add namespaced sub-keys. */
+    [extension: string]: unknown;
+}
+/**
+ * AIP-44 ACP.md frontmatter. Top-level fields are stable across upstream
+ * ACP rev bumps; the AIP-44-specific binding layer lives in
+ * `metadata.aip44`.
+ */
+interface AcpDefinition {
+    /** Kebab id; MUST equal the parent directory name. */
+    name: string;
+    /** Stable runtime id. */
+    id: string;
+    /** One-paragraph purpose. */
+    description: string;
+    /** Semver of this manifest. */
+    version: string;
+    /** client = drives a subprocess; server = exposes an operator; bridge = both. */
+    kind: AcpRole;
+    /** Transport(s) supported. stdio is REQUIRED; websocket is OPTIONAL. */
+    transport: AcpTransport | AcpTransport[];
+    /** Free-form metadata. AIP-44 extensions live under `metadata.aip44`. */
+    metadata: {
+        aip44: Aip44Extensions;
+        [vendor: string]: unknown;
+    };
+    /** Optional tags for catalog ergonomics. */
+    tags?: string[];
+    /** Top-level extension surface preserved for forward compatibility. */
+    [extension: string]: unknown;
+}
+type AcpHandle = Readonly<AcpDefinition>;
+/**
+ * Canonical stream-event taxonomy emitted from `createAcpClient`. The
+ * client maps upstream ACP `session/update` notifications and
+ * `requestPermission` callbacks into this closed set so consumers
+ * never see protocol-specific shapes.
+ */
+type StreamEvent = {
+    kind: "text-delta";
+    sessionId: string;
+    text: string;
+} | {
+    kind: "tool-call";
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    arguments: unknown;
+} | {
+    kind: "tool-result";
+    sessionId: string;
+    toolCallId: string;
+    result: unknown;
+    isError?: boolean;
+} | {
+    kind: "thought";
+    sessionId: string;
+    text: string;
+} | {
+    kind: "agent-prompt";
+    sessionId: string;
+    toolCallId: string;
+    options: unknown;
+} | {
+    kind: "turn-end";
+    sessionId: string;
+    reason: "completed" | "cancelled" | "max_turns" | "error";
+} | {
+    kind: "error";
+    sessionId?: string;
+    error: {
+        code?: number;
+        message: string;
+        data?: unknown;
+    };
+};
+
+export type { AcpDefinition as A, StreamEvent as S, AcpAuditConfig as a, AcpCapabilities as b, AcpHandle as c, AcpMcpServer as d, AcpRole as e, AcpTier as f, AcpTransport as g, Aip44Extensions as h };

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@agentproto/acp",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/acp — AIP-44 ACP.md reference implementation. An agentproto profile of the Agent Client Protocol (agentclientprotocol.com). Wraps @agentclientprotocol/sdk with createAcpClient (drives subprocess agents) and createAcpServer (exposes AIP-9 operators to ACP-speaking IDEs).",
+  "keywords": [
+    "agentproto",
+    "aip-44",
+    "acp",
+    "agent-client-protocol",
+    "defineAcp",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-44",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/acp"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./manifest": {
+      "types": "./dist/manifest/index.d.ts",
+      "import": "./dist/manifest/index.mjs",
+      "default": "./dist/manifest/index.mjs"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "default": "./dist/client/index.mjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "default": "./dist/server/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.21.0",
+    "gray-matter": "^4.0.3",
+    "zod": "^4.3.6",
+    "@agentproto/define-doctype": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}