daemora 1.0.0-alpha.0

package/dist/tools/core/useCrew.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCrew.d.ts","sourceRoot":"","sources":["../../../src/tools/core/useCrew.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,UAAU,kBAAkB;IAC1B,yGAAyG;IACzG,aAAa,IAAI,MAAM,CAAC;CACzB;AAED,QAAA,MAAM,WAAW;;;;;;;;;;;;EAIf,CAAC;AAEH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,WAAW,EAAE;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAiCD"}

package/dist/tools/core/useCrew.js

@@ -0,0 +1,48 @@
+/**
+ * use_crew — delegate a task to a named specialist sub-agent.
+ *
+ * Blocks until the crew finishes, then returns the crew's final answer
+ * plus basic telemetry. Errors from the crew propagate as tool errors
+ * so the main agent can decide whether to retry or fail forward.
+ */
+import { z } from "zod";
+import { NotFoundError } from "../../util/errors.js";
+const inputSchema = z.object({
+    crew: z.string().min(1).describe("Crew id. Use the list shown in the system prompt."),
+    task: z.string().min(1).max(20_000).describe("Full task description — the crew has no prior context from this conversation."),
+    maxSteps: z.number().int().min(1).max(30).optional().describe("Step budget for the crew run. Default 15, max 30. Omit unless the task genuinely needs more — most jobs finish in well under 15."),
+});
+export function makeUseCrewTool(registry, runner, turn) {
+    return {
+        name: "use_crew",
+        description: "Delegate a task to a specialist crew. Returns the crew's finished answer. Give a full task description — the crew has no memory of this chat.",
+        category: "agent",
+        source: { kind: "core" },
+        alwaysOn: true,
+        inputSchema,
+        async execute({ crew, task, maxSteps }, { taskId, abortSignal }) {
+            if (!registry.has(crew)) {
+                throw new NotFoundError(`Unknown crew: ${crew}`, {
+                    knownCrews: registry.list().map((c) => c.manifest.id),
+                });
+            }
+            const result = await runner.run({
+                crewId: crew,
+                task,
+                parentTaskId: taskId,
+                parentModelId: turn.resolvedModel(),
+                ...(maxSteps ? { maxSteps } : {}),
+                abortSignal,
+            });
+            return {
+                crewId: result.crewId,
+                text: result.text,
+                toolCalls: result.toolCalls,
+                steps: result.steps,
+                inputTokens: result.inputTokens,
+                outputTokens: result.outputTokens,
+            };
+        },
+    };
+}
+//# sourceMappingURL=useCrew.js.map

package/dist/tools/core/useCrew.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCrew.js","sourceRoot":"","sources":["../../../src/tools/core/useCrew.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAQrD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACrF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,+EAA+E,CAAC;IAC7H,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kIAAkI,CAAC;CAClM,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAC7B,QAAsB,EACtB,MAAuB,EACvB,IAAwB;IASxB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,+IAA+I;QACjJ,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YAC7D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,aAAa,CAAC,iBAAiB,IAAI,EAAE,EAAE;oBAC/C,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;iBACtD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;gBAC9B,MAAM,EAAE,IAAI;gBACZ,IAAI;gBACJ,YAAY,EAAE,MAAM;gBACpB,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE;gBACnC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,WAAW;aACZ,CAAC,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/core/useMCP.d.ts

@@ -0,0 +1,40 @@
+/**
+ * use_mcp — call a specific tool on a connected MCP server.
+ *
+ * `tool` is required. The system prompt lists every connected server's
+ * tool names (`server: N tools (tool_a, tool_b, …)`) so the model has
+ * the catalog up-front — there's no reason for a two-round-trip
+ * "discover then invoke" dance. If the agent doesn't know which tool
+ * to use, it should re-read the system prompt; the previous version's
+ * auto-discovery return was burning one LLM step per delegation.
+ *
+ * The `task` field is kept for audit logging (shows up in the task
+ * record's toolCalls.args) — it's not passed to the MCP server itself;
+ * the server receives `args` only.
+ */
+import { z } from "zod";
+import type { MCPManager } from "../../mcp/MCPManager.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    server: z.ZodString;
+    tool: z.ZodString;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    task: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    tool: string;
+    server: string;
+    args?: Record<string, unknown> | undefined;
+    task?: string | undefined;
+}, {
+    tool: string;
+    server: string;
+    args?: Record<string, unknown> | undefined;
+    task?: string | undefined;
+}>;
+export declare function makeUseMCPTool(mcp: MCPManager): ToolDef<typeof inputSchema, {
+    server: string;
+    tool: string;
+    result: unknown;
+}>;
+export {};
+//# sourceMappingURL=useMCP.d.ts.map

