hoomanjs 1.18.0 → 1.18.1

package/src/core/prompts/environment.ts

@@ -1,71 +0,0 @@
-import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import {
-  release as osRelease,
-  type as osType,
-  version as osVersion,
-} from "node:os";
-
-type EnvironmentPromptContext = {
-  cwd: string;
-  platform: string;
-  osVersion: string;
-  shell: string;
-  isGitRepo: boolean;
-  currentDateTime: string;
-  timeZone: string;
-};
-
-function detectPlatform(): string {
-  return ["darwin", "linux", "win32"].includes(process.platform)
-    ? process.platform
-    : process.platform;
-}
-
-function detectOsVersion(): string {
-  if (process.platform === "win32") {
-    return `${osVersion()} ${osRelease()}`;
-  }
-  return `${osType()} ${osRelease()}`;
-}
-
-function detectShell(): string {
-  const shell =
-    process.env.SHELL ||
-    process.env.ComSpec ||
-    process.env.COMSPEC ||
-    "unknown";
-  return shell.trim() || "unknown";
-}
-
-function detectGitRepo(startDir: string): boolean {
-  let current = startDir;
-  while (true) {
-    if (existsSync(join(current, ".git"))) {
-      return true;
-    }
-    const parent = dirname(current);
-    if (parent === current) {
-      return false;
-    }
-    current = parent;
-  }
-}
-
-function detectTimeZone(): string {
-  return Intl.DateTimeFormat().resolvedOptions().timeZone || "unknown";
-}
-
-export function getEnvironmentPromptContext(): EnvironmentPromptContext {
-  const cwd = process.cwd();
-  const now = new Date();
-  return {
-    cwd,
-    platform: detectPlatform(),
-    osVersion: detectOsVersion(),
-    shell: detectShell(),
-    isGitRepo: detectGitRepo(cwd),
-    currentDateTime: now.toString(),
-    timeZone: detectTimeZone(),
-  };
-}

package/src/core/prompts/index.ts

@@ -1,22 +0,0 @@
-import type { Config } from "../config.ts";
-import type { Registry } from "../skills/registry.ts";
-import { Skills } from "./skills.ts";
-import { System, type SystemMode } from "./system.ts";
-
-export { Skills, System };
-
-export async function system(
-  path: string,
-  config: Config,
-  mode: SystemMode = "default",
-): Promise<System> {
-  const prompt = new System(path, config, mode);
-  await prompt.reload();
-  return prompt;
-}
-
-export async function skills(registry: Registry): Promise<Skills> {
-  const prompt = new Skills(registry);
-  await prompt.reload();
-  return prompt;
-}

package/src/core/prompts/skills.ts

@@ -1,66 +0,0 @@
-import { existsSync } from "node:fs";
-import { join, resolve } from "node:path";
-import type { Registry } from "../skills/registry.ts";
-
-/**
- * Builds the dynamic **Available skills** markdown block using
- * {@link Registry.list} (same source as the skills CLI).
- *
- * Mirrors {@link System}: call {@link reload}, then read {@link content}.
- */
-export class Skills {
-  private readonly registry: Registry;
-  private data = "";
-
-  public constructor(registry: Registry) {
-    this.registry = registry;
-  }
-
-  get content(): string {
-    return this.data;
-  }
-
-  public async reload(): Promise<void> {
-    let entries;
-    try {
-      entries = await this.registry.list();
-    } catch {
-      this.data = [
-        "## Available skills",
-        "",
-        "The skills list could not be loaded (for example if `npx skills` is unavailable). Skills management tools may still work; try again later.",
-        "",
-      ].join("\n");
-      return;
-    }
-
-    const lines: string[] = [
-      "## Available skills",
-      "",
-      "Installed skills for this environment. When one matches the user's request or would materially help the current turn, read its `SKILL.md` at the path shown (for example with your file-reading tool) and follow that guidance.",
-      "",
-    ];
-
-    if (entries.length === 0) {
-      lines.push(
-        "No skills are installed yet. Use the skills management tools to search and install packages, or add them under your agent skills directory.",
-        "",
-      );
-      this.data = lines.join("\n").trim();
-      return;
-    }
-
-    const sorted = [...entries].sort((a, b) =>
-      a.name.localeCompare(b.name, undefined, { sensitivity: "base" }),
-    );
-
-    for (const e of sorted) {
-      lines.push(`- **${e.name}**`);
-      lines.push(`  - Description: ${e.description}`);
-      lines.push(`  - Path: \`${e.path}\``);
-      lines.push("");
-    }
-
-    this.data = lines.join("\n").trim();
-  }
-}

