@chipschat/protocol 0.0.0-stage → 1.0.1

package/dist/src/harness-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-jobs.d.ts","sourceRoot":"","sources":["../../src/harness-jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,gDAAgD;AAChD,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,gDAAgD;AAChD,eAAO,MAAM,aAAa,SAAU,CAAC;AACrC,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,mDAAmD;AACnD,eAAO,MAAM,SAAS,qDAAsD,CAAC;AAC7E,eAAO,MAAM,OAAO;;;;;EAAoB,CAAC;AACzC,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,uBAAuB;AACvB,eAAO,MAAM,gBAAgB,wCAAyC,CAAC;AACvE,eAAO,MAAM,aAAa;;;;EAA2B,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,KAAK,aAKf,CAAC;AA8CJ,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;iBAanB,CAAC;AACL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAKpD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBkE,CAAC;AAC9F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAE1E,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;iBAkC4B,CAAC;AAChD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;iBAIrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;;;iBAK2D,CAAC;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB,mDAAoD,CAAC;AACnF,eAAO,MAAM,cAAc;;;;;EAA4B,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,aAAa;;;;;;;;;;;;;iBAY+D,CAAC;AAC1F,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAaqE,CAAC;AACjG,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOqD,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;iBAOoD,CAAC;AAC7E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc;;;;;;;;;iBAexB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/src/harness-jobs.js

