@allin-ai/agent-client 0.1.0

package/dist/client/transport.d.ts

@@ -0,0 +1,30 @@
+import type { ClientCommand, ClientEvent, PluginConfig, PluginSyncAcknowledgement } from "./types.js";
+export type ClientTransportHandlers = {
+    command(command: ClientCommand): Promise<void>;
+    /** Desired Git plugin state; the plugin host is added in a later task. */
+    pluginSync?(input: {
+        revision: string;
+        plugins: PluginConfig[];
+    }): Promise<void>;
+    connected(): Promise<void>;
+};
+/**
+ * Connection boundary between the durable Client Core and a Hub protocol
+ * implementation. Transports deliver at least once; the state store supplies
+ * the local idempotency and the per-execution event outbox.
+ */
+export type ClientTransport = {
+    connect(handlers: ClientTransportHandlers): Promise<void>;
+    push(events: ClientEvent[]): Promise<Record<string, number>>;
+    /** Optional while older Hubs ignore plugin desired-state acknowledgements. */
+    reportPluginSync?(acknowledgement: PluginSyncAcknowledgement): Promise<void>;
+    close(): Promise<void>;
+};
+/** The isolated runtime runner port. It must never be used for capabilities. */
+export type RunStarter = {
+    start(command: Extract<ClientCommand, {
+        kind: "agent.run";
+    }>): Promise<void>;
+    cancel(executionId: string): Promise<void>;
+};
+//# sourceMappingURL=transport.d.ts.map

package/dist/client/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,0EAA0E;IAC1E,UAAU,CAAC,CAAC,KAAK,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,YAAY,EAAE,CAAC;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,8EAA8E;IAC9E,gBAAgB,CAAC,CAAC,eAAe,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C,CAAC"}

package/dist/client/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/client/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":""}

package/dist/client/types.d.ts

