hoomanjs 1.9.0 → 1.11.0

package/README.md

@@ -103,12 +103,6 @@ Use a specific session id:
 hooman exec "What changed?" --session my-session
 ```
 
-Choose a toolkit size:
-
-```bash
-hooman exec "Summarize this repo" --toolkit lite
-```
-
 Skip interactive tool approval (allows every tool call; use only when you trust the prompt and environment):
 
 ```bash
@@ -135,12 +129,6 @@ Resume or pin a session id:
 hooman chat --session my-session
 ```
 
-Choose a toolkit size:
-
-```bash
-hooman chat --toolkit max
-```
-
 Skip the in-chat tool approval UI (same semantics as `exec --yolo`):
 
 ```bash
@@ -161,27 +149,26 @@ Resume or pin a session id:
 hooman daemon --session my-daemon --channels
 ```
 
-Choose a toolkit size:
-
-```bash
-hooman daemon --toolkit full --channels
-```
-
 Skip remote channel permission relay and allow every tool call from daemon turns (same risk profile as `exec` / `chat` with `--yolo`):
 
 ```bash
 hooman daemon --channels --yolo
 ```
 
-### Toolkit Levels
+### Feature Flags
+
+Runtime tools and prompt sections are controlled from `config.json` under `features`:
 
-`exec`, `chat`, `daemon`, and `acp` support `-t, --toolkit <lite|full|max>`.
+- `features.fetch.enabled`
+- `features.filesystem.enabled`
+- `features.shell.enabled`
+- `features.ltm.enabled`
+- `features.wiki.enabled`
 
-- `lite` - time, fetch, long-term-memory, installed skills, and configured MCP server tools
-- `full` - `lite` plus filesystem, shell, and thinking tools
-- `max` - `full` plus skills management tools and MCP config management tools
+Both `ltm` and `wiki` include dedicated Chroma settings under:
 
-Prompt loading follows the same split: filesystem / shell / thinking instructions are only included from `full` upward, while skills guidance is always included.
+- `features.ltm.chroma` (default collection: `memory`)
+- `features.wiki.chroma` (default collection: `wiki`)
 
 ### `hooman configure`
 
@@ -206,12 +193,6 @@ Run Hooman as an Agent Client Protocol (ACP) agent over stdio.
 hooman acp
 ```
 
-Choose a toolkit size for ACP-created sessions:
-
-```bash
-hooman acp --toolkit max
-```
-
 ACP notes:
 
 - ACP sessions are stored under the active Hooman data directory in `acp-sessions/`
@@ -230,7 +211,7 @@ Hooman stores its data in:
 
 Important files and folders:
 
-- `config.json` - app name, LLM provider/model, tool approvals, long-term memory, compaction
+- `config.json` - app name, LLM provider/model, tool approvals, feature flags, LTM/wiki settings, compaction
 - `instructions.md` - system instructions used to build the agent prompt
 - `mcp.json` - MCP server definitions
 - `skills/` - installed skills
@@ -252,12 +233,32 @@ This is the shape managed by `hooman configure`:
   "tools": {
     "allowed": []
   },
