@bryti/agent 0.0.1 → 0.1.0

package/dist/message-queue.js

@@ -0,0 +1,188 @@
+/**
+ * Per-channel FIFO message queue with merge and backpressure.
+ *
+ * Two core guarantees:
+ *
+ * 1. Per-channel serialization: only one message is processed at a time per
+ *    channel. Subsequent messages queue up behind it rather than racing into
+ *    the agent loop in parallel.
+ *
+ * 2. Burst merging: rapid-fire messages that arrive within MERGE_WINDOW_MS of
+ *    each other are joined into a single prompt before being dispatched. This
+ *    handles the common "user sends three quick messages" pattern without the
+ *    agent seeing three separate incomplete thoughts.
+ *
+ * New messages queue up to MAX_DEPTH; beyond that the caller gets a rejection
+ * callback (backpressure signal, not silent drop).
+ */
+const MAX_DEPTH = 10;
+// 2-3 seconds is the sweet spot: fast enough that the user experiences a
+// single response (not noticeable delay), long enough to catch split messages
+// that arrive in separate network frames. The current 5s value is conservative
+// and can be tuned down if latency matters more.
+const MERGE_WINDOW_MS = 5000;
+const RATE_LIMIT_MAX = 10;
+const RATE_LIMIT_WINDOW_MS = 60_000;
+/**
+ * Sliding window rate limiter. Tracks timestamps of recent messages per user
+ * and rejects when the limit is exceeded.
+ */
+class RateLimiter {
+    maxMessages;
+    windowMs;
+    windows = new Map();
+    constructor(maxMessages, windowMs) {
+        this.maxMessages = maxMessages;
+        this.windowMs = windowMs;
+    }
+    /**
+     * Check if a message from this user should be allowed.
+     * Returns true if allowed, false if rate-limited.
+     */
+    check(userId) {
+        const now = Date.now();
+        const cutoff = now - this.windowMs;
+        let timestamps = this.windows.get(userId);
+        if (!timestamps) {
+            timestamps = [];
+            this.windows.set(userId, timestamps);
+        }
+        // Prune old entries
+        while (timestamps.length > 0 && timestamps[0] < cutoff) {
+            timestamps.shift();
+        }
+        if (timestamps.length >= this.maxMessages) {
+            return false;
+        }
+        timestamps.push(now);
+        return true;
+    }
+}
+/**
+ * Serialises processing per channel and merges rapid follow-up messages.
+ */
+export class MessageQueue {
+    queues = new Map();
+    processFn;
+    rejectFn;
+    maxDepth;
+    mergeWindowMs;
+    rateLimiter;
+    constructor(processFn, rejectFn, maxDepth = MAX_DEPTH, mergeWindowMs = MERGE_WINDOW_MS) {
+        this.processFn = processFn;
+        this.rejectFn = rejectFn;
+        this.maxDepth = maxDepth;
+        this.mergeWindowMs = mergeWindowMs;
+        this.rateLimiter = new RateLimiter(RATE_LIMIT_MAX, RATE_LIMIT_WINDOW_MS);
+    }
+    /**
+     * Enqueue a message. If nothing is processing for this channel, starts
+     * draining immediately. Rate-limited per user (10 messages/minute).
+     */
+    enqueue(msg) {
+        const key = msg.channelId;
+        // Rate limiting: skip for internal messages (worker triggers, scheduler)
+        const rawObj = msg.raw;
+        const isInternal = rawObj?.type != null;
+        if (!isInternal && !this.rateLimiter.check(msg.userId)) {
+            console.warn(`[queue] Rate limit exceeded for user ${msg.userId}`);
+            this.rejectFn(msg).catch((err) => console.error("rejectFn error:", err));
+            return;
+        }
+        let q = this.queues.get(key);
+        if (!q) {
+            q = { entries: [], processing: false };
+            this.queues.set(key, q);
+        }
+        if (q.entries.length >= this.maxDepth) {
+            // Queue full: invoke the rejection callback immediately and return without
+            // enqueuing. This is a backpressure signal to the caller — the message is
+            // not silently dropped, but it is not queued either. The caller decides
+            // how to respond (e.g., send "I'm busy" to the user).
+            this.rejectFn(msg).catch((err) => console.error("rejectFn error:", err));
+            return;
+        }
+        q.entries.push({ msg, arrivedAt: Date.now() });
+        if (!q.processing) {
+            this.drain(key).catch((err) => console.error("Queue drain error:", err));
+        }
+    }
+    /**
+     * Drain the queue for a channel sequentially, merging close messages.
+     */
+    async drain(key) {
+        const q = this.queues.get(key);
+        if (!q)
+            return;
+        q.processing = true;
+        while (q.entries.length > 0) {
+            const batch = this.takeMergeBatch(q);
+            const merged = this.mergeEntries(batch);
+            try {
+                await this.processFn(merged);
+            }
+            catch (err) {
+                console.error("processMessage error:", err);
+            }
+        }
+        q.processing = false;
+    }
+    /**
+     * Take a batch of entries that should be merged together.
+     *
+     * The first entry is always included. Additional entries are included if they
+     * arrived within mergeWindowMs of the FIRST entry in the batch. This is a
+     * fixed window anchored to the first message, not a sliding window — an
+     * entry that arrives 1ms after the previous one is still excluded if it
+     * falls outside the window from the first entry.
+     */
+    takeMergeBatch(q) {
+        const batch = [];
+        const first = q.entries.shift();
+        batch.push(first);
+        while (q.entries.length > 0) {
+            const next = q.entries[0];
+            if (next.arrivedAt - first.arrivedAt <= this.mergeWindowMs) {
+                batch.push(q.entries.shift());
+            }
+            else {
+                break;
+            }
+        }
+        return batch;
+    }
+    /**
+     * Merge multiple queue entries into a single IncomingMessage by joining
+     * their text with newlines. Metadata (userId, channelId, platform, etc.) is
+     * taken from the first entry.
+     *
+     * Note: images (and other non-text attachments) from subsequent burst
+     * entries are currently dropped — only their text is merged.
+     * TODO: carry images from all burst entries into the merged message.
+     */
+    mergeEntries(entries) {
+        if (entries.length === 1) {
+            return entries[0].msg;
+        }
+        const texts = entries.map((e) => e.msg.text).filter(Boolean);
+        return {
+            ...entries[0].msg,
+            text: texts.join("\n"),
+        };
+    }
+    /**
+     * Number of queued (not-yet-processing) messages for a channel.
+     * Exposed for monitoring dashboards and unit tests.
+     */
+    queueDepth(channelId) {
+        return this.queues.get(channelId)?.entries.length ?? 0;
+    }
+    /**
+     * Whether the channel is currently mid-process (drain loop running).
+     * Exposed for monitoring dashboards and unit tests.
+     */
+    isProcessing(channelId) {
+        return this.queues.get(channelId)?.processing ?? false;
+    }
+}
+//# sourceMappingURL=message-queue.js.map

