@chipschat/protocol 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1,18 +0,0 @@
-/**
- * `@chips/protocol` is Agent Connect. The Zod schemas here are canonical (decision 7): the
- * JSON Schema in `generated/`, the TypeScript types, the documentation reference and the
- * fixtures every layer's tests read are all produced from them by `pnpm gen:protocol`.
- *
- * It depends on `zod` and nothing else, so an SDK built on it stays light.
- */
-export type * from "../generated/types.js";
-export type { Direction, Envelope, EventDefinition } from "./envelope.js";
-export { defineEvent, envelope, eventSchema, PROTOCOL_VERSION } from "./envelope.js";
-export * from "./events/index.js";
-export type { ClientFrame, ErrorCode, ServerFrame } from "./frames.js";
-export { ackFrame, clientFrame, clientHelloFrame, errorCode, errorFrame, eventFrame, FRAME_NAMES, negotiateProtocol, pingFrame, pongFrame, receiptFrame, serverFrame, subscribeFrame, } from "./frames.js";
-export type { Id, IdGenerator, IdGeneratorOptions, IdKind, IdPrefix } from "./ids/index.js";
-export { createIdGenerator, defaultIdGenerator, eventIdOfMessage, ID_PREFIXES, InvalidIdError, isId, messageIdOf, newId, parseId, timestampOf, } from "./ids/index.js";
-export type { Action, Actor, Attachment, AutonomyLevel, Budget, Cost, ParticipantRef, Policy, PolicyRule, Preview, RiskClass, SignedAttachment, Source, TrailEntry, } from "./primitives.js";
-export { action, actor, approverRef, attachment, autonomyLevel, budget, cost, id, isoTimestamp, participantRef, policy, policyRule, preview, riskClass, signedAttachment, source, trailEntry, } from "./primitives.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mBAAmB,uBAAuB,CAAC;AAC3C,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrF,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,IAAI,EACJ,WAAW,EACX,KAAK,EACL,OAAO,EACP,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,MAAM,EACN,KAAK,EACL,UAAU,EACV,aAAa,EACb,MAAM,EACN,IAAI,EACJ,cAAc,EACd,MAAM,EACN,UAAU,EACV,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,MAAM,EACN,KAAK,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,MAAM,EACN,IAAI,EACJ,EAAE,EACF,YAAY,EACZ,cAAc,EACd,MAAM,EACN,UAAU,EACV,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,13 +0,0 @@
-/**
- * `@chips/protocol` is Agent Connect. The Zod schemas here are canonical (decision 7): the
- * JSON Schema in `generated/`, the TypeScript types, the documentation reference and the
- * fixtures every layer's tests read are all produced from them by `pnpm gen:protocol`.
- *
- * It depends on `zod` and nothing else, so an SDK built on it stays light.
- */
-export { defineEvent, envelope, eventSchema, PROTOCOL_VERSION } from "./envelope.js";
-export * from "./events/index.js";
-export { ackFrame, clientFrame, clientHelloFrame, errorCode, errorFrame, eventFrame, FRAME_NAMES, negotiateProtocol, pingFrame, pongFrame, receiptFrame, serverFrame, subscribeFrame, } from "./frames.js";
-export { createIdGenerator, defaultIdGenerator, eventIdOfMessage, ID_PREFIXES, InvalidIdError, isId, messageIdOf, newId, parseId, timestampOf, } from "./ids/index.js";
-export { action, actor, approverRef, attachment, autonomyLevel, budget, cost, id, isoTimestamp, participantRef, policy, policyRule, preview, riskClass, signedAttachment, source, trailEntry, } from "./primitives.js";
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrF,cAAc,mBAAmB,CAAC;AAElC,OAAO,EACL,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,IAAI,EACJ,WAAW,EACX,KAAK,EACL,OAAO,EACP,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAiBxB,OAAO,EACL,MAAM,EACN,KAAK,EACL,WAAW,EACX,UAAU,EACV,aAAa,EACb,MAAM,EACN,IAAI,EACJ,EAAE,EACF,YAAY,EACZ,cAAc,EACd,MAAM,EACN,UAAU,EACV,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,UAAU,GACX,MAAM,iBAAiB,CAAC"}

package/dist/primitives.d.ts

