@openma/common 0.0.0-stage → 0.9.1

package/dist/agent-contract/managed.js

@@ -0,0 +1,242 @@
+import { eventThreadId, normalizeSessionEvent, } from "../session-events/managed.js";
+import { createVendorEvent, } from "../session-events/openma.js";
+import { agentEventEnvelope, callbackFingerprint, createOpenMAEvent, } from "./index.js";
+const MANAGED_SOURCE = {
+    kind: "harness",
+    harness: "claude-managed",
+    adapter: "managed",
+};
+function managedEnvelope(event, context) {
+    return agentEventEnvelope({
+        ...context,
+        sessionThreadId: context.sessionThreadId ?? eventThreadId(event),
+    }, MANAGED_SOURCE);
+}
+function objectRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function stringField(event, ...names) {
+    for (const name of names) {
+        const value = event[name];
+        if (typeof value === "string" && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+export function managedEventToOpenMA(event, context) {
+    const envelope = managedEnvelope(event, context);
+    if (event.type === "agent.tool_use" && event.evaluated_permission === "ask") {
+        const callbackId = stringField(event, "id", "tool_use_id") ?? context.eventId;
+        const method = "tool/permission";
+        const params = {
+            tool_name: stringField(event, "name", "tool_name") ?? "tool",
+            input: event.input ?? {},
+        };
+        const data = {
+            callback_id: callbackId,
+            fingerprint: callbackFingerprint(context, "permission", method, callbackId, params),
+            method,
+            category: "permission",
+            params,
+        };
+        return createOpenMAEvent({
+            ...envelope,
+            type: "callback.requested",
+            data,
+        });
+    }
+    if (event.type === "user.tool_confirmation") {
+        const callbackId = stringField(event, "tool_use_id", "id") ?? context.eventId;
+        const method = "tool/permission";
+        const denied = event.result === "deny";
+        const data = {
+            callback_id: callbackId,
+            method,
+            category: "permission",
+            result: {
+                outcome: denied ? "deny" : "allow",
+                ...(denied && typeof event.deny_message === "string"
+                    ? { message: event.deny_message }
+                    : {}),
+            },
+        };
+        return createOpenMAEvent({
+            ...envelope,
+            type: "callback.completed",
+            data,
+        });
+    }
+    if (event.type === "agent.custom_tool_use") {
+        const callbackId = stringField(event, "id", "tool_use_id") ?? context.eventId;
+        const toolName = stringField(event, "name", "tool_name") ?? "custom";
+        const method = "tool/custom";
+        const params = { tool_name: toolName, input: event.input ?? {} };
+        const data = {
+            callback_id: callbackId,
+            fingerprint: callbackFingerprint(context, "extension", method, callbackId, params),
+            method,
+            category: "extension",
+            params,
+        };
+        return createOpenMAEvent({
+            ...envelope,
+            type: "callback.requested",
+            data,
+        });
+    }
+    if (event.type === "user.custom_tool_result") {
+        const callbackId = stringField(event, "custom_tool_use_id", "tool_use_id", "id") ?? context.eventId;
+        const failed = event.is_error === true;
+        const data = {
+            callback_id: callbackId,
+            method: "tool/custom",
+            category: "extension",
+            ...(failed
+                ? { error: event.content ?? "Custom tool failed" }
+                : { result: event.content ?? null }),
+        };
+        return createOpenMAEvent({
+            ...envelope,
+            type: failed ? "callback.failed" : "callback.completed",
+            data,
+        });
+    }
+    if (event.type === "user.interrupt") {
+        return createOpenMAEvent({
+            ...envelope,
+            type: "turn.interrupted",
+            data: { reason: "user_interrupt" },
+        });
+    }
+    if (event.type === "session.status_rescheduled") {
+        return createOpenMAEvent({
+            ...envelope,
+            type: "turn.queued",
+            data: {
+                ...(typeof event.reason === "string" ? { reason: event.reason } : {}),
+            },
+        });
+    }
+    const normalized = normalizeSessionEvent(event);
+    switch (normalized.kind) {
+        case "user_message":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "user.message",
+                data: { text: normalized.text, message_id: normalized.id },
+            });
+        case "assistant_delta":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "agent.message_chunk",
+                data: { text: normalized.text, message_id: normalized.id },
+            });
+        case "assistant_message":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "agent.message",
+                data: { text: normalized.text, message_id: normalized.id },
+            });
+        case "thinking_delta":
+        case "thinking":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "agent.thinking",
+                data: { text: normalized.text, message_id: normalized.id },
+            });
+        case "tool_input_start":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "tool.started",
+                data: {
+                    tool_call_id: normalized.toolId,
+                    tool_name: normalized.name,
+                    status: "pending",
+                },
+            });
+        case "tool_use":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "tool.started",
+                data: {
+                    tool_call_id: normalized.tool.id,
+                    tool_name: normalized.tool.name,
+                    status: "in_progress",
+                    raw_input: normalized.tool.input,
+                },
+            });
+        case "tool_result":
+            return createOpenMAEvent({
+                ...envelope,
+                type: normalized.isError ? "tool.failed" : "tool.completed",
+                data: {
+                    tool_call_id: normalized.toolId,
+                    status: normalized.isError ? "failed" : "completed",
+                    raw_output: normalized.output,
+                },
+            });
+        case "notice":
+            return createOpenMAEvent({
+                ...envelope,
+                type: normalized.tone === "error" ? "session.error" : "system.notice",
+                data: {
+                    message: normalized.message,
+                    tone: normalized.tone,
+                    ...(normalized.source ? { source: normalized.source } : {}),
+                },
+            });
+        case "turn_running":
+            return createOpenMAEvent({ ...envelope, type: "turn.started", data: {} });
+        case "turn_complete": {
+            const stopReason = stringField(objectRecord(event.stop_reason), "type");
+            const type = stopReason === "retries_exhausted"
+                ? "turn.failed"
+                : stopReason === "cancelled"
+                    ? "turn.cancelled"
+                    : stopReason === "interrupted"
+                        ? "turn.interrupted"
+                        : "turn.completed";
+            return createOpenMAEvent({
+                ...envelope,
+                type,
+                data: {
+                    ...(stopReason ? { stop_reason: stopReason } : {}),
+                    ...(Array.isArray(objectRecord(event.stop_reason).event_ids)
+                        ? { callback_ids: objectRecord(event.stop_reason).event_ids }
+                        : {}),
+                },
+            });
+        }
+        case "turn_terminated":
+            return createOpenMAEvent({ ...envelope, type: "session.terminated", data: {} });
+        case "assistant_stream_end":
+        case "thinking_stream_end":
+            return createVendorEvent({
+                ...envelope,
+                harness: "claude-managed",
+                namespace: "claudeManaged",
+                name: event.type,
+                correlation: {
+                    session_id: context.sessionId,
+                    ...(context.turnId ? { turn_id: context.turnId } : {}),
+                },
+                data: event,
+            });
+        case "ignore":
+            return createVendorEvent({
+                ...envelope,
+                harness: "claude-managed",
+                namespace: "claudeManaged",
+                name: event.type || "unknown",
+                correlation: {
+                    session_id: context.sessionId,
+                    ...(context.turnId ? { turn_id: context.turnId } : {}),
+                    ...(context.workItemId ? { work_item_id: context.workItemId } : {}),
+                },
+                data: event,
+            });
+    }
+}
+//# sourceMappingURL=managed.js.map