-  "ltm": {
-    "enabled": false,
-    "chroma": {
-      "url": "http://127.0.0.1:8000",
-      "collection": {
-        "memory": "memory"
+  "features": {
+    "fetch": {
+      "enabled": true
+    },
+    "filesystem": {
+      "enabled": true
+    },
+    "shell": {
+      "enabled": true
+    },
+    "ltm": {
+      "enabled": false,
+      "chroma": {
+        "url": "http://127.0.0.1:8000",
+        "collection": {
+          "memory": "memory"
+        }
+      }
+    },
+    "wiki": {
+      "enabled": false,
+      "chroma": {
+        "url": "http://127.0.0.1:8000",
+        "collection": {
+          "wiki": "wiki"
+        }
       }
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hoomanjs",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Bun-powered local AI agent CLI with chat, exec, ACP, MCP, and skills support.",
   "author": {
     "name": "Vaibhav Pandey",

package/src/acp/acp-agent.ts

@@ -16,8 +16,6 @@ import {
 } from "@agentclientprotocol/sdk";
 import type { Agent as StrandsAgent } from "@strands-agents/sdk";
 import {
-  AfterToolCallEvent,
-  AgentResultEvent,
   BeforeToolCallEvent,
   isModelStreamEvent,
   Message,
@@ -27,7 +25,6 @@ import {
 import type { StopReason as StrandsStopReason } from "@strands-agents/sdk";
 import { bootstrap } from "../core/index.ts";
 import { runWithCwd } from "../core/utils/cwd-context.ts";
-import type { Toolkit } from "../core/toolkit.ts";
 import { acpSessionsRootPath } from "./utils/paths.ts";
 import { inferToolKind } from "./utils/tool-kind.ts";
 import { toolResultToAcpContent } from "./utils/tool-result-content.ts";
@@ -172,13 +169,11 @@ export class AcpAgent implements AgentContract {
   readonly #connection: AgentSideConnection;
   readonly #sessions = new Map<string, SessionRecord>();
   readonly #acpRoot: string;
-  readonly #toolkit: Toolkit;
   #version: string | null = null;
 
-  constructor(connection: AgentSideConnection, toolkit: Toolkit) {
+  constructor(connection: AgentSideConnection) {
     this.#connection = connection;
     this.#acpRoot = acpSessionsRootPath();
-    this.#toolkit = toolkit;
     queueMicrotask(() => {
       if (connection.signal.aborted) {
         void this.#disposeAllSessions();
@@ -342,7 +337,6 @@ export class AcpAgent implements AgentContract {
       {
         userId: bootstrapUserId,
         sessionId,
-        toolkit: this.#toolkit,
         mcpServers,
         ...(clientSystemPrompt ? { systemPrompt: clientSystemPrompt } : {}),
       },
@@ -440,7 +434,6 @@ export class AcpAgent implements AgentContract {
       {
         userId: bootstrapUserId,
         sessionId: params.sessionId,
-        toolkit: this.#toolkit,
         mcpServers,
         ...(clientSystemPrompt ? { systemPrompt: clientSystemPrompt } : {}),
       },
@@ -804,13 +797,13 @@ export class AcpAgent implements AgentContract {
   }
 }
 
-export async function runAcpStdio(toolkit: Toolkit = "full"): Promise<void> {
+export async function runAcpStdio(): Promise<void> {
   const stream = ndJsonStream(
     Writable.toWeb(stdout) as unknown as WritableStream<Uint8Array>,
     Readable.toWeb(stdin) as unknown as ReadableStream<Uint8Array>,
   );
   const connection = new AgentSideConnection(
-    (conn) => new AcpAgent(conn, toolkit),
+    (conn) => new AcpAgent(conn),
     stream,
   );
   await connection.closed;

package/src/acp/sessions/config-options.ts

@@ -6,6 +6,7 @@ import type {
 import type { Config } from "../../core/config.ts";
 
 export const HOOMAN_LTM_CONFIG_ID = "hooman.longTermMemory" as const;
+export const HOOMAN_WIKI_CONFIG_ID = "hooman.wiki" as const;
 
 export function buildSessionConfigOptions(
   config: Config,
@@ -24,6 +25,19 @@ export function buildSessionConfigOptions(
         { value: "off", name: "Off" },
       ],
     },
+    {
+      type: "select",
+      id: HOOMAN_WIKI_CONFIG_ID,
+      name: "Wiki",
+      description:
+        "When enabled, the agent can read, write, and search wiki pages (requires Chroma at the configured URL).",
+      category: "_hooman",
+      currentValue: config.wiki.enabled ? "on" : "off",
+      options: [
+        { value: "on", name: "On" },
+        { value: "off", name: "Off" },
+      ],
+    },
   ];
 }
 
@@ -36,20 +50,43 @@ export function applySessionConfigOption(
       message: "Boolean session config options are not supported.",
     });
   }
-  if (params.configId !== HOOMAN_LTM_CONFIG_ID) {
+  if (
+    params.configId !== HOOMAN_LTM_CONFIG_ID &&
+    params.configId !== HOOMAN_WIKI_CONFIG_ID
+  ) {
     throw RequestError.invalidParams({ configId: params.configId });
   }
   const value = params.value;
   if (value !== "on" && value !== "off") {
     throw RequestError.invalidParams({ value });
   }
-  const chroma = config.ltm.chroma;
+  if (params.configId === HOOMAN_LTM_CONFIG_ID) {
+    const chroma = config.ltm.chroma;
+    config.update({
+      features: {
+        ...config.features,
+        ltm: {
+          enabled: value === "on",
+          chroma: {
+            url: chroma.url,
+            collection: { memory: chroma.collection.memory },
+          },
+        },
+      },
+    });
+    return;
+  }
+
+  const chroma = config.wiki.chroma;
   config.update({
-    ltm: {
-      enabled: value === "on",
-      chroma: {
-        url: chroma.url,
-        collection: { memory: chroma.collection.memory },
+    features: {
+      ...config.features,
+      wiki: {
+        enabled: value === "on",
+        chroma: {
+          url: chroma.url,
+          collection: { wiki: chroma.collection.wiki },
+        },
       },
     },
   });

package/src/acp/utils/tool-kind.ts

@@ -15,6 +15,12 @@ const KNOWN_TOOL_KINDS = new Map<string, ToolKind>([
   ["get_file_info", "read"],
   ["shell", "execute"],
   ["fetch", "fetch"],
+  ["wiki_list_files", "read"],
+  ["wiki_read_file", "read"],
+  ["wiki_write_file", "edit"],
+  ["wiki_knowledge_graph", "read"],
+  ["wiki_stats", "read"],
+  ["wiki_search", "search"],
   ["think", "think"],
   ["get_current_time", "other"],
   ["convert_time", "other"],

package/src/acp/utils/tool-locations.ts

@@ -11,6 +11,8 @@ const KNOWN_TOOL_LOCATION_KEYS = new Map<string, readonly string[]>([
   ["move_file", ["source", "destination"]],
   ["search_files", ["path"]],
   ["get_file_info", ["path"]],
+  ["wiki_read_file", ["path"]],
+  ["wiki_write_file", ["path"]],
 ]);
 
 /** ACP `locations` extracted only from known core filesystem tools. */

package/src/cli.ts

@@ -1,10 +1,8 @@
 #!/usr/bin/env bun
 
-import { Command, Option } from "commander";
+import { Command } from "commander";
 import { BeforeToolCallEvent } from "@strands-agents/sdk";
 import { bootstrap } from "./core/index.ts";
-import { TOOLKITS } from "./core/toolkit.ts";
-import type { Toolkit } from "./core/toolkit.ts";
 import { createToolApprovalHandler } from "./exec/approvals.ts";
 import { chat } from "./chat/index.tsx";
 import { configure } from "./configure/index.tsx";
@@ -37,15 +35,6 @@ async function readPackageMeta(): Promise<{
   };
 }
 
-function createToolkitOption(): Option {
-  return new Option(
-    "-t, --toolkit <toolkit>",
-    "Toolkit size to enable: lite, full, or max.",
-  )
-    .choices([...TOOLKITS])
-    .default("full");
-}
-
 const packageMeta = await readPackageMeta();
 
 const program = new Command()
@@ -60,21 +49,14 @@ program
   .argument("<prompt>", "Prompt to run once.")
   .option("-s, --session <id>", "Session ID to use.")
   .option("--yolo", "Allow all tools without prompting for approval.")
-  .addOption(createToolkitOption())
   .action(
-    async (
-      prompt: string,
-      options: { session?: string; toolkit?: Toolkit; yolo?: boolean },
-    ) => {
+    async (prompt: string, options: { session?: string; yolo?: boolean }) => {
       const sessionId = options.session?.trim() || crypto.randomUUID();
       const {
         config,
         agent,
         mcp: { manager },
-      } = await bootstrap(
-        { sessionId, toolkit: options.toolkit ?? "full" },
-        true,
-      );
+      } = await bootstrap({ sessionId }, true);
       agent.addHook(
         BeforeToolCallEvent,
         createToolApprovalHandler(config, { yolo: Boolean(options.yolo) }),
@@ -95,11 +77,10 @@ program
   .argument("[prompt]", "Optional initial prompt to run after startup.")
   .option("-s, --session <id>", "Session ID to use.")
   .option("--yolo", "Allow all tools without prompting for approval.")
-  .addOption(createToolkitOption())
   .action(
     async (
       prompt: string | undefined,
-      options: { session?: string; toolkit?: Toolkit; yolo?: boolean },
+      options: { session?: string; yolo?: boolean },
     ) => {
       const sessionId = options.session?.trim() || crypto.randomUUID();
       const {
@@ -107,10 +88,7 @@ program
         agent,
         mcp: { manager },
         registry,
-      } = await bootstrap(
-        { sessionId, toolkit: options.toolkit ?? "full" },
-        false,
-      );
+      } = await bootstrap({ sessionId }, false);
 
       try {
         await chat({
@@ -142,11 +120,9 @@ program
     "Log each MCP channel notification payload to the console.",
   )
   .option("--yolo", "Allow all tools without remote approval or prompts.")
-  .addOption(createToolkitOption())
   .action(
     async (options: {
       session?: string;
-      toolkit?: Toolkit;
       channels?: boolean;
       debug?: boolean;
       yolo?: boolean;
@@ -160,7 +136,6 @@ program
         {
           sessionId: session,
           userId: session,
-          toolkit: options.toolkit ?? "full",
         },
         true,
       );
@@ -198,9 +173,8 @@ program
   .description(
     "Run as an Agent Client Protocol (ACP) agent on stdio for ACP-compatible clients.",
   )
-  .addOption(createToolkitOption())
-  .action(async (options: { toolkit?: Toolkit }) => {
-    await runAcpStdio(options.toolkit ?? "full");
+  .action(async () => {
+    await runAcpStdio();
   });
 
 if (process.argv.slice(2).length === 0) {