@allin-ai/agent-client 0.1.1 → 0.2.0

package/dist/protocol/index.d.ts

@@ -0,0 +1,3 @@
+export { AGENT_CLIENT_PROTOCOL_VERSION, encodeClientEventBatch, encodeClientHello, encodeInventoryReport, encodePluginSyncAcknowledgement, parseClientCommand, parseClientEvent, parseClientEventBatch, parseClientHello, parseHubDownlink, parseHubEventAcknowledgement, parseInventoryReport, parsePluginSyncAcknowledgement, type ClientHello, type HubEventAcknowledgement, } from "./wire.js";
+export { CLIENT_EVENT_TYPES, CLIENT_RUNTIME_IDS, type AgentInput, type ClientCommand, type ClientEvent, type ClientEventBatch, type ClientEventType, type HubDownlink, type HubRuntimeEvent, type HubRuntimeHeartbeat, type HubRuntimeRegistration, type InventoryReport, type PlatformInventoryEntry, type PluginConfig, type PluginInventoryEntry, type PluginSyncAcknowledgement, type PluginSyncStatus, type RuntimeId, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,+BAA+B,EAC/B,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,WAAW,EAChB,KAAK,uBAAuB,GAC7B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,MAAM,YAAY,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,3 @@
+export { AGENT_CLIENT_PROTOCOL_VERSION, encodeClientEventBatch, encodeClientHello, encodeInventoryReport, encodePluginSyncAcknowledgement, parseClientCommand, parseClientEvent, parseClientEventBatch, parseClientHello, parseHubDownlink, parseHubEventAcknowledgement, parseInventoryReport, parsePluginSyncAcknowledgement, } from "./wire.js";
+export { CLIENT_EVENT_TYPES, CLIENT_RUNTIME_IDS, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,+BAA+B,EAC/B,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,oBAAoB,EACpB,8BAA8B,GAG/B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAiBnB,MAAM,YAAY,CAAC"}

package/dist/protocol/types.d.ts

@@ -0,0 +1,111 @@
+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; installation remains a local client concern. */
+export type PluginConfig = {
+    id: string;
+    gitUrl: string;
+    ref?: string;
+    enabled: boolean;
+    runtimes?: RuntimeId[];
+};
+export type HubDownlink = {
+    type: "task.offer";
+    command: ClientCommand;
+} | {
+    type: "plugin.sync";
+    revision: string;
+    plugins: PluginConfig[];
+    /** Query-only downlink: report inventory, apply no side effects. */
+    inventoryQuery?: true;
+};
+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;
+    };
+};
+/** Optional embedded-Hub registration surface for node health reporting. */
+export type HubRuntimeRegistration = {
+    runtimeId: string;
+    displayName: string;
+    protocolVersion: number;
+};
+export type HubRuntimeHeartbeat = {
+    runtimeId: string;
+};
+/** A non-executing embedded Hub audit event. Client executions use ClientEvent. */
+export type HubRuntimeEvent = {
+    sessionId: string;
+    seq: number;
+    kind: string;
+    ts: string;
+    payload: unknown;
+};
+export type PlatformInventoryEntry = {
+    platform: RuntimeId;
+    installed: boolean;
+    version: string | null;
+    reason?: string;
+};
+export type PluginInventoryEntry = {
+    id: string;
+    gitUrl: string;
+    ref?: string;
+    enabled: boolean;
+    status: "active" | "blocked" | "failed";
+    resolvedCommit: string;
+    installedAt: string;
+    lastError?: string;
+};
+export type InventoryReport = {
+    type: "inventory.report";
+    reportedAt: string;
+    platforms: PlatformInventoryEntry[];
+    plugins: PluginInventoryEntry[];
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/protocol/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/protocol/types.js.map

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

@@ -0,0 +1,25 @@
+import { type ClientCommand, type ClientEvent, type ClientEventBatch, type HubDownlink, type InventoryReport, type PluginSyncAcknowledgement } from "./types.js";
+/** Shared Hub ↔ Agent Client protocol identity. */
+export declare const AGENT_CLIENT_PROTOCOL_VERSION = 2;
+export declare function parseClientCommand(value: unknown): ClientCommand | null;
+export declare function parseClientEvent(value: unknown): ClientEvent | null;
+export declare function parseClientEventBatch(value: unknown): ClientEvent[] | null;
+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>;
+};
+export declare function parseInventoryReport(value: unknown): InventoryReport | null;
+export declare function encodeInventoryReport(value: InventoryReport): InventoryReport;
+export declare function parsePluginSyncAcknowledgement(value: unknown): PluginSyncAcknowledgement | null;
+export declare function encodePluginSyncAcknowledgement(value: PluginSyncAcknowledgement): PluginSyncAcknowledgement;
+export declare function parseClientHello(value: unknown): ClientHello | null;
+export declare function encodeClientHello(clientId: string): ClientHello;
+export declare function parseHubDownlink(value: unknown): HubDownlink | null;
+export declare function parseHubEventAcknowledgement(value: unknown): HubEventAcknowledgement | null;
+//# sourceMappingURL=wire.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/protocol/wire.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EAErB,KAAK,WAAW,EAChB,KAAK,eAAe,EAIpB,KAAK,yBAAyB,EAE/B,MAAM,YAAY,CAAC;AAEpB,mDAAmD;AACnD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAwE/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CA2EvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAgCnE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,GAAG,IAAI,CAe1E;AAED,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;AACF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAAC;AA2EF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAkB3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAI7E;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,yBAAyB,GAAG,IAAI,CAmBlC;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,yBAAyB,GAC/B,yBAAyB,CAI3B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAcnE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAQ/D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAqBnE;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,uBAAuB,GAAG,IAAI,CAehC"}

