@tangle-network/agent-app 0.1.5 → 0.1.6

package/dist/chunk-SD2H4FWY.js

@@ -0,0 +1,43 @@
+// src/harness/index.ts
+var KNOWN_HARNESSES = [
+  "opencode",
+  "claude-code",
+  "kimi-code",
+  "codex",
+  "amp",
+  "factory-droids",
+  "pi",
+  "hermes",
+  "forge",
+  "openclaw",
+  "acp",
+  "cursor",
+  "cli-base"
+];
+var DEFAULT_HARNESS = "opencode";
+var HARNESS_SET = new Set(KNOWN_HARNESSES);
+function isHarness(value) {
+  return typeof value === "string" && HARNESS_SET.has(value);
+}
+function coerceHarness(value, fallback = DEFAULT_HARNESS) {
+  return isHarness(value) ? value : fallback;
+}
+function resolveSessionHarness(input = {}) {
+  const fallback = input.fallback ?? DEFAULT_HARNESS;
+  if (isHarness(input.sessionHarness)) {
+    const locked = input.sessionHarness;
+    const swapAttempted = isHarness(input.requested) && input.requested !== locked;
+    return { harness: locked, locked: true, swapAttempted };
+  }
+  const harness = coerceHarness(input.requested, coerceHarness(input.workspaceDefault, fallback));
+  return { harness, locked: false, swapAttempted: false };
+}
+
+export {
+  KNOWN_HARNESSES,
+  DEFAULT_HARNESS,
+  isHarness,
+  coerceHarness,
+  resolveSessionHarness
+};
+//# sourceMappingURL=chunk-SD2H4FWY.js.map

