@isoplan/protocol 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Linscott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/facts.d.ts

@@ -0,0 +1,330 @@
+import { z } from "zod";
+export declare const SourceSchema: z.ZodEnum<{
+    "claude-code": "claude-code";
+}>;
+export declare const SessionFactSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodEnum<{
+        "claude-code": "claude-code";
+    }>;
+    lead: z.ZodString;
+    title: z.ZodNullable<z.ZodString>;
+    titleFrom: z.ZodEnum<{
+        branch: "branch";
+        source: "source";
+    }>;
+    branch: z.ZodNullable<z.ZodString>;
+    checkout: z.ZodOptional<z.ZodString>;
+    lastActive: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+    }>;
+    lights: z.ZodEnum<{
+        off: "off";
+        on: "on";
+    }>;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const AgentFactSchema: z.ZodObject<{
+    id: z.ZodString;
+    source: z.ZodEnum<{
+        "claude-code": "claude-code";
+    }>;
+    session: z.ZodString;
+    startedBy: z.ZodNullable<z.ZodString>;
+    agentType: z.ZodNullable<z.ZodString>;
+    task: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        done: "done";
+        failed: "failed";
+        idle: "idle";
+        stalled: "stalled";
+        stopped: "stopped";
+        working: "working";
+    }>;
+    statusSince: z.ZodISODateTime;
+    lastActive: z.ZodISODateTime;
+    doing: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            read: "read";
+            run: "run";
+            search: "search";
+            talk: "talk";
+            write: "write";
+        }>;
+        file: z.ZodOptional<z.ZodString>;
+        since: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    usage: z.ZodNullable<z.ZodObject<{
+        input: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        cacheWrite1h: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        output: z.ZodNumber;
+        model: z.ZodString;
+        context: z.ZodNumber;
+        over100k: z.ZodObject<{
+            input: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            cacheWrite1h: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strip>;
+        at: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    checkout: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** An edit or a read: `file` is relative to the repo root, with forward slashes. */
+export declare const FileFactSchema: z.ZodObject<{
+    agent: z.ZodString;
+    file: z.ZodString;
+    at: z.ZodISODateTime;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const WaitFactSchema: z.ZodObject<{
+    waiter: z.ZodString;
+    on: z.ZodString;
+    since: z.ZodISODateTime;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const ReportFactSchema: z.ZodObject<{
+    agent: z.ZodString;
+    at: z.ZodISODateTime;
+    text: z.ZodString;
+    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const FactsSchema: z.ZodObject<{
+    session: z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodEnum<{
+            "claude-code": "claude-code";
+        }>;
+        lead: z.ZodString;
+        title: z.ZodNullable<z.ZodString>;
+        titleFrom: z.ZodEnum<{
+            branch: "branch";
+            source: "source";
+        }>;
+        branch: z.ZodNullable<z.ZodString>;
+        checkout: z.ZodOptional<z.ZodString>;
+        lastActive: z.ZodISODateTime;
+        status: z.ZodEnum<{
+            active: "active";
+            idle: "idle";
+        }>;
+        lights: z.ZodEnum<{
+            off: "off";
+            on: "on";
+        }>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    agents: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodEnum<{
+            "claude-code": "claude-code";
+        }>;
+        session: z.ZodString;
+        startedBy: z.ZodNullable<z.ZodString>;
+        agentType: z.ZodNullable<z.ZodString>;
+        task: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            done: "done";
+            failed: "failed";
+            idle: "idle";
+            stalled: "stalled";
+            stopped: "stopped";
+            working: "working";
+        }>;
+        statusSince: z.ZodISODateTime;
+        lastActive: z.ZodISODateTime;
+        doing: z.ZodNullable<z.ZodObject<{
+            kind: z.ZodEnum<{
+                read: "read";
+                run: "run";
+                search: "search";
+                talk: "talk";
+                write: "write";
+            }>;
+            file: z.ZodOptional<z.ZodString>;
+            since: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        usage: z.ZodNullable<z.ZodObject<{
+            input: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            cacheWrite1h: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            output: z.ZodNumber;
+            model: z.ZodString;
+            context: z.ZodNumber;
+            over100k: z.ZodObject<{
+                input: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                cacheWrite1h: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                output: z.ZodNumber;
+            }, z.core.$strip>;
+            at: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        checkout: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    edits: z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        file: z.ZodString;
+        at: z.ZodISODateTime;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    reads: z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        file: z.ZodString;
+        at: z.ZodISODateTime;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    waits: z.ZodArray<z.ZodObject<{
+        waiter: z.ZodString;
+        on: z.ZodString;
+        since: z.ZodISODateTime;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    reports: z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        at: z.ZodISODateTime;
+        text: z.ZodString;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** The records that changed, each replacing the one with the same key. */
+export declare const FactUpsertSchema: z.ZodObject<{
+    session: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodEnum<{
+            "claude-code": "claude-code";
+        }>;
+        lead: z.ZodString;
+        title: z.ZodNullable<z.ZodString>;
+        titleFrom: z.ZodEnum<{
+            branch: "branch";
+            source: "source";
+        }>;
+        branch: z.ZodNullable<z.ZodString>;
+        checkout: z.ZodOptional<z.ZodString>;
+        lastActive: z.ZodISODateTime;
+        status: z.ZodEnum<{
+            active: "active";
+            idle: "idle";
+        }>;
+        lights: z.ZodEnum<{
+            off: "off";
+            on: "on";
+        }>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodEnum<{
+            "claude-code": "claude-code";
+        }>;
+        session: z.ZodString;
+        startedBy: z.ZodNullable<z.ZodString>;
+        agentType: z.ZodNullable<z.ZodString>;
+        task: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            done: "done";
+            failed: "failed";
+            idle: "idle";
+            stalled: "stalled";
+            stopped: "stopped";
+            working: "working";
+        }>;
+        statusSince: z.ZodISODateTime;
+        lastActive: z.ZodISODateTime;
+        doing: z.ZodNullable<z.ZodObject<{
+            kind: z.ZodEnum<{
+                read: "read";
+                run: "run";
+                search: "search";
+                talk: "talk";
+                write: "write";
+            }>;
+            file: z.ZodOptional<z.ZodString>;
+            since: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        usage: z.ZodNullable<z.ZodObject<{
+            input: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            cacheWrite1h: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            output: z.ZodNumber;
+            model: z.ZodString;
+            context: z.ZodNumber;
+            over100k: z.ZodObject<{
+                input: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                cacheWrite1h: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                output: z.ZodNumber;
+            }, z.core.$strip>;
+            at: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        checkout: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        file: z.ZodString;
+        at: z.ZodISODateTime;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    reads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        file: z.ZodString;
+        at: z.ZodISODateTime;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        waiter: z.ZodString;
+        on: z.ZodString;
+        since: z.ZodISODateTime;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    reports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        at: z.ZodISODateTime;
+        text: z.ZodString;
+        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * The keys of records that went away: an agent by its id, an edit or read by agent and file, a
+ * wait by waiter and on, a report by its agent. The session itself goes with the connection.
+ */
+export declare const FactRemoveSchema: z.ZodObject<{
+    agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        file: z.ZodString;
+    }, z.core.$strip>>>;
+    reads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        file: z.ZodString;
+    }, z.core.$strip>>>;
+    waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        waiter: z.ZodString;
+        on: z.ZodString;
+    }, z.core.$strip>>>;
+    reports: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type Source = z.infer<typeof SourceSchema>;
+export type SessionFact = z.infer<typeof SessionFactSchema>;
+export type AgentFact = z.infer<typeof AgentFactSchema>;
+export type FileFact = z.infer<typeof FileFactSchema>;
+export type WaitFact = z.infer<typeof WaitFactSchema>;
+export type ReportFact = z.infer<typeof ReportFactSchema>;
+export type Facts = z.infer<typeof FactsSchema>;
+export type FactUpsert = z.infer<typeof FactUpsertSchema>;
+export type FactRemove = z.infer<typeof FactRemoveSchema>;

package/dist/facts.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+// One session's facts, as its data layer reports them: v1's office model minus everything derived
+// (rooms, roles, meaning) and minus what the hello already says (the owner, the project).
+/** ISO time, with Z or an offset. */
+const Time = z.iso.datetime({ offset: true });
+/** Tool-specific detail that views never rely on. */
+const Extra = z.record(z.string(), z.unknown()).optional();
+export const SourceSchema = z.enum(["claude-code"]);
+export const SessionFactSchema = z.object({
+    id: z.string().min(1),
+    source: SourceSchema,
+    lead: z.string().min(1),
+    title: z.string().nullable(),
+    titleFrom: z.enum(["source", "branch"]),
+    branch: z.string().nullable(),
+    checkout: z.string().optional(),
+    lastActive: Time,
+    status: z.enum(["active", "idle"]),
+    lights: z.enum(["on", "off"]),
+    extra: Extra,
+});
+const TokenCount = z.number().int().nonnegative();
+const TokenCounts = z.object({
+    input: TokenCount,
+    cacheWrite: TokenCount,
+    cacheWrite1h: TokenCount,
+    cacheRead: TokenCount,
+    output: TokenCount,
+});
+export const AgentFactSchema = z.object({
+    id: z.string().min(1),
+    source: SourceSchema,
+    session: z.string().min(1),
+    startedBy: z.string().min(1).nullable(),
+    agentType: z.string().nullable(),
+    task: z.string().nullable(),
+    status: z.enum(["working", "idle", "done", "stalled", "stopped", "failed"]),
+    statusSince: Time,
+    lastActive: Time,
+    doing: z
+        .object({
+        kind: z.enum(["write", "read", "run", "search", "talk"]),
+        file: z.string().optional(),
+        since: Time,
+    })
+        .nullable(),
+    usage: TokenCounts.extend({
+        model: z.string().min(1),
+        context: TokenCount,
+        over100k: TokenCounts,
+        at: Time,
+    }).nullable(),
+    checkout: z.string().optional(),
+    branch: z.string().nullable().optional(),
+    extra: Extra,
+});
+/** An edit or a read: `file` is relative to the repo root, with forward slashes. */
+export const FileFactSchema = z.object({
+    agent: z.string().min(1),
+    file: z.string().min(1),
+    at: Time,
+    extra: Extra,
+});
+export const WaitFactSchema = z.object({
+    waiter: z.string().min(1),
+    on: z.string().min(1),
+    since: Time,
+    extra: Extra,
+});
+export const ReportFactSchema = z.object({
+    agent: z.string().min(1),
+    at: Time,
+    text: z.string(),
+    extra: Extra,
+});
+export const FactsSchema = z.object({
+    session: SessionFactSchema,
+    agents: z.array(AgentFactSchema),
+    edits: z.array(FileFactSchema),
+    reads: z.array(FileFactSchema),
+    waits: z.array(WaitFactSchema),
+    reports: z.array(ReportFactSchema),
+});
+/** The records that changed, each replacing the one with the same key. */
+export const FactUpsertSchema = z.object({
+    session: SessionFactSchema.optional(),
+    agents: z.array(AgentFactSchema).optional(),
+    edits: z.array(FileFactSchema).optional(),
+    reads: z.array(FileFactSchema).optional(),
+    waits: z.array(WaitFactSchema).optional(),
+    reports: z.array(ReportFactSchema).optional(),
+});
+const FileKey = FileFactSchema.pick({ agent: true, file: true });
+/**
+ * The keys of records that went away: an agent by its id, an edit or read by agent and file, a
+ * wait by waiter and on, a report by its agent. The session itself goes with the connection.
+ */
+export const FactRemoveSchema = z.object({
+    agents: z.array(z.string().min(1)).optional(),
+    edits: z.array(FileKey).optional(),
+    reads: z.array(FileKey).optional(),
+    waits: z.array(WaitFactSchema.pick({ waiter: true, on: true })).optional(),
+    reports: z.array(z.string().min(1)).optional(),
+});
+//# sourceMappingURL=facts.js.map

package/dist/facts.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./facts.js";
+export * from "./messages.js";
+export * from "./project-id.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./facts.js";
+export * from "./messages.js";
+export * from "./project-id.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,567 @@
+import { z } from "zod";
+/**
+ * The protocol version every message carries as `v`. Adding optional fields doesn't change it;
+ * changing what a field means, or removing one, does.
+ */
+export declare const PROTOCOL_VERSION = 1;
+export declare const ProjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+/** The first message on a connection: who is reporting, from where, about which session. */
+export declare const HelloMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    v: z.ZodLiteral<1>;
+    source: z.ZodEnum<{
+        "claude-code": "claude-code";
+    }>;
+    account: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    machine: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>;
+    session: z.ZodString;
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** All of the session's facts. Sent on connect and on repair. */
+export declare const FullMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"full">;
+    v: z.ZodLiteral<1>;
+    seq: z.ZodNumber;
+    facts: z.ZodObject<{
+        session: z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            lead: z.ZodString;
+            title: z.ZodNullable<z.ZodString>;
+            titleFrom: z.ZodEnum<{
+                branch: "branch";
+                source: "source";
+            }>;
+            branch: z.ZodNullable<z.ZodString>;
+            checkout: z.ZodOptional<z.ZodString>;
+            lastActive: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                active: "active";
+                idle: "idle";
+            }>;
+            lights: z.ZodEnum<{
+                off: "off";
+                on: "on";
+            }>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+        agents: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            session: z.ZodString;
+            startedBy: z.ZodNullable<z.ZodString>;
+            agentType: z.ZodNullable<z.ZodString>;
+            task: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                done: "done";
+                failed: "failed";
+                idle: "idle";
+                stalled: "stalled";
+                stopped: "stopped";
+                working: "working";
+            }>;
+            statusSince: z.ZodISODateTime;
+            lastActive: z.ZodISODateTime;
+            doing: z.ZodNullable<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    read: "read";
+                    run: "run";
+                    search: "search";
+                    talk: "talk";
+                    write: "write";
+                }>;
+                file: z.ZodOptional<z.ZodString>;
+                since: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            usage: z.ZodNullable<z.ZodObject<{
+                input: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                cacheWrite1h: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                output: z.ZodNumber;
+                model: z.ZodString;
+                context: z.ZodNumber;
+                over100k: z.ZodObject<{
+                    input: z.ZodNumber;
+                    cacheWrite: z.ZodNumber;
+                    cacheWrite1h: z.ZodNumber;
+                    cacheRead: z.ZodNumber;
+                    output: z.ZodNumber;
+                }, z.core.$strip>;
+                at: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            checkout: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        edits: z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        reads: z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        waits: z.ZodArray<z.ZodObject<{
+            waiter: z.ZodString;
+            on: z.ZodString;
+            since: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        reports: z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            at: z.ZodISODateTime;
+            text: z.ZodString;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** What changed since the last message. `seq` goes up by one per message, so a gap shows. */
+export declare const ChangesMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"changes">;
+    v: z.ZodLiteral<1>;
+    seq: z.ZodNumber;
+    upsert: z.ZodObject<{
+        session: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            lead: z.ZodString;
+            title: z.ZodNullable<z.ZodString>;
+            titleFrom: z.ZodEnum<{
+                branch: "branch";
+                source: "source";
+            }>;
+            branch: z.ZodNullable<z.ZodString>;
+            checkout: z.ZodOptional<z.ZodString>;
+            lastActive: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                active: "active";
+                idle: "idle";
+            }>;
+            lights: z.ZodEnum<{
+                off: "off";
+                on: "on";
+            }>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            session: z.ZodString;
+            startedBy: z.ZodNullable<z.ZodString>;
+            agentType: z.ZodNullable<z.ZodString>;
+            task: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                done: "done";
+                failed: "failed";
+                idle: "idle";
+                stalled: "stalled";
+                stopped: "stopped";
+                working: "working";
+            }>;
+            statusSince: z.ZodISODateTime;
+            lastActive: z.ZodISODateTime;
+            doing: z.ZodNullable<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    read: "read";
+                    run: "run";
+                    search: "search";
+                    talk: "talk";
+                    write: "write";
+                }>;
+                file: z.ZodOptional<z.ZodString>;
+                since: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            usage: z.ZodNullable<z.ZodObject<{
+                input: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                cacheWrite1h: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                output: z.ZodNumber;
+                model: z.ZodString;
+                context: z.ZodNumber;
+                over100k: z.ZodObject<{
+                    input: z.ZodNumber;
+                    cacheWrite: z.ZodNumber;
+                    cacheWrite1h: z.ZodNumber;
+                    cacheRead: z.ZodNumber;
+                    output: z.ZodNumber;
+                }, z.core.$strip>;
+                at: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            checkout: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            waiter: z.ZodString;
+            on: z.ZodString;
+            since: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        reports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            at: z.ZodISODateTime;
+            text: z.ZodString;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    remove: z.ZodObject<{
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+        }, z.core.$strip>>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+        }, z.core.$strip>>>;
+        waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            waiter: z.ZodString;
+            on: z.ZodString;
+        }, z.core.$strip>>>;
+        reports: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const DataLayerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    v: z.ZodLiteral<1>;
+    source: z.ZodEnum<{
+        "claude-code": "claude-code";
+    }>;
+    account: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+    machine: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>;
+    session: z.ZodString;
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"full">;
+    v: z.ZodLiteral<1>;
+    seq: z.ZodNumber;
+    facts: z.ZodObject<{
+        session: z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            lead: z.ZodString;
+            title: z.ZodNullable<z.ZodString>;
+            titleFrom: z.ZodEnum<{
+                branch: "branch";
+                source: "source";
+            }>;
+            branch: z.ZodNullable<z.ZodString>;
+            checkout: z.ZodOptional<z.ZodString>;
+            lastActive: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                active: "active";
+                idle: "idle";
+            }>;
+            lights: z.ZodEnum<{
+                off: "off";
+                on: "on";
+            }>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>;
+        agents: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            session: z.ZodString;
+            startedBy: z.ZodNullable<z.ZodString>;
+            agentType: z.ZodNullable<z.ZodString>;
+            task: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                done: "done";
+                failed: "failed";
+                idle: "idle";
+                stalled: "stalled";
+                stopped: "stopped";
+                working: "working";
+            }>;
+            statusSince: z.ZodISODateTime;
+            lastActive: z.ZodISODateTime;
+            doing: z.ZodNullable<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    read: "read";
+                    run: "run";
+                    search: "search";
+                    talk: "talk";
+                    write: "write";
+                }>;
+                file: z.ZodOptional<z.ZodString>;
+                since: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            usage: z.ZodNullable<z.ZodObject<{
+                input: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                cacheWrite1h: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                output: z.ZodNumber;
+                model: z.ZodString;
+                context: z.ZodNumber;
+                over100k: z.ZodObject<{
+                    input: z.ZodNumber;
+                    cacheWrite: z.ZodNumber;
+                    cacheWrite1h: z.ZodNumber;
+                    cacheRead: z.ZodNumber;
+                    output: z.ZodNumber;
+                }, z.core.$strip>;
+                at: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            checkout: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        edits: z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        reads: z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        waits: z.ZodArray<z.ZodObject<{
+            waiter: z.ZodString;
+            on: z.ZodString;
+            since: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        reports: z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            at: z.ZodISODateTime;
+            text: z.ZodString;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"changes">;
+    v: z.ZodLiteral<1>;
+    seq: z.ZodNumber;
+    upsert: z.ZodObject<{
+        session: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            lead: z.ZodString;
+            title: z.ZodNullable<z.ZodString>;
+            titleFrom: z.ZodEnum<{
+                branch: "branch";
+                source: "source";
+            }>;
+            branch: z.ZodNullable<z.ZodString>;
+            checkout: z.ZodOptional<z.ZodString>;
+            lastActive: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                active: "active";
+                idle: "idle";
+            }>;
+            lights: z.ZodEnum<{
+                off: "off";
+                on: "on";
+            }>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<{
+                "claude-code": "claude-code";
+            }>;
+            session: z.ZodString;
+            startedBy: z.ZodNullable<z.ZodString>;
+            agentType: z.ZodNullable<z.ZodString>;
+            task: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                done: "done";
+                failed: "failed";
+                idle: "idle";
+                stalled: "stalled";
+                stopped: "stopped";
+                working: "working";
+            }>;
+            statusSince: z.ZodISODateTime;
+            lastActive: z.ZodISODateTime;
+            doing: z.ZodNullable<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    read: "read";
+                    run: "run";
+                    search: "search";
+                    talk: "talk";
+                    write: "write";
+                }>;
+                file: z.ZodOptional<z.ZodString>;
+                since: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            usage: z.ZodNullable<z.ZodObject<{
+                input: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                cacheWrite1h: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                output: z.ZodNumber;
+                model: z.ZodString;
+                context: z.ZodNumber;
+                over100k: z.ZodObject<{
+                    input: z.ZodNumber;
+                    cacheWrite: z.ZodNumber;
+                    cacheWrite1h: z.ZodNumber;
+                    cacheRead: z.ZodNumber;
+                    output: z.ZodNumber;
+                }, z.core.$strip>;
+                at: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            checkout: z.ZodOptional<z.ZodString>;
+            branch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+            at: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            waiter: z.ZodString;
+            on: z.ZodString;
+            since: z.ZodISODateTime;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+        reports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            at: z.ZodISODateTime;
+            text: z.ZodString;
+            extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    remove: z.ZodObject<{
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+        }, z.core.$strip>>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agent: z.ZodString;
+            file: z.ZodString;
+        }, z.core.$strip>>>;
+        waits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            waiter: z.ZodString;
+            on: z.ZodString;
+        }, z.core.$strip>>>;
+        reports: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+/** Asks the data layer to send its facts in full. */
+export declare const RepairMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"repair">;
+    v: z.ZodLiteral<1>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A note for the later editor of `file`, which the data layer adds to `agent`'s next tool result. */
+export declare const ConflictMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conflict">;
+    v: z.ZodLiteral<1>;
+    agent: z.ZodString;
+    file: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>;
+/** Something the data layer should show. */
+export declare const ErrorMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    v: z.ZodLiteral<1>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const OfficeServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"repair">;
+    v: z.ZodLiteral<1>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conflict">;
+    v: z.ZodLiteral<1>;
+    agent: z.ZodString;
+    file: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    v: z.ZodLiteral<1>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>], "type">;
+export type Project = z.infer<typeof ProjectSchema>;
+export type HelloMessage = z.infer<typeof HelloMessageSchema>;
+export type FullMessage = z.infer<typeof FullMessageSchema>;
+export type ChangesMessage = z.infer<typeof ChangesMessageSchema>;
+export type DataLayerMessage = z.infer<typeof DataLayerMessageSchema>;
+export type RepairMessage = z.infer<typeof RepairMessageSchema>;
+export type ConflictMessage = z.infer<typeof ConflictMessageSchema>;
+export type ErrorMessage = z.infer<typeof ErrorMessageSchema>;
+export type OfficeServerMessage = z.infer<typeof OfficeServerMessageSchema>;
+/**
+ * A parsed message, or why it was refused: `unsupported-version` when it carries a protocol
+ * version this side doesn't speak, `invalid` for anything else wrong with it.
+ */
+export type ParseResult<T> = {
+    ok: true;
+    message: T;
+} | {
+    ok: false;
+    kind: "invalid" | "unsupported-version";
+    error: string;
+};
+/** Validates a message an office server received from a data layer. */
+export declare function parseDataLayerMessage(value: unknown): ParseResult<DataLayerMessage>;
+/** Validates a message a data layer received from an office server. */
+export declare function parseOfficeServerMessage(value: unknown): ParseResult<OfficeServerMessage>;

package/dist/messages.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { FactRemoveSchema, FactsSchema, FactUpsertSchema, SourceSchema } from "./facts.js";
+/**
+ * The protocol version every message carries as `v`. Adding optional fields doesn't change it;
+ * changing what a field means, or removing one, does.
+ */
+export const PROTOCOL_VERSION = 1;
+const Version = z.literal(PROTOCOL_VERSION);
+const Seq = z.number().int().nonnegative();
+export const ProjectSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+});
+// Data layer → office server.
+/** The first message on a connection: who is reporting, from where, about which session. */
+export const HelloMessageSchema = z.object({
+    type: z.literal("hello"),
+    v: Version,
+    source: SourceSchema,
+    account: z.object({ id: z.string().min(1), name: z.string() }),
+    machine: z.object({ name: z.string().min(1) }),
+    session: z.string().min(1),
+    project: ProjectSchema,
+});
+/** All of the session's facts. Sent on connect and on repair. */
+export const FullMessageSchema = z.object({
+    type: z.literal("full"),
+    v: Version,
+    seq: Seq,
+    facts: FactsSchema,
+});
+/** What changed since the last message. `seq` goes up by one per message, so a gap shows. */
+export const ChangesMessageSchema = z.object({
+    type: z.literal("changes"),
+    v: Version,
+    seq: Seq,
+    upsert: FactUpsertSchema,
+    remove: FactRemoveSchema,
+});
+export const DataLayerMessageSchema = z.discriminatedUnion("type", [
+    HelloMessageSchema,
+    FullMessageSchema,
+    ChangesMessageSchema,
+]);
+// Office server → data layer.
+/** Asks the data layer to send its facts in full. */
+export const RepairMessageSchema = z.object({
+    type: z.literal("repair"),
+    v: Version,
+    reason: z.string().optional(),
+});
+/** A note for the later editor of `file`, which the data layer adds to `agent`'s next tool result. */
+export const ConflictMessageSchema = z.object({
+    type: z.literal("conflict"),
+    v: Version,
+    agent: z.string().min(1),
+    file: z.string().min(1),
+    text: z.string().min(1),
+});
+/** Something the data layer should show. */
+export const ErrorMessageSchema = z.object({
+    type: z.literal("error"),
+    v: Version,
+    code: z.string().min(1),
+    message: z.string(),
+});
+export const OfficeServerMessageSchema = z.discriminatedUnion("type", [
+    RepairMessageSchema,
+    ConflictMessageSchema,
+    ErrorMessageSchema,
+]);
+/** Validates a message an office server received from a data layer. */
+export function parseDataLayerMessage(value) {
+    return parse(DataLayerMessageSchema, value);
+}
+/** Validates a message a data layer received from an office server. */
+export function parseOfficeServerMessage(value) {
+    return parse(OfficeServerMessageSchema, value);
+}
+function parse(schema, value) {
+    // The version is checked first, so a newer peer is told so rather than given a field-by-field
+    // list of what changed.
+    if (typeof value === "object" && value !== null && "v" in value && typeof value.v === "number" && value.v !== PROTOCOL_VERSION) {
+        return {
+            ok: false,
+            kind: "unsupported-version",
+            error: `protocol version ${JSON.stringify(value.v)} is not supported; this side speaks version ${PROTOCOL_VERSION}`,
+        };
+    }
+    const result = schema.safeParse(value);
+    if (result.success)
+        return { ok: true, message: result.data };
+    return { ok: false, kind: "invalid", error: z.prettifyError(result.error) };
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

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

package/dist/project-id.d.ts

@@ -0,0 +1,12 @@
+import type { Project } from "./messages.js";
+/**
+ * A project's id and name. With a git remote the id is `host/owner/repo` (any deeper path kept, as
+ * for GitLab subgroups), the same whichever form or letter case the remote is written in, so a
+ * repository cloned on several machines is one project. A repo with no remote, a remote that is a
+ * local path, or one that can't be read is `local:<machine>/<root>`, its working tree's root path.
+ * Never throws, so a remote's credentials never reach an error message.
+ */
+export declare function projectId(remoteUrl: string | null, local: {
+    machine: string;
+    root: string;
+}): Project;

package/dist/project-id.js

@@ -0,0 +1,37 @@
+/**
+ * A project's id and name. With a git remote the id is `host/owner/repo` (any deeper path kept, as
+ * for GitLab subgroups), the same whichever form or letter case the remote is written in, so a
+ * repository cloned on several machines is one project. A repo with no remote, a remote that is a
+ * local path, or one that can't be read is `local:<machine>/<root>`, its working tree's root path.
+ * Never throws, so a remote's credentials never reach an error message.
+ */
+export function projectId(remoteUrl, local) {
+    const remote = remoteUrl === null || isLocalPath(remoteUrl.trim()) ? null : splitRemote(remoteUrl.trim());
+    const segments = remote?.path
+        .replace(/\/+$/, "")
+        .replace(/\.git$/, "")
+        .split("/")
+        .filter(Boolean);
+    if (!remote || !segments || segments.length === 0) {
+        const root = local.root.replace(/\\/g, "/").replace(/\/+$/, "");
+        return { id: `local:${local.machine}/${root}`, name: root.split("/").pop() || root };
+    }
+    // Hosts and the big forges treat owner and repo names case-insensitively.
+    return { id: [remote.host, ...segments].join("/").toLowerCase(), name: segments[segments.length - 1] };
+}
+// An empty remote, a path (`/srv/x.git`, `./x`, `~/x`, `C:\x`, `\\server\x`) or a `file:` URL.
+function isLocalPath(remote) {
+    return remote === "" || /^(?:[/.~\\]|[A-Za-z]:[\\/]|file:)/.test(remote);
+}
+// `scheme://[user[:password]@]host[:port]/path`, or scp-like `[user@]host:path`; null when neither.
+function splitRemote(remote) {
+    if (remote.includes("://")) {
+        if (!URL.canParse(remote))
+            return null;
+        const url = new URL(remote);
+        return url.hostname ? { host: url.hostname, path: url.pathname } : null;
+    }
+    const scp = /^(?:[^@/]+@)?([^:/]+):(.+)$/.exec(remote);
+    return scp ? { host: scp[1], path: scp[2] } : null;
+}
+//# sourceMappingURL=project-id.js.map

package/dist/project-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.js","sourceRoot":"","sources":["../src/project-id.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,SAAwB,EAAE,KAAwC;IAC1F,MAAM,MAAM,GAAG,SAAS,KAAK,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,MAAM,EAAE,IAAI;SAC1B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,SAAS,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;IACvF,CAAC;IACD,0EAA0E;IAC1E,OAAO,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,CAAC;AAC1G,CAAC;AAED,+FAA+F;AAC/F,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,MAAM,KAAK,EAAE,IAAI,mCAAmC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,oGAAoG;AACpG,SAAS,WAAW,CAAC,MAAc;IACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IACD,MAAM,GAAG,GAAG,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC"}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@isoplan/protocol",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The wire protocol between Isoplan's Claude Code plugin and an office server: message and fact types, with zod parsers.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adamlinscott/isoplan-plugin.git",
+    "directory": "packages/protocol"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "zod": "^4.6.7"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.