package/dist/agent-contract/managed.js.map

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

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

@@ -0,0 +1,170 @@
+import type { OpenMAEvent, CanonicalPlanEntry, CallbackCategory, PlanRepresentation, ToolOutputData, ToolStatus, WorkItemKind, WorkItemStatus } from "../session-events/openma.js";
+export declare const AGENT_UI_STATE_VERSION: "oma.agent-ui.v1";
+export type AgentUISessionStatus = "unknown" | "running" | "rescheduled" | "idle" | "terminated" | "error";
+export type AgentUITurnStatus = "unknown" | "queued" | "running" | "completed" | "failed" | "cancelled";
+export interface AgentUIMessageItem {
+    id: string;
+    /** Present when a tool split one protocol message into multiple UI segments. */
+    messageId?: string;
+    kind: "message" | "thinking" | "notice";
+    role: "user" | "assistant" | "system";
+    text: string;
+    status: "streaming" | "complete";
+    content?: unknown;
+    /** Event-clock boundaries for a thought segment, preserved through replay. */
+    startedAt?: string;
+    endedAt?: string;
+    phase?: "commentary" | "final_answer";
+}
+export interface AgentUIToolItem {
+    id: string;
+    kind: "tool";
+    name?: string;
+    title?: string;
+    toolKind?: string;
+    status: ToolStatus;
+    rawInput?: unknown;
+    rawOutput?: unknown;
+    content?: unknown[];
+    locations?: Array<{
+        path?: string;
+        line?: number;
+    }>;
+    adapterMeta?: Record<string, unknown>;
+    outputs: ToolOutputData[];
+    error?: string;
+    reason?: string;
+}
+export interface AgentUIRawItem {
+    id: string;
+    kind: "raw";
+    event: OpenMAEvent;
+}
+export type AgentUITimelineItem = AgentUIMessageItem | AgentUIToolItem | AgentUIRawItem;
+export interface AgentUIWorkItemState {
+    id: string;
+    kind: WorkItemKind;
+    status: WorkItemStatus;
+    title?: string;
+    progress?: number;
+    output: unknown[];
+    result?: unknown;
+    error?: string;
+    reason?: string;
+    startedAt?: string;
+    endedAt?: string;
+    missingStart?: boolean;
+    missingTerminal?: boolean;
+}
+export interface AgentUIPlanState {
+    id: string;
+    representation: PlanRepresentation;
+    status: "active" | "completed";
+    entries: CanonicalPlanEntry[];
+}
+export interface AgentUICallbackState {
+    id: string;
+    category: CallbackCategory;
+    method: string;
+    status: "pending" | "completed" | "failed" | "notification";
+    params?: unknown;
+    result?: unknown;
+    error?: unknown;
+}
+export interface AgentUIUsageState {
+    snapshot: unknown;
+    budget?: unknown;
+    updatedAt: string;
+}
+export interface AgentUIOutcomeState {
+    id: string;
+    status: string;
+    description?: string;
+    rubric?: unknown;
+    maxIterations?: number | null;
+    iteration?: number;
+    explanation?: string;
+    usage?: unknown;
+    updatedAt: string;
+}
+export interface AgentUISessionInfoState {
+    title?: string | null;
+    updatedAt?: string | null;
+}
+export interface AgentUITurnState {
+    id: string;
+    status: AgentUITurnStatus;
+    items: AgentUITimelineItem[];
+    error?: string;
+    reason?: string;
+    startedAt?: string;
+    endedAt?: string;
+}
+export interface AgentUIState {
+    version: typeof AGENT_UI_STATE_VERSION;
+    sessionId: string;
+    status: AgentUISessionStatus;
+    sessionInfo: AgentUISessionInfoState;
+    commands: unknown[];
+    capabilities: Record<string, unknown>;
+    activeTurnId?: string;
+    turnOrder: string[];
+    turns: Record<string, AgentUITurnState>;
+    workItemOrder: string[];
+    workItems: Record<string, AgentUIWorkItemState>;
+    planOrder: string[];
+    plans: Record<string, AgentUIPlanState>;
+    callbackOrder: string[];
+    callbacks: Record<string, AgentUICallbackState>;
+    usage?: AgentUIUsageState;
+    outcomeOrder: string[];
+    outcomes: Record<string, AgentUIOutcomeState>;
+    seenEventIds: Record<string, true>;
+    lastError?: string;
+}
+export declare function createAgentUIState(sessionId: string): AgentUIState;
+export declare function mergeAgentUIStreamingText(accumulated: string, incoming: string): string;
+export declare function reduceAgentUIEvent(state: AgentUIState, event: OpenMAEvent): AgentUIState;
+export declare function replayAgentUIEvents(sessionId: string, events: readonly OpenMAEvent[]): AgentUIState;
+export interface AgentUIStore {
+    getState(): AgentUIState;
+    getSnapshot(): AgentUIState;
+    dispatch(event: OpenMAEvent): AgentUIState;
+    subscribe(listener: (state: AgentUIState) => void): () => void;
+    subscribeTurnStream(turnId: string, listener: AgentUIStreamSubscriber): () => void;
+}
+/** Append-only host event row used by Backchat-compatible session stores.
+ * The host owns persistence; common owns deterministic replay into Agent UI. */
+export interface PersistedAgentUIEvent {
+    seq: number;
+    type: string;
+    data: unknown;
+    ts: number;
+}
+export type PersistedAgentUIEventDecoder = (row: PersistedAgentUIEvent) => OpenMAEvent | readonly OpenMAEvent[] | null | undefined;
+/** Rebuild a live Agent UI store from persisted host events. Stable seq
+ * ordering and the store's event-id dedupe make repeated hydration safe. */
+export declare function replayAgentUIEventLog(store: AgentUIStore, rows: readonly PersistedAgentUIEvent[], decode: PersistedAgentUIEventDecoder): AgentUIState;
+/**
+ * In-memory transcript authority keyed by product session id. A host may swap
+ * or reconnect transports, but selecting a session must resolve back to the
+ * same store until the host explicitly removes it.
+ */
+export interface AgentUISessionRegistry {
+    get(sessionId: string): AgentUIStore;
+    has(sessionId: string): boolean;
+    remove(sessionId: string): boolean;
+    clear(): void;
+}
+export declare function createAgentUISessionRegistry(): AgentUISessionRegistry;
+export type AgentUIStreamDelta = {
+    kind: "assistant";
+    text: string;
+} | {
+    kind: "thought";
+    text: string;
+};
+export type AgentUIStreamSubscriber = (delta: AgentUIStreamDelta) => void;
+export declare function createAgentUIStore(sessionId: string): AgentUIStore;
+export * from "./presentation.js";
+//# sourceMappingURL=index.d.ts.map

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

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