package/dist/chunk-SD2H4FWY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/harness/index.ts"],"sourcesContent":["/**\n * Coding-agent harness selection — taxonomy, coercion, and the session-lock invariant.\n *\n * A \"harness\" is the coding-agent CLI a sandbox drives (opencode / codex /\n * claude-code / …). The shell governs WHICH harness a chat session uses and\n * enforces that a session is LOCKED to the harness it started with — the model\n * may change mid-session, the harness may not (swapping it mid-session would\n * orphan the session's running agent state). Every product otherwise hand-rolls\n * this and hard-codes a single harness; this is the one place the rule lives.\n *\n * Substrate-free: the harness list mirrors the sandbox SDK's `BackendType` as a\n * plain string union (no sandbox dependency). The consumer owns storage — which\n * harness a workspace defaults to, which one a session locked — and maps the\n * resolved value onto the SDK's `backend.type`.\n */\n\n/** The known coding-agent backends. Mirrors `@tangle-network/sandbox`'s\n *  `BackendType`; kept structural so this module needs no sandbox dependency. */\nexport const KNOWN_HARNESSES = [\n  'opencode',\n  'claude-code',\n  'kimi-code',\n  'codex',\n  'amp',\n  'factory-droids',\n  'pi',\n  'hermes',\n  'forge',\n  'openclaw',\n  'acp',\n  'cursor',\n  'cli-base',\n] as const\n\nexport type Harness = (typeof KNOWN_HARNESSES)[number]\n\nexport const DEFAULT_HARNESS: Harness = 'opencode'\n\nconst HARNESS_SET: ReadonlySet<string> = new Set(KNOWN_HARNESSES)\n\nexport function isHarness(value: unknown): value is Harness {\n  return typeof value === 'string' && HARNESS_SET.has(value)\n}\n\n/** Coerce an arbitrary value to a known harness, falling back (default `opencode`). */\nexport function coerceHarness(value: unknown, fallback: Harness = DEFAULT_HARNESS): Harness {\n  return isHarness(value) ? value : fallback\n}\n\nexport interface ResolveSessionHarnessInput {\n  /** The harness already locked to this session (recorded at its first turn). */\n  sessionHarness?: unknown\n  /** The harness requested now — a new session's choice, or a turn's attempt to switch. */\n  requested?: unknown\n  /** The workspace's default harness, used only when starting a fresh session. */\n  workspaceDefault?: unknown\n  /** Final fallback when nothing else resolves (default `opencode`). */\n  fallback?: Harness\n}\n\nexport interface ResolvedSessionHarness {\n  /** The harness to actually run — the locked one when the session already has it. */\n  harness: Harness\n  /** True when the session already had a locked harness (this turn did not pick it). */\n  locked: boolean\n  /** True when `requested` differs from the locked harness — a forbidden mid-session\n   *  swap the caller should reject or warn on. The lock always wins regardless. */\n  swapAttempted: boolean\n}\n\n/**\n * Resolve the harness for a turn, enforcing the session lock.\n *\n * - **Session already started** (`sessionHarness` is a known harness): that harness\n *   wins (`locked: true`); a differing `requested` sets `swapAttempted` so the caller\n *   can reject the swap. The model is a separate per-turn concern and is unaffected.\n * - **Fresh session**: pick `requested → workspaceDefault → fallback`. The caller\n *   persists the result as the session's lock for every subsequent turn.\n */\nexport function resolveSessionHarness(input: ResolveSessionHarnessInput = {}): ResolvedSessionHarness {\n  const fallback = input.fallback ?? DEFAULT_HARNESS\n  if (isHarness(input.sessionHarness)) {\n    const locked = input.sessionHarness\n    const swapAttempted = isHarness(input.requested) && input.requested !== locked\n    return { harness: locked, locked: true, swapAttempted }\n  }\n  const harness = coerceHarness(input.requested, coerceHarness(input.workspaceDefault, fallback))\n  return { harness, locked: false, swapAttempted: false }\n}\n"],"mappings":";AAkBO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,IAAM,kBAA2B;AAExC,IAAM,cAAmC,IAAI,IAAI,eAAe;AAEzD,SAAS,UAAU,OAAkC;AAC1D,SAAO,OAAO,UAAU,YAAY,YAAY,IAAI,KAAK;AAC3D;AAGO,SAAS,cAAc,OAAgB,WAAoB,iBAA0B;AAC1F,SAAO,UAAU,KAAK,IAAI,QAAQ;AACpC;AAgCO,SAAS,sBAAsB,QAAoC,CAAC,GAA2B;AACpG,QAAM,WAAW,MAAM,YAAY;AACnC,MAAI,UAAU,MAAM,cAAc,GAAG;AACnC,UAAM,SAAS,MAAM;AACrB,UAAM,gBAAgB,UAAU,MAAM,SAAS,KAAK,MAAM,cAAc;AACxE,WAAO,EAAE,SAAS,QAAQ,QAAQ,MAAM,cAAc;AAAA,EACxD;AACA,QAAM,UAAU,cAAc,MAAM,WAAW,cAAc,MAAM,kBAAkB,QAAQ,CAAC;AAC9F,SAAO,EAAE,SAAS,QAAQ,OAAO,eAAe,MAAM;AACxD;","names":[]}

