npm - hoomanjs - Versions diffs - 1.0.0 - Mend

hoomanjs 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (96) hide show

package/.github/screenshot.png +0 -0
package/.github/workflows/build-publish.yml +49 -0
package/LICENSE +21 -0
package/README.md +399 -0
package/docker-compose.yml +13 -0
package/package.json +78 -0
package/src/acp/acp-agent.ts +803 -0
package/src/acp/approvals.ts +147 -0
package/src/acp/index.ts +1 -0
package/src/acp/meta/system-prompt.ts +44 -0
package/src/acp/meta/user-id.ts +44 -0
package/src/acp/prompt-invoke.ts +149 -0
package/src/acp/sessions/config-options.ts +56 -0
package/src/acp/sessions/replay.ts +131 -0
package/src/acp/sessions/store.ts +158 -0
package/src/acp/sessions/title.ts +22 -0
package/src/acp/utils/paths.ts +5 -0
package/src/acp/utils/tool-kind.ts +38 -0
package/src/acp/utils/tool-locations.ts +46 -0
package/src/acp/utils/tool-result-content.ts +27 -0
package/src/chat/app.tsx +428 -0
package/src/chat/approvals.ts +96 -0
package/src/chat/components/ApprovalPrompt.tsx +25 -0
package/src/chat/components/ChatMessage.tsx +47 -0
package/src/chat/components/Composer.tsx +39 -0
package/src/chat/components/EmptyChatBanner.tsx +26 -0
package/src/chat/components/ReasoningStrip.tsx +30 -0
package/src/chat/components/Spinner.tsx +34 -0
package/src/chat/components/StatusBar.tsx +65 -0
package/src/chat/components/ThinkingStatus.tsx +128 -0
package/src/chat/components/ToolEvent.tsx +34 -0
package/src/chat/components/Transcript.tsx +34 -0
package/src/chat/components/ascii-logo.ts +11 -0
package/src/chat/components/shared.ts +70 -0
package/src/chat/index.tsx +42 -0
package/src/chat/types.ts +21 -0
package/src/cli.ts +146 -0
package/src/configure/app.tsx +911 -0
package/src/configure/components/BusyScreen.tsx +22 -0
package/src/configure/components/HomeScreen.tsx +43 -0
package/src/configure/components/MenuScreen.tsx +44 -0
package/src/configure/components/PromptForm.tsx +40 -0
package/src/configure/components/SelectMenuItem.tsx +30 -0
package/src/configure/index.tsx +43 -0
package/src/configure/open-in-editor.ts +133 -0
package/src/configure/types.ts +45 -0
package/src/configure/utils.ts +113 -0
package/src/core/agent/index.ts +76 -0
package/src/core/config.ts +157 -0
package/src/core/index.ts +54 -0
package/src/core/mcp/config.ts +80 -0
package/src/core/mcp/index.ts +13 -0
package/src/core/mcp/manager.ts +109 -0
package/src/core/mcp/prefixed-mcp-tool.ts +45 -0
package/src/core/mcp/tools.ts +92 -0
package/src/core/mcp/types.ts +37 -0
package/src/core/memory/index.ts +17 -0
package/src/core/memory/ltm/embed.ts +67 -0
package/src/core/memory/ltm/index.ts +18 -0
package/src/core/memory/ltm/store.ts +376 -0
package/src/core/memory/ltm/tools.ts +146 -0
package/src/core/memory/ltm/types.ts +111 -0
package/src/core/memory/ltm/utils.ts +218 -0
package/src/core/memory/stm/index.ts +17 -0
package/src/core/models/anthropic.ts +53 -0
package/src/core/models/bedrock.ts +54 -0
package/src/core/models/google.ts +51 -0
package/src/core/models/index.ts +16 -0
package/src/core/models/ollama/index.ts +13 -0
package/src/core/models/ollama/strands-ollama.ts +439 -0
package/src/core/models/openai.ts +12 -0
package/src/core/prompts/index.ts +23 -0
package/src/core/prompts/skills.ts +66 -0
package/src/core/prompts/static/fetch.md +33 -0
package/src/core/prompts/static/filesystem.md +38 -0
package/src/core/prompts/static/identity.md +22 -0
package/src/core/prompts/static/ltm.md +39 -0
package/src/core/prompts/static/memory.md +39 -0
package/src/core/prompts/static/shell.md +34 -0
package/src/core/prompts/static/skills.md +19 -0
package/src/core/prompts/static/thinking.md +27 -0
package/src/core/prompts/system.ts +109 -0
package/src/core/skills/index.ts +2 -0
package/src/core/skills/registry.ts +239 -0
package/src/core/skills/tools.ts +80 -0
package/src/core/toolkit.ts +13 -0
package/src/core/tools/fetch.ts +288 -0
package/src/core/tools/filesystem.ts +747 -0
package/src/core/tools/index.ts +5 -0
package/src/core/tools/shell.ts +426 -0
package/src/core/tools/thinking.ts +184 -0
package/src/core/tools/time.ts +121 -0
package/src/core/utils/cwd-context.ts +11 -0
package/src/core/utils/paths.ts +28 -0
package/src/exec/approvals.ts +85 -0
package/tsconfig.json +30 -0

