hoomanjs 1.18.0 → 1.18.1

package/src/core/config.ts

@@ -1,377 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { z } from "zod";
-
-/** LLM backend; extend as you add providers. */
-export enum LlmProvider {
-  Anthropic = "anthropic",
-  Google = "google",
-  Groq = "groq",
-  Moonshot = "moonshot",
-  OpenAI = "openai",
-  Ollama = "ollama",
-  Bedrock = "bedrock",
-  Xai = "xai",
-}
-
-const LlmSchema = z.object({
-  provider: z.nativeEnum(LlmProvider),
-  model: z.string().min(1),
-  params: z.record(z.string(), z.any()).default({}),
-});
-
-/** Partial compaction overrides from JSON; missing fields use defaults below. */
-const CompactionPartialSchema = z.object({
-  /** Fraction of context to target after compaction (e.g. 0.75 = keep ~75% budget). */
-  ratio: z.number().min(0).max(1).optional(),
-  /** Minimum number of recent turns / message groups to preserve verbatim when compacting. */
-  keep: z.number().int().nonnegative().optional(),
-});
-
-const DEFAULT_COMPACTION = { ratio: 0.75, keep: 5 } as const;
-
-const DEFAULT_PROMPTS = {
-  behaviour: true,
-  communication: true,
-  execution: true,
-  engineering: true,
-  guardrails: true,
-} as const;
-
-const DEFAULT_CHROMA = {
-  url: "http://127.0.0.1:8000",
-  collection: { memory: "memory" },
-} as const;
-
-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({
-      memory: z.string().min(1).optional(),
-    })
-    .optional(),
-});
-
-const LtmPartialSchema = z.object({
-  enabled: z.boolean().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 ToolTogglePartialSchema = z.object({
-  enabled: z.boolean().optional(),
-});
-
-const PromptsPartialSchema = z.object({
-  behaviour: z.boolean().optional(),
-  communication: z.boolean().optional(),
-  execution: z.boolean().optional(),
-  engineering: z.boolean().optional(),
-  guardrails: z.boolean().optional(),
-});
-
-const AgentsPartialSchema = z.object({
-  enabled: z.boolean().optional(),
-  concurrency: z.number().int().min(1).optional(),
-});
-
-const SearchProviderSchema = z.enum(["brave", "tavily"]);
-
-const SearchPartialSchema = z.object({
-  enabled: z.boolean().optional(),
-  provider: SearchProviderSchema.optional(),
-  brave: z
-    .object({
-      apiKey: z.string().min(1).optional(),
-    })
-    .optional(),
-  tavily: z
-    .object({
-      apiKey: z.string().min(1).optional(),
-    })
-    .optional(),
-});
-
-const ToolsPartialSchema = z.object({
-  todo: ToolTogglePartialSchema.optional(),
-  fetch: ToolTogglePartialSchema.optional(),
-  filesystem: ToolTogglePartialSchema.optional(),
-  shell: ToolTogglePartialSchema.optional(),
-  sleep: ToolTogglePartialSchema.optional(),
-  ltm: LtmPartialSchema.optional(),
-  wiki: WikiPartialSchema.optional(),
-  mcp: ToolTogglePartialSchema.optional(),
-  skills: ToolTogglePartialSchema.optional(),
-  agents: AgentsPartialSchema.optional(),
-});
-
-const ConfigSchema = z
-  .object({
-    name: z.string().min(1),
-    llm: LlmSchema,
-    search: SearchPartialSchema.nullish(),
-    prompts: PromptsPartialSchema.nullish(),
-    tools: ToolsPartialSchema.nullish(),
-    compaction: CompactionPartialSchema.nullish().transform((c) => ({
-      ratio: c?.ratio ?? DEFAULT_COMPACTION.ratio,
-      keep: c?.keep ?? DEFAULT_COMPACTION.keep,
-    })),
-  })
-  .transform((input) => {
-    const ltm = input.tools?.ltm;
-    const wiki = input.tools?.wiki;
-    return {
-      name: input.name,
-      llm: input.llm,
-      search: {
-        enabled: input.search?.enabled ?? false,
-        provider: input.search?.provider ?? "brave",
-        brave: {
-          apiKey: input.search?.brave?.apiKey,
-        },
-        tavily: {
-          apiKey: input.search?.tavily?.apiKey,
-        },
-      },
-      prompts: {
-        behaviour: input.prompts?.behaviour ?? DEFAULT_PROMPTS.behaviour,
-        communication:
-          input.prompts?.communication ?? DEFAULT_PROMPTS.communication,
-        execution: input.prompts?.execution ?? DEFAULT_PROMPTS.execution,
-        engineering: input.prompts?.engineering ?? DEFAULT_PROMPTS.engineering,
-        guardrails: input.prompts?.guardrails ?? DEFAULT_PROMPTS.guardrails,
-      },
-      tools: {
-        todo: {
-          enabled: input.tools?.todo?.enabled ?? true,
-        },
-        fetch: {
-          enabled: input.tools?.fetch?.enabled ?? true,
-        },
-        filesystem: {
-          enabled: input.tools?.filesystem?.enabled ?? true,
-        },
-        shell: {
-          enabled: input.tools?.shell?.enabled ?? true,
-        },
-        sleep: {
-          enabled: input.tools?.sleep?.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,
-            },
-          },
-        },
-        mcp: {
-          enabled: input.tools?.mcp?.enabled ?? false,
-        },
-        skills: {
-          enabled: input.tools?.skills?.enabled ?? false,
-        },
-        agents: {
-          enabled: input.tools?.agents?.enabled ?? true,
-          concurrency: input.tools?.agents?.concurrency ?? 3,
-        },
-      },
-      compaction: input.compaction,
-    };
-  });
-
-export type ConfigData = z.infer<typeof ConfigSchema>;
-export type LlmConfig = z.infer<typeof LlmSchema>;
-export type CompactionConfig = ConfigData["compaction"];
-export type PromptsConfig = ConfigData["prompts"];
-export type LtmConfig = ConfigData["tools"]["ltm"];
-export type WikiConfig = ConfigData["tools"]["wiki"];
-export type SearchConfig = ConfigData["search"];
-export type ToolsConfig = ConfigData["tools"];
-
-const defaultConfigData = (): ConfigData => ({
-  name: "Hooman",
-  llm: {
-    provider: LlmProvider.Ollama,
-    model: "gemma4:e4b",
-    params: {},
-  },
-  search: {
-    enabled: false,
-    provider: "brave",
-    brave: { apiKey: undefined },
-    tavily: { apiKey: undefined },
-  },
-  prompts: { ...DEFAULT_PROMPTS },
-  tools: {
-    todo: {
-      enabled: true,
-    },
-    fetch: {
-      enabled: true,
-    },
-    filesystem: {
-      enabled: true,
-    },
-    shell: {
-      enabled: true,
-    },
-    sleep: {
-      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" },
-      },
-    },
-    mcp: {
-      enabled: false,
-    },
-    skills: {
-      enabled: false,
-    },
-    agents: {
-      enabled: true,
-      concurrency: 2,
-    },
-  },
-  compaction: {
-    ratio: 0.75,
-    keep: 5,
-  },
-});
-
-export class Config {
-  private data!: ConfigData;
-  private readonly path: string;
-
-  public constructor(path: string) {
-    this.path = path;
-    this.reload();
-  }
-
-  get name(): string {
-    return this.data.name;
-  }
-
-  get llm(): LlmConfig {
-    return this.data.llm;
-  }
-
-  get search(): SearchConfig {
-    return {
-      ...this.data.search,
-      brave: { ...this.data.search.brave },
-      tavily: { ...this.data.search.tavily },
-    };
-  }
-
-  get prompts(): PromptsConfig {
-    return { ...this.data.prompts };
-  }
-
-  get tools(): ToolsConfig {
-    return {
-      ...this.data.tools,
-      todo: { ...this.data.tools.todo },
-      fetch: { ...this.data.tools.fetch },
-      filesystem: { ...this.data.tools.filesystem },
-      shell: { ...this.data.tools.shell },
-      sleep: { ...this.data.tools.sleep },
-      ltm: {
-        ...this.data.tools.ltm,
-        chroma: {
-          ...this.data.tools.ltm.chroma,
-          collection: { ...this.data.tools.ltm.chroma.collection },
-        },
-      },
-      wiki: {
-        ...this.data.tools.wiki,
-        chroma: {
-          ...this.data.tools.wiki.chroma,
-          collection: { ...this.data.tools.wiki.chroma.collection },
-        },
-      },
-      mcp: { ...this.data.tools.mcp },
-      skills: { ...this.data.tools.skills },
-      agents: { ...this.data.tools.agents },
-    };
-  }
-
-  get compaction(): CompactionConfig {
-    return this.data.compaction;
-  }
-
-  get ltm(): LtmConfig {
-    return this.tools.ltm;
-  }
-
-  get wiki(): WikiConfig {
-    return this.tools.wiki;
-  }
-
-  private readJson(): unknown {
-    if (!existsSync(this.path)) {
-      return defaultConfigData();
-    }
-    return JSON.parse(readFileSync(this.path, "utf8"));
-  }
-
-  public reload(): void {
-    const wasMissing = !existsSync(this.path);
-    this.data = ConfigSchema.parse(this.readJson());
-    if (wasMissing) {
-      this.persist();
-    }
-  }
-
-  public persist(): void {
-    writeFileSync(this.path, JSON.stringify(this.data, null, 2), "utf8");
-  }
-
-  public update(partial: Partial<ConfigData>): void {
-    const updated = { ...this.data, ...partial };
-    this.data = ConfigSchema.parse(updated);
-    this.persist();
-  }
-}