@@ -0,0 +1,65 @@
+import type { PluginConfig as GitPluginConfig } from "../plugins/types.js";
+export declare const CLIENT_RUNTIME_IDS: readonly ["codex", "claude", "pi", "zcode"];
+export type RuntimeId = (typeof CLIENT_RUNTIME_IDS)[number];
+/** Structured input passed to a platform adapter; runtime-specific validation is adapter-owned. */
+export type AgentInput = Record<string, unknown>;
+export type ClientCommand = {
+    kind: "agent.run";
+    commandId: string;
+    executionId: string;
+    taskId: string;
+    attempt: number;
+    runtime: RuntimeId;
+    payload: AgentInput;
+} | {
+    kind: "capability.invoke";
+    commandId: string;
+    executionId: string;
+    taskId: string;
+    attempt: number;
+    capabilityId: string;
+    input: Record<string, unknown>;
+} | {
+    kind: "cancel";
+    commandId: string;
+    executionId: string;
+};
+export declare const CLIENT_EVENT_TYPES: readonly ["received", "running", "awaiting_approval", "progress", "done", "failed", "cancelled", "recovery_required", "rejected"];
+export type ClientEventType = (typeof CLIENT_EVENT_TYPES)[number];
+export type ClientEvent = {
+    executionId: string;
+    eventSeq: number;
+    type: ClientEventType;
+    payload?: Record<string, unknown>;
+    occurredAt: string;
+};
+export type ClientEventBatch = {
+    type: "event.push";
+    events: ClientEvent[];
+};
+/** Hub desired plugin state is shared with the local Git installer. */
+export type PluginConfig = GitPluginConfig;
+export type HubDownlink = {
+    type: "task.offer";
+    command: ClientCommand;
+} | {
+    type: "plugin.sync";
+    revision: string;
+    plugins: PluginConfig[];
+};
+export type PluginSyncStatus = "applied" | "already_applied" | "failed";
+/** Local acknowledgement of a desired-state revision; it never carries a pluginSet task field. */
+export type PluginSyncAcknowledgement = {
+    type: "plugin.sync.ack";
+    revision: string;
+    status: PluginSyncStatus;
+    plugins: Array<{
+        id: string;
+        resolvedCommit: string;
+    }>;
+    error?: {
+        code: "plugin_sync_failed";
+        message: string;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3E,eAAO,MAAM,kBAAkB,6CAA8C,CAAC;AAE9E,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,mGAAmG;AACnG,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;CACrB,GACD;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,eAAO,MAAM,kBAAkB,mIAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC;AAE3C,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAExE,kGAAkG;AAClG,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC"}

package/dist/client/types.js

@@ -0,0 +1,13 @@
+export const CLIENT_RUNTIME_IDS = ["codex", "claude", "pi", "zcode"];
+export const CLIENT_EVENT_TYPES = [
+    "received",
+    "running",
+    "awaiting_approval",
+    "progress",
+    "done",
+    "failed",
+    "cancelled",
+    "recovery_required",
+    "rejected",
+];
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAU,CAAC;AA4B9E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,UAAU;IACV,SAAS;IACT,mBAAmB;IACnB,UAAU;IACV,MAAM;IACN,QAAQ;IACR,WAAW;IACX,mBAAmB;IACnB,UAAU;CACF,CAAC"}

package/dist/client/wire.d.ts

@@ -0,0 +1,32 @@
+import { type ClientCommand, type ClientEvent, type ClientEventBatch, type HubDownlink, type PluginSyncAcknowledgement } from "./types.js";
+import { AGENT_CLIENT_PROTOCOL_VERSION } from "../wire.js";
+/**
+ * Validates a Hub command before it can be admitted to the local inbox.
+ * The capability branch intentionally has no arbitrary command/argv/shell
+ * escape hatch: the installed capability chooses its fixed entrypoint.
+ */
+export declare function parseClientCommand(value: unknown): ClientCommand | null;
+/** Parses the only v2 event uplink envelope accepted by a Hub. */
+export declare function parseClientEventBatch(value: unknown): ClientEvent[] | null;
+/** Validates and shapes an event batch before a transport serializes it. */
+export declare function encodeClientEventBatch(events: ClientEvent[]): ClientEventBatch;
+export type ClientHello = {
+    type: "client.hello";
+    protocolVersion: typeof AGENT_CLIENT_PROTOCOL_VERSION;
+    clientId: string;
+};
+export type HubEventAcknowledgement = {
+    type: "event.ack";
+    watermarks: Record<string, number>;
+};
+/** Strictly validates the plugin desired-state acknowledgement emitted by a Client. */
+export declare function parsePluginSyncAcknowledgement(value: unknown): PluginSyncAcknowledgement | null;
+export declare function encodePluginSyncAcknowledgement(value: PluginSyncAcknowledgement): PluginSyncAcknowledgement;
+/** Only protocol-v2 clients may open a v2 Hub connection. */
+export declare function parseClientHello(value: unknown): ClientHello | null;
+export declare function encodeClientHello(clientId: string): ClientHello;
+/** Parses a validated v2 Hub command before it reaches local execution code. */
+export declare function parseHubDownlink(value: unknown): HubDownlink | null;
+/** Parses the acknowledgement envelope paired with one `event.push` batch. */
+export declare function parseHubEventAcknowledgement(value: unknown): HubEventAcknowledgement | null;
+//# sourceMappingURL=wire.d.ts.map

package/dist/client/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/client/wire.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAErB,KAAK,WAAW,EAEhB,KAAK,yBAAyB,EAE/B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AA6E3D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAqFvE;AAwCD,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,GAAG,IAAI,CAiB1E;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,EAAE,GACpB,gBAAgB,CAIlB;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,eAAe,EAAE,OAAO,6BAA6B,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAAC;AAoCF,uFAAuF;AACvF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,yBAAyB,GAAG,IAAI,CAmBlC;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,yBAAyB,GAC/B,yBAAyB,CAI3B;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAenE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAQ/D;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAuBnE;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,uBAAuB,GAAG,IAAI,CAkBhC"}

package/dist/client/wire.js

@@ -0,0 +1,302 @@
+import { CLIENT_EVENT_TYPES, CLIENT_RUNTIME_IDS, } from "./types.js";
+import { AGENT_CLIENT_PROTOCOL_VERSION } from "../wire.js";
+const CAPABILITY_SHELL_FIELDS = ["command", "argv", "shell"];
+function isPlainObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function hasOnlyKeys(value, allowed) {
+    return Object.keys(value).every((key) => allowed.includes(key));
+}
+function isRuntimeId(value) {
+    return (typeof value === "string" && CLIENT_RUNTIME_IDS.includes(value));
+}
+function isClientEventType(value) {
+    return (typeof value === "string" &&
+        CLIENT_EVENT_TYPES.includes(value));
+}
+function isPluginConfig(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, ["id", "gitUrl", "ref", "enabled", "runtimes"]) ||
+        !isNonEmptyString(value.id) ||
+        !isNonEmptyString(value.gitUrl) ||
+        typeof value.enabled !== "boolean") {
+        return false;
+    }
+    if (value.ref !== undefined && !isNonEmptyString(value.ref))
+        return false;
+    return (value.runtimes === undefined ||
+        (Array.isArray(value.runtimes) && value.runtimes.every(isRuntimeId)));
+}
+function hasCapabilityShellField(value, seen = new WeakSet()) {
+    if (!value || typeof value !== "object")
+        return false;
+    if (seen.has(value))
+        return false;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.some((item) => hasCapabilityShellField(item, seen));
+    }
+    if (!isPlainObject(value))
+        return false;
+    return Object.entries(value).some(([key, item]) => CAPABILITY_SHELL_FIELDS.includes(key) || hasCapabilityShellField(item, seen));
+}
+/**
+ * Validates a Hub command before it can be admitted to the local inbox.
+ * The capability branch intentionally has no arbitrary command/argv/shell
+ * escape hatch: the installed capability chooses its fixed entrypoint.
+ */
+export function parseClientCommand(value) {
+    if (!isPlainObject(value) || !isNonEmptyString(value.kind))
+        return null;
+    if (value.kind === "agent.run") {
+        if (!hasOnlyKeys(value, [
+            "kind",
+            "commandId",
+            "executionId",
+            "taskId",
+            "attempt",
+            "runtime",
+            "payload",
+        ]) ||
+            !isNonEmptyString(value.commandId) ||
+            !isNonEmptyString(value.executionId) ||
+            !isNonEmptyString(value.taskId) ||
+            !isNonNegativeInteger(value.attempt) ||
+            !isRuntimeId(value.runtime) ||
+            !isPlainObject(value.payload)) {
+            return null;
+        }
+        return {
+            kind: "agent.run",
+            commandId: value.commandId,
+            executionId: value.executionId,
+            taskId: value.taskId,
+            attempt: value.attempt,
+            runtime: value.runtime,
+            payload: value.payload,
+        };
+    }
+    if (value.kind === "capability.invoke") {
+        if (!hasOnlyKeys(value, [
+            "kind",
+            "commandId",
+            "executionId",
+            "taskId",
+            "attempt",
+            "capabilityId",
+            "input",
+        ]) ||
+            !isNonEmptyString(value.commandId) ||
+            !isNonEmptyString(value.executionId) ||
+            !isNonEmptyString(value.taskId) ||
+            !isNonNegativeInteger(value.attempt) ||
+            !isNonEmptyString(value.capabilityId) ||
+            !isPlainObject(value.input) ||
+            hasCapabilityShellField(value.input)) {
+            return null;
+        }
+        return {
+            kind: "capability.invoke",
+            commandId: value.commandId,
+            executionId: value.executionId,
+            taskId: value.taskId,
+            attempt: value.attempt,
+            capabilityId: value.capabilityId,
+            input: value.input,
+        };
+    }
+    if (value.kind === "cancel") {
+        if (!hasOnlyKeys(value, ["kind", "commandId", "executionId"]) ||
+            !isNonEmptyString(value.commandId) ||
+            !isNonEmptyString(value.executionId)) {
+            return null;
+        }
+        return {
+            kind: "cancel",
+            commandId: value.commandId,
+            executionId: value.executionId,
+        };
+    }
+    return null;
+}
+function parseClientEvent(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, [
+            "executionId",
+            "eventSeq",
+            "type",
+            "payload",
+            "occurredAt",
+        ]) ||
+        !isNonEmptyString(value.executionId) ||
+        !isNonNegativeInteger(value.eventSeq) ||
+        !isClientEventType(value.type) ||
+        !isNonEmptyString(value.occurredAt)) {
+        return null;
+    }
+    const hasPayload = Object.hasOwn(value, "payload");
+    if (hasPayload) {
+        if (!isPlainObject(value.payload))
+            return null;
+        return {
+            executionId: value.executionId,
+            eventSeq: value.eventSeq,
+            type: value.type,
+            payload: value.payload,
+            occurredAt: value.occurredAt,
+        };
+    }
+    return {
+        executionId: value.executionId,
+        eventSeq: value.eventSeq,
+        type: value.type,
+        occurredAt: value.occurredAt,
+    };
+}
+/** Parses the only v2 event uplink envelope accepted by a Hub. */
+export function parseClientEventBatch(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, ["type", "events"]) ||
+        value.type !== "event.push" ||
+        !Array.isArray(value.events)) {
+        return null;
+    }
+    const events = [];
+    for (const event of value.events) {
+        const parsed = parseClientEvent(event);
+        if (!parsed)
+            return null;
+        events.push(parsed);
+    }
+    return events;
+}
+/** Validates and shapes an event batch before a transport serializes it. */
+export function encodeClientEventBatch(events) {
+    const parsed = parseClientEventBatch({ type: "event.push", events });
+    if (!parsed)
+        throw new TypeError("Invalid ClientEvent batch");
+    return { type: "event.push", events: parsed };
+}
+function isPluginSyncAcknowledgement(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, ["type", "revision", "status", "plugins", "error"]) ||
+        value.type !== "plugin.sync.ack" ||
+        !isNonEmptyString(value.revision) ||
+        !["applied", "already_applied", "failed"].includes(value.status) ||
+        !Array.isArray(value.plugins) ||
+        !value.plugins.every((plugin) => isPlainObject(plugin) &&
+            hasOnlyKeys(plugin, ["id", "resolvedCommit"]) &&
+            isNonEmptyString(plugin.id) &&
+            typeof plugin.resolvedCommit === "string" &&
+            /^[0-9a-f]{40}$/i.test(plugin.resolvedCommit))) {
+        return false;
+    }
+    if (value.error === undefined)
+        return value.status !== "failed";
+    return (value.status === "failed" &&
+        isPlainObject(value.error) &&
+        hasOnlyKeys(value.error, ["code", "message"]) &&
+        value.error.code === "plugin_sync_failed" &&
+        isNonEmptyString(value.error.message));
+}
+/** Strictly validates the plugin desired-state acknowledgement emitted by a Client. */
+export function parsePluginSyncAcknowledgement(value) {
+    if (!isPluginSyncAcknowledgement(value))
+        return null;
+    return {
+        type: "plugin.sync.ack",
+        revision: value.revision,
+        status: value.status,
+        plugins: value.plugins.map(({ id, resolvedCommit }) => ({
+            id,
+            resolvedCommit: resolvedCommit.toLowerCase(),
+        })),
+        ...(value.error
+            ? {
+                error: {
+                    code: "plugin_sync_failed",
+                    message: value.error.message,
+                },
+            }
+            : {}),
+    };
+}
+export function encodePluginSyncAcknowledgement(value) {
+    const parsed = parsePluginSyncAcknowledgement(value);
+    if (!parsed)
+        throw new TypeError("Invalid plugin sync acknowledgement");
+    return parsed;
+}
+/** Only protocol-v2 clients may open a v2 Hub connection. */
+export function parseClientHello(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, ["type", "protocolVersion", "clientId"]) ||
+        value.type !== "client.hello" ||
+        value.protocolVersion !== AGENT_CLIENT_PROTOCOL_VERSION ||
+        !isNonEmptyString(value.clientId)) {
+        return null;
+    }
+    return {
+        type: "client.hello",
+        protocolVersion: AGENT_CLIENT_PROTOCOL_VERSION,
+        clientId: value.clientId,
+    };
+}
+export function encodeClientHello(clientId) {
+    const hello = parseClientHello({
+        type: "client.hello",
+        protocolVersion: AGENT_CLIENT_PROTOCOL_VERSION,
+        clientId,
+    });
+    if (!hello)
+        throw new TypeError("Client id must be a non-empty string");
+    return hello;
+}
+/** Parses a validated v2 Hub command before it reaches local execution code. */
+export function parseHubDownlink(value) {
+    if (!isPlainObject(value) || !isNonEmptyString(value.type))
+        return null;
+    if (value.type === "task.offer" && hasOnlyKeys(value, ["type", "command"])) {
+        const command = parseClientCommand(value.command);
+        return command ? { type: "task.offer", command } : null;
+    }
+    if (value.type === "plugin.sync" &&
+        hasOnlyKeys(value, ["type", "revision", "plugins"]) &&
+        isNonEmptyString(value.revision) &&
+        Array.isArray(value.plugins) &&
+        value.plugins.every(isPluginConfig)) {
+        return {
+            type: "plugin.sync",
+            revision: value.revision,
+            plugins: value.plugins,
+        };
+    }
+    return null;
+}
+/** Parses the acknowledgement envelope paired with one `event.push` batch. */
+export function parseHubEventAcknowledgement(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, ["type", "watermarks"]) ||
+        value.type !== "event.ack" ||
+        !isPlainObject(value.watermarks)) {
+        return null;
+    }
+    const watermarks = {};
+    for (const [executionId, watermark] of Object.entries(value.watermarks)) {
+        if (!isNonEmptyString(executionId) || !isNonNegativeInteger(watermark)) {
+            return null;
+        }
+        watermarks[executionId] = watermark;
+    }
+    return { type: "event.ack", watermarks };
+}
+//# sourceMappingURL=wire.js.map

