hoomanjs 1.18.0 → 1.18.1

package/src/configure/components/BusyScreen.tsx

@@ -1,22 +0,0 @@
-import React from "react";
-import { Box, Text } from "ink";
-import { Spinner } from "../../chat/components/Spinner.tsx";
-
-type BusyScreenProps = {
-  message: string;
-};
-
-export function BusyScreen({ message }: BusyScreenProps): React.JSX.Element {
-  return (
-    <Box flexDirection="column" marginTop={1}>
-      <Text bold>Working</Text>
-      <Box marginTop={1}>
-        <Spinner type="dots" color="cyan" />
-        <Text>{` ${message}`}</Text>
-      </Box>
-      <Box marginTop={1}>
-        <Text color="gray">Please wait...</Text>
-      </Box>
-    </Box>
-  );
-}

package/src/configure/components/HomeScreen.tsx

@@ -1,43 +0,0 @@
-import React from "react";
-import { Box, Text } from "ink";
-import type { MenuItem } from "../types.ts";
-import { MenuScreen } from "./MenuScreen.tsx";
-
-type HomeScreenProps = {
-  rootPath: string;
-  configPath: string;
-  instructionsPath: string;
-  mcpPath: string;
-  skillsPath: string;
-  items: MenuItem[];
-};
-
-export function HomeScreen({
-  rootPath,
-  configPath,
-  instructionsPath,
-  mcpPath,
-  skillsPath,
-  items,
-}: HomeScreenProps): React.JSX.Element {
-  return (
-    <Box flexDirection="column" marginTop={1}>
-      <Text color="gray">
-        <Text bold>root:</Text> {rootPath}
-      </Text>
-      <Text color="gray">
-        <Text bold>config.json:</Text> {configPath}
-      </Text>
-      <Text color="gray">
-        <Text bold>instructions.md:</Text> {instructionsPath}
-      </Text>
-      <Text color="gray">
-        <Text bold>mcp.json:</Text> {mcpPath}
-      </Text>
-      <Text color="gray">
-        <Text bold>skills/:</Text> {skillsPath}
-      </Text>
-      <MenuScreen items={items} footerHint="enter: select | ctrl+c: exit" />
-    </Box>
-  );
-}

package/src/configure/components/MenuScreen.tsx

@@ -1,44 +0,0 @@
-import React from "react";
-import { Box, Text } from "ink";
-import SelectInput from "ink-select-input";
-import type { MenuAction, MenuItem } from "../types.ts";
-import { SelectMenuItem } from "./SelectMenuItem.tsx";
-
-type MenuScreenProps = {
-  title?: string;
-  description?: string;
-  items: MenuItem[];
-  footerHint?: string;
-};
-
-export function MenuScreen({
-  title,
-  description,
-  items,
-  footerHint = "enter: select | esc: back | ctrl+c: exit",
-}: MenuScreenProps): React.JSX.Element {
-  const hasHeader = Boolean(title?.trim()) || Boolean(description?.trim());
-  const keyedItems = items.map((item, index) => ({
-    ...item,
-    key: item.key ?? `${title ?? "menu"}:${index}:${item.label}`,
-  }));
-
-  return (
-    <Box flexDirection="column" marginTop={1}>
-      {title?.trim() ? <Text bold>{title}</Text> : null}
-      {description ? <Text color="gray">{description}</Text> : null}
-      <Box marginTop={hasHeader ? 1 : 0}>
-        <SelectInput<MenuAction>
-          items={keyedItems}
-          itemComponent={SelectMenuItem}
-          onSelect={(item) => {
-            void item.value();
-          }}
-        />
-      </Box>
-      <Box marginTop={1}>
-        <Text color="gray">{footerHint}</Text>
-      </Box>
-    </Box>
-  );
-}

package/src/configure/components/PromptForm.tsx