@@ -1,194 +0,0 @@
-/**
- * The sub-schemas events are built from. Each one exists because more than one event needs
- * it, and each carries a description, because those descriptions become the documentation
- * reference (technical-plan decision 13).
- */
-import { z } from "zod";
-import { type IdKind } from "./ids/index.js";
-/** A schema for one kind of prefixed ULID, for example `run_01K4...` (decision 11). */
-export declare function id<K extends IdKind>(kind: K): z.ZodString;
-export declare const isoTimestamp: z.ZodISODateTime;
-/** Who caused an event. Every envelope says so; the audit log is a read of this field. */
-export declare const actor: z.ZodObject<{
-    kind: z.ZodEnum<{
-        person: "person";
-        agent: "agent";
-        system: "system";
-    }>;
-    id: z.ZodString;
-}, z.core.$strip>;
-export type Actor = z.infer<typeof actor>;
-/** A person or agent as another party sees them, with the role Chips assigns. */
-export declare const participantRef: z.ZodObject<{
-    participant_id: z.ZodString;
-    kind: z.ZodEnum<{
-        person: "person";
-        agent: "agent";
-    }>;
-    display_name: z.ZodString;
-    role: z.ZodEnum<{
-        owner: "owner";
-        member: "member";
-        guest: "guest";
-    }>;
-}, z.core.$strip>;
-export type ParticipantRef = z.infer<typeof participantRef>;
-/**
- * An attachment. Anything you can send a person you can send an agent, so this shape carries
- * files, images, video and voice notes alike (decision 10).
- */
-export declare const attachment: z.ZodObject<{
-    attachment_id: z.ZodString;
-    filename: z.ZodString;
-    mime_type: z.ZodString;
-    byte_size: z.ZodInt;
-    sha256: z.ZodString;
-    width: z.ZodOptional<z.ZodInt>;
-    height: z.ZodOptional<z.ZodInt>;
-    duration_ms: z.ZodOptional<z.ZodInt>;
-}, z.core.$strip>;
-export type Attachment = z.infer<typeof attachment>;
-/** An attachment as it reaches an agent: with a URL it can actually fetch. */
-export declare const signedAttachment: z.ZodObject<{
-    attachment_id: z.ZodString;
-    filename: z.ZodString;
-    mime_type: z.ZodString;
-    byte_size: z.ZodInt;
-    sha256: z.ZodString;
-    width: z.ZodOptional<z.ZodInt>;
-    height: z.ZodOptional<z.ZodInt>;
-    duration_ms: z.ZodOptional<z.ZodInt>;
-    url: z.ZodURL;
-    url_expires_at: z.ZodISODateTime;
-}, z.core.$strip>;
-export type SignedAttachment = z.infer<typeof signedAttachment>;
-/** Where a claim came from. External sources are what make an action risky. */
-export declare const source: z.ZodObject<{
-    kind: z.ZodEnum<{
-        external: "external";
-        internal: "internal";
-    }>;
-    label: z.ZodString;
-    url: z.ZodOptional<z.ZodURL>;
-}, z.core.$strip>;
-export type Source = z.infer<typeof source>;
-/**
- * Risk classes. These are the flags the policy engine matches on (decision 8), so the list is
- * closed: a new class is a protocol change, not a free-text string an agent invents.
- */
-export declare const riskClass: z.ZodEnum<{
-    external: "external";
-    external_communication: "external_communication";
-    irreversible: "irreversible";
-    destructive: "destructive";
-    financial: "financial";
-    credential: "credential";
-    privacy: "privacy";
-    legal: "legal";
-}>;
-export type RiskClass = z.infer<typeof riskClass>;
-/** The action an agent wants to take. `kind` is what policy rules glob against. */
-export declare const action: z.ZodObject<{
-    kind: z.ZodString;
-    input: z.ZodOptional<z.ZodUnknown>;
-    external: z.ZodOptional<z.ZodBoolean>;
-    irreversible: z.ZodOptional<z.ZodBoolean>;
-    money_usd: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type Action = z.infer<typeof action>;
-/** What a person is shown before they decide. A diff for a change, prose for a message. */
-export declare const preview: z.ZodObject<{
-    format: z.ZodEnum<{
-        markdown: "markdown";
-        plain: "plain";
-        diff: "diff";
-        json: "json";
-        table: "table";
-    }>;
-    body: z.ZodString;
-    title: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type Preview = z.infer<typeof preview>;
-/**
- * Who may answer an approval. `owner` and `role:<name>` are resolved by Chips, so a harness
- * never needs to know who is on shift.
- */
-export declare const approverRef: z.ZodString;
-/** Autonomy levels L0 to L3 (blueprint: trust is a dial, not a switch). */
-export declare const autonomyLevel: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
-export type AutonomyLevel = z.infer<typeof autonomyLevel>;
-/** One policy rule. Rules read like sentences: `email.send to an external domain -> ask the owner`. */
-export declare const policyRule: z.ZodObject<{
-    match: z.ZodString;
-    when: z.ZodOptional<z.ZodObject<{
-        external: z.ZodOptional<z.ZodBoolean>;
-        irreversible: z.ZodOptional<z.ZodBoolean>;
-        money_usd_over: z.ZodOptional<z.ZodNumber>;
-        risk: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            external: "external";
-            external_communication: "external_communication";
-            irreversible: "irreversible";
-            destructive: "destructive";
-            financial: "financial";
-            credential: "credential";
-            privacy: "privacy";
-            legal: "legal";
-        }>>>;
-    }, z.core.$strip>>;
-    decision: z.ZodEnum<{
-        allow: "allow";
-        ask: "ask";
-        deny: "deny";
-    }>;
-    approvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    reason: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type PolicyRule = z.infer<typeof policyRule>;
-export declare const policy: z.ZodObject<{
-    autonomy: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
-    rules: z.ZodArray<z.ZodObject<{
-        match: z.ZodString;
-        when: z.ZodOptional<z.ZodObject<{
-            external: z.ZodOptional<z.ZodBoolean>;
-            irreversible: z.ZodOptional<z.ZodBoolean>;
-            money_usd_over: z.ZodOptional<z.ZodNumber>;
-            risk: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                external: "external";
-                external_communication: "external_communication";
-                irreversible: "irreversible";
-                destructive: "destructive";
-                financial: "financial";
-                credential: "credential";
-                privacy: "privacy";
-                legal: "legal";
-            }>>>;
-        }, z.core.$strip>>;
-        decision: z.ZodEnum<{
-            allow: "allow";
-            ask: "ask";
-            deny: "deny";
-        }>;
-        approvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        reason: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type Policy = z.infer<typeof policy>;
-/** Money is always an estimate and always labelled as one (blueprint: cost rolls up the trail). */
-export declare const cost: z.ZodObject<{
-    usd: z.ZodNumber;
-    estimated: z.ZodLiteral<true>;
-}, z.core.$strip>;
-export type Cost = z.infer<typeof cost>;
-export declare const budget: z.ZodObject<{
-    limit_usd: z.ZodNumber;
-    spent_usd: z.ZodNumber;
-}, z.core.$strip>;
-export type Budget = z.infer<typeof budget>;
-/** How work travelled to get here, so a lane can be traced back to the message that caused it. */
-export declare const trailEntry: z.ZodObject<{
-    participant_id: z.ZodString;
-    run_id: z.ZodOptional<z.ZodString>;
-    goal: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type TrailEntry = z.infer<typeof trailEntry>;
-//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI1D,uFAAuF;AACvF,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,eAK3C;AAED,eAAO,MAAM,YAAY,kBAEoD,CAAC;AAE9E,0FAA0F;AAC1F,eAAO,MAAM,KAAK;;;;;;;iBAOuC,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,iFAAiF;AACjF,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAW8B,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;iBAkBoB,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAKoC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,+EAA+E;AAC/E,eAAO,MAAM,MAAM;;;;;;;iBAU+D,CAAC;AACnF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;EAWiD,CAAC;AACxE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,MAAM;;;;;;iBAcgC,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,2FAA2F;AAC3F,eAAO,MAAM,OAAO;;;;;;;;;;iBAQkC,CAAC;AACvD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,WAAW,aAG8C,CAAC;AAEvE,2EAA2E;AAC3E,eAAO,MAAM,aAAa,2FAIvB,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,uGAAuG;AACvG,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;iBA4B2B,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ6D,CAAC;AACjF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,mGAAmG;AACnG,eAAO,MAAM,IAAI;;;iBAKgB,CAAC;AAClC,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,eAAO,MAAM,MAAM;;;iBAK0D,CAAC;AAC9E,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,kGAAkG;AAClG,eAAO,MAAM,UAAU;;;;iBAMmC,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/primitives.js

@@ -1,193 +0,0 @@
-/**
- * The sub-schemas events are built from. Each one exists because more than one event needs
- * it, and each carries a description, because those descriptions become the documentation
- * reference (technical-plan decision 13).
- */
-import { z } from "zod";
-import { ID_PREFIXES } from "./ids/index.js";
-const ULID = "[0-7][0-9A-HJKMNP-TV-Z]{25}";
-/** A schema for one kind of prefixed ULID, for example `run_01K4...` (decision 11). */
-export function id(kind) {
-    return z
-        .string()
-        .regex(new RegExp(`^${ID_PREFIXES[kind]}_${ULID}$`), `expected a ${kind} id`)
-        .describe(`A ${kind} identifier: \`${ID_PREFIXES[kind]}_\` followed by a ULID.`);
-}
-export const isoTimestamp = z.iso
-    .datetime({ offset: true })
-    .describe("An ISO 8601 timestamp, for example `2026-09-02T14:22:31.004Z`.");
-/** Who caused an event. Every envelope says so; the audit log is a read of this field. */
-export const actor = z
-    .object({
-    kind: z
-        .enum(["person", "agent", "system"])
-        .describe("Whether a person, an agent or Chips itself acted."),
-    id: z.string().min(1).describe("The participant id, or `system` for Chips."),
-})
-    .describe("The participant an event is attributed to.");
-/** A person or agent as another party sees them, with the role Chips assigns. */
-export const participantRef = z
-    .object({
-    participant_id: z.string().min(1).describe("The stable id of the sender."),
-    kind: z.enum(["person", "agent"]).describe("Whether the sender is a person or an agent."),
-    display_name: z.string().min(1).max(120).describe("The name to show."),
-    role: z
-        .enum(["owner", "member", "guest"])
-        .describe("The sender's standing in this conversation. Multi-user is Chips' job, not the harness's."),
-})
-    .describe("A sender, as the receiving side sees them.");
-/**
- * An attachment. Anything you can send a person you can send an agent, so this shape carries
- * files, images, video and voice notes alike (decision 10).
- */
-export const attachment = z
-    .object({
-    attachment_id: id("attachment"),
-    filename: z.string().min(1).max(255).describe("The name to show. Never trusted for its type."),
-    mime_type: z
-        .string()
-        .min(1)
-        .max(255)
-        .describe("Sniffed from the bytes on upload, not taken from the client."),
-    byte_size: z.int().nonnegative().describe("Size in bytes."),
-    sha256: z
-        .string()
-        .regex(/^[a-f0-9]{64}$/)
-        .describe("Lowercase hex digest. The store is content-addressed."),
-    width: z.int().positive().optional().describe("Pixels, for images and video."),
-    height: z.int().positive().optional().describe("Pixels, for images and video."),
-    duration_ms: z.int().nonnegative().optional().describe("Milliseconds, for audio and video."),
-})
-    .describe("A file carried by a message.");
-/** An attachment as it reaches an agent: with a URL it can actually fetch. */
-export const signedAttachment = attachment
-    .extend({
-    url: z.url().describe("A signed URL, bound to the requesting token."),
-    url_expires_at: isoTimestamp.describe("Ten minutes from issue, by default (decision 10)."),
-})
-    .describe("An attachment with a short-lived, token-bound URL.");
-/** Where a claim came from. External sources are what make an action risky. */
-export const source = z
-    .object({
-    kind: z.enum(["external", "internal"]).describe("Whether the source is outside the workspace."),
-    label: z
-        .string()
-        .min(1)
-        .max(200)
-        .describe("What to show in the receipt, for example `vendor website`."),
-    url: z.url().optional().describe("Where to look, when there is somewhere to look."),
-})
-    .describe("A source an agent used, shown in the receipt and on approval cards.");
-/**
- * Risk classes. These are the flags the policy engine matches on (decision 8), so the list is
- * closed: a new class is a protocol change, not a free-text string an agent invents.
- */
-export const riskClass = z
-    .enum([
-    "external",
-    "external_communication",
-    "irreversible",
-    "destructive",
-    "financial",
-    "credential",
-    "privacy",
-    "legal",
-])
-    .describe("A risk class the policy engine can match a rule against.");
-/** The action an agent wants to take. `kind` is what policy rules glob against. */
-export const action = z
-    .object({
-    kind: z
-        .string()
-        .regex(/^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$/)
-        .max(120)
-        .describe("A dotted verb, for example `email.send` or `payment.transfer`. Policy rules glob on it."),
-    input: z.unknown().optional().describe("The arguments, shaped by the tool being called."),
-    external: z.boolean().optional().describe("True when the action leaves the workspace."),
-    irreversible: z.boolean().optional().describe("True when the action cannot be undone."),
-    money_usd: z.number().nonnegative().optional().describe("Amount at stake, in US dollars."),
-})
-    .describe("An action an agent proposes to take.");
-/** What a person is shown before they decide. A diff for a change, prose for a message. */
-export const preview = z
-    .object({
-    format: z
-        .enum(["markdown", "plain", "diff", "json", "table"])
-        .describe("How to render the body."),
-    body: z.string().max(200_000).describe("The rendered preview."),
-    title: z.string().max(200).optional().describe("A heading for the card."),
-})
-    .describe("What the approver sees before deciding.");
-/**
- * Who may answer an approval. `owner` and `role:<name>` are resolved by Chips, so a harness
- * never needs to know who is on shift.
- */
-export const approverRef = z
-    .string()
-    .regex(/^(owner|any|role:[a-z][a-z0-9_]*|usr_[0-9A-HJKMNP-TV-Z]{26})$/)
-    .describe("`owner`, `any`, `role:<name>`, or a specific person id.");
-/** Autonomy levels L0 to L3 (blueprint: trust is a dial, not a switch). */
-export const autonomyLevel = z
-    .union([z.literal(0), z.literal(1), z.literal(2), z.literal(3)])
-    .describe("0 observe, 1 ask first, 2 ask when it matters, 3 autonomous and report back. Presets that expand to rules.");
-/** One policy rule. Rules read like sentences: `email.send to an external domain -> ask the owner`. */
-export const policyRule = z
-    .object({
-    match: z
-        .string()
-        .min(1)
-        .max(120)
-        .describe("A glob over action kinds, for example `payment.*`."),
-    when: z
-        .object({
-        external: z.boolean().optional(),
-        irreversible: z.boolean().optional(),
-        money_usd_over: z.number().nonnegative().optional(),
-        risk: z.array(riskClass).max(8).optional(),
-    })
-        .optional()
-        .describe("Extra conditions on the action's flags."),
-    decision: z.enum(["allow", "ask", "deny"]).describe("What to do when the rule matches."),
-    approvers: z
-        .array(approverRef)
-        .max(16)
-        .optional()
-        .describe("Who may answer, when the decision is `ask`."),
-    reason: z
-        .string()
-        .max(400)
-        .optional()
-        .describe("Shown to the agent, and recorded in the audit log."),
-})
-    .describe("A rule the policy engine evaluates.");
-export const policy = z
-    .object({
-    autonomy: autonomyLevel,
-    rules: z
-        .array(policyRule)
-        .max(200)
-        .describe("Evaluated in order; the workspace cap always wins."),
-})
-    .describe("An agent's autonomy level and the rules that fill in the details.");
-/** Money is always an estimate and always labelled as one (blueprint: cost rolls up the trail). */
-export const cost = z
-    .object({
-    usd: z.number().nonnegative().describe("An estimate, in US dollars."),
-    estimated: z.literal(true).describe("Always true. Cost is never presented as exact."),
-})
-    .describe("An estimated cost.");
-export const budget = z
-    .object({
-    limit_usd: z.number().nonnegative().describe("The ceiling for this agent."),
-    spent_usd: z.number().nonnegative().describe("Spent so far, estimated."),
-})
-    .describe("An agent's budget. Warns at 80 percent, pauses the run at 100.");
-/** How work travelled to get here, so a lane can be traced back to the message that caused it. */
-export const trailEntry = z
-    .object({
-    participant_id: z.string().min(1).describe("Who handled this hop."),
-    run_id: id("run").optional().describe("The run this hop belongs to."),
-    goal: z.string().max(2000).optional().describe("What was asked at this hop."),
-})
-    .describe("One hop in the chain that led to this work.");
-//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

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