hoomanjs 1.18.0 → 1.19.0

package/README.md

@@ -1,13 +1,13 @@
 <div align="center">
   <h1>Hooman</h1>
   <p>
-    Hooman is a hackable, Bun-powered AI agent toolkit for local workflows. It is built with TypeScript, <a href="https://www.npmjs.com/package/@strands-agents/sdk">Strands Agents SDK</a>, and <a href="https://github.com/vadimdemedes/ink">Ink</a>.
+    Hooman is a hackable AI agent toolkit for local workflows. It is built with TypeScript, <a href="https://www.npmjs.com/package/@strands-agents/sdk">Strands Agents SDK</a>, and <a href="https://github.com/vadimdemedes/ink">Ink</a>.
   </p>
   <p>
-    <a href="https://bun.com"><img src="https://img.shields.io/badge/runtime-Bun-f9f1e1?logo=bun&logoColor=000000" alt="Bun" /></a>
+    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/runtime-Node.js-5FA04E?logo=nodedotjs&logoColor=white" alt="Node.js" /></a>
     <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/language-TypeScript-3178C6?logo=typescript&logoColor=white" alt="TypeScript" /></a>
     <a href="https://github.com/vadimdemedes/ink"><img src="https://img.shields.io/badge/ui-Ink-6f42c1" alt="Ink" /></a>
-    <a href="https://github.com/vaibhavpandeyvpz/hooman/actions/workflows/build-publish.yml"><img src="https://img.shields.io/github/actions/workflow/status/vaibhavpandeyvpz/hooman/build-publish.yml?branch=main&label=build" alt="Build" /></a>
+    <a href="https://github.com/vaibhavpandeyvpz/hooman/actions/workflows/publish-npm.yml"><img src="https://img.shields.io/github/actions/workflow/status/vaibhavpandeyvpz/hooman/publish-npm.yml?branch=main&label=build" alt="Build" /></a>
     <a href="https://github.com/vaibhavpandeyvpz/hooman/stargazers"><img src="https://img.shields.io/github/stars/vaibhavpandeyvpz/hooman?style=flat" alt="GitHub Repo stars" /></a>
     <a href="https://github.com/vaibhavpandeyvpz/hooman/commits/main"><img src="https://img.shields.io/github/last-commit/vaibhavpandeyvpz/hooman" alt="GitHub last commit" /></a>
   </p>
@@ -27,12 +27,12 @@ It gives you a practical toolkit to build and run agent workflows:
 ## Features
 
 - Multiple LLM providers: `ollama`, `openai`, `anthropic`, `google`, `bedrock`, `groq`, `moonshot`, `xai`
-- Local configuration under `./.hooman` when that folder exists in the current working directory, otherwise `~/.hooman`
+- Local configuration under `~/.hooman`
 - Optional web search tool with provider selection (`brave` or `tavily`)
 - MCP server support via `stdio`, `streamable-http`, and `sse`
 - MCP server `instructions` support: server-provided instructions are appended to the agent system prompt
 - MCP channel notification support through `hooman daemon --channels`
-- Skill discovery / install / removal through the integrated configure flow
+- Skill discovery from local `~/.hooman/skills` folders
 - Bundled prompt harness toggles (`behaviour`, `communication`, `execution`, `engineering`, `guardrails`)
 - Built-in subagent runner tools (`research`, `plan`) with configurable concurrency
 - Toolkit-oriented architecture with configurable tools, prompts, memory, and transports
@@ -40,8 +40,8 @@ It gives you a practical toolkit to build and run agent workflows:
 
 ## Requirements
 