package/dist/message-queue.js.map

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

package/dist/model-infra.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shared model infrastructure: AuthStorage, ModelRegistry, models.json
+ * generation, and model string resolution. Used by the main agent, workers,
+ * reflection, and the guardrail.
+ *
+ * This module does three things:
+ *   1. Generates models.json from bryti config so pi's ModelRegistry
+ *      discovers all configured providers and models.
+ *   2. Sets up AuthStorage, bridging Claude CLI credentials and pi auth.json
+ *      so every LLM caller gets tokens without extra wiring.
+ *   3. Exposes model resolution helpers (resolveModel, resolveFirstModel)
+ *      that translate "provider/modelId" config strings into registry Model
+ *      objects with fuzzy fallback.
+ *
+ * These three concerns live together because every LLM-calling component
+ * (agent, workers, reflection, guardrail) needs all three: without models.json
+ * the registry has nothing to load; without AuthStorage the registry cannot
+ * authenticate; without resolution helpers callers cannot turn config strings
+ * into actual Model objects.
+ */
+import type { Model } from "@mariozechner/pi-ai";
+import { AuthStorage, ModelRegistry } from "@mariozechner/pi-coding-agent";
+import type { Config } from "./config.js";
+export interface ModelInfra {
+    authStorage: AuthStorage;
+    modelRegistry: ModelRegistry;
+    agentDir: string;
+}
+/**
+ * Create the auth and model registry infrastructure from config. Generates
+ * models.json, sets up AuthStorage with runtime API keys, and initializes
+ * ModelRegistry. Shared by everything that talks to an LLM.
+ *
+ * Auth priority for Anthropic:
+ *   1. Claude CLI credentials (~/.claude/.credentials.json) — primary source
+ *   2. Pi auth.json (~/.pi/agent/auth.json) — fallback for pi CLI users
+ *   3. Explicit api_key in config — always wins as a runtime override
+ */
+export declare function createModelInfra(config: Config): ModelInfra;
+/**
+ * Resolve a "provider/modelId" string against the registry.
+ *
+ * Resolution order:
+ *   1. Exact match via ModelRegistry.find(provider, modelId).
+ *   2. Fuzzy match: scans all available models for one whose id contains
+ *      modelId as a substring. This handles cases where model IDs in the
+ *      registry include version suffixes (e.g. "claude-3-5-sonnet-20241022")
+ *      that the shorter config string ("claude-3-5-sonnet") doesn't carry.
+ *
+ * Returns null if neither strategy finds a match.
+ */
+export declare function resolveModel(modelString: string, modelRegistry: ModelRegistry): Model<any> | null;
+/**
+ * Resolve the first usable model from an ordered list of "provider/modelId"
+ * candidate strings.
+ *
+ * Used by the guardrail to pick a model without requiring a full config
+ * context: it passes its ordered preference list and gets back whatever is
+ * actually available in the registry. Returns the first successful resolution,
+ * not the "best" or highest-capability model. Returns null if no candidate
+ * resolves.
+ */
+export declare function resolveFirstModel(candidates: string[], modelRegistry: ModelRegistry): Model<any> | null;
+//# sourceMappingURL=model-infra.d.ts.map

