daycare-cli 0.0.0-canary.f57680e

package/dist/engine/modules/tools/sessionHistoryToolBuild.spec.js

@@ -0,0 +1,193 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createId } from "@paralleldrive/cuid2";
+import { describe, expect, it, vi } from "vitest";
+import { configResolve } from "../../../config/configResolve.js";
+import { agentDescriptorWrite } from "../../agents/ops/agentDescriptorWrite.js";
+import { agentHistoryAppend } from "../../agents/ops/agentHistoryAppend.js";
+import { sessionHistoryToolBuild } from "./sessionHistoryToolBuild.js";
+const toolCall = { id: "tool-1", name: "read_session_history" };
+describe("sessionHistoryToolBuild", () => {
+    it("returns summary output by default", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-session-history-tool-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir },
+                providers: [{ id: "openai", model: "gpt-4o-mini", enabled: true }]
+            }, path.join(dir, "settings.json"));
+            const currentAgentId = createId();
+            const targetAgentId = createId();
+            await agentDescriptorWrite(config, targetAgentId, {
+                type: "subagent",
+                id: targetAgentId,
+                parentAgentId: currentAgentId,
+                name: "worker"
+            });
+            await agentHistoryAppend(config, targetAgentId, { type: "start", at: 10 });
+            await agentHistoryAppend(config, targetAgentId, {
+                type: "user_message",
+                at: 20,
+                text: "check logs",
+                files: []
+            });
+            const tool = sessionHistoryToolBuild();
+            const completeMock = vi.fn(async (..._args) => ({
+                message: summaryAssistantMessageBuild("Summary:\n- reviewed history"),
+                providerId: "openai",
+                modelId: "gpt-test"
+            }));
+            const context = buildContext(currentAgentId, config, completeMock);
+            const result = await tool.execute({ agentId: targetAgentId }, context, toolCall);
+            const text = contentText(result.toolMessage.content);
+            expect(result.toolMessage.isError).toBe(false);
+            expect(text).toContain("Agent");
+            expect(text).toContain("Summary:");
+            expect(text).toContain("reviewed history");
+            expect(completeMock).toHaveBeenCalledTimes(1);
+            const summaryContext = completeMock.mock.calls[0]?.[0];
+            expect(summaryContext).toBeDefined();
+            expect(summaryContext?.messages).toHaveLength(1);
+            const details = result.toolMessage.details;
+            expect(details.fromAt).toBe(null);
+            expect(details.toAt).toBe(null);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("returns raw history when summarized is false", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-session-history-tool-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir },
+                providers: [{ id: "openai", model: "gpt-4o-mini", enabled: true }]
+            }, path.join(dir, "settings.json"));
+            const currentAgentId = createId();
+            const targetAgentId = createId();
+            await agentDescriptorWrite(config, targetAgentId, {
+                type: "subagent",
+                id: targetAgentId,
+                parentAgentId: currentAgentId,
+                name: "worker"
+            });
+            await agentHistoryAppend(config, targetAgentId, { type: "start", at: 10 });
+            await agentHistoryAppend(config, targetAgentId, {
+                type: "note",
+                at: 30,
+                text: "done"
+            });
+            await agentHistoryAppend(config, targetAgentId, {
+                type: "note",
+                at: 50,
+                text: "late"
+            });
+            const tool = sessionHistoryToolBuild();
+            const completeMock = vi.fn(async (..._args) => ({
+                message: summaryAssistantMessageBuild("unused"),
+                providerId: "openai",
+                modelId: "gpt-test"
+            }));
+            const context = buildContext(currentAgentId, config, completeMock);
+            const result = await tool.execute({ agentId: targetAgentId, summarized: false, fromAt: 20, toAt: 40 }, context, toolCall);
+            const text = contentText(result.toolMessage.content);
+            expect(result.toolMessage.isError).toBe(false);
+            expect(text).toContain("full session history");
+            expect(text).toContain("\"type\": \"note\"");
+            expect(text).toContain("\"at\": 30");
+            expect(text).not.toContain("\"at\": 10");
+            expect(text).not.toContain("\"at\": 50");
+            expect(completeMock).not.toHaveBeenCalled();
+            const details = result.toolMessage.details;
+            expect(details.recordCount).toBe(1);
+            expect(details.fromAt).toBe(20);
+            expect(details.toAt).toBe(40);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("rejects invalid time range", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-session-history-tool-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir },
+                providers: [{ id: "openai", model: "gpt-4o-mini", enabled: true }]
+            }, path.join(dir, "settings.json"));
+            const currentAgentId = createId();
+            const targetAgentId = createId();
+            await agentDescriptorWrite(config, targetAgentId, {
+                type: "subagent",
+                id: targetAgentId,
+                parentAgentId: currentAgentId,
+                name: "worker"
+            });
+            await agentHistoryAppend(config, targetAgentId, { type: "start", at: 10 });
+            const tool = sessionHistoryToolBuild();
+            const completeMock = vi.fn(async (..._args) => ({
+                message: summaryAssistantMessageBuild("unused"),
+                providerId: "openai",
+                modelId: "gpt-test"
+            }));
+            const context = buildContext(currentAgentId, config, completeMock);
+            await expect(tool.execute({ agentId: targetAgentId, summarized: false, fromAt: 41, toAt: 40 }, context, toolCall)).rejects.toThrow("fromAt must be less than or equal to toAt.");
+            expect(completeMock).not.toHaveBeenCalled();
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+function buildContext(agentId, config, completeMock) {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: config.defaultPermissions,
+        agent: { id: agentId },
+        source: "test",
+        messageContext: {},
+        agentSystem: {
+            config: { current: config },
+            inferenceRouter: {
+                complete: completeMock
+            }
+        },
+        heartbeats: null
+    };
+}
+function contentText(content) {
+    if (!Array.isArray(content)) {
+        return "";
+    }
+    return content
+        .filter((item) => {
+        if (typeof item !== "object" || item === null) {
+            return false;
+        }
+        return item.type === "text";
+    })
+        .map((item) => item.text)
+        .filter((value) => typeof value === "string")
+        .join("\n");
+}
+function summaryAssistantMessageBuild(text) {
+    return {
+        role: "assistant",
+        content: [{ type: "text", text }],
+        stopReason: "complete",
+        usage: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            total: 0
+        }
+    };
+}
+//# sourceMappingURL=sessionHistoryToolBuild.spec.js.map

