@openma/common 0.0.0-stage → 0.9.0

package/dist/agent-contract/acp.js

@@ -0,0 +1,273 @@
+import { parseAcpEvent, sessionUpdateInner, sessionUpdateType, } from "../session-events/acp.js";
+import { OPENMA_EVENT_SCHEMA_VERSION, createRawEvent, immutableJson, } from "../session-events/openma.js";
+import { agentEventEnvelope, callbackFingerprint, createOpenMAEvent, } from "./index.js";
+const ACP_SOURCE = {
+    kind: "harness",
+    harness: "acp",
+    adapter: "acp",
+};
+function isCanonicalOpenMAEvent(event) {
+    return Boolean(event
+        && typeof event === "object"
+        && event.schema_version === OPENMA_EVENT_SCHEMA_VERSION);
+}
+function snapshotCanonicalOpenMAEvent(event, context) {
+    agentEventEnvelope(context, ACP_SOURCE);
+    const record = event;
+    const requiredStrings = ["event_id", "type", "session_id", "turn_id", "occurred_at"];
+    for (const field of requiredStrings) {
+        if (typeof record[field] !== "string" || record[field].length === 0) {
+            throw new TypeError(`Canonical OpenMA event requires ${field}`);
+        }
+    }
+    const expected = {
+        event_id: context.eventId,
+        session_id: context.sessionId,
+        turn_id: context.turnId,
+        occurred_at: context.occurredAt,
+        seq: context.seq,
+    };
+    for (const [field, value] of Object.entries(expected)) {
+        if (record[field] !== value) {
+            throw new Error(`Canonical OpenMA event ${field} does not match mapper context`);
+        }
+    }
+    if (!Object.prototype.hasOwnProperty.call(record, "data")) {
+        throw new TypeError("Canonical OpenMA event requires data");
+    }
+    const source = objectRecord(record.source);
+    if (typeof source.kind !== "string" || source.kind.length === 0) {
+        throw new TypeError("Canonical OpenMA event requires source.kind");
+    }
+    return immutableJson(event);
+}
+function toolEventType(status) {
+    if (status === "completed")
+        return "tool.completed";
+    if (status === "failed")
+        return "tool.failed";
+    if (status === "cancelled")
+        return "tool.cancelled";
+    if (status === "in_progress")
+        return "tool.progress";
+    return "tool.started";
+}
+function canonicalToolStatus(status) {
+    switch (status) {
+        case "pending":
+        case "in_progress":
+        case "completed":
+        case "failed":
+        case "cancelled":
+            return status;
+        default:
+            return undefined;
+    }
+}
+function objectRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function callbackCategory(method) {
+    if (method === "session/request_permission")
+        return "permission";
+    if (method.startsWith("elicitation/"))
+        return "elicitation";
+    if (method.startsWith("fs/"))
+        return "filesystem";
+    if (method.startsWith("terminal/"))
+        return "terminal";
+    if (method.startsWith("mcp/"))
+        return "mcp";
+    return "extension";
+}
+function acpRuntimeEventToOpenMA(event, context) {
+    const envelope = agentEventEnvelope(context, ACP_SOURCE);
+    if (event.type === "promptComplete") {
+        const response = objectRecord(event.response);
+        const stopReason = nonEmptyString(response.stopReason) ?? "unknown";
+        return createOpenMAEvent({
+            ...envelope,
+            type: stopReason === "cancelled" ? "turn.cancelled" : "turn.completed",
+            data: {
+                stop_reason: stopReason,
+                ...(response.usage !== undefined ? { usage: response.usage } : {}),
+            },
+        });
+    }
+    if (event.type === "promptError") {
+        return createOpenMAEvent({
+            ...envelope,
+            type: "turn.failed",
+            data: { error: String(event.error ?? "ACP prompt failed") },
+        });
+    }
+    if (event.type === "acp.client_request"
+        || event.type === "acp.client_response"
+        || event.type === "acp.client_error"
+        || event.type === "acp.client_notification") {
+        const method = nonEmptyString(event.method) ?? "acp/unknown";
+        const category = callbackCategory(method);
+        const callbackId = nonEmptyString(event.requestId);
+        const type = event.type === "acp.client_request"
+            ? "callback.requested"
+            : event.type === "acp.client_response"
+                ? "callback.completed"
+                : event.type === "acp.client_error"
+                    ? "callback.failed"
+                    : "callback.notification";
+        const data = {
+            method,
+            category,
+            ...(callbackId
+                ? {
+                    callback_id: callbackId,
+                    fingerprint: callbackFingerprint(context, category, method, callbackId, event.params),
+                }
+                : {}),
+            ...(event.params !== undefined ? { params: event.params } : {}),
+            ...(event.result !== undefined ? { result: event.result } : {}),
+            ...(event.error !== undefined ? { error: event.error } : {}),
+        };
+        return createOpenMAEvent({ ...envelope, type, data });
+    }
+    return undefined;
+}
+function acpSessionMetadataEventToOpenMA(event, context) {
+    const update = sessionUpdateType(event);
+    if (update !== "current_mode_update"
+        && update !== "config_option_update"
+        && update !== "session_info_update"
+        && update !== "usage_update")
+        return undefined;
+    const envelope = agentEventEnvelope(context, ACP_SOURCE);
+    const data = sessionUpdateInner(event);
+    return createOpenMAEvent({
+        ...envelope,
+        type: update === "usage_update" ? "usage.updated" : "capability.updated",
+        data: { update, value: data },
+    });
+}
+export function acpEventToOpenMA(event, context) {
+    if (isCanonicalOpenMAEvent(event)) {
+        return snapshotCanonicalOpenMAEvent(event, context);
+    }
+    const runtimeEvent = acpRuntimeEventToOpenMA(objectRecord(event), context);
+    if (runtimeEvent)
+        return runtimeEvent;
+    const sessionMetadataEvent = acpSessionMetadataEventToOpenMA(event, context);
+    if (sessionMetadataEvent)
+        return sessionMetadataEvent;
+    const envelope = agentEventEnvelope(context, ACP_SOURCE);
+    const parsed = parseAcpEvent(event);
+    switch (parsed.kind) {
+        case "text":
+            return createOpenMAEvent({
+                ...envelope,
+                ...(parsed.parentToolUseId ? { parent_id: parsed.parentToolUseId } : {}),
+                type: "agent.message_chunk",
+                data: {
+                    text: parsed.text,
+                    ...(parsed.messageId ? { message_id: parsed.messageId } : {}),
+                    ...(parsed.phase ? { phase: parsed.phase } : {}),
+                },
+            });
+        case "thought":
+            return createOpenMAEvent({
+                ...envelope,
+                ...(parsed.parentToolUseId ? { parent_id: parsed.parentToolUseId } : {}),
+                type: "agent.thinking",
+                data: {
+                    text: parsed.text,
+                    ...(parsed.messageId ? { message_id: parsed.messageId } : {}),
+                },
+            });
+        case "notice":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "system.notice",
+                data: { message: parsed.notice },
+            });
+        case "tool_call": {
+            const type = toolEventType(parsed.tool.status);
+            const status = canonicalToolStatus(parsed.tool.status);
+            return createOpenMAEvent({
+                ...envelope,
+                ...(parsed.tool.parentToolUseId ? { parent_id: parsed.tool.parentToolUseId } : {}),
+                type,
+                data: {
+                    tool_call_id: parsed.tool.toolCallId,
+                    ...(parsed.tool.title !== undefined ? { title: parsed.tool.title } : {}),
+                    ...(parsed.tool.kind !== undefined ? { kind: parsed.tool.kind } : {}),
+                    ...(status !== undefined ? { status } : {}),
+                    ...(parsed.tool.toolName !== undefined
+                        ? { tool_name: parsed.tool.toolName }
+                        : {}),
+                    ...(parsed.tool.rawInput !== undefined
+                        ? { raw_input: parsed.tool.rawInput }
+                        : {}),
+                    ...(parsed.tool.rawOutput !== undefined
+                        ? { raw_output: parsed.tool.rawOutput }
+                        : {}),
+                    ...(parsed.tool.content !== undefined ? { content: parsed.tool.content } : {}),
+                    ...(parsed.tool.locations !== undefined
+                        ? { locations: parsed.tool.locations }
+                        : {}),
+                    ...(parsed.tool.meta !== undefined
+                        ? { adapter_meta: parsed.tool.meta }
+                        : {}),
+                },
+            });
+        }
+        case "commands":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "command_catalog.updated",
+                data: { commands: parsed.commands },
+            });
+        case "plan":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "plan.updated",
+                data: {
+                    representation: "items",
+                    ...(parsed.planId ? { plan_id: parsed.planId } : {}),
+                    ...(parsed.updateMode ? { update_mode: parsed.updateMode } : {}),
+                    entries: parsed.plan,
+                    ...(parsed.document ? { document: parsed.document } : {}),
+                },
+            });
+        case "plan_document":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "plan.updated",
+                data: { representation: "markdown", document: parsed.document },
+            });
+        case "plan_removed":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "plan.removed",
+                data: parsed.planId ? { plan_id: parsed.planId } : {},
+            });
+        case "note":
+            return createOpenMAEvent({
+                ...envelope,
+                type: "system.notice",
+                data: { message: parsed.note },
+            });
+        case "silent":
+        case "raw":
+            return createRawEvent({
+                ...envelope,
+                source_kind: "acp",
+                method: "session/update",
+                payload: event,
+                reason: parsed.kind === "raw" ? "unknown" : "unsupported",
+            });
+    }
+}
+//# sourceMappingURL=acp.js.map

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

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

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

