@openscout/protocol 0.2.63 → 0.2.82

package/dist/terminal-workspaces.d.ts.map

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

package/dist/terminal-workspaces.js

@@ -0,0 +1,287 @@
+/**
+ * Durable terminal workspaces.
+ *
+ * A workspace is a named, server-owned arrangement of agent-CLI tiles. It is
+ * the Scout object the three clients had each invented privately —
+ * `openscout.terminal.workspaces.v1` in localStorage,
+ * `scout.terminals.workspaces.v1` in UserDefaults, and nothing at all on iOS —
+ * with the same version number, the same idea, and no synchronization.
+ *
+ * Where this stands TODAY, so nobody reads more into it than is built: the web
+ * client treats the record as its source of truth, seeding its deck from it and
+ * writing changes back. macOS still keeps its own UserDefaults store and has no
+ * reference to `/api/terminal-workspaces`, and iOS has nothing. "One workspace
+ * on all three clients" is the direction this type exists to make possible, not
+ * something it has delivered; the other two clients follow.
+ *
+ * The load-bearing design decision is that a cell stores INTENT, not just a
+ * binding. A saved cell that only remembers "tmux session scout-tmux-cell-7"
+ * is worth nothing after a reboot: tmux is empty and the name resolves to
+ * nothing. A cell that also remembers which host to use, what directory, and
+ * how to resume the harness can be rebuilt. This is the same conclusion
+ * tmux-resurrect/continuum reached — persist intent and replay it, never
+ * process state — and what macOS's `restoreCommandLine` already does in a
+ * cruder form.
+ */
+import { terminalSurfaceMatchesId, terminalSurfaceNodeId, terminalSurfaceNodeScopeMatches, } from "./terminal-sessions.js";
+import { parseTerminalSurfaceId } from "./terminal-surface-id.js";
+/** Highest column count a workspace may reopen with. */
+export const TERMINAL_WORKSPACE_MAX_COLUMNS = 6;
+export const TERMINAL_WORKSPACE_DEFAULT_COLUMNS = 2;
+/**
+ * The layout a workspace should open with, folding a pre-layout record forward.
+ *
+ * A record written before layouts existed carries only a column count, so the
+ * mode is inferred from how that count relates to the cells: one cell is solo,
+ * a count that fits every cell on one row is lanes, anything else was a grid.
+ */
+export function terminalWorkspaceLayoutOf(input) {
+    if (input.layout?.mode) {
+        return {
+            mode: input.layout.mode,
+            ...(input.layout.columns === undefined ? {} : { columns: normalizeTerminalWorkspaceColumnCount(input.layout.columns) }),
+        };
+    }
+    const cellCount = input.cellCount ?? 0;
+    const columns = normalizeTerminalWorkspaceColumns(input.columns ?? TERMINAL_WORKSPACE_DEFAULT_COLUMNS);
+    if (cellCount <= 1)
+        return { mode: "solo" };
+    if (columns >= cellCount)
+        return { mode: "lanes", columns };
+    return { mode: "grid", columns };
+}
+/**
+ * Column count to render with.
+ *
+ * Solo is always one. A dynamic lane count is the tile count, so every tile
+ * gets its own lane; a dynamic grid is the squarest arrangement that holds
+ * them. Both clamp, because past a handful of columns a terminal is too narrow
+ * to read.
+ */
+export function resolveTerminalWorkspaceColumns(layout, input) {
+    const tileCount = Math.max(1, Math.floor(input.tileCount) || 1);
+    if (layout.mode === "solo")
+        return 1;
+    if (layout.columns === undefined || layout.columns === "dynamic") {
+        const dynamic = layout.mode === "lanes" ? tileCount : Math.ceil(Math.sqrt(tileCount));
+        return Math.max(1, Math.min(TERMINAL_WORKSPACE_MAX_COLUMNS, dynamic));
+    }
+    return normalizeTerminalWorkspaceColumns(layout.columns);
+}
+export function normalizeTerminalWorkspaceColumnCount(value) {
+    return value === "dynamic" ? "dynamic" : normalizeTerminalWorkspaceColumns(value);
+}
+/**
+ * Read a stored `layout_json` column back, or null when there is nothing
+ * trustworthy in it.
+ *
+ * Every store that persists a workspace decodes the layout through this, and
+ * that is the point: `layout_json` was added to the schema and then read by one
+ * handle and ignored by the other, so a layout written through the web server
+ * came back as `null` through the runtime store. One decoder means one answer.
+ *
+ * The mode is validated rather than trusted. It flows straight into the
+ * client's grid resolver, so a value that is not one of the three shapes must
+ * become "no stored layout" — which folds forward from the column count — and
+ * not a mode nothing can render.
+ */
+export function parseTerminalWorkspaceLayoutJson(value) {
+    if (!value)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object")
+        return null;
+    const candidate = parsed;
+    const mode = candidate.mode;
+    if (mode !== "solo" && mode !== "lanes" && mode !== "grid")
+        return null;
+    return {
+        mode,
+        ...(candidate.columns === undefined
+            ? {}
+            : { columns: normalizeTerminalWorkspaceColumnCount(candidate.columns) }),
+    };
+}
+export function terminalWorkspaceLayoutLabel(layout) {
+    if (layout.mode === "solo")
+        return "Solo";
+    const shape = layout.mode === "lanes" ? "Lanes" : "Grid";
+    return layout.columns === undefined || layout.columns === "dynamic"
+        ? `${shape} · dynamic`
+        : `${shape} · ${layout.columns} column${layout.columns === 1 ? "" : "s"}`;
+}
+/**
+ * Map every saved cell to a live surface, a restorable-but-dead one, or an
+ * unavailable one.
+ *
+ * This is the only honest answer to a reboot. tmux and zellij sessions do not
+ * survive a restart; a workspace that stored intent can rebuild itself, and one
+ * that stored only a session name cannot. Judgement lives here, on the server
+ * side of the wire, so all three clients inherit the same answer instead of
+ * each re-deriving it — and it never fabricates a record: a cell with nothing
+ * to rebuild from reports `unavailable` and says why.
+ */
+export function reconcileTerminalWorkspace(workspace, input) {
+    const cells = workspace.cells.map((cell) => resolveTerminalWorkspaceCell(cell, input));
+    return {
+        workspaceId: workspace.id,
+        cells,
+        liveCount: cells.filter((cell) => cell.status === "live").length,
+        revivableCount: cells.filter((cell) => cell.status === "revivable").length,
+        unavailableCount: cells.filter((cell) => cell.status === "unavailable").length,
+    };
+}
+function resolveTerminalWorkspaceCell(cell, input) {
+    const live = findLiveSurface(cell, input.sessions, input.localNodeId?.trim() || null);
+    if (live) {
+        return {
+            cellId: cell.id,
+            status: "live",
+            surfaceId: live.surface.surfaceId ?? cell.surfaceId ?? null,
+            terminalSessionId: live.session.id,
+            surface: live.surface,
+            detail: "Running",
+            revive: null,
+        };
+    }
+    const hostId = cell.intent.hostId ?? input.defaultHostId ?? null;
+    const sessionName = cell.intent.sessionName?.trim() || null;
+    if (!hostId || !sessionName) {
+        return unavailable(cell, "This tile was saved without enough detail to reopen it.");
+    }
+    const host = input.hosts.find((candidate) => candidate.id === hostId) ?? null;
+    if (!host) {
+        return unavailable(cell, `This tile needs ${hostId}, which Scout does not know about.`);
+    }
+    if (!host.installed) {
+        return unavailable(cell, `This tile needs ${hostId}, which is not installed here.`);
+    }
+    if (!host.canCreate) {
+        return unavailable(cell, `Scout cannot reopen ${hostId} sessions for you; open it there and come back.`);
+    }
+    return {
+        cellId: cell.id,
+        status: "revivable",
+        surfaceId: cell.surfaceId ?? null,
+        terminalSessionId: cell.terminalSessionId ?? null,
+        surface: null,
+        detail: "Not running. Scout can start it again.",
+        revive: {
+            hostId,
+            sessionName,
+            cwd: cell.intent.cwd?.trim() || null,
+            resumeCommand: cell.intent.resumeCommand?.trim() || null,
+        },
+    };
+}
+function unavailable(cell, detail) {
+    return {
+        cellId: cell.id,
+        status: "unavailable",
+        surfaceId: cell.surfaceId ?? null,
+        terminalSessionId: cell.terminalSessionId ?? null,
+        surface: null,
+        detail,
+        revive: null,
+    };
+}
+/**
+ * Whether a record is an OBSERVATION of the host rather than something Scout
+ * wrote down once. Only an observation can prove a surface is running.
+ */
+function isHostObservedRecord(session) {
+    // `metadata.registryState` is the pre-`origin` signal; both are honoured
+    // until every writer has moved over.
+    return session.origin === "discovered" || session.metadata?.registryState === "discovered";
+}
+/**
+ * A cell binds to a live surface by durable handle first. The intent's session
+ * name is the fallback, because a surface re-created under the same name on the
+ * same host IS the tile's session — that is the whole point of stable per-cell
+ * names — while a record id is not enough on its own, since ids move when a
+ * discovered session is renamed.
+ *
+ * Two rules make the answer an observation instead of a memory, and a review
+ * reproduced what happens without them.
+ *
+ * Only a host-observed record can establish "live". A registry record is
+ * written once, at intake, with `state: "live"` baked in, and it is never
+ * updated again — so after a reboot every saved tile still resolved to
+ * `{status: "live", detail: "Running"}` against a host that had nothing on it.
+ * Scout was reporting its own filing cabinet back to the operator as the state
+ * of their machine.
+ *
+ * And only `state === "live"` counts. `detached` means different things per
+ * host — for tmux it is a running session with no client, for herdr it is a
+ * session whose server is STOPPED — so accepting "anything but exited" reported
+ * stopped herdr sessions as running. Hosts that stay attachable while detached
+ * report `live` from their adapter, so requiring it costs nothing and stops
+ * that.
+ *
+ * When an observation is found, the registry record for the same surface is
+ * preferred as the cell's record: it carries the harness and resume command a
+ * discovered record cannot know. The SURFACE always comes from the observation,
+ * because that is the one with the current state.
+ *
+ * The third rule is that a machine only speaks for itself. The name fallback is
+ * matched under the same node scoping as the handle, because otherwise it
+ * quietly reopened the hole the handle matcher closed: a cell scoped to `node-b`
+ * whose intent named `scout-tmux-cell-1` bound to THIS host's session of that
+ * name, so `node-a` and `node-b` both reported the one discovered session
+ * Running. One observed session never proves more than one node's workspace
+ * live.
+ */
+function findLiveSurface(cell, sessions, localNodeId) {
+    const observedSessions = sessions.filter(isHostObservedRecord);
+    const handle = cell.surfaceId?.trim() || null;
+    const sessionName = cell.intent.sessionName?.trim() || null;
+    const hostId = cell.intent.hostId ?? null;
+    // The cell's node is whatever its durable handle names; a cell with only an
+    // intent names no machine and keeps matching wherever it lands.
+    const cellNodeId = parseTerminalSurfaceId(handle)?.nodeId ?? null;
+    const matches = (surface) => {
+        if (surface.state !== "live")
+            return false;
+        if (handle && terminalSurfaceMatchesId(surface, handle, { localNodeId }))
+            return true;
+        if (!sessionName || surface.sessionName !== sessionName)
+            return false;
+        if (hostId && surface.backend !== hostId)
+            return false;
+        return terminalSurfaceNodeScopeMatches({
+            handleNodeId: cellNodeId,
+            surfaceNodeId: terminalSurfaceNodeId(surface),
+            localNodeId,
+        });
+    };
+    for (const session of observedSessions) {
+        const surface = session.surfaces.find(matches);
+        if (!surface)
+            continue;
+        // Under the same node rule: a registry record from another machine that
+        // happens to hold this session name is not the identity of the session
+        // observed here, and lending it would put a foreign record id on a local
+        // surface.
+        const registryRecord = sessions.find((candidate) => !isHostObservedRecord(candidate)
+            && candidate.surfaces.some((known) => known.backend === surface.backend
+                && known.sessionName === surface.sessionName
+                && terminalSurfaceNodeScopeMatches({
+                    handleNodeId: terminalSurfaceNodeId(known),
+                    surfaceNodeId: terminalSurfaceNodeId(surface),
+                    localNodeId,
+                })));
+        return { session: registryRecord ?? session, surface };
+    }
+    return null;
+}
+export function normalizeTerminalWorkspaceColumns(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return TERMINAL_WORKSPACE_DEFAULT_COLUMNS;
+    return Math.max(1, Math.min(TERMINAL_WORKSPACE_MAX_COLUMNS, Math.floor(value)));
+}

