@project-ava-supernova/core 0.2.71

package/dist/auto/task-executor.d.ts

@@ -0,0 +1,86 @@
+import type { Provider } from '../providers/types.js';
+import type { ModelDefinition } from '../core/types.js';
+import type { ToolRegistry } from '../tools/tool-registry.js';
+import type { TaskManager } from '../tasks/task-manager.js';
+import type { AgentEventHandler } from '../agent/agent.js';
+import { Agent } from '../agent/agent.js';
+/**
+ * TaskExecutor — the second leg of Auto Mode.
+ *
+ * After the conductor model has called present_plan and todo_write, this class
+ * picks up the pending session tasks and dispatches a fresh Builder Agent for
+ * each one. Each Builder gets its own clean context window containing only the
+ * task description, the plan context, and the full task list — not the
+ * conversation history. This is the JARVIS-style hand-off: Ava plans, Builder
+ * executes.
+ *
+ * The executor is intentionally serial for v1 — tasks usually have implicit
+ * dependencies even when not declared. Parallel execution comes later with a
+ * proper dependency graph.
+ *
+ * On the first blocker the executor stops and surfaces a clear message via
+ * events. The user decides whether to retry, give guidance, or abort.
+ */
+export interface TaskExecutorOptions {
+    provider: Provider;
+    model: ModelDefinition;
+    toolRegistry: ToolRegistry;
+    taskManager: TaskManager;
+    cwd: string;
+    sharedState: Record<string, unknown>;
+    /**
+     * Called whenever a Builder Agent starts (passed the agent) or ends
+     * (passed null). AutoCoordinator uses this to forward user inject()
+     * calls into the currently-running Builder.
+     */
+    onActiveAgentChange?: (agent: Agent | null) => void;
+    /**
+     * The same base-prompt options the main agent is built with. Threaded
+     * through so the Builder sub-agent inherits the full base prompt — every
+     * rule, the trust boundary, code craft, verified-done discipline and the
+     * completion contract — instead of the thin standalone prompt it used
+     * before. The Decisions-folder fields (context / exists / opt-in) live in
+     * here too and are rendered by buildSystemPrompt.
+     */
+    systemPromptOpts?: Record<string, unknown>;
+}
+export interface TaskExecutionResult {
+    totalTasks: number;
+    completed: number;
+    blocked: number;
+    blockerMessage?: string;
+    summary: string;
+    /**
+     * The union of all files the completed Builders declared in their
+     * <changes-summary> blocks. AutoCoordinator runs a single integration
+     * verification pass over this set once execution finishes clean.
+     */
+    changedFiles: string[];
+}
+export declare class TaskExecutor {
+    private readonly provider;
+    private readonly model;
+    private readonly toolRegistry;
+    private readonly taskManager;
+    private readonly cwd;
+    private readonly sharedState;
+    private readonly onActiveAgentChange?;
+    private readonly systemPromptOpts;
+    constructor(opts: TaskExecutorOptions);
+    /**
+     * Execute every pending session task using a fresh Builder agent per task.
+     * Pauses on the first blocker and persists session tasks to disk so the work
+     * survives a window close.
+     */
+    executeAll(planContext: string, onEvent: AgentEventHandler, signal?: AbortSignal): Promise<TaskExecutionResult>;
+    /**
+     * Run a single task with a fresh Builder Agent.
+     * The Agent gets a clean conversation containing only the task framing —
+     * not the main chat history — so context stays focused and cheap.
+     */
+    private executeTask;
+    private buildBuilderSystemPrompt;
+    private lastAssistantText;
+    private shorten;
+}
+//# sourceMappingURL=task-executor.d.ts.map

package/dist/auto/task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/auto/task-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAW,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAM1C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAgC;IACrE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;gBAE/C,IAAI,EAAE,mBAAmB;IAWrC;;;;OAIG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC;IA4G/B;;;;OAIG;YACW,WAAW;IA0EzB,OAAO,CAAC,wBAAwB;IA8DhC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,OAAO;CAIhB"}

package/dist/auto/task-executor.js

