@tangle-network/agent-interface 5.5.0 → 5.6.1

package/dist/harness-capabilities.d.ts

@@ -7,7 +7,7 @@ import type { HarnessType } from "./harness.js";
  *   3. system-prompt intents (whether a harness can replace its own prompt, add to it, or neither).
  *
  * All are facets of the same question — "what can this (harness, model) pair actually do" — and
- * apply to BOTH harness-backed systems (vendor-locked CLIs like claude-code/codex/kimi) AND
+ * apply to BOTH harness-backed systems (CLIs that speak a vendor wire, like claude-code, codex and kimi-code) AND
  * router-backed systems (opencode, cli-base: any model the router serves). Lifted here so the
  * cli-bridge backends, the sandbox UI pickers, and the router all read one truth instead of each
  * hand-rolling a divergent copy.
@@ -91,7 +91,7 @@ export declare function harnessModelSupport(harness: HarnessType, modelId: strin
  * Whether a harness can run a model; {@link harnessModelSupport} gives the reason when it cannot.
  */
 export declare function harnessSupportsModel(harness: HarnessType, modelId: string, options?: HarnessModelSupportOptions): boolean;
-/** The harness to adopt for a model whose provider is vendor-locked (`anthropic` → `claude-code`,
+/** The harness a vendor's model adopts when the caller names none (`anthropic` → `claude-code`,
  *  `openai` → `codex`, `moonshot` → `kimi-code`); `null` when any router-backed harness will do. */
 export declare function preferredHarnessForModel(modelId: string): HarnessType | null;
 /**
@@ -104,8 +104,7 @@ export declare function preferredHarnessForModel(modelId: string): HarnessType |
 export declare function snapModelToHarness(harness: HarnessType, modelId: string, candidateIds: readonly string[]): string;
 /**
  * Keep the harness when it can run `modelId`; otherwise return the model's native harness
- * (anthropic → claude-code, openai → codex, moonshot → kimi-code), falling back to the router-backed
- * `opencode` for everything else.
+ * ({@link vendorHarness}), falling back to the router-backed `opencode` for everything else.
  */
 export declare function snapHarnessToModel(harness: HarnessType, modelId: string): HarnessType;
 /** The reasoning efforts a harness can express, independent of model — its explicit override set, or

package/dist/harness-capabilities.js

@@ -6,7 +6,7 @@ import { REASONING_EFFORTS, } from "./agent-profile.js";
  *   3. system-prompt intents (whether a harness can replace its own prompt, add to it, or neither).
  *
  * All are facets of the same question — "what can this (harness, model) pair actually do" — and
- * apply to BOTH harness-backed systems (vendor-locked CLIs like claude-code/codex/kimi) AND
+ * apply to BOTH harness-backed systems (CLIs that speak a vendor wire, like claude-code, codex and kimi-code) AND
  * router-backed systems (opencode, cli-base: any model the router serves). Lifted here so the
  * cli-bridge backends, the sandbox UI pickers, and the router all read one truth instead of each
  * hand-rolling a divergent copy.
@@ -20,19 +20,36 @@ import { REASONING_EFFORTS, } from "./agent-profile.js";
 export const reasoningLadder = REASONING_EFFORTS;
 // ── Harness ↔ model compatibility ────────────────────────────────────────────
 /**
- * Provider prefixes a harness is vendor-locked to (canonical-id prefix, e.g. `anthropic`, `openai`).
- * A harness with no entry is router-backed: it runs any model, except the measured exclusions in
+ * Provider prefixes a harness is vendor-locked to (canonical-id prefix, e.g. `moonshot`). A harness
+ * with no entry is router-backed: it runs any model, except the measured exclusions in
  * {@link harnessModelExclusions}.
  *
+ * `claude-code` and `codex` are deliberately absent. Their CLIs speak a vendor wire (Anthropic
+ * Messages, OpenAI Responses), but the Tangle Router passes only that vendor's own models through
+ * natively and translates every other model on those wires to chat completions (text, images and
+ * function tools, streamed or not; hosted tools are dropped), so both run any router-served model.
+ * A caller's own vendor key or login still serves that vendor's models alone, which this table does
+ * not see. Which harness a vendor's model adopts when the caller names none is
+ * {@link vendorHarness}, a separate fact.
+ *
  * `nanoclaw` is deliberately absent despite the "claw" name: its runner routes every provider through
  * the Tangle router (canonical model id straight to the gateway), so it is router-backed like
  * `opencode` — not Anthropic-locked.
  */
 const harnessProviderLock = {
-    "claude-code": ["anthropic"],
-    codex: ["openai"],
     "kimi-code": ["moonshot"],
 };
+/**
+ * The harness that natively speaks a vendor's models. A model of that vendor adopts it when the
+ * caller names no harness ({@link preferredHarnessForModel}), and a locked harness handed such a
+ * model switches to it ({@link snapHarnessToModel}). It is not a restriction: `claude-code` and
+ * `codex` also run other providers' models through the router.
+ */
+const vendorHarness = {
+    anthropic: "claude-code",
+    openai: "codex",
+    moonshot: "kimi-code",
+};
 /** Provider prefix of a canonical model id (`anthropic/claude-…` → `anthropic`), or null. */
 export function modelProvider(modelId) {
     const slash = modelId.indexOf("/");
@@ -169,17 +186,11 @@ export function harnessModelSupport(harness, modelId, options = {}) {
 export function harnessSupportsModel(harness, modelId, options) {
     return harnessModelSupport(harness, modelId, options).supported;
 }
-/** The harness to adopt for a model whose provider is vendor-locked (`anthropic` → `claude-code`,
+/** The harness a vendor's model adopts when the caller names none (`anthropic` → `claude-code`,
  *  `openai` → `codex`, `moonshot` → `kimi-code`); `null` when any router-backed harness will do. */
 export function preferredHarnessForModel(modelId) {
     const provider = resolveModelProvider(modelId);
-    if (!provider)
-        return null;
-    for (const [harness, providers] of Object.entries(harnessProviderLock)) {
-        if (providers?.includes(provider))
-            return harness;
-    }
-    return null;
+    return provider ? (vendorHarness[provider] ?? null) : null;
 }
 // ── Harness ↔ model snapping (catalog-aware) ─────────────────────────────────
 /**
@@ -188,12 +199,6 @@ export function preferredHarnessForModel(modelId) {
  * harness never snaps (it runs the model as-is).
  */
 const harnessPreferredModelPatterns = {
-    "claude-code": [
-        /^anthropic\/claude-opus-[\d.-]+$/,
-        /^anthropic\/claude-sonnet-[\d.-]+$/,
-        /^anthropic\//,
-    ],
-    codex: [/^openai\/gpt-\d+(\.\d+)?$/, /^openai\/gpt/, /^openai\//],
     "kimi-code": [/^moonshot\//],
 };
 const numericDesc = new Intl.Collator(undefined, {
@@ -222,8 +227,7 @@ export function snapModelToHarness(harness, modelId, candidateIds) {
 }
 /**
  * Keep the harness when it can run `modelId`; otherwise return the model's native harness
- * (anthropic → claude-code, openai → codex, moonshot → kimi-code), falling back to the router-backed
- * `opencode` for everything else.
+ * ({@link vendorHarness}), falling back to the router-backed `opencode` for everything else.
  */
 export function snapHarnessToModel(harness, modelId) {
     if (harnessSupportsModel(harness, modelId))

package/dist/harness.d.ts

@@ -1,27 +1,16 @@
 import { z } from "zod";
 /**
- * The execution runner for an agent — WHICH runtime materializes and runs an `AgentProfile`.
+ * Recognized execution identities, not a deployment's list of installed runners.
+ * A profile's authored harness remains part of its canonical identity; execution
+ * receipts record authored identity, effective identity and selected harness
+ * separately. Retiring an executable must not invalidate historical profiles,
+ * sessions or receipts. Availability is admitted against the selected deployment.
  *
- * This enum describes an EXECUTION concern. When an `AgentProfile` authors a `harness`
- * preference, that field participates in its canonical identity like every other parsed profile
- * field. A caller or executor may override the preference for one run, but the execution receipt
- * preserves the authored identity, effective identity, and selected harness separately. This is
- * the single shared enum every layer references instead of keeping its own copy (session control,
- * the profile materializer, the cli-bridge backends, VB profile specs).
- *
- * `cli-base` is the router-backed mode — a plain multi-turn router call (a reviewer, a cheap judge,
- * a one-shot) with no full coding-agent harness. The rest are full agentic harnesses run in a
- * sandbox or locally via the CLI bridge.
- *
- * `forge` (tailcallhq/forgecode) and `cursor` (cursor-agent) are multi-provider CLI harnesses with
- * no vendor lock, so they carry no entry in the capability tables and resolve as router-backed.
- *
- * `prime` (PrimeIntellect-ai/prime-agent) is the prime fork of the pi line — the RLM
- * IPython-kernel harness. It is a distinct harness from `pi`: the fork's wire protocol has
- * diverged (its daemon rejects pi-line clients), so the two are not interchangeable at run time.
+ * `cli-base` names router-backed execution without a full coding-agent harness.
+ * `prime` is a distinct Pi-line fork with a different native wire protocol; its
+ * sessions are not interchangeable with Pi sessions. A shared identity does not
+ * assert protocol, model, profile-control or native-resume compatibility.
  */
-export type HarnessType = "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "prime" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
-/** Runtime validator for {@link HarnessType}. Kept in lockstep with the type by the drift guard below. */
 export declare const harnessTypeSchema: z.ZodEnum<{
     acp: "acp";
     amp: "amp";
@@ -40,3 +29,5 @@ export declare const harnessTypeSchema: z.ZodEnum<{
     pi: "pi";
     prime: "prime";
 }>;
+/** One declaration owns runtime validation and the compile-time vocabulary. */
+export type HarnessType = z.infer<typeof harnessTypeSchema>;

package/dist/harness.js

@@ -1,5 +1,16 @@
 import { z } from "zod";
-/** Runtime validator for {@link HarnessType}. Kept in lockstep with the type by the drift guard below. */
+/**
+ * Recognized execution identities, not a deployment's list of installed runners.
+ * A profile's authored harness remains part of its canonical identity; execution
+ * receipts record authored identity, effective identity and selected harness
+ * separately. Retiring an executable must not invalidate historical profiles,
+ * sessions or receipts. Availability is admitted against the selected deployment.
+ *
+ * `cli-base` names router-backed execution without a full coding-agent harness.
+ * `prime` is a distinct Pi-line fork with a different native wire protocol; its
+ * sessions are not interchangeable with Pi sessions. A shared identity does not
+ * assert protocol, model, profile-control or native-resume compatibility.
+ */
 export const harnessTypeSchema = z.enum([
     "claude-code",
     "nanoclaw",
@@ -18,5 +29,3 @@ export const harnessTypeSchema = z.enum([
     "acp",
     "cli-base",
 ]);
-const _harnessSchemaMatchesType = true;
-void _harnessSchemaMatchesType;

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export * from "./host-services.js";
 export * from "./mcp.js";
 export * from "./provider-adapter.js";
 export type * from "./environment-provider.js";
-export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, ResourceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
+export { AgentEnvironmentCapabilitiesSchema, AgentEnvironmentReadOnlyGetOptionsSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, ResourceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
 export * from "./plan.js";
 export * from "./runtime-control.js";
 export * from "./portable-context.js";

package/dist/index.js

@@ -8,7 +8,7 @@ export * from "./provider-config.js";
 export * from "./host-services.js";
 export * from "./mcp.js";
 export * from "./provider-adapter.js";
-export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, ResourceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
+export { AgentEnvironmentCapabilitiesSchema, AgentEnvironmentReadOnlyGetOptionsSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, ResourceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
 export * from "./plan.js";
 export * from "./runtime-control.js";
 export * from "./portable-context.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "5.5.0",
+  "version": "5.6.1",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",