package/src/core/prompts/system.ts

@@ -1,183 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { compile } from "handlebars";
-import type { Config } from "../config.ts";
-import { getEnvironmentPromptContext } from "./environment.ts";
-
-/** Bundled markdown next to this module (`prompts/static/`). */
-const STATIC_PROMPT_FILES = [
-  "identity.md",
-  "environment.md",
-  "ltm.md",
-  "todo.md",
-  "thinking.md",
-  "filesystem.md",
-  "fetch.md",
-  "web-search.md",
-  "shell.md",
-  "sleep.md",
-  "daemon.md",
-  "wiki.md",
-  "skills.md",
-  "subagents.md",
-] as const;
-
-const HARNESS_PROMPT_FILES = [
-  { key: "behaviour", file: "behaviour.md" },
-  { key: "communication", file: "communication.md" },
-  { key: "execution", file: "execution.md" },
-  { key: "engineering", file: "engineering.md" },
-  { key: "guardrails", file: "guardrails.md" },
-] as const;
-
-export type SystemMode = "default" | "daemon" | "acp";
-
-const SECTION_BREAK = "\n\n---\n\n";
-const EXTRA_CWD_INSTRUCTIONS = "AGENTS.md";
-
-/**
- * Loads `prompts/static/*.md` from the package, then `instructions.md` from disk,
- * concatenates them, and renders with Handlebars using `context`.
- */
-export class System {
-  private readonly path: string;
-  private readonly config: Config;
-  private readonly mode: SystemMode;
-  private data = "";
-
-  public constructor(
-    path: string,
-    config: Config,
-    mode: SystemMode = "default",
-  ) {
-    this.path = path;
-    this.config = config;
-    this.mode = mode;
-  }
-
-  private staticPromptFiles(): readonly (typeof STATIC_PROMPT_FILES)[number][] {
-    return STATIC_PROMPT_FILES.filter((file) => {
-      switch (file) {
-        case "ltm.md":
-          return this.config.tools.ltm.enabled;
-        case "fetch.md":
-          return this.config.tools.fetch.enabled;
-        case "web-search.md":
-          return this.config.search.enabled;
-        case "todo.md":
-          return this.config.tools.todo.enabled;
-        case "filesystem.md":
-          return this.config.tools.filesystem.enabled;
-        case "shell.md":
-          return this.config.tools.shell.enabled;
-        case "sleep.md":
-          return this.config.tools.sleep.enabled;
-        case "daemon.md":
-          return this.mode === "daemon";
-        case "wiki.md":
-          return this.config.tools.wiki.enabled;
-        case "skills.md":
-          return this.config.tools.skills.enabled;
-        case "subagents.md":
-          return this.config.tools.agents.enabled;
-        case "thinking.md":
-        default:
-          return true;
-      }
-    });
-  }
-
-  private readBundledStaticPrompts(): string {
-    const dir = join(dirname(fileURLToPath(import.meta.url)), "static");
-    const parts: string[] = [];
-    for (const file of this.staticPromptFiles()) {
-      const full = join(dir, file);
-      if (!existsSync(full)) {
-        continue;
-      }
-      const text = readFileSync(full, "utf8").trim();
-      if (text.length > 0) {
-        parts.push(text);
-      }
-    }
-    return parts.join("\n\n");
-  }
-
-  private readBundledHarnessPrompts(): string {
-    const dir = join(dirname(fileURLToPath(import.meta.url)), "harness");
-    const parts: string[] = [];
-    for (const { key, file } of HARNESS_PROMPT_FILES) {
-      if (!this.config.prompts[key]) {
-        continue;
-      }
-      const full = join(dir, file);
-      if (!existsSync(full)) {
-        continue;
-      }
-      const text = readFileSync(full, "utf8").trim();
-      if (text.length > 0) {
-        parts.push(text);
-      }
-    }
-    return parts.join("\n\n");
-  }
-
-  private readCwdAgentsInstructions(): string {
-    const path = join(process.cwd(), EXTRA_CWD_INSTRUCTIONS);
-    if (!existsSync(path)) {
-      return "";
-    }
-    return readFileSync(path, "utf8").trim();
-  }
-
-  private readRawText(): string {
-    const instructions = existsSync(this.path)
-      ? readFileSync(this.path, "utf8").trim()
-      : "";
-    const bundled = this.readBundledStaticPrompts();
-    const harness = this.readBundledHarnessPrompts();
-    const extra = this.readCwdAgentsInstructions();
-
-    const blocks: string[] = [];
-    if (bundled.length > 0) {
-      blocks.push(bundled);
-    }
-    if (harness.length > 0) {
-      blocks.push(harness);
-    }
-    if (instructions.length > 0) {
-      blocks.push(instructions);
-    }
-    if (extra.length > 0) {
-      blocks.push(extra);
-    }
-    if (blocks.length === 0) {
-      return "";
-    }
-    return blocks.join(SECTION_BREAK);
-  }
-
-  get content(): string {
-    return this.data;
-  }
-
-  /** Plain object for Handlebars (`{{name}}`, `{{llm.model}}`, …). */
-  private context(): Record<string, unknown> {
-    return {
-      name: this.config.name,
-      llm: this.config.llm,
-      environment: getEnvironmentPromptContext(),
-      ltm: this.config.tools.ltm,
-      wiki: this.config.tools.wiki,
-      compaction: this.config.compaction,
-      mode: this.mode,
-    };
-  }
-
-  public async reload(): Promise<void> {
-    const raw = this.readRawText();
-    const template = compile(raw);
-    this.data = template(this.context()).trim();
-  }
-}