package/dist/engine/modules/tools/sessionHistoryToolBuild.spec.js.map

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

package/dist/engine/modules/tools/signal.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@/types";
+import type { Signals } from "../../signals/signals.js";
+export declare function buildSignalGenerateTool(signals: Signals): ToolDefinition;
+//# sourceMappingURL=signal.d.ts.map

package/dist/engine/modules/tools/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/signal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AA4DxD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CA8CxE"}

package/dist/engine/modules/tools/signal.js

@@ -0,0 +1,81 @@
+import { Type } from "@sinclair/typebox";
+const sourceSchema = Type.Union([
+    Type.Object({
+        type: Type.Literal("system")
+    }, { additionalProperties: false }),
+    Type.Object({
+        type: Type.Literal("agent"),
+        id: Type.String({ minLength: 1 })
+    }, { additionalProperties: false }),
+    Type.Object({
+        type: Type.Literal("webhook"),
+        id: Type.Optional(Type.String({ minLength: 1 }))
+    }, { additionalProperties: false }),
+    Type.Object({
+        type: Type.Literal("process"),
+        id: Type.Optional(Type.String({ minLength: 1 }))
+    }, { additionalProperties: false })
+]);
+const schema = Type.Object({
+    type: Type.String({ minLength: 1 }),
+    source: Type.Optional(sourceSchema),
+    data: Type.Optional(Type.Unknown())
+}, { additionalProperties: false });
+const signalGenerateResultSchema = Type.Object({
+    summary: Type.String(),
+    signalId: Type.String(),
+    signalType: Type.String(),
+    source: Type.String()
+}, { additionalProperties: false });
+const signalGenerateReturns = {
+    schema: signalGenerateResultSchema,
+    toLLMText: (result) => result.summary
+};
+export function buildSignalGenerateTool(signals) {
+    return {
+        tool: {
+            name: "generate_signal",
+            description: "Broadcast a signal event. Any agent subscribed to a matching pattern receives it. Use colon-separated type segments (e.g. `build:project-x:done`). Signals are fire-and-forget — you don't need to know who listens.",
+            parameters: schema
+        },
+        returns: signalGenerateReturns,
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const source = payload.source ?? { type: "agent", id: toolContext.agent.id };
+            const signal = await signals.generate({
+                type: payload.type,
+                source,
+                data: payload.data
+            });
+            const sourceLabel = signalSourceLabel(signal.source);
+            const summary = `Signal generated: ${signal.id} (${signal.type}, source=${sourceLabel}).`;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: summary
+                    }
+                ],
+                details: { signal },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    signalId: signal.id,
+                    signalType: signal.type,
+                    source: sourceLabel
+                }
+            };
+        }
+    };
+}
+function signalSourceLabel(source) {
+    return source.id ? `${source.type}:${source.id}` : source.type;
+}
+//# sourceMappingURL=signal.js.map