package/dist/thread-events.d.ts

@@ -142,3 +142,4 @@ export interface ThreadWatchError {
     code: "no_responder" | "forbidden" | "unknown_conversation" | "lease_expired" | "cursor_out_of_range" | "invalid_request" | "internal";
     message: string;
 }
+//# sourceMappingURL=thread-events.d.ts.map

package/dist/thread-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-events.d.ts","sourceRoot":"","sources":["../src/thread-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,gBAAgB,GAChB,wBAAwB,GACxB,8BAA8B,GAC9B,qBAAqB,GACrB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,cAAc,GACd,WAAW,GACX,kBAAkB,GAClB,eAAe,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,+BAA+B;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,aAAa,GAAG,oBAAoB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,GAAG,mBAAmB,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,mBAAmB,GAAG,0BAA0B,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,EAAE,kBAAkB,GAAG,+BAA+B,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB,mBAAmB,GACnB,0BAA0B,GAC1B,+BAA+B,GAC/B,sBAAsB,GACtB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,kBAAkB,CAAC;IAC5B,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,oBAAoB,CAAC;AACzE,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,GAAG,0BAA0B,CAAC;AAC3F,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,sBAAsB,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC9C,aAAa,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EACA,cAAc,GACd,WAAW,GACX,sBAAsB,GACtB,eAAe,GACf,qBAAqB,GACrB,iBAAiB,GACjB,UAAU,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/time.d.ts