package/dist/client/wire.js.map

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

package/dist/client/ws-transport.d.ts

@@ -0,0 +1,54 @@
+import type { ClientEvent, PluginSyncAcknowledgement } from "./types.js";
+import type { ClientTransport, ClientTransportHandlers } from "./transport.js";
+export type ClientWebSocketLike = {
+    readyState: number;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+    onclose: (() => void) | null;
+    onerror: (() => void) | null;
+    onopen: (() => void) | null;
+    send(data: string): void;
+    close(): void;
+};
+export type WsClientTransportOptions = {
+    hubBaseUrl: string;
+    token: string;
+    clientId: string;
+    WebSocketImpl?: new (url: string) => ClientWebSocketLike;
+    reconnectBaseMs?: number;
+    reconnectMaxMs?: number;
+};
+/**
+ * WebSocket transport for the protocol-v2 Client Core. It has no execution
+ * policy or state: the supervisor owns those durable concerns. A reconnect
+ * can replay the same offer and the state store will safely de-duplicate it.
+ */
+export declare class WsClientTransport implements ClientTransport {
+    private readonly options;
+    private readonly WebSocketImpl;
+    private readonly reconnectBaseMs;
+    private readonly reconnectMaxMs;
+    private handlers;
+    private socket;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private stopped;
+    private pendingAcknowledgement;
+    private pushTail;
+    constructor(options: WsClientTransportOptions);
+    connect(handlers: ClientTransportHandlers): Promise<void>;
+    push(events: ClientEvent[]): Promise<Record<string, number>>;
+    reportPluginSync(acknowledgement: PluginSyncAcknowledgement): Promise<void>;
+    close(): Promise<void>;
+    private connectSocket;
+    private notifyConnected;
+    private consumeMessage;
+    private parseMessage;
+    private pushOne;
+    private closeSocket;
+    private scheduleReconnect;
+    private clearReconnect;
+    private rejectPendingAcknowledgement;
+}
+//# sourceMappingURL=ws-transport.d.ts.map

package/dist/client/ws-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-transport.d.ts","sourceRoot":"","sources":["../../src/client/ws-transport.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAM/E,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,mBAAmB,CAAC;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAwBF;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IAY3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAXpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2C;IACzE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,sBAAsB,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAoC;gBAEvB,OAAO,EAAE,wBAAwB;IAoBxD,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAS5D,gBAAgB,CACpB,eAAe,EAAE,yBAAyB,GACzC,OAAO,CAAC,IAAI,CAAC;IAUV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B,OAAO,CAAC,aAAa;YA4CP,eAAe;YAUf,cAAc;IA+B5B,OAAO,CAAC,YAAY;YAmBN,OAAO;IAwBrB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,4BAA4B;CAKrC"}