@project-ava-supernova/core 0.2.71

package/dist/tools/curator.d.ts

@@ -0,0 +1,34 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Curator Tool — on-demand taste specialist.
+ *
+ * When the calling agent hits a subjective design decision it doesn't have
+ * clear guidance on (palette choice, typography selection, voice tone, visual
+ * hierarchy, etc.), it calls this tool with the question. The tool spawns a
+ * **fresh Curator agent** in an isolated context containing only:
+ *
+ *   - The Curator persona prompt
+ *   - The project's Decisions/design/ folder contents (if present)
+ *   - The user's relevant taste memory (pulled via memory_recall)
+ *   - The specific design question being asked
+ *
+ * Critically, the Curator does NOT see the calling agent's conversation,
+ * stack traces, build errors, or task churn. Her attention budget is fully
+ * available for the one taste decision. This is the architectural fix for
+ * "flustered design degradation" — the observation that design quality drops
+ * under cognitive load because the agent's attention is saturated with
+ * firefighting. A fresh-context specialist never sees the fire.
+ *
+ * The Curator runs one-shot and returns her decision + reasoning. The
+ * calling agent applies the decision and continues its task.
+ */
+export declare class CuratorTool implements Tool {
+    readonly name = "curator";
+    readonly description = "Consult the Curator specialist for a design or taste decision";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=curator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"curator.d.ts","sourceRoot":"","sources":["../../src/tools/curator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,uBAAuB,CAAC;AAUtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,YAAW,IAAI;IACtC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,mEAAmE;IACvF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CA6B7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA6GjG"}

package/dist/tools/curator.js

@@ -0,0 +1,191 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getTextContent } from '../core/types.js';
+import { CURATOR } from '../personas/definitions.js';
+import { Agent } from '../agent/agent.js';
+import { Conversation } from '../agent/conversation.js';
+import { logger } from '../core/logger.js';
+/**
+ * Curator Tool — on-demand taste specialist.
+ *
+ * When the calling agent hits a subjective design decision it doesn't have
+ * clear guidance on (palette choice, typography selection, voice tone, visual
+ * hierarchy, etc.), it calls this tool with the question. The tool spawns a
+ * **fresh Curator agent** in an isolated context containing only:
+ *
+ *   - The Curator persona prompt
+ *   - The project's Decisions/design/ folder contents (if present)
+ *   - The user's relevant taste memory (pulled via memory_recall)
+ *   - The specific design question being asked
+ *
+ * Critically, the Curator does NOT see the calling agent's conversation,
+ * stack traces, build errors, or task churn. Her attention budget is fully
+ * available for the one taste decision. This is the architectural fix for
+ * "flustered design degradation" — the observation that design quality drops
+ * under cognitive load because the agent's attention is saturated with
+ * firefighting. A fresh-context specialist never sees the fire.
+ *
+ * The Curator runs one-shot and returns her decision + reasoning. The
+ * calling agent applies the decision and continues its task.
+ */
+export class CuratorTool {
+    name = 'curator';
+    description = 'Consult the Curator specialist for a design or taste decision';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'curator',
+        description: 'Consult the Curator specialist for a design or taste decision. Use this when ' +
+            'you need to choose a colour, font, spacing, visual hierarchy, voice tone, layout ' +
+            'pattern, component shape, motion character, empty-state treatment, or anything ' +
+            'where the right answer is subjective and taste-driven rather than a technical ' +
+            'correctness question. The Curator runs in a fresh context isolated from the ' +
+            'current conversation — her attention is fully focused on the taste decision. ' +
+            'She reads the project\'s Decisions/design/ folder, recalls the user\'s taste ' +
+            'patterns from memory, and returns a decision with reasoning. Do NOT use for ' +
+            'logic, data, auth, or performance questions — those are not taste decisions.',
+        parameters: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'The specific design question you need answered. Be precise. ' +
+                        'Example: "What accent colour should I use for the primary CTA button on the hero section of a portfolio site for a full-stack developer? The base palette is already dark with a cool undertone."',
+                },
+                context: {
+                    type: 'string',
+                    description: 'Optional context about where this decision lives in the UI, which file you\'re working on, and what constraints exist. Keep it tight — the Curator wants the decision question, not the whole task history.',
+                },
+            },
+            required: ['question'],
+        },
+    };
+    async execute(args, context) {
+        const question = args.question;
+        if (!question || typeof question !== 'string') {
+            return {
+                success: false,
+                output: 'curator tool requires a "question" parameter — the specific design question you need answered.',
+            };
+        }
+        const extraContext = args.context ?? '';
+        // ── Resolve provider + model from sharedState ─────────────────────────
+        const sharedState = context.sharedState;
+        const provider = sharedState?.activeProvider;
+        const model = sharedState?.activeModel;
+        const toolRegistry = sharedState?.toolRegistry;
+        if (!provider || !model || !toolRegistry) {
+            return {
+                success: false,
+                output: 'Curator unavailable: missing activeProvider/activeModel/toolRegistry in shared state. ' +
+                    'Fallback: answer the design question yourself, consulting Decisions/design/*.md directly.',
+            };
+        }
+        // ── Load Decisions/design/ folder contents ────────────────────────────
+        const designContext = await loadDesignContext(context.cwd);
+        // ── Build the Curator's fresh context prompt ──────────────────────────
+        // The prompt is intentionally isolated — no chat history, no task brief,
+        // no stack traces. Just persona + design context + the question.
+        const systemPrompt = [
+            CURATOR.prompt,
+            '',
+            '## Project design direction',
+            designContext.length > 0
+                ? designContext
+                : '_No Decisions/design folder found for this project. Use your judgement, grounded in the user\'s taste memory if available._',
+        ].join('\n');
+        const userMessage = extraContext
+            ? `**Context:** ${extraContext}\n\n**Question:** ${question}`
+            : question;
+        logger.debug(`[curator] Spawning fresh specialist for question: ${question.slice(0, 80)}...`);
+        // ── Spawn a fresh Agent with the Curator's prompt ─────────────────────
+        // The Curator shares the same tool registry and sharedState as the caller
+        // — she needs file_read, memory_recall, and (optionally) file_write to
+        // record decisions in Decisions/. The prompt enforces her scope: she
+        // MUST NOT call the curator tool recursively or write outside Decisions/.
+        const curatorAgent = new Agent({
+            provider,
+            model,
+            toolRegistry,
+            cwd: context.cwd,
+            sharedState: context.sharedState,
+        });
+        const conversation = new Conversation();
+        conversation.setSystemPrompt(systemPrompt);
+        conversation.addUserMessage(userMessage);
+        // ── Run one-shot (silent event handler — the caller doesn't need to see
+        // every internal tool call the Curator makes; those would clutter the
+        // main timeline. We just want the final decision text.) ───────────────
+        const silentHandler = () => { };
+        try {
+            const signal = context.signal;
+            const messages = await curatorAgent.run(conversation.getMessages(), silentHandler, signal);
+            // Extract the last assistant message — that's the decision.
+            const lastAssistant = [...messages].reverse().find(m => m.role === 'assistant');
+            if (!lastAssistant) {
+                return {
+                    success: false,
+                    output: 'Curator returned no response. Fallback: answer the design question yourself, consulting Decisions/design/*.md directly.',
+                };
+            }
+            const decision = getTextContent(lastAssistant.content);
+            if (!decision.trim()) {
+                return {
+                    success: false,
+                    output: 'Curator returned an empty response. Fallback: answer the design question yourself.',
+                };
+            }
+            logger.debug(`[curator] Decision returned (${decision.length} chars)`);
+            return {
+                success: true,
+                output: `**Curator's decision:**\n\n${decision}`,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.debug(`[curator] Specialist run failed: ${message}`);
+            return {
+                success: false,
+                output: `Curator specialist failed: ${message}. Fallback: answer the design question yourself, consulting Decisions/design/*.md directly.`,
+            };
+        }
+    }
+}
+/**
+ * Load the contents of `Decisions/design/*.md` for the given project.
+ * Returns a concatenated string suitable for injection into a system prompt.
+ * Returns empty string if no Decisions folder or no design files exist.
+ */
+async function loadDesignContext(projectRoot) {
+    const designDir = join(projectRoot, 'Decisions', 'design');
+    const files = ['palette.md', 'typography.md', 'voice.md', 'assets.md'];
+    const parts = [];
+    for (const file of files) {
+        try {
+            const content = await readFile(join(designDir, file), 'utf-8');
+            const trimmed = content.trim();
+            if (trimmed) {
+                parts.push(`### Decisions/design/${file}\n${trimmed}`);
+            }
+        }
+        catch {
+            /* file doesn't exist — skip */
+        }
+    }
+    // Also include overview/context for project-level framing
+    const overviewFiles = ['overview.md', 'context.md'];
+    for (const file of overviewFiles) {
+        try {
+            const content = await readFile(join(projectRoot, 'Decisions', file), 'utf-8');
+            const trimmed = content.trim();
+            if (trimmed) {
+                parts.unshift(`### Decisions/${file}\n${trimmed}`);
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=curator.js.map

package/dist/tools/curator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curator.js","sourceRoot":"","sources":["../../src/tools/curator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAAG,+DAA+D,CAAC;IAC9E,SAAS,GAAkB,MAAM,CAAC;IAClC,oBAAoB,GAAG,KAAK,CAAC;IAE7B,MAAM,GAAmB;QAChC,IAAI,EAAE,SAAS;QACf,WAAW,EACT,+EAA+E;YAC/E,mFAAmF;YACnF,iFAAiF;YACjF,gFAAgF;YAChF,8EAA8E;YAC9E,+EAA+E;YAC/E,+EAA+E;YAC/E,8EAA8E;YAC9E,8EAA8E;QAChF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,8DAA8D;wBAC9D,mMAAmM;iBACtM;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,6MAA6M;iBAChN;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAA6B;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAkB,CAAC;QACzC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,gGAAgG;aACzG,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAI,IAAI,CAAC,OAA8B,IAAI,EAAE,CAAC;QAEhE,yEAAyE;QACzE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAkD,CAAC;QAC/E,MAAM,QAAQ,GAAG,WAAW,EAAE,cAAsC,CAAC;QACrE,MAAM,KAAK,GAAG,WAAW,EAAE,WAA0C,CAAC;QACtE,MAAM,YAAY,GAAG,WAAW,EAAE,YAAwC,CAAC;QAE3E,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EACJ,wFAAwF;oBACxF,2FAA2F;aAC9F,CAAC;QACJ,CAAC;QAED,yEAAyE;QACzE,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE3D,yEAAyE;QACzE,yEAAyE;QACzE,iEAAiE;QACjE,MAAM,YAAY,GAAG;YACnB,OAAO,CAAC,MAAM;YACd,EAAE;YACF,6BAA6B;YAC7B,aAAa,CAAC,MAAM,GAAG,CAAC;gBACtB,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,6HAA6H;SAClI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,WAAW,GAAG,YAAY;YAC9B,CAAC,CAAC,gBAAgB,YAAY,qBAAqB,QAAQ,EAAE;YAC7D,CAAC,CAAC,QAAQ,CAAC;QAEb,MAAM,CAAC,KAAK,CAAC,qDAAqD,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QAE9F,yEAAyE;QACzE,0EAA0E;QAC1E,uEAAuE;QACvE,qEAAqE;QACrE,0EAA0E;QAC1E,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC;YAC7B,QAAQ;YACR,KAAK;YACL,YAAY;YACZ,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACxC,YAAY,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAC3C,YAAY,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAEzC,yEAAyE;QACzE,sEAAsE;QACtE,wEAAwE;QACxE,MAAM,aAAa,GAAsB,GAAG,EAAE,GAAkB,CAAC,CAAC;QAElE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CACrC,YAAY,CAAC,WAAW,EAAE,EAC1B,aAAa,EACb,MAAM,CACP,CAAC;YAEF,4DAA4D;YAC5D,MAAM,aAAa,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;YAChF,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,yHAAyH;iBAClI,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAEvD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,oFAAoF;iBAC7F,CAAC;YACJ,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,SAAS,CAAC,CAAC;YAEvE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,8BAA8B,QAAQ,EAAE;aACjD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,CAAC,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,8BAA8B,OAAO,6FAA6F;aAC3I,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,CAAC,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,wBAAwB,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,OAAO,CAAC,iBAAiB,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/tools/database-query.d.ts

@@ -0,0 +1,11 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class DatabaseQueryTool implements Tool {
+    readonly name = "database_query";
+    readonly description = "Run read-only SQL queries against PostgreSQL, SQLite, or MySQL databases";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=database-query.d.ts.map

package/dist/tools/database-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-query.d.ts","sourceRoot":"","sources":["../../src/tools/database-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAsI5D,qBAAa,iBAAkB,YAAW,IAAI;IAC5C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,8EAA8E;IAClG,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAe;IAChD,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAyB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAyEjG"}

package/dist/tools/database-query.js

@@ -0,0 +1,228 @@
+import { createRequire } from 'node:module';
+const MAX_OUTPUT_LENGTH = 30_000;
+const MAX_ROWS = 100;
+const CONNECT_TIMEOUT_MS = 5_000;
+const QUERY_TIMEOUT_MS = 15_000;
+/** Read-only query prefixes. */
+const ALLOWED_PREFIXES = new Set(['SELECT', 'SHOW', 'DESCRIBE', 'EXPLAIN', 'PRAGMA', 'WITH']);
+/** Write keywords that must never appear anywhere in the query. */
+const WRITE_KEYWORDS = /\b(INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE|GRANT|REVOKE|REPLACE|MERGE|CALL|EXEC)\b/i;
+function isReadOnlyQuery(query) {
+    // Strip block comments
+    const stripped = query.trim().replace(/\/\*[\s\S]*?\*\//g, '').trim();
+    const firstWord = stripped.split(/\s+/)[0]?.toUpperCase();
+    if (!firstWord || !ALLOWED_PREFIXES.has(firstWord))
+        return false;
+    if (WRITE_KEYWORDS.test(stripped))
+        return false;
+    return true;
+}
+function resolveConnectionString(provided) {
+    if (provided)
+        return provided;
+    return process.env.DATABASE_URL || process.env.POSTGRES_URL ||
+        process.env.MYSQL_URL || process.env.SQLITE_PATH;
+}
+function detectDbType(connStr) {
+    if (connStr.startsWith('postgres://') || connStr.startsWith('postgresql://'))
+        return 'postgres';
+    if (connStr.startsWith('mysql://'))
+        return 'mysql';
+    if (connStr.startsWith('sqlite://') || connStr.startsWith('sqlite:') || connStr.endsWith('.sqlite') ||
+        connStr.endsWith('.sqlite3') || connStr.endsWith('.db'))
+        return 'sqlite';
+    return null;
+}
+function formatTable(columns, rows) {
+    if (columns.length === 0)
+        return '(no columns)';
+    const truncatedRows = rows.slice(0, MAX_ROWS);
+    // Calculate column widths
+    const widths = columns.map((col, i) => {
+        const values = truncatedRows.map(r => String(r[i] ?? 'NULL'));
+        return Math.min(Math.max(col.length, ...values.map(v => v.length)), 50);
+    });
+    const header = columns.map((c, i) => c.padEnd(widths[i])).join(' | ');
+    const separator = widths.map(w => '-'.repeat(w)).join('-+-');
+    const dataRows = truncatedRows.map(row => row.map((v, i) => {
+        const s = String(v ?? 'NULL');
+        return (s.length > 50 ? s.slice(0, 47) + '...' : s).padEnd(widths[i]);
+    }).join(' | '));
+    let output = `${header}\n${separator}\n${dataRows.join('\n')}`;
+    output += `\n(${rows.length} row${rows.length === 1 ? '' : 's'})`;
+    if (rows.length > MAX_ROWS)
+        output += ` — showing first ${MAX_ROWS}`;
+    return output;
+}
+async function queryPostgres(connStr, query) {
+    let pg;
+    try {
+        // @ts-expect-error — pg is an optional peer dependency, only loaded at runtime
+        pg = await import('pg');
+    }
+    catch {
+        throw new Error('pg is not installed. Install it with: npm install pg');
+    }
+    const Client = pg.default?.Client || pg.Client;
+    const client = new Client({ connectionString: connStr, connectionTimeoutMillis: CONNECT_TIMEOUT_MS });
+    await client.connect();
+    try {
+        await client.query('SET SESSION CHARACTERISTICS AS TRANSACTION READ ONLY');
+        await client.query('SET statement_timeout = $1', [QUERY_TIMEOUT_MS]);
+        const result = await client.query(query);
+        return {
+            columns: result.fields?.map((f) => f.name) ?? [],
+            rows: (result.rows ?? []).map((r) => Object.values(r)),
+        };
+    }
+    finally {
+        await client.end();
+    }
+}
+function querySqlite(dbPath, query, cwd) {
+    // better-sqlite3 is CJS-only — use createRequire
+    const require = createRequire(import.meta.url);
+    let Database;
+    try {
+        Database = require('better-sqlite3');
+    }
+    catch {
+        throw new Error('better-sqlite3 is not installed. Install it with: npm install better-sqlite3');
+    }
+    const { resolve, isAbsolute } = require('node:path');
+    const resolvedPath = isAbsolute(dbPath) ? dbPath : resolve(cwd, dbPath);
+    const db = new Database(resolvedPath, { readonly: true });
+    try {
+        db.pragma('query_only = ON');
+        const stmt = db.prepare(query);
+        const result = stmt.all();
+        if (!result || result.length === 0)
+            return { columns: [], rows: [] };
+        return {
+            columns: Object.keys(result[0]),
+            rows: result.map((r) => Object.values(r)),
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+async function queryMysql(connStr, query) {
+    let mysql;
+    try {
+        mysql = await import('mysql2/promise');
+    }
+    catch {
+        throw new Error('mysql2 is not installed. Install it with: npm install mysql2');
+    }
+    const createConnection = mysql.default?.createConnection || mysql.createConnection;
+    const conn = await createConnection({ uri: connStr, connectTimeout: CONNECT_TIMEOUT_MS });
+    try {
+        await conn.query('SET SESSION TRANSACTION READ ONLY');
+        const [rows, fields] = await conn.query({ sql: query, timeout: QUERY_TIMEOUT_MS });
+        return {
+            columns: fields?.map((f) => f.name) ?? [],
+            rows: rows.map((r) => Object.values(r)),
+        };
+    }
+    finally {
+        await conn.end();
+    }
+}
+export class DatabaseQueryTool {
+    name = 'database_query';
+    description = 'Run read-only SQL queries against PostgreSQL, SQLite, or MySQL databases';
+    riskLevel = 'dangerous';
+    requiresConfirmation = true;
+    schema = {
+        name: 'database_query',
+        description: 'Run a read-only SQL query against a database. Supports PostgreSQL, SQLite, and MySQL. ' +
+            'ONLY SELECT, SHOW, DESCRIBE, EXPLAIN, and PRAGMA queries are allowed — write operations are blocked. ' +
+            'Returns results formatted as a text table. Max 100 rows returned. ' +
+            'Connection string can be passed directly or read from DATABASE_URL environment variable. ' +
+            'Install the appropriate driver: pg (PostgreSQL), better-sqlite3 (SQLite), mysql2 (MySQL).',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The SQL query to execute. Must be read-only (SELECT, SHOW, DESCRIBE, EXPLAIN, PRAGMA).',
+                },
+                connection_string: {
+                    type: 'string',
+                    description: 'Database connection string. Examples: "postgres://user:pass@host:5432/db", ' +
+                        '"mysql://user:pass@host:3306/db", or a file path for SQLite ("/path/to/db.sqlite"). ' +
+                        'If omitted, checks DATABASE_URL, POSTGRES_URL, MYSQL_URL, or SQLITE_PATH environment variables.',
+                },
+            },
+            required: ['query'],
+        },
+    };
+    async execute(args, context) {
+        const query = args.query;
+        const providedConnStr = args.connection_string;
+        if (!query?.trim()) {
+            return { success: false, output: 'Query is required.' };
+        }
+        // Validate read-only
+        if (!isReadOnlyQuery(query)) {
+            return {
+                success: false,
+                output: 'Only read-only queries are allowed (SELECT, SHOW, DESCRIBE, EXPLAIN, PRAGMA, WITH). ' +
+                    'Write operations (INSERT, UPDATE, DELETE, DROP, etc.) are blocked.',
+            };
+        }
+        // Resolve connection string
+        const connStr = resolveConnectionString(providedConnStr);
+        if (!connStr) {
+            return {
+                success: false,
+                output: 'No connection string provided. Pass one via connection_string parameter or set ' +
+                    'DATABASE_URL, POSTGRES_URL, MYSQL_URL, or SQLITE_PATH environment variable.',
+            };
+        }
+        // Detect database type
+        const dbType = detectDbType(connStr);
+        if (!dbType) {
+            return {
+                success: false,
+                output: `Could not determine database type from connection string. ` +
+                    `Use postgres://, mysql://, or a .sqlite/.db file path.`,
+            };
+        }
+        try {
+            let result;
+            switch (dbType) {
+                case 'postgres':
+                    result = await queryPostgres(connStr, query);
+                    break;
+                case 'sqlite': {
+                    const { validatePath } = await import('./security.js');
+                    const dbPath = connStr.startsWith('sqlite://') ? connStr.slice(9) :
+                        connStr.startsWith('sqlite:') ? connStr.slice(7) : connStr;
+                    // Validate SQLite path stays within workspace/home to prevent path traversal
+                    validatePath(dbPath, context.cwd);
+                    result = querySqlite(dbPath, query, context.cwd);
+                    break;
+                }
+                case 'mysql':
+                    result = await queryMysql(connStr, query);
+                    break;
+            }
+            let output = formatTable(result.columns, result.rows);
+            if (output.length > MAX_OUTPUT_LENGTH) {
+                output = output.slice(0, MAX_OUTPUT_LENGTH) + '\n... (output truncated)';
+            }
+            return {
+                success: true,
+                output,
+                metadata: { dbType, rowCount: result.rows.length, columnCount: result.columns.length },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { success: false, output: `Database query failed: ${message}` };
+        }
+    }
+}
+//# sourceMappingURL=database-query.js.map

package/dist/tools/database-query.js.map

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

package/dist/tools/day-plan.d.ts

@@ -0,0 +1,27 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class DayPlanReadTool implements Tool {
+    readonly name = "day_plan_read";
+    readonly description = "Read the plan for a day \u2014 what was agreed, what has gone out, what has not. Call this before planning a day (items may already be there, carried from yesterday) and any time you need to know where the day stands.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DayPlanWriteTool implements Tool {
+    readonly name = "day_plan_write";
+    readonly description = "Write agreed items into a day's plan. Use it when the operator has DECIDED something goes out \u2014 not to record a suggestion. A story going to several platforms is several items sharing one group_id.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+export declare class DayPlanItemStatusTool implements Tool {
+    readonly name = "day_plan_item_status";
+    readonly description = "Change one plan item: done, dropped, or carried. Only mark done what you can actually verify \u2014 a post you watched publish. Anything the operator did by hand is theirs to tick.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=day-plan.d.ts.map

package/dist/tools/day-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"day-plan.d.ts","sourceRoot":"","sources":["../../src/tools/day-plan.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2C5D,qBAAa,eAAgB,YAAW,IAAI;IAC1C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,+NACqM;IAEzN,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAc7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoBjG;AAED,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,gNACuL;IAE3M,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CA2B7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAmCjG;AAED,qBAAa,qBAAsB,YAAW,IAAI;IAChD,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,WAAW,0LACgK;IAEpL,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAY7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAuBjG"}