package/dist/engine/modules/tools/signal.js.map

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

package/dist/engine/modules/tools/signal.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signal.spec.d.ts.map

package/dist/engine/modules/tools/signal.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/signal.spec.ts"],"names":[],"mappings":""}

package/dist/engine/modules/tools/signal.spec.js

@@ -0,0 +1,59 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { EngineEventBus } from "../../ipc/events.js";
+import { Signals } from "../../signals/signals.js";
+import { buildSignalGenerateTool } from "./signal.js";
+const toolCall = { id: "tool-1", name: "generate_signal" };
+describe("buildSignalGenerateTool", () => {
+    it("generates agent source signals by default", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-signal-tool-"));
+        try {
+            const eventBus = new EngineEventBus();
+            const signals = new Signals({ eventBus, configDir: dir });
+            const events = [];
+            const unsubscribe = eventBus.onEvent((event) => {
+                events.push({ type: event.type, payload: event.payload });
+            });
+            await signals.ensureDir();
+            const tool = buildSignalGenerateTool(signals);
+            const result = await tool.execute({
+                type: "automation.requested",
+                data: { target: "deploy" }
+            }, contextBuild("agent-123"), toolCall);
+            unsubscribe();
+            expect(result.toolMessage.isError).toBe(false);
+            const details = result.toolMessage.details;
+            expect(details?.signal?.type).toBe("automation.requested");
+            expect(details?.signal?.source).toEqual({ type: "agent", id: "agent-123" });
+            expect(details?.signal?.data).toEqual({ target: "deploy" });
+            expect(events.some((event) => event.type === "signal.generated")).toBe(true);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+function contextBuild(agentId) {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: {
+            workingDir: "/tmp",
+            writeDirs: ["/tmp"],
+            readDirs: ["/tmp"],
+            network: true,
+            events: false
+        },
+        agent: { id: agentId },
+        source: "test",
+        messageContext: {},
+        agentSystem: null,
+        heartbeats: null
+    };
+}
+//# sourceMappingURL=signal.spec.js.map

package/dist/engine/modules/tools/signal.spec.js.map

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

package/dist/engine/modules/tools/signalEventsCsvToolBuild.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "@/types";
+import type { Signals } from "../../signals/signals.js";
+/**
+ * Builds the signal_events_csv tool for CSV-friendly event inspection.
+ * Expects: filters are optional; when both fromAt/toAt are provided, fromAt <= toAt.
+ */
+export declare function signalEventsCsvToolBuild(signals: Signals): ToolDefinition;
+//# sourceMappingURL=signalEventsCsvToolBuild.d.ts.map

package/dist/engine/modules/tools/signalEventsCsvToolBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalEventsCsvToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/signalEventsCsvToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAElE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAmCxD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CA2CzE"}

package/dist/engine/modules/tools/signalEventsCsvToolBuild.js

@@ -0,0 +1,123 @@
+import { Type } from "@sinclair/typebox";
+const schema = Type.Object({
+    fromAt: Type.Optional(Type.Integer({ minimum: 0 })),
+    toAt: Type.Optional(Type.Integer({ minimum: 0 })),
+    types: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1, maxItems: 100 }))
+}, { additionalProperties: false });
+const signalEventsCsvResultSchema = Type.Object({
+    summary: Type.String(),
+    recordCount: Type.Number(),
+    fromAt: Type.Optional(Type.Number()),
+    toAt: Type.Optional(Type.Number()),
+    filterTypeCount: Type.Number()
+}, { additionalProperties: false });
+const signalEventsCsvReturns = {
+    schema: signalEventsCsvResultSchema,
+    toLLMText: (result) => result.summary
+};
+/**
+ * Builds the signal_events_csv tool for CSV-friendly event inspection.
+ * Expects: filters are optional; when both fromAt/toAt are provided, fromAt <= toAt.
+ */
+export function signalEventsCsvToolBuild(signals) {
+    return {
+        tool: {
+            name: "signal_events_csv",
+            description: "Read signal events as CSV. Optional filters: fromAt/toAt (unix ms) and types (exact event type matches). Columns: event_type,args,unix_time,ai_friendly_time.",
+            parameters: schema
+        },
+        returns: signalEventsCsvReturns,
+        execute: async (args, _toolContext, toolCall) => {
+            const payload = args;
+            const timeRange = signalEventsCsvTimeRangeNormalize(payload.fromAt, payload.toAt);
+            const types = signalTypesNormalize(payload.types);
+            const records = signalEventsFilter(await signals.listAll(), timeRange, types);
+            const text = signalEventsCsvBuild(records);
+            const summary = text;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [{ type: "text", text: summary }],
+                details: {
+                    fromAt: timeRange.fromAt,
+                    toAt: timeRange.toAt,
+                    types,
+                    recordCount: records.length
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    recordCount: records.length,
+                    ...(timeRange.fromAt !== null ? { fromAt: timeRange.fromAt } : {}),
+                    ...(timeRange.toAt !== null ? { toAt: timeRange.toAt } : {}),
+                    filterTypeCount: types.length
+                }
+            };
+        }
+    };
+}
+function signalEventsCsvTimeRangeNormalize(fromAt, toAt) {
+    const normalized = {
+        fromAt: fromAt ?? null,
+        toAt: toAt ?? null
+    };
+    if (normalized.fromAt !== null &&
+        normalized.toAt !== null &&
+        normalized.fromAt > normalized.toAt) {
+        throw new Error("fromAt must be less than or equal to toAt.");
+    }
+    return normalized;
+}
+function signalTypesNormalize(types) {
+    if (!types || types.length === 0) {
+        return [];
+    }
+    const normalized = types
+        .map((type) => type.trim())
+        .filter((type) => type.length > 0);
+    return Array.from(new Set(normalized));
+}
+function signalEventsFilter(records, timeRange, types) {
+    const typeSet = new Set(types);
+    return records.filter((record) => {
+        if (timeRange.fromAt !== null && record.createdAt < timeRange.fromAt) {
+            return false;
+        }
+        if (timeRange.toAt !== null && record.createdAt > timeRange.toAt) {
+            return false;
+        }
+        if (typeSet.size > 0 && !typeSet.has(record.type)) {
+            return false;
+        }
+        return true;
+    });
+}
+function signalEventsCsvBuild(records) {
+    const header = "event_type,args,unix_time,ai_friendly_time";
+    if (records.length === 0) {
+        return header;
+    }
+    const lines = records.map((record) => {
+        const args = JSON.stringify(record.data ?? null);
+        const aiFriendlyTime = new Date(record.createdAt).toISOString();
+        return [
+            csvEscape(record.type),
+            csvEscape(args),
+            csvEscape(String(record.createdAt)),
+            csvEscape(aiFriendlyTime)
+        ].join(",");
+    });
+    return [header, ...lines].join("\n");
+}
+function csvEscape(value) {
+    if (!/[",\n]/.test(value)) {
+        return value;
+    }
+    return `"${value.replace(/"/g, "\"\"")}"`;
+}
+//# sourceMappingURL=signalEventsCsvToolBuild.js.map

package/dist/engine/modules/tools/signalEventsCsvToolBuild.js.map

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

package/dist/engine/modules/tools/signalEventsCsvToolBuild.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signalEventsCsvToolBuild.spec.d.ts.map

package/dist/engine/modules/tools/signalEventsCsvToolBuild.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalEventsCsvToolBuild.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/signalEventsCsvToolBuild.spec.ts"],"names":[],"mappings":""}

package/dist/engine/modules/tools/signalEventsCsvToolBuild.spec.js

@@ -0,0 +1,100 @@
+import { describe, expect, it } from "vitest";
+import { signalEventsCsvToolBuild } from "./signalEventsCsvToolBuild.js";
+const toolCall = { id: "tool-1", name: "signal_events_csv" };
+describe("signalEventsCsvToolBuild", () => {
+    it("renders filtered event rows as CSV", async () => {
+        const tool = signalEventsCsvToolBuild({
+            listAll: async () => signalEventsFixture()
+        });
+        const result = await tool.execute({
+            fromAt: 2000,
+            toAt: 3000,
+            types: ["build.done"]
+        }, contextBuild(), toolCall);
+        const text = contentText(result.toolMessage.content);
+        expect(text).toContain("event_type,args,unix_time,ai_friendly_time");
+        expect(text).toContain("\"{\"\"ok\"\":true}\"");
+        expect(text).toContain("build.done");
+        expect(text).toContain("2000");
+        expect(text).toContain("1970-01-01T00:00:02.000Z");
+        expect(text).not.toContain("build.failed");
+        expect(text).not.toContain("1000");
+        expect(text).not.toContain("4000");
+    });
+    it("returns only CSV header when no records match", async () => {
+        const tool = signalEventsCsvToolBuild({
+            listAll: async () => signalEventsFixture()
+        });
+        const result = await tool.execute({
+            types: ["missing.type"]
+        }, contextBuild(), toolCall);
+        const text = contentText(result.toolMessage.content);
+        expect(text).toBe("event_type,args,unix_time,ai_friendly_time");
+    });
+    it("rejects invalid time ranges", async () => {
+        const tool = signalEventsCsvToolBuild({
+            listAll: async () => signalEventsFixture()
+        });
+        await expect(tool.execute({
+            fromAt: 5,
+            toAt: 4
+        }, contextBuild(), toolCall)).rejects.toThrow("fromAt must be less than or equal to toAt.");
+    });
+});
+function signalEventsFixture() {
+    return [
+        {
+            id: "e1",
+            type: "build.done",
+            source: { type: "system" },
+            data: { ok: true },
+            createdAt: 2000
+        },
+        {
+            id: "e2",
+            type: "build.failed",
+            source: { type: "system" },
+            data: { ok: false },
+            createdAt: 3000
+        },
+        {
+            id: "e3",
+            type: "deploy.done",
+            source: { type: "system" },
+            data: { env: "prod" },
+            createdAt: 4000
+        }
+    ];
+}
+function contextBuild() {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: {
+            workingDir: "/tmp",
+            writeDirs: ["/tmp"],
+            readDirs: ["/tmp"],
+            network: false,
+            events: false
+        },
+        agent: { id: "agent-caller" },
+        source: "test",
+        messageContext: {},
+        agentSystem: null,
+        heartbeats: null
+    };
+}
+function contentText(content) {
+    if (!Array.isArray(content)) {
+        return "";
+    }
+    return content
+        .filter((item) => typeof item === "object" && item !== null && item.type === "text")
+        .map((item) => item.text)
+        .filter((value) => typeof value === "string")
+        .join("\n");
+}
+//# sourceMappingURL=signalEventsCsvToolBuild.spec.js.map

package/dist/engine/modules/tools/signalEventsCsvToolBuild.spec.js.map

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

package/dist/engine/modules/tools/signalSubscribeToolBuild.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@/types";
+import type { Signals } from "../../signals/signals.js";
+export declare function buildSignalSubscribeTool(signals: Signals): ToolDefinition;
+//# sourceMappingURL=signalSubscribeToolBuild.d.ts.map