package/dist/protocol/wire.js

@@ -0,0 +1,337 @@
+import { CLIENT_EVENT_TYPES, CLIENT_RUNTIME_IDS, } from "./types.js";
+/** Shared Hub ↔ Agent Client protocol identity. */
+export const AGENT_CLIENT_PROTOCOL_VERSION = 2;
+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));
+}
+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;
+}
+export 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;
+    if (Object.hasOwn(value, "payload")) {
+        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,
+    };
+}
+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;
+}
+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));
+}
+function isPlatformInventoryEntry(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, ["platform", "installed", "version", "reason"]) ||
+        !isRuntimeId(value.platform) ||
+        typeof value.installed !== "boolean" ||
+        (value.version !== null && typeof value.version !== "string"))
+        return false;
+    return value.reason === undefined || isNonEmptyString(value.reason);
+}
+function isPluginInventoryEntry(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, [
+            "id",
+            "gitUrl",
+            "ref",
+            "enabled",
+            "status",
+            "resolvedCommit",
+            "installedAt",
+            "lastError",
+        ]) ||
+        !isNonEmptyString(value.id) ||
+        !isNonEmptyString(value.gitUrl) ||
+        typeof value.enabled !== "boolean" ||
+        !["active", "blocked", "failed"].includes(value.status) ||
+        typeof value.resolvedCommit !== "string" ||
+        !(value.resolvedCommit === "unresolved" || /^[0-9a-f]{40}$/i.test(value.resolvedCommit)) ||
+        !isNonEmptyString(value.installedAt))
+        return false;
+    if (value.ref !== undefined && !isNonEmptyString(value.ref))
+        return false;
+    return value.lastError === undefined || isNonEmptyString(value.lastError);
+}
+export function parseInventoryReport(value) {
+    if (!isPlainObject(value) ||
+        !hasOnlyKeys(value, ["type", "reportedAt", "platforms", "plugins"]) ||
+        value.type !== "inventory.report" ||
+        !isNonEmptyString(value.reportedAt) ||
+        !Array.isArray(value.platforms) ||
+        !value.platforms.every(isPlatformInventoryEntry) ||
+        !Array.isArray(value.plugins) ||
+        !value.plugins.every(isPluginInventoryEntry))
+        return null;
+    return {
+        type: "inventory.report",
+        reportedAt: value.reportedAt,
+        platforms: value.platforms,
+        plugins: value.plugins,
+    };
+}
+export function encodeInventoryReport(value) {
+    const parsed = parseInventoryReport(value);
+    if (!parsed)
+        throw new TypeError("Invalid inventory report");
+    return parsed;
+}
+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;
+}
+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;
+}
+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", "inventoryQuery"]) &&
+        isNonEmptyString(value.revision) &&
+        Array.isArray(value.plugins) &&
+        value.plugins.every(isPluginConfig) &&
+        (value.inventoryQuery === undefined || value.inventoryQuery === true))
+        return {
+            type: "plugin.sync",
+            revision: value.revision,
+            plugins: value.plugins,
+            ...(value.inventoryQuery === true ? { inventoryQuery: true } : {}),
+        };
+    return null;
+}
+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/protocol/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../src/protocol/wire.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAanB,MAAM,YAAY,CAAC;AAEpB,mDAAmD;AACnD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAE/C,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEtE,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,WAAW,CAClB,KAA8B,EAC9B,OAA0B;IAE1B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,kBAAkB,CAAC,QAAQ,CAAC,KAAkB,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,kBAAkB,CAAC,QAAQ,CAAC,KAAwB,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACnE,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;QAElC,OAAO,KAAK,CAAC;IACf,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,OAAO,CACL,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CACrE,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,OAAO,IAAI,OAAO,EAAU;IAE5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAC/B,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CACd,uBAAuB,CAAC,QAAQ,CAC9B,GAA+C,CAChD,IAAI,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,IACE,CAAC,WAAW,CAAC,KAAK,EAAE;YAClB,MAAM;YACN,WAAW;YACX,aAAa;YACb,QAAQ;YACR,SAAS;YACT,SAAS;YACT,SAAS;SACV,CAAC;YACF,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC;YAClC,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC;YACpC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC;YAC/B,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC;YACpC,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3B,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;YAE7B,OAAO,IAAI,CAAC;QACd,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAqB;SACrC,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACvC,IACE,CAAC,WAAW,CAAC,KAAK,EAAE;YAClB,MAAM;YACN,WAAW;YACX,aAAa;YACb,QAAQ;YACR,SAAS;YACT,cAAc;YACd,OAAO;SACR,CAAC;YACF,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC;YAClC,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC;YACpC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC;YAC/B,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC;YACpC,CAAC,gBAAgB,CAAC,KAAK,CAAC,YAAY,CAAC;YACrC,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;YAC3B,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC;YAEpC,OAAO,IAAI,CAAC;QACd,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,IACE,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;YACzD,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC;YAClC,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC;YAEpC,OAAO,IAAI,CAAC;QACd,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE;YAClB,aAAa;YACb,UAAU;YACV,MAAM;YACN,SAAS;YACT,YAAY;SACb,CAAC;QACF,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC;QACpC,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC;QACrC,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC;QAC9B,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC;QAEnC,OAAO,IAAI,CAAC;IACd,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO;YACL,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,KAAK,YAAY;QAC3B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAE5B,OAAO,IAAI,CAAC;IACd,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAqB;IAErB,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAC;IAC9D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAYD,SAAS,2BAA2B,CAClC,KAAc;IAEd,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,KAAK,iBAAiB;QAChC,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjC,CAAC,CAAC,SAAS,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAChD,KAAK,CAAC,MAAgB,CACvB;QACD,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAClB,CAAC,MAAM,EAAE,EAAE,CACT,aAAa,CAAC,MAAM,CAAC;YACrB,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;YAC7C,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;YACzC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAChD;QAED,OAAO,KAAK,CAAC;IACf,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC;IAChE,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,QAAQ;QACzB,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1B,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7C,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,oBAAoB;QACzC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CACtC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnE,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC5B,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS;QACpC,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;QAE7D,OAAO,KAAK,CAAC;IACf,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CACV,KAAK,EACL;YACE,IAAI;YACJ,QAAQ;YACR,KAAK;YACL,SAAS;YACT,QAAQ;YACR,gBAAgB;YAChB,aAAa;YACb,WAAW;SACZ,CACF;QACD,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;QAClC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAgB,CAAC;QACjE,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;QACxC,CAAC,CAAC,KAAK,CAAC,cAAc,KAAK,YAAY,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACxF,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC;QAEpC,OAAO,KAAK,CAAC;IACf,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,KAAK,kBAAkB;QACjC,CAAC,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC;QACnC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/B,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,wBAAwB,CAAC;QAChD,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC;QAE5C,OAAO,IAAI,CAAC;IACd,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAAc;IAEd,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;YACtD,EAAE;YACF,cAAc,EAAE,cAAc,CAAC,WAAW,EAAE;SAC7C,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,KAAK;YACb,CAAC,CAAC;gBACE,KAAK,EAAE;oBACL,IAAI,EAAE,oBAA6B;oBACnC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;iBAC7B;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAgC;IAEhC,MAAM,MAAM,GAAG,8BAA8B,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,KAAK,cAAc;QAC7B,KAAK,CAAC,eAAe,KAAK,6BAA6B;QACvD,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAEjC,OAAO,IAAI,CAAC;IACd,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,eAAe,EAAE,6BAA6B;QAC9C,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC;QAC7B,IAAI,EAAE,cAAc;QACpB,eAAe,EAAE,6BAA6B;QAC9C,QAAQ;KACT,CAAC,CAAC;IACH,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,CAAC;IACD,IACE,KAAK,CAAC,IAAI,KAAK,aAAa;QAC5B,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACrE,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;QACnC,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC;QAErE,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAc;IAEd,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;QACrB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,KAAK,WAAW;QAC1B,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;QAEhC,OAAO,IAAI,CAAC;IACd,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,UAAU,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC"}