package/dist/tools/core/useMCP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMCP.d.ts","sourceRoot":"","sources":["../../../src/tools/core/useMCP.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAKf,CAAC;AAEH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAmD9H"}

package/dist/tools/core/useMCP.js

@@ -0,0 +1,64 @@
+/**
+ * use_mcp — call a specific tool on a connected MCP server.
+ *
+ * `tool` is required. The system prompt lists every connected server's
+ * tool names (`server: N tools (tool_a, tool_b, …)`) so the model has
+ * the catalog up-front — there's no reason for a two-round-trip
+ * "discover then invoke" dance. If the agent doesn't know which tool
+ * to use, it should re-read the system prompt; the previous version's
+ * auto-discovery return was burning one LLM step per delegation.
+ *
+ * The `task` field is kept for audit logging (shows up in the task
+ * record's toolCalls.args) — it's not passed to the MCP server itself;
+ * the server receives `args` only.
+ */
+import { z } from "zod";
+import { NotFoundError, ValidationError } from "../../util/errors.js";
+const inputSchema = z.object({
+    server: z.string().min(1).describe("Connected MCP server name. See `## Connected MCP Servers` in the system prompt."),
+    tool: z.string().min(1).describe("Exact tool name on that server. The system prompt lists each server's tools."),
+    args: z.record(z.unknown()).optional().describe("Arguments for the tool. Shape is defined by the tool's inputSchema."),
+    task: z.string().optional().describe("Optional human-readable description of intent — recorded for audit only, not passed to the server."),
+});
+export function makeUseMCPTool(mcp) {
+    return {
+        name: "use_mcp",
+        description: "Call a tool on a connected MCP server. `server` + `tool` are required — the system prompt lists every connected server with its tool names.",
+        category: "agent",
+        source: { kind: "core" },
+        alwaysOn: true,
+        tags: ["mcp", "integration"],
+        inputSchema,
+        async execute({ server, tool, args }) {
+            const status = mcp.listStatus();
+            const connectedNames = status.filter((s) => s.status === "connected").map((s) => s.name);
+            const serverInfo = status.find((s) => s.name === server);
+            if (!serverInfo) {
+                // Only reveal *connected* servers in the error. Leaking every
+                // disabled default makes the agent claim they're available.
+                const hint = connectedNames.length > 0
+                    ? `Connected servers: ${connectedNames.join(", ")}.`
+                    : "No MCP servers are currently connected.";
+                throw new NotFoundError(`MCP server "${server}" not found or not connected. ${hint} ` +
+                    `Additional integrations can be enabled by the user at /mcp.`);
+            }
+            if (serverInfo.status !== "connected") {
+                const reason = serverInfo.configured
+                    ? "disabled — user must enable it at /mcp"
+                    : "not configured — user must add required credentials at /mcp";
+                throw new Error(`MCP server "${server}" is ${reason}. ` +
+                    (connectedNames.length > 0 ? `Connected alternatives: ${connectedNames.join(", ")}.` : ""));
+            }
+            // Validate tool belongs to this server so we fail fast with a
+            // useful message instead of letting the MCP server return an
+            // obscure "unknown method" error.
+            const knownTools = new Set(serverInfo.tools.map((t) => t.name));
+            if (!knownTools.has(tool)) {
+                throw new ValidationError(`Tool "${tool}" not found on MCP server "${server}". Available on this server: ${serverInfo.tools.map((t) => t.name).join(", ")}.`);
+            }
+            const result = await mcp.callTool(server, tool, args ?? {});
+            return { server, tool, result };
+        },
+    };
+}
+//# sourceMappingURL=useMCP.js.map

package/dist/tools/core/useMCP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMCP.js","sourceRoot":"","sources":["../../../src/tools/core/useMCP.ts"],"names":[],"mappings":"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"}