@@ -0,0 +1,210 @@
+/**
+ * A harness's own jobs (ADR 0252): what it runs by itself, outside any space, on a schedule of its
+ * own. OpenClaw's are its Main agent's Heartbeat, Dreaming and a Skill review for each agent.
+ *
+ * Nothing about a job is Chips'. A harness that declares `jobs` sends a copy of all of them
+ * (`PUT /v1/harnesses/:id/jobs`), whole, and posts each run it finishes (`POST …/jobs/runs`),
+ * which Chips keeps for `JOB_RUNS_KEPT_DAYS`. A person's change goes down the harness's socket as
+ * a `job.change` frame, and is done when the harness sends its copy again, answering it.
+ */
+import { z } from "zod";
+import { id, isoTimestamp } from "./primitives.js";
+/** The most jobs a harness's copy lists. */
+export const HARNESS_JOBS_MAX = 24;
+/** The most intervals a job offers a person. */
+export const JOB_CHOICES_MAX = 12;
+/** The longest interval, in minutes: a year. */
+export const JOB_EVERY_MAX = 525_600;
+/** The most runs one post carries. */
+export const JOB_RUNS_POST_MAX = 200;
+/** The most runs one read gives. */
+export const JOB_RUNS_READ_MAX = 500;
+/** How long Chips keeps a run, in days: a harness that keeps a week can still be read for two. */
+export const JOB_RUNS_KEPT_DAYS = 90;
+/**
+ * How long a change waits for its harness's answer, as a heartbeat's does (ADR 0143). After it the
+ * change reads as missed; an answer after it still counts, and a new change may be asked.
+ */
+export const JOB_CHANGE_WAIT_MS = 60_000;
+/** What a job does, for the mark its row wears. */
+export const JOB_KINDS = ["heartbeat", "memory", "skills", "other"];
+export const jobKind = z.enum(JOB_KINDS);
+/** How a run ended. */
+export const JOB_RUN_OUTCOMES = ["done", "failed", "stopped"];
+export const jobRunOutcome = z.enum(JOB_RUN_OUTCOMES);
+export const jobId = z
+    .string()
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$/, "expected a job id")
+    .describe("The harness's own id for a job: stable, up to 80 letters, digits, `.`, `_`, `:` or `-`.");
+const minutes = z.int().min(1).max(JOB_EVERY_MAX);
+const ascending = (choices) => choices.every((each, at) => at === 0 || each > (choices[at - 1] ?? 0));
+const jobFields = {
+    job_id: jobId,
+    name: z.string().min(1).max(40).describe('What the harness calls it: "Dreaming".'),
+    about: z.string().min(1).max(240).describe("What it does, in a sentence, for its page."),
+    kind: jobKind.describe("What it does, for its mark: `other` for anything else."),
+    every: minutes
+        .optional()
+        .describe("How often it runs, in minutes. Chips says it in words, with `next_at` for the time of day."),
+    when: z
+        .string()
+        .min(1)
+        .max(60)
+        .optional()
+        .describe("How often, in the harness's words, for a schedule that is not an interval."),
+    next_at: isoTimestamp.optional().describe("When it runs next, while it is on."),
+    for_agents: z
+        .array(id("agent"))
+        .max(200)
+        .optional()
+        .describe("The harness's agents it runs for, if it runs for some rather than the harness."),
+    on: z.boolean().describe("Whether it runs now."),
+    editable: z.boolean().describe("Whether a person may switch it from Chips."),
+    why_read_only: z
+        .string()
+        .min(1)
+        .max(120)
+        .optional()
+        .describe("Why not, in the harness's words, only when it is not `editable`."),
+    choices: z
+        .array(minutes)
+        .min(1)
+        .max(JOB_CHOICES_MAX)
+        .refine(ascending, { message: "The intervals go up, each named once." })
+        .optional()
+        .describe("The intervals a person may pick, in minutes, shortest first, `every` among them."),
+};
+export const harnessJob = z
+    .object(jobFields)
+    .refine((job) => job.every !== undefined || job.when !== undefined, {
+    path: ["every"],
+    message: "Say how often it runs: `every` in minutes, or `when` in words.",
+})
+    .refine((job) => job.choices === undefined || job.choices.includes(job.every ?? -1), {
+    path: ["choices"],
+    message: "`every` is one of `choices`.",
+})
+    .refine((job) => job.why_read_only === undefined || !job.editable, {
+    path: ["why_read_only"],
+    message: "Say why only for a job that can't be switched.",
+});
+const uniqueJobs = (jobs) => new Set(jobs.map((job) => job.job_id)).size === jobs.length;
+export const harnessJobsPut = z
+    .object({
+    jobs: z
+        .array(harnessJob)
+        .max(HARNESS_JOBS_MAX)
+        .refine(uniqueJobs, { message: "Each job is named once." })
+        .describe("Every job the harness runs on its own, whole: one left out is gone, runs and all."),
+    answers: id("change")
+        .optional()
+        .describe("The change this copy answers: made, and these are the jobs as they are now."),
+    refuses: z
+        .object({
+        change_id: id("change"),
+        message: z.string().min(1).max(300).optional().describe("Why not, for the person."),
+    })
+        .optional()
+        .describe("A change not made. The copy beside it is the jobs as they are now."),
+})
+    .describe("`PUT /v1/harnesses/:id/jobs`: a harness's copy of the jobs it runs on its own.");
+export const jobRun = z
+    .object({
+    job_id: jobId,
+    run_id: z.string().min(1).max(160).describe("The harness's own id for the run."),
+    started_at: isoTimestamp,
+    ended_at: isoTimestamp,
+    outcome: jobRunOutcome.describe("`done`, `failed`, or `stopped` when something else ended it, such as a restart."),
+    quiet: z
+        .boolean()
+        .optional()
+        .describe("It did its work and had nothing to say: a heartbeat with nothing for anyone."),
+    waited: z.boolean().optional().describe("It waited for an approval that nobody gave."),
+    error: z
+        .string()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe("What went wrong, in the harness's words, for a run that failed or was stopped."),
+    agent_id: id("agent").optional().describe("The agent it ran for, when it runs for some."),
+    cost_usd: z
+        .number()
+        .min(0)
+        .max(10_000)
+        .optional()
+        .describe("What it cost, as the harness priced it: absent when the harness doesn't know."),
+    tokens: z.int().min(0).optional().describe("Its tokens, in and out."),
+    model: z.string().min(1).max(80).optional().describe("The model it ran on, in its words."),
+})
+    .refine((run) => Date.parse(run.ended_at) >= Date.parse(run.started_at), {
+    path: ["ended_at"],
+    message: "A run ends after it starts.",
+})
+    .describe("One run of a job, once it ended.");
+export const jobRunsPost = z
+    .object({ runs: z.array(jobRun).min(1).max(JOB_RUNS_POST_MAX) })
+    .describe("`POST /v1/harnesses/:id/jobs/runs`: runs the harness finished. A run posted again says what it says over what was posted before, and what it leaves out stays: so a run may be posted once more with its cost, and never loses one.");
+export const jobChangeAsk = z
+    .object({
+    on: z.boolean(),
+    every: minutes.optional().describe("One of the job's choices; its own when left out."),
+})
+    .describe("`POST /v1/harnesses/:id/jobs/:job/changes`: on or off, and how often.");
+export const JOB_CHANGE_STATES = ["waiting", "saved", "failed", "missed"];
+export const jobChangeState = z.enum(JOB_CHANGE_STATES);
+export const jobChangeView = z
+    .object({
+    change_id: id("change"),
+    state: jobChangeState.describe("`missed` once `JOB_CHANGE_WAIT_MS` has passed with no answer; read, never stored."),
+    on: z.boolean(),
+    every: minutes.optional(),
+    asked_at: isoTimestamp,
+    answered_at: isoTimestamp.optional(),
+    message: z.string().max(300).optional().describe("The harness's words, for a refusal."),
+})
+    .describe("The last change a person asked of a job, and what became of it (ADR 0252).");
+export const harnessJobView = z
+    .object({
+    ...jobFields,
+    week_usd: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("What its runs of the last seven days cost: absent when none of them had a cost."),
+    week_runs: z.int().min(0).describe("How many runs it made in the last seven days."),
+    runs_total: z.int().min(0).describe("How many of its runs Chips holds."),
+    last_run: jobRun.optional(),
+    change: jobChangeView.optional(),
+})
+    .describe("One job as a person reads it: the harness's copy, what Chips counted, its change.");
+export const harnessJobsView = z
+    .object({
+    harness_id: id("harness"),
+    jobs: z.array(harnessJobView),
+    read_at: isoTimestamp.describe("When the harness last sent its copy."),
+    away: z.boolean().describe("No socket of the harness hears changes now: read, not switched."),
+})
+    .describe("`GET /v1/harnesses/:id/jobs`, for the harness's owner or an admin.");
+export const jobRunsView = z
+    .object({
+    harness_id: id("harness"),
+    job_id: jobId,
+    runs: z.array(jobRun).describe("Newest first."),
+    more: z.boolean().describe("Whether older runs are left, for `before` the last one's start."),
+})
+    .describe("`GET /v1/harnesses/:id/jobs/:job/runs?since=&before=&limit=`.");
+export const jobChangeFrame = z
+    .object({
+    frame: z.literal("job.change"),
+    change_id: id("change"),
+    harness_id: id("harness"),
+    job_id: jobId,
+    on: z.boolean(),
+    every: minutes
+        .optional()
+        .describe("For a job with choices: one of them, the copy's own when the person named none."),
+    asked_by: id("person"),
+    asked_at: isoTimestamp,
+})
+    .describe("A person switched one of a harness's own jobs, or changed how often it runs (ADR 0252). Sent to a harness's socket that said `jobs` in its `hello`, now or never: it is not in the log. The harness answers with its copy of all its jobs, `answers` or `refuses` naming `change_id`.");
+//# sourceMappingURL=harness-jobs.js.map