package/src/core/skills/index.ts

@@ -1,2 +0,0 @@
-export { Registry, create as createSkillsRegistry } from "./registry.ts";
-export { create as createSkillsTools } from "./tools.ts";

package/src/core/skills/registry.ts

@@ -1,239 +0,0 @@
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { readFile, rm } from "node:fs/promises";
-import { basename, isAbsolute, join, resolve } from "node:path";
-import matter from "gray-matter";
-
-const execFileAsync = promisify(execFile);
-
-/** Vercel `skills` CLI package; uses latest every time. */
-const SKILLS_CLI = "skills@latest";
-/** Agent target for `skills add/list` — OpenClaw layout → `./skills/`. */
-const SKILLS_AGENT = "openclaw";
-const SKILLS_API_URL = "https://skills.sh";
-const NPX_BIN = process.platform === "win32" ? "npx.cmd" : "npx";
-
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-
-/**
- * Parse name and description from a SKILL.md file's YAML frontmatter.
- */
-function parseSkillFrontmatter(
-  content: string,
-  dirName: string,
-): { name: string; description?: string } {
-  try {
-    const { data } = matter(content);
-    const name =
-      typeof data?.name === "string" && data.name.trim()
-        ? data.name.trim()
-        : dirName;
-    const description =
-      typeof data?.description === "string" && data.description.trim()
-        ? data.description.trim()
-        : undefined;
-    return { name, description };
-  } catch {
-    return { name: dirName };
-  }
-}
-
-function stripAnsi(s: string): string {
-  return s.replace(ANSI_RE, "");
-}
-
-type SkillsListJsonRow = {
-  name: string;
-  path: string;
-  scope?: string;
-  agents?: string[];
-};
-
-export type SkillListEntry = {
-  /** Display title (skill `name` from SKILL.md) */
-  name: string;
-  /** Full description read using gray-matter */
-  description?: string;
-  /** Absolute path to the skill package root from `skills list --json`. */
-  path: string;
-};
-
-export interface SkillSearchResult {
-  name: string;
-  slug: string;
-  source: string;
-  installs: number;
-}
-
-async function runNpxSkills(
-  args: string[],
-  options: { cwd?: string; timeout?: number } = {},
-): Promise<{ stdout: string; stderr: string }> {
-  const { cwd, timeout = 300_000 } = options;
-  return execFileAsync(NPX_BIN, ["--yes", SKILLS_CLI, ...args], {
-    cwd,
-    maxBuffer: 20 * 1024 * 1024,
-    timeout,
-    env: { ...process.env, NO_COLOR: "1", FORCE_COLOR: "0" },
-  });
-}
-
-/**
- * Install / list / delete skills via the Vercel [`skills` CLI](https://github.com/vercel-labs/skills)
- * (`npx skills`), using OpenClaw scope (`./skills/`).
- */
-export class Registry {
-  private readonly cwd: string;
-
-  constructor(cwd: string) {
-    this.cwd = cwd;
-  }
-
-  async list(): Promise<SkillListEntry[]> {
-    let stdout: string;
-    try {
-      const r = await runNpxSkills(["list", "--json", "-a", SKILLS_AGENT], {
-        cwd: this.cwd,
-      });
-      stdout = r.stdout;
-    } catch (e) {
-      const err = e as { stderr?: string; message?: string };
-      const detail = err.stderr ?? err.message ?? String(e);
-      throw new Error(
-        `skills list failed. Is Node/npm available?\n${stripAnsi(detail)}`,
-      );
-    }
-    const text = stdout.trim();
-    if (!text) {
-      return [];
-    }
-    let rows: SkillsListJsonRow[];
-    try {
-      rows = JSON.parse(text) as SkillsListJsonRow[];
-    } catch {
-      throw new Error(
-        `Unexpected skills list output (expected JSON):\n${text.slice(0, 500)}`,
-      );
-    }
-    if (!Array.isArray(rows)) {
-      return [];
-    }
-    const entries: SkillListEntry[] = [];
-    for (const row of rows) {
-      try {
-        const folder = basename(row.path);
-        const root = isAbsolute(row.path)
-          ? resolve(row.path)
-          : resolve(this.cwd, row.path);
-        const md = resolve(join(root, "SKILL.md"));
-        const raw = await readFile(md, "utf-8");
-        const { name, description } = parseSkillFrontmatter(raw, folder);
-        entries.push({
-          name,
-          description,
-          path: md,
-        });
-      } catch {
-        continue;
-      }
-    }
-    return entries;
-  }
-
-  /**
-   * `skills add <source> -y -a openclaw --copy` — supports owner/repo, Git URLs with tree paths, local paths, etc.
-   */
-  async install(source: string): Promise<void> {
-    const raw = source.trim();
-    if (!raw) {
-      throw new Error(
-        "Enter a skill source (e.g. owner/repo or a GitHub URL).",
-      );
-    }
-    try {
-      await runNpxSkills(["add", raw, "-y", "-a", SKILLS_AGENT, "--copy"], {
-        cwd: this.cwd,
-        timeout: 600_000,
-      });
-    } catch (e) {
-      const err = e as { stderr?: string; stdout?: string; message?: string };
-      const detail = stripAnsi(
-        err.stderr || err.stdout || err.message || String(e),
-      );
-      throw new Error(`skills add failed:\n${detail}`);
-    }
-  }
-
-  /**
-   * Remove by on-disk folder name (basename of `path` from `skills list --json`).
-   *
-   * We do **not** pass `--agent` so removal matches the CLI’s universal layout behavior.
-   */
-  async delete(folder: string): Promise<void> {
-    const safe = folder.trim();
-    if (!safe || /[\\/]/.test(safe) || safe.includes("..")) {
-      throw new Error("Invalid skill name.");
-    }
-    try {
-      await runNpxSkills(["remove", safe, "-y"], { cwd: this.cwd });
-    } catch (e) {
-      const err = e as { stderr?: string; stdout?: string; message?: string };
-      const detail = stripAnsi(
-        err.stderr || err.stdout || err.message || String(e),
-      );
-      throw new Error(`skills remove failed:\n${detail}`);
-    }
-
-    await rm(join(this.cwd, "skills", safe), {
-      recursive: true,
-      force: true,
-    }).catch(() => {});
-  }
-
-  /**
-   * Search the public catalog at skills.sh (same API as the `skills` CLI `find` command).
-   */
-  async search(query: string): Promise<SkillSearchResult[]> {
-    const q = query.trim();
-    if (!q) {
-      throw new Error("Enter a search term for the skills catalog.");
-    }
-    if (q.length < 2) {
-      throw new Error("Use at least 2 characters to search.");
-    }
-    try {
-      const url = `${SKILLS_API_URL}/api/search?q=${encodeURIComponent(q)}&limit=10`;
-      const res = await fetch(url);
-      if (!res.ok) {
-        return [];
-      }
-      const data = (await res.json()) as {
-        skills: Array<{
-          skillId: string;
-          name: string;
-          installs: number;
-          source: string;
-        }>;
-      };
-
-      if (!Array.isArray(data.skills)) {
-        throw new Error("Skills search did not return .skills[] in response");
-      }
-
-      return data.skills
-        .map((skill) => ({
-          name: skill.name,
-          slug: `${skill.source.trim()}@${skill.skillId.trim()}`,
-          source: skill.source || "",
-          installs: skill.installs,
-        }))
-        .sort((a, b) => (b.installs || 0) - (a.installs || 0));
-    } catch {
-      return [];
-    }
-  }
-}
-
-export function create(cwd: string) {
-  return new Registry(cwd);
-}

