hoomanjs 1.10.0 → 1.11.0

package/README.md

@@ -163,6 +163,12 @@ Runtime tools and prompt sections are controlled from `config.json` under `featu
 - `features.filesystem.enabled`
 - `features.shell.enabled`
 - `features.ltm.enabled`
+- `features.wiki.enabled`
+
+Both `ltm` and `wiki` include dedicated Chroma settings under:
+
+- `features.ltm.chroma` (default collection: `memory`)
+- `features.wiki.chroma` (default collection: `wiki`)
 
 ### `hooman configure`
 
@@ -205,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
@@ -245,6 +251,15 @@ This is the shape managed by `hooman configure`:
           "memory": "memory"
         }
       }
+    },
+    "wiki": {
+      "enabled": false,
+      "chroma": {
+        "url": "http://127.0.0.1:8000",
+        "collection": {
+          "wiki": "wiki"
+        }
+      }
     }
   },
   "compaction": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hoomanjs",
-  "version": "1.10.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/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,22 +50,42 @@ 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({
     features: {
       ...config.features,
-      ltm: {
+      wiki: {
         enabled: value === "on",
         chroma: {
           url: chroma.url,
-          collection: { memory: chroma.collection.memory },
+          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/configure/app.tsx

@@ -39,6 +39,7 @@ import {
   noticeColor,
   parseNumber,
   parseObjectRecord,
+  maskSensitiveParamsForDisplay,
   parseStringArray,
   parseStringRecord,
   transportSummary,
@@ -412,7 +413,9 @@ export function ConfigureApp({
           }),
       },
       {
-        label: `LLM params • ${truncate(compactJson(configData.llm.params))}`,
+        label: `LLM params • ${truncate(
+          compactJson(maskSensitiveParamsForDisplay(configData.llm.params)),
+        )}`,
         value: () =>
           promptValue({
             title: "Update LLM params",
@@ -496,7 +499,112 @@ export function ConfigureApp({
         },
       },
       {
-        label: `Long-term memory • ${configData.features.ltm.enabled ? "Enabled" : "Disabled"}`,
+        label: `Long-term memory • ${configData.features.ltm.enabled ? "Enabled" : "Disabled"} • ${configData.features.ltm.chroma.collection.memory}`,
+        value: () => setScreen({ kind: "config-ltm" }),
+      },
+      {
+        label: `Wiki feature • ${configData.features.wiki.enabled ? "Enabled" : "Disabled"} • ${configData.features.wiki.chroma.collection.wiki}`,
+        value: () => setScreen({ kind: "config-wiki" }),
+      },
+      {
+        label: `Compaction ratio • ${configData.compaction.ratio}`,
+        value: () =>
+          promptValue({
+            title: "Update compaction ratio",
+            label: "Ratio",
+            initialValue: String(configData.compaction.ratio),
+            onSubmit: async (value) => {
+              const ratio = parseNumber(value, "Compaction ratio", {
+                min: 0,
+                max: 1,
+              });
+              updateConfig(
+                {
+                  compaction: {
+                    ...config.compaction,
+                    ratio,
+                  },
+                },
+                "Updated compaction ratio.",
+              );
+              setPrompt(null);
+            },
+          }),
+      },
+      {
+        label: `Compaction keep • ${configData.compaction.keep}`,
+        value: () =>
+          promptValue({
+            title: "Update compaction keep",
+            label: "Keep",
+            initialValue: String(configData.compaction.keep),
+            onSubmit: async (value) => {
+              const keep = parseNumber(value, "Compaction keep", {
+                min: 0,
+                integer: true,
+              });
+              updateConfig(
+                {
+                  compaction: {
+                    ...config.compaction,
+                    keep,
+                  },
+                },
+                "Updated compaction keep.",
+              );
+              setPrompt(null);
+            },
+          }),
+      },
+      {
+        label: "Back",
+        value: () => setScreen({ kind: "home" }),
+      },
+    ];
+
+    return (
+      <MenuScreen
+        title="Configuration"
+        description="Edit the same values loaded from ~/.hooman/config.json."
+        items={items}
+      />
+    );
+  };
+
+  const renderProviderMenu = () => {
+    const items: MenuItem[] = [
+      ...Object.values(LlmProvider).map((provider) => ({
+        label:
+          provider === configData.llm.provider
+            ? `${provider} • current`
+            : provider,
+        value: () => {
+          updateConfig(
+            { llm: { ...config.llm, provider } },
+            `Updated LLM provider to "${provider}".`,
+          );
+          setScreen({ kind: "config" });
+        },
+      })),
+      {
+        label: "Back",
+        value: () => setScreen({ kind: "config" }),
+      },
+    ];
+
+    return (
+      <MenuScreen
+        title="Choose Provider"
+        description="Pick which model provider to use for future sessions."
+        items={items}
+      />
+    );
+  };
+
+  const renderLtmConfigMenu = () => {
+    const items: MenuItem[] = [
+      {
+        label: `Enabled • ${configData.features.ltm.enabled ? "On" : "Off"}`,
         value: () => {
           updateConfig(
             {
@@ -510,14 +618,14 @@ export function ConfigureApp({
             },
             `Long-term memory ${configData.features.ltm.enabled ? "disabled" : "enabled"}.`,
           );
-          setScreen({ kind: "config" });
+          setScreen({ kind: "config-ltm" });
         },
       },
       {
         label: `Chroma URL • ${configData.features.ltm.chroma.url}`,
         value: () =>
           promptValue({
-            title: "Update Chroma URL",
+            title: "Update LTM Chroma URL",
             label: "URL",
             initialValue: configData.features.ltm.chroma.url,
             onSubmit: async (value) => {
@@ -538,17 +646,17 @@ export function ConfigureApp({
                     },
                   },
                 },
-                "Updated Chroma URL.",
+                "Updated LTM Chroma URL.",
               );
               setPrompt(null);
             },
           }),
       },
       {
-        label: `Chroma memory collection • ${configData.features.ltm.chroma.collection.memory}`,
+        label: `Chroma collection • ${configData.features.ltm.chroma.collection.memory}`,
         value: () =>
           promptValue({
-            title: "Update Chroma memory collection",
+            title: "Update LTM Chroma collection",
             label: "Collection name",
             initialValue: configData.features.ltm.chroma.collection.memory,
             onSubmit: async (value) => {
@@ -569,92 +677,109 @@ export function ConfigureApp({
                     },
                   },
                 },
-                "Updated Chroma collection.",
+                "Updated LTM Chroma collection.",
               );
               setPrompt(null);
             },
           }),
       },
       {
-        label: `Compaction ratio • ${configData.compaction.ratio}`,
+        label: "Back",
+        value: () => setScreen({ kind: "config" }),
+      },
+    ];
+
+    return (
+      <MenuScreen
+        title="Long-term Memory"
+        description="Configure LTM memory storage and Chroma settings."
+        items={items}
+      />
+    );
+  };
+
+  const renderWikiConfigMenu = () => {
+    const items: MenuItem[] = [
+      {
+        label: `Enabled • ${configData.features.wiki.enabled ? "On" : "Off"}`,
+        value: () => {
+          updateConfig(
+            {
+              features: {
+                ...config.features,
+                wiki: {
+                  ...config.features.wiki,
+                  enabled: !configData.features.wiki.enabled,
+                },
+              },
+            },
+            `Wiki feature ${configData.features.wiki.enabled ? "disabled" : "enabled"}.`,
+          );
+          setScreen({ kind: "config-wiki" });
+        },
+      },
+      {
+        label: `Chroma URL • ${configData.features.wiki.chroma.url}`,
         value: () =>
           promptValue({
-            title: "Update compaction ratio",
-            label: "Ratio",
-            initialValue: String(configData.compaction.ratio),
+            title: "Update Wiki Chroma URL",
+            label: "URL",
+            initialValue: configData.features.wiki.chroma.url,
             onSubmit: async (value) => {
-              const ratio = parseNumber(value, "Compaction ratio", {
-                min: 0,
-                max: 1,
-              });
+              const url = value.trim();
+              if (!url) {
+                throw new Error("URL is required.");
+              }
               updateConfig(
                 {
-                  compaction: {
-                    ...config.compaction,
-                    ratio,
+                  features: {
+                    ...config.features,
+                    wiki: {
+                      ...config.features.wiki,
+                      chroma: {
+                        ...config.features.wiki.chroma,
+                        url,
+                      },
+                    },
                   },
                 },
-                "Updated compaction ratio.",
+                "Updated Wiki Chroma URL.",
               );
               setPrompt(null);
             },
           }),
       },
       {
-        label: `Compaction keep • ${configData.compaction.keep}`,
+        label: `Chroma collection • ${configData.features.wiki.chroma.collection.wiki}`,
         value: () =>
           promptValue({
-            title: "Update compaction keep",
-            label: "Keep",
-            initialValue: String(configData.compaction.keep),
+            title: "Update Wiki Chroma collection",
+            label: "Collection name",
+            initialValue: configData.features.wiki.chroma.collection.wiki,
             onSubmit: async (value) => {
-              const keep = parseNumber(value, "Compaction keep", {
-                min: 0,
-                integer: true,
-              });
+              const wiki = value.trim();
+              if (!wiki) {
+                throw new Error("Collection name is required.");
+              }
               updateConfig(
                 {
-                  compaction: {
-                    ...config.compaction,
-                    keep,
+                  features: {
+                    ...config.features,
+                    wiki: {
+                      ...config.features.wiki,
+                      chroma: {
+                        ...config.features.wiki.chroma,
+                        collection: { wiki },
+                      },
+                    },
                   },
                 },
-                "Updated compaction keep.",
+                "Updated Wiki Chroma collection.",
               );
               setPrompt(null);
             },
           }),
       },
-      {
-        label: "Back",
-        value: () => setScreen({ kind: "home" }),
-      },
-    ];
-
-    return (
-      <MenuScreen
-        title="Configuration"
-        description="Edit the same values loaded from ~/.hooman/config.json."
-        items={items}
-      />
-    );
-  };
-
-  const renderProviderMenu = () => {
-    const items: MenuItem[] = [
-      ...Object.values(LlmProvider).map((provider) => ({
-        label:
-          provider === configData.llm.provider
-            ? `${provider} • current`
-            : provider,
-        value: () => {
-          updateConfig(
-            { llm: { ...config.llm, provider } },
-            `Updated LLM provider to "${provider}".`,
-          );
-          setScreen({ kind: "config" });
-        },
-      })),
       {
         label: "Back",
         value: () => setScreen({ kind: "config" }),
@@ -663,8 +788,8 @@ export function ConfigureApp({
 
     return (
       <MenuScreen
-        title="Choose Provider"
-        description="Pick which model provider to use for future sessions."
+        title="Wiki"
+        description="Configure wiki features and Chroma-backed wiki search."
         items={items}
       />
     );
@@ -936,6 +1061,10 @@ export function ConfigureApp({
         return renderConfigMenu();
       case "config-provider":
         return renderProviderMenu();
+      case "config-ltm":
+        return renderLtmConfigMenu();
+      case "config-wiki":
+        return renderWikiConfigMenu();
       case "mcp":
         return renderMcpMenu();
       case "mcp-delete-confirm":

package/src/configure/types.ts

@@ -13,6 +13,8 @@ export type Screen =
   | { kind: "home" }
   | { kind: "config" }
   | { kind: "config-provider" }
+  | { kind: "config-ltm" }
+  | { kind: "config-wiki" }
   | { kind: "mcp" }
   | { kind: "mcp-delete-confirm"; name: string }
   | { kind: "skills" }

package/src/configure/utils.ts

@@ -16,6 +16,27 @@ export function compactJson(value: unknown): string {
   return JSON.stringify(value);
 }
 
+const MASKED_PARAM_KEYS = new Set(["apikey", "clientconfig"]);
+
+export function maskSensitiveParamsForDisplay(value: unknown): unknown {
+  if (Array.isArray(value)) {
+    return value.map((item) => maskSensitiveParamsForDisplay(item));
+  }
+  if (!value || typeof value !== "object") {
+    return value;
+  }
+  const input = value as Record<string, unknown>;
+  const output: Record<string, unknown> = {};
+  for (const [key, itemValue] of Object.entries(input)) {
+    if (MASKED_PARAM_KEYS.has(key.toLowerCase())) {
+      output[key] = "[REDACTED]";
+      continue;
+    }
+    output[key] = maskSensitiveParamsForDisplay(itemValue);
+  }
+  return output;
+}
+
 export function truncate(text: string, max: number = 88): string {
   return text.length > max ? `${text.slice(0, max - 1)}…` : text;
 }

package/src/core/agent/index.ts

@@ -16,6 +16,7 @@ import {
   createShellTools,
   createThinkingTools,
   createTimeTools,
+  createWikiTools,
 } from "../tools";
 
 const SECTION_BREAK = "\n\n---\n\n";
@@ -59,6 +60,7 @@ export async function create(
       ...(ltm ? createLongTermMemoryTools(ltm) : []),
       ...(config.features.filesystem.enabled ? createFilesystemTools() : []),
       ...(config.features.shell.enabled ? createShellTools() : []),
+      ...(config.features.wiki.enabled ? createWikiTools(config) : []),
       ...createThinkingTools(),
       ...tools,
     ],

package/src/core/config.ts

@@ -34,7 +34,12 @@ const DEFAULT_CHROMA = {
   collection: { memory: "memory" },
 } as const;
 
-const ChromaPartialSchema = z.object({
+const DEFAULT_WIKI_CHROMA = {
+  url: "http://127.0.0.1:8000",
+  collection: { wiki: "wiki" },
+} as const;
+
+const LtmChromaPartialSchema = z.object({
   url: z.string().min(1).optional(),
   collection: z
     .object({
@@ -45,7 +50,21 @@ const ChromaPartialSchema = z.object({
 
 const LtmPartialSchema = z.object({
   enabled: z.boolean().optional(),
-  chroma: ChromaPartialSchema.optional(),
+  chroma: LtmChromaPartialSchema.optional(),
+});
+
+const WikiChromaPartialSchema = z.object({
+  url: z.string().min(1).optional(),
+  collection: z
+    .object({
+      wiki: z.string().min(1).optional(),
+    })
+    .optional(),
+});
+
+const WikiPartialSchema = z.object({
+  enabled: z.boolean().optional(),
+  chroma: WikiChromaPartialSchema.optional(),
 });
 
 const FeatureTogglePartialSchema = z.object({
@@ -57,6 +76,7 @@ const FeaturesPartialSchema = z.object({
   filesystem: FeatureTogglePartialSchema.optional(),
   shell: FeatureTogglePartialSchema.optional(),
   ltm: LtmPartialSchema.optional(),
+  wiki: WikiPartialSchema.optional(),
 });
 
 const ToolsPartialSchema = z.object({
@@ -76,6 +96,7 @@ const ConfigSchema = z
   })
   .transform((input) => {
     const ltm = input.features?.ltm;
+    const wiki = input.features?.wiki;
     return {
       name: input.name,
       llm: input.llm,
@@ -101,6 +122,17 @@ const ConfigSchema = z
             },
           },
         },
+        wiki: {
+          enabled: wiki?.enabled ?? false,
+          chroma: {
+            url: wiki?.chroma?.url ?? DEFAULT_WIKI_CHROMA.url,
+            collection: {
+              wiki:
+                wiki?.chroma?.collection?.wiki ??
+                DEFAULT_WIKI_CHROMA.collection.wiki,
+            },
+          },
+        },
       },
       compaction: input.compaction,
     };
@@ -110,6 +142,7 @@ export type ConfigData = z.infer<typeof ConfigSchema>;
 export type LlmConfig = z.infer<typeof LlmSchema>;
 export type CompactionConfig = ConfigData["compaction"];
 export type LtmConfig = ConfigData["features"]["ltm"];
+export type WikiConfig = ConfigData["features"]["wiki"];
 export type ToolsConfig = ConfigData["tools"];
 export type FeaturesConfig = ConfigData["features"];
 
@@ -140,6 +173,13 @@ const defaultConfigData = (): ConfigData => ({
         collection: { memory: "memory" },
       },
     },
+    wiki: {
+      enabled: false,
+      chroma: {
+        url: "http://127.0.0.1:8000",
+        collection: { wiki: "wiki" },
+      },
+    },
   },
   compaction: {
     ratio: 0.75,
@@ -188,6 +228,13 @@ export class Config {
           collection: { ...this.data.features.ltm.chroma.collection },
         },
       },
+      wiki: {
+        ...this.data.features.wiki,
+        chroma: {
+          ...this.data.features.wiki.chroma,
+          collection: { ...this.data.features.wiki.chroma.collection },
+        },
+      },
     };
   }
 
@@ -195,6 +242,10 @@ export class Config {
     return this.features.ltm;
   }
 
+  get wiki(): WikiConfig {
+    return this.features.wiki;
+  }
+
   private readJson(): unknown {
     if (!existsSync(this.path)) {
       return defaultConfigData();