package/dist/tools/core/watcherTool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * watcher(action, ...) — manage event-driven triggers.
+ *
+ * Watchers fire when a condition is met (webhook received, poll result
+ * changes, file modified, cron tick). This tool configures them; the
+ * runtime execution is handled by the server-side WatcherRunner.
+ *
+ * Actions:
+ *   create  — new watcher
+ *   list    — all watchers
+ *   get     — details for one watcher
+ *   update  — patch fields
+ *   delete  — permanent removal
+ *   enable  — turn on
+ *   disable — turn off without deleting
+ */
+import { z } from "zod";
+import type { WatcherStore } from "../../watchers/WatcherStore.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    action: z.ZodEnum<["create", "list", "get", "update", "delete", "enable", "disable"]>;
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    triggerType: z.ZodOptional<z.ZodEnum<["webhook", "poll", "file", "cron"]>>;
+    pattern: z.ZodOptional<z.ZodString>;
+    actionSpec: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "delete" | "get" | "create" | "list" | "update" | "enable" | "disable";
+    channel?: string | undefined;
+    pattern?: string | undefined;
+    id?: string | undefined;
+    name?: string | undefined;
+    triggerType?: "file" | "cron" | "webhook" | "poll" | undefined;
+    actionSpec?: string | undefined;
+}, {
+    action: "delete" | "get" | "create" | "list" | "update" | "enable" | "disable";
+    channel?: string | undefined;
+    pattern?: string | undefined;
+    id?: string | undefined;
+    name?: string | undefined;
+    triggerType?: "file" | "cron" | "webhook" | "poll" | undefined;
+    actionSpec?: string | undefined;
+}>;
+export declare function makeWatcherTool(store: WatcherStore): ToolDef<typeof inputSchema, unknown>;
+export {};
+//# sourceMappingURL=watcherTool.d.ts.map

package/dist/tools/core/watcherTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherTool.d.ts","sourceRoot":"","sources":["../../../src/tools/core/watcherTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EAQf,CAAC;AAEH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,CAAC,CAsFzF"}

package/dist/tools/core/watcherTool.js