@@ -0,0 +1,125 @@
+import { createOpenMAEvent as createLegacyOpenMAEvent, type DeepReadonly, type CallbackCategory, type CallbackRequestedData, type CallbackRequestedEvent, type JsonObject, type JsonValue, type OpenMAEvent, type OpenMAEventSource, type TurnTerminalEvent } from "../session-events/openma.js";
+export * from "../session-events/openma.js";
+/** Agent Contract facts cross a strict, immutable JSON boundary. Legacy
+ * session-events callers retain their existing event constructor behavior. */
+export declare function createOpenMAEvent<TType extends string, TData>(input: Parameters<typeof createLegacyOpenMAEvent<TType, TData>>[0]): DeepReadonly<ReturnType<typeof createLegacyOpenMAEvent<TType, TData>>>;
+export type AgentPlacement = "local" | "remote" | "managed";
+export interface AgentSessionHandle {
+    readonly connectorId: string;
+    readonly externalSessionId: string;
+    readonly placement: AgentPlacement;
+    readonly resumeToken?: string;
+    readonly metadata?: JsonObject;
+}
+export declare function createAgentSessionHandle(input: AgentSessionHandle): Readonly<AgentSessionHandle>;
+export type AgentSessionPersistence = "ephemeral" | "resumable" | "persistent";
+export interface AgentCapabilities {
+    readonly sessionPersistence: AgentSessionPersistence;
+    readonly streaming: boolean;
+    readonly cancellation: boolean;
+    readonly permissions: boolean;
+    readonly elicitation: boolean;
+    readonly steering?: boolean;
+    readonly customTools?: boolean;
+    readonly mcp?: boolean;
+    readonly extensions?: JsonObject;
+}
+export interface AgentSessionInput {
+    /** Canonical durable Session id chosen by the host before remote creation. */
+    readonly sessionId: string;
+    /** Stable key for replaying remote Session creation without duplication. */
+    readonly idempotencyKey: string;
+    readonly generation: number;
+    readonly agentId: string;
+    readonly cwd?: string;
+    readonly additionalDirectories?: readonly string[];
+    readonly resume?: AgentSessionHandle;
+    readonly metadata?: JsonObject;
+}
+export interface AgentContentBlock {
+    readonly type: string;
+    readonly [key: string]: JsonValue;
+}
+export type AgentContent = string | readonly AgentContentBlock[];
+export interface AgentTurnInput {
+    /** Canonical durable Session id used by every emitted OpenMA event. */
+    readonly sessionId: string;
+    readonly turnId: string;
+    /** Last sequence already committed by the host during crash recovery. */
+    readonly afterSequence: number;
+    readonly contextDigest?: string;
+    readonly content: AgentContent;
+    readonly grants?: readonly string[];
+    readonly workspace?: {
+        readonly cwd?: string;
+        readonly additionalDirectories?: readonly string[];
+    };
+    readonly metadata?: JsonObject;
+}
+export type AgentCommand = {
+    type: "turn.steer";
+    content: AgentContent;
+} | {
+    type: "turn.cancel";
+    turnId: string;
+} | {
+    type: "callback.respond";
+    callbackId: string;
+    result?: JsonValue;
+    error?: JsonValue;
+};
+export interface OpenMAAgentConnector {
+    readonly id: string;
+    capabilities(): Promise<AgentCapabilities>;
+    /** MUST be idempotent by input.idempotencyKey. A replay returns the same
+     * remote Session identity instead of creating an orphan Session. */
+    open(input: AgentSessionInput): Promise<AgentSessionHandle>;
+    /** A repeated logical turnId MUST resume/replay that Turn without repeating
+     * already-applied Agent/tool side effects. Events at or below afterSequence
+     * may be omitted; emitted facts keep the supplied sessionId and turnId. */
+    execute(session: AgentSessionHandle, input: AgentTurnInput): AsyncIterable<OpenMAEvent>;
+    /** Repeating callback.respond for one callbackId or turn.cancel for one
+     * turnId MUST be safe and equivalent to one application. */
+    send(session: AgentSessionHandle, command: AgentCommand): Promise<void>;
+    /** MUST be idempotent. An already-closed or provider-missing Session is a
+     * successful close, not a permanent replay failure. */
+    close(session: AgentSessionHandle): Promise<void>;
+}
+export interface AgentEventContext {
+    readonly eventId: string;
+    readonly sessionId: string;
+    readonly occurredAt: string;
+    readonly source?: OpenMAEventSource;
+    readonly sessionThreadId?: string;
+    readonly turnId: string;
+    readonly workItemId?: string;
+    readonly parentEventId?: string;
+    readonly parentId?: string;
+    readonly seq: number;
+}
+export declare function agentEventEnvelope(context: AgentEventContext, defaultSource: OpenMAEventSource): {
+    event_id: string;
+    session_id: string;
+    source: OpenMAEventSource;
+    occurred_at: string;
+    session_thread_id?: string;
+    turn_id: string;
+    work_item_id?: string;
+    parent_event_id?: string;
+    parent_id?: string;
+    seq: number;
+};
+export type AgentTurnTerminalStatus = "completed" | "failed" | "cancelled" | "interrupted";
+export declare function turnTerminalStatus(event: OpenMAEvent): AgentTurnTerminalStatus | undefined;
+export declare function isTurnTerminalEvent(event: OpenMAEvent): event is TurnTerminalEvent;
+export type CallbackRequestEventFor<TCategory extends CallbackCategory> = Omit<CallbackRequestedEvent, "data"> & {
+    data: CallbackRequestedData & {
+        category: TCategory;
+    };
+};
+export declare function isCallbackRequestEvent<TCategory extends CallbackCategory>(event: OpenMAEvent, category: TCategory): event is CallbackRequestEventFor<TCategory>;
+export declare function isCallbackRequestEvent(event: OpenMAEvent): event is CallbackRequestedEvent;
+export declare function isPermissionRequestEvent(event: OpenMAEvent): event is CallbackRequestEventFor<"permission">;
+export declare function isElicitationRequestEvent(event: OpenMAEvent): event is CallbackRequestEventFor<"elicitation">;
+export declare function callbackFingerprint(context: Pick<AgentEventContext, "sessionId" | "turnId">, category: CallbackCategory, method: string, callbackId: string, params: unknown): string;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/agent-contract/index.js