@@ -0,0 +1,271 @@
+import { Agent } from '../agent/agent.js';
+import { Conversation } from '../agent/conversation.js';
+import { buildSystemPrompt } from '../agent/system-prompt.js';
+import { extractChangesSummary } from './changes-summary.js';
+import { logger } from '../core/logger.js';
+export class TaskExecutor {
+    provider;
+    model;
+    toolRegistry;
+    taskManager;
+    cwd;
+    sharedState;
+    onActiveAgentChange;
+    systemPromptOpts;
+    constructor(opts) {
+        this.provider = opts.provider;
+        this.model = opts.model;
+        this.toolRegistry = opts.toolRegistry;
+        this.taskManager = opts.taskManager;
+        this.cwd = opts.cwd;
+        this.sharedState = opts.sharedState;
+        this.onActiveAgentChange = opts.onActiveAgentChange;
+        this.systemPromptOpts = opts.systemPromptOpts ?? {};
+    }
+    /**
+     * Execute every pending session task using a fresh Builder agent per task.
+     * Pauses on the first blocker and persists session tasks to disk so the work
+     * survives a window close.
+     */
+    async executeAll(planContext, onEvent, signal) {
+        const allTasks = this.taskManager.getSessionTasks();
+        const pending = allTasks.filter(t => t.status === 'todo');
+        if (pending.length === 0) {
+            return { totalTasks: 0, completed: 0, blocked: 0, summary: 'No pending tasks to execute.', changedFiles: [] };
+        }
+        logger.debug(`[task-executor] Starting execution of ${pending.length} tasks`);
+        onEvent({ type: 'execution_start', total: pending.length });
+        let completed = 0;
+        let blocked = 0;
+        let blockerMessage;
+        const summaries = [];
+        // Union of files touched across all completed tasks, for the integration pass
+        const changedFiles = new Set();
+        for (let i = 0; i < pending.length; i++) {
+            if (signal?.aborted) {
+                logger.debug('[task-executor] Aborted by signal');
+                break;
+            }
+            const task = pending[i];
+            logger.debug(`[task-executor] Task ${i + 1}/${pending.length}: ${task.title}`);
+            // Mark in-progress before dispatching the Builder
+            this.taskManager.updateSessionTask(task.id, 'in-progress');
+            onEvent({
+                type: 'task_start',
+                taskId: task.id,
+                title: task.title,
+                index: i,
+                total: pending.length,
+            });
+            try {
+                const outcome = await this.executeTask(task, planContext, allTasks, i, onEvent, signal);
+                if (outcome.success) {
+                    this.taskManager.updateSessionTask(task.id, 'done');
+                    completed++;
+                    for (const f of outcome.files ?? [])
+                        changedFiles.add(f);
+                    summaries.push(`✓ ${task.title}${outcome.summary ? ` — ${outcome.summary}` : ''}`);
+                    onEvent({
+                        type: 'task_complete',
+                        taskId: task.id,
+                        title: task.title,
+                        summary: outcome.summary,
+                    });
+                }
+                else {
+                    this.taskManager.updateSessionTask(task.id, 'blocked');
+                    blocked++;
+                    blockerMessage = outcome.summary || `Task "${task.title}" was blocked.`;
+                    summaries.push(`⛔ ${task.title} — ${blockerMessage}`);
+                    onEvent({
+                        type: 'task_blocked',
+                        taskId: task.id,
+                        title: task.title,
+                        reason: blockerMessage,
+                    });
+                    // Pause on first blocker so we don't waste tokens or compound errors
+                    break;
+                }
+            }
+            catch (err) {
+                this.taskManager.updateSessionTask(task.id, 'blocked');
+                blocked++;
+                const errMsg = err instanceof Error ? err.message : String(err);
+                blockerMessage = `Task "${task.title}" failed: ${errMsg}`;
+                summaries.push(`⛔ ${task.title} — ${errMsg}`);
+                onEvent({
+                    type: 'task_failed',
+                    taskId: task.id,
+                    title: task.title,
+                    error: errMsg,
+                });
+                break;
+            }
+        }
+        onEvent({
+            type: 'execution_complete',
+            completed,
+            blocked,
+            total: pending.length,
+        });
+        // Flush session tasks to disk so progress survives a reload
+        try {
+            await this.taskManager.flushSessionTasks();
+        }
+        catch (err) {
+            logger.debug(`[task-executor] flushSessionTasks failed: ${err}`);
+        }
+        const headline = blocked > 0
+            ? `Executed ${completed}/${pending.length} tasks. ${blocked} blocked.`
+            : `Executed all ${completed} tasks successfully.`;
+        return {
+            totalTasks: pending.length,
+            completed,
+            blocked,
+            blockerMessage,
+            summary: [headline, '', ...summaries].join('\n'),
+            changedFiles: [...changedFiles],
+        };
+    }
+    /**
+     * Run a single task with a fresh Builder Agent.
+     * The Agent gets a clean conversation containing only the task framing —
+     * not the main chat history — so context stays focused and cheap.
+     */
+    async executeTask(task, planContext, allTasks, currentIndex, onEvent, signal) {
+        const conversation = new Conversation();
+        conversation.setSystemPrompt(this.buildBuilderSystemPrompt());
+        const taskList = allTasks
+            .map((t, idx) => {
+            const marker = idx === currentIndex ? ' ← YOU ARE HERE' : '';
+            return `${idx + 1}. [${t.status}] ${t.title}${marker}`;
+        })
+            .join('\n');
+        const taskMessage = [
+            planContext ? `## Plan context\n${planContext}\n` : '',
+            `## Full task list`,
+            taskList,
+            ``,
+            `## Your job`,
+            `Execute task ${currentIndex + 1}: **${task.title}**`,
+            ``,
+            `Use the execution tools (file_write, file_edit, bash, git_commit, test_run, etc.) ` +
+                `to complete THIS task. Do not work on other tasks — they will be dispatched separately.`,
+            ``,
+            `When the task is genuinely complete, write a one-paragraph summary of what you did and stop. ` +
+                `Do not call any more tools after the summary.`,
+            ``,
+            `If you hit a real blocker that needs the user to decide something, start your final response ` +
+                `with "BLOCKED:" followed by a clear explanation of what's stopping you and what you need.`,
+        ].filter(Boolean).join('\n');
+        conversation.addUserMessage(taskMessage);
+        // Fresh Agent instance — fresh context window, focused on this task only
+        const builderAgent = new Agent({
+            provider: this.provider,
+            model: this.model,
+            toolRegistry: this.toolRegistry,
+            cwd: this.cwd,
+            sharedState: this.sharedState,
+        });
+        // Register the Builder as the active agent so AutoCoordinator's inject()
+        // forwards user mid-run messages here instead of into the dead coordinator
+        // queue.
+        this.onActiveAgentChange?.(builderAgent);
+        try {
+            const result = await builderAgent.run(conversation.getMessages(), onEvent, signal);
+            const lastAssistant = this.lastAssistantText(result);
+            if (lastAssistant && /^\s*BLOCKED:/i.test(lastAssistant.trim())) {
+                const reason = lastAssistant.replace(/^\s*BLOCKED:\s*/i, '').trim();
+                return { success: false, summary: reason || 'Builder reported a blocker without details.' };
+            }
+            const parsed = lastAssistant ? extractChangesSummary(lastAssistant) : null;
+            return {
+                success: true,
+                summary: lastAssistant ? this.shorten(lastAssistant, 240) : undefined,
+                files: parsed?.files,
+            };
+        }
+        catch (err) {
+            logger.debug(`[task-executor] Builder agent threw: ${err}`);
+            throw err;
+        }
+        finally {
+            this.onActiveAgentChange?.(null);
+        }
+    }
+    buildBuilderSystemPrompt() {
+        // The Builder sub-agent runs on the SAME base prompt as the main agent —
+        // every rule, the trust boundary, code craft, verified-done discipline and
+        // the completion contract — then layers the focused-sub-agent framing
+        // below. Previously this path used a thin standalone prompt that inherited
+        // none of that, so orchestrated builds ran under far less discipline than
+        // direct ones. systemPromptOpts is threaded from AutoCoordinator; the
+        // Decisions-folder block is built by buildSystemPrompt from those same
+        // opts, so it is not repeated here.
+        const base = buildSystemPrompt({
+            ...this.systemPromptOpts,
+            cwd: this.cwd,
+        });
+        return `${base}
+
+## You are the Builder, running as a focused sub-agent
+You've been spawned for a single task. You do NOT have the full chat history —
+the task description below contains everything you need. Execute the approved
+plan: build what was asked, match the codebase, verify your work, and finish.
+Stay focused on this one task.
+
+## Tools
+You have access to the full execution toolset: file_read, file_write, file_edit,
+glob, grep, list_directory, bash, git_status, git_diff, git_commit, test_run,
+todo_write, and the rest. Use them.
+
+## Curator — the on-demand taste specialist
+You have a \`curator\` tool for design and taste decisions. **Before calling it,
+first check Decisions/design/*.md** — the project's declared direction lives
+in those files. If \`palette.md\` already says the primary accent is a specific
+colour and you need a primary colour, just use it — no curator call needed.
+If \`voice.md\` already defines the tone and you need a button label, follow
+it directly. The Decisions folder is the first source of truth; curator is a
+specialist called when the answer genuinely isn't there.
+
+**Call curator when:**
+- You face a taste decision the Decisions folder doesn't cover (new component
+  type not mentioned in existing design docs, novel visual element, new asset
+  generation, a decision that requires reconciling conflicting precedents).
+- You're about to default to a generic pattern (\`bg-blue-500\`, \`text-gray-500\`,
+  system-default font) because nothing better comes to mind. That's the signal
+  that you need taste input you don't have — call curator.
+
+**Do NOT call curator when:**
+- The Decisions folder already answers the question directly.
+- The decision is logic, data shape, auth, state management, or performance.
+- The question is correctness rather than subjective judgement.
+- You can apply an existing project pattern with confidence.
+
+Curator runs in a fresh context isolated from error-fix churn, so her attention
+is fully on the decision. She's expensive to spawn — one decision per call,
+only when genuinely needed. A Builder that calls curator 10 times in a task is
+usually a Builder that didn't read the Decisions folder first.
+
+## Output discipline
+- The plan is already approved. Do not redesign. Do not propose alternatives.
+- When done: end with a one-paragraph summary of what you built, then the <changes-summary> block from the completion contract above. Stop.
+- When blocked: start your final response with "BLOCKED:" then explain clearly.
+- Do not narrate every tool call. Tools speak for themselves.`;
+    }
+    lastAssistantText(messages) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const m = messages[i];
+            if (m.role === 'assistant') {
+                return typeof m.content === 'string' ? m.content : null;
+            }
+        }
+        return null;
+    }
+    shorten(text, max) {
+        if (text.length <= max)
+            return text;
+        return text.slice(0, max - 1).trimEnd() + '…';
+    }
+}
+//# sourceMappingURL=task-executor.js.map