package/dist/runtime/claude.d.ts

@@ -1,18 +1,38 @@
-import { type CanUseTool, type Options, type Query, type SDKMessage, type SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
 import type { PlatformEvent, PlatformProbe } from "./types.js";
-/** Re-exported so host wrappers can consume the opaque vendor payload safely. */
-export type ClaudeSdkMessage = SDKMessage;
+/** Opaque vendor message shape retained without a mandatory SDK type dependency. */
+export type ClaudeSdkMessage = {
+    type?: string;
+    subtype?: string;
+    [key: string]: unknown;
+};
+export type ClaudeSdkUserMessage = Record<string, unknown>;
+export type ClaudeCanUseTool = (toolName: string, input: Record<string, unknown>, options: {
+    toolUseID: string;
+    signal: AbortSignal;
+}) => Promise<unknown>;
+export type ClaudeSdkOptions = {
+    abortController?: AbortController;
+    canUseTool?: ClaudeCanUseTool;
+    [key: string]: unknown;
+};
+export type ClaudeQuery = AsyncIterable<ClaudeSdkMessage> & {
+    close(): void;
+};
 export type ClaudeAdapterRunInput = {
-    prompt: string | AsyncIterable<SDKUserMessage>;
+    prompt: string | AsyncIterable<ClaudeSdkUserMessage>;
     /** Domain/host prepares provider and plugin settings before crossing this boundary. */
-    options: Omit<Options, "abortController" | "canUseTool">;
+    options: Omit<ClaudeSdkOptions, "abortController" | "canUseTool">;
     /** Host-owned tool decision bridge. The adapter never imports a host package. */
-    onAskUser?: CanUseTool;
+    onAskUser?: ClaudeCanUseTool;
 };
 export type ClaudeQueryFactory = (parameters: {
-    prompt: string | AsyncIterable<SDKUserMessage>;
-    options?: Options;
-}) => Query;
+    prompt: string | AsyncIterable<ClaudeSdkUserMessage>;
+    options?: ClaudeSdkOptions;
+}) => ClaudeQuery;
+type ClaudeSdkModule = {
+    query: ClaudeQueryFactory;
+};
+export type ClaudeSdkLoader = () => Promise<ClaudeSdkModule>;
 export type ClaudeAdapter = {
     readonly id: "claude";
     probe(): Promise<PlatformProbe>;
@@ -21,10 +41,13 @@ export type ClaudeAdapter = {
 export type CreateClaudeAdapterDeps = {
     /** Test seam. Production invokes the installed official Claude Agent SDK. */
     query?: ClaudeQueryFactory;
+    /** Test seam for the optional SDK module. It is never invoked at import time. */
+    loadClaude?: ClaudeSdkLoader;
 };
 /**
  * Official Claude Agent SDK adapter. SDK setup/iteration and process cleanup
  * stay here; provider selection and host callbacks are explicit input.
  */
 export declare function createClaudeAdapter(deps?: CreateClaudeAdapterDeps): ClaudeAdapter;
+export {};
 //# sourceMappingURL=claude.d.ts.map

package/dist/runtime/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/runtime/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE1C,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC/C,uFAAuF;IACvF,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAAC,CAAC;IACzD,iFAAiF;IACjF,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE;IAC5C,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,KAAK,KAAK,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,KAAK,CACH,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC,aAAa,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAuHF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,uBAA4B,GACjC,aAAa,CAkEf"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/runtime/claude.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KAChD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC,gBAAgB,CAAC,GAAG;IAC1D,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACrD,uFAAuF;IACvF,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,GAAG,YAAY,CAAC,CAAC;IAClE,iFAAiF;IACjF,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE;IAC5C,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,KAAK,WAAW,CAAC;AAElB,KAAK,eAAe,GAAG;IAAE,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,KAAK,CACH,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC,aAAa,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,iFAAiF;IACjF,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B,CAAC;AAuIF;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,uBAA4B,GACjC,aAAa,CAsEf"}