package/src/core/tools/fetch.ts ADDED Viewed

@@ -0,0 +1,288 @@
+import dns from "node:dns/promises";
+import net from "node:net";
+import { Readability } from "@mozilla/readability";
+import { JSDOM } from "jsdom";
+import { tool } from "@strands-agents/sdk";
+import type { JSONValue, ToolContext } from "@strands-agents/sdk";
+import TurndownService from "turndown";
+import { z } from "zod";
+async function createUserAgent(): Promise<string> {
+  const path = new URL("../../../package.json", import.meta.url);
+  const pkg = (await Bun.file(path).json()) as {
+    name?: string;
+    version?: string;
+  };
+  return `${pkg.name ?? "hoomanjs"}/${pkg.version ?? "0.0.0"}`;
+}
+const DEFAULT_TIMEOUT_SECONDS = 30;
+const DEFAULT_MAX_LENGTH = 5000;
+const MAX_FETCH_LENGTH = 1_000_000;
+const turndown = new TurndownService({
+  headingStyle: "atx",
+  bulletListMarker: "-",
+  codeBlockStyle: "fenced",
+});
+function toJsonValue(value: unknown): JSONValue {
+  return JSON.parse(JSON.stringify(value)) as JSONValue;
+}
+function isHttpUrl(value: string): URL {
+  const url = new URL(value);
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new Error("Only http:// and https:// URLs are supported.");
+  }
+  return url;
+}
+function isPrivateHostname(hostname: string): boolean {
+  const normalized = hostname.toLowerCase();
+  return (
+    normalized === "localhost" ||
+    normalized === "127.0.0.1" ||
+    normalized === "::1" ||
+    normalized.endsWith(".localhost")
+  );
+}
+function isPrivateIp(address: string): boolean {
+  const version = net.isIP(address);
+  if (version === 4) {
+    const parts = address.split(".").map((part) => Number(part));
+    const a = parts[0] ?? -1;
+    const b = parts[1] ?? -1;
+    return (
+      a === 10 ||
+      a === 127 ||
+      (a === 172 && b >= 16 && b <= 31) ||
+      (a === 192 && b === 168) ||
+      (a === 169 && b === 254)
+    );
+  }
+  if (version === 6) {
+    const normalized = address.toLowerCase();
+    return (
+      normalized === "::1" ||
+      normalized.startsWith("fc") ||
+      normalized.startsWith("fd") ||
+      normalized.startsWith("fe80:")
+    );
+  }
+  return false;
+}
+async function assertRemoteUrl(url: URL): Promise<void> {
+  if (isPrivateHostname(url.hostname)) {
+    throw new Error("Fetching localhost or loopback URLs is not allowed.");
+  }
+  const resolved = await dns.lookup(url.hostname, { all: true });
+  if (resolved.some((entry) => isPrivateIp(entry.address))) {
+    throw new Error("Fetching private-network URLs is not allowed.");
+  }
+}
+function responseHeaders(headers: Headers): Record<string, string> {
+  const out: Record<string, string> = {};
+  headers.forEach((value, key) => {
+    out[key] = value;
+  });
+  return out;
+}
+function isHtml(contentType: string, body: string): boolean {
+  const normalized = contentType.toLowerCase();
+  return (
+    normalized.includes("text/html") ||
+    normalized.includes("application/xhtml+xml") ||
+    /^\s*<!doctype html/i.test(body) ||
+    /^\s*<html[\s>]/i.test(body)
+  );
+}
+function tryFormatJson(body: string): string {
+  try {
+    return JSON.stringify(JSON.parse(body), null, 2);
+  } catch {
+    return body;
+  }
+}
+function htmlToMarkdown(
+  html: string,
+  baseUrl: string,
+): { markdown: string; title?: string | null } {
+  const dom = new JSDOM(html, { url: baseUrl });
+  const reader = new Readability(dom.window.document);
+  const article = reader.parse();
+  const source = article?.content ?? dom.window.document.body?.innerHTML ?? "";
+  const markdown = turndown.turndown(source).trim();
+  return {
+    markdown: markdown || "Page could not be simplified to markdown.",
+    title: article?.title ?? dom.window.document.title ?? null,
+  };
+}
+function sliceContent(
+  content: string,
+  startIndex: number,
+  maxLength: number,
+): { content: string; truncated: boolean; nextStartIndex: number | null } {
+  if (startIndex >= content.length) {
+    return {
+      content: "No more content available.",
+      truncated: false,
+      nextStartIndex: null,
+    };
+  }
+  const slice = content.slice(startIndex, startIndex + maxLength);
+  const nextStartIndex =
+    startIndex + slice.length < content.length
+      ? startIndex + slice.length
+      : null;
+  return {
+    content: slice,
+    truncated: nextStartIndex !== null,
+    nextStartIndex,
+  };
+}
+function createFetchInputSchema() {
+  return z.object({
+    url: z.string().url().describe("Remote HTTP(S) URL to fetch."),
+    max_length: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(MAX_FETCH_LENGTH)
+      .optional()
+      .describe("Maximum number of characters to return."),
+    start_index: z.coerce
+      .number()
+      .int()
+      .min(0)
+      .optional()
+      .describe("Start returning content from this character index."),
+    raw: z
+      .boolean()
+      .optional()
+      .describe(
+        "Return raw response text instead of simplifying HTML to markdown.",
+      ),
+    timeout: z.coerce
+      .number()
+      .positive()
+      .optional()
+      .describe("Request timeout in seconds."),
+    headers: z
+      .record(z.string(), z.string())
+      .optional()
+      .describe("Optional extra HTTP headers."),
+  });
+}
+export function createFetchTools() {
+  const inputSchema = createFetchInputSchema();
+  return [
+    tool({
+      name: "fetch",
+      description:
+        "Fetch a remote URL and return response content. HTML pages are simplified to markdown by default to save context window and tokens.",
+      inputSchema,
+      callback: async (input, context?: ToolContext) => {
+        const timeoutSeconds = input.timeout ?? DEFAULT_TIMEOUT_SECONDS;
+        const timeoutSignal = AbortSignal.timeout(timeoutSeconds * 1000);
+        const signal = context
+          ? AbortSignal.any([timeoutSignal, context.agent.cancelSignal])
+          : timeoutSignal;
+        const url = isHttpUrl(input.url);
+        await assertRemoteUrl(url);
+        const headers = new Headers(input.headers);
+        if (!headers.has("user-agent")) {
+          headers.set("user-agent", await createUserAgent());
+        }
+        if (!headers.has("accept")) {
+          headers.set(
+            "accept",
+            "text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.5",
+          );
+        }
+        try {
+          const response = await fetch(url, {
+            method: "GET",
+            headers,
+            redirect: "follow",
+            signal,
+          });
+          const text = await response.text();
+          const contentType = response.headers.get("content-type") ?? "";
+          if (!response.ok) {
+            throw new Error(
+              `HTTP ${response.status} ${response.statusText}: GET ${url.toString()}`,
+            );
+          }
+          let transformed = text;
+          let transformedFormat: "raw" | "markdown" | "json-pretty" = "raw";
+          let title: string | null | undefined;
+          if (!input.raw && isHtml(contentType, text)) {
+            const result = htmlToMarkdown(text, url.toString());
+            transformed = result.markdown;
+            transformedFormat = "markdown";
+            title = result.title;
+          } else if (contentType.toLowerCase().includes("json")) {
+            transformed = tryFormatJson(text);
+            transformedFormat = "json-pretty";
+          }
+          const paged = sliceContent(
+            transformed,
+            input.start_index ?? 0,
+            input.max_length ?? DEFAULT_MAX_LENGTH,
+          );
+          return toJsonValue({
+            url: url.toString(),
+            status: response.status,
+            statusText: response.statusText,
+            headers: responseHeaders(response.headers),
+            content_type: contentType || null,
+            format: transformedFormat,
+            title: title ?? null,
+            start_index: input.start_index ?? 0,
+            max_length: input.max_length ?? DEFAULT_MAX_LENGTH,
+            total_length: transformed.length,
+            truncated: paged.truncated,
+            next_start_index: paged.nextStartIndex,
+            content: paged.content,
+          });
+        } catch (error) {
+          if (error instanceof Error && error.name === "AbortError") {
+            const reason = timeoutSignal.aborted
+              ? `Request timed out after ${timeoutSeconds} seconds`
+              : "Request was cancelled";
+            throw new Error(`${reason}: ${url.toString()}`);
+          }
+          throw error;
+        }
+      },
+    }),
+  ];
+}