@@ -1,40 +0,0 @@
-import React, { useEffect, useState } from "react";
-import { Box, Text } from "ink";
-import TextInput from "ink-text-input";
-import type { PromptState } from "../types.ts";
-
-type PromptFormProps = {
-  prompt: PromptState;
-  onSubmit: (value: string) => void | Promise<void>;
-};
-
-export function PromptForm({
-  prompt,
-  onSubmit,
-}: PromptFormProps): React.JSX.Element {
-  const [value, setValue] = useState(prompt.initialValue ?? "");
-
-  useEffect(() => {
-    setValue(prompt.initialValue ?? "");
-  }, [prompt.initialValue, prompt.title, prompt.label]);
-
-  return (
-    <Box flexDirection="column" marginTop={1}>
-      <Text bold>{prompt.title}</Text>
-      <Text color="gray">{prompt.label}</Text>
-      {prompt.note ? <Text color="gray">{prompt.note}</Text> : null}
-      <Box marginTop={1} borderStyle="round" borderColor="cyan" paddingX={1}>
-        <Text color="gray">{"> "}</Text>
-        <TextInput
-          value={value}
-          onChange={setValue}
-          onSubmit={() => void onSubmit(value)}
-          placeholder={prompt.placeholder ?? ""}
-        />
-      </Box>
-      <Box marginTop={1}>
-        <Text color="gray">enter: submit | esc: cancel | ctrl+c: exit</Text>
-      </Box>
-    </Box>
-  );
-}

package/src/configure/components/SelectMenuItem.tsx

@@ -1,30 +0,0 @@
-import React from "react";
-import { Text } from "ink";
-
-/** Custom row for `ink-select-input` so we can bold part of the label. */
-export function SelectMenuItem(props: {
-  isSelected?: boolean;
-  label: string;
-  boldSubstring?: string;
-}): React.JSX.Element {
-  const { isSelected, label, boldSubstring } = props;
-  const color = isSelected ? "blue" : undefined;
-  if (!boldSubstring) {
-    return <Text color={color}>{label}</Text>;
-  }
-  const i = label.indexOf(boldSubstring);
-  if (i === -1) {
-    return <Text color={color}>{label}</Text>;
-  }
-  const before = label.slice(0, i);
-  const after = label.slice(i + boldSubstring.length);
-  return (
-    <Text color={color}>
-      {before}
-      <Text bold color={color}>
-        {boldSubstring}
-      </Text>
-      {after}
-    </Text>
-  );
-}

package/src/configure/index.tsx

@@ -1,43 +0,0 @@
-import React from "react";
-import { mkdir } from "node:fs/promises";
-import { render } from "ink";
-import { ConfigureApp } from "./app.tsx";
-import { Config as AppConfig } from "../core/config.ts";
-import { Config as McpConfig } from "../core/mcp/config.ts";
-import { createSkillsRegistry } from "../core/skills/index.ts";
-import {
-  basePath,
-  configJsonPath,
-  mcpJsonPath,
-  skillsPath,
-} from "../core/utils/paths.ts";
-
-export async function configure(): Promise<void> {
-  await mkdir(basePath(), { recursive: true });
-  await mkdir(skillsPath(), { recursive: true });
-
-  const config = new AppConfig(configJsonPath());
-  const mcpConfig = new McpConfig(mcpJsonPath());
-  const skills = createSkillsRegistry(basePath());
-
-  let done = false;
-  const { waitUntilExit, unmount } = render(
-    <ConfigureApp
-      config={config}
-      mcpConfig={mcpConfig}
-      skills={skills}
-      onExit={() => {
-        done = true;
-      }}
-    />,
-    { exitOnCtrlC: false },
-  );
-
-  try {
-    await waitUntilExit();
-  } finally {
-    if (!done) {
-      unmount();
-    }
-  }
-}

package/src/configure/open-in-editor.ts

