@tangle-network/agent-interface 1.8.0 → 2.0.0

package/dist/profile-schema.d.ts

@@ -112,13 +112,13 @@ export declare const agentProfileResourcesSchema: z.ZodObject<{
     failOnError: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const reasoningEffortSchema: z.ZodEnum<{
-    none: "none";
-    minimal: "minimal";
+    high: "high";
     low: "low";
     medium: "medium";
-    high: "high";
-    xhigh: "xhigh";
+    minimal: "minimal";
+    none: "none";
     ultracode: "ultracode";
+    xhigh: "xhigh";
 }>;
 /**
  * Enforce the token ceilings that live together: each single ceiling must not
@@ -135,13 +135,13 @@ export declare const agentProfileModelHintsBaseSchema: z.ZodObject<{
     small: z.ZodOptional<z.ZodString>;
     provider: z.ZodOptional<z.ZodString>;
     reasoningEffort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        minimal: "minimal";
+        high: "high";
         low: "low";
         medium: "medium";
-        high: "high";
-        xhigh: "xhigh";
+        minimal: "minimal";
+        none: "none";
         ultracode: "ultracode";
+        xhigh: "xhigh";
     }>>;
     maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
     maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -153,13 +153,13 @@ export declare const agentProfileModelHintsSchema: z.ZodObject<{
     small: z.ZodOptional<z.ZodString>;
     provider: z.ZodOptional<z.ZodString>;
     reasoningEffort: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        minimal: "minimal";
+        high: "high";
         low: "low";
         medium: "medium";
-        high: "high";
-        xhigh: "xhigh";
+        minimal: "minimal";
+        none: "none";
         ultracode: "ultracode";
+        xhigh: "xhigh";
     }>>;
     maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
     maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -187,8 +187,8 @@ export declare const agentProfileSecretRefSchema: z.ZodObject<{
     kind: z.ZodLiteral<"secret-ref">;
     key: z.ZodString;
     format: z.ZodOptional<z.ZodEnum<{
-        raw: "raw";
         bearer: "bearer";
+        raw: "raw";
     }>>;
 }, z.core.$strict>;
 export declare const agentProfileConfigValueSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -198,8 +198,8 @@ export declare const agentProfileConfigValueSchema: z.ZodDiscriminatedUnion<[z.Z
     kind: z.ZodLiteral<"secret-ref">;
     key: z.ZodString;
     format: z.ZodOptional<z.ZodEnum<{
-        raw: "raw";
         bearer: "bearer";
+        raw: "raw";
     }>>;
 }, z.core.$strict>], "kind">;
 export declare const agentProfileEnvironmentSchema: z.ZodType<Record<string, {
@@ -208,14 +208,14 @@ export declare const agentProfileEnvironmentSchema: z.ZodType<Record<string, {
 } | {
     kind: "secret-ref";
     key: string;
-    format?: "raw" | "bearer" | undefined;
+    format?: "bearer" | "raw" | undefined;
 }>, unknown, z.core.$ZodTypeInternals<Record<string, {
     kind: "public";
     value: string;
 } | {
     kind: "secret-ref";
     key: string;
-    format?: "raw" | "bearer" | undefined;
+    format?: "bearer" | "raw" | undefined;
 }>, unknown>>;
 export declare const agentProfileHeaderSchema: z.ZodType<Record<string, {
     kind: "public";
@@ -223,14 +223,14 @@ export declare const agentProfileHeaderSchema: z.ZodType<Record<string, {
 } | {
     kind: "secret-ref";
     key: string;
-    format?: "raw" | "bearer" | undefined;
+    format?: "bearer" | "raw" | undefined;
 }>, unknown, z.core.$ZodTypeInternals<Record<string, {
     kind: "public";
     value: string;
 } | {
     kind: "secret-ref";
     key: string;
-    format?: "raw" | "bearer" | undefined;
+    format?: "bearer" | "raw" | undefined;
 }>, unknown>>;
 export declare const agentSubagentProfileSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
@@ -252,14 +252,14 @@ export declare const agentProfileHookCommandSchema: z.ZodObject<{
     } | {
         kind: "secret-ref";
         key: string;
-        format?: "raw" | "bearer" | undefined;
+        format?: "bearer" | "raw" | undefined;
     }>, unknown, z.core.$ZodTypeInternals<Record<string, {
         kind: "public";
         value: string;
     } | {
         kind: "secret-ref";
         key: string;
-        format?: "raw" | "bearer" | undefined;
+        format?: "bearer" | "raw" | undefined;
     }>, unknown>>>;
 }, z.core.$strict>;
 export declare const agentProfileModeSchema: z.ZodObject<{
@@ -346,13 +346,13 @@ export declare const agentProfileSchema: z.ZodObject<{
         small: z.ZodOptional<z.ZodString>;
         provider: z.ZodOptional<z.ZodString>;
         reasoningEffort: z.ZodOptional<z.ZodEnum<{
-            none: "none";
-            minimal: "minimal";
+            high: "high";
             low: "low";
             medium: "medium";
-            high: "high";
-            xhigh: "xhigh";
+            minimal: "minimal";
+            none: "none";
             ultracode: "ultracode";
+            xhigh: "xhigh";
         }>>;
         maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
         maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -360,22 +360,22 @@ export declare const agentProfileSchema: z.ZodObject<{
         metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
     }, z.core.$strict>>;
     harness: z.ZodOptional<z.ZodEnum<{
+        acp: "acp";
+        amp: "amp";
         "claude-code": "claude-code";
-        nanoclaw: "nanoclaw";
+        "cli-base": "cli-base";
         codex: "codex";
-        opencode: "opencode";
-        "kimi-code": "kimi-code";
-        pi: "pi";
-        prime: "prime";
+        cursor: "cursor";
+        "factory-droids": "factory-droids";
+        forge: "forge";
         gemini: "gemini";
         hermes: "hermes";
+        "kimi-code": "kimi-code";
+        nanoclaw: "nanoclaw";
         openclaw: "openclaw";
-        amp: "amp";
-        "factory-droids": "factory-droids";
-        forge: "forge";
-        cursor: "cursor";
-        acp: "acp";
-        "cli-base": "cli-base";
+        opencode: "opencode";
+        pi: "pi";
+        prime: "prime";
     }>>;
     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>>>;
@@ -486,7 +486,7 @@ export declare const agentProfileSchema: z.ZodObject<{
         } | {
             kind: "secret-ref";
             key: string;
-            format?: "raw" | "bearer" | undefined;
+            format?: "bearer" | "raw" | undefined;
         }> | undefined;
     }[]>, unknown, z.core.$ZodTypeInternals<Record<string, {
         command: string;
@@ -499,7 +499,7 @@ export declare const agentProfileSchema: z.ZodObject<{
         } | {
             kind: "secret-ref";
             key: string;
-            format?: "raw" | "bearer" | undefined;
+            format?: "bearer" | "raw" | undefined;
         }> | undefined;
     }[]>, unknown>>>;
     modes: z.ZodOptional<z.ZodType<Record<string, {

package/dist/runtime-control.d.ts

@@ -53,7 +53,6 @@ export interface AgentRunCancellationRequest extends AgentRunCancellationRequest
 }
 export declare function agentRunCancellationRequestDigest(request: AgentRunCancellationRequestMaterial): Sha256Digest;
 export declare const AgentRunCancellationRequestSchema: z.ZodObject<{
-    requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     operationId: z.ZodString;
     run: z.ZodObject<{
         runId: z.ZodString;
@@ -64,6 +63,7 @@ export declare const AgentRunCancellationRequestSchema: z.ZodObject<{
         requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     }, z.core.$strict>;
     reason: z.ZodOptional<z.ZodString>;
+    requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
 }, z.core.$strict>;
 export interface AgentRunCancellationAcknowledgement {
     operationId: string;
@@ -87,16 +87,16 @@ export declare const AgentRunCancellationAcknowledgementSchema: z.ZodObject<{
         requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     }, z.core.$strict>;
     status: z.ZodEnum<{
-        unknown: "unknown";
-        conflict: "conflict";
         accepted: "accepted";
+        conflict: "conflict";
         replayed: "replayed";
+        unknown: "unknown";
     }>;
     effect: z.ZodEnum<{
-        unknown: "unknown";
-        cancelled: "cancelled";
         cancel_requested: "cancel_requested";
+        cancelled: "cancelled";
         not_live: "not_live";
+        unknown: "unknown";
     }>;
     message: z.ZodOptional<z.ZodString>;
     retryable: z.ZodOptional<z.ZodBoolean>;
@@ -115,13 +115,12 @@ export interface AgentRunControlRequest extends AgentRunControlRequestMaterial {
 }
 export declare function agentRunControlRequestDigest(request: AgentRunControlRequestMaterial): Sha256Digest;
 export declare const AgentRunControlRequestSchema: z.ZodObject<{
-    requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     operationId: z.ZodString;
     action: z.ZodEnum<{
-        status: "status";
-        steer: "steer";
         cancel: "cancel";
         reconnect: "reconnect";
+        status: "status";
+        steer: "steer";
     }>;
     run: z.ZodObject<{
         runId: z.ZodString;
@@ -132,6 +131,7 @@ export declare const AgentRunControlRequestSchema: z.ZodObject<{
         requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     }, z.core.$strict>;
     payload: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+    requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
 }, z.core.$strict>;
 export interface AgentRunControlAcknowledgement {
     operationId: string;
@@ -154,10 +154,10 @@ export declare const AgentRunControlAcknowledgementSchema: z.ZodObject<{
         requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     }, z.core.$strict>;
     status: z.ZodEnum<{
-        unknown: "unknown";
-        conflict: "conflict";
         accepted: "accepted";
+        conflict: "conflict";
         replayed: "replayed";
+        unknown: "unknown";
     }>;
     message: z.ZodOptional<z.ZodString>;
     retryable: z.ZodOptional<z.ZodBoolean>;

package/dist/workspace-cleanup.d.ts

@@ -43,12 +43,12 @@ export declare const WorkspaceCleanupAcknowledgementSchema: z.ZodObject<{
     provider: z.ZodString;
     requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     status: z.ZodEnum<{
-        unknown: "unknown";
+        already_absent: "already_absent";
         conflict: "conflict";
-        transport_failure: "transport_failure";
         deleted: "deleted";
-        already_absent: "already_absent";
         in_use: "in_use";
+        transport_failure: "transport_failure";
+        unknown: "unknown";
     }>;
     existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
     message: z.ZodOptional<z.ZodString>;

package/dist/workspace-cwd.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/** Maximum number of UTF-16 code units accepted in a workspace cwd path. */
+export declare const MAX_WORKSPACE_CWD_LENGTH = 4096;
+export type WorkspaceCwdBase = "repository" | "host";
+export type WorkspaceCwd = {
+    base: "repository";
+    path: string;
+} | {
+    base: "host";
+    path: string;
+};
+/**
+ * Validate and canonicalize an explicitly based workspace path.
+ *
+ * Repository paths never start with `./`, contain duplicate separators, or
+ * leave the workspace root. Host paths preserve native separators and values.
+ */
+export declare const workspaceCwdSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    base: z.ZodLiteral<"repository">;
+    path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strict>, z.ZodObject<{
+    base: z.ZodLiteral<"host">;
+    path: z.ZodString;
+}, z.core.$strict>], "base">;
+/** Validate and return the canonical form of a workspace cwd. */
+export declare function canonicalWorkspaceCwd(value: WorkspaceCwd): WorkspaceCwd;
+/** Return a provider path only when its explicit base is supported. */
+export declare function workspaceCwdPathForBase(value: WorkspaceCwd | undefined, base: WorkspaceCwdBase, providerLabel: string): string | undefined;

