daemora 1.0.0-alpha.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelCrew.d.ts","sourceRoot":"","sources":["../../../src/tools/core/parallelCrew.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;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,aAAa,IAAI,MAAM,CAAC;CACzB;AAOD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAC;AAEH,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,CAAC,CA0ClE"}

package/dist/tools/core/parallelCrew.js

@@ -0,0 +1,60 @@
+/**
+ * parallel_crew — fan out N independent tasks to different crews at once.
+ *
+ * Use when two (or more) tasks have no ordering dependency — e.g. "have
+ * the researcher find X while the reviewer checks Y". Returns one
+ * result per task, in the same order, with `ok:false` + error for any
+ * that failed without tearing down the siblings.
+ */
+import { z } from "zod";
+import { toDaemoraError } from "../../util/errors.js";
+const taskSchema = z.object({
+    crew: z.string().min(1),
+    task: z.string().min(1).max(20_000),
+});
+const inputSchema = z.object({
+    tasks: z.array(taskSchema).min(1).max(6).describe("Independent tasks to run in parallel. Max 6."),
+    maxSteps: z.number().int().min(1).max(30).optional().describe("Per-crew step budget. Default 15, max 30. Applies to every task in the batch. Omit unless tasks genuinely need more."),
+});
+export function makeParallelCrewTool(registry, runner, turn) {
+    return {
+        name: "parallel_crew",
+        description: "Run multiple independent crew tasks in parallel. Returns results in order. One task's failure doesn't affect the others.",
+        category: "agent",
+        source: { kind: "core" },
+        alwaysOn: true,
+        inputSchema,
+        async execute({ tasks, maxSteps }, { taskId, abortSignal }) {
+            const settled = await Promise.all(tasks.map(async (t) => {
+                if (!registry.has(t.crew)) {
+                    return {
+                        crewId: t.crew,
+                        ok: false,
+                        error: { code: "not_found", message: `Unknown crew: ${t.crew}` },
+                    };
+                }
+                try {
+                    const r = await runner.run({
+                        crewId: t.crew,
+                        task: t.task,
+                        parentTaskId: taskId,
+                        parentModelId: turn.resolvedModel(),
+                        ...(maxSteps ? { maxSteps } : {}),
+                        abortSignal,
+                    });
+                    return { crewId: r.crewId, ok: true, text: r.text };
+                }
+                catch (e) {
+                    const err = toDaemoraError(e);
+                    return {
+                        crewId: t.crew,
+                        ok: false,
+                        error: { code: err.code, message: err.message },
+                    };
+                }
+            }));
+            return { results: settled };
+        },
+    };
+}
+//# sourceMappingURL=parallelCrew.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelCrew.js","sourceRoot":"","sources":["../../../src/tools/core/parallelCrew.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAOtD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACjG,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,sHAAsH,CAAC;CACtL,CAAC,CAAC;AASH,MAAM,UAAU,oBAAoB,CAClC,QAAsB,EACtB,MAAuB,EACvB,IAAwB;IAExB,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0HAA0H;QAC5H,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;YACxD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAwB,EAAE;gBAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,OAAO;wBACL,MAAM,EAAE,CAAC,CAAC,IAAI;wBACd,EAAE,EAAE,KAAK;wBACT,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE;qBACjE,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC;wBACzB,MAAM,EAAE,CAAC,CAAC,IAAI;wBACd,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,YAAY,EAAE,MAAM;wBACpB,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE;wBACnC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjC,WAAW;qBACZ,CAAC,CAAC;oBACH,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACtD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;oBAC9B,OAAO;wBACL,MAAM,EAAE,CAAC,CAAC,IAAI;wBACd,EAAE,EAAE,KAAK;wBACT,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;qBAChD,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CACH,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * create_poll(question, options, ...) — create a poll in a channel.
+ *
+ * Only channels that override `sendPoll` support this (currently
+ * Telegram and Discord). For other channels the tool returns a clear
+ * error so the agent knows to fall back to a plain-text question.
+ *
+ * The agent must pass `channelId` and `chatId` explicitly because
+ * tools don't carry implicit channel context in TS (a cleaner contract
+ * than the JS version's RequestContext magic).
+ */
+import { z } from "zod";
+import type { ChannelManager } from "../../channels/ChannelManager.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    channelId: z.ZodString;
+    chatId: z.ZodString;
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodString, "many">;
+    durationHours: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    chatId: string;
+    options: string[];
+    channelId: string;
+    question: string;
+    durationHours: number;
+}, {
+    chatId: string;
+    options: string[];
+    channelId: string;
+    question: string;
+    durationHours?: number | undefined;
+}>;
+export declare function makePollTool(channels: ChannelManager): ToolDef<typeof inputSchema, unknown>;
+export {};
+//# sourceMappingURL=pollTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pollTool.d.ts","sourceRoot":"","sources":["../../../src/tools/core/pollTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;EAOf,CAAC;AAEH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,CAAC,CAgD3F"}