@@ -1,133 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
-import tty from "node:tty";
-
-/**
- * Open a real file in VISUAL / EDITOR (or a sensible platform default),
- * block until the editor exits, then return the updated contents.
- *
- * This temporarily releases TTY raw mode so Ink can coexist with full-screen
- * terminal editors like vim / nano.
- */
-export function openFileInEditor(
-  filePath: string,
-  initialContent: string,
-): string {
-  mkdirSync(dirname(filePath), { recursive: true });
-  if (!existsSync(filePath)) {
-    writeFileSync(filePath, initialContent, "utf8");
-  }
-
-  const restore = releaseStdinForSubprocess();
-  try {
-    const { command, args, options } = resolveEditorSpawn(filePath);
-    const result = spawnSync(command, args, options);
-    if (result.error) {
-      throw result.error;
-    }
-    if (result.status !== 0 && result.status !== null) {
-      throw new Error(`Editor exited with code ${result.status}`);
-    }
-    return readFileSync(filePath, "utf8");
-  } finally {
-    restore();
-  }
-}
-
-function releaseStdinForSubprocess(): () => void {
-  if (!process.stdin.isTTY) {
-    return () => {};
-  }
-  const stdin = process.stdin as tty.ReadStream;
-  const wasRaw = stdin.isRaw;
-  if (wasRaw) {
-    stdin.setRawMode(false);
-  }
-  stdin.pause();
-  return () => {
-    stdin.resume();
-    if (wasRaw) {
-      stdin.setRawMode(true);
-    }
-  };
-}
-
-function resolveEditorSpawn(filePath: string): {
-  command: string;
-  args: string[];
-  options: { stdio: "inherit"; shell?: boolean };
-} {
-  const spec = (process.env.VISUAL ?? process.env.EDITOR ?? "").trim();
-  if (!spec) {
-    if (process.platform === "win32") {
-      return {
-        command: "notepad",
-        args: [filePath],
-        options: { stdio: "inherit" },
-      };
-    }
-    return {
-      command: "vi",
-      args: [filePath],
-      options: { stdio: "inherit" },
-    };
-  }
-
-  if (process.platform === "win32") {
-    return {
-      command: `${spec} "${filePath.replace(/"/g, '\\"')}"`,
-      args: [],
-      options: { stdio: "inherit", shell: true },
-    };
-  }
-
-  const parts = tokenizeEditorSpec(spec);
-  if (parts.length === 0) {
-    return {
-      command: "vi",
-      args: [filePath],
-      options: { stdio: "inherit" },
-    };
-  }
-
-  return {
-    command: parts[0]!,
-    args: [...parts.slice(1), filePath],
-    options: { stdio: "inherit" },
-  };
-}
-
-/** Split VISUAL/EDITOR on spaces with basic quoted-token support. */
-function tokenizeEditorSpec(s: string): string[] {
-  const out: string[] = [];
-  let cur = "";
-  let quote: '"' | "'" | null = null;
-  for (let i = 0; i < s.length; i += 1) {
-    const c = s[i]!;
-    if (quote) {
-      if (c === quote) {
-        quote = null;
-      } else {
-        cur += c;
-      }
-      continue;
-    }
-    if (c === '"' || c === "'") {
-      quote = c as '"' | "'";
-      continue;
-    }
-    if (/\s/.test(c)) {
-      if (cur.length > 0) {
-        out.push(cur);
-        cur = "";
-      }
-      continue;
-    }
-    cur += c;
-  }
-  if (cur.length > 0) {
-    out.push(cur);
-  }
-  return out;
-}

package/src/configure/types.ts

@@ -1,51 +0,0 @@
-import type { Config as AppConfig } from "../core/config.ts";
-import type { Config as McpConfig } from "../core/mcp/config.ts";
-import type { Registry as SkillsRegistry } from "../core/skills/registry.ts";
-
-export type ConfigureAppProps = {
-  config: AppConfig;
-  mcpConfig: McpConfig;
-  skills: SkillsRegistry;
-  onExit: () => void;
-};
-
-export type Screen =
-  | { kind: "home" }
-  | { kind: "config" }
-  | { kind: "config-tools" }
-  | { kind: "config-provider" }
-  | { kind: "config-prompts" }
-  | { kind: "config-search" }
-  | { kind: "config-search-provider" }
-  | { kind: "config-ltm" }
-  | { kind: "config-wiki" }
-  | { kind: "mcp" }
-  | { kind: "mcp-delete-confirm"; name: string }
-  | { kind: "skills" }
-  | { kind: "skills-delete-confirm"; folder: string; displayName: string }
-  | { kind: "skills-search-results"; query: string };
-
-export type Notice = {
-  kind: "success" | "error" | "info";
-  text: string;
-};
-
-export type PromptState = {
-  title: string;
-  label: string;
-  initialValue?: string;
-  placeholder?: string;
-  note?: string;
-  onSubmit: (value: string) => void | Promise<void>;
-  onCancel?: () => void;
-};
-
-export type MenuAction = () => void | Promise<void>;
-
-export type MenuItem = {
-  key?: string;
-  label: string;
-  /** First occurrence in `label` is rendered bold (MCP server name, skill title, etc.). */
-  boldSubstring?: string;
-  value: MenuAction;
-};

