@sweny-ai/core 0.1.148 → 0.1.149

package/dist/harness/agents.d.ts

@@ -6,6 +6,10 @@
  */
 export declare const SUPPORTED_AGENTS: readonly ["claude", "codex", "pi"];
 export type SupportedAgent = (typeof SUPPORTED_AGENTS)[number];
-export declare function isSupportedAgent(id: string): id is SupportedAgent;
+/** `acp:<command>` (#416): any Agent Client Protocol agent, started with `<command>`. */
+export type AcpAgentId = `acp:${string}`;
+/** The command of an `acp:<command>` agent id (`"opencode acp"` for `acp:opencode acp`), or undefined when it is not one or the command is empty. */
+export declare function parseAcpAgent(id: string): string | undefined;
+export declare function isSupportedAgent(id: string): id is SupportedAgent | AcpAgentId;
 /** The error for an agent id with no adapter. */
 export declare function unsupportedAgentError(id: string): string;

package/dist/harness/agents.js

@@ -5,8 +5,15 @@
  * the harness factory share it).
  */
 export const SUPPORTED_AGENTS = ["claude", "codex", "pi"];
+/** The command of an `acp:<command>` agent id (`"opencode acp"` for `acp:opencode acp`), or undefined when it is not one or the command is empty. */
+export function parseAcpAgent(id) {
+    if (!id.startsWith("acp:"))
+        return undefined;
+    const command = id.slice("acp:".length).trim();
+    return command === "" ? undefined : command;
+}
 export function isSupportedAgent(id) {
-    return SUPPORTED_AGENTS.includes(id);
+    return SUPPORTED_AGENTS.includes(id) || parseAcpAgent(id) !== undefined;
 }
 /** The error for an agent id with no adapter. */
 export function unsupportedAgentError(id) {

package/dist/harness/capabilities.d.ts

@@ -56,3 +56,33 @@ export declare const CODEX_CAPABILITIES: HarnessCapabilities;
  * - cancel rpc: the `abort` command, then SIGTERM and SIGKILL.
  */
 export declare const PI_CAPABILITIES: HarnessCapabilities;
+/**
+ * Any ACP agent (`--agent acp:<command>`, #416), declared from the Agent
+ * Client Protocol schema v1.24.1 (agentclientprotocol/agent-client-protocol,
+ * `schema/v1/schema.json`, docs under `docs/protocol/v1/`) and probed by the
+ * contract suite against a scripted fake agent. ACP is the long-tail adapter:
+ * the protocol carries a prompt and a stream of updates, not sweny's opinions.
+ * - structuredOutput prompt: `PromptResponse` has only `stopReason`, so there
+ *   is no schema channel. sweny asks for the JSON in the prompt, parses it,
+ *   checks it and retries once.
+ * - toolTrace full: `tool_call` and `tool_call_update` session updates carry an
+ *   id, a kind, a status and (optionally) raw input and content.
+ * - builtinDeny none: the protocol has no tool allow or deny list. The only
+ *   hook is `session/request_permission`, which fires only when the agent
+ *   chooses to ask. sweny answers it by policy (best effort), but cannot
+ *   promise the agent asks, so nothing is declared.
+ * - mcp inject, exclusive none: `session/new` takes `mcpServers`, but whether
+ *   the agent also loads its own MCP config is agent-defined.
+ * - sandbox none: nothing in the protocol. The process wrapper (srt) is the
+ *   only containment, see sandbox-wrapper.ts.
+ * - readOnly none: modes are agent-defined. `policyGate` counts read-only as
+ *   enforced only with the wrapper's read-only mount.
+ * - turnLimit watchdog: no turn limit in the protocol; sweny counts tool calls.
+ * - usage costUsd only: `usage_update {used, size, cost?}` is the stable
+ *   usage. `used` and `size` are context window occupancy, not billed tokens,
+ *   so they are not mapped; `cost` (cumulative, ISO 4217 currency) is, when it
+ *   is USD. Per-turn token usage is behind an unstable flag.
+ * - cancel rpc: `session/cancel`, then kill.
+ * - resume false: sweny starts a fresh session per node.
+ */
+export declare const ACP_CAPABILITIES: HarnessCapabilities;

package/dist/harness/capabilities.js

@@ -90,3 +90,44 @@ export const PI_CAPABILITIES = {
     cancel: "rpc",
     resume: false,
 };
+/**
+ * Any ACP agent (`--agent acp:<command>`, #416), declared from the Agent
+ * Client Protocol schema v1.24.1 (agentclientprotocol/agent-client-protocol,
+ * `schema/v1/schema.json`, docs under `docs/protocol/v1/`) and probed by the
+ * contract suite against a scripted fake agent. ACP is the long-tail adapter:
+ * the protocol carries a prompt and a stream of updates, not sweny's opinions.
+ * - structuredOutput prompt: `PromptResponse` has only `stopReason`, so there
+ *   is no schema channel. sweny asks for the JSON in the prompt, parses it,
+ *   checks it and retries once.
+ * - toolTrace full: `tool_call` and `tool_call_update` session updates carry an
+ *   id, a kind, a status and (optionally) raw input and content.
+ * - builtinDeny none: the protocol has no tool allow or deny list. The only
+ *   hook is `session/request_permission`, which fires only when the agent
+ *   chooses to ask. sweny answers it by policy (best effort), but cannot
+ *   promise the agent asks, so nothing is declared.
+ * - mcp inject, exclusive none: `session/new` takes `mcpServers`, but whether
+ *   the agent also loads its own MCP config is agent-defined.
+ * - sandbox none: nothing in the protocol. The process wrapper (srt) is the
+ *   only containment, see sandbox-wrapper.ts.
+ * - readOnly none: modes are agent-defined. `policyGate` counts read-only as
+ *   enforced only with the wrapper's read-only mount.
+ * - turnLimit watchdog: no turn limit in the protocol; sweny counts tool calls.
+ * - usage costUsd only: `usage_update {used, size, cost?}` is the stable
+ *   usage. `used` and `size` are context window occupancy, not billed tokens,
+ *   so they are not mapped; `cost` (cumulative, ISO 4217 currency) is, when it
+ *   is USD. Per-turn token usage is behind an unstable flag.
+ * - cancel rpc: `session/cancel`, then kill.
+ * - resume false: sweny starts a fresh session per node.
+ */
+export const ACP_CAPABILITIES = {
+    structuredOutput: "prompt",
+    toolTrace: "full",
+    builtinDeny: "none",
+    mcp: { inject: true, exclusive: "none" },
+    sandbox: { fs: false, network: false },
+    readOnly: "none",
+    turnLimit: "watchdog",
+    usage: { tokens: false, costUsd: true, live: false },
+    cancel: "rpc",
+    resume: false,
+};

package/dist/harness/index.d.ts

@@ -4,6 +4,7 @@
  */
 import { ClaudeCodeHarness, type ClaudeCodeHarnessOptions } from "./claude-code.js";
 import { CodexHarness, type CodexHarnessOptions } from "./codex.js";
+import { AcpHarness, type AcpHarnessOptions } from "./acp.js";
 import { PiHarness, type PiHarnessOptions } from "./pi.js";
 export { claudeCompat, asClaude } from "./compat.js";
 export type { AgentHarness, HarnessCapabilities, HarnessCompleteRequest, HarnessId, HarnessInfo, HarnessRunRequest, HarnessRunResult, NodePolicy, PolicyGateResult, PolicyWrappers, ToolClass, } from "./types.js";
@@ -14,12 +15,14 @@ export { ClaudeCodeHarness, CLAUDE_CODE_CAPABILITIES } from "./claude-code.js";
 export type { ClaudeCodeHarnessOptions } from "./claude-code.js";
 export { CodexHarness, CODEX_CAPABILITIES, MIN_CODEX_VERSION } from "./codex.js";
 export type { CodexHarnessOptions } from "./codex.js";
+export { AcpHarness, ACP_CAPABILITIES, ACP_PROTOCOL_VERSION } from "./acp.js";
+export type { AcpHarnessOptions } from "./acp.js";
 export { PiHarness, PI_CAPABILITIES, MIN_PI_VERSION } from "./pi.js";
 export type { PiHarnessOptions } from "./pi.js";
 export { startToolBridge } from "./tool-bridge/server.js";
 export type { ToolBridge, ToolBridgeOptions } from "./tool-bridge/server.js";
-export { SUPPORTED_AGENTS, isSupportedAgent, unsupportedAgentError } from "./agents.js";
-export type { SupportedAgent } from "./agents.js";
+export { SUPPORTED_AGENTS, isSupportedAgent, parseAcpAgent, unsupportedAgentError } from "./agents.js";
+export type { AcpAgentId, SupportedAgent } from "./agents.js";
 /**
  * Build the harness for an agent id. `claude` is the historical `--agent` /
  * `coding-agent-provider` value and means the same as `claude-code`.
@@ -28,4 +31,5 @@ export type { SupportedAgent } from "./agents.js";
 export declare function createHarness(id: "claude" | "claude-code", opts?: ClaudeCodeHarnessOptions): ClaudeCodeHarness;
 export declare function createHarness(id: "codex", opts?: CodexHarnessOptions): CodexHarness;
 export declare function createHarness(id: "pi", opts?: PiHarnessOptions): PiHarness;
-export declare function createHarness(id: string, opts?: ClaudeCodeHarnessOptions & CodexHarnessOptions & PiHarnessOptions): ClaudeCodeHarness | CodexHarness | PiHarness;
+export declare function createHarness(id: `acp:${string}`, opts?: AcpHarnessOptions): AcpHarness;
+export declare function createHarness(id: string, opts?: ClaudeCodeHarnessOptions & CodexHarnessOptions & PiHarnessOptions & AcpHarnessOptions): ClaudeCodeHarness | CodexHarness | PiHarness | AcpHarness;

package/dist/harness/index.js

@@ -4,17 +4,22 @@
  */
 import { ClaudeCodeHarness } from "./claude-code.js";
 import { CodexHarness } from "./codex.js";
+import { AcpHarness } from "./acp.js";
 import { PiHarness } from "./pi.js";
-import { unsupportedAgentError } from "./agents.js";
+import { parseAcpAgent, unsupportedAgentError } from "./agents.js";
 export { claudeCompat, asClaude } from "./compat.js";
 export { policyGate, nativeDenyClasses, resolveHarnessPolicy, isToolClass, TOOL_CLASSES } from "./policy.js";
 export { ask, evaluate, buildAskPrompt, buildEvaluatePrompt } from "./prompts.js";
 export { ClaudeCodeHarness, CLAUDE_CODE_CAPABILITIES } from "./claude-code.js";
 export { CodexHarness, CODEX_CAPABILITIES, MIN_CODEX_VERSION } from "./codex.js";
+export { AcpHarness, ACP_CAPABILITIES, ACP_PROTOCOL_VERSION } from "./acp.js";
 export { PiHarness, PI_CAPABILITIES, MIN_PI_VERSION } from "./pi.js";
 export { startToolBridge } from "./tool-bridge/server.js";
-export { SUPPORTED_AGENTS, isSupportedAgent, unsupportedAgentError } from "./agents.js";
+export { SUPPORTED_AGENTS, isSupportedAgent, parseAcpAgent, unsupportedAgentError } from "./agents.js";
 export function createHarness(id, opts = {}) {
+    // `acp:<command>` (#416): any ACP agent. An empty command is an error, not a fallback.
+    if (id.startsWith("acp:"))
+        return new AcpHarness({ ...opts, acpCommand: parseAcpAgent(id) ?? "" });
     switch (id) {
         case "claude":
         case "claude-code":

package/dist/harness/parse.d.ts

@@ -47,3 +47,15 @@ export declare function summarizeToolError(parsed: unknown): string;
  * non-conforming model answer is at least attributable.
  */
 export declare function tryParseJSON(text: string, outputSchema?: JSONSchema, logger?: Pick<Logger, "warn">, label?: string): Record<string, unknown>;
+/**
+ * Lightweight structural check of a parsed object against a JSON Schema.
+ *
+ * Deliberately shallow: it verifies `required` keys are present and that the
+ * top-level `type` and each declared property `type` match. It does NOT do
+ * full JSON Schema validation (no `$ref`, `oneOf`, formats, nested arrays).
+ * The contract here is "flag an obviously non-conforming object" so a mismatch
+ * is logged rather than silently accepted; it is not a validation gate.
+ *
+ * Returns a list of human-readable problems; empty means no detected mismatch.
+ */
+export declare function schemaMismatches(value: unknown, schema: JSONSchema): string[];

package/dist/harness/parse.js

@@ -195,7 +195,7 @@ export function tryParseJSON(text, outputSchema, logger, label = "Claude") {
  *
  * Returns a list of human-readable problems; empty means no detected mismatch.
  */
-function schemaMismatches(value, schema) {
+export function schemaMismatches(value, schema) {
     const problems = [];
     const s = schema;
     if (s.type === "object" || s.properties || s.required) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sweny-ai/core",
-  "version": "0.1.148",
+  "version": "0.1.149",
   "type": "module",
   "bin": {
     "sweny": "./dist/cli/main.js"