@tangle-network/agent-interface 5.7.1 → 5.8.0

package/README.md

@@ -12,8 +12,10 @@ across subscriptions. Each stage pins a harness, provider, model, and account
 selector. `all-eligible` lets the account manager choose each available seat in
 its own order; `seat` names one account. The first stage must equal the profile's
 top-level `harness`, `model.provider`, and `model.default`, so the initial run
-cannot silently change its authored model. The profile's reasoning effort and
-system prompt intent must be supported by every stage. The executor must check
+cannot silently change its authored model. Each stage inherits `model.reasoningEffort`
+unless it declares `reasoningEffort`; explicit `none` disables thinking where the
+harness supports it. An explicit first-stage effort must equal the profile's.
+Every stage must support its effective effort and the profile's system prompt intent. The executor must check
 the remaining profile capabilities and resolve seats before spend.
 
 An omitted `seats` field preserves the legacy single-provider policy. For each
@@ -22,6 +24,13 @@ provider-facing projection without `seats`, setting its top-level harness and
 model to the selected stage. A cross-provider continuation requires an explicit
 stage in the authored chain.
 
+`parseSeatSpec("codex/gpt-6.1-sol@xhigh")` and `formatSeatSpec(spec)` share the
+`harness/model[@effort]` command grammar. They are exported at the package root
+and `harness-capabilities`. `claude` and `kimi` resolve to canonical harness names;
+the authored model remains unchanged, including explicit provider prefixes.
+The parsed `provider` is null when the model's provider is unknown. These pure
+helpers do not choose accounts, rank models, load credentials, or fill omitted effort.
+
 Each later stage may replace the profile-level `tools` and `permissions` maps.
 An explicit `{}` removes those profile-level controls for that stage; an omitted
 map inherits them. If the first stage names a map, it must equal the top-level

package/dist/agent-candidate-code-schema.d.ts

@@ -105,8 +105,8 @@ export declare const agentCandidateContainerLaunchSchema: z.ZodObject<{
         kind: z.ZodLiteral<"secret-ref">;
         key: z.ZodString;
         format: z.ZodOptional<z.ZodEnum<{
-            bearer: "bearer";
             raw: "raw";
+            bearer: "bearer";
         }>>;
     }, z.core.$strict>], "kind">>>;
 }, z.core.$strict>;
@@ -114,11 +114,11 @@ export declare const agentCandidateEntrypointLaunchSchema: z.ZodObject<{
     kind: z.ZodLiteral<"candidate-entrypoint">;
     entrypoint: z.ZodString;
     interpreter: z.ZodOptional<z.ZodEnum<{
-        bun: "bun";
-        deno: "deno";
         node: "node";
         python: "python";
         python3: "python3";
+        bun: "bun";
+        deno: "deno";
         tsx: "tsx";
         uv: "uv";
     }>>;
@@ -129,8 +129,8 @@ export declare const agentCandidateEntrypointLaunchSchema: z.ZodObject<{
         kind: z.ZodLiteral<"secret-ref">;
         key: z.ZodString;
         format: z.ZodOptional<z.ZodEnum<{
-            bearer: "bearer";
             raw: "raw";
+            bearer: "bearer";
         }>>;
     }, z.core.$strict>], "kind">>>;
 }, z.core.$strict>;
@@ -144,19 +144,19 @@ export declare const agentCandidateLaunchSchema: z.ZodDiscriminatedUnion<[z.ZodO
         kind: z.ZodLiteral<"secret-ref">;
         key: z.ZodString;
         format: z.ZodOptional<z.ZodEnum<{
-            bearer: "bearer";
             raw: "raw";
+            bearer: "bearer";
         }>>;
     }, z.core.$strict>], "kind">>>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"candidate-entrypoint">;
     entrypoint: z.ZodString;
     interpreter: z.ZodOptional<z.ZodEnum<{
-        bun: "bun";
-        deno: "deno";
         node: "node";
         python: "python";
         python3: "python3";
+        bun: "bun";
+        deno: "deno";
         tsx: "tsx";
         uv: "uv";
     }>>;
@@ -167,8 +167,8 @@ export declare const agentCandidateLaunchSchema: z.ZodDiscriminatedUnion<[z.ZodO
         kind: z.ZodLiteral<"secret-ref">;
         key: z.ZodString;
         format: z.ZodOptional<z.ZodEnum<{
-            bearer: "bearer";
             raw: "raw";
+            bearer: "bearer";
         }>>;
     }, z.core.$strict>], "kind">>>;
 }, z.core.$strict>], "kind">;
@@ -183,22 +183,22 @@ export declare const agentCandidateInstructionDeliverySchema: z.ZodDiscriminated
 }, z.core.$strict>], "kind">;
 export declare const agentCandidateExecutionSchema: z.ZodObject<{
     harness: z.ZodEnum<{
-        acp: "acp";
-        amp: "amp";
         "claude-code": "claude-code";
-        "cli-base": "cli-base";
-        codex: "codex";
-        cursor: "cursor";
-        "factory-droids": "factory-droids";
-        forge: "forge";
-        gemini: "gemini";
-        hermes: "hermes";
-        "kimi-code": "kimi-code";
         nanoclaw: "nanoclaw";
-        openclaw: "openclaw";
+        codex: "codex";
         opencode: "opencode";
+        "kimi-code": "kimi-code";
         pi: "pi";
         prime: "prime";
+        gemini: "gemini";
+        hermes: "hermes";
+        openclaw: "openclaw";
+        amp: "amp";
+        "factory-droids": "factory-droids";
+        forge: "forge";
+        cursor: "cursor";
+        acp: "acp";
+        "cli-base": "cli-base";
     }>;
     harnessVersion: z.ZodString;
     launch: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -211,19 +211,19 @@ export declare const agentCandidateExecutionSchema: z.ZodObject<{
             kind: z.ZodLiteral<"secret-ref">;
             key: z.ZodString;
             format: z.ZodOptional<z.ZodEnum<{
-                bearer: "bearer";
                 raw: "raw";
+                bearer: "bearer";
             }>>;
         }, z.core.$strict>], "kind">>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"candidate-entrypoint">;
         entrypoint: z.ZodString;
         interpreter: z.ZodOptional<z.ZodEnum<{
-            bun: "bun";
-            deno: "deno";
             node: "node";
             python: "python";
             python3: "python3";
+            bun: "bun";
+            deno: "deno";
             tsx: "tsx";
             uv: "uv";
         }>>;
@@ -234,8 +234,8 @@ export declare const agentCandidateExecutionSchema: z.ZodObject<{
             kind: z.ZodLiteral<"secret-ref">;
             key: z.ZodString;
             format: z.ZodOptional<z.ZodEnum<{
-                bearer: "bearer";
                 raw: "raw";
+                bearer: "bearer";
             }>>;
         }, z.core.$strict>], "kind">>>;
     }, z.core.$strict>], "kind">;
@@ -262,8 +262,8 @@ export declare const agentCandidateExecutionSchema: z.ZodObject<{
         kind: z.ZodLiteral<"secret-ref">;
         key: z.ZodString;
         format: z.ZodOptional<z.ZodEnum<{
-            bearer: "bearer";
             raw: "raw";
+            bearer: "bearer";
         }>>;
     }, z.core.$strict>], "kind">>>;
     environment: z.ZodDiscriminatedUnion<[z.ZodObject<{