package/src/core/index.ts

@@ -1,60 +0,0 @@
-import type { Agent } from "@strands-agents/sdk";
-import { Config } from "./config.ts";
-import { create as createAgent } from "./agent/index.ts";
-import {
-  createMcpConfig,
-  createMcpManager,
-  type Config as McpServersConfig,
-  type Manager as McpConnectionManager,
-  type NamedMcpTransport,
-} from "./mcp/index.ts";
-import { createSkillsRegistry } from "./skills/index.ts";
-import type { Registry } from "./skills/index.ts";
-import { system as createSystemPrompt } from "./prompts/index.ts";
-import {
-  basePath,
-  configJsonPath,
-  instructionsMdPath,
-  mcpJsonPath,
-} from "./utils/paths.ts";
-
-export type BootstrapMeta = {
-  userId?: string;
-  sessionId?: string;
-  acp?: AcpMeta;
-};
-
-export type BootstrapMode = "default" | "daemon" | "acp";
-
-export type AcpMeta = {
-  systemPrompt?: string;
-  mcpServers?: NamedMcpTransport[];
-};
-
-export async function bootstrap(
-  mode: BootstrapMode,
-  meta: BootstrapMeta,
-  print: boolean = false,
-): Promise<{
-  config: Config;
-  agent: Agent;
-  mcp: { config: McpServersConfig; manager: McpConnectionManager };
-  registry: Registry;
-}> {
-  const config = new Config(configJsonPath());
-  const mcpConfig = createMcpConfig(mcpJsonPath());
-  const mcpManager = createMcpManager(
-    mcpConfig,
-    mode === "acp",
-    meta.acp?.mcpServers ?? [],
-  );
-  const mcp = { config: mcpConfig, manager: mcpManager };
-  const registry = createSkillsRegistry(basePath());
-  const system = await createSystemPrompt(instructionsMdPath(), config, mode);
-  const agent = await createAgent(config, system, registry, mcp, print, {
-    userId: meta?.userId ?? meta?.sessionId,
-    sessionId: meta?.sessionId,
-    systemPrompt: meta?.acp?.systemPrompt,
-  });
-  return { config, agent, mcp, registry };
-}

