aec-agent 1.0.0

package/dist/components/tool-hub/built-in-tools/skills/skill-manage-tool.js

@@ -0,0 +1,226 @@
+import { SkillError } from "../../../../kernel/errors/skill-error.js";
+import { normalizeSkillPath } from "../../../skill-hub/skill-format.js";
+import { copySkillToWorkspace, removeSkillFromWorkspace } from "./skill-workspace.js";
+const ACTIONS = ["create", "rewrite", "patch", "write_file", "remove_file", "delete"];
+/**
+ * skill_manage — lets an agent create and maintain skills in the shared skill library
+ * (used by the built-in skill-creator skill). A created skill is enabled for the agent
+ * right away; other agents can enable it too. Only custom skills can be changed, and an
+ * agent can only change skills that are enabled for it.
+ *
+ * Risk "consequential": a skill changes how agents behave from then on, so every call
+ * waits for the user's approval, which shows the full content being saved.
+ *
+ * After each change the skill's `.skills/<name>/` folder in an isolated workspace is
+ * brought in line with the library (rewritten, or removed on delete), so the agent never
+ * works from a stale copy. A failed sync is reported but does not fail the call — the
+ * skill is saved either way.
+ */
+export class SkillManageTool {
+    name = "tool:skill-manage";
+    version = "1.0.0";
+    definition = {
+        name: "skill_manage",
+        description: "Create, change or delete a skill (a SKILL.md with YAML frontmatter `name` + `description`, then instructions; " +
+            "optional extra files such as scripts/ and references/). Follow the skill-creator skill when you have it. " +
+            "Actions: create (content, files?) · rewrite (name, content, files? — replaces SKILL.md, and all files when given) · " +
+            "patch (name, old_string, new_string, path? — exact replacement in SKILL.md or a file) · write_file (name, path, content) · " +
+            "remove_file (name, path) · delete (name). Each call asks the user for approval.",
+        parameters: {
+            type: "object",
+            properties: {
+                action: { type: "string", enum: [...ACTIONS], description: "What to do" },
+                name: { type: "string", description: "The skill to change (every action except create)" },
+                content: { type: "string", description: "create/rewrite: the full SKILL.md text; write_file: the file content" },
+                files: {
+                    type: "array",
+                    description: "create/rewrite: extra files of the skill",
+                    items: {
+                        type: "object",
+                        properties: {
+                            path: { type: "string", description: 'Relative path, e.g. "scripts/run.py" or "references/guide.md"' },
+                            content: { type: "string", description: "File content (text)" },
+                        },
+                        required: ["path", "content"],
+                    },
+                },
+                path: { type: "string", description: "patch/write_file/remove_file: a file in the skill (patch defaults to SKILL.md)" },
+                old_string: { type: "string", description: "patch: exact text to replace — must occur exactly once" },
+                new_string: { type: "string", description: "patch: the replacement text" },
+            },
+            required: ["action"],
+        },
+        risk: "consequential",
+    };
+    async execute(args, context) {
+        const skills = context.skills;
+        if (!skills)
+            return fail("skill_manage: skills are not available here");
+        const action = str(args, "action");
+        if (!action || !ACTIONS.includes(action))
+            return fail(`skill_manage: "action" must be one of ${ACTIONS.join(", ")}`);
+        try {
+            if (action === "create") {
+                const content = str(args, "content");
+                if (!content)
+                    return fail('skill_manage create: "content" (the full SKILL.md) is required');
+                const files = filesArg(args);
+                if (typeof files === "string")
+                    return fail(files);
+                const skill = await skills.create({ content, files: files ?? [] });
+                const requested = str(args, "name");
+                const note = requested && requested !== skill.name ? ` (named from the frontmatter, not "${requested}")` : "";
+                const synced = await copySkillToWorkspace(skill, context, { replace: true });
+                return ok(`Created skill "${skill.name}"${note} with ${countFiles(skill)}. It is enabled for you and appears in your skill index ` +
+                    "from your next turn. Other agents can enable it on their Capabilities page." +
+                    workspaceNote(synced, "written to"), skill, synced);
+            }
+            const name = str(args, "name");
+            if (!name)
+                return fail(`skill_manage ${action}: "name" is required`);
+            const existing = await skills.get(name);
+            if (!existing)
+                return fail(`skill_manage ${action}: you have no skill named "${name}"`);
+            if (existing.source !== "custom") {
+                return fail(`skill_manage ${action} failed (read_only): "${name}" is a ${existing.source} skill and cannot be changed — ` +
+                    "create a new skill with a different name instead");
+            }
+            if (action === "delete") {
+                await skills.delete(name);
+                const removed = await removeSkillFromWorkspace(name, context);
+                return {
+                    content: `Deleted skill "${name}".` + workspaceNote(removed, "removed from"),
+                    metadata: { skill: name, action, ...workspaceMetadata(removed) },
+                };
+            }
+            let content = existing.content;
+            let files = existing.files;
+            let summary;
+            switch (action) {
+                case "rewrite": {
+                    const next = str(args, "content");
+                    if (!next)
+                        return fail('skill_manage rewrite: "content" (the full new SKILL.md) is required');
+                    const nextFiles = filesArg(args);
+                    if (typeof nextFiles === "string")
+                        return fail(nextFiles);
+                    content = next;
+                    if (nextFiles)
+                        files = nextFiles;
+                    summary = `Rewrote skill "${name}"${nextFiles ? " and replaced its files" : ""}`;
+                    break;
+                }
+                case "patch": {
+                    const oldString = str(args, "old_string");
+                    const newString = typeof args["new_string"] === "string" ? args["new_string"] : undefined;
+                    if (!oldString || newString === undefined)
+                        return fail('skill_manage patch: "old_string" and "new_string" are required');
+                    const rawPath = str(args, "path");
+                    const path = rawPath ? normalizeSkillPath(rawPath) : "SKILL.md";
+                    if (!path)
+                        return fail(`skill_manage patch: invalid path "${rawPath}"`);
+                    if (path.toLowerCase() === "skill.md") {
+                        const patched = replaceOnce(content, oldString, newString);
+                        if (typeof patched !== "string")
+                            return fail(`skill_manage patch: ${patched.error} in SKILL.md`);
+                        content = patched;
+                    }
+                    else {
+                        const file = files.find((f) => f.path === path);
+                        if (!file)
+                            return fail(`skill_manage patch: skill "${name}" has no file "${path}"`);
+                        const patched = replaceOnce(file.content, oldString, newString);
+                        if (typeof patched !== "string")
+                            return fail(`skill_manage patch: ${patched.error} in ${path}`);
+                        files = files.map((f) => (f.path === path ? { path, content: patched } : f));
+                    }
+                    summary = `Patched ${path} of skill "${name}"`;
+                    break;
+                }
+                case "write_file": {
+                    const rawPath = str(args, "path");
+                    const path = rawPath ? normalizeSkillPath(rawPath) : null;
+                    const fileContent = typeof args["content"] === "string" ? args["content"] : undefined;
+                    if (!path || fileContent === undefined)
+                        return fail('skill_manage write_file: a relative "path" and "content" are required');
+                    const exists = files.some((f) => f.path === path);
+                    files = exists ? files.map((f) => (f.path === path ? { path, content: fileContent } : f)) : [...files, { path, content: fileContent }];
+                    summary = `${exists ? "Replaced" : "Added"} ${path} in skill "${name}"`;
+                    break;
+                }
+                case "remove_file": {
+                    const rawPath = str(args, "path");
+                    const path = rawPath ? normalizeSkillPath(rawPath) : null;
+                    if (!path || !files.some((f) => f.path === path))
+                        return fail(`skill_manage remove_file: skill "${name}" has no file "${rawPath ?? ""}"`);
+                    files = files.filter((f) => f.path !== path);
+                    summary = `Removed ${path} from skill "${name}"`;
+                    break;
+                }
+            }
+            const updated = await skills.update(name, { content, files });
+            const synced = await copySkillToWorkspace(updated, context, { replace: true });
+            return ok(`${summary} (version ${updated.version}, ${countFiles(updated)}).` + workspaceNote(synced, "updated in"), updated, synced);
+        }
+        catch (error) {
+            if (error instanceof SkillError) {
+                // Validation and permission failures are deterministic — the model must change the input.
+                return { content: `skill_manage ${action} failed (${error.code}): ${error.message}`, isError: true, retryable: false, metadata: { code: error.code } };
+            }
+            return { content: `skill_manage ${action} failed: ${error instanceof Error ? error.message : String(error)}`, isError: true };
+        }
+    }
+}
+function replaceOnce(text, oldString, newString) {
+    const first = text.indexOf(oldString);
+    if (first === -1)
+        return { error: "old_string was not found" };
+    if (text.indexOf(oldString, first + oldString.length) !== -1)
+        return { error: "old_string occurs more than once — include more surrounding text" };
+    return text.slice(0, first) + newString + text.slice(first + oldString.length);
+}
+/** The `files` argument, undefined when absent, or an error message. */
+function filesArg(args) {
+    const raw = args["files"];
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (!Array.isArray(raw))
+        return 'skill_manage: "files" must be a list of { "path", "content" }';
+    const files = [];
+    for (const item of raw) {
+        const path = item && typeof item === "object" ? item["path"] : undefined;
+        const content = item && typeof item === "object" ? item["content"] : undefined;
+        if (typeof path !== "string" || typeof content !== "string")
+            return 'skill_manage: every entry of "files" needs a string "path" and "content"';
+        files.push({ path, content });
+    }
+    return files;
+}
+function str(args, key) {
+    const value = args[key];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function countFiles(skill) {
+    const n = skill.files.length;
+    return n === 0 ? "no extra files" : `${n} extra file${n === 1 ? "" : "s"}`;
+}
+/** One sentence on the workspace copy, or "" when there is no sandbox. */
+function workspaceNote(result, verb) {
+    if (!result)
+        return "";
+    if ("dir" in result)
+        return ` Its folder was ${verb} your workspace at ${result.dir}/.`;
+    return ` The saved skill is fine, but your workspace copy could not be synced (${result.error}).`;
+}
+function workspaceMetadata(result) {
+    if (!result)
+        return {};
+    return "dir" in result ? { workspaceDir: result.dir } : { workspaceError: result.error };
+}
+function ok(content, skill, workspace = null) {
+    return { content, metadata: { skill: skill.name, version: skill.version, files: skill.files.map((f) => f.path), ...workspaceMetadata(workspace) } };
+}
+function fail(content) {
+    return { content, isError: true, retryable: false };
+}
+//# sourceMappingURL=skill-manage-tool.js.map

package/dist/components/tool-hub/built-in-tools/skills/skill-manage-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manage-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/skills/skill-manage-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/skills/skill-view-tool.d.ts

@@ -0,0 +1,18 @@
+import type { ToolContext, ToolDefinition, ToolHandler, ToolOutput } from "../../types.js";
+/**
+ * skill_view — loads a skill (progressive disclosure, level 2 and 3): the SKILL.md
+ * instructions plus the list of its files, or one file with `path`.
+ *
+ * Not registered in the ToolHub: the agent's SkillManager adds it to the model's tools
+ * whenever the agent has at least one usable skill, so enabling a skill is enough. When
+ * the skill has files and the agent's sandbox is isolated, they are copied to
+ * `.skills/<name>/` in the workspace (with its SKILL.md) so scripts can be run from there.
+ */
+export declare class SkillViewTool implements ToolHandler {
+    readonly name = "tool:skill-view";
+    readonly version = "1.0.0";
+    readonly definition: ToolDefinition;
+    execute(args: Record<string, unknown>, context: ToolContext): Promise<ToolOutput>;
+    private viewFile;
+}
+//# sourceMappingURL=skill-view-tool.d.ts.map

package/dist/components/tool-hub/built-in-tools/skills/skill-view-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-view-tool.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/skills/skill-view-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG3F;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAejC;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBtF;IAED,OAAO,CAAC,QAAQ;CAkBjB"}

package/dist/components/tool-hub/built-in-tools/skills/skill-view-tool.js

@@ -0,0 +1,86 @@
+import { normalizeSkillPath } from "../../../skill-hub/skill-format.js";
+import { copySkillToWorkspace } from "./skill-workspace.js";
+/**
+ * skill_view — loads a skill (progressive disclosure, level 2 and 3): the SKILL.md
+ * instructions plus the list of its files, or one file with `path`.
+ *
+ * Not registered in the ToolHub: the agent's SkillManager adds it to the model's tools
+ * whenever the agent has at least one usable skill, so enabling a skill is enough. When
+ * the skill has files and the agent's sandbox is isolated, they are copied to
+ * `.skills/<name>/` in the workspace (with its SKILL.md) so scripts can be run from there.
+ */
+export class SkillViewTool {
+    name = "tool:skill-view";
+    version = "1.0.0";
+    definition = {
+        name: "skill_view",
+        description: "Load one of your skills (listed under <available_skills> in your instructions). Returns the skill's " +
+            "instructions and its files — follow the instructions to do the task. Load a skill BEFORE starting a task it " +
+            "matches. Pass `path` to read one of the skill's files (e.g. references/format.md).",
+        parameters: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "The skill name, exactly as listed in <available_skills>" },
+                path: { type: "string", description: "Optional: a file inside the skill to read instead of its instructions" },
+            },
+            required: ["name"],
+        },
+        risk: "read-only",
+    };
+    async execute(args, context) {
+        const name = typeof args["name"] === "string" ? args["name"].trim() : "";
+        if (!name)
+            return fail('skill_view: "name" must be a non-empty string');
+        if (!context.skills)
+            return fail("skill_view: skills are not available here");
+        const skill = await context.skills.get(name);
+        if (!skill) {
+            const available = (await context.skills.list()).map((s) => s.name);
+            return fail(`skill_view: no skill named "${name}". ` +
+                (available.length ? `Your skills: ${available.join(", ")}.` : "You have no skills enabled."));
+        }
+        const rawPath = typeof args["path"] === "string" ? args["path"].trim() : "";
+        if (rawPath)
+            return this.viewFile(skill, rawPath);
+        const copied = skill.files.length ? await copySkillToWorkspace(skill, context) : null;
+        return {
+            content: renderSkill(skill, copied),
+            metadata: { skill: skill.name, source: skill.source, version: skill.version, files: skill.files.length, copiedTo: copied && "dir" in copied ? copied.dir : undefined },
+        };
+    }
+    viewFile(skill, rawPath) {
+        const path = normalizeSkillPath(rawPath);
+        if (path?.toLowerCase() === "skill.md") {
+            return { content: `<skill_file skill="${skill.name}" path="SKILL.md">\n${skill.content}\n</skill_file>` };
+        }
+        const file = path ? skill.files.find((f) => f.path === path) : undefined;
+        if (!file) {
+            const files = skill.files.map((f) => f.path);
+            return fail(`skill_view: skill "${skill.name}" has no file "${rawPath}". ` +
+                (files.length ? `Its files: ${files.join(", ")}.` : "It has no files besides SKILL.md."));
+        }
+        return {
+            content: `<skill_file skill="${skill.name}" path="${file.path}">\n${file.content}\n</skill_file>`,
+            metadata: { skill: skill.name, path: file.path },
+        };
+    }
+}
+function renderSkill(skill, copied) {
+    const lines = [`<skill_content name="${skill.name}">`, skill.body];
+    if (skill.files.length) {
+        lines.push("", "<skill_resources>", ...skill.files.map((f) => f.path), "</skill_resources>");
+        lines.push(`Read a file with skill_view(name="${skill.name}", path="<file>").`);
+        if (copied && "dir" in copied) {
+            lines.push(`The files are also in your workspace at ${copied.dir}/ — run scripts from there (e.g. python3 ${copied.dir}/scripts/<script>).`);
+        }
+        else if (copied && "error" in copied) {
+            lines.push(`The files could not be copied to your workspace (${copied.error}); read them with skill_view instead.`);
+        }
+    }
+    lines.push("</skill_content>");
+    return lines.join("\n");
+}
+function fail(content) {
+    return { content, isError: true, retryable: false };
+}
+//# sourceMappingURL=skill-view-tool.js.map

