@isoplan/protocol 0.0.0-stage → 0.2.0

package/dist/messages.js

@@ -0,0 +1,263 @@
+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),
+});
+const Account = z.object({ id: z.string().min(1), name: z.string() });
+const Machine = z.object({ name: z.string().min(1) });
+/** Matches a request with its reply or refusal. */
+const RequestId = z.string().min(1);
+/** A handoff's id. It names the handoff's branch, `isoplan/handoff/<id>`, so it keeps to safe characters. */
+const HandoffId = z
+    .string()
+    .max(64)
+    .regex(/^[a-z0-9][a-z0-9-]*$/, "lowercase letters, digits and dashes");
+/**
+ * One repo a handoff pushed: its path in the session's folder (`.` for the folder itself), remote,
+ * branch and commit. A handoff drives git on the receiver's machine, so the path stays inside the
+ * folder and the remote can't name a transport helper such as `ext::`, which runs a command.
+ */
+export const HandoffRepoSchema = z.object({
+    path: z
+        .string()
+        .min(1)
+        .refine((path) => !/^([\\/]|[A-Za-z]:)/.test(path), "a path relative to the session's folder")
+        .refine((path) => !path.split(/[\\/]/).includes(".."), "a path inside the session's folder, with no `..`")
+        .refine((path) => !path.startsWith("-"), "a path that doesn't start with `-`, which git would read as an option"),
+    remote: z
+        .string()
+        .min(1)
+        .refine((remote) => !/^[A-Za-z0-9+.-]+::/.test(remote), "a remote with no transport helper (`<transport>::`)")
+        .refine((remote) => !remote.startsWith("-"), "a remote that doesn't start with `-`, which git would read as an option"),
+    branch: z.string().min(1),
+    commit: z.string().regex(/^([0-9a-f]{40}|[0-9a-f]{64})$/, "a full commit hash"),
+});
+/** What the receiver gets: the brief, and every repo pushed for it, each on the handoff's own branch. */
+export const HandoffSchema = z
+    .object({
+    id: HandoffId,
+    brief: z.string().min(1),
+    repos: z.array(HandoffRepoSchema).min(1),
+})
+    .superRefine((handoff, context) => {
+    handoff.repos.forEach((repo, i) => {
+        if (repo.branch !== `isoplan/handoff/${handoff.id}`) {
+            context.addIssue({ code: "custom", path: ["repos", i, "branch"], message: `the handoff's branch, isoplan/handoff/${handoff.id}` });
+        }
+    });
+});
+// 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: Account,
+    machine: Machine,
+    session: z.string().min(1),
+    project: ProjectSchema,
+});
+/** The first message on a runner's link: the one link per machine that answers requests for its rooms. */
+export const RunnerHelloMessageSchema = z.object({
+    type: z.literal("runner"),
+    v: Version,
+    account: Account,
+    machine: Machine,
+});
+/** 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,
+});
+/** The answer to a request, carrying the request's id and kind. */
+export const ReplyMessageSchema = z.discriminatedUnion("kind", [
+    z.object({ type: z.literal("reply"), v: Version, id: RequestId, kind: z.literal("answer-question"), answer: z.string().min(1) }),
+    z.object({ type: z.literal("reply"), v: Version, id: RequestId, kind: z.literal("write-brief"), handoff: HandoffSchema }),
+    // The owner's answer reached the question that was waiting for it.
+    z.object({ type: z.literal("reply"), v: Version, id: RequestId, kind: z.literal("owner-answer") }),
+]);
+/**
+ * A request the machine won't answer, sent in place of its reply. `over-cap` names the cap it would
+ * go over. `withheld` means the secret scan matched; the reply follows if the owner releases it.
+ * `unavailable` is anything else that stops the room answering now, such as its checkout being gone,
+ * its lead being mid-turn or a push being rejected.
+ */
+export const RefusalMessageSchema = z.discriminatedUnion("reason", [
+    z.object({
+        type: z.literal("refusal"),
+        v: Version,
+        id: RequestId,
+        reason: z.literal("over-cap"),
+        cap: z.enum(["room-hour", "owner-day", "owner-tokens"]),
+    }),
+    z.object({ type: z.literal("refusal"), v: Version, id: RequestId, reason: z.literal("withheld") }),
+    z.object({ type: z.literal("refusal"), v: Version, id: RequestId, reason: z.literal("unavailable"), detail: z.string().min(1) }),
+]);
+/**
+ * The sender's session handed its room over with the command: its agent wrote the brief and pushed.
+ * `to` is the receiver as the sender named them, for the server to find in the office.
+ */
+export const HandOverMessageSchema = z.object({
+    type: z.literal("hand-over"),
+    v: Version,
+    to: z.string().min(1),
+    handoff: HandoffSchema,
+});
+/** The receiver's session asks for the handoff a take code stands for. */
+export const TakeMessageSchema = z.object({
+    type: z.literal("take"),
+    v: Version,
+    code: z.string().min(1),
+});
+/**
+ * The receiver took the handoff and joins its room. Each step that failed is listed with the repo it
+ * was for and the end of its output; the session opens anyway.
+ */
+export const TakenMessageSchema = z.object({
+    type: z.literal("taken"),
+    v: Version,
+    handoff: HandoffId,
+    failures: z.array(z.object({
+        step: z.enum(["worktree", "setup", "checkout", "open"]),
+        repo: z.string().min(1).optional(),
+        output: z.string(),
+    })),
+});
+export const DataLayerMessageSchema = z.discriminatedUnion("type", [
+    HelloMessageSchema,
+    RunnerHelloMessageSchema,
+    FullMessageSchema,
+    ChangesMessageSchema,
+    ReplyMessageSchema,
+    RefusalMessageSchema,
+    HandOverMessageSchema,
+    TakeMessageSchema,
+    TakenMessageSchema,
+]);
+// 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(),
+});
+/**
+ * Something for the machine to answer, with a reply or a refusal carrying the same id. `session` is
+ * the session it concerns: the lead whose fork answers or writes the brief, or the session whose
+ * agent asked its owner. `room` is the room the caps count against.
+ */
+export const RequestMessageSchema = z.discriminatedUnion("kind", [
+    // Someone the room was handed to asks it a question.
+    z.object({
+        type: z.literal("request"),
+        v: Version,
+        id: RequestId,
+        kind: z.literal("answer-question"),
+        session: z.string().min(1),
+        room: z.string().min(1),
+        from: Account,
+        question: z.string().min(1),
+    }),
+    // The sender handed the room over from the floor: write the brief and push, for this handoff.
+    z.object({
+        type: z.literal("request"),
+        v: Version,
+        id: RequestId,
+        kind: z.literal("write-brief"),
+        session: z.string().min(1),
+        room: z.string().min(1),
+        handoff: HandoffId,
+        to: Account,
+    }),
+    // The owner answered their agent's question from the floor. `question` is the question fact's id,
+    // and `answers` maps each question's text to its answer.
+    z.object({
+        type: z.literal("request"),
+        v: Version,
+        id: RequestId,
+        kind: z.literal("owner-answer"),
+        session: z.string().min(1),
+        question: z.string().min(1),
+        answers: z.record(z.string(), z.string()),
+    }),
+]);
+/** The owner released a reply the secret scan withheld, so the machine sends it now. */
+export const ReleaseMessageSchema = z.object({
+    type: z.literal("release"),
+    v: Version,
+    id: RequestId,
+});
+/**
+ * A handoff for the receiver to take: sent to their runner when they take it from the floor, or to
+ * their session in answer to a take code.
+ */
+export const HandoffMessageSchema = z.object({
+    type: z.literal("handoff"),
+    v: Version,
+    handoff: HandoffSchema,
+});
+export const OfficeServerMessageSchema = z.discriminatedUnion("type", [
+    RepairMessageSchema,
+    ConflictMessageSchema,
+    ErrorMessageSchema,
+    RequestMessageSchema,
+    ReleaseMessageSchema,
+    HandoffMessageSchema,
+]);
+/** 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.2.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.