@chipschat/protocol 0.0.0-stage → 1.0.0

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

@@ -0,0 +1,390 @@
+/**
+ * Events a harness 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: "harness_to_chips",
+    summary: "A harness 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 harness 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: "harness_to_chips",
+    summary: "What the harness is doing right now. This is the harness'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 harness\'s name, for example "Reading PO #4471…".'),
+        progress: z
+            .number()
+            .min(0)
+            .max(1)
+            .optional()
+            .describe("Fraction complete, when the harness knows."),
+        estimate_seconds: z
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Seconds remaining, when the harness knows."),
+    }),
+});
+export const runPlan = defineEvent({
+    type: "run.plan",
+    direction: "harness_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: "harness_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: "harness_to_chips",
+    summary: "A harness says something in a space, 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: "harness_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 harness, 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 harness 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 harness 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: "harness_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 harness, 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 harness will do if the timeout passes."),
+    }),
+});
+export const artifactCreate = defineEvent({
+    type: "artifact.create",
+    direction: "harness_to_chips",
+    summary: "A file, document, code, image or table the harness 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 harness 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: "harness_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 harness will do next."),
+        compacted: z
+            .boolean()
+            .default(false)
+            .describe("True when the harness just compacted its context."),
+    }),
+});
+export const handoff = defineEvent({
+    type: "handoff",
+    direction: "harness_to_chips",
+    summary: "Passing work to a person or another harness, 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: "harness_to_chips",
+    summary: "Route work to another harness. 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("space").optional().describe("The lead's space, where the route card appears."),
+    }),
+});
+export const usage = defineEvent({
+    type: "usage",
+    direction: "harness_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 harness can compute one."),
+    }),
+});
+export const contextUsage = defineEvent({
+    type: "context.usage",
+    direction: "harness_to_chips",
+    summary: "How full the harness's context is. Drives the context ring; context stays per harness, 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 harness just compacted."),
+    }),
+});
+export const approvalExecuted = defineEvent({
+    type: "approval.executed",
+    direction: "harness_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: "harness_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: "harness_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 a harness may send, in the order the reference lists them. */
+export const HARNESS_TO_CHIPS = [
+    runStarted,
+    runStatus,
+    runPlan,
+    stepLog,
+    messagePost,
+    approvalRequest,
+    questionAsk,
+    artifactCreate,
+    checkpoint,
+    handoff,
+    task,
+    usage,
+    contextUsage,
+    approvalExecuted,
+    runCompleted,
+    runFailed,
+];
+//# sourceMappingURL=harness-to-chips.js.map

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

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

package/dist/events/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./agent-to-chips.js";
+export type { AgentToChipsType, ChipsToAgentType, EventType, ParseFailure, WorkspaceEventType, } from "./catalogue.js";
+export { EVENT_SCHEMAS, EVENT_TYPES, EVENTS, eventDefinition, parseEvent, schemaFor, UnknownEventTypeError, } from "./catalogue.js";
+export * from "./chips-to-agent.js";
+export * from "./workspace.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,WAAW,EACX,MAAM,EACN,eAAe,EACf,UAAU,EACV,SAAS,EACT,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,5 @@
+export * from "./agent-to-chips.js";
+export { EVENT_SCHEMAS, EVENT_TYPES, EVENTS, eventDefinition, parseEvent, schemaFor, UnknownEventTypeError, } from "./catalogue.js";
+export * from "./chips-to-agent.js";
+export * from "./workspace.js";
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AAQpC,OAAO,EACL,aAAa,EACb,WAAW,EACX,MAAM,EACN,eAAe,EACf,UAAU,EACV,SAAS,EACT,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/events/workspace.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Events Chips records about itself.
+ *
+ * Agent Connect is the vocabulary an agent speaks. It is not the whole log. Decision 4 says
+ * every Agent Connect event **and every human action** is an event, and creating a conversation
+ * or adding somebody to one is a human action. Without these, `conversations` and `memberships`
+ * would be read models that no replay could reconstruct — which would make `rebuild` a lie.
+ *
+ * These never travel to an agent. An agent learns that it was added to a conversation from
+ * `message.new`, not from here. See ADR 0018 for the line between what is event-sourced and
+ * what is a registry.
+ */
+export declare const conversationCreated: import("../envelope.js").EventDefinition<"conversation.created">;
+export declare const membershipAdded: import("../envelope.js").EventDefinition<"membership.added">;
+export declare const membershipRemoved: import("../envelope.js").EventDefinition<"membership.removed">;
+export declare const attachmentFetched: import("../envelope.js").EventDefinition<"attachment.fetched">;
+/** Every event Chips records about a workspace, in the order the reference lists them. */
+export declare const WORKSPACE_EVENTS: readonly [import("../envelope.js").EventDefinition<"conversation.created">, import("../envelope.js").EventDefinition<"membership.added">, import("../envelope.js").EventDefinition<"membership.removed">, import("../envelope.js").EventDefinition<"attachment.fetched">];
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/events/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,eAAO,MAAM,mBAAmB,kEAc9B,CAAC;AAEH,eAAO,MAAM,eAAe,8DAc1B,CAAC;AAEH,eAAO,MAAM,iBAAiB,gEAc5B,CAAC;AAEH,eAAO,MAAM,iBAAiB,gEAW5B,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,2QAKnB,CAAC"}