@@ -0,0 +1,119 @@
+/**
+ * watcher(action, ...) — manage event-driven triggers.
+ *
+ * Watchers fire when a condition is met (webhook received, poll result
+ * changes, file modified, cron tick). This tool configures them; the
+ * runtime execution is handled by the server-side WatcherRunner.
+ *
+ * Actions:
+ *   create  — new watcher
+ *   list    — all watchers
+ *   get     — details for one watcher
+ *   update  — patch fields
+ *   delete  — permanent removal
+ *   enable  — turn on
+ *   disable — turn off without deleting
+ */
+import { z } from "zod";
+import { NotFoundError, ValidationError } from "../../util/errors.js";
+const TRIGGER_TYPES = ["webhook", "poll", "file", "cron"];
+const inputSchema = z.object({
+    action: z.enum(["create", "list", "get", "update", "delete", "enable", "disable"]),
+    id: z.string().optional(),
+    name: z.string().optional(),
+    triggerType: z.enum(TRIGGER_TYPES).optional().describe("Source type."),
+    pattern: z.string().optional().describe("Trigger-specific matcher: URL path for webhook, path glob for file, cron expr, etc."),
+    actionSpec: z.string().optional().describe("What the agent does when fired — usually a prompt or task id."),
+    channel: z.string().optional().describe("Delivery channel for the resulting agent reply."),
+});
+export function makeWatcherTool(store) {
+    return {
+        name: "watcher",
+        description: "Manage event-driven triggers (webhooks, polls, file watches, cron). Actions: create, list, get, update, delete, enable, disable.",
+        category: "agent",
+        source: { kind: "core" },
+        tags: ["watcher", "trigger", "event", "webhook"],
+        inputSchema,
+        async execute(input, { logger }) {
+            switch (input.action) {
+                case "create": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    const watcher = store.create({
+                        name: input.name,
+                        ...(input.triggerType ? { triggerType: input.triggerType } : {}),
+                        ...(input.pattern !== undefined ? { pattern: input.pattern } : {}),
+                        ...(input.actionSpec !== undefined ? { action: input.actionSpec } : {}),
+                        ...(input.channel ? { channel: input.channel } : {}),
+                    });
+                    logger.info("watcher created", { id: watcher.id, name: watcher.name, triggerType: watcher.triggerType });
+                    return {
+                        id: watcher.id,
+                        name: watcher.name,
+                        triggerType: watcher.triggerType,
+                        enabled: watcher.enabled,
+                        message: `Watcher '${watcher.name}' (${watcher.triggerType}) created (${watcher.id.slice(0, 8)})`,
+                    };
+                }
+                case "list": {
+                    return store.list().map((w) => ({
+                        id: w.id,
+                        name: w.name,
+                        triggerType: w.triggerType,
+                        pattern: w.pattern,
+                        channel: w.channel,
+                        enabled: w.enabled,
+                        triggerCount: w.triggerCount,
+                        lastTriggeredAt: w.lastTriggeredAt ? new Date(w.lastTriggeredAt).toISOString() : null,
+                    }));
+                }
+                case "get": {
+                    if (!input.id)
+                        throw new ValidationError("id is required");
+                    const w = store.get(input.id);
+                    if (!w)
+                        throw new NotFoundError(`Watcher not found: ${input.id}`);
+                    return {
+                        ...w,
+                        lastTriggeredAt: w.lastTriggeredAt ? new Date(w.lastTriggeredAt).toISOString() : null,
+                        createdAt: new Date(w.createdAt).toISOString(),
+                        updatedAt: new Date(w.updatedAt).toISOString(),
+                    };
+                }
+                case "update": {
+                    if (!input.id)
+                        throw new ValidationError("id is required");
+                    const patch = {
+                        ...(input.name !== undefined ? { name: input.name } : {}),
+                        ...(input.triggerType !== undefined ? { triggerType: input.triggerType } : {}),
+                        ...(input.pattern !== undefined ? { pattern: input.pattern } : {}),
+                        ...(input.actionSpec !== undefined ? { action: input.actionSpec } : {}),
+                        ...(input.channel !== undefined ? { channel: input.channel } : {}),
+                    };
+                    const ok = store.update(input.id, patch);
+                    if (!ok)
+                        throw new NotFoundError(`Watcher not found: ${input.id}`);
+                    return { id: input.id, updated: true, message: `Watcher ${input.id.slice(0, 8)} updated` };
+                }
+                case "delete": {
+                    if (!input.id)
+                        throw new ValidationError("id is required");
+                    const ok = store.delete(input.id);
+                    if (!ok)
+                        throw new NotFoundError(`Watcher not found: ${input.id}`);
+                    return { id: input.id, removed: true, message: `Watcher ${input.id.slice(0, 8)} removed` };
+                }
+                case "enable":
+                case "disable": {
+                    if (!input.id)
+                        throw new ValidationError("id is required");
+                    const ok = store.update(input.id, { enabled: input.action === "enable" });
+                    if (!ok)
+                        throw new NotFoundError(`Watcher not found: ${input.id}`);
+                    return { id: input.id, enabled: input.action === "enable", message: `Watcher ${input.id.slice(0, 8)} ${input.action}d` };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=watcherTool.js.map

package/dist/tools/core/watcherTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcherTool.js","sourceRoot":"","sources":["../../../src/tools/core/watcherTool.ts"],"names":[],"mappings":"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"}

package/dist/tools/core/webFetch.d.ts

@@ -0,0 +1,48 @@
+/**
+ * web_fetch — fetch a URL and return *readable* text.
+ *
+ * Where `fetch_url` is a raw HTTP client (for calling APIs and getting
+ * status codes back), `web_fetch` is the "read me this page" tool:
+ *
+ *   1. SSRF defense — block private / loopback hosts.
+ *   2. GitHub `blob` links auto-convert to `raw.githubusercontent.com`.
+ *   3. Primary: fetch the page, strip script/style/nav/footer, remove
+ *      hidden elements and prompt-injection-y invisible unicode, convert
+ *      to plain text.
+ *   4. Fallback: Firecrawl (if FIRECRAWL_API_KEY is in the vault) — for
+ *      JS-rendered pages or anything our regex pipeline can't crack.
+ *   5. 15-minute LRU cache (100 URLs max) so repeated reads don't burn
+ *      bandwidth / quota.
+ */
+import { z } from "zod";
+import type { ConfigManager } from "../../config/ConfigManager.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    url: z.ZodString;
+    maxChars: z.ZodDefault<z.ZodNumber>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    forceFirecrawl: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    timeoutMs: number;
+    maxChars: number;
+    forceFirecrawl: boolean;
+}, {
+    url: string;
+    timeoutMs?: number | undefined;
+    maxChars?: number | undefined;
+    forceFirecrawl?: boolean | undefined;
+}>;
+interface WebFetchResult {
+    readonly url: string;
+    readonly status: number;
+    readonly extractor: "local" | "firecrawl";
+    readonly text: string;
+    readonly truncated: boolean;
+    readonly cached: boolean;
+    readonly durationMs: number;
+}
+export declare function clearWebFetchCache(): number;
+export declare function makeWebFetchTool(cfg: ConfigManager): ToolDef<typeof inputSchema, WebFetchResult>;
+export {};
+//# sourceMappingURL=webFetch.d.ts.map

package/dist/tools/core/webFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webFetch.d.ts","sourceRoot":"","sources":["../../../src/tools/core/webFetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAOf,CAAC;AAEH,UAAU,cAAc;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAID,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,cAAc,CAAC,CA8GhG"}