@@ -0,0 +1,102 @@
+import { createOpenMAEvent as createLegacyOpenMAEvent, immutableJson, } from "../session-events/openma.js";
+export * from "../session-events/openma.js";
+/** Agent Contract facts cross a strict, immutable JSON boundary. Legacy
+ * session-events callers retain their existing event constructor behavior. */
+export function createOpenMAEvent(input) {
+    return immutableJson(createLegacyOpenMAEvent(input));
+}
+export function createAgentSessionHandle(input) {
+    if (!input.connectorId.trim())
+        throw new Error("connectorId must not be empty");
+    if (!input.externalSessionId.trim()) {
+        throw new Error("externalSessionId must not be empty");
+    }
+    return immutableJson(input);
+}
+export function agentEventEnvelope(context, defaultSource) {
+    if (!context.eventId.trim())
+        throw new Error("eventId must not be empty");
+    if (!context.sessionId.trim())
+        throw new Error("sessionId must not be empty");
+    if (!context.turnId.trim())
+        throw new Error("turnId must not be empty");
+    if (!context.occurredAt.trim())
+        throw new Error("occurredAt must not be empty");
+    if (!Number.isSafeInteger(context.seq) || context.seq < 0) {
+        throw new Error("seq must be a non-negative safe integer");
+    }
+    return {
+        event_id: context.eventId,
+        session_id: context.sessionId,
+        source: context.source ?? defaultSource,
+        occurred_at: context.occurredAt,
+        ...(context.sessionThreadId ? { session_thread_id: context.sessionThreadId } : {}),
+        turn_id: context.turnId,
+        ...(context.workItemId ? { work_item_id: context.workItemId } : {}),
+        ...(context.parentEventId ? { parent_event_id: context.parentEventId } : {}),
+        ...(context.parentId ? { parent_id: context.parentId } : {}),
+        seq: context.seq,
+    };
+}
+const TURN_TERMINAL_TYPES = {
+    "turn.completed": "completed",
+    "turn.failed": "failed",
+    "turn.cancelled": "cancelled",
+    "turn.interrupted": "interrupted",
+};
+export function turnTerminalStatus(event) {
+    const status = TURN_TERMINAL_TYPES[event.type];
+    if (status === undefined
+        || typeof event.turn_id !== "string"
+        || event.turn_id.length === 0
+        || !Number.isSafeInteger(event.seq)
+        || (event.seq ?? -1) < 0)
+        return undefined;
+    return status;
+}
+export function isTurnTerminalEvent(event) {
+    return turnTerminalStatus(event) !== undefined;
+}
+export function isCallbackRequestEvent(event, category) {
+    if (event.type !== "callback.requested")
+        return false;
+    if (!event.data || typeof event.data !== "object")
+        return false;
+    const data = event.data;
+    if (typeof data.callback_id !== "string"
+        || data.callback_id.length === 0
+        || typeof data.fingerprint !== "string"
+        || data.fingerprint.length === 0
+        || typeof data.method !== "string"
+        || data.method.length === 0)
+        return false;
+    return category === undefined
+        || data.category === category;
+}
+export function isPermissionRequestEvent(event) {
+    return isCallbackRequestEvent(event, "permission");
+}
+export function isElicitationRequestEvent(event) {
+    return isCallbackRequestEvent(event, "elicitation");
+}
+export function callbackFingerprint(context, category, method, callbackId, params) {
+    const segments = [
+        context.sessionId,
+        context.turnId,
+        category,
+        method,
+        callbackId,
+    ].map(encodeURIComponent);
+    const normalizedParams = immutableJson(params ?? null);
+    return `oma.callback.v1/${segments.join("/")}/${encodeURIComponent(canonicalJsonStringify(normalizedParams))}`;
+}
+function canonicalJsonStringify(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalJsonStringify).join(",")}]`;
+    }
+    const object = value;
+    return `{${Object.keys(object).sort().map((key) => `${JSON.stringify(key)}:${canonicalJsonStringify(object[key])}`).join(",")}}`;
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/agent-contract/managed.d.ts

@@ -0,0 +1,5 @@
+import { type WireSessionEvent } from "../session-events/managed.js";
+import { type OpenMAEvent } from "../session-events/openma.js";
+import { type AgentEventContext } from "./index.js";
+export declare function managedEventToOpenMA(event: WireSessionEvent, context: AgentEventContext): OpenMAEvent;
+//# sourceMappingURL=managed.d.ts.map

package/dist/agent-contract/managed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed.d.ts","sourceRoot":"","sources":["../../src/agent-contract/managed.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAgCpB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,iBAAiB,GACzB,WAAW,CAiPb"}