@@ -0,0 +1,16 @@
+declare const epochMsBrand: unique symbol;
+declare const durationMsBrand: unique symbol;
+export type EpochMs = number & {
+    readonly [epochMsBrand]: "EpochMs";
+};
+export type DurationMs = number & {
+    readonly [durationMsBrand]: "DurationMs";
+};
+export declare const EPOCH_MILLISECONDS_FLOOR = 1000000000000;
+export declare function nowMs(): EpochMs;
+export declare function epochMs(value: unknown): EpochMs | null;
+export declare function epochMsFromSeconds(value: number): EpochMs;
+export declare function durationMs(value: number): DurationMs;
+export declare function toIso(ms: EpochMs): string;
+export {};
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAC1C,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC;AAE7C,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC;AAE/E,eAAO,MAAM,wBAAwB,gBAAoB,CAAC;AAc1D,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAYtD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAEzC"}

package/dist/time.js

@@ -0,0 +1,33 @@
+export const EPOCH_MILLISECONDS_FLOOR = 1_000_000_000_000;
+function isFinitePositive(value) {
+    return Number.isFinite(value) && value > 0;
+}
+function requireFinitePositive(value, label) {
+    if (!isFinitePositive(value)) {
+        throw new RangeError(`${label} must be a finite positive number`);
+    }
+    return value;
+}
+export function nowMs() {
+    return Date.now();
+}
+export function epochMs(value) {
+    const parsed = typeof value === "number"
+        ? value
+        : typeof value === "string"
+            ? Number(value)
+            : null;
+    if (parsed === null || !isFinitePositive(parsed)) {
+        return null;
+    }
+    return Math.trunc(parsed < EPOCH_MILLISECONDS_FLOOR ? parsed * 1000 : parsed);
+}
+export function epochMsFromSeconds(value) {
+    return Math.trunc(requireFinitePositive(value, "Epoch seconds") * 1000);
+}
+export function durationMs(value) {
+    return Math.trunc(requireFinitePositive(value, "Duration milliseconds"));
+}
+export function toIso(ms) {
+    return new Date(ms).toISOString();
+}

