@shardworks/spider-apparatus 0.1.115

package/dist/spider.js

@@ -0,0 +1,356 @@
+/**
+ * The Spider — rig execution engine apparatus.
+ *
+ * The Spider drives writ-to-completion by managing rigs: ordered pipelines
+ * of engine instances. Each crawl() call performs one unit of work:
+ *
+ *   collect > run > spawn   (priority order)
+ *
+ * collect — check running engines for terminal session results
+ * run     — execute the next pending engine (clockwork inline, quick → launch)
+ * spawn   — create a new rig for a ready writ with no existing rig
+ *
+ * CDC on the rigs book (Phase 1 cascade) transitions the associated writ
+ * when a rig reaches a terminal state (completed or failed).
+ *
+ * See: docs/architecture/apparatus/spider.md
+ */
+import { guild, generateId } from '@shardworks/nexus-core';
+import { draftEngine, implementEngine, reviewEngine, reviseEngine, sealEngine, } from "./engines/index.js";
+import { crawlTool, crawlContinualTool } from "./tools/index.js";
+// ── Helpers ────────────────────────────────────────────────────────────
+/**
+ * Check whether a value is JSON-serializable.
+ * Non-serializable yields cause engine failure — the Stacks cannot store them.
+ */
+function isJsonSerializable(value) {
+    try {
+        JSON.stringify(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build the upstream yields map for a rig: all completed engine yields
+ * keyed by engine id. Passed as context.upstream to the engine's run().
+ */
+function buildUpstreamMap(rig) {
+    const upstream = {};
+    for (const engine of rig.engines) {
+        if (engine.status === 'completed' && engine.yields !== undefined) {
+            upstream[engine.id] = engine.yields;
+        }
+    }
+    return upstream;
+}
+/**
+ * Find the first pending engine whose entire upstream is completed.
+ * Returns null if no runnable engine exists.
+ */
+function findRunnableEngine(rig) {
+    for (const engine of rig.engines) {
+        if (engine.status !== 'pending')
+            continue;
+        const allUpstreamDone = engine.upstream.every((upstreamId) => {
+            const dep = rig.engines.find((e) => e.id === upstreamId);
+            return dep?.status === 'completed';
+        });
+        if (allUpstreamDone)
+            return engine;
+    }
+    return null;
+}
+/**
+ * Produce the five-engine static pipeline for a writ.
+ * Each engine receives only the givens it needs.
+ * Upstream yields arrive via context.upstream at run time.
+ */
+function buildStaticEngines(writ, config) {
+    const role = config.role ?? 'artificer';
+    const reviewGivens = {
+        writ,
+        role: 'reviewer',
+        ...(config.buildCommand !== undefined ? { buildCommand: config.buildCommand } : {}),
+        ...(config.testCommand !== undefined ? { testCommand: config.testCommand } : {}),
+    };
+    return [
+        { id: 'draft', designId: 'draft', status: 'pending', upstream: [], givensSpec: { writ } },
+        { id: 'implement', designId: 'implement', status: 'pending', upstream: ['draft'], givensSpec: { writ, role } },
+        { id: 'review', designId: 'review', status: 'pending', upstream: ['implement'], givensSpec: reviewGivens },
+        { id: 'revise', designId: 'revise', status: 'pending', upstream: ['review'], givensSpec: { writ, role } },
+        { id: 'seal', designId: 'seal', status: 'pending', upstream: ['revise'], givensSpec: {} },
+    ];
+}
+// ── Apparatus factory ──────────────────────────────────────────────────
+export function createSpider() {
+    let rigsBook;
+    let sessionsBook;
+    let writsBook;
+    let clerk;
+    let fabricator;
+    let spiderConfig = {};
+    // ── Internal crawl operations ─────────────────────────────────────
+    /**
+     * Mark an engine failed and propagate failure to the rig (same update).
+     */
+    async function failEngine(rig, engineId, errorMessage) {
+        const now = new Date().toISOString();
+        const updatedEngines = rig.engines.map((e) => e.id === engineId
+            ? { ...e, status: 'failed', error: errorMessage, completedAt: now }
+            : e);
+        await rigsBook.patch(rig.id, {
+            engines: updatedEngines,
+            status: 'failed',
+        });
+    }
+    /**
+     * Phase 1 — collect.
+     *
+     * Find the first running engine with a sessionId whose session has
+     * reached a terminal state. Populate yields and advance the engine
+     * (and possibly the rig) to completed or failed.
+     */
+    async function tryCollect() {
+        const runningRigs = await rigsBook.find({ where: [['status', '=', 'running']] });
+        for (const rig of runningRigs) {
+            for (const engine of rig.engines) {
+                if (engine.status !== 'running' || !engine.sessionId)
+                    continue;
+                const session = await sessionsBook.get(engine.sessionId);
+                if (!session || session.status === 'running')
+                    continue;
+                // Terminal session found — collect.
+                const now = new Date().toISOString();
+                if (session.status === 'failed' || session.status === 'timeout') {
+                    await failEngine(rig, engine.id, session.error ?? `Session ${session.status}`);
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+                }
+                // Completed session — assemble engine-specific yields from session record.
+                let yields;
+                if (engine.id === 'review') {
+                    // Review collect: parse findings and passed flag from session output;
+                    // retrieve mechanicalChecks stashed in session metadata by the review engine.
+                    const findings = session.output ?? '';
+                    const passed = /^###\s*Overall:\s*PASS/mi.test(findings);
+                    const mechanicalChecks = session.metadata?.mechanicalChecks ?? [];
+                    yields = { sessionId: session.id, passed, findings, mechanicalChecks };
+                }
+                else {
+                    yields = {
+                        sessionId: session.id,
+                        sessionStatus: session.status,
+                        ...(session.output !== undefined ? { output: session.output } : {}),
+                    };
+                }
+                if (!isJsonSerializable(yields)) {
+                    await failEngine(rig, engine.id, 'Session yields are not JSON-serializable');
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+                }
+                const updatedEngines = rig.engines.map((e) => e.id === engine.id
+                    ? { ...e, status: 'completed', yields, completedAt: now }
+                    : e);
+                const allCompleted = updatedEngines.every((e) => e.status === 'completed');
+                await rigsBook.patch(rig.id, {
+                    engines: updatedEngines,
+                    status: allCompleted ? 'completed' : 'running',
+                });
+                if (allCompleted) {
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'completed' };
+                }
+                return { action: 'engine-completed', rigId: rig.id, engineId: engine.id };
+            }
+        }
+        return null;
+    }
+    /**
+     * Phase 2 — run.
+     *
+     * Find the first pending engine in any running rig whose upstream is
+     * all completed. Execute it:
+     * - Clockwork ('completed') → store yields, mark engine completed,
+     *   check for rig completion.
+     * - Quick ('launched') → store sessionId, mark engine running.
+     */
+    async function tryRun() {
+        const runningRigs = await rigsBook.find({ where: [['status', '=', 'running']] });
+        for (const rig of runningRigs) {
+            const pending = findRunnableEngine(rig);
+            if (!pending)
+                continue;
+            const design = fabricator.getEngineDesign(pending.designId);
+            if (!design) {
+                await failEngine(rig, pending.id, `No engine design found for "${pending.designId}"`);
+                return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+            }
+            const now = new Date().toISOString();
+            const upstream = buildUpstreamMap(rig);
+            const givens = { ...pending.givensSpec };
+            const context = { engineId: pending.id, upstream };
+            let engineResult;
+            try {
+                // Mark engine as running before executing
+                const startedEngines = rig.engines.map((e) => e.id === pending.id ? { ...e, status: 'running', startedAt: now } : e);
+                await rigsBook.patch(rig.id, { engines: startedEngines });
+                // Re-fetch to get the up-to-date engines list (with startedAt set)
+                const updatedRig = { ...rig, engines: startedEngines };
+                engineResult = await design.run(givens, context);
+                if (engineResult.status === 'launched') {
+                    // Quick engine — store sessionId, leave engine in 'running'
+                    const { sessionId } = engineResult;
+                    const launchedEngines = updatedRig.engines.map((e) => e.id === pending.id
+                        ? { ...e, status: 'running', sessionId }
+                        : e);
+                    await rigsBook.patch(rig.id, { engines: launchedEngines });
+                    return { action: 'engine-started', rigId: rig.id, engineId: pending.id };
+                }
+                // Clockwork engine — validate and store yields
+                const { yields } = engineResult;
+                if (!isJsonSerializable(yields)) {
+                    await failEngine(updatedRig, pending.id, 'Engine yields are not JSON-serializable');
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+                }
+                const completedAt = new Date().toISOString();
+                const completedEngines = updatedRig.engines.map((e) => e.id === pending.id
+                    ? { ...e, status: 'completed', yields, completedAt }
+                    : e);
+                const allCompleted = completedEngines.every((e) => e.status === 'completed');
+                await rigsBook.patch(rig.id, {
+                    engines: completedEngines,
+                    status: allCompleted ? 'completed' : 'running',
+                });
+                if (allCompleted) {
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'completed' };
+                }
+                return { action: 'engine-completed', rigId: rig.id, engineId: pending.id };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                await failEngine(rig, pending.id, errorMessage);
+                return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+            }
+        }
+        return null;
+    }
+    /**
+     * Phase 3 — spawn.
+     *
+     * Find the oldest ready writ with no existing rig. Create a rig and
+     * transition the writ to active so the Clerk tracks it as in-progress.
+     */
+    async function trySpawn() {
+        // Find ready writs ordered by creation time (oldest first)
+        const readyWrits = await writsBook.find({
+            where: [['status', '=', 'ready']],
+            orderBy: ['createdAt', 'asc'],
+            limit: 10,
+        });
+        for (const writ of readyWrits) {
+            // Check for existing rig
+            const existing = await rigsBook.find({
+                where: [['writId', '=', writ.id]],
+                limit: 1,
+            });
+            if (existing.length > 0)
+                continue;
+            const rigId = generateId('rig', 4);
+            const engines = buildStaticEngines(writ, spiderConfig);
+            const rig = {
+                id: rigId,
+                writId: writ.id,
+                status: 'running',
+                engines,
+            };
+            await rigsBook.put(rig);
+            // Transition writ to active so Clerk tracks it
+            try {
+                await clerk.transition(writ.id, 'active');
+            }
+            catch (err) {
+                // Only swallow state-transition conflicts (writ already moved past 'ready')
+                if (err instanceof Error && err.message.includes('transition')) {
+                    // Race condition — another spider got here first. The rig is already created,
+                    // so we continue. The writ is already active or beyond.
+                }
+                else {
+                    throw err;
+                }
+            }
+            return { action: 'rig-spawned', rigId, writId: writ.id };
+        }
+        return null;
+    }
+    // ── SpiderApi ─────────────────────────────────────────────────────
+    const api = {
+        async crawl() {
+            const collected = await tryCollect();
+            if (collected)
+                return collected;
+            const ran = await tryRun();
+            if (ran)
+                return ran;
+            const spawned = await trySpawn();
+            if (spawned)
+                return spawned;
+            return null;
+        },
+    };
+    // ── Apparatus ─────────────────────────────────────────────────────
+    return {
+        apparatus: {
+            requires: ['stacks', 'clerk', 'fabricator'],
+            supportKit: {
+                books: {
+                    rigs: {
+                        indexes: ['status', 'writId', ['status', 'writId']],
+                    },
+                },
+                engines: {
+                    draft: draftEngine,
+                    implement: implementEngine,
+                    review: reviewEngine,
+                    revise: reviseEngine,
+                    seal: sealEngine,
+                },
+                tools: [crawlTool, crawlContinualTool],
+            },
+            provides: api,
+            start(_ctx) {
+                const g = guild();
+                spiderConfig = g.guildConfig().spider ?? {};
+                const stacks = g.apparatus('stacks');
+                clerk = g.apparatus('clerk');
+                fabricator = g.apparatus('fabricator');
+                rigsBook = stacks.book('spider', 'rigs');
+                sessionsBook = stacks.readBook('animator', 'sessions');
+                writsBook = stacks.readBook('clerk', 'writs');
+                // CDC — Phase 1 cascade on rigs book.
+                // When a rig reaches a terminal state, transition the associated writ.
+                stacks.watch('spider', 'rigs', async (event) => {
+                    if (event.type !== 'update')
+                        return;
+                    const rig = event.entry;
+                    const prev = event.prev;
+                    // Only act when status changes to a terminal state
+                    if (rig.status === prev.status)
+                        return;
+                    if (rig.status === 'completed') {
+                        // Use seal yields as the resolution summary
+                        const sealEngine = rig.engines.find((e) => e.id === 'seal');
+                        const resolution = sealEngine?.yields
+                            ? JSON.stringify(sealEngine.yields)
+                            : 'Rig completed';
+                        await clerk.transition(rig.writId, 'completed', { resolution });
+                    }
+                    else if (rig.status === 'failed') {
+                        const failedEngine = rig.engines.find((e) => e.status === 'failed');
+                        const resolution = failedEngine?.error ?? 'Engine failure';
+                        await clerk.transition(rig.writId, 'failed', { resolution });
+                    }
+                }, { failOnError: true });
+            },
+        },
+    };
+}
+//# sourceMappingURL=spider.js.map

package/dist/spider.js.map

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

package/dist/tools/crawl-continual.d.ts

@@ -0,0 +1,13 @@
+/**
+ * crawlContinual tool — runs the crawl loop continuously.
+ *
+ * Polls crawl() on a configurable interval until stopped or no remaining
+ * work exists for the configured number of consecutive idle cycles.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    maxIdleCycles: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+}>;
+export default _default;
+//# sourceMappingURL=crawl-continual.d.ts.map

package/dist/tools/crawl-continual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl-continual.d.ts","sourceRoot":"","sources":["../../src/tools/crawl-continual.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;AAKxB,wBA0DG"}

package/dist/tools/crawl-continual.js

@@ -0,0 +1,63 @@
+/**
+ * crawlContinual tool — runs the crawl loop continuously.
+ *
+ * Polls crawl() on a configurable interval until stopped or no remaining
+ * work exists for the configured number of consecutive idle cycles.
+ */
+import { z } from 'zod';
+import { guild } from '@shardworks/nexus-core';
+import { tool } from '@shardworks/tools-apparatus';
+export default tool({
+    name: 'crawlContinual',
+    description: "Run the Spider's crawl loop continuously until idle",
+    instructions: 'Polls crawl() in a loop, sleeping between steps when idle. ' +
+        'Stops when the configured number of consecutive idle cycles is reached. ' +
+        'Returns a summary of all actions taken.',
+    params: {
+        maxIdleCycles: z
+            .number()
+            .optional()
+            .default(3)
+            .describe('Number of consecutive idle crawl() calls before stopping (default: 3)'),
+        pollIntervalMs: z
+            .number()
+            .optional()
+            .describe('Override the configured poll interval in milliseconds'),
+    },
+    permission: 'spider:write',
+    handler: async (params) => {
+        const g = guild();
+        const spider = g.apparatus('spider');
+        const config = g.guildConfig().spider ?? {};
+        const intervalMs = params.pollIntervalMs ?? config.pollIntervalMs ?? 5000;
+        const maxIdle = params.maxIdleCycles;
+        const actions = [];
+        let idleCount = 0;
+        while (idleCount < maxIdle) {
+            let result;
+            try {
+                result = await spider.crawl();
+            }
+            catch (err) {
+                console.error('[crawlContinual] crawl() error:', err instanceof Error ? err.message : String(err));
+                idleCount++;
+                if (idleCount < maxIdle) {
+                    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+                }
+                continue;
+            }
+            if (result === null) {
+                idleCount++;
+                if (idleCount < maxIdle) {
+                    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+                }
+            }
+            else {
+                idleCount = 0;
+                actions.push(result);
+            }
+        }
+        return { actions, totalActions: actions.length };
+    },
+});
+//# sourceMappingURL=crawl-continual.js.map

package/dist/tools/crawl-continual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl-continual.js","sourceRoot":"","sources":["../../src/tools/crawl-continual.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGnD,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,qDAAqD;IAClE,YAAY,EACV,6DAA6D;QAC7D,0EAA0E;QAC1E,yCAAyC;IAC3C,MAAM,EAAE;QACN,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CACP,uEAAuE,CACxE;QACH,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uDAAuD,CACxD;KACJ;IACD,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,IAAI,EAAkB,CAAC;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;QAErC,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,OAAO,SAAS,GAAG,OAAO,EAAE,CAAC;YAC3B,IAAI,MAAgD,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBACnG,SAAS,EAAE,CAAC;gBACZ,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;oBACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;gBACxE,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,SAAS,EAAE,CAAC;gBACZ,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;oBACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,CAAC,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/crawl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * crawl tool — executes a single step of the crawl loop.
+ *
+ * Returns the CrawlResult or null (idle) from one crawl() call.
+ * Useful for manual step-through or testing.
+ */
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{}>;
+export default _default;
+//# sourceMappingURL=crawl.d.ts.map

package/dist/tools/crawl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../../src/tools/crawl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAMH,wBAaG"}

package/dist/tools/crawl.js

@@ -0,0 +1,22 @@
+/**
+ * crawl tool — executes a single step of the crawl loop.
+ *
+ * Returns the CrawlResult or null (idle) from one crawl() call.
+ * Useful for manual step-through or testing.
+ */
+import { guild } from '@shardworks/nexus-core';
+import { tool } from '@shardworks/tools-apparatus';
+export default tool({
+    name: 'crawl',
+    description: "Execute one step of the Spider's crawl loop",
+    instructions: 'Runs a single crawl() step: collect a pending session result, run the next ' +
+        'ready engine, or spawn a rig for a ready writ — in that priority order. ' +
+        'Returns the action taken, or null if there is nothing to do.',
+    params: {},
+    permission: 'spider:write',
+    handler: async () => {
+        const spider = guild().apparatus('spider');
+        return spider.crawl();
+    },
+});
+//# sourceMappingURL=crawl.js.map

package/dist/tools/crawl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.js","sourceRoot":"","sources":["../../src/tools/crawl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGnD,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,6CAA6C;IAC1D,YAAY,EACV,6EAA6E;QAC7E,0EAA0E;QAC1E,8DAA8D;IAChE,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { default as crawlTool } from './crawl.ts';
+export { default as crawlContinualTool } from './crawl-continual.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export { default as crawlTool } from "./crawl.js";
+export { default as crawlContinualTool } from "./crawl-continual.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}