package/dist/workspace-cwd.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { pathSafetyIssues, relativePathSafetyIssues, } from "./agent-candidate-schema-common.js";
+/** Maximum number of UTF-16 code units accepted in a workspace cwd path. */
+export const MAX_WORKSPACE_CWD_LENGTH = 4_096;
+const workspaceCwdIssueMessages = {
+    absolute: "Workspace cwd must be relative",
+    backslash: "Workspace cwd must use POSIX separators",
+    "control-character": "Workspace cwd cannot contain control characters",
+    "parent-traversal": "Workspace cwd cannot leave the workspace root",
+    "malformed-unicode": "Workspace cwd must contain well-formed Unicode",
+};
+function normalizeWorkspaceCwd(value) {
+    const segments = value
+        .split("/")
+        .filter((segment) => segment.length > 0 && segment !== ".");
+    return segments.join("/") || ".";
+}
+const pathIssueMessages = {
+    "control-character": "Workspace cwd cannot contain control characters",
+    "malformed-unicode": "Workspace cwd must contain well-formed Unicode",
+};
+const repositoryWorkspaceCwdPathSchema = z
+    .string()
+    .min(1)
+    .max(MAX_WORKSPACE_CWD_LENGTH)
+    .superRefine((value, refinement) => {
+    for (const issue of relativePathSafetyIssues(value)) {
+        const message = workspaceCwdIssueMessages[issue];
+        if (message === undefined)
+            continue;
+        refinement.addIssue({
+            code: "custom",
+            message,
+        });
+    }
+})
+    .transform(normalizeWorkspaceCwd);
+const hostWorkspaceCwdPathSchema = z
+    .string()
+    .max(MAX_WORKSPACE_CWD_LENGTH)
+    .superRefine((value, refinement) => {
+    for (const issue of pathSafetyIssues(value)) {
+        refinement.addIssue({
+            code: "custom",
+            message: pathIssueMessages[issue],
+        });
+    }
+});
+/**
+ * Validate and canonicalize an explicitly based workspace path.
+ *
+ * Repository paths never start with `./`, contain duplicate separators, or
+ * leave the workspace root. Host paths preserve native separators and values.
+ */
+export const workspaceCwdSchema = z.discriminatedUnion("base", [
+    z.strictObject({
+        base: z.literal("repository"),
+        path: repositoryWorkspaceCwdPathSchema,
+    }),
+    z.strictObject({
+        base: z.literal("host"),
+        path: hostWorkspaceCwdPathSchema,
+    }),
+]);
+/** Validate and return the canonical form of a workspace cwd. */
+export function canonicalWorkspaceCwd(value) {
+    return workspaceCwdSchema.parse(value);
+}
+/** Return a provider path only when its explicit base is supported. */
+export function workspaceCwdPathForBase(value, base, providerLabel) {
+    if (value === undefined)
+        return undefined;
+    if (value.base !== base) {
+        throw new Error(`${providerLabel} supports workspace cwd base "${base}", not "${value.base}"`);
+    }
+    return value.path;
+}

