@openma/common 0.0.0-stage → 0.9.0

package/dist/session-events/openma.js

@@ -0,0 +1,438 @@
+/**
+ * OpenMA's harness-neutral event contract.
+ *
+ * ACP and vendor adapters translate their wire payloads into this envelope.
+ * The renderer may project these events into UI state, but must not turn the
+ * projection into a second event vocabulary.
+ */
+export const OPENMA_EVENT_SCHEMA_VERSION = "oma.event.v1";
+/** Validate, clone, and recursively freeze one portable JSON value.
+ * Unlike a JSON stringify/parse round trip, this rejects values that would be
+ * silently omitted or coerced. Published facts therefore preserve exactly the
+ * data the adapter supplied. */
+export function immutableJson(value) {
+    return cloneJson(value, "$", new WeakSet());
+}
+function cloneJson(value, path, ancestors) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            invalidJson(path, "number must be finite");
+        return value;
+    }
+    if (typeof value !== "object") {
+        invalidJson(path, `${typeof value} is not a JSON value`);
+    }
+    if (ancestors.has(value))
+        invalidJson(path, "cyclic reference");
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value))
+            return cloneJsonArray(value, path, ancestors);
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            invalidJson(path, "object must have a plain or null prototype");
+        }
+        const clone = {};
+        for (const key of Reflect.ownKeys(value)) {
+            if (typeof key === "symbol")
+                invalidJson(path, "symbol keys are not JSON");
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (!descriptor?.enumerable || !("value" in descriptor)) {
+                invalidJson(`${path}.${key}`, "property must be enumerable data");
+            }
+            Object.defineProperty(clone, key, {
+                value: cloneJson(descriptor.value, `${path}.${key}`, ancestors),
+                enumerable: true,
+                configurable: true,
+                writable: true,
+            });
+        }
+        return Object.freeze(clone);
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+function cloneJsonArray(value, path, ancestors) {
+    if (Object.getPrototypeOf(value) !== Array.prototype) {
+        invalidJson(path, "array must use the standard Array prototype");
+    }
+    const allowedKeys = new Set(["length"]);
+    const clone = [];
+    for (let index = 0; index < value.length; index += 1) {
+        if (!Object.prototype.hasOwnProperty.call(value, index)) {
+            invalidJson(`${path}[${index}]`, "sparse arrays are not JSON facts");
+        }
+        const key = String(index);
+        allowedKeys.add(key);
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor?.enumerable || !("value" in descriptor)) {
+            invalidJson(`${path}[${index}]`, "array item must be enumerable data");
+        }
+        clone.push(cloneJson(descriptor.value, `${path}[${index}]`, ancestors));
+    }
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key === "symbol" || !allowedKeys.has(key)) {
+            invalidJson(path, "array has a non-JSON property");
+        }
+    }
+    return Object.freeze(clone);
+}
+function invalidJson(path, reason) {
+    throw new TypeError(`Invalid JSON at ${path}: ${reason}`);
+}
+export const OPENMA_CANONICAL_EVENT_TYPES = [
+    "user.message",
+    "user.interrupt",
+    "user.permission_response",
+    "user.elicitation_response",
+    "agent.message",
+    "agent.message_chunk",
+    "agent.thinking",
+    "turn.queued",
+    "turn.started",
+    "turn.completed",
+    "turn.failed",
+    "turn.cancelled",
+    "turn.interrupted",
+    "tool.started",
+    "tool.progress",
+    "tool.completed",
+    "tool.failed",
+    "tool.cancelled",
+    "work_item.started",
+    "work_item.progress",
+    "work_item.output",
+    "work_item.completed",
+    "work_item.failed",
+    "work_item.cancelled",
+    "work_item.killed",
+    "work_item.terminated",
+    "work_item.missing_terminal",
+    "work_item.reidentified",
+    "work_item.classified",
+    "monitor.event",
+    "plan.updated",
+    "plan.completed",
+    "plan.removed",
+    "session.started",
+    "session.running",
+    "session.idle",
+    "session.terminated",
+    "session.error",
+    "system.notice",
+    "command_catalog.updated",
+    "capability.updated",
+    "usage.updated",
+    "callback.requested",
+    "callback.completed",
+    "callback.failed",
+    "callback.notification",
+    "user.message_chunk",
+    "user.fs_write_response",
+    "session.updated",
+    "session.rescheduled",
+    "system.message",
+    "outcome.defined",
+    "outcome.evaluation_started",
+    "outcome.evaluation_progress",
+    "outcome.evaluation_completed",
+];
+export const OPENMA_EVENT_TYPES = [
+    ...OPENMA_CANONICAL_EVENT_TYPES,
+    "vendor.event",
+    "raw.event",
+];
+const EVENT_TYPES = new Set(OPENMA_EVENT_TYPES);
+const SOURCE_KINDS = new Set(["harness", "openma", "user", "system"]);
+const RAW_SOURCES = new Set(["acp", "adapter", "transport"]);
+const RAW_REASONS = new Set(["unknown", "unsupported", "malformed"]);
+function recordValue(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function optionalString(value) {
+    return value === undefined || typeof value === "string";
+}
+function validSource(value) {
+    const source = recordValue(value);
+    return source !== undefined
+        && typeof source.kind === "string"
+        && SOURCE_KINDS.has(source.kind)
+        && optionalString(source.harness)
+        && optionalString(source.adapter);
+}
+function validRawRecord(value) {
+    const raw = recordValue(value);
+    return raw !== undefined
+        && raw.kind === "raw"
+        && typeof raw.source === "string"
+        && RAW_SOURCES.has(raw.source)
+        && optionalString(raw.method)
+        && optionalString(raw.event_type)
+        && Object.hasOwn(raw, "payload")
+        && typeof raw.received_at === "string"
+        && typeof raw.reason === "string"
+        && RAW_REASONS.has(raw.reason);
+}
+function validVendorRecord(value) {
+    const vendor = recordValue(value);
+    const correlation = vendor?.correlation === undefined
+        ? undefined
+        : recordValue(vendor.correlation);
+    return vendor !== undefined
+        && vendor.kind === "vendor"
+        && typeof vendor.harness === "string"
+        && typeof vendor.namespace === "string"
+        && typeof vendor.name === "string"
+        && optionalString(vendor.version)
+        && (vendor.correlation === undefined
+            || (correlation !== undefined
+                && optionalString(correlation.session_id)
+                && optionalString(correlation.turn_id)
+                && optionalString(correlation.work_item_id)
+                && optionalString(correlation.parent_id)))
+        && Object.hasOwn(vendor, "data");
+}
+/** The single runtime validator for Agent/UI/Store consumers. It accepts only
+ * the published event vocabulary and strict portable JSON facts. */
+export function isOpenMAEvent(input) {
+    try {
+        const event = recordValue(immutableJson(input));
+        if (event === undefined
+            || event.schema_version !== OPENMA_EVENT_SCHEMA_VERSION
+            || typeof event.event_id !== "string"
+            || event.event_id.length === 0
+            || typeof event.type !== "string"
+            || !EVENT_TYPES.has(event.type)
+            || typeof event.session_id !== "string"
+            || event.session_id.length === 0
+            || !optionalString(event.session_thread_id)
+            || !optionalString(event.turn_id)
+            || !optionalString(event.work_item_id)
+            || !optionalString(event.parent_event_id)
+            || !optionalString(event.parent_id)
+            || !validSource(event.source)
+            || typeof event.occurred_at !== "string"
+            || event.occurred_at.length === 0
+            || !optionalString(event.ingested_at)
+            || (event.seq !== undefined
+                && (!Number.isSafeInteger(event.seq) || event.seq < 0))
+            || !Object.hasOwn(event, "data")
+            || (event.raw !== undefined && !validRawRecord(event.raw)))
+            return false;
+        if (event.type === "raw.event")
+            return validRawRecord(event.data);
+        if (event.type === "vendor.event")
+            return validVendorRecord(event.data);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function createOpenMAEvent(input) {
+    return {
+        schema: OPENMA_EVENT_SCHEMA_VERSION,
+        schema_version: OPENMA_EVENT_SCHEMA_VERSION,
+        ...input,
+    };
+}
+export function createVendorEvent(input) {
+    const { harness, namespace, name, version, correlation, data, ...envelope } = input;
+    return createOpenMAEvent({
+        ...envelope,
+        type: "vendor.event",
+        data: {
+            kind: "vendor",
+            harness,
+            namespace,
+            name,
+            ...(version ? { version } : {}),
+            ...(correlation ? { correlation } : {}),
+            data,
+        },
+    });
+}
+export function createRawEvent(input) {
+    const { source_kind, method, event_type, payload, received_at, reason, ...envelope } = input;
+    return createOpenMAEvent({
+        ...envelope,
+        type: "raw.event",
+        data: {
+            kind: "raw",
+            source: source_kind,
+            ...(method ? { method } : {}),
+            ...(event_type ? { event_type } : {}),
+            payload,
+            received_at: received_at ?? input.occurred_at,
+            reason,
+        },
+    });
+}
+export function createWorkItemRegistry() {
+    return { items: new Map(), seen_event_ids: new Set() };
+}
+function isWorkItemEvent(event) {
+    return event.type.startsWith("work_item.") && typeof event.work_item_id === "string";
+}
+function isTerminal(status) {
+    return status !== "running" && status !== "unknown";
+}
+function cloneRegistry(registry) {
+    return {
+        items: new Map([...registry.items].map(([id, item]) => [id, { ...item, output: [...item.output] }])),
+        seen_event_ids: new Set(registry.seen_event_ids),
+    };
+}
+function getOrCreateItem(items, id, kind = "other") {
+    const existing = items.get(id);
+    if (existing)
+        return existing;
+    const created = {
+        id,
+        kind,
+        status: "unknown",
+        output: [],
+        missing_start: true,
+    };
+    items.set(id, created);
+    return created;
+}
+function applyWorkItemEvent(items, event) {
+    const id = event.work_item_id;
+    if (!id)
+        return;
+    const data = event.data;
+    if (event.type === "work_item.reidentified") {
+        const previous = items.get(data.previous_work_item_id);
+        const current = items.get(id);
+        if (!previous) {
+            getOrCreateItem(items, id);
+            return;
+        }
+        items.delete(data.previous_work_item_id);
+        items.set(id, current
+            ? {
+                ...previous,
+                ...current,
+                id,
+                kind: current.kind === "other" ? previous.kind : current.kind,
+                output: [...previous.output, ...current.output],
+            }
+            : { ...previous, id, output: [...previous.output] });
+        return;
+    }
+    if (event.type === "work_item.classified") {
+        const existing = items.get(id);
+        if (existing)
+            existing.kind = data.kind;
+        return;
+    }
+    const item = getOrCreateItem(items, id, event.type === "work_item.started" ? data.kind : undefined);
+    if (isTerminal(item.status) && event.type !== `work_item.${item.status}`)
+        return;
+    switch (event.type) {
+        case "work_item.started":
+            if (isTerminal(item.status))
+                return;
+            if (item.kind === "other" || data.kind !== "other") {
+                item.kind = data.kind;
+            }
+            item.title = data.title;
+            item.status = "running";
+            item.started_at = event.occurred_at;
+            item.missing_start = undefined;
+            item.missing_terminal = undefined;
+            item.reason = undefined;
+            return;
+        case "work_item.progress":
+            if (typeof data.progress === "number")
+                item.progress = data.progress;
+            if (data.output !== undefined)
+                item.output.push(data.output);
+            return;
+        case "work_item.output":
+            item.output.push(data.output);
+            return;
+        case "work_item.completed":
+            // A terminal-only adapter update may carry the generic `other` kind
+            // because it cannot re-identify the already-started item. Preserve a
+            // richer kind learned from the start event instead of downgrading a
+            // Bash/agent item to `other`.
+            if (data.kind && (item.kind === "other" || data.kind !== "other")) {
+                item.kind = data.kind;
+            }
+            if (data.title)
+                item.title = data.title;
+            item.status = "completed";
+            item.result = data.result;
+            item.ended_at = event.occurred_at;
+            item.missing_terminal = undefined;
+            return;
+        case "work_item.failed":
+        case "work_item.cancelled":
+        case "work_item.killed":
+        case "work_item.terminated":
+            if (data.kind && (item.kind === "other" || data.kind !== "other")) {
+                item.kind = data.kind;
+            }
+            if (data.title)
+                item.title = data.title;
+            item.status = event.type.slice("work_item.".length);
+            item.error = data.error;
+            item.reason = data.reason;
+            item.result = data.result;
+            item.ended_at = event.occurred_at;
+            item.missing_terminal = undefined;
+            return;
+        case "work_item.missing_terminal":
+            item.status = "unknown";
+            item.reason = data.reason;
+            item.missing_terminal = true;
+            return;
+    }
+}
+export function reduceWorkItemEvent(registry, event) {
+    if (registry.seen_event_ids.has(event.event_id))
+        return registry;
+    const next = cloneRegistry(registry);
+    next.seen_event_ids.add(event.event_id);
+    if (isWorkItemEvent(event))
+        applyWorkItemEvent(next.items, event);
+    return next;
+}
+export function reduceWorkItems(events) {
+    let registry = createWorkItemRegistry();
+    const ordered = events.map((event, index) => ({ event, index })).sort((a, b) => {
+        if (a.event.seq === undefined && b.event.seq === undefined)
+            return a.index - b.index;
+        if (a.event.seq === undefined)
+            return 1;
+        if (b.event.seq === undefined)
+            return -1;
+        return a.event.seq - b.event.seq || a.index - b.index;
+    });
+    for (const { event } of ordered) {
+        registry = reduceWorkItemEvent(registry, event);
+    }
+    return registry;
+}
+export function finalizeWorkItems(registry) {
+    const finalized = cloneRegistry(registry);
+    for (const [id, item] of finalized.items) {
+        if (isTerminal(item.status))
+            continue;
+        finalized.items.set(id, {
+            ...item,
+            status: "unknown",
+            missing_terminal: true,
+        });
+    }
+    return finalized;
+}
+//# sourceMappingURL=openma.js.map

package/dist/session-events/openma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openma.js","sourceRoot":"","sources":["../../src/session-events/openma.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,cAAuB,CAAC;AAenE;;;gCAGgC;AAChC,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,OAAO,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAoB,CAAC;AACjE,CAAC;AAED,SAAS,SAAS,CAChB,KAAc,EACd,IAAY,EACZ,SAA0B;IAE1B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,WAAW,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,WAAW,CAAC,IAAI,EAAE,GAAG,OAAO,KAAK,sBAAsB,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAChE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACxE,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACzD,WAAW,CAAC,IAAI,EAAE,4CAA4C,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,KAAK,GAA8B,EAAE,CAAC;QAC5C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,WAAW,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;YAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/D,IAAI,CAAC,UAAU,EAAE,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC;gBACxD,WAAW,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,kCAAkC,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE;gBAChC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,SAAS,CAAC;gBAC/D,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;gBAClB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,KAAgB,EAChB,IAAY,EACZ,SAA0B;IAE1B,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;QACrD,WAAW,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YACxD,WAAW,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,kCAAkC,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,EAAE,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC;YACxD,WAAW,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,oCAAoC,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,WAAW,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,MAAc;IAC/C,MAAM,IAAI,SAAS,CAAC,mBAAmB,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC;AAmCD,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,cAAc;IACd,gBAAgB;IAChB,0BAA0B;IAC1B,2BAA2B;IAC3B,eAAe;IACf,qBAAqB;IACrB,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,kBAAkB;IAClB,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,kBAAkB;IAClB,qBAAqB;IACrB,kBAAkB;IAClB,sBAAsB;IACtB,4BAA4B;IAC5B,wBAAwB;IACxB,sBAAsB;IACtB,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,oBAAoB;IACpB,eAAe;IACf,eAAe;IACf,yBAAyB;IACzB,oBAAoB;IACpB,eAAe;IACf,oBAAoB;IACpB,oBAAoB;IACpB,iBAAiB;IACjB,uBAAuB;IACvB,oBAAoB;IACpB,wBAAwB;IACxB,iBAAiB;IACjB,qBAAqB;IACrB,gBAAgB;IAChB,iBAAiB;IACjB,4BAA4B;IAC5B,6BAA6B;IAC7B,8BAA8B;CACtB,CAAC;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,4BAA4B;IAC/B,cAAc;IACd,WAAW;CACH,CAAC;AAqLX,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;AACxD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9E,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AACrE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAE7E,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,MAAM,KAAK,SAAS;WACtB,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;WAC/B,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;WAC7B,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;WAC9B,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,GAAG,KAAK,SAAS;WACnB,GAAG,CAAC,IAAI,KAAK,KAAK;WAClB,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;WAC9B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;WAC3B,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;WAC1B,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC;WAC9B,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC;WAC7B,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ;WACnC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;WAC9B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,KAAK,SAAS;QACnD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACpC,OAAO,MAAM,KAAK,SAAS;WACtB,MAAM,CAAC,IAAI,KAAK,QAAQ;WACxB,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;WAClC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;WACpC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;WAC/B,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;WAC9B,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;eAC/B,CAAC,WAAW,KAAK,SAAS;mBACxB,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC;mBACtC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC;mBACnC,cAAc,CAAC,WAAW,CAAC,YAAY,CAAC;mBACxC,cAAc,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;WAC3C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;oEACoE;AACpE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,IACE,KAAK,KAAK,SAAS;eAChB,KAAK,CAAC,cAAc,KAAK,2BAA2B;eACpD,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;eAClC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;eAC3B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;eAC9B,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;eAC5B,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;eACpC,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;eAC7B,CAAC,cAAc,CAAC,KAAK,CAAC,iBAAiB,CAAC;eACxC,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC;eAC9B,CAAC,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC;eACnC,CAAC,cAAc,CAAC,KAAK,CAAC,eAAe,CAAC;eACtC,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC;eAChC,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;eAC1B,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;eACrC,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;eAC9B,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC;eAClC,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS;mBACtB,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,IAAK,KAAK,CAAC,GAAc,GAAG,CAAC,CAAC,CAAC;eAClE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;eAC7B,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1D,OAAO,KAAK,CAAC;QACf,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAAE,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AA8CD,MAAM,UAAU,iBAAiB,CAC/B,KAAqC;IAErC,OAAO;QACL,MAAM,EAAE,2BAA2B;QACnC,cAAc,EAAE,2BAA2B;QAC3C,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC;IACpF,OAAO,iBAAiB,CAAC;QACvB,GAAG,QAAQ;QACX,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,OAAO;YACP,SAAS;YACT,IAAI;YACJ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,IAAI;SACL;KACF,CAAC,CAAC;AACL,CAAC;AAYD,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EACJ,WAAW,EACX,MAAM,EACN,UAAU,EACV,OAAO,EACP,WAAW,EACX,MAAM,EACN,GAAG,QAAQ,EACZ,GAAG,KAAK,CAAC;IACV,OAAO,iBAAiB,CAAC;QACvB,GAAG,QAAQ;QACX,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE;YACJ,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,WAAW;YACnB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO;YACP,WAAW,EAAE,WAAW,IAAI,KAAK,CAAC,WAAW;YAC7C,MAAM;SACP;KACF,CAAC,CAAC;AACL,CAAC;AA6FD,MAAM,UAAU,sBAAsB;IACpC,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,eAAe,CAAC,KAAkB;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC;AACvF,CAAC;AAED,SAAS,UAAU,CAAC,MAAsB;IACxC,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,QAA0B;IAC/C,OAAO;QACL,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACpG,cAAc,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,KAAoC,EACpC,EAAU,EACV,OAAqB,OAAO;IAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,OAAO,GAAqB;QAChC,EAAE;QACF,IAAI;QACJ,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,EAAE;QACV,aAAa,EAAE,IAAI;KACpB,CAAC;IACF,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAoC,EAAE,KAAoB;IACpF,MAAM,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC;IAC9B,IAAI,CAAC,EAAE;QAAE,OAAO;IAChB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAuM,CAAC;IAC3N,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,eAAe,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACzC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO;YACnB,CAAC,CAAC;gBACE,GAAG,QAAQ;gBACX,GAAG,OAAO;gBACV,EAAE;gBACF,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI;gBAC7D,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;aAChD;YACH,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,QAAQ;YAAE,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACxC,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO;IAEjF,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,mBAAmB;YACtB,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,OAAO;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACnD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACxB,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC;YACpC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAClC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,OAAO;QACT,KAAK,oBAAoB;YACvB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YACrE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7D,OAAO;QACT,KAAK,kBAAkB;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO;QACT,KAAK,qBAAqB;YACxB,oEAAoE;YACpE,qEAAqE;YACrE,oEAAoE;YACpE,8BAA8B;YAC9B,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACxB,CAAC;YACD,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACxC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC;YAClC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAClC,OAAO;QACT,KAAK,kBAAkB,CAAC;QACxB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,kBAAkB,CAAC;QACxB,KAAK,sBAAsB;YACzB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACxB,CAAC;YACD,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACxC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAA2B,CAAC;YAC9E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC;YAClC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAClC,OAAO;QACT,KAAK,4BAA4B;YAC/B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC7B,OAAO;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAA0B,EAC1B,KAAkB;IAElB,IAAI,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjE,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,IAAI,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7E,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QACrF,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;QAChC,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAA0B;IAC1D,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,SAAS;QACtC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE;YACtB,GAAG,IAAI;YACP,MAAM,EAAE,SAAS;YACjB,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/session-kernel/index.d.ts

@@ -0,0 +1,118 @@
+/** Product-neutral runtime placement. Both Backchat and OpenManaged use the
+ * same cloud transport; only the host behind a local runtime differs. */
+export { SessionOrchestrator, sessionInheritance, type QueuedSessionTurn, type SessionForkSource, type SessionInheritance, type SessionInheritanceInput, type SessionOrchestratorOptions, type SessionRestartDisposition, type SessionRestartMode, } from "../session-orchestrator/index.js";
+export type SessionRuntime = "local" | "cloud";
+export interface SessionStartCommand {
+    type: "session.start";
+    sessionId: string;
+    agentId: string;
+    runtime: SessionRuntime;
+    cwd?: string;
+    acpSessionId?: string;
+}
+export interface SessionPromptCommand {
+    type: "session.prompt";
+    sessionId: string;
+    turnId: string;
+    text: string;
+}
+export interface SessionCancelCommand {
+    type: "session.cancel";
+    sessionId: string;
+    turnId: string;
+}
+export interface SessionDisposeCommand {
+    type: "session.dispose";
+    sessionId: string;
+}
+export type SessionCommand = SessionStartCommand | SessionPromptCommand | SessionCancelCommand | SessionDisposeCommand;
+export interface SessionReadyEvent {
+    type: "session.ready";
+    sessionId: string;
+    acpSessionId: string;
+}
+export interface SessionStreamEvent {
+    type: "session.event";
+    sessionId: string;
+    turnId: string;
+    event: unknown;
+}
+export interface SessionCompleteEvent {
+    type: "session.complete";
+    sessionId: string;
+    turnId: string;
+}
+export interface SessionErrorEvent {
+    type: "session.error";
+    sessionId: string;
+    turnId?: string;
+    message: string;
+}
+export interface SessionDisposedEvent {
+    type: "session.disposed";
+    sessionId: string;
+}
+export type SessionHostEvent = SessionReadyEvent | SessionStreamEvent | SessionCompleteEvent | SessionErrorEvent | SessionDisposedEvent;
+export type SessionWireMessage = {
+    type?: string;
+    session_id?: string;
+    tenant_id?: string;
+    turn_id?: string;
+    agent_id?: string;
+    text?: string;
+    event?: unknown;
+    message?: string;
+    acp_session_id?: string;
+    cwd?: string;
+    resume?: {
+        acp_session_id?: string;
+    };
+};
+/** Decode the relay's snake_case JSON once at the boundary. Hosts should not
+ * scatter wire-shape checks through their lifecycle implementation. */
+export declare function decodeSessionCommand(input: unknown): SessionCommand | null;
+/** Encode an application-native command at the relay transport edge. */
+export declare function encodeSessionCommand(command: SessionCommand, options?: {
+    tenantId?: string;
+}): Record<string, unknown>;
+/** Decode host-to-cloud relay JSON into the shared application vocabulary. */
+export declare function decodeSessionHostEvent(input: unknown): SessionHostEvent | null;
+/** Encode a host event to the relay wire shape. The optional tenant is kept
+ * at the transport edge; it is not part of the local lifecycle model. */
+export declare function encodeSessionHostEvent(event: SessionHostEvent, options?: {
+    tenantId?: string;
+}): Record<string, unknown>;
+export type SessionLifecycleEvent = {
+    type: "start.requested";
+} | {
+    type: "session.ready";
+    acpSessionId: string;
+} | {
+    type: "prompt.requested";
+    turnId: string;
+} | {
+    type: "prompt.cancelled";
+    turnId: string;
+} | {
+    type: "session.complete";
+    turnId: string;
+} | {
+    type: "session.error";
+    turnId?: string;
+    message: string;
+} | {
+    type: "session.disposed";
+};
+export type SessionLifecycleStatus = "draft" | "starting" | "ready" | "running" | "errored" | "disposed";
+export interface SessionLifecycle {
+    sessionId: string;
+    status: SessionLifecycleStatus;
+    acpSessionId?: string;
+    activeTurnId?: string;
+    lastError?: string;
+}
+export declare function initialSessionLifecycle(sessionId: string): SessionLifecycle;
+/** Pure lifecycle reducer. Hosts keep their own persistence/transport, but
+ * every host must apply these same transition and stale-event rules. */
+export declare function reduceSessionLifecycle(state: SessionLifecycle, event: SessionLifecycleEvent): SessionLifecycle;
+//# sourceMappingURL=index.d.ts.map

package/dist/session-kernel/index.d.ts.map

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