@claudexor/schema 4.6.2 → 4.8.1

package/dist/run-observation.js

@@ -0,0 +1,93 @@
+import { z } from "zod/v3";
+import { ControlRunState } from "./control.js";
+import { TaskGroupId } from "./task-group.js";
+export const RUN_WAIT_MANY_MAX_TARGETS = 1000;
+export const RUN_WAIT_MANY_REQUEST_BYTES = 1_048_576;
+export const RUN_WAIT_MANY_RESULT_BYTES = 131_072;
+const token = z
+    .string()
+    .length(43)
+    .regex(/^[A-Za-z0-9_-]{43}$/);
+const handle = z.string().trim().min(1).max(256);
+/** Internal scalar projection. Stored facts are validated per target, so one
+ * malformed lifecycle cannot turn healthy sibling observations into failures. */
+export const RunObservationRecord = z
+    .object({
+    jobId: z.string().min(1),
+    runId: z.string().min(1).nullable(),
+    partition: z.string().min(1),
+    epoch: z.string().min(1),
+    state: ControlRunState,
+    createdAt: z.string().min(1),
+    taskGroupId: TaskGroupId.optional(),
+})
+    .strict();
+export const RunWaitManyInput = z
+    .preprocess((value, ctx) => {
+    // Measure the actual compact request before trimming IDs or adding defaults.
+    // HTTP admission separately bounds incoming bytes before reading the body.
+    try {
+        const json = JSON.stringify(value);
+        if (json !== undefined && Buffer.byteLength(json, "utf8") > RUN_WAIT_MANY_REQUEST_BYTES)
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "wait-many request exceeds 1048576 bytes",
+            });
+    }
+    catch {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "wait-many request must be JSON serializable",
+        });
+    }
+    return value;
+}, z
+    .object({
+    targets: z
+        .array(z.object({ runId: handle, seen: token.optional() }).strict())
+        .min(1)
+        .max(RUN_WAIT_MANY_MAX_TARGETS),
+    waitMs: z.number().int().min(0).max(50_000).default(25_000),
+})
+    .strict())
+    .describe("Read-only attention observation; compact request JSON is at most 1048576 UTF-8 bytes.");
+export const RunWaitManySummary = z.union([
+    z.object({ status: ControlRunState, pending: z.boolean(), token, problem: z.null() }).strict(),
+    z
+        .object({
+        status: z.null(),
+        pending: z.null(),
+        token: z.null(),
+        problem: z.enum(["not_found", "snapshot_unavailable", "not_observed"]),
+    })
+        .strict(),
+]);
+export const RunWaitManyResult = z
+    .object({
+    wakeReason: z.enum(["attention", "problems", "timeout", "aborted"]),
+    attention: z
+        .array(z
+        .number()
+        .int()
+        .min(0)
+        .max(RUN_WAIT_MANY_MAX_TARGETS - 1))
+        .max(RUN_WAIT_MANY_MAX_TARGETS),
+    summaries: z.array(RunWaitManySummary).min(1).max(RUN_WAIT_MANY_MAX_TARGETS),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    if (value.attention.some((index, position) => index >= value.summaries.length ||
+        (position > 0 && index <= value.attention[position - 1])))
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["attention"],
+            message: "attention indexes must be ascending unique summary positions",
+        });
+    if (Buffer.byteLength(JSON.stringify(value), "utf8") > RUN_WAIT_MANY_RESULT_BYTES)
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "wait-many result exceeds 131072 bytes",
+        });
+})
+    .describe("Lifecycle and pending attention only, at most 131072 UTF-8 JSON bytes; output readiness is a separate addressed read.");
+//# sourceMappingURL=run-observation.js.map

package/dist/run-observation.js.map

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

package/dist/setup-login.d.ts

@@ -13,7 +13,7 @@ export declare const SetupLoginManifest: z.ZodEffects<z.ZodObject<{
     version: z.ZodLiteral<2>;
     jobId: z.ZodString;
     executionId: z.ZodString;
-    harness: z.ZodEnum<["codex", "claude", "cursor", "agy"]>;
+    harness: z.ZodEnum<["codex", "claude", "cursor", "agy", "grok"]>;
     jobDir: z.ZodString;
     binary: z.ZodString;
     args: z.ZodArray<z.ZodString, "many">;
@@ -92,7 +92,7 @@ export declare const SetupLoginManifest: z.ZodEffects<z.ZodObject<{
     version: 2;
     jobId: string;
     executionId: string;
-    harness: "agy" | "claude" | "codex" | "cursor";
+    harness: "agy" | "claude" | "codex" | "cursor" | "grok";
     jobDir: string;
     binary: string;
     args: string[];
@@ -127,7 +127,7 @@ export declare const SetupLoginManifest: z.ZodEffects<z.ZodObject<{
     version: 2;
     jobId: string;
     executionId: string;
-    harness: "agy" | "claude" | "codex" | "cursor";
+    harness: "agy" | "claude" | "codex" | "cursor" | "grok";
     jobDir: string;
     binary: string;
     args: string[];
@@ -162,7 +162,7 @@ export declare const SetupLoginManifest: z.ZodEffects<z.ZodObject<{
     version: 2;
     jobId: string;
     executionId: string;
-    harness: "agy" | "claude" | "codex" | "cursor";
+    harness: "agy" | "claude" | "codex" | "cursor" | "grok";
     jobDir: string;
     binary: string;
     args: string[];
@@ -197,7 +197,7 @@ export declare const SetupLoginManifest: z.ZodEffects<z.ZodObject<{
     version: 2;
     jobId: string;
     executionId: string;
-    harness: "agy" | "claude" | "codex" | "cursor";
+    harness: "agy" | "claude" | "codex" | "cursor" | "grok";
     jobDir: string;
     binary: string;
     args: string[];