hoomanjs 1.35.2 → 1.36.0

package/dist/acp/acp-agent.d.ts

@@ -1,69 +1,43 @@
-import type { Agent as AgentContract, SetSessionConfigOptionResponse } from "@agentclientprotocol/sdk";
-import { AgentSideConnection } from "@agentclientprotocol/sdk";
-export declare class AcpAgent implements AgentContract {
+import { type AgentApp, type AgentConnection, type AgentContext, type CancelNotification, type DeleteSessionRequest, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
+/** Name + version reported to the client in `agentInfo`. */
+type AgentIdentity = {
+    name: string;
+    version: string;
+};
+/**
+ * Hooman's ACP agent, built on the app-style SDK API.
+ *
+ * Implements initialization, session setup (`session/new`, `session/load`),
+ * session discovery (`session/list`, `session/delete`), and the full prompt
+ * turn (`session/prompt` streaming + `session/cancel`).
+ */
+export declare class HoomanAcpAgent {
     #private;
-    constructor(connection: AgentSideConnection);
-    initialize(params: Parameters<AgentContract["initialize"]>[0]): Promise<{
-        protocolVersion: number;
-        agentInfo: {
-            name: string;
-            title: string;
-            version: string;
-        };
-        authMethods: never[];
-        agentCapabilities: {
-            loadSession: boolean;
-            mcpCapabilities: {
-                http: boolean;
-                sse: boolean;
-            };
-            promptCapabilities: {
-                embeddedContext: boolean;
-                image: boolean;
-                audio: boolean;
-            };
-            sessionCapabilities: {
-                list: {};
-            };
-        };
-    }>;
-    authenticate(_params: Parameters<AgentContract["authenticate"]>[0]): Promise<{}>;
-    setSessionMode(params: Parameters<NonNullable<AgentContract["setSessionMode"]>>[0]): Promise<{}>;
-    setSessionConfigOption(params: Parameters<NonNullable<AgentContract["setSessionConfigOption"]>>[0]): Promise<SetSessionConfigOptionResponse>;
-    extMethod(method: string, _params: Record<string, unknown>): Promise<Record<string, unknown>>;
-    extNotification(_method: string, _params: Record<string, unknown>): Promise<void>;
-    listSessions(params: Parameters<NonNullable<AgentContract["listSessions"]>>[0]): Promise<{
-        sessions: import("@agentclientprotocol/sdk").SessionInfo[];
-        nextCursor: string | null;
-    }>;
-    newSession(params: Parameters<AgentContract["newSession"]>[0]): Promise<{
-        sessionId: `${string}-${string}-${string}-${string}-${string}`;
-        modes: {
-            currentModeId: "agent";
-            availableModes: {
-                id: "agent";
-                name: string;
-                description: string;
-            }[];
-        };
-        models: null;
-        configOptions: import("@agentclientprotocol/sdk").SessionConfigOption[];
-    }>;
-    loadSession(params: Parameters<NonNullable<AgentContract["loadSession"]>>[0]): Promise<{
-        modes: {
-            currentModeId: "agent";
-            availableModes: {
-                id: "agent";
-                name: string;
-                description: string;
-            }[];
-        };
-        models: null;
-        configOptions: import("@agentclientprotocol/sdk").SessionConfigOption[];
-    }>;
-    cancel(params: Parameters<AgentContract["cancel"]>[0]): Promise<void>;
-    prompt(params: Parameters<AgentContract["prompt"]>[0]): Promise<{
-        stopReason: "cancelled" | "refusal" | "end_turn";
-    }>;
+    constructor(identity: AgentIdentity);
+    /** Bind connection-scoped lifecycle: capture the client + dispose on close. */
+    onConnect(connection: AgentConnection): void;
+    initialize(params: InitializeRequest): InitializeResponse;
+    listSessions(params: ListSessionsRequest): Promise<ListSessionsResponse>;
+    deleteSession(params: DeleteSessionRequest): Promise<void>;
+    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
+    loadSession(params: LoadSessionRequest, client: AgentContext): Promise<LoadSessionResponse>;
+    /**
+     * Handle `session/set_mode`: switch the active mode for a running session,
+     * re-applying the tool surface and persisting the choice.
+     */
+    setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
+    /**
+     * Handle `session/set_config_option`: apply a model or mode selection and
+     * return the complete, up-to-date configuration state (as the spec requires).
+     */
+    setSessionConfigOption(params: SetSessionConfigOptionRequest): Promise<SetSessionConfigOptionResponse>;
+    /** Cancel an in-flight prompt turn. Silent no-op for unknown sessions. */
+    cancel(params: CancelNotification): Promise<void>;
+    /** Run one prompt turn: stream model output, tool calls, and a stop reason. */
+    prompt(params: PromptRequest): Promise<PromptResponse>;
 }
+/** Build the ACP agent app and register the handlers implemented so far. */
+export declare function createAcpApp(agent: HoomanAcpAgent): AgentApp;
+/** Run Hooman as an ACP agent over stdio. */
 export declare function runAcpStdio(): Promise<void>;
+export {};