package/src/configure/utils.ts

@@ -1,134 +0,0 @@
-import { basename, dirname } from "node:path";
-import { z } from "zod";
-import type { McpTransport } from "../core/mcp/types.ts";
-import type { SkillListEntry } from "../core/skills/registry.ts";
-import type { Notice } from "./types.ts";
-
-const StringArraySchema = z.array(z.string());
-const StringRecordSchema = z.record(z.string(), z.string());
-
-export const DEFAULT_INSTRUCTIONS = `# Instructions
-
-You are Hooman.
-`;
-
-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;
-}
-
-export function folderNameForSkill(skill: SkillListEntry): string {
-  return basename(dirname(skill.path));
-}
-
-export function parseObjectRecord(
-  input: string,
-  label: string,
-): Record<string, unknown> {
-  const trimmed = input.trim();
-  if (!trimmed) {
-    return {};
-  }
-  const parsed = JSON.parse(trimmed) as unknown;
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`${label} must be a JSON object.`);
-  }
-  return parsed as Record<string, unknown>;
-}
-
-export function parseStringArray(input: string, label: string): string[] {
-  const trimmed = input.trim();
-  if (!trimmed) {
-    return [];
-  }
-  return StringArraySchema.parse(JSON.parse(trimmed), {
-    error: () => `${label} must be a JSON string array.`,
-  });
-}
-
-export function parseStringRecord(
-  input: string,
-  label: string,
-): Record<string, string> | undefined {
-  const trimmed = input.trim();
-  if (!trimmed) {
-    return undefined;
-  }
-  return StringRecordSchema.parse(JSON.parse(trimmed), {
-    error: () => `${label} must be a JSON object with string values.`,
-  });
-}
-
-export function parseNumber(
-  input: string,
-  label: string,
-  options: { min?: number; max?: number; integer?: boolean } = {},
-): number {
-  const value = Number(input.trim());
-  if (!Number.isFinite(value)) {
-    throw new Error(`${label} must be a number.`);
-  }
-  if (options.integer && !Number.isInteger(value)) {
-    throw new Error(`${label} must be an integer.`);
-  }
-  if (options.min !== undefined && value < options.min) {
-    throw new Error(`${label} must be >= ${options.min}.`);
-  }
-  if (options.max !== undefined && value > options.max) {
-    throw new Error(`${label} must be <= ${options.max}.`);
-  }
-  return value;
-}
-
-export function normalizeOptional(input: string): string | undefined {
-  const trimmed = input.trim();
-  return trimmed ? trimmed : undefined;
-}
-
-export function transportSummary(transport: McpTransport): string {
-  switch (transport.type) {
-    case "stdio":
-      return `${transport.type} • ${transport.command}`;
-    case "streamable-http":
-    case "sse":
-      return `${transport.type} • ${transport.url}`;
-    default:
-      return String(transport);
-  }
-}
-
-export function noticeColor(kind: Notice["kind"]): string {
-  switch (kind) {
-    case "success":
-      return "green";
-    case "error":
-      return "red";
-    case "info":
-    default:
-      return "cyan";
-  }
-}

package/src/core/agent/index.ts

