@telora/daemon 0.13.17 → 0.13.18

package/dist/loop-llm-client.js

@@ -0,0 +1,80 @@
+/**
+ * LLM client for loop data updates.
+ *
+ * Calls the Anthropic API using the organization's LLM secret
+ * (fetched via edge function RPC). One call per strategy per cycle maximum.
+ */
+import { callApi } from './queries/shared.js';
+// ---------------------------------------------------------------------------
+// API key retrieval
+// ---------------------------------------------------------------------------
+/**
+ * Fetch the organization's Anthropic API key via the edge function.
+ * Falls back to ANTHROPIC_API_KEY env var if not configured in the org.
+ */
+async function getApiKey(_organizationId) {
+    try {
+        const result = await callApi('llm_secret_get', {
+            provider: 'anthropic',
+        });
+        if (result.apiKey)
+            return result.apiKey;
+    }
+    catch {
+        // Fall through to env var
+    }
+    return process.env.ANTHROPIC_API_KEY ?? null;
+}
+// ---------------------------------------------------------------------------
+// LLM call
+// ---------------------------------------------------------------------------
+/** Default model for loop evaluations. */
+const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
+/** Max tokens for the loop update response. */
+const MAX_TOKENS = 4096;
+/**
+ * Call the Anthropic API for a loop data update.
+ *
+ * @param organizationId - Organization owning the LLM secret
+ * @param prompt - System + user prompt assembled by the prompt builder
+ * @returns Raw text response, or null if the call failed
+ */
+export async function callLoopLLM(organizationId, prompt) {
+    const apiKey = await getApiKey(organizationId);
+    if (!apiKey) {
+        console.log('[Loop] No Anthropic API key available -- skipping LLM evaluation');
+        return null;
+    }
+    const messages = [
+        { role: 'user', content: prompt.user },
+    ];
+    try {
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': apiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model: DEFAULT_MODEL,
+                max_tokens: MAX_TOKENS,
+                system: prompt.system,
+                messages,
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => 'unknown error');
+            console.log(`[Loop] Anthropic API error (${response.status}): ${errorBody.slice(0, 200)}`);
+            return null;
+        }
+        const result = await response.json();
+        const textBlock = result.content?.find(c => c.type === 'text');
+        return textBlock?.text ?? null;
+    }
+    catch (err) {
+        console.log(`[Loop] Anthropic API call failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=loop-llm-client.js.map

package/dist/loop-llm-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-llm-client.js","sourceRoot":"","sources":["../src/loop-llm-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAqB9C,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,KAAK,UAAU,SAAS,CAAC,eAAuB;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAoB,gBAAgB,EAAE;YAChE,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,0CAA0C;AAC1C,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD,+CAA+C;AAC/C,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,cAAsB,EACtB,MAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAuB;QACnC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;KACvC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,MAAM;gBACnB,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,aAAa;gBACpB,UAAU,EAAE,UAAU;gBACtB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ;aACT,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,+BAA+B,QAAQ,CAAC,MAAM,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3F,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAC;QAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAC/D,OAAO,SAAS,EAAE,IAAI,IAAI,IAAI,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,qCAAqC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/loop-prompt-builder.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Loop update prompt assembler.
+ *
+ * Builds the LLM prompt for loop data re-evaluation and parses
+ * the structured response into typed updates.
+ */
+import type { LoopIntentData, RealityData, VarianceResult } from './loop-variance.js';
+export interface LoopUpdatePrompt {
+    system: string;
+    user: string;
+}
+export interface LoopUpdateResult {
+    /** Ordered document IDs (first = highest priority). Empty = no change. */
+    documentReorders: string[];
+    /** Answer updates. */
+    answerUpdates: Array<{
+        questionId: string;
+        content: string;
+    }>;
+    /** New questions to create. */
+    newQuestions: Array<{
+        text: string;
+    }>;
+    /** Proposed persona adjustment (null = no change). */
+    personaProposal: string | null;
+}
+/**
+ * Build the LLM prompt for loop data re-evaluation.
+ *
+ * System = loop persona (how to think at this layer).
+ * User = intent data + reality data + variance + instructions.
+ */
+export declare function buildLoopUpdatePrompt(intent: LoopIntentData, reality: RealityData, variance: VarianceResult): LoopUpdatePrompt;
+/**
+ * Parse the LLM response into structured loop updates.
+ * Handles JSON extraction from markdown code blocks.
+ */
+export declare function parseLoopUpdateResponse(rawResponse: string): LoopUpdateResult;
+//# sourceMappingURL=loop-prompt-builder.d.ts.map

package/dist/loop-prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-prompt-builder.d.ts","sourceRoot":"","sources":["../src/loop-prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMtF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,sBAAsB;IACtB,aAAa,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,+BAA+B;IAC/B,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtC,sDAAsD;IACtD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,cAAc,GACvB,gBAAgB,CAyGlB;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAwC7E"}

package/dist/loop-prompt-builder.js

@@ -0,0 +1,168 @@
+/**
+ * Loop update prompt assembler.
+ *
+ * Builds the LLM prompt for loop data re-evaluation and parses
+ * the structured response into typed updates.
+ */
+// ---------------------------------------------------------------------------
+// Prompt builder
+// ---------------------------------------------------------------------------
+/**
+ * Build the LLM prompt for loop data re-evaluation.
+ *
+ * System = loop persona (how to think at this layer).
+ * User = intent data + reality data + variance + instructions.
+ */
+export function buildLoopUpdatePrompt(intent, reality, variance) {
+    // System prompt: the persona defines the agent's thinking altitude
+    const system = intent.persona
+        ? intent.persona
+        : 'You are a strategic analyst evaluating the alignment between declared intent and forecasted operational reality. Think in terms of directional priorities, risk, and whether execution is converging toward or diverging from the intended outcome.';
+    // Build the user message
+    const parts = [];
+    // Section 1: Current loop documents (ranked)
+    parts.push('## Current Loop Documents (force-ranked, highest priority first)\n');
+    if (intent.documents.length === 0) {
+        parts.push('_No loop documents exist yet. Create initial documents based on the reality data below._\n');
+    }
+    else {
+        for (const doc of intent.documents) {
+            parts.push(`### ${doc.sortOrder + 1}. ${doc.title}\n`);
+            parts.push(doc.content);
+            parts.push(`\n_Document ID: ${doc.id}_\n`);
+        }
+    }
+    // Section 2: Questions and current answers
+    parts.push('\n## Loop Questions\n');
+    const fixedQuestions = intent.questions.filter(q => q.questionType === 'fixed' && !q.isRetired);
+    const generatedQuestions = intent.questions.filter(q => q.questionType === 'generated' && !q.isRetired);
+    if (fixedQuestions.length > 0) {
+        parts.push('### Fixed Questions\n');
+        for (const q of fixedQuestions) {
+            parts.push(`**Q (${q.id}):** ${q.text}`);
+            parts.push(`**A:** ${q.answer || '_No answer yet._'}\n`);
+        }
+    }
+    if (generatedQuestions.length > 0) {
+        parts.push('### Agent-Generated Questions (ranked)\n');
+        for (const q of generatedQuestions) {
+            parts.push(`**Q (${q.id}):** ${q.text}`);
+            parts.push(`**A:** ${q.answer || '_No answer yet._'}\n`);
+        }
+    }
+    // Section 3: Reality data
+    parts.push('\n## Execution Reality (Wire B)\n');
+    const metrics = reality.metrics;
+    if (metrics) {
+        const m = metrics;
+        parts.push(`- Deliveries: planning=${m.deliveries_planning ?? 0}, queued=${m.deliveries_queued ?? 0}, coding=${m.deliveries_coding ?? 0}, verify=${m.deliveries_verify ?? 0}, done=${m.deliveries_done ?? 0}`);
+        parts.push(`- Issues: total=${m.total_issues ?? 0}, todo=${m.issues_todo ?? 0}, in_progress=${m.issues_in_progress ?? 0}, done=${m.issues_done ?? 0}, blocked=${m.issues_blocked ?? 0}`);
+        parts.push(`- Throughput: ${m.issues_done_7d ?? 0} (7d), ${m.issues_done_14d ?? 0} (14d), ${m.issues_done_30d ?? 0} (30d)`);
+        if (m.avg_cycle_time_days)
+            parts.push(`- Avg cycle time: ${m.avg_cycle_time_days} days`);
+        parts.push(`- Agent sessions: ${m.session_count ?? 0}, cost: $${Number(m.total_agent_cost ?? 0).toFixed(2)}, escalations: ${m.escalation_count ?? 0}`);
+    }
+    else {
+        parts.push('_No reality metrics available yet._');
+    }
+    // Projections
+    const comp = reality.projections.completion;
+    const cost = reality.projections.cost;
+    if (comp) {
+        parts.push(`\n### Completion Projection`);
+        parts.push(`- Status: ${comp.status}`);
+        if (comp.projectedCompletionDate)
+            parts.push(`- Projected completion: ${comp.projectedCompletionDate}`);
+        if (comp.velocity)
+            parts.push(`- Velocity: ${comp.velocity} issues/day`);
+        if (comp.confidence)
+            parts.push(`- Confidence: ${comp.confidence}`);
+        if (comp.remainingIssues)
+            parts.push(`- Remaining: ${comp.remainingIssues} issues`);
+    }
+    if (cost) {
+        parts.push(`\n### Cost Projection`);
+        parts.push(`- Cost to date: $${Number(cost.costToDate ?? 0).toFixed(2)}`);
+        parts.push(`- Burn rate: $${Number(cost.burnRatePerDay ?? 0).toFixed(2)}/day`);
+        if (cost.projectedTotalCost)
+            parts.push(`- Projected total: $${Number(cost.projectedTotalCost).toFixed(2)}`);
+    }
+    // Section 4: Computed variance
+    parts.push(`\n## Computed Variance\n`);
+    parts.push(`**Lock status:** ${variance.lockStatus}`);
+    parts.push(`**Summary:** ${variance.summary}`);
+    if (variance.noiseFlags.activityWithoutProgress)
+        parts.push('**Noise flag:** High activity without progress detected');
+    if (variance.noiseFlags.extendedCodingNoVerify)
+        parts.push('**Noise flag:** Extended coding phase without verification');
+    if (variance.noiseFlags.highEscalationRate)
+        parts.push('**Noise flag:** High escalation rate');
+    // Section 5: Instructions
+    parts.push(`\n## Instructions\n`);
+    parts.push('Given the intent data (loop documents, questions, answers) and the reality data (metrics, projections, variance), update the loop layer:\n');
+    parts.push('1. **Re-rank documents** if priorities have shifted based on new reality data. Return the ordered list of document IDs (highest priority first). Return empty array if no reordering needed.');
+    parts.push('2. **Revise answers** to questions based on the latest data. Only include answers that need updating.');
+    parts.push('3. **Generate new questions** if emerging concerns are not covered by existing questions. Questions should surface what matters but is not being asked.');
+    parts.push('4. **Propose persona adjustment** if the thinking mode needs recalibration. Return null if no adjustment needed.\n');
+    parts.push('**CRITICAL: This system is asymmetric.** You must NEVER suggest lowering targets, accommodating drift, or adjusting intent downward. If the gap between intent and forecasted reality is large, surface it as a concern and escalation signal -- do not normalize it. Only humans adjust intent.\n');
+    parts.push('Respond with a JSON object in this exact format:\n');
+    parts.push('```json');
+    parts.push('{');
+    parts.push('  "documentReorders": ["doc-id-1", "doc-id-2", ...],');
+    parts.push('  "answerUpdates": [{"questionId": "q-id", "content": "updated answer"}],');
+    parts.push('  "newQuestions": [{"text": "question text"}],');
+    parts.push('  "personaProposal": null');
+    parts.push('}');
+    parts.push('```');
+    return {
+        system,
+        user: parts.join('\n'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Response parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse the LLM response into structured loop updates.
+ * Handles JSON extraction from markdown code blocks.
+ */
+export function parseLoopUpdateResponse(rawResponse) {
+    const empty = {
+        documentReorders: [],
+        answerUpdates: [],
+        newQuestions: [],
+        personaProposal: null,
+    };
+    // Extract JSON from code block if present
+    let jsonStr = rawResponse.trim();
+    const codeBlockMatch = jsonStr.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (codeBlockMatch) {
+        jsonStr = codeBlockMatch[1].trim();
+    }
+    try {
+        const parsed = JSON.parse(jsonStr);
+        return {
+            documentReorders: Array.isArray(parsed.documentReorders)
+                ? parsed.documentReorders.filter(id => typeof id === 'string')
+                : [],
+            answerUpdates: Array.isArray(parsed.answerUpdates)
+                ? parsed.answerUpdates
+                    .filter(a => typeof a.questionId === 'string' && typeof a.content === 'string')
+                    .map(a => ({ questionId: a.questionId, content: a.content }))
+                : [],
+            newQuestions: Array.isArray(parsed.newQuestions)
+                ? parsed.newQuestions
+                    .filter(q => typeof q.text === 'string')
+                    .map(q => ({ text: q.text }))
+                : [],
+            personaProposal: typeof parsed.personaProposal === 'string'
+                ? parsed.personaProposal
+                : null,
+        };
+    }
+    catch {
+        console.log('[Loop] Failed to parse LLM response as JSON');
+        return empty;
+    }
+}
+//# sourceMappingURL=loop-prompt-builder.js.map

package/dist/loop-prompt-builder.js.map

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

package/dist/loop-variance.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Variance computation for the Loop Agent differential receiver.
+ *
+ * Compares intent (loop data) against forecasted reality (metrics + projections)
+ * and produces a structured VarianceResult. Pure function, no side effects.
+ */
+export interface LoopIntentData {
+    documents: Array<{
+        id: string;
+        title: string;
+        content: string;
+        sortOrder: number;
+    }>;
+    questions: Array<{
+        id: string;
+        text: string;
+        questionType: string;
+        sortOrder: number | null;
+        isRetired: boolean;
+        answer: string | null;
+    }>;
+    persona: string | null;
+    proposedPersona: string | null;
+}
+export interface RealityData {
+    metrics: Record<string, unknown> | null;
+    projections: {
+        completion: Record<string, unknown> | null;
+        cost: Record<string, unknown> | null;
+    };
+}
+export interface ScheduleVariance {
+    targetDate: string | null;
+    projectedDate: string | null;
+    varianceDays: number;
+    direction: 'ahead' | 'behind' | 'on_track' | 'unknown';
+}
+export interface ThroughputVariance {
+    currentVelocity: number;
+    requiredVelocity: number | null;
+    trend: 'accelerating' | 'steady' | 'decelerating' | 'stalled';
+    remainingIssues: number;
+}
+export interface CostVariance {
+    costToDate: number;
+    projectedTotal: number | null;
+    burnRatePerDay: number;
+}
+export interface StalenessVariance {
+    /** Whether loop data may be outdated relative to reality changes. */
+    isStale: boolean;
+    /** Human-readable reason. */
+    reason: string | null;
+}
+export interface VarianceDimensions {
+    schedule: ScheduleVariance | null;
+    throughput: ThroughputVariance | null;
+    cost: CostVariance | null;
+    staleness: StalenessVariance | null;
+    completionConfidence: number | null;
+}
+export interface NoiseFlags {
+    /** High activity but no throughput change. */
+    activityWithoutProgress: boolean;
+    /** All deliveries coding for extended period with no verify transitions. */
+    extendedCodingNoVerify: boolean;
+    /** High escalation rate relative to session count. */
+    highEscalationRate: boolean;
+}
+export type LockStatus = 'locked' | 'drifting' | 'unlocked';
+export type TrendDirection = 'converging' | 'diverging' | 'stable';
+export interface VarianceResult {
+    lockStatus: LockStatus;
+    dimensions: VarianceDimensions;
+    noiseFlags: NoiseFlags;
+    summary: string;
+    trendDirection: TrendDirection;
+}
+/**
+ * Compute variance between intent and forecasted reality.
+ *
+ * @param intent - Loop data (documents, questions, answers, persona)
+ * @param reality - Reality metrics and projections
+ * @param targetDate - Strategy target date (ISO string or null)
+ * @param previousVariance - Previous variance result for trend computation (optional)
+ * @returns Structured variance result
+ */
+export declare function computeVariance(intent: LoopIntentData, reality: RealityData, targetDate: string | null, previousVariance?: VarianceResult | null): VarianceResult;
+//# sourceMappingURL=loop-variance.d.ts.map

package/dist/loop-variance.d.ts.map

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