@inhuman.tools/harness-contract 0.0.0-stage → 0.1.0

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAA2B,MAAM,gBAAgB,CAAC;AACzG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,0HAA0H;IAC1H,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;CACzB;AAED,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,iBAAiB,CAChH,CAAC,EACD,CAAC,EACD,GAAG,EACH,WAAW,CACZ,CAAC;AAQF,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,MAAM,EAAE,CAE1D;AAoVD;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAkC,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,OAAO,QAAQ,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,GAAE,iBAA4B,EAAE,IAAI,GAAE,SAAS,MAAM,EAAO,GAAG,aAAa,EAAE,CAKlH;AAED,oCAAoC;AACpC,wBAAgB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAE5D;AAED,4GAA4G;AAC5G,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAOzE"}

package/dist/contract.js

@@ -0,0 +1,353 @@
+import { isContractProcedure, oc } from "@orpc/contract";
+import { z } from "zod";
+import * as authorization from "./schemas/authorization.js";
+import * as connection from "./schemas/connection.js";
+import { uiFormSchema, uiResolveInput } from "./schemas/rpc.js";
+import * as shapes from "./schemas/shapes.js";
+/** The HTTP path a procedure is projected to in the OpenAPI document. */
+export function httpPathOf(meta) {
+    return meta.host === "any" ? `/${meta.method}` : `/${meta.host}/${meta.method}`;
+}
+function rpc(host, method, doc) {
+    const meta = doc.mayPark === true ? { method, host, mayPark: true } : { method, host };
+    const namespace = method.includes("/") ? method.slice(0, method.indexOf("/")) : method;
+    return oc.$meta(meta).route({
+        method: "POST",
+        path: httpPathOf(meta),
+        summary: doc.summary,
+        ...(doc.description === undefined ? {} : { description: doc.description }),
+        tags: [host === "any" ? "ui" : `${host}.${namespace}`],
+    });
+}
+/** A parking method's output: its result, or the form to answer. */
+const parks = (result) => z.union([result, uiFormSchema]);
+const session = {
+    kv: {
+        set: rpc("session", "kv/set", {
+            summary: "Write a key in session, project or kernel scope",
+            description: 'Session `model` / `connection` also become the last-choice default (project + kernel) when `remember` is set. `/model` and `/connect` send "1"; a bare session write (subagent, `--model`, `--connection`) does not.',
+        })
+            .input(shapes.kvSetInput)
+            .output(shapes.kvOutput),
+        clear: rpc("session", "kv/clear", { summary: "Clear a key in session, project or kernel scope" })
+            .input(shapes.kvClearInput)
+            .output(shapes.kvOutput),
+    },
+    plugin: {
+        method: rpc("session", "plugin/method", {
+            summary: "Call a plugin's own state method",
+            description: "A plugin command's call into that plugin's own state. `args` is a JSON object, since action params cross as strings. `field` names the argument the composer text (`input`) fills; an empty `input` then refuses. A failure is data (`ok: false`), not an RPC error.",
+        })
+            .input(shapes.pluginMethodInput)
+            .output(shapes.pluginMethodOutput),
+    },
+    policy: {
+        set: rpc("session", "policy/set", { summary: "Set the session's permission mode" })
+            .input(shapes.policySetInput)
+            .output(shapes.policySetOutput),
+        explain: rpc("session", "policy/explain", {
+            summary: "Explain what would happen to a call right now",
+            description: "Runs the same floor, grant and resolution code as a real call, with no judge and no effect. Returns the tier (block, soft-deny, ask, allow), the classes that voted, which resolver licenses it in the session's mode and from which layer, and the outcome.",
+        })
+            .input(authorization.policyExplainInput)
+            .output(authorization.policyExplainOutput),
+        overlay: rpc("session", "policy/overlay", {
+            summary: "Set or clear this session's authorization overlay",
+            description: "A human decision for this session only. It may loosen what the user's config says, but never past the project layer. Refused for any caller that is not a human client.",
+        })
+            .input(authorization.policyOverlayInput)
+            .output(authorization.policyOverlayOutput),
+        configGet: rpc("session", "policy/config-get", {
+            summary: "Read the authorization layers this session resolves against",
+        })
+            .input(authorization.policyConfigGetInput)
+            .output(authorization.policyConfigGetOutput),
+    },
+    connect: {
+        adopt: rpc("session", "connect/adopt", {
+            summary: "Adopt a connection and make it this session's connection",
+            description: "Delegates to the kernel's `connect/adopt`, then writes the new connection id into the session's `connection` key and warms it. May park for UI.",
+            mayPark: true,
+        })
+            .input(shapes.connectAdoptInput)
+            .output(shapes.sessionConnectAdoptOutput),
+    },
+    turn: {
+        send: rpc("session", "turn", {
+            summary: "Submit a prompt as a turn, a steer or a queued prompt",
+            description: "Pictures (`visuals`) ride only on a fresh turn: standard base64, stored beside the session, and the model must accept images.",
+        })
+            .input(shapes.turnInput)
+            .output(shapes.turnOutput),
+        cancel: rpc("session", "turn/cancel", { summary: "Cancel a running turn by turn id or eval request id" })
+            .input(shapes.turnCancelInput)
+            .output(shapes.turnCancelOutput),
+        visual: rpc("session", "turn/visual", { summary: "Read one picture seated on the session's head turn" })
+            .input(shapes.turnVisualReadInput)
+            .output(shapes.turnVisualReadOutput),
+        rewind: rpc("session", "turn/rewind", { summary: "Rewind the session to before a turn" })
+            .input(shapes.turnRewindInput)
+            .output(shapes.turnRewindOutput),
+        retry: rpc("session", "turn/retry", { summary: "Retry the last turn" })
+            .input(shapes.turnRetryInput)
+            .output(shapes.turnRetryOutput),
+    },
+    blob: {
+        get: rpc("session", "blob/get", {
+            summary: "Read one blob the session's document references, by content hash",
+            description: "Large bodies (a file's prior text today) live in the kernel's blob bucket; the document keeps `{sha256, bytes, mime, head}`. `text/*` blobs return `text`, anything else `bytesBase64`. The hash a document names is the capability; there is no listing.",
+        })
+            .input(shapes.blobGetInput)
+            .output(shapes.blobGetOutput),
+        vacuum: rpc("session", "blob/vacuum", {
+            summary: "Move the session's large stored text into the blob bucket",
+            description: "A session written before large bodies left the document keeps a file's prior text and an isolated completion's prompt inline, and the stored image carries them forever. The vacuum moves every such body over the inline limit into the kernel's blob bucket, leaving the head and a reference, then rewrites the stored image as one snapshot. Completions still running are skipped. `dryRun` counts what would move and writes nothing. Reads stay whole: the wire projection and `blob/get` resolve the references.",
+        })
+            .input(shapes.blobVacuumInput)
+            .output(shapes.blobVacuumOutput),
+    },
+    compact: rpc("session", "compact", { summary: "Compact the session's context, optionally around a focus" })
+        .input(shapes.compactInput)
+        .output(shapes.compactOutput),
+    rename: rpc("session", "rename", { summary: "Set the session title" })
+        .input(shapes.renameInput)
+        .output(shapes.renameOutput),
+    eval: rpc("session", "eval", {
+        summary: "Admit a Scheme program as an unattended eval turn",
+        description: "Idempotent per `requestId`: a repeat with the same input returns the admitted turn; a repeat with different input is refused. `ok: false` with `policy_unavailable` means the requested permission policy cannot run unattended.",
+    })
+        .input(shapes.evalInput)
+        .output(shapes.evalOutput),
+    ask: {
+        answer: rpc("session", "ask/answer", {
+            summary: "Answer the live approval ask",
+            description: "Answer the live ask or soft-deny on `sessionId`: this session, or a worker that escalated to it. `store` remembers a human yes to an ask as a grant (scope, subject, TTL); a soft-deny is never stored and a block is never put to a human.",
+        })
+            .input(authorization.askAnswerInput)
+            .output(authorization.askAnswerOutput),
+    },
+    ack: {
+        pending: rpc("session", "ack/pending", {
+            summary: "List calls waiting for an acknowledgement",
+            description: "A call that is allowed but flagged `needsAcknowledgement` waits for a person. Acks travel over RPC only: there is no ack job and no transcript entry. Absent `sessionId`: this session and the workers that escalated to it.",
+        })
+            .input(authorization.ackPendingInput)
+            .output(authorization.ackPendingOutput),
+        answer: rpc("session", "ack/answer", {
+            summary: "Acknowledge or refuse a pending call, optionally remembering the acknowledgement",
+            description: "Human clients only. `accept` lets the call run; a refusal is a human denial (its `comment` is what the agent reads). `store` remembers the acknowledgement at session, project, bot or global scope as one of the offered `storeOptions`; prompt-created project, bot and global acks last 7 days. A block and a policy denial are never put here. When the prompt was also an ask (a combined prompt), the same answer settles both.",
+        })
+            .input(authorization.ackAnswerInput)
+            .output(authorization.ackAnswerOutput),
+    },
+    resident: {
+        set: rpc("session", "resident/set", { summary: "Mark the session resident (kept alive) or not" })
+            .input(shapes.residentSetInput)
+            .output(shapes.residentSetOutput),
+    },
+    queue: {
+        steerFirst: rpc("session", "queue/steer-first", {
+            summary: "Promote the first queued prompt to a steer",
+            description: "A queued row named by the id the client saw. Already drained or moved is `ok: false`.",
+        })
+            .input(shapes.queueRowInput)
+            .output(shapes.queueRowOutput),
+        retractLast: rpc("session", "queue/retract-last", {
+            summary: "Retract the last queued prompt",
+            description: "A queued row named by the id the client saw. Already drained or moved is `ok: false`.",
+        })
+            .input(shapes.queueRowInput)
+            .output(shapes.queueRowOutput),
+    },
+    agentCalls: {
+        list: rpc("session", "agent-calls/list", { summary: "List agent calls made from this session" })
+            .input(shapes.agentCallsListInput)
+            .output(shapes.agentCallsListOutput),
+        inspect: rpc("session", "agent-calls/inspect", { summary: "Inspect one agent call by request id" })
+            .input(shapes.agentCallsInspectInput)
+            .output(shapes.agentCallsInspectOutput),
+        cancel: rpc("session", "agent-calls/cancel", { summary: "Cancel one agent call by request id" })
+            .input(shapes.agentCallsCancelInput)
+            .output(shapes.agentCallsCancelOutput),
+    },
+};
+const kernel = {
+    termContinue: {
+        set: rpc("kernel", "term-continue/set", { summary: "Remember which session a terminal key continues" })
+            .input(shapes.termContinueSetInput)
+            .output(shapes.termContinueOutput),
+        clear: rpc("kernel", "term-continue/clear", { summary: "Forget a terminal key's continue session" })
+            .input(shapes.termContinueClearInput)
+            .output(shapes.termContinueOutput),
+    },
+    connect: {
+        drop: rpc("kernel", "connect/drop", {
+            summary: "Remove a connection and its secrets",
+            description: "Without `confirm: true` it parks on a confirmation form; cancelling answers `{ok: false}`.",
+            mayPark: true,
+        })
+            .input(shapes.connectDropInput)
+            .output(parks(shapes.connectDropOutput)),
+        adopt: rpc("kernel", "connect/adopt", {
+            summary: "Adopt a connection from a driver",
+            description: "Runs the driver's adopt flow. The flow may need the human (sign-in, a pasted key) and then parks. Cancelling answers `{ok: false}`.",
+            mayPark: true,
+        })
+            .input(shapes.connectAdoptInput)
+            .output(parks(shapes.connectAdoptOutput)),
+        list: rpc("kernel", "connect/list", { summary: "List connections, optionally by ability claim" })
+            .input(connection.listConnectionsInput)
+            .output(connection.listConnectionsOutput),
+        models: rpc("kernel", "connect/models", { summary: "Probe the model catalog of one or all connections" })
+            .input(connection.connectModelsInput)
+            .output(connection.connectModelsOutput),
+        get: rpc("kernel", "connect/get", { summary: "Read one connection with its settings" })
+            .input(connection.getConnectionInput)
+            .output(connection.getConnectionOutput),
+        setEnabled: rpc("kernel", "connect/set-enabled", { summary: "Enable or disable a connection" })
+            .input(connection.setEnabledInput)
+            .output(connection.setEnabledOutput),
+        alwaysAllow: rpc("kernel", "connect/always-allow", { summary: "Always allow one tool of a connection" })
+            .input(connection.persistToolInput)
+            .output(connection.persistToolOutput),
+        excludeTool: rpc("kernel", "connect/exclude-tool", { summary: "Exclude one tool of a connection" })
+            .input(connection.persistToolInput)
+            .output(connection.persistToolOutput),
+        login: rpc("kernel", "connect/login", {
+            summary: "Sign in to a connection",
+            description: "May open a browser flow and park until the human finishes it.",
+            mayPark: true,
+        })
+            .input(connection.loginInput)
+            .output(parks(connection.loginOutput)),
+        logout: rpc("kernel", "connect/logout", { summary: "Sign out of a connection" })
+            .input(connection.logoutInput)
+            .output(connection.logoutOutput),
+        update: rpc("kernel", "connect/update", {
+            summary: "Rename a connection or merge its settings",
+            description: "Rename or merge settings of a connection that already exists. The id stays.",
+        })
+            .input(shapes.connectUpdateInput)
+            .output(shapes.connectUpdateOutput),
+    },
+    mcpServer: {
+        adopt: rpc("kernel", "mcp-server/adopt", {
+            summary: "Adopt an MCP server as a connection",
+            description: "May need the human (sign-in) and then parks.",
+            mayPark: true,
+        })
+            .input(shapes.mcpServerAdoptInput)
+            .output(parks(shapes.mcpServerAdoptOutput)),
+        search: rpc("kernel", "mcp-server/search", { summary: "Search the official MCP registry" })
+            .input(shapes.mcpServerSearchInput)
+            .output(shapes.mcpServerSearchOutput),
+    },
+    config: {
+        set: rpc("kernel", "config/set", { summary: "Set kernel configuration fields" })
+            .input(shapes.configSetInput)
+            .output(shapes.configSetOutput),
+    },
+    grant: {
+        list: rpc("kernel", "grant/list", { summary: "List stored grants" })
+            .input(authorization.grantListInput)
+            .output(authorization.grantListOutput),
+        add: rpc("kernel", "grant/add", {
+            summary: "Store a grant from settings",
+            description: "A grant turns an ask into allow for a family (a command, a path, an MCP server+tool+account). It never lifts a soft-deny or a block. Settings grants do not expire unless `ttlMs` is given.",
+        })
+            .input(authorization.grantAddInput)
+            .output(authorization.grantAddOutput),
+        revoke: rpc("kernel", "grant/revoke", { summary: "Revoke a stored grant" })
+            .input(authorization.grantRevokeInput)
+            .output(authorization.grantRevokeOutput),
+    },
+    ack: {
+        list: rpc("kernel", "ack/list", {
+            summary: "List stored acknowledgements",
+            description: "The acknowledgements a person stored at session, project, bot or global scope (same rows, TTL and scopes as grants). Flags themselves live in the `authorization` block (see `policy/config-get`).",
+        })
+            .input(authorization.ackListInput)
+            .output(authorization.ackListOutput),
+        add: rpc("kernel", "ack/add", {
+            summary: "Store an acknowledgement from settings",
+            description: 'Equivalent to "you can send any email you want in this project". Settings acknowledgements do not expire unless `ttlMs` is given.',
+        })
+            .input(authorization.ackAddInput)
+            .output(authorization.ackAddOutput),
+        revoke: rpc("kernel", "ack/revoke", { summary: "Revoke a stored acknowledgement" })
+            .input(authorization.ackRevokeInput)
+            .output(authorization.ackRevokeOutput),
+    },
+    plugin: {
+        set: rpc("kernel", "plugin/set", { summary: "Enable, disable or foreground a plugin" })
+            .input(shapes.pluginSetInput)
+            .output(shapes.pluginSetOutput),
+        install: rpc("kernel", "plugin/install", { summary: "Install a plugin from an npm spec" })
+            .input(shapes.pluginInstallInput)
+            .output(shapes.pluginInstallOutput),
+        remove: rpc("kernel", "plugin/remove", { summary: "Remove an installed plugin" })
+            .input(shapes.pluginRemoveInput)
+            .output(shapes.pluginRemoveOutput),
+    },
+    skill: {
+        list: rpc("kernel", "skill/list", { summary: "List skill files for a project and home" })
+            .input(shapes.skillListInput)
+            .output(shapes.skillListOutput),
+        write: rpc("kernel", "skill/write", { summary: "Write a skill file" })
+            .input(shapes.skillWriteInput)
+            .output(shapes.skillWriteOutput),
+        remove: rpc("kernel", "skill/remove", { summary: "Remove a skill file" })
+            .input(shapes.skillRemoveInput)
+            .output(shapes.skillRemoveOutput),
+        read: rpc("kernel", "skill/read", { summary: "Read a skill file with its body" })
+            .input(shapes.skillReadInput)
+            .output(shapes.skillReadOutput),
+    },
+    bot: {
+        write: rpc("kernel", "bot/write", {
+            summary: "Write a bot definition",
+            description: "Absent `invokes`, `reasoningEffort` and `modelPreferences` keep the file's current value; an empty list clears. Absent `mcp` keeps the file's grants; an empty list clears them. A settings save that does not know these fields must not wipe them.",
+        })
+            .input(shapes.botWriteInput)
+            .output(shapes.botWriteOutput),
+        remove: rpc("kernel", "bot/remove", { summary: "Remove a bot definition" })
+            .input(shapes.botRemoveInput)
+            .output(shapes.botRemoveOutput),
+    },
+};
+const common = {
+    resolve: rpc("any", "ui/resolve", {
+        summary: "Answer a parked UI form",
+        description: 'Finishes a call that answered `{form: "ui", pending, body}`. The reply is the resumed call\'s result, or another park form. `kind: "cancel"` aborts the parked call. Closing the socket cancels every park it owns.',
+    })
+        .input(uiResolveInput)
+        .output(z.record(z.string(), z.unknown())),
+};
+/**
+ * The daemon's RPC contract, grouped by host and namespace. The tree is for
+ * callers; the JSON-RPC wire name of each procedure is `meta.method`.
+ * `turn` is `session.turn.send`: the namespace and the bare method share a name.
+ */
+export const contract = { session, kernel, ui: common };
+/** Every procedure of a router with its tree path, in declaration order. */
+export function listProcedures(router = contract, path = []) {
+    if (isContractProcedure(router)) {
+        return [{ path, procedure: router, meta: router["~orpc"].meta }];
+    }
+    return Object.entries(router).flatMap(([key, child]) => listProcedures(child, [...path, key]));
+}
+/** The wire name of a procedure. */
+export function methodOf(procedure) {
+    return procedure["~orpc"].meta.method;
+}
+/** Wire name for a tree path (`["session","kv","set"]` is `kv/set`), or `undefined` for an unknown path. */
+export function methodForPath(path) {
+    let node = contract;
+    for (const key of path) {
+        if (typeof node !== "object" || node === null || !Object.hasOwn(node, key))
+            return undefined;
+        node = node[key];
+    }
+    return isContractProcedure(node) ? node["~orpc"].meta.method : undefined;
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./contract.js";
+export * from "./jsonrpc.js";
+export * from "./schemas/authorization.js";
+export * from "./schemas/connection.js";
+export * from "./schemas/rpc.js";
+export * from "./schemas/shapes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./contract.js";
+export * from "./jsonrpc.js";
+export * from "./schemas/authorization.js";
+export * from "./schemas/connection.js";
+export * from "./schemas/rpc.js";
+export * from "./schemas/shapes.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,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/jsonrpc.d.ts

@@ -0,0 +1,18 @@
+import { type JsonRpcId } from "./schemas/rpc.js";
+export declare const JSON_RPC_VERSION: "2.0";
+export declare const JSON_RPC_PARSE_ERROR = -32700;
+export declare const JSON_RPC_INVALID_REQUEST = -32600;
+export declare const JSON_RPC_METHOD_NOT_FOUND = -32601;
+export declare const JSON_RPC_INVALID_PARAMS = -32602;
+export declare const JSON_RPC_INTERNAL_ERROR = -32603;
+/** JSON-RPC error on a Client waiter. Transport loss is a plain Error. */
+export declare class RpcClientError extends Error {
+    readonly code: number;
+    constructor(code: number, message: string);
+}
+/** Method-not-found / invalid-params: do not treat as a socket drop. */
+export declare function isRpcContractError(error: unknown): boolean;
+export declare function encodeJsonRpcRequest(id: string | number, method: string, params?: unknown): string;
+export declare function encodeJsonRpcResult(id: JsonRpcId, result: unknown): string;
+export declare function encodeJsonRpcError(id: JsonRpcId, code: number, message: string, data?: unknown): string;
+//# sourceMappingURL=jsonrpc.d.ts.map

package/dist/jsonrpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../src/jsonrpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,eAAO,MAAM,gBAAgB,EAAG,KAAc,CAAC;AAC/C,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAC5C,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAChD,eAAO,MAAM,yBAAyB,SAAU,CAAC;AACjD,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAC/C,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,0EAA0E;AAC1E,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAY,GAAG,MAAM,CAEtG;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAE1E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAMvG"}

package/dist/jsonrpc.js

@@ -0,0 +1,34 @@
+export const JSON_RPC_VERSION = "2.0";
+export const JSON_RPC_PARSE_ERROR = -32_700;
+export const JSON_RPC_INVALID_REQUEST = -32_600;
+export const JSON_RPC_METHOD_NOT_FOUND = -32_601;
+export const JSON_RPC_INVALID_PARAMS = -32_602;
+export const JSON_RPC_INTERNAL_ERROR = -32_603;
+/** JSON-RPC error on a Client waiter. Transport loss is a plain Error. */
+export class RpcClientError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "RpcClientError";
+        this.code = code;
+    }
+}
+/** Method-not-found / invalid-params: do not treat as a socket drop. */
+export function isRpcContractError(error) {
+    return (error instanceof RpcClientError &&
+        (error.code === JSON_RPC_METHOD_NOT_FOUND || error.code === JSON_RPC_INVALID_PARAMS));
+}
+export function encodeJsonRpcRequest(id, method, params = {}) {
+    return JSON.stringify({ jsonrpc: JSON_RPC_VERSION, id, method, params });
+}
+export function encodeJsonRpcResult(id, result) {
+    return JSON.stringify({ jsonrpc: JSON_RPC_VERSION, id, result });
+}
+export function encodeJsonRpcError(id, code, message, data) {
+    return JSON.stringify({
+        jsonrpc: JSON_RPC_VERSION,
+        id,
+        error: data === undefined ? { code, message } : { code, message, data },
+    });
+}
+//# sourceMappingURL=jsonrpc.js.map

package/dist/jsonrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../src/jsonrpc.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAc,CAAC;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAM,CAAC;AAChD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAAM,CAAC;AACjD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAM,CAAC;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAM,CAAC;AAE/C,0EAA0E;AAC1E,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,CACL,KAAK,YAAY,cAAc;QAC/B,CAAC,KAAK,CAAC,IAAI,KAAK,yBAAyB,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,CAAC,CACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAmB,EAAE,MAAc,EAAE,SAAkB,EAAE;IAC5F,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAa,EAAE,MAAe;IAChE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAa,EAAE,IAAY,EAAE,OAAe,EAAE,IAAc;IAC7F,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE,gBAAgB;QACzB,EAAE;QACF,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KACxE,CAAC,CAAC;AACL,CAAC"}