@claudexor/schema 1.0.0 → 2.0.0

package/dist/attachment.js

@@ -1,54 +1,69 @@
 import { z } from "zod";
-import { Id } from "./primitives.js";
-/**
- * A user- or agent-provided file/image attached to a turn. `path` is the
- * resolved on-disk location in the scoped attachment store (kept OUTSIDE any
- * worktree so `git add -A` cannot capture it); an adapter reads bytes from
- * there to forward to its harness in that harness's native shape.
- */
+import { ContentHash, Id, IsoTimestamp } from "./primitives.js";
 export const AttachmentKind = z
     .enum(["image", "file"])
-    .describe("Kind of attachment: image (vision input) or file (generic bytes).");
+    .describe("Kind of attached resource: image input or generic file bytes.");
+/** The only attachment authority accepted by run/turn requests. */
+export const ResourceAttachmentRef = z
+    .object({ resourceId: Id.describe("Immutable daemon resource id returned by upload finalize.") })
+    .strict()
+    .describe("Reference to an immutable daemon-owned uploaded resource.");
+/** Internal resolved shape passed to adapters; never accepted from a client. */
 export const Attachment = z
     .object({
-    id: Id.describe("Attachment id."),
-    kind: AttachmentKind.default("file"),
-    mime: z.string().default("application/octet-stream").describe("MIME type of the attachment content."),
-    name: z.string().default("").describe("Original file name as provided by the user or agent."),
-    /** Resolved local path in the scoped attachment store. */
-    path: z.string().describe("Resolved local path in the scoped attachment store (kept outside any worktree)."),
+    resource_id: Id.describe("Immutable daemon resource id."),
+    kind: AttachmentKind,
+    mime: z.string().min(1).describe("Declared MIME type validated against adapter limits."),
+    name: z.string().describe("Original display name."),
+    sha256: ContentHash.describe("Exact sha256 digest of the immutable bytes."),
+    size_bytes: z.number().int().nonnegative().describe("Exact byte length."),
+    path: z.string().describe("Daemon-owned immutable blob path; internal adapter input only."),
 })
-    .describe("A user- or agent-provided file/image attached to a turn, stored in the scoped attachment store and forwarded to harnesses in their native shape.");
-/**
- * Inbound attachment on a control request. Thread/composer uploads may arrive
- * base64-inline (`data`) for a fresh upload; direct non-thread run enqueue
- * accepts only non-empty absolute existing file paths so bytes cannot persist in
- * the daemon job registry. The daemon/turn store resolves inbound bytes to a
- * durable {@link Attachment}. Exactly one of `data` / `path` is expected; both
- * null is rejected by the resolver (fail loud, never a silent empty attachment).
- */
-export const AttachmentInput = z
+    .strict()
+    .describe("Daemon-resolved immutable resource supplied to a harness adapter.");
+export const AttachmentTransport = z
+    .enum(["file_path", "base64_stream", "base64_inline", "text_inline"])
+    .describe("Native adapter transport used for one supported attachment class.");
+/** Finite declaration: absent/unknown MIME is unsupported, never assumed. */
+export const AttachmentInputClass = z
     .object({
-    kind: AttachmentKind.default("file"),
-    mime: z.string().default("application/octet-stream").describe("MIME type of the attachment content."),
-    name: z.string().default("").describe("Original file name for the attachment."),
-    data: z.string().nullable().default(null).describe("Base64-inline attachment bytes for a fresh upload; null when path is used instead."),
-    path: z
-        .string()
-        .nullable()
-        .default(null)
-        .describe("Absolute existing file path to read bytes from; null when data is used instead."),
+    kind: AttachmentKind,
+    mime_types: z.array(z.string().min(1)).min(1),
+    max_bytes: z.number().int().positive().finite(),
+    max_count: z.number().int().positive().finite(),
+    transport: AttachmentTransport,
 })
-    .describe("Inbound attachment on a control request; exactly one of data (base64-inline) or path (absolute existing file) is expected, resolved by the daemon into a durable Attachment.");
-/**
- * How a harness accepts image input, declared by its adapter manifest and used
- * for honest UI gating + per-adapter serialization (never a normalized wire
- * format): `file_path` (codex `-i`), `base64_stream` (claude stream-json image
- * block), `base64_inline` (raw-api `image_url` data URL), or `none` (cursor /
- * opencode — image attachments are disabled/routed to a vision-capable harness
- * rather than silently dropped; generic file attachments still use Attachment).
- */
-export const ImageInputMode = z
-    .enum(["file_path", "base64_stream", "base64_inline", "none"])
-    .describe("How a harness accepts image input: file_path (CLI file argument), base64_stream (base64 image block on the stream), base64_inline (data-URL in the request), or none (no vision input on this route).");
+    .strict()
+    .describe("Finite MIME, size, count and transport limits declared by one adapter.");
+export const ControlUploadCreateRequest = z
+    .object({
+    kind: AttachmentKind,
+    mime: z.string().min(1),
+    name: z.string().default(""),
+    sizeBytes: z.number().int().nonnegative(),
+})
+    .strict();
+export const ControlUploadStatus = z
+    .object({
+    uploadId: Id,
+    state: z.enum(["open", "uploading", "uploaded", "cancelled"]),
+    receivedBytes: z.number().int().nonnegative(),
+    expectedBytes: z.number().int().nonnegative(),
+})
+    .strict();
+export const ControlResource = z
+    .object({
+    resourceId: Id,
+    kind: AttachmentKind,
+    mime: z.string().min(1),
+    name: z.string(),
+    sha256: ContentHash,
+    sizeBytes: z.number().int().nonnegative(),
+    createdAt: IsoTimestamp,
+    deduplicated: z.boolean(),
+})
+    .strict();
+export const ControlUploadFinalizeRequest = z
+    .object({ expectedSha256: ContentHash.optional() })
+    .strict();
 //# sourceMappingURL=attachment.js.map

package/dist/attachment.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../src/attachment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;KACvB,QAAQ,CAAC,mEAAmE,CAAC,CAAC;AAGjF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACjC,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC7F,0DAA0D;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iFAAiF,CAAC;CAC7G,CAAC;KACD,QAAQ,CACP,kJAAkJ,CACnJ,CAAC;AAGJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC/E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IACxI,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,iFAAiF,CAAC;CAC/F,CAAC;KACD,QAAQ,CACP,8KAA8K,CAC/K,CAAC;AAGJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,IAAI,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;KAC7D,QAAQ,CACP,uMAAuM,CACxM,CAAC"}
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../src/attachment.ts"],"names":[],"mappings":"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"}