package/dist/src/harness-jobs.js.map

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

package/dist/src/ids/index.d.ts

@@ -0,0 +1,3 @@
+export type { Id, IdGenerator, IdGeneratorOptions, IdKind, IdPrefix } from "./ulid.js";
+export { createIdGenerator, defaultIdGenerator, eventIdOfMessage, ID_PREFIXES, InvalidIdError, isId, messageIdOf, newId, parseId, timestampOf, } from "./ulid.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/ids/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ids/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,IAAI,EACJ,WAAW,EACX,KAAK,EACL,OAAO,EACP,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/src/ids/index.js

@@ -0,0 +1,2 @@
+export { createIdGenerator, defaultIdGenerator, eventIdOfMessage, ID_PREFIXES, InvalidIdError, isId, messageIdOf, newId, parseId, timestampOf, } from "./ulid.js";
+//# sourceMappingURL=index.js.map

package/dist/src/ids/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ids/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,IAAI,EACJ,WAAW,EACX,KAAK,EACL,OAAO,EACP,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/src/ids/ulid.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Identifiers are ULIDs with a type prefix (technical-plan decision 11). Always strings,
+ * always sortable by creation time, and self-describing: `run_01JB...` can only ever be a
+ * run. Generation goes through a port so tests are deterministic (6.1).
+ *
+ * This lives in `packages/protocol` rather than `packages/platform` because an id is part of
+ * the wire format: every envelope carries three of them. Keeping it here means `@chipschat/harness`
+ * can validate ids without pulling a logger and a metrics API into an SDK.
+ *
+ * The encoding is the ULID spec: 48 bits of millisecond timestamp in ten Crockford base32
+ * characters, then 80 bits of randomness in sixteen. Ids minted in the same millisecond are
+ * made strictly increasing by incrementing the random component, so `seq` is not the only
+ * thing that orders a workspace's history.
+ */
+/**
+ * The prefix for each kind of thing Chips names.
+ *
+ * The first eleven are decision 11's list. The rest extend it: an event needs an id of its own
+ * to be idempotent across a reconnect, and devices and harness tokens are rows in the schema
+ * M0.3 creates (recorded in STATUS.md); an agent is who a harness takes part in rooms as (ADR
+ * 0087), a join request is somebody asking to come in (ADR 0122), and an edit is a person's change
+ * to an agent's context on its way to its harness (ADR 0134), and a change is a person's choice of
+ * an agent's model and effort, of its heartbeat, or of its context window's limit, or a Compact
+ * now, on its way there too (ADR 0140, ADR 0143, ADR 0146). A direct ask is a guest asking an
+ * owner to share the server's machine in Tailscale (ADR 0211, Phase 3).
+ * `agt` was the harness's prefix before the rename of 4 September, and no log holds one.
+ */
+export declare const ID_PREFIXES: {
+    readonly workspace: "ws";
+    readonly person: "usr";
+    readonly harness: "hrn";
+    readonly space: "spc";
+    readonly message: "msg";
+    readonly run: "run";
+    readonly step: "stp";
+    readonly approval: "apr";
+    readonly question: "qst";
+    readonly lane: "lane";
+    readonly attachment: "att";
+    readonly event: "evt";
+    readonly device: "dev";
+    readonly token: "tok";
+    readonly invite: "inv";
+    readonly passkey: "pky";
+    readonly agent: "agt";
+    readonly join: "jrq";
+    readonly direct: "dra";
+    readonly edit: "edt";
+    readonly change: "chg";
+};
+export type IdKind = keyof typeof ID_PREFIXES;
+export type IdPrefix = (typeof ID_PREFIXES)[IdKind];
+export type Id<K extends IdKind = IdKind> = `${(typeof ID_PREFIXES)[K]}_${string}`;
+/** Thrown when a string that should be an id is not one. */
+export declare class InvalidIdError extends Error {
+    readonly value: string;
+    readonly name = "InvalidIdError";
+    constructor(value: string, reason: string);
+}
+export interface IdGenerator {
+    /** Mint a new id of the given kind. */
+    next: <K extends IdKind>(kind: K) => Id<K>;
+}
+export interface IdGeneratorOptions {
+    /** Milliseconds since the epoch. Defaults to the system clock. */
+    now?: () => number;
+    /** Fills the supplied buffer with randomness. Defaults to `crypto.getRandomValues`. */
+    randomFill?: (into: Uint8Array) => void;
+}
+/**
+ * A generator that is monotonic within a millisecond. Two generators are independent; a
+ * process that needs strictly ordered ids uses one.
+ */
+export declare function createIdGenerator(options?: IdGeneratorOptions): IdGenerator;
+/** The process-wide generator. Code that can inject a generator should do that instead. */
+export declare const defaultIdGenerator: IdGenerator;
+/** Mint an id with the process-wide generator. */
+export declare function newId<K extends IdKind>(kind: K): Id<K>;
+/** True when `value` is an id of the given kind. */
+export declare function isId<K extends IdKind>(kind: K, value: unknown): value is Id<K>;
+/** Split an id into its kind and ULID, or throw if it is not an id. */
+export declare function parseId(value: string): {
+    kind: IdKind;
+    ulid: string;
+};
+/** The instant an id was minted. */
+export declare function timestampOf(value: string): number;
+/**
+ * The id a message has on the wire. A message is its event: the row and the reference both
+ * carry the event's ULID, and `message.new` names it with the message prefix so a `reply_to`
+ * is a message id and not an event id. Pure, and the same in both directions.
+ */
+export declare function messageIdOf(eventId: string): Id<"message">;
+/** The event an on-the-wire message id names. */
+export declare function eventIdOfMessage(messageId: string): Id<"event">;
+//# sourceMappingURL=ulid.d.ts.map

