@m6d/cortex-cli 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@m6d/cortex-cli",
-    "version": "0.6.0",
+    "version": "0.7.0",
     "description": "Scaffold and operate Cortex servers",
     "license": "MIT",
     "type": "module",

package/src/contracts/runtime/sync.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { MESSAGE_ROLES, type TokenUsage } from "../wire/index";
 import { agentRefSchema, agentSlugSchema, variableDeclarationSchema } from "./grammar";
-import { TRIGGER_OUTCOMES, TRIGGER_SOURCES } from "./triggers";
+import { approvalRequestedEventSchema, TRIGGER_OUTCOMES, TRIGGER_SOURCES } from "./triggers";
 import { DATASET_ERROR_KINDS } from "./datasets";
 
 /*
@@ -141,6 +141,19 @@ export const syncEventSchema = z.discriminatedUnion("type", [
         createdAt: z.iso.datetime(),
         finishedAt: z.iso.datetime().nullable(),
     }),
+    /**
+     * A run on a cc-backed agent parked on approval. cc delivers it to the
+     * published webhooks in the agent's audience; a code agent reacts in
+     * code and sends none.
+     */
+    z.object({
+        type: z.literal("approval.requested"),
+        id: z.uuid(),
+        agentSlug: agentSlugSchema,
+        agentRef: agentRefSchema,
+        payload: approvalRequestedEventSchema,
+        createdAt: z.iso.datetime(),
+    }),
     /** What the server offers console-created agents, sent whole at boot and replacing the previous declaration. */
     z.object({
         type: z.literal("server.declare"),

package/src/contracts/runtime/triggers.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { datasetIdentifierSchema } from "./datasets";
 import {
+    agentRefSchema,
     agentSlugSchema,
     localizedTextSchema,
     mentionedToolSchema,
@@ -159,6 +160,31 @@ const triggerApprovalSchema = z.object({
     input: z.unknown(),
 });
 
+/** The host-reaction events a run reports. One so far; the shape is generic. */
+export const HOST_EVENTS = ["approval_requested"] as const;
+
+/**
+ * A run parked on server tools that need the user's approval, as every host
+ * hears of it: the code hook's argument and a webhook's body are this one
+ * object. `agentId` is the slug; `agentRef` is cc's id when cc backs the
+ * agent. `firingId` and `triggerName` are set when a trigger started the run,
+ * which is what a host answering through the firing route needs.
+ */
+export const approvalRequestedEventSchema = z.object({
+    event: z.literal("approval_requested"),
+    agentId: z.string(),
+    agentRef: agentRefSchema.optional(),
+    threadId: z.string(),
+    runId: z.string(),
+    userId: z.string(),
+    firingId: z.uuid().optional(),
+    triggerName: z.string().optional(),
+    /** The hook always gets each call's `input`; a webhook body leaves it out when the whole would be too large for the wire. */
+    approvals: z.array(triggerApprovalSchema.extend({ input: z.unknown().optional() })),
+    occurredAt: z.iso.datetime(),
+});
+export type ApprovalRequestedEvent = z.infer<typeof approvalRequestedEventSchema>;
+
 export const triggerFiringResponseSchema = z.discriminatedUnion("outcome", [
     z.object({
         firingId: z.uuid(),

package/src/scaffold/files.ts

@@ -27,7 +27,7 @@ export type Database = "postgres" | "mssql";
 // sync (scripts/sync-package-versions.ts) restamps it and files.test.ts holds
 // them to that.
 export const DEPENDENCIES = {
-    "@m6d/cortex-server": "~0.6.0",
+    "@m6d/cortex-server": "~0.7.0",
     "@tanstack/ai": "^0.55.0",
     "@tanstack/ai-openai": "^0.22.8",
     hono: "^4.12.3",