@@ -1,108 +0,0 @@
-import { Agent, BeforeInvocationEvent } from "@strands-agents/sdk";
-import type { Tool } from "@strands-agents/sdk";
-import type { Config } from "../config.ts";
-import { modelProviders } from "../models";
-import {
-  createMcpTools,
-  type Config as McpConfig,
-  type Manager as McpManager,
-} from "../mcp";
-import type { System as SystemPrompt } from "../prompts";
-import { skills as createSkillsPrompt } from "../prompts";
-import {
-  createShortTermMemory,
-  createLongTermMemoryStore,
-  createLongTermMemoryTools,
-} from "../memory";
-import { createSkillsTools, type Registry } from "../skills";
-import {
-  createRunAgentsTools,
-  loadBuiltInAgentDefinitions,
-} from "../agents/index.ts";
-import {
-  createTodoTools,
-  createFetchTools,
-  createFilesystemTools,
-  createSleepTools,
-  createShellTools,
-  createThinkingTools,
-  createTimeTools,
-  createWikiTools,
-  createWebSearchTools,
-} from "../tools";
-import { clearTodoState } from "../state/todos.ts";
-
-const SECTION_BREAK = "\n\n---\n\n";
-
-export async function create(
-  config: Config,
-  system: SystemPrompt,
-  registry: Registry,
-  mcp: { config: McpConfig; manager: McpManager },
-  print: boolean = false,
-  meta: {
-    userId?: string;
-    sessionId?: string;
-    systemPrompt?: string;
-  },
-): Promise<Agent> {
-  const sessionId = meta.sessionId;
-  const userId = meta.userId ?? sessionId;
-  const llm = await modelProviders[config.llm.provider]!();
-  const stm = createShortTermMemory(sessionId);
-  const ltm = config.tools.ltm.enabled
-    ? createLongTermMemoryStore(config)
-    : null;
-  const skills = (await createSkillsPrompt(registry)).content;
-  const prefixed = await mcp.manager.listPrefixedTools();
-  const append = await mcp.manager.listServerInstructions();
-  const prompt = [system.content, meta.systemPrompt, ...append, skills]
-    .filter((x) => !!x)
-    .join(SECTION_BREAK);
-  const model = llm.create(config.llm.model, config.llm.params);
-  const tools: Tool[] = [
-    ...createTimeTools(),
-    ...(config.tools.sleep.enabled ? createSleepTools() : []),
-    ...(config.tools.todo.enabled ? createTodoTools() : []),
-    ...(config.tools.fetch.enabled ? createFetchTools() : []),
-    ...(ltm ? createLongTermMemoryTools(ltm) : []),
-    ...(config.tools.filesystem.enabled ? createFilesystemTools() : []),
-    ...(config.tools.shell.enabled ? createShellTools() : []),
-    ...(config.search.enabled ? createWebSearchTools(config) : []),
-    ...(config.tools.wiki.enabled ? createWikiTools(config) : []),
-    ...(config.tools.mcp.enabled ? createMcpTools(mcp.config) : []),
-    ...(config.tools.skills.enabled ? createSkillsTools(registry) : []),
-    ...createThinkingTools(),
-    ...prefixed,
-  ];
-  if (config.tools.agents.enabled) {
-    const definitions = loadBuiltInAgentDefinitions(config, {
-      knownTools: tools.map((entry) => entry.name),
-    });
-    tools.push(
-      ...createRunAgentsTools({
-        parent: config.name,
-        definitions,
-        tools,
-        createModel: () => llm.create(config.llm.model, config.llm.params),
-        defaultConcurrency: config.tools.agents.concurrency,
-      }),
-    );
-  }
-  const agent = new Agent({
-    name: config.name,
-    systemPrompt: prompt,
-    model,
-    appState: {
-      ...(userId ? { userId } : {}),
-      ...(sessionId ? { sessionId } : {}),
-    },
-    tools,
-    printer: print,
-    ...stm,
-  });
-  agent.addHook(BeforeInvocationEvent, async (event) => {
-    clearTodoState(event.agent);
-  });
-  return agent;
-}

package/src/core/agents/definitions.ts

@@ -1,48 +0,0 @@
-export const BUILTIN_AGENT_KINDS = ["research", "plan"] as const;
-
-export type AgentKind = (typeof BUILTIN_AGENT_KINDS)[number];
-
-export type AgentConfig = {
-  id: AgentKind;
-  instructions: string;
-  description: string;
-  tools: readonly string[];
-};
-
-export type AgentDefinition = AgentConfig & {
-  instructionsText: string;
-};
-
-export const BUILTIN_AGENT_CONFIGS: readonly AgentConfig[] = [
-  {
-    id: "research",
-    instructions: "research.md",
-    description: "Investigates sources and context before the parent acts.",
-    tools: [
-      "read_file",
-      "read_multiple_files",
-      "list_directory",
-      "directory_tree",
-      "search_files",
-      "get_file_info",
-      "fetch",
-      "web_search",
-      "think",
-    ],
-  },
-  {
-    id: "plan",
-    instructions: "plan.md",
-    description: "Produces plans, tradeoffs, risks, and validation steps.",
-    tools: [
-      "read_file",
-      "read_multiple_files",
-      "list_directory",
-      "directory_tree",
-      "search_files",
-      "get_file_info",
-      "web_search",
-      "think",
-    ],
-  },
-];