package/dist/auto/task-executor.js.map

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

package/dist/auto/types.d.ts

@@ -0,0 +1,57 @@
+import type { ModelDefinition } from '../core/types.js';
+import type { Provider } from '../providers/types.js';
+export type TaskCategory = 'coding' | 'vision' | 'image_gen' | 'planning' | 'chat' | 'long_context' | 'teach' | 'security' | 'brainstorm';
+export interface ClassificationResult {
+    category: TaskCategory;
+    /** Model ID to force-route to (from user inline override like "@kimi") */
+    modelOverride?: string;
+    /** Why this classification was chosen — for logging/debugging */
+    reason: string;
+}
+export interface RouteResult {
+    /** Qualified model ID e.g. 'platform:kimi-k3' */
+    modelId: string;
+    provider: Provider;
+    model: ModelDefinition;
+    /** Human-readable reason — "Best agentic coding model" */
+    reason: string;
+    /** Warning if routing is suboptimal — "No vision model available" */
+    warning?: string;
+}
+/** Per-category model preferences set by the user in settings */
+export type UserRoutePreferences = Partial<Record<TaskCategory, string>>;
+export interface TaskBrief {
+    /** The user's request */
+    task: string;
+    /** Summary of recent conversation (last few exchanges, truncated) */
+    context: string;
+    /** Relevant memories for this query */
+    relevantMemories: string;
+    /** Project instructions (CLAUDE.md, etc.) */
+    projectContext: string;
+    /** Model-specific constraints — context window, capabilities */
+    constraints: string;
+    /** File paths mentioned in recent messages */
+    files: string[];
+}
+export type AutoEvent = {
+    type: 'auto_routing';
+    category: TaskCategory;
+    model: string;
+    reason: string;
+} | {
+    type: 'auto_agent_start';
+    model: string;
+    category: TaskCategory;
+} | {
+    type: 'auto_agent_end';
+    model: string;
+    summary?: string;
+};
+export interface ContextThresholds {
+    /** Warning threshold (0-1), default 0.80 */
+    warning: number;
+    /** Critical threshold (0-1), default 0.90 */
+    critical: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auto/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auto/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,GACN,cAAc,GACd,OAAO,GACP,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;AAIzE,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAIhE,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/auto/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/auto/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/auto/types.ts"],"names":[],"mappings":""}

package/dist/awareness/tick-engine.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ══════════════════════════════════════════════════════════════════════
+ * Ava Tick Engine — Proactive Awareness System
+ * ══════════════════════════════════════════════════════════════════════
+ *
+ * Periodic background check that makes Ava continuously aware of the
+ * user's world — tasks, journal, memory, support, token balance — and
+ * surfaces findings only when they matter.
+ *
+ * She checks silently. If there's nothing worth saying, the user never
+ * knows. If there is, she speaks up gently.
+ *
+ * Inspired by concepts that a certain "AI safety" company accidentally
+ * published to npm because they forgot to add *.map to .npmignore.
+ * Cheers Anthropic — couldn't have done it without your generosity. 🍻
+ *
+ * Unlike theirs, this one ships openly. No feature flags. No stealth.
+ * No "undercover mode". Just transparency, as always.
+ *
+ * ══════════════════════════════════════════════════════════════════════
+ */
+export interface TickContext {
+    /** Check overdue/upcoming tasks */
+    getOverdueTasks?: () => Promise<Array<{
+        title: string;
+        dueDate?: string;
+        priority: string;
+    }>>;
+    /** Check journal streak */
+    getJournalStreak?: () => Promise<{
+        days: number;
+        writtenToday: boolean;
+    }>;
+    /** Check token balance */
+    getTokenBalance?: () => {
+        used: number;
+        limit: number;
+    } | null;
+    /** Check unread support messages */
+    getSupportUnread?: () => number;
+    /** Check for stale/contradictory memories */
+    getMemoryHealth?: () => Promise<{
+        staleCount: number;
+        contradictions: number;
+    }>;
+}
+export interface TickEvent {
+    type: 'task_overdue' | 'task_upcoming' | 'journal_streak' | 'token_warning' | 'support_reply' | 'memory_health';
+    message: string;
+    severity: 'info' | 'nudge' | 'urgent';
+    /** Should this interrupt or wait for next natural pause? */
+    blocking: boolean;
+}
+export interface TickResult {
+    events: TickEvent[];
+    /** Timestamp of this tick */
+    timestamp: number;
+}
+export declare class TickEngine {
+    private lastTick;
+    private lastEventByType;
+    /**
+     * Run a single tick — check everything, return events worth surfacing.
+     * Designed to be called periodically from an interval timer.
+     * Fast and non-blocking — total execution should stay under BLOCKING_BUDGET_MS.
+     */
+    tick(ctx: TickContext): Promise<TickResult>;
+    /** Check if this event type was already fired recently */
+    private isDuplicate;
+    /** Reset dedup tracking — useful when user explicitly asks for a check */
+    reset(): void;
+}
+//# sourceMappingURL=tick-engine.d.ts.map

package/dist/awareness/tick-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick-engine.d.ts","sourceRoot":"","sources":["../../src/awareness/tick-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC9F,2BAA2B;IAC3B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1E,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/D,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;IAChC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,gBAAgB,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;IAChH,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,eAAe,CAAkC;IAEzD;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA4GjD,0DAA0D;IAC1D,OAAO,CAAC,WAAW;IAKnB,0EAA0E;IAC1E,KAAK,IAAI,IAAI;CAId"}