package/src/core/mcp/config.ts

@@ -1,80 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { z } from "zod";
-import { McpTransportSchema, type McpTransport } from "./types.ts";
-
-const McpServersFileSchema = z.object({
-  mcpServers: z.record(z.string().min(1), McpTransportSchema).default({}),
-});
-
-export type McpServersFile = z.infer<typeof McpServersFileSchema>;
-
-/** One named MCP transport from the config file. */
-export type NamedMcpTransport = { name: string; transport: McpTransport };
-
-/**
- * Read/write `{"mcpServers": { "<name>": <transport> }}` on disk.
- */
-export class Config {
-  private readonly path: string;
-  private servers: Record<string, McpTransport>;
-
-  public constructor(path: string) {
-    this.path = path;
-    this.servers = {};
-    this.reload();
-  }
-
-  private readJson(): McpServersFile {
-    if (!existsSync(this.path)) {
-      return { mcpServers: {} };
-    }
-    const raw = readFileSync(this.path, "utf8");
-    return JSON.parse(raw) as McpServersFile;
-  }
-
-  /** Reload servers from disk (overwrites unsaved in-memory changes). */
-  public reload(): void {
-    const parsed = McpServersFileSchema.parse(this.readJson());
-    this.servers = { ...parsed.mcpServers };
-  }
-
-  private persist(): void {
-    const payload: McpServersFile = { mcpServers: { ...this.servers } };
-    writeFileSync(this.path, JSON.stringify(payload, null, 2), "utf8");
-  }
-
-  /** All configured servers, stable sort by name. */
-  public list(): NamedMcpTransport[] {
-    return Object.entries(this.servers)
-      .sort(([a], [b]) => a.localeCompare(b))
-      .map(([name, transport]) => ({ name, transport }));
-  }
-
-  public get(name: string): McpTransport | undefined {
-    return this.servers[name];
-  }
-
-  public add(name: string, transport: McpTransport): void {
-    if (Object.hasOwn(this.servers, name)) {
-      throw new Error(`MCP server "${name}" already exists`);
-    }
-    this.servers[name] = transport;
-    this.persist();
-  }
-
-  public update(name: string, transport: McpTransport): void {
-    if (!Object.hasOwn(this.servers, name)) {
-      throw new Error(`MCP server "${name}" not found`);
-    }
-    this.servers[name] = transport;
-    this.persist();
-  }
-
-  public remove(name: string): void {
-    if (!Object.hasOwn(this.servers, name)) {
-      throw new Error(`MCP server "${name}" not found`);
-    }
-    delete this.servers[name];
-    this.persist();
-  }
-}

package/src/core/mcp/index.ts

@@ -1,33 +0,0 @@
-import { Config, type NamedMcpTransport } from "./config.ts";
-import {
-  Manager,
-  HOOMAN_CHANNEL,
-  HOOMAN_CHANNEL_PERMISSION,
-  type ChannelMessage,
-  type ChannelPermissionBehavior,
-  type ChannelSubscription,
-  type ChannelSubscriptionHandle,
-} from "./manager.ts";
-
-export { Config, Manager };
-export { HOOMAN_CHANNEL, HOOMAN_CHANNEL_PERMISSION };
-export type {
-  ChannelMessage,
-  ChannelPermissionBehavior,
-  ChannelSubscription,
-  ChannelSubscriptionHandle,
-  NamedMcpTransport,
-};
-export { createMcpTools } from "./tools.ts";
-
-export function createMcpConfig(path: string): Config {
-  return new Config(path);
-}
-
-export function createMcpManager(
-  config: Config,
-  acp = false,
-  mcpServers: readonly NamedMcpTransport[] = [],
-): Manager {
-  return new Manager(config, acp, mcpServers);
-}