package/dist/model-infra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-infra.d.ts","sourceRoot":"","sources":["../src/model-infra.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,WAAW,EACX,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAyB3D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,aAAa,GAC3B,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAanB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAAE,EACpB,aAAa,EAAE,aAAa,GAC3B,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAMnB"}

package/dist/model-infra.js

@@ -0,0 +1,202 @@
+/**
+ * Shared model infrastructure: AuthStorage, ModelRegistry, models.json
+ * generation, and model string resolution. Used by the main agent, workers,
+ * reflection, and the guardrail.
+ *
+ * This module does three things:
+ *   1. Generates models.json from bryti config so pi's ModelRegistry
+ *      discovers all configured providers and models.
+ *   2. Sets up AuthStorage, bridging Claude CLI credentials and pi auth.json
+ *      so every LLM caller gets tokens without extra wiring.
+ *   3. Exposes model resolution helpers (resolveModel, resolveFirstModel)
+ *      that translate "provider/modelId" config strings into registry Model
+ *      objects with fuzzy fallback.
+ *
+ * These three concerns live together because every LLM-calling component
+ * (agent, workers, reflection, guardrail) needs all three: without models.json
+ * the registry has nothing to load; without AuthStorage the registry cannot
+ * authenticate; without resolution helpers callers cannot turn config strings
+ * into actual Model objects.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { AuthStorage, ModelRegistry, } from "@mariozechner/pi-coding-agent";
+// ---------------------------------------------------------------------------
+// models.json generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate models.json from bryti config so pi's ModelRegistry discovers
+ * all configured providers and models.
+ */
+function generateModelsJson(config, agentDir) {
+    const modelsJsonPath = path.join(agentDir, "models.json");
+    const providers = {};
+    for (const provider of config.models.providers) {
+        if (provider.name === "groq") {
+            // Groq's provider format is not currently compatible with the SDK's
+            // openai-completions adapter (auth header shape differs). Skipping
+            // prevents ModelRegistry from producing broken entries.
+            // TODO: revisit once the SDK adds a native Groq adapter.
+            continue;
+        }
+        // Providers without an api_key use OAuth from ~/.pi/agent/auth.json.
+        // We still need to include them in models.json so custom model IDs
+        // (not yet in SDK built-ins) are discoverable.
+        // Use "oauth" as a placeholder apiKey: pi's auth.json holds the real token
+        // and AuthStorage resolves it at call time, but ModelRegistry requires a
+        // non-empty apiKey field to accept the entry at all.
+        const apiKey = provider.api_key || "oauth";
+        providers[provider.name] = {
+            baseUrl: provider.base_url || `https://api.${provider.name}.com`,
+            api: provider.api || "openai-completions",
+            apiKey: apiKey,
+            models: provider.models.map((m) => ({
+                id: m.id,
+                name: m.name || m.id,
+                contextWindow: m.context_window || 200000,
+                maxTokens: m.max_tokens || 32000,
+                input: m.input ?? ["text", "image"],
+                ...(m.api && { api: m.api }),
+                ...(m.cost && { cost: m.cost }),
+                ...(m.compat && { compat: m.compat }),
+            })),
+        };
+    }
+    fs.writeFileSync(modelsJsonPath, JSON.stringify({ providers }, null, 2), "utf-8");
+}
+/**
+ * Seed AuthStorage with Anthropic credentials from the Claude CLI credential
+ * file (~/.claude/.credentials.json) if no Anthropic credential is already
+ * present in auth.json.
+ *
+ * Claude CLI is the primary auth source for users who have it installed.
+ * Pi auth.json is used as the fallback (for users who logged in via `pi login`).
+ *
+ * Once seeded, pi's AuthStorage manages the refresh lifecycle going forward:
+ * it will auto-refresh the token using the refresh token when it expires.
+ *
+ * Credential format conversion:
+ *   Claude CLI stores { accessToken, refreshToken, expiresAt } under the
+ *   "claudeAiOauth" key. Pi expects { type: "oauth", access, refresh, expires }.
+ *   The field names are remapped here; the values are passed through unchanged.
+ *
+ * This function is called before runtime overrides are applied (setRuntimeApiKey),
+ * so an explicit api_key in config always wins over the seeded credential.
+ */
+function seedFromClaudeCliIfNeeded(authStorage) {
+    // Already have Anthropic creds — nothing to do
+    if (authStorage.has("anthropic")) {
+        return;
+    }
+    const claudeCredPath = path.join(os.homedir(), ".claude", ".credentials.json");
+    let raw;
+    try {
+        raw = fs.readFileSync(claudeCredPath, "utf-8");
+    }
+    catch {
+        // File doesn't exist or isn't readable — Claude CLI not installed
+        return;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        console.warn("[auth] ~/.claude/.credentials.json is not valid JSON, skipping");
+        return;
+    }
+    const creds = parsed.claudeAiOauth;
+    if (!creds?.accessToken || !creds?.refreshToken) {
+        console.warn("[auth] ~/.claude/.credentials.json has no usable claudeAiOauth credentials, skipping");
+        return;
+    }
+    // Convert Claude CLI format → pi AuthStorage OAuthCredential format:
+    //   Claude CLI: { accessToken, refreshToken, expiresAt }
+    //   pi:         { type: "oauth", access, refresh, expires }
+    authStorage.set("anthropic", {
+        type: "oauth",
+        access: creds.accessToken,
+        refresh: creds.refreshToken,
+        expires: creds.expiresAt ?? Date.now(),
+    });
+    console.log("[auth] Seeded Anthropic credentials from Claude CLI (~/.claude/.credentials.json)");
+}
+// ---------------------------------------------------------------------------
+// Infrastructure creation
+// ---------------------------------------------------------------------------
+/**
+ * Create the auth and model registry infrastructure from config. Generates
+ * models.json, sets up AuthStorage with runtime API keys, and initializes
+ * ModelRegistry. Shared by everything that talks to an LLM.
+ *
+ * Auth priority for Anthropic:
+ *   1. Claude CLI credentials (~/.claude/.credentials.json) — primary source
+ *   2. Pi auth.json (~/.pi/agent/auth.json) — fallback for pi CLI users
+ *   3. Explicit api_key in config — always wins as a runtime override
+ */
+export function createModelInfra(config) {
+    const agentDir = path.join(config.data_dir, ".pi");
+    fs.mkdirSync(agentDir, { recursive: true });
+    generateModelsJson(config, agentDir);
+    // Auth: start with ~/.pi/agent/auth.json (pi CLI OAuth creds), then
+    // seed from Claude CLI if no Anthropic credential is present there.
+    // AuthStorage uses file-level locking so concurrent token refreshes are safe.
+    const authStorage = new AuthStorage();
+    // Seed from Claude CLI before applying runtime overrides, so an explicit
+    // api_key in config still wins (setRuntimeApiKey takes precedence).
+    seedFromClaudeCliIfNeeded(authStorage);
+    for (const provider of config.models.providers) {
+        if (provider.api_key) {
+            authStorage.setRuntimeApiKey(provider.name, provider.api_key);
+        }
+    }
+    const modelRegistry = new ModelRegistry(authStorage, path.join(agentDir, "models.json"));
+    modelRegistry.refresh();
+    return { authStorage, modelRegistry, agentDir };
+}
+// ---------------------------------------------------------------------------
+// Model resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a "provider/modelId" string against the registry.
+ *
+ * Resolution order:
+ *   1. Exact match via ModelRegistry.find(provider, modelId).
+ *   2. Fuzzy match: scans all available models for one whose id contains
+ *      modelId as a substring. This handles cases where model IDs in the
+ *      registry include version suffixes (e.g. "claude-3-5-sonnet-20241022")
+ *      that the shorter config string ("claude-3-5-sonnet") doesn't carry.
+ *
+ * Returns null if neither strategy finds a match.
+ */
+export function resolveModel(modelString, modelRegistry) {
+    const [providerName, modelId] = modelString.includes("/")
+        ? modelString.split("/")
+        : [modelString, modelString];
+    let model = modelRegistry.find(providerName, modelId);
+    if (!model) {
+        const available = modelRegistry.getAvailable();
+        model = available.find((m) => m.provider === providerName && m.id.includes(modelId));
+    }
+    return model ?? null;
+}
+/**
+ * Resolve the first usable model from an ordered list of "provider/modelId"
+ * candidate strings.
+ *
+ * Used by the guardrail to pick a model without requiring a full config
+ * context: it passes its ordered preference list and gets back whatever is
+ * actually available in the registry. Returns the first successful resolution,
+ * not the "best" or highest-capability model. Returns null if no candidate
+ * resolves.
+ */
+export function resolveFirstModel(candidates, modelRegistry) {
+    for (const candidate of candidates) {
+        const model = resolveModel(candidate, modelRegistry);
+        if (model)
+            return model;
+    }
+    return null;
+}
+//# sourceMappingURL=model-infra.js.map