package/dist/events/workspace.js

@@ -0,0 +1,79 @@
+/**
+ * Events Chips records about itself.
+ *
+ * Agent Connect is the vocabulary an agent speaks. It is not the whole log. Decision 4 says
+ * every Agent Connect event **and every human action** is an event, and creating a conversation
+ * or adding somebody to one is a human action. Without these, `conversations` and `memberships`
+ * would be read models that no replay could reconstruct — which would make `rebuild` a lie.
+ *
+ * These never travel to an agent. An agent learns that it was added to a conversation from
+ * `message.new`, not from here. See ADR 0018 for the line between what is event-sourced and
+ * what is a registry.
+ */
+import { z } from "zod";
+import { defineEvent } from "../envelope.js";
+import { id, isoTimestamp } from "../primitives.js";
+export const conversationCreated = defineEvent({
+    type: "conversation.created",
+    direction: "workspace",
+    summary: "A conversation was opened: a direct message, a group, a channel or a thread.",
+    requiresRun: false,
+    payload: z.object({
+        kind: z
+            .enum(["direct", "group", "channel", "thread"])
+            .describe("Mixed membership is the norm; the kind is about shape, not about who is in it."),
+        title: z.string().max(200).optional().describe("What to call it. Direct messages have none."),
+        parent_conversation_id: id("conversation")
+            .optional()
+            .describe("The conversation this is a thread of."),
+    }),
+});
+export const membershipAdded = defineEvent({
+    type: "membership.added",
+    direction: "workspace",
+    summary: "A person or an agent joined a conversation. Shows as a muted centred line.",
+    requiresRun: false,
+    payload: z.object({
+        participant_id: z.string().min(1).max(120).describe("Who joined."),
+        participant_kind: z.enum(["person", "agent"]).describe("A person or an agent, in one room."),
+        role: z
+            .enum(["owner", "member", "guest"])
+            .default("member")
+            .describe("Their standing here, which is what every `from` field reports."),
+        joined_at: isoTimestamp.optional().describe("Defaults to the event's own timestamp."),
+    }),
+});
+export const membershipRemoved = defineEvent({
+    type: "membership.removed",
+    direction: "workspace",
+    summary: "A person or an agent left a conversation, or was removed from it.",
+    requiresRun: false,
+    payload: z.object({
+        participant_id: z.string().min(1).max(120).describe("Who left."),
+        removed_by: z
+            .string()
+            .min(1)
+            .max(120)
+            .optional()
+            .describe("Who removed them, if not themselves."),
+    }),
+});
+export const attachmentFetched = defineEvent({
+    type: "attachment.fetched",
+    direction: "workspace",
+    summary: "An agent downloaded an attachment. Every fetch is an audit event: “Scout read IMG_2210.jpg”.",
+    requiresRun: false,
+    payload: z.object({
+        attachment_id: id("attachment"),
+        filename: z.string().min(1).max(255).describe("What the file was called when it was sent."),
+        by: z.string().min(1).max(120).describe("The agent that fetched it. Recorded by Chips."),
+    }),
+});
+/** Every event Chips records about a workspace, in the order the reference lists them. */
+export const WORKSPACE_EVENTS = [
+    conversationCreated,
+    membershipAdded,
+    membershipRemoved,
+    attachmentFetched,
+];
+//# sourceMappingURL=workspace.js.map

package/dist/events/workspace.js.map

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