hoomanjs 1.35.3 → 1.37.0

package/README.md

@@ -458,17 +458,19 @@ LLM entries reference a provider by name and carry normalized model options:
 
 Supported provider option fields:
 
-- `anthropic`: `apiKey`, optional `baseURL`, optional `headers`, optional `thinking`
-- `azure`: optional `resourceName`, optional `baseURL`, optional `apiKey`, optional `headers`, optional `apiVersion`, optional `useDeploymentBasedUrls`
-- `bedrock`: `region`, `accessKeyId`, `secretAccessKey`, optional `sessionToken`, optional `apiKey`
-- `google`: `apiKey`
-- `groq`: `apiKey`, optional `baseURL`, optional `headers`
-- `minimax`: `apiKey`, optional `headers`, optional `thinking`
-- `moonshot`: `apiKey`, optional `baseURL`, optional `headers`
-- `ollama`: optional `baseURL`, optional `thinking`
-- `openai`: `apiKey`, optional `baseURL`, optional `headers`
-- `openrouter`: `apiKey`, optional `baseURL`, optional `headers`
-- `xai`: `apiKey`, optional `baseURL`, optional `headers`
+All reasoning-capable providers share a common optional `reasoning` object (`{ effort?, summary?, display? }`). `effort` is `"minimal" | "low" | "medium" | "high"` and its presence enables thinking; Hooman translates it to each backend's native shape. `summary` (`"auto" | "concise" | "detailed" | "none"`) is only honored by the OpenAI/Azure Responses API. `display` (`"summarized" | "omitted"`) applies to Bedrock Claude / MiniMax only. See the bundled **hooman-config** skill for the exact per-provider mapping.
+
+- `anthropic`: `apiKey`, optional `baseURL`, optional `headers`, optional `reasoning`
+- `azure`: optional `resourceName`, optional `baseURL`, optional `apiKey`, optional `headers`, optional `apiVersion`, optional `useDeploymentBasedUrls`, optional `reasoning`
+- `bedrock`: `region`, `accessKeyId`, `secretAccessKey`, optional `sessionToken`, optional `apiKey`, optional `reasoning`
+- `google`: `apiKey`, optional `reasoning`
+- `groq`: `apiKey`, optional `baseURL`, optional `headers`, optional `reasoning`
+- `minimax`: `apiKey`, optional `headers`, optional `reasoning`
+- `moonshot`: `apiKey`, optional `baseURL`, optional `headers`, optional `reasoning`
+- `ollama`: optional `baseURL`, optional `reasoning`
+- `openai`: `apiKey`, optional `baseURL`, optional `headers`, optional `api` (`"responses"` (default) or `"chat"`), optional `reasoning`
+- `openrouter`: `apiKey`, optional `baseURL`, optional `headers`, optional `reasoning`
+- `xai`: `apiKey`, optional `baseURL`, optional `headers`, optional `reasoning`
 
 Normalized LLM option fields:
 
@@ -482,8 +484,10 @@ Notes:
 - Azure uses the Vercel AI SDK `@ai-sdk/azure` provider. Set the LLM `model` to your Azure deployment name, not the raw OpenAI model id.
 - Ollama maps normalized `temperature` into Ollama `options.temperature`.
 - MiniMax uses the Anthropic-compatible endpoint `https://api.minimax.io/anthropic` automatically.
-- Moonshot defaults `baseURL` to `https://api.moonshot.ai/v1` when it is omitted.
-- OpenRouter defaults `baseURL` to `https://openrouter.ai/api/v1` when it is omitted, and model names are usually provider-qualified ids such as `anthropic/claude-3.5-sonnet`.
+- Moonshot defaults `baseURL` to `https://api.moonshot.ai/v1` when it is omitted. It is served through the reasoning-aware openai-compatible adapter, so Kimi's `reasoning_content` streams as thinking — this makes it the right provider for reaching Kimi through an OpenAI-compatible proxy (e.g. LiteLLM), where the `openai` provider's Chat adapter would drop reasoning.
+- OpenRouter defaults `baseURL` to `https://openrouter.ai/api/v1` when it is omitted, and model names are usually provider-qualified ids such as `anthropic/claude-3.5-sonnet`. It also uses the openai-compatible adapter, so reasoning streams for reasoning models.
+- The `openai` provider defaults to the Responses API (`api: "responses"`), which surfaces reasoning. `api: "chat"` does NOT surface reasoning (the Chat adapter drops `reasoning_content`); route such proxies through `moonshot`/`openrouter` instead.
+- `reasoning.display` is for Bedrock Claude (Opus 4.7+ hide reasoning by default) and MiniMax; the native Anthropic API rejects it.
 - Bedrock can rely on the AWS default credential chain when explicit credentials are not provided.
 
 ## MCP Configuration

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 {};