package/dist/model-infra.js.map

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

package/dist/projection/format.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Format projections for system prompt injection.
+ */
+import type { Projection } from "./store.js";
+/**
+ * Render a short projection list suitable for inclusion in the system prompt.
+ * Capped at maxItems to avoid crowding context.
+ */
+export declare function formatProjectionsForPrompt(projections: Projection[], maxItems?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/projection/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/projection/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,QAAQ,SAAK,GAAG,MAAM,CAwB3F"}

package/dist/projection/format.js

@@ -0,0 +1,30 @@
+/**
+ * Format projections for system prompt injection.
+ */
+/**
+ * Render a short projection list suitable for inclusion in the system prompt.
+ * Capped at maxItems to avoid crowding context.
+ */
+export function formatProjectionsForPrompt(projections, maxItems = 15) {
+    if (projections.length === 0) {
+        return "No upcoming projections.";
+    }
+    const capped = projections.slice(0, maxItems);
+    const lines = capped.map((p) => {
+        const when = p.trigger_on_fact
+            ? `[waiting for: "${p.trigger_on_fact}"]`
+            : p.resolved_when
+                ? `[${p.resolved_when.slice(0, 16)}, ${p.resolution}]`
+                : p.raw_when
+                    ? `[${p.raw_when}, ${p.resolution}]`
+                    : `[someday]`;
+        const recur = p.recurrence ? ` [recurring: ${p.recurrence}]` : "";
+        const ctx = p.context ? ` — ${p.context}` : "";
+        return `- ${when}${recur} ${p.summary}${ctx} (id: ${p.id})`;
+    });
+    const overflow = projections.length > maxItems
+        ? `\n(${projections.length - maxItems} more — use projection_list to see all)`
+        : "";
+    return lines.join("\n") + overflow;
+}
+//# sourceMappingURL=format.js.map

package/dist/projection/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/projection/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAyB,EAAE,QAAQ,GAAG,EAAE;IACjF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,eAAe;YAC5B,CAAC,CAAC,kBAAkB,CAAC,CAAC,eAAe,IAAI;YACzC,CAAC,CAAC,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG;gBACtD,CAAC,CAAC,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,UAAU,GAAG;oBACpC,CAAC,CAAC,WAAW,CAAC;QACpB,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,OAAO,GAAG,GAAG,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,QAAQ;QAC5C,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,GAAG,QAAQ,yCAAyC;QAC9E,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;AACrC,CAAC"}

package/dist/projection/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Projection: forward-looking agent memory.
+ * Memory answers "what do I know?"; projection answers "what do I expect?"
+ */
+export { createProjectionStore } from "./store.js";
+export type { Projection, ProjectionResolution, ProjectionStatus, ProjectionStore, ProjectionDependency, ProjectionDependencyInput, DependencyConditionType, } from "./store.js";
+export { formatProjectionsForPrompt } from "./format.js";
+export { createProjectionTools } from "./tools.js";
+export { runReflection } from "./reflection.js";
+export type { ReflectionResult } from "./reflection.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/projection/index.js

@@ -0,0 +1,9 @@
+/**
+ * Projection: forward-looking agent memory.
+ * Memory answers "what do I know?"; projection answers "what do I expect?"
+ */
+export { createProjectionStore } from "./store.js";
+export { formatProjectionsForPrompt } from "./format.js";
+export { createProjectionTools } from "./tools.js";
+export { runReflection } from "./reflection.js";
+//# sourceMappingURL=index.js.map

package/dist/projection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/projection/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAUnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/projection/reflection.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Projection reflection pass.
+ *
+ * Lightweight background job that scans recent conversation history for
+ * future references the agent missed during live chat.
+ *
+ * Runs every 30 min via cron. Reads the JSONL audit log, makes a single
+ * completeSimple() call with a narrow extraction prompt (no agent loop,
+ * no tools), parses the JSON output, and writes projections directly to
+ * SQLite. Existing pending projections are included in the prompt so the
+ * model won't duplicate them. A per-user timestamp tracks the last run
+ * to skip unchanged transcripts.
+ *
+ * Why completeSimple() instead of a full agent loop?
+ * The reflection pass has no side effects and requires no tool calls. It only
+ * needs one prompt in and one JSON blob out. Using a full agent loop would add
+ * latency, cost, and the risk of unintended tool invocations. completeSimple()
+ * is cheaper, faster, and keeps the pass strictly read-only from the model's
+ * perspective.
+ */
+import type { Config } from "../config.js";
+import type { ProjectionResolution, ProjectionStore } from "./store.js";
+export interface ProjectionCandidate {
+    summary: string;
+    when?: string;
+    resolution?: ProjectionResolution;
+    context?: string;
+}
+export interface ArchiveCandidate {
+    content: string;
+}
+export interface ReflectionOutput {
+    project: ProjectionCandidate[];
+    /**
+     * TODO: archive candidates are extracted from the LLM output but are not
+     * currently written anywhere. This field is a placeholder for a future
+     * feature that would auto-insert noteworthy facts into archival memory
+     * during the reflection pass.
+     */
+    archive: ArchiveCandidate[];
+}
+export interface ReflectionResult {
+    /** Number of projections written to the store. */
+    projectionsAdded: number;
+    /** Raw candidates extracted (before dedup). */
+    candidates: ProjectionCandidate[];
+    /** Whether reflection was skipped (no new messages). */
+    skipped: boolean;
+    /** Reason for skipping, if applicable. */
+    skipReason?: string;
+}
+interface HistoryEntry {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    timestamp: string;
+}
+/**
+ * Read user+assistant messages from the JSONL audit log for the last
+ * `windowMinutes`. Returns entries in chronological order, capped at
+ * `maxMessages`.
+ *
+ * Reads from the JSONL audit log written by src/compaction/history.ts, NOT
+ * from the pi SDK session file. The audit log is the only way to get
+ * structured turn-by-turn history outside of a live session context: the pi
+ * session file is append-only and interleaved with tool scaffolding, whereas
+ * the audit log contains clean role/content/timestamp records per message.
+ */
+export declare function readRecentHistory(historyDir: string, windowMinutes: number, maxMessages?: number): HistoryEntry[];
+interface CompletionMessage {
+    role: "system" | "user";
+    content: string;
+}
+/**
+ * Single chat completion via the pi SDK provider layer. Uses reflection_model
+ * if configured, otherwise falls back to the primary model and then the
+ * fallback chain. This lets operators use a cheaper model for reflection.
+ */
+export declare function sdkComplete(config: Config, messages: CompletionMessage[]): Promise<string>;
+/**
+ * Parse the LLM output, tolerating markdown code fences and minor formatting.
+ *
+ * Even with `temperature: 0` and an explicit "output JSON only" instruction,
+ * models occasionally wrap their response in a ```json ... ``` code fence.
+ * The stripping step removes those fences before calling JSON.parse(), so
+ * both bare JSON and fenced JSON are accepted.
+ */
+export declare function parseReflectionOutput(raw: string): ReflectionOutput;
+/**
+ * Run one reflection pass for a user. Reads recent conversation, extracts
+ * future references via LLM, and writes new projections to the store.
+ */
+export declare function runReflection(config: Config, userId: string, windowMinutes?: number, store?: ProjectionStore, completeFn?: typeof sdkComplete): Promise<ReflectionResult>;
+export {};
+//# sourceMappingURL=reflection.d.ts.map

package/dist/projection/reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection.d.ts","sourceRoot":"","sources":["../../src/projection/reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUxE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,WAAW,SAAK,GACf,YAAY,EAAE,CAyChB;AAuCD,UAAU,iBAAiB;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,CA6CjB;AA+CD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAgBnE;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,aAAa,SAAK,EAClB,KAAK,CAAC,EAAE,eAAe,EACvB,UAAU,CAAC,EAAE,OAAO,WAAW,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAwH3B"}