@openma/common 0.0.0-stage → 0.9.0

package/dist/acp-runtime/probe.d.ts

@@ -0,0 +1,103 @@
+import { type AuthMethod, type SessionConfigOption, type SessionModeState } from "@agentclientprotocol/sdk";
+import type { AgentSpec, Spawner } from "./types.js";
+export interface ProbeAcpSessionOptions {
+    agent: AgentSpec;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    /** Maximum time allowed for initialize, session/new, and capability updates. */
+    timeoutMs?: number;
+    /** Bounded grace period for post-session/new capability notifications. */
+    capabilitySettleMs?: number;
+    spawner?: Spawner;
+}
+export interface ProbeAcpSessionResult {
+    sessionId: string;
+    configOptions: SessionConfigOption[];
+    availableCommands: unknown[];
+    modes: SessionModeState | null;
+    authMethods: AuthMethod[];
+}
+export interface ProbeAgentConfigOptionsOptions {
+    agent: AgentSpec;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    /** Bounded collection window for capability notifications published after session/new. */
+    capabilitySettleMs?: number;
+    timeoutMs?: number;
+    spawner?: Spawner;
+}
+export interface ProbeAgentSessionConfigResult {
+    configOptions: SessionConfigOption[];
+    availableCommands: unknown[];
+    modes?: SessionModeState | null;
+    auth: ProbeAgentAuthStatus;
+}
+/**
+ * Disposable capability probe used during product cold start. It deliberately
+ * never returns the child as a real session: callers must start a fresh ACP
+ * session after consuming this snapshot.
+ */
+export declare function probeAcpSession(options: ProbeAcpSessionOptions): Promise<ProbeAcpSessionResult>;
+/** Disposable session/capability probe that also reports auth status from the same child. */
+export declare function probeAgentSessionConfig(options: ProbeAgentConfigOptionsOptions): Promise<ProbeAgentSessionConfigResult>;
+/** Dispose every in-flight capability probe, auth probe, and background
+ * authentication child before a product shuts down. */
+export declare function disposeAllAcpProbes(): Promise<void>;
+export interface ProbeAgentAuthStatusOptions {
+    agent: AgentSpec;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    timeoutMs?: number;
+    spawner?: Spawner;
+}
+export interface ProbeAgentAuthMethod {
+    id: string;
+    name?: string;
+    description?: string;
+    type: string;
+    form?: "fields";
+    vars?: Array<{
+        name: string;
+        label?: string;
+        secret?: boolean;
+        optional?: boolean;
+    }>;
+    link?: string;
+    terminalLaunch?: TerminalAuthLaunchOptions;
+}
+export interface ProbeAgentAuthStatus {
+    status: "configured" | "needs-auth" | "none" | "unknown";
+    methodId?: string;
+    methodName?: string;
+    methods?: ProbeAgentAuthMethod[];
+    message?: string;
+}
+export interface TerminalAuthLaunchOptions {
+    label: string;
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+export interface AuthenticateAgentOptions {
+    agent: AgentSpec;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    timeoutMs?: number;
+    /** When positive, a still-pending agent authenticate is reported as started
+     * after this many milliseconds and left running in the background. */
+    agentAuthLaunchGraceMs?: number;
+    /** How long a background authenticate may keep its child alive. Defaults to 10 minutes. */
+    backgroundAuthTimeoutMs?: number;
+    spawner?: Spawner;
+    methodId?: string;
+    /** Ephemeral fields encoded into authenticate `_meta`. The runtime does not persist them. */
+    values?: Record<string, string>;
+    launchInteractiveAuth?: (launch: TerminalAuthLaunchOptions) => Promise<void>;
+}
+export interface AuthenticateAgentResult {
+    status: "completed" | "started";
+}
+export declare function probeAgentAuthStatus(options: ProbeAgentAuthStatusOptions): Promise<ProbeAgentAuthStatus>;
+export declare function authenticateAgent(options: AuthenticateAgentOptions): Promise<AuthenticateAgentResult>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/acp-runtime/probe.d.ts.map

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