@tangle-network/agent-interface 3.0.0 → 3.1.1

package/dist/profile-schema.d.ts

@@ -166,6 +166,37 @@ export declare const agentProfileModelHintsSchema: z.ZodObject<{
     maxTotalOutputTokens: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
 }, z.core.$strict>;
+/** Ordered account selection policy, without credentials or ambient model defaults. */
+export declare const agentProfileSeatSchema: 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";
+        opencode: "opencode";
+        pi: "pi";
+        prime: "prime";
+    }>;
+    provider: z.ZodString;
+    model: z.ZodString;
+    selector: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"all-eligible">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"seat">;
+        id: z.ZodString;
+    }, z.core.$strict>]>;
+    tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
+    permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
+}, z.core.$strict>;
 /**
  * Replacement and addition are separate, independently optional fields, and the
  * pair is admitted on purpose: the effective prompt is `systemPrompt` followed
@@ -306,6 +337,7 @@ export declare const agentProfileDiffRemovalSchema: z.ZodObject<{
     }, z.core.$strict>]>>;
     model: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodArray<z.ZodString>]>>;
     harness: z.ZodOptional<z.ZodLiteral<true>>;
+    seats: z.ZodOptional<z.ZodLiteral<true>>;
     permissions: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodArray<z.ZodString>]>>;
     tools: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodArray<z.ZodString>]>>;
     mcp: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodArray<z.ZodString>]>>;
@@ -487,6 +519,36 @@ export declare const agentProfileSchema: z.ZodObject<{
         pi: "pi";
         prime: "prime";
     }>>;
+    seats: z.ZodOptional<z.ZodArray<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";
+            opencode: "opencode";
+            pi: "pi";
+            prime: "prime";
+        }>;
+        provider: z.ZodString;
+        model: z.ZodString;
+        selector: z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"all-eligible">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"seat">;
+            id: z.ZodString;
+        }, z.core.$strict>]>;
+        tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
+        permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
+    }, z.core.$strict>>>;
     permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
     tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
     mcp: z.ZodOptional<z.ZodType<Record<string, AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, AgentProfileMcpServer>, unknown>>>;

package/dist/profile-schema.js

@@ -2,6 +2,8 @@ import { z } from "zod";
 import { REASONING_EFFORTS, TRAINED_MODEL_PREFIX, trainedModelIdForArtifact, } from "./agent-profile.js";
 import { canonicalCandidateDigest, sha256DigestSchema, environmentNameSchema, headerNameSchema, isSafeExecutable, isSafeRelativePath, isWellFormedUnicode, looksLikeCredential, } from "./agent-candidate-schema-common.js";
 import { harnessTypeSchema } from "./harness.js";
+import { canonicalAgentProfileJson } from "./agent-profile-canonical.js";
+import { harnessHonorsEffort, harnessHonorsModel, harnessModelSupport, harnessReasoningEfforts, harnessSystemPromptIntents, resolveModelProvider, } from "./harness-capabilities.js";
 import { SANDBOX_SIZE_PRESET_NAMES, } from "./sandbox-size.js";
 /**
  * Zod records currently assign parsed values onto an ordinary object. The
@@ -130,6 +132,18 @@ export const agentProfileModelHintsBaseSchema = z.strictObject({
     metadata: ownPropertyRecordSchema(z.unknown()).optional(),
 });
 export const agentProfileModelHintsSchema = agentProfileModelHintsBaseSchema.superRefine(enforceModelTokenBounds);
+/** Ordered account selection policy, without credentials or ambient model defaults. */
+export const agentProfileSeatSchema = z.strictObject({
+    harness: harnessTypeSchema,
+    provider: z.string().regex(/^[a-z][a-z0-9-]*$/),
+    model: z.string().min(1).refine((value) => value.trim() === value, "model must be canonical"),
+    selector: z.union([
+        z.strictObject({ kind: z.literal("all-eligible") }),
+        z.strictObject({ kind: z.literal("seat"), id: z.string().min(1).refine((value) => value.trim() === value, "seat id must be canonical") }),
+    ]),
+    tools: ownPropertyRecordSchema(z.boolean()).optional(),
+    permissions: ownPropertyRecordSchema(agentProfilePermissionSchema).optional(),
+});
 /**
  * Replacement and addition are separate, independently optional fields, and the
  * pair is admitted on purpose: the effective prompt is `systemPrompt` followed
@@ -308,6 +322,7 @@ export const agentProfileDiffRemovalSchema = z.strictObject({
         .optional(),
     model: removeListSchema.optional(),
     harness: z.literal(true).optional(),
+    seats: z.literal(true).optional(),
     permissions: removeListSchema.optional(),
     tools: removeListSchema.optional(),
     mcp: removeListSchema.optional(),
@@ -418,6 +433,7 @@ export const agentProfileSchema = z
     prompt: agentProfilePromptSchema.optional(),
     model: agentProfileModelHintsSchema.optional(),
     harness: harnessTypeSchema.optional(),
+    seats: z.array(agentProfileSeatSchema).nonempty().optional(),
     permissions: ownPropertyRecordSchema(agentProfilePermissionSchema).optional(),
     tools: ownPropertyRecordSchema(z.boolean()).optional(),
     mcp: ownPropertyRecordSchema(agentProfileMcpServerSchema).optional(),
@@ -432,6 +448,46 @@ export const agentProfileSchema = z
 })
     .superRefine((profile, context) => {
     validateNestedRecordKeys(profile, context, [], new Set());
+    if (profile.seats?.length) {
+        const first = profile.seats[0];
+        if (first.harness !== profile.harness || first.provider !== profile.model?.provider ||
+            first.model !== profile.model?.default) {
+            context.addIssue({ code: "custom", path: ["seats", 0], message: "first seat must match profile harness, model.provider, and model.default" });
+        }
+        if (first.tools !== undefined &&
+            canonicalAgentProfileJson(first.tools) !== canonicalAgentProfileJson(profile.tools)) {
+            context.addIssue({ code: "custom", path: ["seats", 0, "tools"], message: "first seat tools must match profile tools" });
+        }
+        if (first.permissions !== undefined &&
+            canonicalAgentProfileJson(first.permissions) !== canonicalAgentProfileJson(profile.permissions)) {
+            context.addIssue({ code: "custom", path: ["seats", 0, "permissions"], message: "first seat permissions must match profile permissions" });
+        }
+        for (const [index, seat] of profile.seats.entries()) {
+            const provider = resolveModelProvider(seat.model);
+            if (provider !== seat.provider) {
+                context.addIssue({ code: "custom", path: ["seats", index, "provider"], message: "seat provider must match the model provider" });
+            }
+            if (!harnessHonorsModel(seat.harness)) {
+                context.addIssue({ code: "custom", path: ["seats", index, "harness"], message: "seat harness does not honor an exact model choice" });
+            }
+            const support = harnessModelSupport(seat.harness, seat.model, { reasoningEffort: profile.model?.reasoningEffort });
+            if (!support.supported) {
+                context.addIssue({ code: "custom", path: ["seats", index, "model"], message: support.message });
+            }
+            const effort = profile.model?.reasoningEffort;
+            if (effort !== undefined && (!harnessHonorsEffort(seat.harness) ||
+                !harnessReasoningEfforts(seat.harness).includes(effort))) {
+                context.addIssue({ code: "custom", path: ["seats", index, "harness"], message: "seat harness cannot honor profile reasoning effort" });
+            }
+            const prompt = harnessSystemPromptIntents(seat.harness);
+            if (profile.prompt?.systemPrompt !== undefined && !prompt.replace) {
+                context.addIssue({ code: "custom", path: ["seats", index, "harness"], message: "seat harness cannot replace the system prompt" });
+            }
+            if (profile.prompt?.appendSystemPrompt !== undefined && !prompt.append) {
+                context.addIssue({ code: "custom", path: ["seats", index, "harness"], message: "seat harness cannot append the system prompt" });
+            }
+        }
+    }
     const training = agentProfileTrainingSchema.safeParse(profile.metadata?.training);
     if (profile.model?.default?.startsWith(TRAINED_MODEL_PREFIX) && !training.success) {
         context.addIssue({ code: "custom", path: ["metadata", "training"], message: "trained model requires a checkpoint receipt" });

package/package.json

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