package/dist/components/tool-hub/built-in-tools/skills/skill-view-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-view-tool.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/skills/skill-view-tool.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/skills/skill-workspace.d.ts

@@ -0,0 +1,26 @@
+import type { Skill } from "../../../skill-hub/types/skill.js";
+import type { ToolContext } from "../../types.js";
+/** Where a skill's files are copied, relative to the agent's working directory. */
+export declare const SKILL_WORKSPACE_DIR = ".skills";
+/** Outcome of a workspace copy: where it went, why it failed, or null when there is no sandbox. */
+export type SkillWorkspaceResult = {
+    dir: string;
+} | {
+    error: string;
+} | null;
+/**
+ * Copy a skill (SKILL.md plus its files) to `.skills/<name>/` in the agent's workspace,
+ * skipping files already up to date.
+ * SKILL.md is written too, so the folder is the whole skill (scripts or instructions that
+ * refer to it, or a skill used as a starting point for a new one, find it on disk).
+ * With `replace`, the folder is removed first so files
+ * the skill no longer has do not linger (skill_manage after a change).
+ * Only in an isolated sandbox: on a host folder writes need the user's approval, which a
+ * skill load must not bypass.
+ */
+export declare function copySkillToWorkspace(skill: Skill, context: ToolContext, opts?: {
+    replace?: boolean;
+}): Promise<SkillWorkspaceResult>;
+/** Remove a deleted skill's `.skills/<name>/` folder from the agent's workspace. */
+export declare function removeSkillFromWorkspace(name: string, context: ToolContext): Promise<SkillWorkspaceResult>;
+//# sourceMappingURL=skill-workspace.d.ts.map

