@chipschat/protocol 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chipschat/protocol",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Agent Connect: the canonical Zod schemas, the identifier vocabulary, and everything generated from them.",
   "license": "Apache-2.0",
   "homepage": "https://chipschat.ai/reference/",
@@ -9,6 +9,7 @@
     "url": "git+https://github.com/arjungupta99/chips.git",
     "directory": "packages/protocol"
   },
+  "bugs": "https://github.com/arjungupta99/chips/issues",
   "type": "module",
   "exports": {
     ".": {

package/dist/envelope.d.ts

@@ -1,54 +0,0 @@
-/**
- * Every Agent Connect event is an envelope plus a payload. The envelope is the part Chips
- * itself reads: who acted, in which workspace, on which run, and — for anything a client
- * sends — the key that makes replaying it safe.
- *
- * The shape is fixed by Appendix C of the technical plan.
- */
-import { z } from "zod";
-/** The protocol version this build speaks. Breaking changes only at a major, after 1.0. */
-export declare const PROTOCOL_VERSION: 1;
-export declare const envelope: z.ZodObject<{
-    v: z.ZodLiteral<1>;
-    type: z.ZodString;
-    id: z.ZodString;
-    ts: z.ZodISODateTime;
-    workspace_id: z.ZodString;
-    conversation_id: z.ZodOptional<z.ZodString>;
-    run_id: z.ZodOptional<z.ZodString>;
-    seq: z.ZodOptional<z.ZodInt>;
-    idempotency_key: z.ZodOptional<z.ZodString>;
-    actor: z.ZodObject<{
-        kind: z.ZodEnum<{
-            person: "person";
-            agent: "agent";
-            system: "system";
-        }>;
-        id: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export type Envelope = z.infer<typeof envelope>;
-/**
- * Which way an event travels. `workspace` events never leave Chips: they record a human action
- * on the workspace itself, so the read models that depend on them can be replayed (ADR 0018).
- */
-export type Direction = "agent_to_chips" | "chips_to_agent" | "workspace";
-/** The description of one event type: everything the schema, the docs and the tests need. */
-export interface EventDefinition<TType extends string = string> {
-    /** The wire value of `type`. */
-    readonly type: TType;
-    readonly direction: Direction;
-    /** One sentence, in the product voice. Becomes the reference page's opening line. */
-    readonly summary: string;
-    /** The fields this event adds to the envelope. */
-    readonly payload: z.ZodObject;
-    /** Whether an agent may send this without a `run_id`. */
-    readonly requiresRun: boolean;
-}
-/** Build the full schema for an event: the envelope, its `type` narrowed, and its payload. */
-export declare function eventSchema<TType extends string>(definition: EventDefinition<TType>): z.ZodObject<{
-    [x: string]: any;
-}, z.core.$strip>;
-/** Helper for declaring a definition without losing the literal type of `type`. */
-export declare function defineEvent<TType extends string>(definition: EventDefinition<TType>): EventDefinition<TType>;
-//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAE3C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;iBA4BuC,CAAC;AAE7D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAE1E,6FAA6F;AAC7F,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IAC5D,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC;;kBAKnF;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAC9C,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,GACjC,eAAe,CAAC,KAAK,CAAC,CAExB"}

package/dist/envelope.js

@@ -1,48 +0,0 @@
-/**
- * Every Agent Connect event is an envelope plus a payload. The envelope is the part Chips
- * itself reads: who acted, in which workspace, on which run, and — for anything a client
- * sends — the key that makes replaying it safe.
- *
- * The shape is fixed by Appendix C of the technical plan.
- */
-import { z } from "zod";
-import { actor, id, isoTimestamp } from "./primitives.js";
-/** The protocol version this build speaks. Breaking changes only at a major, after 1.0. */
-export const PROTOCOL_VERSION = 1;
-export const envelope = z
-    .object({
-    v: z.literal(PROTOCOL_VERSION).describe("Protocol major version."),
-    type: z.string().min(1).describe("The event type, for example `approval.request`."),
-    id: id("event").describe("The event's own id. Stable across a retry of the same event."),
-    ts: isoTimestamp.describe("When it happened, by Chips' clock. Stamped on the way in; a value the sender writes is replaced."),
-    workspace_id: id("workspace"),
-    conversation_id: id("conversation")
-        .optional()
-        .describe("The conversation, when the event belongs to one."),
-    run_id: id("run").optional().describe("The run, when the event belongs to one."),
-    seq: z
-        .int()
-        .positive()
-        .optional()
-        .describe("Assigned by the server on append, monotonic per workspace. Absent on the way in."),
-    idempotency_key: z
-        .string()
-        .min(1)
-        .max(200)
-        .optional()
-        .describe("Required on every client-originated write. Sending the same key twice is a no-op."),
-    actor,
-})
-    .describe("The fields every Agent Connect event carries.");
-/** Build the full schema for an event: the envelope, its `type` narrowed, and its payload. */
-export function eventSchema(definition) {
-    return envelope
-        .extend({ type: z.literal(definition.type) })
-        .extend(definition.payload.shape)
-        .describe(definition.summary);
-}
-/** Helper for declaring a definition without losing the literal type of `type`. */
-export function defineEvent(definition) {
-    return definition;
-}
-//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1D,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACnF,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,8DAA8D,CAAC;IACxF,EAAE,EAAE,YAAY,CAAC,QAAQ,CACvB,kGAAkG,CACnG;IACD,YAAY,EAAE,EAAE,CAAC,WAAW,CAAC;IAC7B,eAAe,EAAE,EAAE,CAAC,cAAc,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAChF,GAAG,EAAE,CAAC;SACH,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;IACH,KAAK;CACN,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAuB7D,8FAA8F;AAC9F,MAAM,UAAU,WAAW,CAAuB,UAAkC;IAClF,OAAO,QAAQ;SACZ,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5C,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;SAChC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CACzB,UAAkC;IAElC,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/events/agent-to-chips.d.ts

@@ -1,27 +0,0 @@
-/**
- * Events an agent sends to Chips.
- *
- * The interface is progressive (blueprint, Connect): the minimum is three events — a run
- * started, a message, a run completed. Every extra event upgrades what the person sees. Send
- * step logs and you get receipts; send approval requests and you get approval cards; send
- * context usage and you get the context ring.
- */
-export declare const runStarted: import("../envelope.js").EventDefinition<"run.started">;
-export declare const runStatus: import("../envelope.js").EventDefinition<"run.status">;
-export declare const runPlan: import("../envelope.js").EventDefinition<"run.plan">;
-export declare const stepLog: import("../envelope.js").EventDefinition<"step.log">;
-export declare const messagePost: import("../envelope.js").EventDefinition<"message.post">;
-export declare const approvalRequest: import("../envelope.js").EventDefinition<"approval.request">;
-export declare const questionAsk: import("../envelope.js").EventDefinition<"question.ask">;
-export declare const artifactCreate: import("../envelope.js").EventDefinition<"artifact.create">;
-export declare const checkpoint: import("../envelope.js").EventDefinition<"checkpoint">;
-export declare const handoff: import("../envelope.js").EventDefinition<"handoff">;
-export declare const task: import("../envelope.js").EventDefinition<"task">;
-export declare const usage: import("../envelope.js").EventDefinition<"usage">;
-export declare const contextUsage: import("../envelope.js").EventDefinition<"context.usage">;
-export declare const approvalExecuted: import("../envelope.js").EventDefinition<"approval.executed">;
-export declare const runCompleted: import("../envelope.js").EventDefinition<"run.completed">;
-export declare const runFailed: import("../envelope.js").EventDefinition<"run.failed">;
-/** Every event an agent may send, in the order the reference lists them. */
-export declare const AGENT_TO_CHIPS: readonly [import("../envelope.js").EventDefinition<"run.started">, import("../envelope.js").EventDefinition<"run.status">, import("../envelope.js").EventDefinition<"run.plan">, import("../envelope.js").EventDefinition<"step.log">, import("../envelope.js").EventDefinition<"message.post">, import("../envelope.js").EventDefinition<"approval.request">, import("../envelope.js").EventDefinition<"question.ask">, import("../envelope.js").EventDefinition<"artifact.create">, import("../envelope.js").EventDefinition<"checkpoint">, import("../envelope.js").EventDefinition<"handoff">, import("../envelope.js").EventDefinition<"task">, import("../envelope.js").EventDefinition<"usage">, import("../envelope.js").EventDefinition<"context.usage">, import("../envelope.js").EventDefinition<"approval.executed">, import("../envelope.js").EventDefinition<"run.completed">, import("../envelope.js").EventDefinition<"run.failed">];
-//# sourceMappingURL=agent-to-chips.d.ts.map

package/dist/events/agent-to-chips.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-to-chips.d.ts","sourceRoot":"","sources":["../../src/events/agent-to-chips.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH,eAAO,MAAM,UAAU,yDAsBrB,CAAC;AAEH,eAAO,MAAM,SAAS,wDAwBpB,CAAC;AAEH,eAAO,MAAM,OAAO,sDAoBlB,CAAC;AAEH,eAAO,MAAM,OAAO,sDAuBlB,CAAC;AAEH,eAAO,MAAM,WAAW,0DAqBtB,CAAC;AAEH,eAAO,MAAM,eAAe,8DAkD1B,CAAC;AAkCH,eAAO,MAAM,WAAW,0DAmBtB,CAAC;AAEH,eAAO,MAAM,cAAc,6DAczB,CAAC;AAEH,eAAO,MAAM,UAAU,wDAarB,CAAC;AAEH,eAAO,MAAM,OAAO,qDAYlB,CAAC;AAEH,eAAO,MAAM,IAAI,kDA0Cf,CAAC;AAEH,eAAO,MAAM,KAAK,mDAahB,CAAC;AAEH,eAAO,MAAM,YAAY,2DAYvB,CAAC;AAEH,eAAO,MAAM,gBAAgB,+DAY3B,CAAC;AAEH,eAAO,MAAM,YAAY,2DAevB,CAAC;AAEH,eAAO,MAAM,SAAS,wDAYpB,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,cAAc,s5BAiBjB,CAAC"}

package/dist/events/agent-to-chips.js

@@ -1,392 +0,0 @@
-/**
- * Events an agent sends to Chips.
- *
- * The interface is progressive (blueprint, Connect): the minimum is three events — a run
- * started, a message, a run completed. Every extra event upgrades what the person sees. Send
- * step logs and you get receipts; send approval requests and you get approval cards; send
- * context usage and you get the context ring.
- */
-import { z } from "zod";
-import { defineEvent } from "../envelope.js";
-import { action, approverRef, attachment, autonomyLevel, cost, id, isoTimestamp, preview, riskClass, source, } from "../primitives.js";
-const plannedStep = z
-    .object({
-    step_id: z
-        .string()
-        .min(1)
-        .max(120)
-        .describe("Stable for the life of the run, so updates land on the right row."),
-    title: z.string().min(1).max(300).describe("What this step will do."),
-})
-    .describe("One step of a plan, shown as a hollow dot until it completes.");
-export const runStarted = defineEvent({
-    type: "run.started",
-    direction: "agent_to_chips",
-    summary: "An agent has begun a unit of work, optionally with the plan it intends to follow.",
-    requiresRun: true,
-    payload: z.object({
-        goal: z
-            .string()
-            .min(1)
-            .max(4000)
-            .describe("What the run is for, in the person's words where possible."),
-        plan: z
-            .array(plannedStep)
-            .max(64)
-            .optional()
-            .describe("The steps the agent expects to take. The run panel draws one hollow dot each."),
-        session_ref: z
-            .string()
-            .max(500)
-            .optional()
-            .describe("A pointer back to the harness's own transcript, so a person can jump to it."),
-    }),
-});
-export const runStatus = defineEvent({
-    type: "run.status",
-    direction: "agent_to_chips",
-    summary: "What the agent is doing right now. This is the agent's typing indicator.",
-    requiresRun: true,
-    payload: z.object({
-        phase: z.string().min(1).max(120).describe("A short machine-ish label, for example `reading`."),
-        verb_phrase: z
-            .string()
-            .min(1)
-            .max(200)
-            .describe('What to show under the agent\'s name, for example "Reading PO #4471…".'),
-        progress: z
-            .number()
-            .min(0)
-            .max(1)
-            .optional()
-            .describe("Fraction complete, when the agent knows."),
-        estimate_seconds: z
-            .int()
-            .nonnegative()
-            .optional()
-            .describe("Seconds remaining, when the agent knows."),
-    }),
-});
-export const runPlan = defineEvent({
-    type: "run.plan",
-    direction: "agent_to_chips",
-    summary: "The plan changed. Replaces the steps not yet done; the ones already done or failed keep their place.",
-    requiresRun: true,
-    payload: z.object({
-        plan: z
-            .array(plannedStep)
-            .min(1)
-            .max(64)
-            .describe("The steps still to come, in order. Steps already done or failed stay ahead of these; a step still to do that is not here is dropped."),
-        reason: z
-            .string()
-            .max(1000)
-            .optional()
-            .describe("Why the plan changed, in a sentence: a steer, a surprise, a shortcut."),
-    }),
-});
-export const stepLog = defineEvent({
-    type: "step.log",
-    direction: "agent_to_chips",
-    summary: "One tool call or reasoning step, for the receipt and the run timeline.",
-    requiresRun: true,
-    payload: z.object({
-        step_id: z
-            .string()
-            .min(1)
-            .max(120)
-            .describe("Stable across the started and done events for one step."),
-        status: z.enum(["started", "done", "failed"]).describe("Where this step got to."),
-        title: z
-            .string()
-            .max(300)
-            .optional()
-            .describe("What the step is, when it was not in the plan."),
-        tool: z.string().max(120).optional().describe("The tool called, for example `drive.read`."),
-        summary: z.string().max(2000).optional().describe("One line for the receipt."),
-        sources: z.array(source).max(32).optional().describe("Where the information came from."),
-        duration_ms: z.int().nonnegative().optional().describe("How long the step took."),
-        error: z.string().max(2000).optional().describe("Why it failed, when it did."),
-    }),
-});
-export const messagePost = defineEvent({
-    type: "message.post",
-    direction: "agent_to_chips",
-    summary: "An agent says something in a conversation, with any attachments.",
-    requiresRun: false,
-    payload: z.object({
-        text: z.string().max(64_000).describe("Markdown, with mentions."),
-        attachments: z
-            .array(attachment)
-            .max(20)
-            .optional()
-            .describe("Photos, video, voice notes, files, as the upload described them."),
-        upload_ids: z
-            .array(id("attachment"))
-            .max(20)
-            .optional()
-            .describe("Uploads to attach, by the id `POST /v1/uploads` gave. Chips fills in `attachments` from what it stored."),
-        reply_to: id("message").optional().describe("The message being answered, when it is a reply."),
-    }),
-});
-export const approvalRequest = defineEvent({
-    type: "approval.request",
-    direction: "agent_to_chips",
-    summary: "The thing a group chat cannot do: an action, a preview, a risk class, who may answer, and an audit record.",
-    requiresRun: true,
-    payload: z.object({
-        approval_id: id("approval").describe("Minted by the agent, so a retry after a reconnect is the same ask."),
-        step_id: z.string().min(1).max(120).optional().describe("The plan step this ask belongs to."),
-        action,
-        preview: preview
-            .optional()
-            .describe("What the approver sees. Omit only when the action speaks for itself."),
-        risk: z
-            .array(riskClass)
-            .max(8)
-            .describe("Risk classes. The policy engine matches rules against these."),
-        sources: z
-            .array(source)
-            .max(32)
-            .optional()
-            .describe("Where the agent got what it is about to act on."),
-        expires_in: z
-            .int()
-            .positive()
-            .max(604_800)
-            .describe("Seconds until the approval expires. Every approval has an expiry and a fallback."),
-        fallback: z
-            .enum(["deny", "allow"])
-            .default("deny")
-            .describe("What happens on expiry. Denying is the default, and the safe one."),
-        approvers: z
-            .array(approverRef)
-            .max(16)
-            .optional()
-            .describe("Who may answer. Chips resolves roles."),
-        editable: z
-            .boolean()
-            .default(false)
-            .describe("Whether the approver may change the input before allowing."),
-        resume_token: z
-            .string()
-            .max(500)
-            .optional()
-            .describe("Lets a paused command-line run continue hours later. Approvals outlive processes."),
-    }),
-});
-const questionOption = z
-    .object({
-    value: z.string().min(1).max(120).describe("What comes back in `question.answered`."),
-    label: z.string().min(1).max(200).describe("What the person taps."),
-    description: z.string().max(500).optional().describe("What choosing it means."),
-})
-    .describe("One tappable option.");
-const question = z
-    .object({
-    question_id: z
-        .string()
-        .min(1)
-        .max(120)
-        .describe("Stable, so answers land on the right question."),
-    prompt: z.string().min(1).max(2000).describe("What is being asked."),
-    options: z.array(questionOption).min(2).max(4).describe("Two to four options."),
-    multi_select: z
-        .boolean()
-        .default(false)
-        .describe("Whether more than one option may be chosen."),
-    allow_free_text: z.boolean().default(false).describe("Whether the person may type instead."),
-    default_value: z
-        .string()
-        .max(120)
-        .optional()
-        .describe("What the agent will take if nobody answers. Its presence lowers the notification tier."),
-})
-    .describe("One question, with its options.");
-export const questionAsk = defineEvent({
-    type: "question.ask",
-    direction: "agent_to_chips",
-    summary: "One to four questions with tappable options, a default, and a timeout.",
-    requiresRun: true,
-    payload: z.object({
-        ask_id: id("question").describe("Minted by the agent, so a retry is the same ask."),
-        questions: z.array(question).min(1).max(4).describe("One to four questions."),
-        timeout_seconds: z
-            .int()
-            .positive()
-            .max(604_800)
-            .optional()
-            .describe("How long to wait for an answer."),
-        on_no_answer: z
-            .enum(["use_default", "cancel", "continue"])
-            .default("use_default")
-            .describe("What the agent will do if the timeout passes."),
-    }),
-});
-export const artifactCreate = defineEvent({
-    type: "artifact.create",
-    direction: "agent_to_chips",
-    summary: "A file, document, code, image or table the agent produced, with a version.",
-    requiresRun: false,
-    payload: z.object({
-        artifact_id: id("attachment").describe("Content-addressed, like every attachment."),
-        kind: z.enum(["file", "document", "code", "image", "table"]).describe("How to render it."),
-        title: z.string().min(1).max(300).describe("What to call it."),
-        version: z.int().positive().default(1).describe("Bumped when the agent revises it."),
-        attachment: attachment.optional().describe("The bytes, when the artifact is a file."),
-        body: z.string().max(1_000_000).optional().describe("The content, when the artifact is text."),
-        language: z.string().max(60).optional().describe("For code, the language to highlight."),
-    }),
-});
-export const checkpoint = defineEvent({
-    type: "checkpoint",
-    direction: "agent_to_chips",
-    summary: "A milestone reached and what is next. Compaction is a checkpoint. FYI tier.",
-    requiresRun: true,
-    payload: z.object({
-        label: z.string().min(1).max(300).describe("The milestone reached."),
-        next: z.string().max(300).optional().describe("What the agent will do next."),
-        compacted: z
-            .boolean()
-            .default(false)
-            .describe("True when the agent just compacted its context."),
-    }),
-});
-export const handoff = defineEvent({
-    type: "handoff",
-    direction: "agent_to_chips",
-    summary: "Passing work to a person or another agent, with a context summary and what is still open.",
-    requiresRun: false,
-    payload: z.object({
-        to: z.string().min(1).max(120).describe("The participant id receiving the work."),
-        context_summary: z.string().min(1).max(20_000).describe("What the recipient needs to know."),
-        open_items: z.array(z.string().max(500)).max(50).optional().describe("What is still undone."),
-        reason: z.string().max(1000).optional().describe("Why the work is moving."),
-    }),
-});
-export const task = defineEvent({
-    type: "task",
-    direction: "agent_to_chips",
-    summary: "Route work to another agent. From a lead this becomes a lane: one object, two views, never a copy.",
-    requiresRun: false,
-    payload: z.object({
-        task_id: id("lane").describe("The lane this task opens."),
-        to: z
-            .string()
-            .min(1)
-            .max(120)
-            .describe("The specialist's participant id, or a label for an ephemeral child."),
-        child: z
-            .object({
-            label: z
-                .string()
-                .min(1)
-                .max(120)
-                .describe("A name for a transient participant Chips will mint."),
-        })
-            .optional()
-            .describe("Names an ephemeral child, which inherits owner, autonomy and budget from the lead."),
-        on_behalf_of: z.string().min(1).max(120).describe("The person the work is ultimately for."),
-        origin: id("message").optional().describe("The message that caused this routing."),
-        goal: z.string().min(1).max(4000).describe("What the specialist is being asked to do."),
-        constraints: z
-            .array(z.string().max(500))
-            .max(20)
-            .optional()
-            .describe("Bounds on how to do it."),
-        deadline: isoTimestamp.optional().describe("When it is needed by."),
-        autonomy: autonomyLevel
-            .optional()
-            .describe("The level for this lane. Never above the lead's own."),
-        attachments: z.array(attachment).max(20).optional().describe("Anything the specialist needs."),
-        link_to: id("conversation")
-            .optional()
-            .describe("The lead's conversation, where the route card appears."),
-    }),
-});
-export const usage = defineEvent({
-    type: "usage",
-    direction: "agent_to_chips",
-    summary: "Tokens and cost for a step, a run or a lane. Cost rolls up the trail and is always an estimate.",
-    requiresRun: true,
-    payload: z.object({
-        scope: z.enum(["step", "run", "lane"]).describe("What the numbers cover."),
-        model: z.string().min(1).max(120).describe("The model that did the work."),
-        input_tokens: z.int().nonnegative().describe("Tokens in."),
-        output_tokens: z.int().nonnegative().describe("Tokens out."),
-        cost: cost.optional().describe("The estimated cost, when the agent can compute one."),
-    }),
-});
-export const contextUsage = defineEvent({
-    type: "context.usage",
-    direction: "agent_to_chips",
-    summary: "How full the agent's context is. Drives the context ring; context stays per agent, never rolled up.",
-    requiresRun: true,
-    payload: z.object({
-        used_tokens: z.int().nonnegative().describe("Tokens currently held."),
-        limit_tokens: z.int().positive().describe("The window size."),
-        model: z.string().min(1).max(120).describe("The model whose window this is."),
-        compacted: z.boolean().default(false).describe("True when the agent just compacted."),
-    }),
-});
-export const approvalExecuted = defineEvent({
-    type: "approval.executed",
-    direction: "agent_to_chips",
-    summary: "What happened after a yes. The card changes from `approved` to `sent`, or to `failed`.",
-    requiresRun: true,
-    payload: z.object({
-        approval_id: id("approval"),
-        outcome: z
-            .enum(["executed", "failed", "skipped"])
-            .describe("Whether the action actually happened."),
-        detail: z.string().max(4000).optional().describe("What was sent, or why it failed."),
-    }),
-});
-export const runCompleted = defineEvent({
-    type: "run.completed",
-    direction: "agent_to_chips",
-    summary: "The run is done. Posts a summary card and moves the status pill to Done.",
-    requiresRun: true,
-    payload: z.object({
-        summary: z.string().min(1).max(20_000).describe("The outcome, in the product voice."),
-        changed: z.array(z.string().max(500)).max(50).optional().describe("What changed in the world."),
-        follow_ups: z
-            .array(z.string().max(500))
-            .max(50)
-            .optional()
-            .describe("What is worth doing next."),
-        cost: cost.optional().describe("The run's estimated cost."),
-    }),
-});
-export const runFailed = defineEvent({
-    type: "run.failed",
-    direction: "agent_to_chips",
-    summary: "The run stopped without finishing. Says what was left undone, so a person can pick it up.",
-    requiresRun: true,
-    payload: z.object({
-        error: z.string().min(1).max(4000).describe("What went wrong."),
-        left_undone: z.array(z.string().max(500)).max(50).optional().describe("What did not get done."),
-        retryable: z.boolean().default(false).describe("Whether running it again might work."),
-        cost: cost.optional().describe("What was spent before it failed."),
-    }),
-});
-/** Every event an agent may send, in the order the reference lists them. */
-export const AGENT_TO_CHIPS = [
-    runStarted,
-    runStatus,
-    runPlan,
-    stepLog,
-    messagePost,
-    approvalRequest,
-    questionAsk,
-    artifactCreate,
-    checkpoint,
-    handoff,
-    task,
-    usage,
-    contextUsage,
-    approvalExecuted,
-    runCompleted,
-    runFailed,
-];
-//# sourceMappingURL=agent-to-chips.js.map

package/dist/events/agent-to-chips.js.map

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

package/dist/events/catalogue.d.ts

@@ -1,48 +0,0 @@
-/**
- * The catalogue is the single list of every Agent Connect event. The schemas, the generated
- * JSON Schema, the generated types, the reference pages and the fixture tests are all reads
- * of this one array, so an event cannot exist in one of them and not the others.
- */
-import type { z } from "zod";
-import { type EventDefinition } from "../envelope.js";
-import { AGENT_TO_CHIPS } from "./agent-to-chips.js";
-import { CHIPS_TO_AGENT } from "./chips-to-agent.js";
-import { WORKSPACE_EVENTS } from "./workspace.js";
-/** Every event in the log: Agent Connect in both directions, then Chips' own (ADR 0018). */
-export declare const EVENTS: readonly EventDefinition[];
-/** Every event type, as a plain list of strings. */
-export declare const EVENT_TYPES: readonly string[];
-export type AgentToChipsType = (typeof AGENT_TO_CHIPS)[number]["type"];
-export type ChipsToAgentType = (typeof CHIPS_TO_AGENT)[number]["type"];
-export type WorkspaceEventType = (typeof WORKSPACE_EVENTS)[number]["type"];
-export type EventType = AgentToChipsType | ChipsToAgentType | WorkspaceEventType;
-/** The definition for one event type, or undefined when nothing declares it. */
-export declare function eventDefinition(type: string): EventDefinition | undefined;
-export declare function schemaFor(type: string): z.ZodObject | undefined;
-/** Every schema, keyed by event type. Used by the generators. */
-export declare const EVENT_SCHEMAS: ReadonlyMap<string, z.ZodObject>;
-export declare class UnknownEventTypeError extends Error {
-    readonly type: string;
-    readonly name = "UnknownEventTypeError";
-    constructor(type: string);
-}
-export interface ParseFailure {
-    readonly type: "unknown_type" | "invalid";
-    readonly message: string;
-    readonly issues?: readonly {
-        path: string;
-        message: string;
-    }[];
-}
-/**
- * Validate one event from the wire. This is the edge: everything inside trusts the result and
- * does not re-validate (technical-plan 6.1).
- */
-export declare function parseEvent(input: unknown): {
-    ok: true;
-    value: Record<string, unknown>;
-} | {
-    ok: false;
-    error: ParseFailure;
-};
-//# sourceMappingURL=catalogue.d.ts.map

package/dist/events/catalogue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../src/events/catalogue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,KAAK,eAAe,EAAe,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,4FAA4F;AAC5F,eAAO,MAAM,MAAM,EAAE,SAAS,eAAe,EAI5C,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAAsC,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAIjF,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAOD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,GAAG,SAAS,CAE/D;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAW,CAAC;AAEvE,qBAAa,qBAAsB,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADjC,SAAkB,IAAI,2BAA2B;gBAC5B,IAAI,EAAE,MAAM;CAGlC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA0BnF"}