acpx 0.4.0 → 0.5.0

package/dist/{output-render-C7w9NZ2H.js → render-BL5ynRkN.js}

@@ -1,15 +1,16 @@
 import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
-import { N as normalizeRuntimeSessionId, s as probeQueueOwnerHealth } from "./queue-ipc-CgWf63GN.js";
+import { u as normalizeRuntimeSessionId } from "./perf-metrics-D9QC81lB.js";
+import { s as probeQueueOwnerHealth } from "./ipc-DN6M4Ui9.js";
 import path from "node:path";
-//#region src/cli/json-output.ts
+//#region src/cli/output/json-output.ts
 function emitJsonResult(format, payload) {
 	if (format !== "json") return false;
 	process.stdout.write(`${JSON.stringify(payload)}\n`);
 	return true;
 }
 //#endregion
-//#region src/cli/output-render.ts
-var output_render_exports = /* @__PURE__ */ __exportAll({
+//#region src/cli/output/render.ts
+var render_exports = /* @__PURE__ */ __exportAll({
 	agentSessionIdPayload: () => agentSessionIdPayload,
 	formatPromptSessionBannerLine: () => formatPromptSessionBannerLine,
 	printClosedSessionByFormat: () => printClosedSessionByFormat,
@@ -134,6 +135,6 @@ function agentSessionIdPayload(agentSessionId) {
 	return { agentSessionId: normalized };
 }
 //#endregion
-export { emitJsonResult as i, formatPromptSessionBannerLine as n, output_render_exports as r, agentSessionIdPayload as t };
+export { emitJsonResult as i, formatPromptSessionBannerLine as n, render_exports as r, agentSessionIdPayload as t };
 
-//# sourceMappingURL=output-render-C7w9NZ2H.js.map
+//# sourceMappingURL=render-BL5ynRkN.js.map

package/dist/render-BL5ynRkN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-BL5ynRkN.js","names":[],"sources":["../src/cli/output/json-output.ts","../src/cli/output/render.ts"],"sourcesContent":["import type { OutputFormat } from \"../../types.js\";\n\nexport function emitJsonResult(format: OutputFormat, payload: unknown): boolean {\n  if (format !== \"json\") {\n    return false;\n  }\n  process.stdout.write(`${JSON.stringify(payload)}\\n`);\n  return true;\n}\n","import path from \"node:path\";\nimport { normalizeRuntimeSessionId } from \"../../session/runtime-session-id.js\";\nimport type { OutputFormat, SessionRecord } from \"../../types.js\";\nimport { probeQueueOwnerHealth } from \"../queue/ipc.js\";\nimport { emitJsonResult } from \"./json-output.js\";\n\nfunction formatSessionLabel(record: SessionRecord): string {\n  return record.name ?? \"cwd\";\n}\n\nfunction formatRoutedFrom(sessionCwd: string, currentCwd: string): string | undefined {\n  const relative = path.relative(sessionCwd, currentCwd);\n  if (!relative || relative === \".\") {\n    return undefined;\n  }\n  return relative.startsWith(\".\") ? relative : `.${path.sep}${relative}`;\n}\n\ntype SessionConnectionStatus = \"connected\" | \"needs reconnect\";\n\nasync function resolveSessionConnectionStatus(\n  record: SessionRecord,\n): Promise<SessionConnectionStatus> {\n  const health = await probeQueueOwnerHealth(record.acpxRecordId);\n  return health.healthy ? \"connected\" : \"needs reconnect\";\n}\n\nexport function printSessionsByFormat(sessions: SessionRecord[], format: OutputFormat): void {\n  if (format === \"json\") {\n    process.stdout.write(`${JSON.stringify(sessions)}\\n`);\n    return;\n  }\n\n  if (format === \"quiet\") {\n    for (const session of sessions) {\n      const closedMarker = session.closed ? \" [closed]\" : \"\";\n      process.stdout.write(`${session.acpxRecordId}${closedMarker}\\n`);\n    }\n    return;\n  }\n\n  if (sessions.length === 0) {\n    process.stdout.write(\"No sessions\\n\");\n    return;\n  }\n\n  for (const session of sessions) {\n    const closedMarker = session.closed ? \" [closed]\" : \"\";\n    process.stdout.write(\n      `${session.acpxRecordId}${closedMarker}\\t${session.name ?? \"-\"}\\t${session.cwd}\\t${session.lastUsedAt}\\n`,\n    );\n  }\n}\n\nexport function printClosedSessionByFormat(record: SessionRecord, format: OutputFormat): void {\n  if (\n    emitJsonResult(format, {\n      action: \"session_closed\",\n      acpxRecordId: record.acpxRecordId,\n      acpxSessionId: record.acpSessionId,\n      agentSessionId: record.agentSessionId,\n    })\n  ) {\n    return;\n  }\n\n  if (format === \"quiet\") {\n    return;\n  }\n\n  process.stdout.write(`${record.acpxRecordId}\\n`);\n}\n\nexport function printNewSessionByFormat(\n  record: SessionRecord,\n  replaced: SessionRecord | undefined,\n  format: OutputFormat,\n): void {\n  if (\n    emitJsonResult(format, {\n      action: \"session_ensured\",\n      created: true,\n      acpxRecordId: record.acpxRecordId,\n      acpxSessionId: record.acpSessionId,\n      agentSessionId: record.agentSessionId,\n      name: record.name,\n      replacedSessionId: replaced?.acpxRecordId,\n    })\n  ) {\n    return;\n  }\n\n  if (format === \"quiet\") {\n    process.stdout.write(`${record.acpxRecordId}\\n`);\n    return;\n  }\n\n  if (replaced) {\n    process.stdout.write(`${record.acpxRecordId}\\t(replaced ${replaced.acpxRecordId})\\n`);\n    return;\n  }\n\n  process.stdout.write(`${record.acpxRecordId}\\n`);\n}\n\nexport function printEnsuredSessionByFormat(\n  record: SessionRecord,\n  created: boolean,\n  format: OutputFormat,\n): void {\n  if (\n    emitJsonResult(format, {\n      action: \"session_ensured\",\n      created,\n      acpxRecordId: record.acpxRecordId,\n      acpxSessionId: record.acpSessionId,\n      agentSessionId: record.agentSessionId,\n      name: record.name,\n    })\n  ) {\n    return;\n  }\n\n  if (format === \"quiet\") {\n    process.stdout.write(`${record.acpxRecordId}\\n`);\n    return;\n  }\n\n  const action = created ? \"created\" : \"existing\";\n  process.stdout.write(`${record.acpxRecordId}\\t(${action})\\n`);\n}\n\nexport function printQueuedPromptByFormat(\n  result: {\n    sessionId: string;\n    requestId: string;\n  },\n  format: OutputFormat,\n): void {\n  if (\n    emitJsonResult(format, {\n      action: \"prompt_queued\",\n      acpxRecordId: result.sessionId,\n      requestId: result.requestId,\n    })\n  ) {\n    return;\n  }\n\n  if (format === \"quiet\") {\n    return;\n  }\n\n  process.stdout.write(`[queued] ${result.requestId}\\n`);\n}\n\nexport function formatPromptSessionBannerLine(\n  record: SessionRecord,\n  currentCwd: string,\n  connectionStatus: SessionConnectionStatus = \"needs reconnect\",\n): string {\n  const label = formatSessionLabel(record);\n  const normalizedSessionCwd = path.resolve(record.cwd);\n  const normalizedCurrentCwd = path.resolve(currentCwd);\n  const routedFrom =\n    normalizedSessionCwd === normalizedCurrentCwd\n      ? undefined\n      : formatRoutedFrom(normalizedSessionCwd, normalizedCurrentCwd);\n  const status = connectionStatus;\n\n  if (routedFrom) {\n    return `[acpx] session ${label} (${record.acpxRecordId}) · ${normalizedSessionCwd} (routed from ${routedFrom}) · agent ${status}`;\n  }\n\n  return `[acpx] session ${label} (${record.acpxRecordId}) · ${normalizedSessionCwd} · agent ${status}`;\n}\n\nexport async function printPromptSessionBanner(\n  record: SessionRecord,\n  currentCwd: string,\n  format: OutputFormat,\n  jsonStrict = false,\n): Promise<void> {\n  if (format === \"quiet\" || (jsonStrict && format === \"json\")) {\n    return;\n  }\n\n  const status = await resolveSessionConnectionStatus(record);\n  process.stderr.write(`${formatPromptSessionBannerLine(record, currentCwd, status)}\\n`);\n}\n\nexport function printCreatedSessionBanner(\n  record: SessionRecord,\n  agentName: string,\n  format: OutputFormat,\n  jsonStrict = false,\n): void {\n  if (format === \"quiet\" || (jsonStrict && format === \"json\")) {\n    return;\n  }\n\n  const label = formatSessionLabel(record);\n  process.stderr.write(`[acpx] created session ${label} (${record.acpxRecordId})\\n`);\n  process.stderr.write(`[acpx] agent: ${agentName}\\n`);\n  process.stderr.write(`[acpx] cwd: ${record.cwd}\\n`);\n}\n\nexport function agentSessionIdPayload(agentSessionId: string | undefined): {\n  agentSessionId?: string;\n} {\n  const normalized = normalizeRuntimeSessionId(agentSessionId);\n  if (!normalized) {\n    return {};\n  }\n\n  return { agentSessionId: normalized };\n}\n"],"mappings":"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"}

package/dist/runtime.d.ts

@@ -0,0 +1,266 @@
+import { a as PermissionMode, i as NonInteractivePermissionPolicy, r as McpServer, s as SessionRecord } from "./types-DXxLBQc3.js";
+import { t as AcpClient } from "./client-DLTWuu4w.js";
+
+//#region src/runtime/public/contract.d.ts
+type AcpRuntimePromptMode = "prompt" | "steer";
+type AcpRuntimeSessionMode = "persistent" | "oneshot";
+type AcpSessionUpdateTag = "agent_message_chunk" | "agent_thought_chunk" | "tool_call" | "tool_call_update" | "usage_update" | "available_commands_update" | "current_mode_update" | "config_option_update" | "session_info_update" | "plan" | (string & {});
+type AcpRuntimeControl = "session/set_mode" | "session/set_config_option" | "session/status";
+type AcpRuntimeHandle = {
+  sessionKey: string;
+  backend: string;
+  runtimeSessionName: string;
+  cwd?: string;
+  acpxRecordId?: string;
+  backendSessionId?: string;
+  agentSessionId?: string;
+};
+type AcpRuntimeEnsureInput = {
+  sessionKey: string;
+  agent: string;
+  mode: AcpRuntimeSessionMode;
+  resumeSessionId?: string;
+  cwd?: string;
+};
+type AcpRuntimeTurnAttachment = {
+  mediaType: string;
+  data: string;
+};
+type AcpRuntimeTurnInput = {
+  handle: AcpRuntimeHandle;
+  text: string;
+  attachments?: AcpRuntimeTurnAttachment[];
+  mode: AcpRuntimePromptMode;
+  requestId: string;
+  timeoutMs?: number;
+  signal?: AbortSignal;
+};
+type AcpRuntimeCapabilities = {
+  controls: AcpRuntimeControl[];
+  configOptionKeys?: string[];
+};
+type AcpRuntimeStatus = {
+  summary?: string;
+  acpxRecordId?: string;
+  backendSessionId?: string;
+  agentSessionId?: string;
+  details?: Record<string, unknown>;
+};
+type AcpRuntimeDoctorReport = {
+  ok: boolean;
+  code?: string;
+  message: string;
+  installCommand?: string;
+  details?: string[];
+};
+type AcpRuntimeEvent = {
+  type: "text_delta";
+  text: string;
+  stream?: "output" | "thought";
+  tag?: AcpSessionUpdateTag;
+} | {
+  type: "status";
+  text: string;
+  tag?: AcpSessionUpdateTag;
+  used?: number;
+  size?: number;
+} | {
+  type: "tool_call";
+  text: string;
+  tag?: AcpSessionUpdateTag;
+  toolCallId?: string;
+  status?: string;
+  title?: string;
+} | {
+  type: "done";
+  stopReason?: string;
+} | {
+  type: "error";
+  message: string;
+  code?: string;
+  retryable?: boolean;
+};
+interface AcpRuntime {
+  ensureSession(input: AcpRuntimeEnsureInput): Promise<AcpRuntimeHandle>;
+  runTurn(input: AcpRuntimeTurnInput): AsyncIterable<AcpRuntimeEvent>;
+  getCapabilities?(input: {
+    handle?: AcpRuntimeHandle;
+  }): Promise<AcpRuntimeCapabilities> | AcpRuntimeCapabilities;
+  getStatus?(input: {
+    handle: AcpRuntimeHandle;
+    signal?: AbortSignal;
+  }): Promise<AcpRuntimeStatus>;
+  setMode?(input: {
+    handle: AcpRuntimeHandle;
+    mode: string;
+  }): Promise<void>;
+  setConfigOption?(input: {
+    handle: AcpRuntimeHandle;
+    key: string;
+    value: string;
+  }): Promise<void>;
+  doctor?(): Promise<AcpRuntimeDoctorReport>;
+  cancel(input: {
+    handle: AcpRuntimeHandle;
+    reason?: string;
+  }): Promise<void>;
+  close(input: {
+    handle: AcpRuntimeHandle;
+    reason: string;
+  }): Promise<void>;
+}
+type AcpSessionRecord = SessionRecord;
+interface AcpSessionStore {
+  load(sessionId: string): Promise<AcpSessionRecord | undefined>;
+  save(record: AcpSessionRecord): Promise<void>;
+}
+interface AcpAgentRegistry {
+  resolve(agentName: string): string;
+  list(): string[];
+}
+type AcpRuntimeOptions = {
+  cwd: string;
+  sessionStore: AcpSessionStore;
+  agentRegistry: AcpAgentRegistry;
+  mcpServers?: McpServer[];
+  permissionMode: PermissionMode;
+  nonInteractivePermissions?: NonInteractivePermissionPolicy;
+  timeoutMs?: number;
+  probeAgent?: string;
+  verbose?: boolean;
+};
+type AcpFileSessionStoreOptions = {
+  stateDir: string;
+};
+//#endregion
+//#region src/agent-registry.d.ts
+declare const DEFAULT_AGENT_NAME = "codex";
+//#endregion
+//#region src/runtime/engine/manager.d.ts
+type AcpRuntimeManagerDeps = {
+  clientFactory?: (options: ConstructorParameters<typeof AcpClient>[0]) => AcpClient;
+};
+declare class AcpRuntimeManager {
+  private readonly options;
+  private readonly deps;
+  private readonly activeControllers;
+  private readonly pendingPersistentClients;
+  constructor(options: AcpRuntimeOptions, deps?: AcpRuntimeManagerDeps);
+  private createClient;
+  ensureSession(input: {
+    sessionKey: string;
+    agent: string;
+    mode: "persistent" | "oneshot";
+    cwd?: string;
+    resumeSessionId?: string;
+  }): Promise<SessionRecord>;
+  runTurn(input: {
+    handle: AcpRuntimeHandle;
+    text: string;
+    attachments?: AcpRuntimeTurnAttachment[];
+    mode: AcpRuntimePromptMode;
+    sessionMode: "persistent" | "oneshot";
+    requestId: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+  }): AsyncIterable<AcpRuntimeEvent>;
+  getStatus(handle: AcpRuntimeHandle): Promise<AcpRuntimeStatus>;
+  setMode(handle: AcpRuntimeHandle, mode: string, sessionMode?: "persistent" | "oneshot"): Promise<void>;
+  setConfigOption(handle: AcpRuntimeHandle, key: string, value: string, sessionMode?: "persistent" | "oneshot"): Promise<void>;
+  cancel(handle: AcpRuntimeHandle): Promise<void>;
+  close(handle: AcpRuntimeHandle): Promise<void>;
+  private requireRecord;
+}
+//#endregion
+//#region src/runtime/public/file-session-store.d.ts
+declare function createFileSessionStore(options: AcpFileSessionStoreOptions): AcpSessionStore;
+//#endregion
+//#region src/runtime/public/errors.d.ts
+declare const ACP_ERROR_CODES: readonly ["ACP_BACKEND_MISSING", "ACP_BACKEND_UNAVAILABLE", "ACP_BACKEND_UNSUPPORTED_CONTROL", "ACP_DISPATCH_DISABLED", "ACP_INVALID_RUNTIME_OPTION", "ACP_SESSION_INIT_FAILED", "ACP_TURN_FAILED"];
+type AcpRuntimeErrorCode = (typeof ACP_ERROR_CODES)[number];
+declare class AcpRuntimeError extends Error {
+  readonly code: AcpRuntimeErrorCode;
+  readonly cause?: unknown;
+  constructor(code: AcpRuntimeErrorCode, message: string, options?: {
+    cause?: unknown;
+  });
+}
+declare function isAcpRuntimeError(value: unknown): value is AcpRuntimeError;
+//#endregion
+//#region src/runtime/public/shared.d.ts
+type AcpxHandleState = {
+  name: string;
+  agent: string;
+  cwd: string;
+  mode: "persistent" | "oneshot";
+  acpxRecordId?: string;
+  backendSessionId?: string;
+  agentSessionId?: string;
+};
+//#endregion
+//#region src/runtime/public/handle-state.d.ts
+declare function encodeAcpxRuntimeHandleState(state: AcpxHandleState): string;
+declare function decodeAcpxRuntimeHandleState(runtimeSessionName: string): AcpxHandleState | null;
+//#endregion
+//#region src/runtime.d.ts
+declare const ACPX_BACKEND_ID = "acpx";
+type AcpxRuntimeLike = AcpRuntime & {
+  probeAvailability(): Promise<void>;
+  isHealthy(): boolean;
+  doctor(): Promise<AcpRuntimeDoctorReport>;
+};
+declare function createAgentRegistry(params?: {
+  overrides?: Record<string, string>;
+}): AcpAgentRegistry;
+declare class AcpxRuntime implements AcpxRuntimeLike {
+  private readonly options;
+  private readonly testOptions?;
+  private healthy;
+  private manager;
+  private managerPromise;
+  constructor(options: AcpRuntimeOptions, testOptions?: {
+    managerFactory?: (options: AcpRuntimeOptions) => AcpRuntimeManager;
+    probeRunner?: (options: AcpRuntimeOptions) => Promise<{
+      ok: boolean;
+      message: string;
+      details?: string[];
+    }>;
+  } | undefined);
+  isHealthy(): boolean;
+  probeAvailability(): Promise<void>;
+  doctor(): Promise<AcpRuntimeDoctorReport>;
+  ensureSession(input: AcpRuntimeEnsureInput): Promise<AcpRuntimeHandle>;
+  runTurn(input: AcpRuntimeTurnInput): AsyncIterable<AcpRuntimeEvent>;
+  getCapabilities(): AcpRuntimeCapabilities;
+  getStatus(input: {
+    handle: AcpRuntimeHandle;
+    signal?: AbortSignal;
+  }): Promise<AcpRuntimeStatus>;
+  setMode(input: {
+    handle: AcpRuntimeHandle;
+    mode: string;
+  }): Promise<void>;
+  setConfigOption(input: {
+    handle: AcpRuntimeHandle;
+    key: string;
+    value: string;
+  }): Promise<void>;
+  cancel(input: {
+    handle: AcpRuntimeHandle;
+    reason?: string;
+  }): Promise<void>;
+  close(input: {
+    handle: AcpRuntimeHandle;
+    reason: string;
+  }): Promise<void>;
+  private getManager;
+  private runProbe;
+  private resolveHandleState;
+}
+declare function createAcpRuntime(options: AcpRuntimeOptions): AcpxRuntime;
+declare function createRuntimeStore(options: {
+  stateDir: string;
+}): AcpSessionStore;
+//#endregion
+export { ACPX_BACKEND_ID, type AcpAgentRegistry, type AcpFileSessionStoreOptions, type AcpRuntime, type AcpRuntimeCapabilities, type AcpRuntimeDoctorReport, type AcpRuntimeEnsureInput, AcpRuntimeError, type AcpRuntimeErrorCode, type AcpRuntimeEvent, type AcpRuntimeHandle, type AcpRuntimeOptions, type AcpRuntimePromptMode, type AcpRuntimeSessionMode, type AcpRuntimeStatus, type AcpRuntimeTurnAttachment, type AcpRuntimeTurnInput, type AcpSessionRecord, type AcpSessionStore, type AcpSessionUpdateTag, AcpxRuntime, DEFAULT_AGENT_NAME, createAcpRuntime, createAgentRegistry, createFileSessionStore, createRuntimeStore, decodeAcpxRuntimeHandleState, encodeAcpxRuntimeHandleState, isAcpRuntimeError };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../src/runtime/public/contract.ts","../src/agent-registry.ts","../src/runtime/engine/manager.ts","../src/runtime/public/file-session-store.ts","../src/runtime/public/errors.ts","../src/runtime/public/shared.ts","../src/runtime/public/handle-state.ts","../src/runtime.ts"],"mappings":"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"}