-- [Bun](https://bun.com) `>= 1.0.0`
-- Node/npm available if you want to install skills from the public skills catalog
+- [Node.js](https://nodejs.org) `>= 24`
+- npm for package installs and JavaScript tooling
 - Provider credentials or local model runtime depending on the LLM you choose
 
 ## Usage
@@ -49,21 +49,18 @@ It gives you a practical toolkit to build and run agent workflows:
 Fastest way to get started without cloning the repo:
 
 ```bash
-bunx hoomanjs configure
-bunx hoomanjs chat
+npx hoomanjs configure
+npx hoomanjs chat
 
 # or install globally
-bun i -g hoomanjs
+npm i -g hoomanjs
 ```
 
-Or with npm:
+Or with Bun:
 
 ```bash
-npx hoomanjs configure
-npx hoomanjs chat
-
-# or install globally
-npm i -g hoomanjs
+bunx hoomanjs configure
+bunx hoomanjs chat
 ```
 
 Recommended first run:
@@ -92,25 +89,26 @@ For production deployments, still review permissions and use least-privilege cre
 ## Install
 
 ```bash
-bun install
+npm install
 ```
 
 Run locally:
 
 ```bash
-bun run src/cli.ts --help
+npm run dev -- --help
 ```
 
 Or use the dev alias:
 
 ```bash
-bun run dev -- --help
+npm run build
+node dist/cli.js --help
 ```
 
 Link the CLI locally:
 
 ```bash
-bun link
+npm link
 hooman --help
 ```
 
@@ -202,8 +200,8 @@ Runtime tool and prompt switches are controlled from `config.json`:
 - `tools.sleep.enabled`
 - `tools.ltm.enabled`
 - `tools.wiki.enabled`
-- `tools.mcp.enabled` (enables MCP management tools + prefixed MCP server tools/instructions)
-- `tools.skills.enabled` (enables skills management tools + skills prompt sections)
+- `tools.mcp.enabled` (enables configured MCP server tools/instructions)
+- `tools.skills.enabled` (enables skills prompt guidance)
 - `tools.agents.enabled` (enables built-in `run_agents` tool)
 - `tools.agents.concurrency`
 
@@ -227,7 +225,7 @@ The configure UI currently lets you:
 - toggle bundled harness prompts (`behaviour`, `communication`, `execution`, `engineering`, `guardrails`)
 - edit `instructions.md` in your `$VISUAL` / `$EDITOR` (cross-platform fallback included)
 - add, edit, and delete MCP servers with confirmation
-- search, install, refresh, and remove skills
+- refresh and remove local skills
 
 ### `hooman acp`
 
@@ -249,8 +247,7 @@ ACP notes:
 Hooman stores its data in:
 
 ```text
-./.hooman/   # when this folder exists in the current working directory
-~/.hooman/   # otherwise
+~/.hooman/
 ```
 
 Important files and folders:
@@ -566,14 +563,12 @@ Uses the Vercel AI SDK xAI provider (`@ai-sdk/xai`) on top of Strands `VercelMod
 Skills are installed under:
 
 ```text
-./.hooman/skills   # when ./.hooman exists
-~/.hooman/skills   # otherwise
+~/.hooman/skills
 ```
 
+Skills are discovered by scanning direct child directories for `SKILL.md`.
 The configure workflow can:
 
-- search the public skills catalog
-- install a skill from a source string, repo, URL, or local path
 - refresh installed skills
 - remove installed skills with confirmation
 
@@ -582,19 +577,19 @@ The configure workflow can:
 Install dependencies:
 
 ```bash
-bun install
+npm install
 ```
 
 Run the CLI:
 
 ```bash
-bun run src/cli.ts --help
+npm run dev -- --help
 ```
 
 Run typecheck:
 
 ```bash
-bunx tsc --noEmit
+npm run typecheck
 ```
 
 ## License

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

@@ -0,0 +1,69 @@
+import type { Agent as AgentContract, SetSessionConfigOptionResponse } from "@agentclientprotocol/sdk";
+import { AgentSideConnection } from "@agentclientprotocol/sdk";
+export declare class AcpAgent implements AgentContract {
+    #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: "default";
+            availableModes: {
+                id: "default";
+                name: string;
+                description: string;
+            }[];
+        };
+        models: null;
+        configOptions: import("@agentclientprotocol/sdk").SessionConfigOption[];
+    }>;
+    loadSession(params: Parameters<NonNullable<AgentContract["loadSession"]>>[0]): Promise<{
+        modes: {
+            currentModeId: "default";
+            availableModes: {
+                id: "default";
+                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" | "end_turn" | "refusal";
+    }>;
+}
+export declare function runAcpStdio(): Promise<void>;