@vercel/factory 0.0.21 → 0.0.22

package/dist/schema/task-graph.d.mts

@@ -258,6 +258,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   reportRef?: string | undefined;
 }>> & z.ZodType<({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -271,10 +275,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -335,6 +335,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   parentTaskId?: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -348,10 +352,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -418,6 +418,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   parentTaskId?: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -431,10 +435,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -501,6 +501,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   parentTaskId: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -514,10 +518,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -656,6 +656,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   reportRef?: string | undefined;
 }, z.core.$ZodTypeInternals<({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -669,10 +673,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -733,6 +733,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   parentTaskId?: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -746,10 +750,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -816,6 +816,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   parentTaskId?: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -829,10 +833,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -899,6 +899,10 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   parentTaskId: `task_${string}`;
 }) | ({
   id: `task_${string}`;
+  origin: {
+    signalId?: `sig_${string}` | undefined;
+    operator?: string | undefined;
+  };
   schemaVersion: 1;
   replyTo: {
     channel: string;
@@ -912,10 +916,6 @@ declare const taskGraphAdmissionSchema: Omit<z.ZodObject<{
   model?: string | undefined;
   area?: string | undefined;
   approval?: "required" | "granted" | "denied" | undefined;
-  origin: {
-    signalId?: `sig_${string}` | undefined;
-    operator?: string | undefined;
-  };
   work: {
     title: string;
     input: JsonValue;
@@ -1308,6 +1308,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     reportRef?: string | undefined;
   }>> & z.ZodType<({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1321,10 +1325,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -1385,6 +1385,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     parentTaskId?: `task_${string}`;
   }) | ({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1398,10 +1402,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -1468,6 +1468,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     parentTaskId?: `task_${string}`;
   }) | ({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1481,10 +1485,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -1551,6 +1551,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     parentTaskId: `task_${string}`;
   }) | ({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1564,10 +1568,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -1706,6 +1706,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     reportRef?: string | undefined;
   }, z.core.$ZodTypeInternals<({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1719,10 +1723,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -1783,6 +1783,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     parentTaskId?: `task_${string}`;
   }) | ({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1796,10 +1800,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -1866,6 +1866,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     parentTaskId?: `task_${string}`;
   }) | ({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1879,10 +1883,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -1949,6 +1949,10 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     parentTaskId: `task_${string}`;
   }) | ({
     id: `task_${string}`;
+    origin: {
+      signalId?: `sig_${string}` | undefined;
+      operator?: string | undefined;
+    };
     schemaVersion: 1;
     replyTo: {
       channel: string;
@@ -1962,10 +1966,6 @@ declare const taskGraphNodeSchema: z.ZodObject<{
     model?: string | undefined;
     area?: string | undefined;
     approval?: "required" | "granted" | "denied" | undefined;
-    origin: {
-      signalId?: `sig_${string}` | undefined;
-      operator?: string | undefined;
-    };
     work: {
       title: string;
       input: JsonValue;
@@ -2366,6 +2366,10 @@ declare const taskGraphSchema: z.ZodObject<{
       reportRef?: string | undefined;
     }>> & z.ZodType<({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -2379,10 +2383,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;
@@ -2443,6 +2443,10 @@ declare const taskGraphSchema: z.ZodObject<{
       parentTaskId?: `task_${string}`;
     }) | ({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -2456,10 +2460,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;
@@ -2526,6 +2526,10 @@ declare const taskGraphSchema: z.ZodObject<{
       parentTaskId?: `task_${string}`;
     }) | ({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -2539,10 +2543,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;
@@ -2609,6 +2609,10 @@ declare const taskGraphSchema: z.ZodObject<{
       parentTaskId: `task_${string}`;
     }) | ({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -2622,10 +2626,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;
@@ -2764,6 +2764,10 @@ declare const taskGraphSchema: z.ZodObject<{
       reportRef?: string | undefined;
     }, z.core.$ZodTypeInternals<({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -2777,10 +2781,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;
@@ -2841,6 +2841,10 @@ declare const taskGraphSchema: z.ZodObject<{
       parentTaskId?: `task_${string}`;
     }) | ({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -2854,10 +2858,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;
@@ -2924,6 +2924,10 @@ declare const taskGraphSchema: z.ZodObject<{
       parentTaskId?: `task_${string}`;
     }) | ({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -2937,10 +2941,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;
@@ -3007,6 +3007,10 @@ declare const taskGraphSchema: z.ZodObject<{
       parentTaskId: `task_${string}`;
     }) | ({
       id: `task_${string}`;
+      origin: {
+        signalId?: `sig_${string}` | undefined;
+        operator?: string | undefined;
+      };
       schemaVersion: 1;
       replyTo: {
         channel: string;
@@ -3020,10 +3024,6 @@ declare const taskGraphSchema: z.ZodObject<{
       model?: string | undefined;
       area?: string | undefined;
       approval?: "required" | "granted" | "denied" | undefined;
-      origin: {
-        signalId?: `sig_${string}` | undefined;
-        operator?: string | undefined;
-      };
       work: {
         title: string;
         input: JsonValue;

package/dist/schema/transcript.d.mts

@@ -24,9 +24,9 @@ declare const toolCallSchema: z.ZodReadonly<z.ZodObject<{
     running: "running";
     failed: "failed";
     cancelled: "cancelled";
-    rejected: "rejected";
     "input-streaming": "input-streaming";
     completed: "completed";
+    rejected: "rejected";
   }>;
 }, z.core.$strip>>;
 /** Validates a rendered transcript block with payloads correlated to its kind. */
@@ -81,9 +81,9 @@ declare const transcriptBlockSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.Zo
       running: "running";
       failed: "failed";
       cancelled: "cancelled";
-      rejected: "rejected";
       "input-streaming": "input-streaming";
       completed: "completed";
+      rejected: "rejected";
     }>;
   }, z.core.$strip>>;
   attachments: z.ZodOptional<z.ZodNever>;
@@ -149,9 +149,9 @@ declare const transcriptSnapshotSchema: z.ZodReadonly<z.ZodObject<{
         running: "running";
         failed: "failed";
         cancelled: "cancelled";
-        rejected: "rejected";
         "input-streaming": "input-streaming";
         completed: "completed";
+        rejected: "rejected";
       }>;
     }, z.core.$strip>>;
     attachments: z.ZodOptional<z.ZodNever>;
@@ -255,9 +255,9 @@ declare const transcriptPageSchema: z.ZodObject<{
           running: "running";
           failed: "failed";
           cancelled: "cancelled";
-          rejected: "rejected";
           "input-streaming": "input-streaming";
           completed: "completed";
+          rejected: "rejected";
         }>;
       }, z.core.$strip>>;
       attachments: z.ZodOptional<z.ZodNever>;

package/docs/recipes/repository-scripts.md

@@ -0,0 +1,64 @@
+# Run repository-defined scripts on events
+
+Use repository scripts for small, bounded jobs such as classifying a newly opened issue, commenting
+with the result, and adding a label. Scripts run as workflow-owned Factory Tasks, so admission,
+retries, usage, and completion remain inspectable without starting an agent.
+
+In a factory created by `@vercel/factory-cli`, install the included issue-classification preset with
+`factory add script --template issue-classifier`. To define a different policy, create a subfolder
+and register it as shown below.
+
+Create a subfolder such as `factory/scripts/issue-classifier/` and export an exact script definition:
+
+```ts
+import { defineRepositoryScript } from "@vercel/factory/repository-scripts";
+
+export default defineRepositoryScript({
+  id: "issue-classifier",
+  version: 1,
+  on: ["github.issues.opened"],
+  repositories: ["acme/web"],
+  permissions: ["ai:classify", "github:issues:comment", "github:issues:label"],
+  async run({ event, classify }) {
+    const result = await classify({
+      instruction: "Classify the issue by its primary intent.",
+      subject: `${event.issue.title}\n\n${event.issue.body ?? ""}`,
+      choices: ["bug", "question", "feature"],
+    });
+    return {
+      actions: [
+        {
+          type: "github.issue.comment",
+          body: `Classified as **${result.choice}**. ${result.reason}`,
+        },
+        {
+          type: "github.issue.addLabel",
+          label: {
+            name: result.choice,
+            color: "1D76DB",
+            description: "Issue classification produced by Factory",
+          },
+        },
+      ],
+    };
+  },
+});
+```
+
+Import the definition in `factory/scripts/index.ts`:
+
+```ts
+import { defineRepositoryScripts } from "@vercel/factory/repository-scripts";
+import issueClassifier from "./issue-classifier/script";
+
+export const repositoryScripts = defineRepositoryScripts([issueClassifier]);
+```
+
+The event's repository must still appear in `factory.config.ts`. Permissions are deny-by-default:
+calling `classify` or returning an action without its declared permission fails the Task. A matching
+script handles the Signal instead of sending it to Foreman.
+
+When behavior changes, register a new active version and retain the previous definition with
+`active: false` until no stored Task can reference it. Script results are persisted before GitHub
+effects, so a retry reuses the same classification and action plan. Comment actions are reconciled
+by a hidden stable marker, and label additions are idempotent.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/factory",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "Schema, state machines, and kernel primitives for Agent Factory.",
   "homepage": "https://github.com/vercel-labs/agent-factory/tree/main/packages/factory",
   "bugs": "https://github.com/vercel-labs/agent-factory/issues",
@@ -32,6 +32,10 @@
       "types": "./dist/workflows.d.mts",
       "import": "./dist/workflows.mjs"
     },
+    "./repository-scripts": {
+      "types": "./dist/repository-scripts.d.mts",
+      "import": "./dist/repository-scripts.mjs"
+    },
     "./execution": {
       "types": "./dist/execution-public.d.mts",
       "import": "./dist/execution-public.mjs"
@@ -141,9 +145,9 @@
     "diff": "8.0.2"
   },
   "devDependencies": {
-    "@ai-sdk/harness": "1.0.108",
-    "@ai-sdk/harness-claude-code": "1.0.112",
-    "@ai-sdk/sandbox-vercel": "1.0.108",
+    "@ai-sdk/harness": "1.0.115",
+    "@ai-sdk/harness-claude-code": "1.0.119",
+    "@ai-sdk/sandbox-vercel": "1.0.115",
     "@electric-sql/pglite": "^0.5.7",
     "@types/pg": "^8.23.1",
     "@vercel/blob": "^2.8.0",