package/dist/harness/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Coding-agent harness selection — taxonomy, coercion, and the session-lock invariant.
+ *
+ * A "harness" is the coding-agent CLI a sandbox drives (opencode / codex /
+ * claude-code / …). The shell governs WHICH harness a chat session uses and
+ * enforces that a session is LOCKED to the harness it started with — the model
+ * may change mid-session, the harness may not (swapping it mid-session would
+ * orphan the session's running agent state). Every product otherwise hand-rolls
+ * this and hard-codes a single harness; this is the one place the rule lives.
+ *
+ * Substrate-free: the harness list mirrors the sandbox SDK's `BackendType` as a
+ * plain string union (no sandbox dependency). The consumer owns storage — which
+ * harness a workspace defaults to, which one a session locked — and maps the
+ * resolved value onto the SDK's `backend.type`.
+ */
+/** The known coding-agent backends. Mirrors `@tangle-network/sandbox`'s
+ *  `BackendType`; kept structural so this module needs no sandbox dependency. */
+declare const KNOWN_HARNESSES: readonly ["opencode", "claude-code", "kimi-code", "codex", "amp", "factory-droids", "pi", "hermes", "forge", "openclaw", "acp", "cursor", "cli-base"];
+type Harness = (typeof KNOWN_HARNESSES)[number];
+declare const DEFAULT_HARNESS: Harness;
+declare function isHarness(value: unknown): value is Harness;
+/** Coerce an arbitrary value to a known harness, falling back (default `opencode`). */
+declare function coerceHarness(value: unknown, fallback?: Harness): Harness;
+interface ResolveSessionHarnessInput {
+    /** The harness already locked to this session (recorded at its first turn). */
+    sessionHarness?: unknown;
+    /** The harness requested now — a new session's choice, or a turn's attempt to switch. */
+    requested?: unknown;
+    /** The workspace's default harness, used only when starting a fresh session. */
+    workspaceDefault?: unknown;
+    /** Final fallback when nothing else resolves (default `opencode`). */
+    fallback?: Harness;
+}
+interface ResolvedSessionHarness {
+    /** The harness to actually run — the locked one when the session already has it. */
+    harness: Harness;
+    /** True when the session already had a locked harness (this turn did not pick it). */
+    locked: boolean;
+    /** True when `requested` differs from the locked harness — a forbidden mid-session
+     *  swap the caller should reject or warn on. The lock always wins regardless. */
+    swapAttempted: boolean;
+}
+/**
+ * Resolve the harness for a turn, enforcing the session lock.
+ *
+ * - **Session already started** (`sessionHarness` is a known harness): that harness
+ *   wins (`locked: true`); a differing `requested` sets `swapAttempted` so the caller
+ *   can reject the swap. The model is a separate per-turn concern and is unaffected.
+ * - **Fresh session**: pick `requested → workspaceDefault → fallback`. The caller
+ *   persists the result as the session's lock for every subsequent turn.
+ */
+declare function resolveSessionHarness(input?: ResolveSessionHarnessInput): ResolvedSessionHarness;
+
+export { DEFAULT_HARNESS, type Harness, KNOWN_HARNESSES, type ResolveSessionHarnessInput, type ResolvedSessionHarness, coerceHarness, isHarness, resolveSessionHarness };

package/dist/harness/index.js

@@ -0,0 +1,15 @@
+import {
+  DEFAULT_HARNESS,
+  KNOWN_HARNESSES,
+  coerceHarness,
+  isHarness,
+  resolveSessionHarness
+} from "../chunk-SD2H4FWY.js";
+export {
+  DEFAULT_HARNESS,
+  KNOWN_HARNESSES,
+  coerceHarness,
+  isHarness,
+  resolveSessionHarness
+};
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { AppToolLoopOptions, LoopEvent, LoopToolCall, OpenAICompatStreamTurnOpti
 export { createTokenRecallChecker, producedFromToolEvents } from './eval/index.js';
 export { KnowledgeRequirementSpec, KnowledgeSignal, KnowledgeStateAccessor, SatisfiedByRule, buildKnowledgeRequirements, deriveSignals } from './knowledge/index.js';
 export { CreateKnowledgeLoopDeps, KnowledgeCandidate, KnowledgeDecider, KnowledgeDeciderInput, KnowledgeDecision, KnowledgeGateVerdict, KnowledgeLoop, KnowledgeLoopDriver, createKnowledgeLoop, createReviewerDecider, reviewCandidate } from './knowledge-loop/index.js';
+export { DEFAULT_HARNESS, Harness, KNOWN_HARNESSES, ResolveSessionHarnessInput, ResolvedSessionHarness, coerceHarness, isHarness, resolveSessionHarness } from './harness/index.js';
 export { AgentAppConfig, AgentDelegationConfig, AgentIdentityConfig, AgentIntegrationsConfig, AgentKnowledgeConfig, AgentTaxonomyConfig, AgentUiConfig, KnowledgeLoopConfig, KnowledgeSourceSpec, agentAppConfigJsonSchema, defineAgentApp } from './config/index.js';
 export { D1Like, D1PreparedLike, DrizzleColumnLike, DrizzleSqliteCoreLike, PRESET_MIGRATION_SQL, PRESET_TABLES, PresetBillingOptions, PresetKnowledgeAccessorOptions, PresetToolHandlerOptions, VaultKv, createD1KnowledgeStateAccessor, createPresetDrizzleSchema, createPresetFieldCrypto, createPresetToolHandlers, createPresetWorkspaceKeyManager, createPresetWorkspaceKeyStore } from './preset-cloudflare/index.js';
 export { KeyCrypto, KeyProvisioner, PlanLimit, PlatformBalanceInfo, PlatformBalanceManager, PlatformBalanceManagerOptions, PlatformBillingClient, PlatformIdentity, PlatformProductUsage, SharedBillingState, WorkspaceKeyManager, WorkspaceKeyManagerOptions, WorkspaceKeyRecord, WorkspaceKeyStore, WorkspaceModelKeyUsage, createPlatformBalanceManager, createWorkspaceKeyManager } from './billing/index.js';

package/dist/index.js

@@ -1,3 +1,13 @@
+import {
+  redactForIngestion
+} from "./chunk-C5CREGT2.js";
+import {
+  DEFAULT_HARNESS,
+  KNOWN_HARNESSES,
+  coerceHarness,
+  isHarness,
+  resolveSessionHarness
+} from "./chunk-SD2H4FWY.js";
 import {
   agentAppConfigJsonSchema,
   defineAgentApp
@@ -56,9 +66,6 @@ import {
   parseJsonObjectBody,
   requireString
 } from "./chunk-CN75FIPT.js";
-import {
-  redactForIngestion
-} from "./chunk-C5CREGT2.js";
 import {
   APP_TOOL_NAMES,
   DEFAULT_APP_TOOL_PATHS,
@@ -115,11 +122,13 @@ import {
 export {
   APP_TOOL_NAMES,
   DEFAULT_APP_TOOL_PATHS,
+  DEFAULT_HARNESS,
   DEFAULT_HEADER_NAMES,
   DEFAULT_TANGLE_ROUTER_BASE_URL,
   DELEGATION_MCP_SERVER_KEY,
   DELEGATION_TOOLS,
   HubExecClient,
+  KNOWN_HARNESSES,
   PRESET_MIGRATION_SQL,
   PRESET_TABLES,
   ToolInputError,
@@ -136,6 +145,7 @@ export {
   buildKnowledgeRequirements,
   buildUserTextParts,
   checkRateLimit,
+  coerceHarness,
   createAppToolRuntimeExecutor,
   createBrokerTokenProvider,
   createCapabilityToken,
@@ -173,6 +183,7 @@ export {
   handleAppToolRequest,
   invokeIntegrationHub,
   isAppToolName,
+  isHarness,
   mergePersistedPart,
   messageHasTurnId,
   normalizeClientTurnId,
@@ -187,6 +198,7 @@ export {
   requireString,
   resolveChatTurn,
   resolveIntegrationAction,
+  resolveSessionHarness,
   resolveTangleModelConfig,
   resolveToolId,
   resolveToolName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "packageManager": "pnpm@10.33.4",
   "description": "Application-shell framework for Tangle agent products: a bounded tool loop, the structured agent→app tool side channel, integration-hub client, per-workspace billing, and crypto — composed over the Tangle agent substrate through typed seams.",
   "keywords": [
@@ -76,6 +76,11 @@
       "import": "./dist/knowledge-loop/index.js",
       "default": "./dist/knowledge-loop/index.js"
     },
+    "./harness": {
+      "types": "./dist/harness/index.d.ts",
+      "import": "./dist/harness/index.js",
+      "default": "./dist/harness/index.js"
+    },
     "./preset-cloudflare": {
       "types": "./dist/preset-cloudflare/index.d.ts",
       "import": "./dist/preset-cloudflare/index.js",