package/dist/components/tool-hub/built-in-tools/skills/skill-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-workspace.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/skills/skill-workspace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,mGAAmG;AACnG,MAAM,MAAM,oBAAoB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAE9E;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,WAAW,EACpB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAiB/B;AAED,oFAAoF;AACpF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAYhH"}

package/dist/components/tool-hub/built-in-tools/skills/skill-workspace.js

@@ -0,0 +1,93 @@
+import { createHash } from "node:crypto";
+import { SandboxError } from "../../../../kernel/errors/sandbox-error.js";
+/** Where a skill's files are copied, relative to the agent's working directory. */
+export const SKILL_WORKSPACE_DIR = ".skills";
+/**
+ * Copy a skill (SKILL.md plus its files) to `.skills/<name>/` in the agent's workspace,
+ * skipping files already up to date.
+ * SKILL.md is written too, so the folder is the whole skill (scripts or instructions that
+ * refer to it, or a skill used as a starting point for a new one, find it on disk).
+ * With `replace`, the folder is removed first so files
+ * the skill no longer has do not linger (skill_manage after a change).
+ * Only in an isolated sandbox: on a host folder writes need the user's approval, which a
+ * skill load must not bypass.
+ */
+export async function copySkillToWorkspace(skill, context, opts = {}) {
+    const env = await isolatedSandbox(context);
+    if (!env || "error" in env)
+        return env;
+    const dir = skillDir(skill.name);
+    const files = [{ path: "SKILL.md", content: skill.content }, ...skill.files];
+    try {
+        if (opts.replace)
+            await removeDir(env, dir);
+        for (const file of files) {
+            const target = `${dir}/${file.path}`;
+            if ((await currentSha256(env, target)) === sha256(file.content))
+                continue;
+            await env.writeFile(target, file.content);
+        }
+        return { dir };
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** Remove a deleted skill's `.skills/<name>/` folder from the agent's workspace. */
+export async function removeSkillFromWorkspace(name, context) {
+    const env = await isolatedSandbox(context);
+    if (!env || "error" in env)
+        return env;
+    const dir = skillDir(name);
+    try {
+        if (!(await env.stat(dir)))
+            return { dir };
+        await removeDir(env, dir);
+        return { dir };
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+function skillDir(name) {
+    return `${SKILL_WORKSPACE_DIR}/${name}`;
+}
+async function isolatedSandbox(context) {
+    if (!context.getSandbox)
+        return null;
+    let env;
+    try {
+        env = await context.getSandbox();
+    }
+    catch {
+        return null; // no sandbox for this agent — skill_view(path) still works
+    }
+    if (!env.traits.isolated)
+        return { error: "the workspace is a host folder, so files are not copied automatically" };
+    return env;
+}
+/**
+ * SandboxView has no delete, so the folder is removed with `rm -rf` (argv, no shell).
+ * Without exec the old files stay; the caller still writes the current ones over them.
+ */
+async function removeDir(env, dir) {
+    if (!env.capabilities.has("exec") || env.traits.os === "windows")
+        return;
+    const result = await env.exec({ command: ["rm", "-rf", "--", dir], timeoutMs: 10_000, maxOutputBytes: 4_096 });
+    if (result.exitCode !== 0)
+        throw new Error(`could not remove ${dir}: ${result.stderr.trim() || `exit ${result.exitCode}`}`);
+}
+async function currentSha256(env, path) {
+    try {
+        return (await env.readFile(path, { maxBytes: 1 })).sha256;
+    }
+    catch (error) {
+        if (error instanceof SandboxError && error.code === "not_found")
+            return null;
+        throw error;
+    }
+}
+function sha256(text) {
+    return createHash("sha256").update(text, "utf8").digest("hex");
+}
+//# sourceMappingURL=skill-workspace.js.map

package/dist/components/tool-hub/built-in-tools/skills/skill-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-workspace.js","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/skills/skill-workspace.ts"],"names":[],"mappings":"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"}

package/dist/components/tool-hub/built-in-tools/web/duckduckgo-search-provider.d.ts

@@ -0,0 +1,28 @@
+import type { FetchFn, WebSearchProvider, WebSearchQuery, WebSearchResult } from "./types.js";
+export interface DuckDuckGoSearchProviderOptions {
+    /** Defaults to https://html.duckduckgo.com/html/ */
+    endpoint?: string;
+    /** Request timeout. Default 10s. */
+    timeoutMs?: number;
+    /** Default region (DuckDuckGo `kl`, e.g. "us-en"). */
+    region?: string;
+    userAgent?: string;
+    fetch?: FetchFn;
+}
+export declare class DuckDuckGoSearchProvider implements WebSearchProvider {
+    readonly name = "duckduckgo";
+    private endpoint;
+    private timeoutMs;
+    private region?;
+    private userAgent;
+    private fetchFn;
+    constructor(options?: DuckDuckGoSearchProviderOptions);
+    search(query: WebSearchQuery): Promise<WebSearchResult[]>;
+}
+/**
+ * Parse the result list from html.duckduckgo.com markup. Each organic result has an
+ * `<a class="result__a" href="//duckduckgo.com/l/?uddg=<target>">title</a>` and an optional
+ * `class="result__snippet"` element after it. Ads (`/y.js?` links) are skipped.
+ */
+export declare function parseDuckDuckGoHtml(html: string, maxResults: number): WebSearchResult[];
+//# sourceMappingURL=duckduckgo-search-provider.d.ts.map

package/dist/components/tool-hub/built-in-tools/web/duckduckgo-search-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckduckgo-search-provider.d.ts","sourceRoot":"","sources":["../../../../../src/components/tool-hub/built-in-tools/web/duckduckgo-search-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAS9F,MAAM,WAAW,+BAA+B;IAC9C,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAQD,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAU;IAEzB,YAAY,OAAO,GAAE,+BAAoC,EAMxD;IAEK,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA6B9D;CACF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,CA2BvF"}