package/dist/src/ids/ulid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.d.ts","sourceRoot":"","sources":["../../../src/ids/ulid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;CAsBd,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,WAAW,CAAC;AAC9C,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACpD,MAAM,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;AAanF,4DAA4D;AAC5D,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAFxB,SAAkB,IAAI,oBAAoB;gBAE/B,KAAK,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM;CAIjB;AAED,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAc/E;AAkCD,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,EAAE,WAAiC,CAAC;AAEnE,kDAAkD;AAClD,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAEtD;AAED,oDAAoD;AACpD,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAI9E;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMrE;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAwED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,CAE1D;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,CAE/D"}

package/dist/src/ids/ulid.js

@@ -0,0 +1,212 @@
+/**
+ * Identifiers are ULIDs with a type prefix (technical-plan decision 11). Always strings,
+ * always sortable by creation time, and self-describing: `run_01JB...` can only ever be a
+ * run. Generation goes through a port so tests are deterministic (6.1).
+ *
+ * This lives in `packages/protocol` rather than `packages/platform` because an id is part of
+ * the wire format: every envelope carries three of them. Keeping it here means `@chipschat/harness`
+ * can validate ids without pulling a logger and a metrics API into an SDK.
+ *
+ * The encoding is the ULID spec: 48 bits of millisecond timestamp in ten Crockford base32
+ * characters, then 80 bits of randomness in sixteen. Ids minted in the same millisecond are
+ * made strictly increasing by incrementing the random component, so `seq` is not the only
+ * thing that orders a workspace's history.
+ */
+/**
+ * The prefix for each kind of thing Chips names.
+ *
+ * The first eleven are decision 11's list. The rest extend it: an event needs an id of its own
+ * to be idempotent across a reconnect, and devices and harness tokens are rows in the schema
+ * M0.3 creates (recorded in STATUS.md); an agent is who a harness takes part in rooms as (ADR
+ * 0087), a join request is somebody asking to come in (ADR 0122), and an edit is a person's change
+ * to an agent's context on its way to its harness (ADR 0134), and a change is a person's choice of
+ * an agent's model and effort, of its heartbeat, or of its context window's limit, or a Compact
+ * now, on its way there too (ADR 0140, ADR 0143, ADR 0146). A direct ask is a guest asking an
+ * owner to share the server's machine in Tailscale (ADR 0211, Phase 3).
+ * `agt` was the harness's prefix before the rename of 4 September, and no log holds one.
+ */
+export const ID_PREFIXES = {
+    workspace: "ws",
+    person: "usr",
+    harness: "hrn",
+    space: "spc",
+    message: "msg",
+    run: "run",
+    step: "stp",
+    approval: "apr",
+    question: "qst",
+    lane: "lane",
+    attachment: "att",
+    event: "evt",
+    device: "dev",
+    token: "tok",
+    invite: "inv",
+    passkey: "pky",
+    agent: "agt",
+    join: "jrq",
+    direct: "dra",
+    edit: "edt",
+    change: "chg",
+};
+const ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+const TIME_CHARS = 10;
+const RANDOM_CHARS = 16;
+const RANDOM_BYTES = 10;
+const ULID_CHARS = TIME_CHARS + RANDOM_CHARS;
+const MAX_TIME_MS = 281_474_976_710_655; // 2^48 - 1
+const PREFIX_TO_KIND = new Map(Object.entries(ID_PREFIXES).map(([kind, prefix]) => [prefix, kind]));
+/** Thrown when a string that should be an id is not one. */
+export class InvalidIdError extends Error {
+    value;
+    name = "InvalidIdError";
+    constructor(value, reason) {
+        super(`invalid id ${JSON.stringify(value)}: ${reason}`);
+        this.value = value;
+    }
+}
+/**
+ * A generator that is monotonic within a millisecond. Two generators are independent; a
+ * process that needs strictly ordered ids uses one.
+ */
+export function createIdGenerator(options = {}) {
+    const now = options.now ?? Date.now;
+    const randomFill = options.randomFill ?? defaultRandomFill;
+    const cursor = { time: -1, random: new Uint8Array(RANDOM_BYTES) };
+    return {
+        next(kind) {
+            const prefix = ID_PREFIXES[kind];
+            if (prefix === undefined)
+                throw new InvalidIdError(String(kind), "unknown id kind");
+            advance(cursor, requireTimestamp(now()), randomFill);
+            return `${prefix}_${encodeTime(cursor.time)}${encodeRandom(cursor.random)}`;
+        },
+    };
+}
+/**
+ * Move the cursor to the next id position. A later millisecond starts fresh. The same
+ * millisecond, or a clock that has moved backwards, steps the randomness instead, so the
+ * id still sorts after its predecessor; when the randomness is exhausted it borrows the
+ * next millisecond rather than colliding.
+ */
+function advance(cursor, nowMs, randomFill) {
+    if (nowMs > cursor.time) {
+        cursor.time = nowMs;
+        cursor.random = freshRandom(randomFill);
+        return;
+    }
+    if (!incrementInPlace(cursor.random)) {
+        cursor.time += 1;
+        cursor.random = freshRandom(randomFill);
+    }
+}
+function requireTimestamp(value) {
+    const time = Math.floor(value);
+    if (!Number.isFinite(time) || time < 0 || time > MAX_TIME_MS) {
+        throw new RangeError(`timestamp ${value} is outside the range a ULID can hold`);
+    }
+    return time;
+}
+/** The process-wide generator. Code that can inject a generator should do that instead. */
+export const defaultIdGenerator = createIdGenerator();
+/** Mint an id with the process-wide generator. */
+export function newId(kind) {
+    return defaultIdGenerator.next(kind);
+}
+/** True when `value` is an id of the given kind. */
+export function isId(kind, value) {
+    if (typeof value !== "string")
+        return false;
+    const parsed = tryParseId(value);
+    return parsed !== undefined && parsed.kind === kind;
+}
+/** Split an id into its kind and ULID, or throw if it is not an id. */
+export function parseId(value) {
+    const parsed = tryParseId(value);
+    if (parsed === undefined) {
+        throw new InvalidIdError(value, "expected <prefix>_<26 character ULID>");
+    }
+    return parsed;
+}
+/** The instant an id was minted. */
+export function timestampOf(value) {
+    return decodeTime(parseId(value).ulid);
+}
+function tryParseId(value) {
+    const underscore = value.indexOf("_");
+    if (underscore <= 0)
+        return undefined;
+    const kind = PREFIX_TO_KIND.get(value.slice(0, underscore));
+    if (kind === undefined)
+        return undefined;
+    const ulid = value.slice(underscore + 1);
+    if (ulid.length !== ULID_CHARS)
+        return undefined;
+    for (let i = 0; i < ULID_CHARS; i += 1) {
+        if (ALPHABET.indexOf(ulid.charAt(i)) < 0)
+            return undefined;
+    }
+    // Ten base32 characters hold fifty bits; a timestamp holds forty-eight.
+    if (ALPHABET.indexOf(ulid.charAt(0)) > 7)
+        return undefined;
+    return { kind, ulid };
+}
+function encodeTime(timeMs) {
+    let remaining = timeMs;
+    let out = "";
+    for (let i = 0; i < TIME_CHARS; i += 1) {
+        out = ALPHABET.charAt(remaining % 32) + out;
+        remaining = Math.floor(remaining / 32);
+    }
+    return out;
+}
+function decodeTime(ulid) {
+    let time = 0;
+    for (let i = 0; i < TIME_CHARS; i += 1) {
+        time = time * 32 + ALPHABET.indexOf(ulid.charAt(i));
+    }
+    return time;
+}
+function encodeRandom(bytes) {
+    let value = 0n;
+    for (const byte of bytes)
+        value = (value << 8n) | BigInt(byte);
+    let out = "";
+    for (let i = 0; i < RANDOM_CHARS; i += 1) {
+        out = ALPHABET.charAt(Number(value & 31n)) + out;
+        value >>= 5n;
+    }
+    return out;
+}
+function freshRandom(randomFill) {
+    const bytes = new Uint8Array(RANDOM_BYTES);
+    randomFill(bytes);
+    return bytes;
+}
+/** Adds one to a big-endian byte array. Returns false when it would overflow. */
+function incrementInPlace(bytes) {
+    for (let i = bytes.length - 1; i >= 0; i -= 1) {
+        const byte = bytes[i] ?? 0;
+        if (byte < 0xff) {
+            bytes[i] = byte + 1;
+            return true;
+        }
+        bytes[i] = 0;
+    }
+    return false;
+}
+function defaultRandomFill(into) {
+    globalThis.crypto.getRandomValues(into);
+}
+/**
+ * The id a message has on the wire. A message is its event: the row and the reference both
+ * carry the event's ULID, and `message.new` names it with the message prefix so a `reply_to`
+ * is a message id and not an event id. Pure, and the same in both directions.
+ */
+export function messageIdOf(eventId) {
+    return `${ID_PREFIXES.message}_${parseId(eventId).ulid}`;
+}
+/** The event an on-the-wire message id names. */
+export function eventIdOfMessage(messageId) {
+    return `${ID_PREFIXES.event}_${parseId(messageId).ulid}`;
+}
+//# sourceMappingURL=ulid.js.map

package/dist/src/ids/ulid.js.map

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