package/dist/transports.d.ts

@@ -64,3 +64,4 @@ export interface CollaborationEventAppendCommand {
     event: CollaborationEvent;
 }
 export type ControlCommand = NodeUpsertCommand | ActorUpsertCommand | AgentUpsertCommand | AgentEndpointUpsertCommand | ConversationUpsertCommand | BindingUpsertCommand | CollaborationUpsertCommand | CollaborationEventAppendCommand | PostMessageCommand | InvokeAgentCommand | EnsureAwakeCommand | SubscribeCommand;
+//# sourceMappingURL=transports.d.ts.map

package/dist/transports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../src/transports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,EAAE,mBAAmB,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC,iBAAiB,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,YAAY,EAAE,sBAAsB,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,4BAA4B,CAAC;IACnC,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,0BAA0B,GAC1B,yBAAyB,GACzB,oBAAoB,GACpB,0BAA0B,GAC1B,+BAA+B,GAC/B,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,CAAC"}

package/package.json

@@ -1,31 +1,59 @@
 {
   "name": "@openscout/protocol",
-  "version": "0.2.63",
+  "version": "0.2.82",
   "description": "Typed protocol for the OpenScout local control plane",
+  "license": "Apache-2.0",
   "type": "module",
+  "author": "Arach Tchoupani",
+  "homepage": "https://github.com/oscout/scout/tree/main/packages/protocol#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oscout/scout.git",
+    "directory": "packages/protocol"
+  },
+  "bugs": {
+    "url": "https://github.com/oscout/scout/issues"
+  },
+  "keywords": [
+    "openscout",
+    "protocol",
+    "agents",
+    "broker",
+    "control-plane",
+    "a2a",
+    "typescript"
+  ],
+  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./src/index.ts",
       "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
       "default": "./dist/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
-  "types": "./src/index.ts",
+  "types": "./dist/index.d.ts",
   "files": [
-    "src",
     "dist",
-    "README.md"
+    "src",
+    "!src/**/*.test.ts",
+    "README.md",
+    "LICENSE"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
+    "prebuild": "bun ../../scripts/generate-runtime-catalog.ts",
     "build": "rm -rf dist && tsc -p tsconfig.json",
+    "precheck": "bun ../../scripts/generate-runtime-catalog.ts",
     "check": "tsc --noEmit -p tsconfig.json",
     "test": "bun test src/*.test.ts",
     "prepack": "npm run build && node ../../scripts/prepare-publish-manifest.mjs .",
+    "postpack": "node ../../scripts/restore-publish-manifest.mjs .",
     "postpublish": "node ../../scripts/restore-publish-manifest.mjs ."
   },
-  "publishConfig": {
-    "access": "public"
-  },
   "devDependencies": {
     "typescript": "^5"
   }