hoomanjs 1.9.0 → 1.11.0

package/src/configure/app.tsx

@@ -39,6 +39,7 @@ import {
   noticeColor,
   parseNumber,
   parseObjectRecord,
+  maskSensitiveParamsForDisplay,
   parseStringArray,
   parseStringRecord,
   transportSummary,
@@ -131,7 +132,7 @@ export function ConfigureApp({
         name: config.name,
         llm: config.llm,
         tools: config.tools,
-        ltm: config.ltm,
+        features: config.features,
         compaction: config.compaction,
       }) satisfies ConfigData,
     [config, revision],
@@ -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",
@@ -445,75 +448,63 @@ export function ConfigureApp({
           }),
       },
       {
-        label: `Long-term memory • ${configData.ltm.enabled ? "Enabled" : "Disabled"}`,
+        label: `Fetch feature • ${configData.features.fetch.enabled ? "Enabled" : "Disabled"}`,
         value: () => {
           updateConfig(
             {
-              ltm: {
-                ...config.ltm,
-                enabled: !configData.ltm.enabled,
+              features: {
+                ...config.features,
+                fetch: {
+                  enabled: !configData.features.fetch.enabled,
+                },
               },
             },
-            `Long-term memory ${configData.ltm.enabled ? "disabled" : "enabled"}.`,
+            `Fetch feature ${configData.features.fetch.enabled ? "disabled" : "enabled"}.`,
           );
           setScreen({ kind: "config" });
         },
       },
       {
-        label: `Chroma URL • ${configData.ltm.chroma.url}`,
-        value: () =>
-          promptValue({
-            title: "Update Chroma URL",
-            label: "URL",
-            initialValue: configData.ltm.chroma.url,
-            onSubmit: async (value) => {
-              const url = value.trim();
-              if (!url) {
-                throw new Error("URL is required.");
-              }
-              updateConfig(
-                {
-                  ltm: {
-                    ...config.ltm,
-                    chroma: {
-                      ...config.ltm.chroma,
-                      url,
-                    },
-                  },
+        label: `Filesystem feature • ${configData.features.filesystem.enabled ? "Enabled" : "Disabled"}`,
+        value: () => {
+          updateConfig(
+            {
+              features: {
+                ...config.features,
+                filesystem: {
+                  enabled: !configData.features.filesystem.enabled,
                 },
-                "Updated Chroma URL.",
-              );
-              setPrompt(null);
+              },
             },
-          }),
+            `Filesystem feature ${configData.features.filesystem.enabled ? "disabled" : "enabled"}.`,
+          );
+          setScreen({ kind: "config" });
+        },
       },
       {
-        label: `Chroma memory collection • ${configData.ltm.chroma.collection.memory}`,
-        value: () =>
-          promptValue({
-            title: "Update Chroma memory collection",
-            label: "Collection name",
-            initialValue: configData.ltm.chroma.collection.memory,
-            onSubmit: async (value) => {
-              const memory = value.trim();
-              if (!memory) {
-                throw new Error("Collection name is required.");
-              }
-              updateConfig(
-                {
-                  ltm: {
-                    ...config.ltm,
-                    chroma: {
-                      ...config.ltm.chroma,
-                      collection: { memory },
-                    },
-                  },
+        label: `Shell feature • ${configData.features.shell.enabled ? "Enabled" : "Disabled"}`,
+        value: () => {
+          updateConfig(
+            {
+              features: {
+                ...config.features,
+                shell: {
+                  enabled: !configData.features.shell.enabled,
                 },
-                "Updated Chroma collection.",
-              );
-              setPrompt(null);
+              },
             },
-          }),
+            `Shell feature ${configData.features.shell.enabled ? "disabled" : "enabled"}.`,
+          );
+          setScreen({ kind: "config" });
+        },
+      },
+      {
+        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}`,
@@ -610,6 +601,200 @@ export function ConfigureApp({
     );
   };
 
+  const renderLtmConfigMenu = () => {
+    const items: MenuItem[] = [
+      {
+        label: `Enabled • ${configData.features.ltm.enabled ? "On" : "Off"}`,
+        value: () => {
+          updateConfig(
+            {
+              features: {
+                ...config.features,
+                ltm: {
+                  ...config.features.ltm,
+                  enabled: !configData.features.ltm.enabled,
+                },
+              },
+            },
+            `Long-term memory ${configData.features.ltm.enabled ? "disabled" : "enabled"}.`,
+          );
+          setScreen({ kind: "config-ltm" });
+        },
+      },
+      {
+        label: `Chroma URL • ${configData.features.ltm.chroma.url}`,
+        value: () =>
+          promptValue({
+            title: "Update LTM Chroma URL",
+            label: "URL",
+            initialValue: configData.features.ltm.chroma.url,
+            onSubmit: async (value) => {
+              const url = value.trim();
+              if (!url) {
+                throw new Error("URL is required.");
+              }
+              updateConfig(
+                {
+                  features: {
+                    ...config.features,
+                    ltm: {
+                      ...config.features.ltm,
+                      chroma: {
+                        ...config.features.ltm.chroma,
+                        url,
+                      },
+                    },
+                  },
+                },
+                "Updated LTM Chroma URL.",
+              );
+              setPrompt(null);
+            },
+          }),
+      },
+      {
+        label: `Chroma collection • ${configData.features.ltm.chroma.collection.memory}`,
+        value: () =>
+          promptValue({
+            title: "Update LTM Chroma collection",
+            label: "Collection name",
+            initialValue: configData.features.ltm.chroma.collection.memory,
+            onSubmit: async (value) => {
+              const memory = value.trim();
+              if (!memory) {
+                throw new Error("Collection name is required.");
+              }
+              updateConfig(
+                {
+                  features: {
+                    ...config.features,
+                    ltm: {
+                      ...config.features.ltm,
+                      chroma: {
+                        ...config.features.ltm.chroma,
+                        collection: { memory },
+                      },
+                    },
+                  },
+                },
+                "Updated LTM Chroma collection.",
+              );
+              setPrompt(null);
+            },
+          }),
+      },
+      {
+        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 Wiki Chroma URL",
+            label: "URL",
+            initialValue: configData.features.wiki.chroma.url,
+            onSubmit: async (value) => {
+              const url = value.trim();
+              if (!url) {
+                throw new Error("URL is required.");
+              }
+              updateConfig(
+                {
+                  features: {
+                    ...config.features,
+                    wiki: {
+                      ...config.features.wiki,
+                      chroma: {
+                        ...config.features.wiki.chroma,
+                        url,
+                      },
+                    },
+                  },
+                },
+                "Updated Wiki Chroma URL.",
+              );
+              setPrompt(null);
+            },
+          }),
+      },
+      {
+        label: `Chroma collection • ${configData.features.wiki.chroma.collection.wiki}`,
+        value: () =>
+          promptValue({
+            title: "Update Wiki Chroma collection",
+            label: "Collection name",
+            initialValue: configData.features.wiki.chroma.collection.wiki,
+            onSubmit: async (value) => {
+              const wiki = value.trim();
+              if (!wiki) {
+                throw new Error("Collection name is required.");
+              }
+              updateConfig(
+                {
+                  features: {
+                    ...config.features,
+                    wiki: {
+                      ...config.features.wiki,
+                      chroma: {
+                        ...config.features.wiki.chroma,
+                        collection: { wiki },
+                      },
+                    },
+                  },
+                },
+                "Updated Wiki Chroma collection.",
+              );
+              setPrompt(null);
+            },
+          }),
+      },
+      {
+        label: "Back",
+        value: () => setScreen({ kind: "config" }),
+      },
+    ];
+
+    return (
+      <MenuScreen
+        title="Wiki"
+        description="Configure wiki features and Chroma-backed wiki search."
+        items={items}
+      />
+    );
+  };
+
   const renderMcpMenu = () => {
     const serverItems: MenuItem[] = mcpServers.flatMap((server) => [
       {
@@ -876,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

@@ -1,11 +1,7 @@
 import { Agent } from "@strands-agents/sdk";
 import type { Config } from "../config.ts";
 import { modelProviders } from "../models";
-import {
-  type Config as McpConfig,
-  type Manager as McpManager,
-  createMcpTools,
-} from "../mcp";
+import { type Config as McpConfig, type Manager as McpManager } from "../mcp";
 import type { System as SystemPrompt } from "../prompts";
 import { skills as createSkillsPrompt } from "../prompts";
 import {
@@ -14,16 +10,14 @@ import {
   createLongTermMemoryTools,
 } from "../memory";
 import type { Registry } from "../skills";
-import { createSkillsTools } from "../skills";
 import {
   createFetchTools,
   createFilesystemTools,
   createShellTools,
   createThinkingTools,
   createTimeTools,
+  createWikiTools,
 } from "../tools";
-import { toolkitAtLeast } from "../toolkit.ts";
-import type { Toolkit } from "../toolkit.ts";
 
 const SECTION_BREAK = "\n\n---\n\n";
 
@@ -37,15 +31,15 @@ export async function create(
     userId?: string;
     sessionId?: string;
     systemPrompt?: string;
-    toolkit?: Toolkit;
   },
 ): Promise<Agent> {
   const sessionId = meta.sessionId;
   const userId = meta.userId ?? sessionId;
-  const toolkit = meta.toolkit ?? "full";
   const llm = await modelProviders[config.llm.provider]!();
   const stm = createShortTermMemory(sessionId);
-  const ltm = config.ltm.enabled ? createLongTermMemoryStore(config) : null;
+  const ltm = config.features.ltm.enabled
+    ? createLongTermMemoryStore(config)
+    : null;
   const skills = await createSkillsPrompt(registry);
   const tools = await mcp.manager.listPrefixedTools();
   const append = await mcp.manager.listServerInstructions();
@@ -62,13 +56,12 @@ export async function create(
     },
     tools: [
       ...createTimeTools(),
-      ...createFetchTools(),
+      ...(config.features.fetch.enabled ? createFetchTools() : []),
       ...(ltm ? createLongTermMemoryTools(ltm) : []),
-      ...(toolkitAtLeast(toolkit, "full") ? createFilesystemTools() : []), // > lite
-      ...(toolkitAtLeast(toolkit, "full") ? createShellTools() : []),
-      ...(toolkitAtLeast(toolkit, "full") ? createThinkingTools() : []),
-      ...(toolkit === "max" ? createSkillsTools(registry) : []),
-      ...(toolkit === "max" ? createMcpTools(mcp.config) : []),
+      ...(config.features.filesystem.enabled ? createFilesystemTools() : []),
+      ...(config.features.shell.enabled ? createShellTools() : []),
+      ...(config.features.wiki.enabled ? createWikiTools(config) : []),
+      ...createThinkingTools(),
       ...tools,
     ],
     printer: print,

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,38 +50,101 @@ 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({
+  enabled: z.boolean().optional(),
+});
+
+const FeaturesPartialSchema = z.object({
+  fetch: FeatureTogglePartialSchema.optional(),
+  filesystem: FeatureTogglePartialSchema.optional(),
+  shell: FeatureTogglePartialSchema.optional(),
+  ltm: LtmPartialSchema.optional(),
+  wiki: WikiPartialSchema.optional(),
 });
 
 const ToolsPartialSchema = z.object({
   allowed: z.array(z.string().min(1)).default([]),
 });
 
-const ConfigSchema = z.object({
-  name: z.string().min(1),
-  llm: LlmSchema,
-  tools: ToolsPartialSchema.default({ allowed: [] }),
-  ltm: LtmPartialSchema.nullish().transform((ltm) => ({
-    enabled: ltm?.enabled ?? false,
-    chroma: {
-      url: ltm?.chroma?.url ?? DEFAULT_CHROMA.url,
-      collection: {
-        memory:
-          ltm?.chroma?.collection?.memory ?? DEFAULT_CHROMA.collection.memory,
+const ConfigSchema = z
+  .object({
+    name: z.string().min(1),
+    llm: LlmSchema,
+    tools: ToolsPartialSchema.default({ allowed: [] }),
+    features: FeaturesPartialSchema.nullish(),
+    compaction: CompactionPartialSchema.nullish().transform((c) => ({
+      ratio: c?.ratio ?? DEFAULT_COMPACTION.ratio,
+      keep: c?.keep ?? DEFAULT_COMPACTION.keep,
+    })),
+  })
+  .transform((input) => {
+    const ltm = input.features?.ltm;
+    const wiki = input.features?.wiki;
+    return {
+      name: input.name,
+      llm: input.llm,
+      tools: input.tools,
+      features: {
+        fetch: {
+          enabled: input.features?.fetch?.enabled ?? true,
+        },
+        filesystem: {
+          enabled: input.features?.filesystem?.enabled ?? true,
+        },
+        shell: {
+          enabled: input.features?.shell?.enabled ?? true,
+        },
+        ltm: {
+          enabled: ltm?.enabled ?? false,
+          chroma: {
+            url: ltm?.chroma?.url ?? DEFAULT_CHROMA.url,
+            collection: {
+              memory:
+                ltm?.chroma?.collection?.memory ??
+                DEFAULT_CHROMA.collection.memory,
+            },
+          },
+        },
+        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: CompactionPartialSchema.nullish().transform((c) => ({
-    ratio: c?.ratio ?? DEFAULT_COMPACTION.ratio,
-    keep: c?.keep ?? DEFAULT_COMPACTION.keep,
-  })),
-});
+      compaction: input.compaction,
+    };
+  });
 
 export type ConfigData = z.infer<typeof ConfigSchema>;
 export type LlmConfig = z.infer<typeof LlmSchema>;
 export type CompactionConfig = ConfigData["compaction"];
-export type LtmConfig = ConfigData["ltm"];
+export type LtmConfig = ConfigData["features"]["ltm"];
+export type WikiConfig = ConfigData["features"]["wiki"];
 export type ToolsConfig = ConfigData["tools"];
+export type FeaturesConfig = ConfigData["features"];
 
 const defaultConfigData = (): ConfigData => ({
   name: "Hooman",
@@ -88,11 +156,29 @@ const defaultConfigData = (): ConfigData => ({
   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" },
+      },
     },
   },
   compaction: {
@@ -129,8 +215,35 @@ export class Config {
     return this.data.compaction;
   }
 
+  get features(): FeaturesConfig {
+    return {
+      ...this.data.features,
+      fetch: { ...this.data.features.fetch },
+      filesystem: { ...this.data.features.filesystem },
+      shell: { ...this.data.features.shell },
+      ltm: {
+        ...this.data.features.ltm,
+        chroma: {
+          ...this.data.features.ltm.chroma,
+          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 },
+        },
+      },
+    };
+  }
+
   get ltm(): LtmConfig {
-    return this.data.ltm;
+    return this.features.ltm;
+  }
+
+  get wiki(): WikiConfig {
+    return this.features.wiki;
   }
 
   private readJson(): unknown {