package/dist/workspace-fork.d.ts

@@ -39,10 +39,10 @@ export declare const WorkspaceForkRequestSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
     placement: z.ZodObject<{
         kind: z.ZodEnum<{
-            provider: "provider";
+            fleet: "fleet";
             local: "local";
+            provider: "provider";
             sandbox: "sandbox";
-            fleet: "fleet";
         }>;
         sandboxId: z.ZodOptional<z.ZodString>;
         fleetId: z.ZodOptional<z.ZodString>;
@@ -100,10 +100,10 @@ export declare const ForkedEnvironmentRefSchema: z.ZodObject<{
     createdAt: z.ZodISODateTime;
     placement: z.ZodObject<{
         kind: z.ZodEnum<{
-            provider: "provider";
+            fleet: "fleet";
             local: "local";
+            provider: "provider";
             sandbox: "sandbox";
-            fleet: "fleet";
         }>;
         sandboxId: z.ZodOptional<z.ZodString>;
         fleetId: z.ZodOptional<z.ZodString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "1.8.0",
+  "version": "2.0.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -83,15 +83,15 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@noble/hashes": "1.8.0",
+    "@noble/hashes": "2.4.0",
     "spdx-expression-parse": "5.0.0",
-    "zod": "4.4.3"
+    "zod": "4.5.4"
   },
   "devDependencies": {
-    "@types/node": "25.6.0",
+    "@types/node": "26.4.0",
     "@types/spdx-expression-parse": "4.0.0",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",