@openma/common 0.0.0-stage → 0.9.0

package/dist/session-kernel/index.js

@@ -0,0 +1,215 @@
+/** Product-neutral runtime placement. Both Backchat and OpenManaged use the
+ * same cloud transport; only the host behind a local runtime differs. */
+export { SessionOrchestrator, sessionInheritance, } from "../session-orchestrator/index.js";
+function nonEmpty(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/** Decode the relay's snake_case JSON once at the boundary. Hosts should not
+ * scatter wire-shape checks through their lifecycle implementation. */
+export function decodeSessionCommand(input) {
+    if (!input || typeof input !== "object")
+        return null;
+    const message = input;
+    if (!nonEmpty(message.session_id))
+        return null;
+    switch (message.type) {
+        case "session.start":
+            if (!nonEmpty(message.agent_id))
+                return null;
+            return {
+                type: "session.start",
+                sessionId: message.session_id,
+                agentId: message.agent_id,
+                runtime: "local",
+                ...(nonEmpty(message.cwd) ? { cwd: message.cwd } : {}),
+                ...(nonEmpty(message.resume?.acp_session_id)
+                    ? { acpSessionId: message.resume.acp_session_id }
+                    : {}),
+            };
+        case "session.prompt":
+            if (!nonEmpty(message.turn_id) || typeof message.text !== "string")
+                return null;
+            return {
+                type: "session.prompt",
+                sessionId: message.session_id,
+                turnId: message.turn_id,
+                text: message.text,
+            };
+        case "session.cancel":
+            if (!nonEmpty(message.turn_id))
+                return null;
+            return { type: "session.cancel", sessionId: message.session_id, turnId: message.turn_id };
+        case "session.dispose":
+            return { type: "session.dispose", sessionId: message.session_id };
+        default:
+            return null;
+    }
+}
+/** Encode an application-native command at the relay transport edge. */
+export function encodeSessionCommand(command, options = {}) {
+    const tenant = options.tenantId ? { tenant_id: options.tenantId } : {};
+    switch (command.type) {
+        case "session.start":
+            return {
+                type: command.type,
+                session_id: command.sessionId,
+                ...tenant,
+                agent_id: command.agentId,
+                ...(command.cwd ? { cwd: command.cwd } : {}),
+                ...(command.acpSessionId
+                    ? { resume: { acp_session_id: command.acpSessionId } }
+                    : {}),
+            };
+        case "session.prompt":
+            return {
+                type: command.type,
+                session_id: command.sessionId,
+                ...tenant,
+                turn_id: command.turnId,
+                text: command.text,
+            };
+        case "session.cancel":
+            return {
+                type: command.type,
+                session_id: command.sessionId,
+                ...tenant,
+                turn_id: command.turnId,
+            };
+        case "session.dispose":
+            return { type: command.type, session_id: command.sessionId, ...tenant };
+    }
+}
+/** Decode host-to-cloud relay JSON into the shared application vocabulary. */
+export function decodeSessionHostEvent(input) {
+    if (!input || typeof input !== "object")
+        return null;
+    const message = input;
+    if (!nonEmpty(message.session_id))
+        return null;
+    switch (message.type) {
+        case "session.ready":
+            return nonEmpty(message.acp_session_id)
+                ? {
+                    type: message.type,
+                    sessionId: message.session_id,
+                    acpSessionId: message.acp_session_id,
+                }
+                : null;
+        case "session.event":
+            return nonEmpty(message.turn_id) && "event" in message
+                ? {
+                    type: message.type,
+                    sessionId: message.session_id,
+                    turnId: message.turn_id,
+                    event: message.event,
+                }
+                : null;
+        case "session.complete":
+            return nonEmpty(message.turn_id)
+                ? {
+                    type: message.type,
+                    sessionId: message.session_id,
+                    turnId: message.turn_id,
+                }
+                : null;
+        case "session.error":
+            return typeof message.message === "string"
+                ? {
+                    type: message.type,
+                    sessionId: message.session_id,
+                    ...(nonEmpty(message.turn_id) ? { turnId: message.turn_id } : {}),
+                    message: message.message,
+                }
+                : null;
+        case "session.disposed":
+            return { type: message.type, sessionId: message.session_id };
+        default:
+            return 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 function encodeSessionHostEvent(event, options = {}) {
+    const tenant = options.tenantId ? { tenant_id: options.tenantId } : {};
+    switch (event.type) {
+        case "session.ready":
+            return {
+                type: event.type,
+                session_id: event.sessionId,
+                ...tenant,
+                acp_session_id: event.acpSessionId,
+            };
+        case "session.event":
+            return {
+                type: event.type,
+                session_id: event.sessionId,
+                ...tenant,
+                turn_id: event.turnId,
+                event: event.event,
+            };
+        case "session.complete":
+            return {
+                type: event.type,
+                session_id: event.sessionId,
+                ...tenant,
+                turn_id: event.turnId,
+            };
+        case "session.error":
+            return {
+                type: event.type,
+                session_id: event.sessionId,
+                ...tenant,
+                ...(event.turnId ? { turn_id: event.turnId } : {}),
+                message: event.message,
+            };
+        case "session.disposed":
+            return { type: event.type, session_id: event.sessionId, ...tenant };
+    }
+}
+export function initialSessionLifecycle(sessionId) {
+    return { sessionId, status: "draft" };
+}
+/** Pure lifecycle reducer. Hosts keep their own persistence/transport, but
+ * every host must apply these same transition and stale-event rules. */
+export function reduceSessionLifecycle(state, event) {
+    switch (event.type) {
+        case "start.requested":
+            if (state.status === "disposed")
+                return state;
+            return { ...state, status: "starting", lastError: undefined };
+        case "session.ready":
+            if (state.status === "disposed")
+                return state;
+            return {
+                ...state,
+                status: "ready",
+                acpSessionId: event.acpSessionId,
+                activeTurnId: undefined,
+                lastError: undefined,
+            };
+        case "prompt.requested":
+            if (state.status === "disposed")
+                return state;
+            return { ...state, status: "running", activeTurnId: event.turnId, lastError: undefined };
+        case "session.complete":
+            if (state.activeTurnId !== event.turnId)
+                return state;
+            return { ...state, status: "ready", activeTurnId: undefined };
+        case "prompt.cancelled":
+            if (state.activeTurnId !== event.turnId)
+                return state;
+            return { ...state, status: "ready", activeTurnId: undefined };
+        case "session.error":
+            if (event.turnId && state.activeTurnId && event.turnId !== state.activeTurnId)
+                return state;
+            return {
+                ...state,
+                status: "errored",
+                activeTurnId: undefined,
+                lastError: event.message,
+            };
+        case "session.disposed":
+            return { ...state, status: "disposed", activeTurnId: undefined };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/session-kernel/index.js.map

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

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

@@ -0,0 +1,71 @@
+export type SessionRestartMode = "now" | "after-turn";
+export type SessionRestartDisposition = "ready" | "pending";
+export interface QueuedSessionTurn<T> {
+    readonly turnId: string;
+    value: T;
+    readonly createdAt: number;
+}
+export interface SessionOrchestratorOptions {
+    sessionId: string;
+    now?: () => number;
+}
+/**
+ * Host-neutral session scheduling state.
+ *
+ * ACP owns prompt completion; this class owns the client-side policy around
+ * which prompt may start next. It deliberately contains no transport,
+ * persistence, workspace provisioning, or UI behavior.
+ */
+export declare class SessionOrchestrator<T> {
+    #private;
+    readonly sessionId: string;
+    constructor(options: SessionOrchestratorOptions);
+    get activeTurnId(): string | null;
+    get queued(): readonly QueuedSessionTurn<T>[];
+    get steeringTurnIds(): readonly string[];
+    get restartPending(): boolean;
+    get disposed(): boolean;
+    isBusy(): boolean;
+    tryStartTurn(turnId: string): boolean;
+    finishTurn(turnId: string): boolean;
+    enqueue(turnId: string, value: T): QueuedSessionTurn<T>;
+    claimNext(): QueuedSessionTurn<T> | null;
+    clearQueue(): QueuedSessionTurn<T>[];
+    removeQueued(turnId: string): QueuedSessionTurn<T> | null;
+    updateQueued(turnId: string, update: (value: T) => T): boolean;
+    reorderQueue(turnIds: readonly string[]): void;
+    beginSteering(turnId: string): boolean;
+    finishSteering(turnId: string): boolean;
+    requestRestart(mode: SessionRestartMode): SessionRestartDisposition;
+    clearRestart(): void;
+    dispose(): QueuedSessionTurn<T>[];
+}
+export interface SessionForkSource {
+    acpSessionId: string;
+    sessionId?: string;
+}
+export interface SessionInheritanceInput {
+    cwd: string;
+    additionalDirectories?: readonly string[];
+    resumeAcpSessionId?: string;
+    forkFrom?: SessionForkSource;
+}
+export type SessionInheritance = {
+    kind: "new";
+    cwd: string;
+    additionalDirectories: string[];
+} | {
+    kind: "resume";
+    cwd: string;
+    additionalDirectories: string[];
+    resumeAcpSessionId: string;
+} | {
+    kind: "fork";
+    cwd: string;
+    additionalDirectories: string[];
+    parentSessionId?: string;
+    forkFromAcpSessionId: string;
+};
+/** Normalize session inheritance once before a host opens an ACP session. */
+export declare function sessionInheritance(input: SessionInheritanceInput): SessionInheritance;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/session-orchestrator/index.js

@@ -0,0 +1,177 @@
+/**
+ * Host-neutral session scheduling state.
+ *
+ * ACP owns prompt completion; this class owns the client-side policy around
+ * which prompt may start next. It deliberately contains no transport,
+ * persistence, workspace provisioning, or UI behavior.
+ */
+export class SessionOrchestrator {
+    sessionId;
+    #now;
+    #activeTurnId = null;
+    #queued = [];
+    #steeringTurnIds = new Set();
+    #restartPending = false;
+    #disposed = false;
+    constructor(options) {
+        this.sessionId = options.sessionId;
+        this.#now = options.now ?? Date.now;
+    }
+    get activeTurnId() {
+        return this.#activeTurnId;
+    }
+    get queued() {
+        return this.#queued;
+    }
+    get steeringTurnIds() {
+        return [...this.#steeringTurnIds];
+    }
+    get restartPending() {
+        return this.#restartPending;
+    }
+    get disposed() {
+        return this.#disposed;
+    }
+    isBusy() {
+        return (this.#activeTurnId !== null
+            || this.#queued.length > 0
+            || this.#steeringTurnIds.size > 0);
+    }
+    tryStartTurn(turnId) {
+        if (this.#disposed
+            || this.#restartPending
+            || this.#activeTurnId !== null
+            || this.#queued.length > 0
+            || this.#steeringTurnIds.size > 0)
+            return false;
+        this.#activeTurnId = turnId;
+        return true;
+    }
+    finishTurn(turnId) {
+        if (this.#activeTurnId !== turnId)
+            return false;
+        this.#activeTurnId = null;
+        return true;
+    }
+    enqueue(turnId, value) {
+        const existing = this.#queued.find((entry) => entry.turnId === turnId);
+        if (existing) {
+            existing.value = value;
+            return existing;
+        }
+        const entry = {
+            turnId,
+            value,
+            createdAt: this.#now(),
+        };
+        this.#queued.push(entry);
+        return entry;
+    }
+    claimNext() {
+        if (this.#disposed
+            || this.#restartPending
+            || this.#activeTurnId !== null
+            || this.#steeringTurnIds.size > 0)
+            return null;
+        const next = this.#queued.shift();
+        if (!next)
+            return null;
+        this.#activeTurnId = next.turnId;
+        return next;
+    }
+    clearQueue() {
+        return this.#queued.splice(0);
+    }
+    removeQueued(turnId) {
+        const index = this.#queued.findIndex((entry) => entry.turnId === turnId);
+        if (index < 0)
+            return null;
+        return this.#queued.splice(index, 1)[0] ?? null;
+    }
+    updateQueued(turnId, update) {
+        const queued = this.#queued.find((entry) => entry.turnId === turnId);
+        if (!queued)
+            return false;
+        queued.value = update(queued.value);
+        return true;
+    }
+    reorderQueue(turnIds) {
+        const order = new Map();
+        for (const [index, turnId] of turnIds.entries()) {
+            if (!order.has(turnId))
+                order.set(turnId, index);
+        }
+        this.#queued.sort((left, right) => {
+            const leftIndex = order.get(left.turnId);
+            const rightIndex = order.get(right.turnId);
+            if (leftIndex === undefined && rightIndex === undefined) {
+                return left.createdAt - right.createdAt;
+            }
+            if (leftIndex === undefined)
+                return 1;
+            if (rightIndex === undefined)
+                return -1;
+            return leftIndex - rightIndex;
+        });
+    }
+    beginSteering(turnId) {
+        if (this.#disposed
+            || this.#activeTurnId === null
+            || this.#steeringTurnIds.has(turnId))
+            return false;
+        this.#steeringTurnIds.add(turnId);
+        return true;
+    }
+    finishSteering(turnId) {
+        return this.#steeringTurnIds.delete(turnId);
+    }
+    requestRestart(mode) {
+        if (mode === "after-turn"
+            && (this.#activeTurnId !== null || this.#steeringTurnIds.size > 0)) {
+            this.#restartPending = true;
+            return "pending";
+        }
+        return "ready";
+    }
+    clearRestart() {
+        this.#restartPending = false;
+    }
+    dispose() {
+        if (this.#disposed)
+            return [];
+        this.#disposed = true;
+        this.#activeTurnId = null;
+        this.#steeringTurnIds.clear();
+        this.#restartPending = false;
+        return this.clearQueue();
+    }
+}
+/** Normalize session inheritance once before a host opens an ACP session. */
+export function sessionInheritance(input) {
+    if (input.resumeAcpSessionId && input.forkFrom?.acpSessionId) {
+        throw new Error("cannot resume and fork the same session");
+    }
+    const base = {
+        cwd: input.cwd,
+        additionalDirectories: [...(input.additionalDirectories ?? [])],
+    };
+    if (input.forkFrom?.acpSessionId) {
+        return {
+            kind: "fork",
+            ...base,
+            ...(input.forkFrom.sessionId
+                ? { parentSessionId: input.forkFrom.sessionId }
+                : {}),
+            forkFromAcpSessionId: input.forkFrom.acpSessionId,
+        };
+    }
+    if (input.resumeAcpSessionId) {
+        return {
+            kind: "resume",
+            ...base,
+            resumeAcpSessionId: input.resumeAcpSessionId,
+        };
+    }
+    return { kind: "new", ...base };
+}
+//# sourceMappingURL=index.js.map

package/dist/session-orchestrator/index.js.map

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

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

@@ -0,0 +1,96 @@
+import type { SessionConfigOption } from "@agentclientprotocol/sdk";
+import { type ReactNode } from "react";
+export interface SessionRunHarness {
+    id: string;
+    label: string;
+}
+export interface SessionRunControlsProps {
+    activeHarnessId: string;
+    harnesses: readonly SessionRunHarness[];
+    configOptions: readonly SessionConfigOption[];
+    disabled?: boolean;
+    className?: string;
+    onSelectHarness(harnessId: string): void;
+    onSetConfigOption(configId: string, value: string | boolean): void;
+}
+export interface SessionHistoryItem {
+    id: string;
+    title: string;
+}
+export interface SessionHistoryMenuProps {
+    activeSessionId: string;
+    sessions: readonly SessionHistoryItem[];
+    className?: string;
+    onSelectSession(sessionId: string): void;
+}
+export declare function OpenMAMark({ className }: {
+    className?: string;
+}): import("react").JSX.Element;
+/** Shared Backchat session switcher. Hosts own placement; common owns the
+ * accessible menu behavior and visual vocabulary so it never falls back to a
+ * platform-native select. */
+export declare function SessionHistoryMenu({ activeSessionId, sessions, className, onSelectSession, }: SessionHistoryMenuProps): import("react").JSX.Element;
+export declare function HarnessIcon({ harnessId, label, className, size, }: {
+    harnessId: string;
+    label?: string;
+    className?: string;
+    size?: number | string;
+}): import("react").JSX.Element;
+export declare function SessionRunControls({ activeHarnessId, harnesses, configOptions, disabled, className, onSelectHarness, onSetConfigOption, }: SessionRunControlsProps): import("react").JSX.Element;
+export declare function flattenSessionConfigSelectOptions(options: Extract<SessionConfigOption, {
+    type: "select";
+}>["options"]): Array<{
+    value: string;
+    name: string;
+    group?: string;
+}>;
+export type SessionTurnStatus = "queued" | "running" | "complete" | "completed" | "error" | "errored" | "cancelled" | "unknown" | "terminated";
+export interface SessionTurnFrameLabels {
+    queued?: ReactNode;
+    cancelled?: ReactNode;
+    unknown?: ReactNode;
+    terminated?: ReactNode;
+    failed?: ReactNode;
+}
+export interface SessionTurnFrameProps {
+    turnId: string;
+    sessionId?: string;
+    promptText?: string;
+    /** Product-owned prompt body when mentions or attachments need richer UI. */
+    promptNode?: ReactNode;
+    status: SessionTurnStatus;
+    errorMessage?: string;
+    errorNotice?: ReactNode;
+    labels?: SessionTurnFrameLabels;
+    hideStatusMessage?: boolean;
+    children?: ReactNode;
+    className?: string;
+}
+export interface SessionTurnFooterLabels {
+    copyAnswer: string;
+    answerCopied: string;
+    continueInNewChat: string;
+}
+export interface SessionTurnFooterProps {
+    status: SessionTurnStatus;
+    timestamp?: number | string;
+    copyText: string;
+    labels: SessionTurnFooterLabels;
+    onFork?: () => void;
+    /** Host override for desktop bridges and deterministic interaction tests. */
+    writeClipboard?: (text: string) => void | Promise<void>;
+    /** Host override when product locale formatting differs from the browser. */
+    formatTimestamp?: (timestamp: number | string) => ReactNode;
+}
+/**
+ * Shared DOM shell for a Backchat/OpenManaged session turn.
+ *
+ * Product adapters keep ownership of Markdown, tools, plans, subagents, and
+ * stores; this component owns the stable prompt/response hierarchy and status
+ * semantics so both products can evolve those slots without forking the
+ * session-level GUI structure again.
+ */
+export declare function SessionTurnFrame({ turnId, sessionId, promptText, promptNode, status, errorMessage, errorNotice, labels, hideStatusMessage, children, className, }: SessionTurnFrameProps): import("react").JSX.Element;
+/** Backchat-compatible metadata and actions for the end of a session turn. */
+export declare function SessionTurnFooter({ status, timestamp, copyText, labels, onFork, writeClipboard, formatTimestamp, }: SessionTurnFooterProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

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