package/dist/tools/core/pollTool.js

@@ -0,0 +1,69 @@
+/**
+ * create_poll(question, options, ...) — create a poll in a channel.
+ *
+ * Only channels that override `sendPoll` support this (currently
+ * Telegram and Discord). For other channels the tool returns a clear
+ * error so the agent knows to fall back to a plain-text question.
+ *
+ * The agent must pass `channelId` and `chatId` explicitly because
+ * tools don't carry implicit channel context in TS (a cleaner contract
+ * than the JS version's RequestContext magic).
+ */
+import { z } from "zod";
+import { NotFoundError, ProviderError, ValidationError } from "../../util/errors.js";
+const inputSchema = z.object({
+    channelId: z.string().min(1).describe("Channel id, e.g. 'telegram', 'discord'."),
+    chatId: z.string().min(1).describe("Chat / room / channel id inside the provider."),
+    question: z.string().min(1).max(300),
+    options: z.array(z.string().min(1).max(100)).min(2).max(10)
+        .describe("2–10 poll options."),
+    durationHours: z.number().int().min(1).max(168).default(24),
+});
+export function makePollTool(channels) {
+    return {
+        name: "create_poll",
+        description: "Create a poll in a chat channel (supports Telegram / Discord). Requires channelId + chatId explicitly.",
+        category: "channel",
+        source: { kind: "core" },
+        tags: ["poll", "channel", "vote"],
+        inputSchema,
+        async execute(input, { logger }) {
+            const running = channels.runningSet();
+            if (!running.has(input.channelId)) {
+                throw new NotFoundError(`Channel '${input.channelId}' is not running. Running: ${[...running].join(", ") || "none"}`);
+            }
+            // Reach into the manager's private map via a typed accessor.
+            // We keep this contained so if the manager surface changes we
+            // only adjust this one tool.
+            const running2 = channels;
+            const channel = running2.running.get(input.channelId);
+            if (!channel)
+                throw new NotFoundError(`Channel '${input.channelId}' handle unavailable`);
+            const meta = {
+                channel: input.channelId,
+                userId: "",
+                chatId: input.chatId,
+            };
+            try {
+                await channel.sendPoll(meta, input.question, input.options, input.durationHours);
+                logger.info("poll created", { channelId: input.channelId, chatId: input.chatId, options: input.options.length });
+                return {
+                    channelId: input.channelId,
+                    chatId: input.chatId,
+                    question: input.question,
+                    options: input.options,
+                    durationHours: input.durationHours,
+                    message: `Poll created: "${input.question}" with ${input.options.length} options`,
+                };
+            }
+            catch (err) {
+                const msg = err.message;
+                if (msg.includes("does not support polls")) {
+                    throw new ValidationError(`Channel '${input.channelId}' doesn't support polls — ask the user inline instead.`);
+                }
+                throw new ProviderError(`Poll creation failed: ${msg}`, input.channelId);
+            }
+        },
+    };
+}
+//# sourceMappingURL=pollTool.js.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * project(action, ...) — multi-step project + task planning.
+ *
+ * The agent uses this to break large goals into ordered tasks, track
+ * what's done, and resume cleanly after a restart.
+ *
+ * Actions:
+ *   createProject   — new project, optionally seeded with tasks
+ *   listProjects    — all projects with task counts + status
+ *   getProject      — one project with its tasks
+ *   updateProject   — patch project fields (name, description, status)
+ *   deleteProject   — remove project + all tasks
+ *   addTask         — add a task to an existing project
+ *   updateTask      — change status / notes
+ *   deleteTask      — remove a task
+ */
+import { z } from "zod";
+import type { ProjectStore } from "../../projects/ProjectStore.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    action: z.ZodEnum<["createProject", "listProjects", "getProject", "updateProject", "deleteProject", "addTask", "updateTask", "deleteTask"]>;
+    projectId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    projectStatus: z.ZodOptional<z.ZodEnum<["in_progress", "completed", "abandoned"]>>;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["pending", "in_progress", "done", "failed", "skipped"]>>;
+    notes: z.ZodOptional<z.ZodString>;
+    tasks: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        description?: string | undefined;
+    }, {
+        title: string;
+        description?: string | undefined;
+    }>]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    action: "createProject" | "listProjects" | "getProject" | "updateProject" | "deleteProject" | "addTask" | "updateTask" | "deleteTask";
+    status?: "failed" | "skipped" | "pending" | "in_progress" | "done" | undefined;
+    description?: string | undefined;
+    taskId?: string | undefined;
+    projectId?: string | undefined;
+    title?: string | undefined;
+    name?: string | undefined;
+    notes?: string | undefined;
+    tasks?: (string | {
+        title: string;
+        description?: string | undefined;
+    })[] | undefined;
+    projectStatus?: "completed" | "in_progress" | "abandoned" | undefined;
+}, {
+    action: "createProject" | "listProjects" | "getProject" | "updateProject" | "deleteProject" | "addTask" | "updateTask" | "deleteTask";
+    status?: "failed" | "skipped" | "pending" | "in_progress" | "done" | undefined;
+    description?: string | undefined;
+    taskId?: string | undefined;
+    projectId?: string | undefined;
+    title?: string | undefined;
+    name?: string | undefined;
+    notes?: string | undefined;
+    tasks?: (string | {
+        title: string;
+        description?: string | undefined;
+    })[] | undefined;
+    projectStatus?: "completed" | "in_progress" | "abandoned" | undefined;
+}>;
+export declare function makeProjectTool(store: ProjectStore): ToolDef<typeof inputSchema, unknown>;
+export {};
+//# sourceMappingURL=projectTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectTracker.d.ts","sourceRoot":"","sources":["../../../src/tools/core/projectTracker.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;AAK3C,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBf,CAAC;AAUH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,CAAC,CA+HzF"}