package/src/core/skills/tools.ts

@@ -1,80 +0,0 @@
-import { tool } from "@strands-agents/sdk";
-import type { JSONValue } from "@strands-agents/sdk";
-import { z } from "zod";
-import type { Registry } from "./registry.ts";
-
-function toJsonValue(value: unknown): JSONValue {
-  return JSON.parse(JSON.stringify(value)) as JSONValue;
-}
-
-export function create(registry: Registry) {
-  return [
-    tool({
-      name: "list_skills",
-      description:
-        "List currently installed skills available to the local agent.",
-      inputSchema: z.object({}),
-      callback: async () => {
-        const skills = await registry.list();
-        return toJsonValue({
-          count: skills.length,
-          skills,
-        });
-      },
-    }),
-    tool({
-      name: "search_skills",
-      description:
-        "Search the public skills catalog for skills matching a query.",
-      inputSchema: z.object({
-        query: z
-          .string()
-          .min(2)
-          .describe("Search query for the public skills catalog."),
-      }),
-      callback: async (input) => {
-        const results = await registry.search(input.query);
-        return toJsonValue({
-          count: results.length,
-          results,
-        });
-      },
-    }),
-    tool({
-      name: "install_skill",
-      description:
-        "Install a skill from a source such as owner/repo, a GitHub URL, or a local path.",
-      inputSchema: z.object({
-        source: z
-          .string()
-          .min(1)
-          .describe("Skill source to install (repo, URL, or local path)."),
-      }),
-      callback: async (input) => {
-        await registry.install(input.source);
-        return toJsonValue({
-          installed: true,
-          source: input.source,
-        });
-      },
-    }),
-    tool({
-      name: "delete_skill",
-      description:
-        "Delete an installed skill by its folder name under the local skills directory.",
-      inputSchema: z.object({
-        folder: z
-          .string()
-          .min(1)
-          .describe("Installed skill folder name to remove."),
-      }),
-      callback: async (input) => {
-        await registry.delete(input.folder);
-        return toJsonValue({
-          deleted: true,
-          folder: input.folder,
-        });
-      },
-    }),
-  ];
-}