@claudexor/schema 4.6.2 → 4.8.1

package/dist/attachment.d.ts

@@ -137,4 +137,182 @@ export declare const ControlUploadFinalizeRequest: z.ZodObject<{
     expectedSha256?: string | undefined;
 }>;
 export type ControlUploadFinalizeRequest = z.infer<typeof ControlUploadFinalizeRequest>;
+export declare const ControlUploadImportContent: z.ZodObject<{
+    sizeBytes: z.ZodNumber;
+    sha256: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    sizeBytes: number;
+    sha256: string;
+}, {
+    sizeBytes: number;
+    sha256: string;
+}>;
+export type ControlUploadImportContent = z.infer<typeof ControlUploadImportContent>;
+/** The key binds every field except the store check and `content`, which its first declaration binds. */
+export declare const ControlUploadImportRequest: z.ZodObject<{
+    expectedStoreId: z.ZodString;
+    kind: z.ZodEnum<["image", "file"]>;
+    mime: z.ZodString;
+    name: z.ZodDefault<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodObject<{
+        sizeBytes: z.ZodNumber;
+        sha256: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        sizeBytes: number;
+        sha256: string;
+    }, {
+        sizeBytes: number;
+        sha256: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    expectedStoreId: string;
+    kind: "file" | "image";
+    mime: string;
+    name: string;
+    source?: string | undefined;
+    content?: {
+        sizeBytes: number;
+        sha256: string;
+    } | undefined;
+}, {
+    expectedStoreId: string;
+    kind: "file" | "image";
+    mime: string;
+    name?: string | undefined;
+    source?: string | undefined;
+    content?: {
+        sizeBytes: number;
+        sha256: string;
+    } | undefined;
+}>;
+export type ControlUploadImportRequest = z.infer<typeof ControlUploadImportRequest>;
+export declare const ControlUploadImport: z.ZodEffects<z.ZodObject<{
+    storeId: z.ZodString;
+    state: z.ZodEnum<["open", "uploading", "ready", "cancelled"]>;
+    uploadId: z.ZodString;
+    content: z.ZodObject<{
+        sizeBytes: z.ZodNumber;
+        sha256: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        sizeBytes: number;
+        sha256: string;
+    }, {
+        sizeBytes: number;
+        sha256: string;
+    }>;
+    receivedBytes: z.ZodNumber;
+    resource: z.ZodOptional<z.ZodObject<{
+        resourceId: z.ZodString;
+        purpose: z.ZodOptional<z.ZodLiteral<"model">>;
+        kind: z.ZodEnum<["image", "file"]>;
+        mime: z.ZodString;
+        name: z.ZodString;
+        sha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        createdAt: z.ZodString;
+        deduplicated: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        resourceId: string;
+        purpose?: "model" | undefined;
+        kind: "file" | "image";
+        mime: string;
+        name: string;
+        sha256: string;
+        sizeBytes: number;
+        createdAt: string;
+        deduplicated: boolean;
+    }, {
+        resourceId: string;
+        purpose?: "model" | undefined;
+        kind: "file" | "image";
+        mime: string;
+        name: string;
+        sha256: string;
+        sizeBytes: number;
+        createdAt: string;
+        deduplicated: boolean;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    storeId: string;
+    state: "cancelled" | "open" | "ready" | "uploading";
+    uploadId: string;
+    content: {
+        sizeBytes: number;
+        sha256: string;
+    };
+    receivedBytes: number;
+    resource?: {
+        resourceId: string;
+        purpose?: "model" | undefined;
+        kind: "file" | "image";
+        mime: string;
+        name: string;
+        sha256: string;
+        sizeBytes: number;
+        createdAt: string;
+        deduplicated: boolean;
+    } | undefined;
+}, {
+    storeId: string;
+    state: "cancelled" | "open" | "ready" | "uploading";
+    uploadId: string;
+    content: {
+        sizeBytes: number;
+        sha256: string;
+    };
+    receivedBytes: number;
+    resource?: {
+        resourceId: string;
+        purpose?: "model" | undefined;
+        kind: "file" | "image";
+        mime: string;
+        name: string;
+        sha256: string;
+        sizeBytes: number;
+        createdAt: string;
+        deduplicated: boolean;
+    } | undefined;
+}>, {
+    storeId: string;
+    state: "cancelled" | "open" | "ready" | "uploading";
+    uploadId: string;
+    content: {
+        sizeBytes: number;
+        sha256: string;
+    };
+    receivedBytes: number;
+    resource?: {
+        resourceId: string;
+        purpose?: "model" | undefined;
+        kind: "file" | "image";
+        mime: string;
+        name: string;
+        sha256: string;
+        sizeBytes: number;
+        createdAt: string;
+        deduplicated: boolean;
+    } | undefined;
+}, {
+    storeId: string;
+    state: "cancelled" | "open" | "ready" | "uploading";
+    uploadId: string;
+    content: {
+        sizeBytes: number;
+        sha256: string;
+    };
+    receivedBytes: number;
+    resource?: {
+        resourceId: string;
+        purpose?: "model" | undefined;
+        kind: "file" | "image";
+        mime: string;
+        name: string;
+        sha256: string;
+        sizeBytes: number;
+        createdAt: string;
+        deduplicated: boolean;
+    } | undefined;
+}>;
+export type ControlUploadImport = z.infer<typeof ControlUploadImport>;
 //# sourceMappingURL=attachment.d.ts.map

package/dist/attachment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../src/attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B,eAAO,MAAM,cAAc,8BAEiD,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,mEAAmE;AACnE,eAAO,MAAM,qBAAqB;;;;;;EAGsC,CAAC;AACzE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,gFAAgF;AAChF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EAWyD,CAAC;AACjF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB,2EAEgD,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EASoD,CAAC;AACtF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAa5B,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAOrB,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAejB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,4BAA4B;;;;;;EAE9B,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../src/attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAM3B,eAAO,MAAM,cAAc,8BAEiD,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,mEAAmE;AACnE,eAAO,MAAM,qBAAqB;;;;;;EAGsC,CAAC;AACzE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,gFAAgF;AAChF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;EAWyD,CAAC;AACjF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB,2EAEgD,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,6EAA6E;AAC7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EASoD,CAAC;AACtF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAa5B,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAOrB,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAejB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,4BAA4B;;;;;;EAE9B,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAExF,eAAO,MAAM,0BAA0B;;;;;;;;;EASiD,CAAC;AACzF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,yGAAyG;AACzG,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqByC,CAAC;AACjF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBgE,CAAC;AACjG,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/attachment.js

@@ -1,5 +1,7 @@
 import { z } from "zod/v3";
+import { ControlHandshakeResponse } from "./operation.js";
 import { ContentHash, Id, IsoTimestamp } from "./primitives.js";
+const storeId = ControlHandshakeResponse.shape.storeId.unwrap();
 export const AttachmentKind = z
     .enum(["image", "file"])
     .describe("Kind of attached resource: image input or generic file bytes.");
@@ -74,4 +76,48 @@ export const ControlResource = z
 export const ControlUploadFinalizeRequest = z
     .object({ expectedSha256: ContentHash.optional() })
     .strict();
+export const ControlUploadImportContent = z
+    .object({
+    sizeBytes: z.number().int().nonnegative().describe("Exact byte length."),
+    sha256: z
+        .string()
+        .regex(/^sha256:[a-f0-9]{64}$/)
+        .describe('Exact digest of the bytes: "sha256:" and 64 lowercase hex digits.'),
+})
+    .strict()
+    .describe("Exact bytes a keyed import owns, bound by its first accepted declaration.");
+/** The key binds every field except the store check and `content`, which its first declaration binds. */
+export const ControlUploadImportRequest = z
+    .object({
+    expectedStoreId: storeId.describe("Store UUID from the opt-in handshake, saved with the key BEFORE the first import and replayed unchanged; never replaced by the current store. A different store is refused before any effect."),
+    kind: AttachmentKind,
+    mime: z.string().min(1),
+    name: z.string().default(""),
+    source: z
+        .string()
+        .min(1)
+        .max(4096)
+        .optional()
+        .describe("Opaque caller identity of the selected source, such as the absolute path a local client read or a task artifact id. Bound into the key only; the daemon never reads, resolves, stores or returns it."),
+    content: ControlUploadImportContent.optional().describe("Required to begin an import. Omit it to read or replay an already bound key without touching the source."),
+})
+    .strict()
+    .describe("Keyed import of one ordinary attachment through the upload owner.");
+export const ControlUploadImport = z
+    .object({
+    storeId: storeId.describe("Durable store that owns this import key and its resource."),
+    state: z
+        .enum(["open", "uploading", "ready", "cancelled"])
+        .describe("open: send the bound bytes; uploading: a transfer is in flight; ready: resource is published; cancelled: finished without a resource, a new attempt needs a new key."),
+    uploadId: Id.describe("Upload that receives this import's bytes."),
+    content: ControlUploadImportContent,
+    receivedBytes: z.number().int().nonnegative(),
+    resource: ControlResource.optional().describe("The immutable resource, present exactly when state is ready."),
+})
+    .strict()
+    .refine((value) => (value.state === "ready") === (value.resource !== undefined), {
+    message: "resource is present exactly when state is ready",
+    path: ["resource"],
+})
+    .describe("Current state of one keyed import, identical for its first call and every replay.");
 //# sourceMappingURL=attachment.js.map

package/dist/attachment.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../src/attachment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../src/attachment.ts"],"names":[],"mappings":"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"}

package/dist/auxiliary-writable-roots.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod/v3";
+import type { AccessProfile, ModeKind } from "./primitives.js";
+/**
+ * Exact caller-created service directories (download caches, outside-Git
+ * scratch) an Agent lane may write besides its execution tree. The caller owns
+ * them; the engine never creates, captures, applies, reverts, or deletes them.
+ */
+export declare const AuxiliaryWritableRootsRequest: z.ZodArray<z.ZodString, "many">;
+/** Canonical grant recorded by the engine after admission (realpath, deduplicated). */
+export declare const AuxiliaryWritableRoots: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+/** Manifest fact: the adapter applies auxiliary writable roots natively and revocably per turn. */
+export declare const AuxiliaryWritableRootsCapability: z.ZodDefault<z.ZodBoolean>;
+export interface AuxiliaryWritableRootsViolation {
+    code: "auxiliary_writable_roots_access_conflict";
+    message: string;
+    retryable: false;
+    requiredActions: readonly [string];
+}
+/**
+ * A non-empty grant exists only on an Agent run whose effective access is
+ * workspace_write; every other mode or access level is a typed conflict, never
+ * a silently changed access profile.
+ */
+export declare function runAuxiliaryWritableRootsViolation(value: {
+    mode?: ModeKind;
+    execution?: {
+        auxiliaryWritableRoots?: readonly string[];
+    };
+}, effectiveAccess: AccessProfile | undefined): AuxiliaryWritableRootsViolation | null;
+//# sourceMappingURL=auxiliary-writable-roots.d.ts.map

package/dist/auxiliary-writable-roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary-writable-roots.d.ts","sourceRoot":"","sources":["../src/auxiliary-writable-roots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,iCAIvC,CAAC;AAEJ,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,+CAKhC,CAAC;AAEJ,mGAAmG;AACnG,eAAO,MAAM,gCAAgC,4BAK1C,CAAC;AAEJ,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;IACjB,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,EACtF,eAAe,EAAE,aAAa,GAAG,SAAS,GACzC,+BAA+B,GAAG,IAAI,CAaxC"}

package/dist/auxiliary-writable-roots.js

@@ -0,0 +1,40 @@
+import { z } from "zod/v3";
+/**
+ * Exact caller-created service directories (download caches, outside-Git
+ * scratch) an Agent lane may write besides its execution tree. The caller owns
+ * them; the engine never creates, captures, applies, reverts, or deletes them.
+ */
+export const AuxiliaryWritableRootsRequest = z
+    .array(z.string().min(1))
+    .describe("Exact existing absolute directories, created by the caller, that an Agent run with effective workspace_write may also write (service caches or scratch outside the execution tree). [] grants nothing extra; so does omission, except that a continueFrom successor omitting execution inherits its predecessor's whole execution group. Requires a lane whose capability_profile.access_control.auxiliary_writable_roots is true; the files are never part of the project result.");
+/** Canonical grant recorded by the engine after admission (realpath, deduplicated). */
+export const AuxiliaryWritableRoots = z
+    .array(z.string())
+    .default([])
+    .describe("Canonical auxiliary writable directories granted to this run's writable Agent lanes; empty = no extra engine grant. Read-only lanes never receive them.");
+/** Manifest fact: the adapter applies auxiliary writable roots natively and revocably per turn. */
+export const AuxiliaryWritableRootsCapability = z
+    .boolean()
+    .default(false)
+    .describe("The adapter applies HarnessRunSpec.auxiliary_writable_roots natively under workspace_write, and a later spec carrying none receives no earlier grant; false = such a lane refuses (explicit pool) or is filtered (auto pool).");
+/**
+ * A non-empty grant exists only on an Agent run whose effective access is
+ * workspace_write; every other mode or access level is a typed conflict, never
+ * a silently changed access profile.
+ */
+export function runAuxiliaryWritableRootsViolation(value, effectiveAccess) {
+    if ((value.execution?.auxiliaryWritableRoots?.length ?? 0) === 0)
+        return null;
+    const mode = value.mode ?? "agent";
+    if (mode === "agent" && (effectiveAccess === undefined || effectiveAccess === "workspace_write"))
+        return null;
+    return {
+        code: "auxiliary_writable_roots_access_conflict",
+        message: `execution.auxiliaryWritableRoots requires an Agent run with workspace_write access (mode '${mode}', access '${mode === "agent" ? effectiveAccess : "readonly"}')`,
+        retryable: false,
+        requiredActions: [
+            "Use Agent with workspace_write, or clear the roots. For continueFrom, POST /v2/runs with a complete replacement execution group and auxiliaryWritableRoots: []; claudexor_run_continue cannot replace execution, so use HTTP or start a new run.",
+        ],
+    };
+}
+//# sourceMappingURL=auxiliary-writable-roots.js.map

package/dist/auxiliary-writable-roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary-writable-roots.js","sourceRoot":"","sources":["../src/auxiliary-writable-roots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACxB,QAAQ,CACP,odAAod,CACrd,CAAC;AAEJ,uFAAuF;AACvF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACpC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACjB,OAAO,CAAC,EAAE,CAAC;KACX,QAAQ,CACP,yJAAyJ,CAC1J,CAAC;AAEJ,mGAAmG;AACnG,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC;KAC9C,OAAO,EAAE;KACT,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CACP,+NAA+N,CAChO,CAAC;AASJ;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAChD,KAAsF,EACtF,eAA0C;IAE1C,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,sBAAsB,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC;IACnC,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,iBAAiB,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,OAAO;QACL,IAAI,EAAE,0CAA0C;QAChD,OAAO,EAAE,6FAA6F,IAAI,cAAc,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,IAAI;QAC3K,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE;YACf,kPAAkP;SACnP;KACF,CAAC;AACJ,CAAC"}