package/dist/tools/core/projectTracker.js

@@ -0,0 +1,181 @@
+/**
+ * project(action, ...) — multi-step project + task planning.
+ *
+ * The agent uses this to break large goals into ordered tasks, track
+ * what's done, and resume cleanly after a restart.
+ *
+ * Actions:
+ *   createProject   — new project, optionally seeded with tasks
+ *   listProjects    — all projects with task counts + status
+ *   getProject      — one project with its tasks
+ *   updateProject   — patch project fields (name, description, status)
+ *   deleteProject   — remove project + all tasks
+ *   addTask         — add a task to an existing project
+ *   updateTask      — change status / notes
+ *   deleteTask      — remove a task
+ */
+import { z } from "zod";
+import { NotFoundError, ValidationError } from "../../util/errors.js";
+const taskStatus = z.enum(["pending", "in_progress", "done", "failed", "skipped"]);
+const projectStatus = z.enum(["in_progress", "completed", "abandoned"]);
+const inputSchema = z.object({
+    action: z.enum([
+        "createProject", "listProjects", "getProject", "updateProject", "deleteProject",
+        "addTask", "updateTask", "deleteTask",
+    ]),
+    projectId: z.string().optional(),
+    taskId: z.string().optional(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    projectStatus: projectStatus.optional(),
+    title: z.string().optional(),
+    status: taskStatus.optional(),
+    notes: z.string().optional(),
+    tasks: z.array(z.union([
+        z.string(),
+        z.object({ title: z.string(), description: z.string().optional() }),
+    ])).optional(),
+});
+const STATUS_ICON = {
+    pending: "⬜",
+    in_progress: "🔄",
+    done: "✅",
+    failed: "❌",
+    skipped: "⏭️",
+};
+export function makeProjectTool(store) {
+    return {
+        name: "project",
+        description: "Plan and track multi-step projects. Actions: createProject, listProjects, getProject, updateProject, deleteProject, addTask, updateTask, deleteTask.",
+        category: "agent",
+        source: { kind: "core" },
+        tags: ["project", "planning", "tasks"],
+        inputSchema,
+        async execute(input) {
+            switch (input.action) {
+                case "createProject": {
+                    if (!input.name)
+                        throw new ValidationError("name is required");
+                    const tasks = (input.tasks ?? []).map((t) => {
+                        if (typeof t === "string")
+                            return { title: t };
+                        return t.description === undefined
+                            ? { title: t.title }
+                            : { title: t.title, description: t.description };
+                    });
+                    const project = store.createProject({
+                        name: input.name,
+                        ...(input.description ? { description: input.description } : {}),
+                        tasks,
+                    });
+                    return {
+                        id: project.id,
+                        name: project.name,
+                        taskCount: tasks.length,
+                        message: `Project '${project.name}' created (${project.id.slice(0, 8)}) with ${tasks.length} task(s)`,
+                    };
+                }
+                case "listProjects": {
+                    return store.allProjects().map((p) => {
+                        const tasks = store.listProjectTasks(p.id);
+                        const byStatus = tasks.reduce((acc, t) => {
+                            acc[t.status] = (acc[t.status] ?? 0) + 1;
+                            return acc;
+                        }, {});
+                        return {
+                            id: p.id,
+                            name: p.name,
+                            status: p.status,
+                            taskCount: tasks.length,
+                            byStatus,
+                            updatedAt: new Date(p.updatedAt).toISOString(),
+                        };
+                    });
+                }
+                case "getProject": {
+                    if (!input.projectId)
+                        throw new ValidationError("projectId is required");
+                    const project = store.getProject(input.projectId);
+                    if (!project)
+                        throw new NotFoundError(`Project not found: ${input.projectId}`);
+                    const tasks = store.listProjectTasks(project.id);
+                    return {
+                        project: {
+                            ...project,
+                            createdAt: new Date(project.createdAt).toISOString(),
+                            updatedAt: new Date(project.updatedAt).toISOString(),
+                        },
+                        tasks: tasks.map((t) => ({
+                            id: t.id,
+                            position: t.position,
+                            title: t.title,
+                            description: t.description,
+                            status: t.status,
+                            icon: STATUS_ICON[t.status],
+                            notes: t.notes,
+                            updatedAt: new Date(t.updatedAt).toISOString(),
+                        })),
+                    };
+                }
+                case "updateProject": {
+                    if (!input.projectId)
+                        throw new ValidationError("projectId is required");
+                    const patch = {
+                        ...(input.name !== undefined ? { name: input.name } : {}),
+                        ...(input.description !== undefined ? { description: input.description } : {}),
+                        ...(input.projectStatus !== undefined ? { status: input.projectStatus } : {}),
+                    };
+                    const ok = store.updateProjectRow(input.projectId, patch);
+                    if (!ok)
+                        throw new NotFoundError(`Project not found: ${input.projectId}`);
+                    return { id: input.projectId, updated: true };
+                }
+                case "deleteProject": {
+                    if (!input.projectId)
+                        throw new ValidationError("projectId is required");
+                    const ok = store.deleteProjectRow(input.projectId);
+                    if (!ok)
+                        throw new NotFoundError(`Project not found: ${input.projectId}`);
+                    return { id: input.projectId, removed: true };
+                }
+                case "addTask": {
+                    if (!input.projectId)
+                        throw new ValidationError("projectId is required");
+                    if (!input.title)
+                        throw new ValidationError("title is required");
+                    const project = store.getProject(input.projectId);
+                    if (!project)
+                        throw new NotFoundError(`Project not found: ${input.projectId}`);
+                    const task = store.addTask(input.projectId, {
+                        title: input.title,
+                        ...(input.description ? { description: input.description } : {}),
+                    });
+                    return { id: task.id, projectId: task.projectId, title: task.title, position: task.position };
+                }
+                case "updateTask": {
+                    if (!input.taskId)
+                        throw new ValidationError("taskId is required");
+                    const patch = {
+                        ...(input.title !== undefined ? { title: input.title } : {}),
+                        ...(input.description !== undefined ? { description: input.description } : {}),
+                        ...(input.status !== undefined ? { status: input.status } : {}),
+                        ...(input.notes !== undefined ? { notes: input.notes } : {}),
+                    };
+                    const ok = store.updateTaskRow(input.taskId, patch);
+                    if (!ok)
+                        throw new NotFoundError(`Task not found: ${input.taskId}`);
+                    return { id: input.taskId, updated: true };
+                }
+                case "deleteTask": {
+                    if (!input.taskId)
+                        throw new ValidationError("taskId is required");
+                    const ok = store.deleteTaskRow(input.taskId);
+                    if (!ok)
+                        throw new NotFoundError(`Task not found: ${input.taskId}`);
+                    return { id: input.taskId, removed: true };
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=projectTracker.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import type { FilesystemGuard } from "../../safety/FilesystemGuard.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    path: z.ZodString;
+    /** Optional read window for large files. */
+    startLine: z.ZodOptional<z.ZodNumber>;
+    endLine: z.ZodOptional<z.ZodNumber>;
+    /** Hard cap so an LLM can't blow context by reading a huge file. */
+    maxBytes: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    maxBytes: number;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+}, {
+    path: string;
+    maxBytes?: number | undefined;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+}>;
+export declare function makeReadFileTool(guard: FilesystemGuard): ToolDef<typeof inputSchema, string>;
+export {};
+//# sourceMappingURL=readFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readFile.d.ts","sourceRoot":"","sources":["../../../src/tools/core/readFile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;IAEf,4CAA4C;;;IAG5C,oEAAoE;;;;;;;;;;;;EAEpE,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE,MAAM,CAAC,CAqC5F"}

package/dist/tools/core/readFile.js

@@ -0,0 +1,49 @@
+import { readFile, stat } from "node:fs/promises";
+import { z } from "zod";
+import { NotFoundError, PermissionDeniedError, ValidationError } from "../../util/errors.js";
+const inputSchema = z.object({
+    path: z.string().min(1).describe("Absolute or workspace-relative file path"),
+    /** Optional read window for large files. */
+    startLine: z.number().int().min(1).optional().describe("1-based start line, optional"),
+    endLine: z.number().int().min(1).optional().describe("1-based end line (inclusive), optional"),
+    /** Hard cap so an LLM can't blow context by reading a huge file. */
+    maxBytes: z.number().int().positive().max(1_000_000).default(200_000),
+});
+export function makeReadFileTool(guard) {
+    return {
+        name: "read_file",
+        description: "Read a text file. Use startLine/endLine for large files. 200 KB hard cap by default.",
+        category: "filesystem",
+        source: { kind: "core" },
+        alwaysOn: true,
+        inputSchema,
+        async execute({ path, startLine, endLine, maxBytes }) {
+            const canonical = guard.ensureAllowed(path, "read");
+            let s;
+            try {
+                s = await stat(canonical);
+            }
+            catch (e) {
+                const err = e;
+                if (err.code === "ENOENT")
+                    throw new NotFoundError(`File not found: ${canonical}`);
+                if (err.code === "EACCES")
+                    throw new PermissionDeniedError(`Read denied: ${canonical}`);
+                throw err;
+            }
+            if (!s.isFile())
+                throw new ValidationError(`Not a file: ${canonical}`);
+            if (s.size > maxBytes && !startLine && !endLine) {
+                throw new ValidationError(`File ${canonical} is ${s.size} bytes — exceeds maxBytes (${maxBytes}). Pass startLine/endLine to read a window.`);
+            }
+            const raw = await readFile(canonical, "utf-8");
+            if (startLine === undefined && endLine === undefined)
+                return raw;
+            const lines = raw.split("\n");
+            const a = Math.max(0, (startLine ?? 1) - 1);
+            const b = Math.min(lines.length, endLine ?? lines.length);
+            return lines.slice(a, b).join("\n");
+        },
+    };
+}
+//# sourceMappingURL=readFile.js.map

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

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

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

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import type { ModelRouter } from "../../models/ModelRouter.js";
+import type { FilesystemGuard } from "../../safety/FilesystemGuard.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    path: z.ZodString;
+    pages: z.ZodOptional<z.ZodString>;
+    method: z.ZodDefault<z.ZodEnum<["auto", "pdftotext", "model"]>>;
+    /**
+     * Optional model override — format `provider:model`. When omitted the
+     * tool uses whatever `DEFAULT_MODEL` is set to in Settings. We do NOT
+     * ship a hardcoded default here: model names age fast and every user
+     * should drive inference through the same model they picked for chat.
+     */
+    model: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    method: "model" | "auto" | "pdftotext";
+    path: string;
+    maxChars: number;
+    model?: string | undefined;
+    pages?: string | undefined;
+}, {
+    path: string;
+    method?: "model" | "auto" | "pdftotext" | undefined;
+    model?: string | undefined;
+    pages?: string | undefined;
+    maxChars?: number | undefined;
+}>;
+export declare function makeReadPDFTool(guard: FilesystemGuard, models: ModelRouter): ToolDef<typeof inputSchema, string>;
+export {};
+//# sourceMappingURL=readPDF.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readPDF.d.ts","sourceRoot":"","sources":["../../../src/tools/core/readPDF.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,QAAA,MAAM,WAAW;;;;IAKf;;;;;OAKG;;;;;;;;;;;;;;;EAIH,CAAC;AAEH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,WAAW,EAAE,MAAM,CAAC,CA4ErC"}