@dv.nghiem/flowdeck 0.4.2 → 0.4.3

package/dist/services/artifact-store.d.ts

@@ -0,0 +1,39 @@
+export declare const ARTIFACT_SUMMARY_MAX_CHARS = 500;
+export interface Artifact {
+    id: string;
+    agent: string;
+    stage: string;
+    summary: string;
+    content: string;
+    content_chars: number;
+    state_version: number;
+    index_version: number;
+    created_at: string;
+}
+export interface ArtifactRef {
+    id: string;
+    summary: string;
+}
+/** Content-hash of the output text (24-char hex prefix). */
+export declare function contentHash(content: string): string;
+/** Auto-generate a short summary from content (first ARTIFACT_SUMMARY_MAX_CHARS chars, stripped). */
+export declare function summarizeContent(content: string): string;
+/**
+ * Store an artifact and return a ref (id + summary) for carry-forward.
+ * On storage failure, returns a ref with the summary only (id may be recomputed later).
+ */
+export declare function storeArtifact(dir: string, agent: string, stage: string, content: string, stateVersion: number, indexVersion: number): ArtifactRef;
+/**
+ * Retrieve an artifact by ID, enforcing version consistency.
+ * Returns null when: not found, stateVersion/indexVersion mismatch, or corrupt file.
+ */
+export declare function getArtifact(dir: string, id: string, stateVersion: number, indexVersion: number): Artifact | null;
+/**
+ * Resolve `artifact:<id>` tokens in a text string, replacing each with the
+ * artifact's full content. Tokens whose artifact is not found or stale are
+ * replaced with a `[artifact:<id> not found]` placeholder.
+ */
+export declare function resolveArtifactRefs(dir: string, text: string, stateVersion: number, indexVersion: number): string;
+/** Format an ArtifactRef for carry-forward in pipeline prompts. */
+export declare function formatArtifactRef(ref: ArtifactRef): string;
+//# sourceMappingURL=artifact-store.d.ts.map

package/dist/services/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../src/services/artifact-store.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAE7C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;CAChB;AAUD,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,WAAW,CAsBb;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,QAAQ,GAAG,IAAI,CAUjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE1D"}

package/dist/services/artifact-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=artifact-store.test.d.ts.map

package/dist/services/artifact-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.test.d.ts","sourceRoot":"","sources":["../../src/services/artifact-store.test.ts"],"names":[],"mappings":""}

package/dist/services/context-assembler.d.ts

@@ -0,0 +1,29 @@
+export interface StageContext {
+    stage: string;
+    /** Concise human-readable summary for injection into model prompts */
+    compact_summary: string;
+    /** Current state version — for cache invalidation */
+    state_version: number;
+    /** Current codebase index version — for cache invalidation */
+    index_version: number;
+    /** Structured fields relevant to this stage */
+    fields: Record<string, unknown>;
+    /** Was this loaded from cache (same summaryVersions as last call)? */
+    from_cache: boolean;
+}
+/**
+ * Assembles a minimal, stage-specific context for prompt injection.
+ *
+ * Uses in-memory cache keyed by (stage, dir) + (stateVersion, indexVersion).
+ * Safe for concurrent readers — no file writes.
+ *
+ * @param dir - project root directory
+ * @param stage - current workflow stage
+ * @returns StageContext with compact_summary and fields
+ */
+export declare function assembleStageContext(dir: string, stage: string): StageContext;
+/** Explicitly invalidate the context cache for a directory (call after state writes). */
+export declare function invalidateContextCache(dir: string): void;
+/** Return current cache entry count (for tests/telemetry). */
+export declare function getContextCacheSize(): number;
+//# sourceMappingURL=context-assembler.d.ts.map

package/dist/services/context-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.d.ts","sourceRoot":"","sources":["../../src/services/context-assembler.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAA;IACvB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAA;CACpB;AAuGD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAmC7E;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/services/context-assembler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-assembler.test.d.ts.map

package/dist/services/context-assembler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembler.test.d.ts","sourceRoot":"","sources":["../../src/services/context-assembler.test.ts"],"names":[],"mappings":""}

package/dist/services/cost-budget.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cost Budget Service
+ *
+ * Enforces per-workflow cost and token ceilings.
+ * Complements delegation-budget.ts (which counts calls/retries/depth) by tracking
+ * estimated USD spend and token consumption across a workflow run.
+ *
+ * Usage:
+ *   const result = checkCostBudget(dir, workflowId, { inputTokensDelta: 5000, costUSDDelta: 0.015 }, cfg)
+ *   if (result.status === "exhausted") throw new Error(result.message)
+ */
+import { loadFlowDeckConfig } from "../config";
+export interface CostBudgetState {
+    workflow_id: string;
+    run_id: string;
+    started_at: string;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    total_est_cost_usd: number;
+    call_count: number;
+}
+export type CostBudgetStatus = "ok" | "warned" | "exhausted";
+export interface CostBudgetCheckResult {
+    status: CostBudgetStatus;
+    message: string;
+    state: CostBudgetState;
+}
+export interface CostDelta {
+    inputTokensDelta?: number;
+    outputTokensDelta?: number;
+    costUSDDelta?: number;
+}
+/**
+ * Apply a delta to the running budget state and check against configured limits.
+ * If no governance.costBudget is configured, always returns "ok".
+ *
+ * @param dir         - project directory (for loading config and persisting state)
+ * @param workflowId  - e.g. the GSD run id or workflow name
+ * @param runId       - a unique id for this invocation (e.g. sessionID)
+ * @param delta       - tokens/cost consumed by the current call
+ * @param cfg         - optional pre-loaded budget config (avoids re-reading flowdeck.json)
+ */
+export declare function checkCostBudget(dir: string, workflowId: string, runId: string, delta: CostDelta, cfg?: ReturnType<typeof loadFlowDeckConfig>): CostBudgetCheckResult;
+/**
+ * Read the current accumulated state for a workflow run without applying a delta.
+ * Returns null if no state exists yet.
+ */
+export declare function getCostBudgetState(dir: string, workflowId: string, runId: string): CostBudgetState | null;
+/**
+ * Reset the budget state for a workflow run (e.g. at start of a new run).
+ */
+export declare function resetCostBudget(dir: string, workflowId: string, runId: string): void;
+//# sourceMappingURL=cost-budget.d.ts.map

package/dist/services/cost-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-budget.d.ts","sourceRoot":"","sources":["../../src/services/cost-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAI9C,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE5D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AA8CD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,EAChB,GAAG,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAC1C,qBAAqB,CAwDvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,eAAe,GAAG,IAAI,CAGxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIpF"}

package/dist/services/cost-budget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cost-budget.test.d.ts.map

package/dist/services/cost-budget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-budget.test.d.ts","sourceRoot":"","sources":["../../src/services/cost-budget.test.ts"],"names":[],"mappings":""}

package/dist/services/cost-estimator.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Cost Estimator Service
+ *
+ * Provides USD cost estimates for model calls based on a pricing table.
+ * Covers common OpenCode-compatible models (Anthropic, OpenAI, Google).
+ *
+ * Prices are per 1,000 tokens (input / output) in USD.
+ * Rates reflect publicly available list pricing; update when vendors change them.
+ *
+ * Usage:
+ *   import { estimateCostUSD, getCostReport } from "./cost-estimator"
+ *   const cost = estimateCostUSD("claude-sonnet-4.6", 5000, 1200)
+ */
+import type { MetricEvent } from "./token-metrics";
+/** Cost per million tokens in USD. */
+interface ModelPricing {
+    /** USD per 1M input tokens. */
+    input: number;
+    /** USD per 1M output tokens. */
+    output: number;
+}
+/**
+ * Resolve pricing for a model identifier string.
+ * Matching is case-insensitive prefix match; more specific prefixes take priority.
+ */
+export declare function getModelPricing(model: string): ModelPricing;
+/**
+ * Estimate USD cost for a single model call.
+ *
+ * @param model - Model identifier (e.g. "claude-sonnet-4.6", "gpt-4o")
+ * @param inputTokens - Number of input tokens (use estimateTokens() if char count only)
+ * @param outputTokens - Number of output tokens
+ * @returns Estimated cost in USD (unrounded — round at display time)
+ */
+export declare function estimateCostUSD(model: string, inputTokens: number, outputTokens: number): number;
+/**
+ * Estimate cost from raw character counts using the 4 chars/token heuristic.
+ * Convenience wrapper for callers that don't have token counts.
+ */
+export declare function estimateCostFromChars(model: string, inputChars: number, outputChars: number): number;
+export interface AgentCostEntry {
+    agent: string;
+    model_calls: number;
+    cache_hits: number;
+    retries: number;
+    est_input_tokens: number;
+    est_output_tokens: number;
+    est_cost_usd: number;
+}
+export interface StageCostEntry {
+    stage: string;
+    model_calls: number;
+    cache_hits: number;
+    retries: number;
+    est_input_tokens: number;
+    est_output_tokens: number;
+    est_cost_usd: number;
+    /** Fraction of total workflow cost (0–1). */
+    cost_fraction: number;
+}
+export interface CostReport {
+    workflow_id: string;
+    /** Per-agent breakdown. */
+    by_agent: AgentCostEntry[];
+    /** Per-stage breakdown. */
+    by_stage: StageCostEntry[];
+    totals: {
+        model_calls: number;
+        cache_hits: number;
+        retries: number;
+        est_input_tokens: number;
+        est_output_tokens: number;
+        est_cost_usd: number;
+        /** Tokens/$ saved by cache hits (based on avg per-call token count). */
+        cache_savings_est_usd: number;
+        /** Tokens/$ wasted by retries. */
+        retry_cost_est_usd: number;
+        cache_hit_rate: number;
+        retry_rate: number;
+    };
+    /** Sorted from most to least expensive. */
+    most_expensive_agents: string[];
+    most_expensive_stages: string[];
+}
+/**
+ * Build a cost report from MetricEvent[] for a given workflow.
+ *
+ * The caller is responsible for loading the events (from TOKEN_METRICS.jsonl).
+ * `defaultModel` is used when an event has no model field.
+ */
+export declare function buildCostReport(workflowId: string, events: MetricEvent[], defaultModel?: string): CostReport;
+/**
+ * Load MetricEvents from TOKEN_METRICS.jsonl for a workflow and build a CostReport.
+ * Convenience wrapper around buildCostReport for production use.
+ */
+export declare function getCostReport(dir: string, workflowId: string, defaultModel?: string): CostReport;
+/**
+ * Format a cost report as a human-readable summary string (for logging/display).
+ * Returns compact output — use for appLog or tool output.
+ */
+export declare function formatCostReport(report: CostReport): string;
+export {};
+//# sourceMappingURL=cost-estimator.d.ts.map

package/dist/services/cost-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../../src/services/cost-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAKlD,sCAAsC;AACtC,UAAU,YAAY;IACpB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;CACf;AAsDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,2BAA2B;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,2BAA2B;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,gBAAgB,EAAE,MAAM,CAAA;QACxB,iBAAiB,EAAE,MAAM,CAAA;QACzB,YAAY,EAAE,MAAM,CAAA;QACpB,wEAAwE;QACxE,qBAAqB,EAAE,MAAM,CAAA;QAC7B,kCAAkC;QAClC,kBAAkB,EAAE,MAAM,CAAA;QAC1B,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,EAAE,EACrB,YAAY,SAAK,GAChB,UAAU,CAyGZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,UAAU,CAe5F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAgB3D"}

package/dist/services/cost-estimator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cost-estimator.test.d.ts.map

package/dist/services/cost-estimator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.test.d.ts","sourceRoot":"","sources":["../../src/services/cost-estimator.test.ts"],"names":[],"mappings":""}

package/dist/services/draft-verifier.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Draft Verifier
+ *
+ * Implements draft-then-verify for agent calls. A cheap draft is checked
+ * against deterministic verifiers before deciding whether to escalate to
+ * an expensive model call.
+ *
+ * PHASE 1: Only rule-based (deterministic) verifiers are supported.
+ * Model-based verification is explicitly excluded to avoid turning 1 call into 2.
+ *
+ * Usage pattern:
+ *   1. Run cheap/draft agent → get draft response
+ *   2. Call verifyDraft(draft, verifiers)
+ *   3. If decision.accepted → return draft, skip expensive agent
+ *   4. If !decision.accepted → call expensive agent
+ */
+export type BuiltinVerifierType = "min_length" | "is_json" | "contains_key" | "matches_regex" | "is_nonempty" | "no_error_markers";
+export interface BuiltinVerifier {
+    type: BuiltinVerifierType;
+    /** min_length: minimum character count after trimming */
+    min_chars?: number;
+    /** contains_key: substring that must appear in the response */
+    required_key?: string;
+    /** matches_regex: regex pattern string */
+    pattern?: string;
+}
+export interface VerificationResult {
+    passed: boolean;
+    verifier: BuiltinVerifierType;
+    reason: string;
+}
+export interface DraftVerifyDecision {
+    /** True if all verifiers passed and the draft is acceptable. */
+    accepted: boolean;
+    verifications: VerificationResult[];
+    failures: number;
+}
+/**
+ * Run all verifiers against a draft response.
+ * ALL verifiers must pass for the draft to be accepted.
+ */
+export declare function verifyDraft(draft: string, verifiers: BuiltinVerifier[]): DraftVerifyDecision;
+/**
+ * Return a default set of verifiers for a given task output type.
+ * Use as a starting point — callers can extend or replace.
+ */
+export declare function defaultVerifiers(taskType: "json_response" | "prose_response" | "classification"): BuiltinVerifier[];
+//# sourceMappingURL=draft-verifier.d.ts.map

package/dist/services/draft-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-verifier.d.ts","sourceRoot":"","sources":["../../src/services/draft-verifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,SAAS,GACT,cAAc,GACd,eAAe,GACf,aAAa,GACb,kBAAkB,CAAA;AAEtB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAA;IACzB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,kBAAkB,EAAE,CAAA;IACnC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAiBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,mBAAmB,CAI5F;AAkFD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,GAC9D,eAAe,EAAE,CAsBnB"}

package/dist/services/draft-verifier.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=draft-verifier.test.d.ts.map

package/dist/services/draft-verifier.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-verifier.test.d.ts","sourceRoot":"","sources":["../../src/services/draft-verifier.test.ts"],"names":[],"mappings":""}

package/dist/services/index.d.ts

@@ -9,4 +9,17 @@ export * from "./agent-trace-graph";
 export * from "./delegation-budget";
 export * from "./deadlock-detector";
 export * from "./workflow-scorecard";
+export * from "./token-metrics";
+export * from "./model-router";
+export * from "./context-assembler";
+export * from "./prompt-cache";
+export * from "./rule-engine";
+export * from "./artifact-store";
+export * from "./task-batcher";
+export * from "./draft-verifier";
+export * from "./token-budget";
+export * from "./cost-estimator";
+export * from "./cost-budget";
+export * from "./rtk-manager";
+export * from "./rtk-policy";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,2BAA2B,CAAA;AACzC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA"}

package/dist/services/lazy-rule-loader.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Lazy Rule Loader
+ *
+ * Replaces the eager `loadRulePaths()` (loads all rule files) with two-phase discovery:
+ *
+ * 1. Discovery (cheap): reads frontmatter-only metadata from all rule files without
+ *    loading their full content. Results are cached per `rulesDir`.
+ *
+ * 2. Selection: filters rules by `always_on`, `languages`, and `stages` signals
+ *    derived from the project context.
+ *
+ * This eliminates unrelated language patterns (e.g. Java rules for a TypeScript
+ * project) and provides the infrastructure for future stage-based lazy loading.
+ *
+ * Rules without frontmatter are treated as always-on (fail-safe).
+ */
+/** Metadata parsed from a rule file's YAML frontmatter. */
+export interface RuleMetadata {
+    /** Absolute path to the rule file. */
+    path: string;
+    /** One-line description extracted from frontmatter. */
+    description: string;
+    /** If true, inject unconditionally regardless of stage/language. */
+    always_on: boolean;
+    /**
+     * Workflow stages this rule is relevant for (empty = all stages).
+     * Values: discuss | plan | execute | verify | fix-bug | write-docs
+     */
+    stages: string[];
+    /**
+     * Project languages this rule applies to (empty = all languages).
+     * Values: typescript | javascript | python | go | java | rust
+     */
+    languages: string[];
+}
+/** Context signals used to select rules. */
+export interface SelectionContext {
+    /** Detected project languages (e.g. ["typescript"]). */
+    languages?: string[];
+    /**
+     * Current workflow stage. When provided, stage-restricted rules are
+     * filtered to only those matching the stage.
+     * When absent (e.g. at plugin startup), stage-restricted rules are still
+     * included if they have no language restriction, or excluded if they require
+     * a specific language that isn't detected.
+     */
+    stage?: string;
+}
+/** Result of a rule selection pass. */
+export interface RuleSelection {
+    selected: RuleMetadata[];
+    skipped: RuleMetadata[];
+    /** Map from file path to human-readable selection reason. */
+    reasons: Record<string, string>;
+    total_discovered: number;
+}
+/**
+ * Parse a minimal YAML frontmatter block from markdown content.
+ * Supports string, boolean, and bracketed array values only.
+ * Returns an empty object if no `---` delimited frontmatter is found.
+ */
+export declare function parseFrontmatter(content: string): Record<string, unknown>;
+/**
+ * Scan a directory for `*.md` rule files and return their metadata (frontmatter only).
+ * Results are cached per `rulesDir` until `invalidateRuleCache()` is called.
+ */
+export declare function discoverRules(rulesDir: string): RuleMetadata[];
+/**
+ * Select which rule files should be loaded for the given context.
+ *
+ * Selection rules (evaluated in order):
+ *
+ * 1. `always_on: true` → always selected.
+ * 2. Language-restricted (`languages` non-empty):
+ *    - Selected if any detected project language matches.
+ *    - Skipped if no language match (eliminates foreign-language patterns).
+ * 3. Stage-restricted (`stages` non-empty, `stage` provided in context):
+ *    - Selected if the current stage matches.
+ *    - Skipped if stage doesn't match.
+ * 4. All other rules (no language, no stage restriction) → selected.
+ */
+export declare function selectRulePaths(rulesDir: string, context?: SelectionContext): RuleSelection;
+/**
+ * Convenience wrapper: returns the file paths to inject into `cfg.instructions`
+ * at plugin startup. Uses detected project languages for language-based filtering.
+ * Stage filtering is intentionally skipped at startup (stage is not known yet).
+ */
+export declare function getStartupRulePaths(rulesDir: string, detectedLanguages: string[]): string[];
+/**
+ * Detect the primary programming languages used in a project by inspecting
+ * known indicator files in the project root.
+ * Returns lowercase language names matching the `languages` field in rule frontmatter.
+ */
+export declare function detectProjectLanguages(projectRoot: string): string[];
+/**
+ * Build a human-readable diagnostic string for logging.
+ * Reports how many rules were discovered, selected, and skipped with reasons.
+ */
+export declare function buildSelectionDiagnostics(selection: RuleSelection, context: SelectionContext): string;
+/** Invalidate the discovery cache (call after rule files change, e.g. in tests). */
+export declare function invalidateRuleCache(): void;
+/** Return current cache entry count (for tests/telemetry). */
+export declare function getRuleCacheSize(): number;
+//# sourceMappingURL=lazy-rule-loader.d.ts.map

package/dist/services/lazy-rule-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-rule-loader.d.ts","sourceRoot":"","sources":["../../src/services/lazy-rule-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB;;;OAGG;IACH,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzE;AAkCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CA0B9D;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAiDf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,MAAM,EAAE,CAGV;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAiDpE;AAID;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAgBR;AAID,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/services/lazy-rule-loader.test.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Lazy Rule Loader Tests
+ *
+ * Covers:
+ * - parseFrontmatter: correctly parses always_on, stages, languages arrays, and description
+ * - discoverRules: finds all .md files, caches results, skips README.md
+ * - selectRulePaths: always_on rules always included
+ * - selectRulePaths: language-mismatched rules skipped
+ * - selectRulePaths: language-matched rules included
+ * - selectRulePaths: stage filtering when stage is provided
+ * - selectRulePaths: stage-restricted rules still included when stage is absent
+ * - selectRulePaths: rules without frontmatter treated as always_on (fail-safe)
+ * - getStartupRulePaths: returns paths only for selected rules
+ * - detectProjectLanguages: detects TypeScript via tsconfig.json
+ * - detectProjectLanguages: detects Python via requirements.txt
+ * - detectProjectLanguages: detects Go via go.mod
+ * - detectProjectLanguages: detects Rust via Cargo.toml
+ * - buildSelectionDiagnostics: includes discovered/selected/skipped counts
+ * - invalidateRuleCache: clears cached discovery results
+ * - repeated loading suppressed (same dir returns cached metadata)
+ */
+export {};
+//# sourceMappingURL=lazy-rule-loader.test.d.ts.map

package/dist/services/lazy-rule-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-rule-loader.test.d.ts","sourceRoot":"","sources":["../../src/services/lazy-rule-loader.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/services/model-router-ext.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-router-ext.test.d.ts.map

package/dist/services/model-router-ext.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router-ext.test.d.ts","sourceRoot":"","sources":["../../src/services/model-router-ext.test.ts"],"names":[],"mappings":""}

package/dist/services/model-router.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Model Router Service
+ *
+ * Classifies task complexity and maps agents to cost tiers.
+ * Routes cheap tasks away from expensive models and provides
+ * orchestrator-prompt slimming via stage-aware agent filtering.
+ *
+ * IMPORTANT: This service is telemetry/guidance only.
+ * It does NOT change which model OpenCode uses for each call.
+ * Actual model switching requires caller integration (flagged with TODO).
+ */
+export type TaskComplexity = "cheap" | "standard" | "expensive";
+export type AgentTier = "cheap" | "standard" | "expensive";
+export interface RoutingDecision {
+    complexity: TaskComplexity;
+    reason: string;
+    /** Agents that are appropriate for this complexity tier */
+    eligible_agents: string[];
+}
+export declare function classifyTaskComplexity(task: string): RoutingDecision;
+export declare function getTierForAgent(agentName: string): AgentTier;
+/**
+ * Returns the set of agents relevant to the given workflow stage.
+ * Returns undefined if the stage is unknown (caller should use full list).
+ */
+export declare function filterAgentsForStage(stage: string): string[] | undefined;
+/**
+ * Returns agent names to DISABLE for the given stage.
+ * Useful for `buildOrchestratorPrompt(disabledAgents)` which takes a disallow-set.
+ *
+ * @param stage - workflow stage name
+ * @param allAgents - complete list of registered agent names
+ */
+export declare function getDisabledAgentsForStage(stage: string, allAgents: string[]): Set<string>;
+/**
+ * Tally of agents that would be shown vs hidden for each stage.
+ * Used for reporting/telemetry.
+ */
+export declare function computePromptSlimmingStats(allAgents: string[]): Record<string, {
+    shown: number;
+    hidden: number;
+    saving_pct: number;
+}>;
+/**
+ * Return a soft output-format hint to prepend to prompts for cheap tasks.
+ * For cheap/classification tasks, requests compact JSON output to reduce prose.
+ * Returns an empty string for standard/expensive tasks (no constraint injected).
+ *
+ * This is guidance only — not enforced at the API level.
+ */
+export declare function getOutputFormatHint(complexity: TaskComplexity): string;
+//# sourceMappingURL=model-router.d.ts.map

package/dist/services/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../src/services/model-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAA;AAE/D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAA;AAE1D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,cAAc,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AAsCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAwBpE;AAoED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAE5D;AA2ED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAIxE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CASzF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAavE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAKtE"}

package/dist/services/model-router.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-router.test.d.ts.map

package/dist/services/model-router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.test.d.ts","sourceRoot":"","sources":["../../src/services/model-router.test.ts"],"names":[],"mappings":""}

package/dist/services/prompt-cache-ext.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt-cache-ext.test.d.ts.map

package/dist/services/prompt-cache-ext.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache-ext.test.d.ts","sourceRoot":"","sources":["../../src/services/prompt-cache-ext.test.ts"],"names":[],"mappings":""}

package/dist/services/prompt-cache.d.ts

@@ -0,0 +1,61 @@
+/** Agents that are safe to cache — pure read-only / idempotent analysis. */
+export declare const CACHEABLE_AGENTS: Set<string>;
+export interface CacheEntry {
+    key: string;
+    agent: string;
+    state_version: number;
+    index_version: number;
+    created_at: string;
+    ttl_ms: number;
+    response: string;
+}
+export interface CacheStats {
+    total_entries: number;
+    valid_entries: number;
+    expired_entries: number;
+    cache_size_bytes: number;
+}
+export declare function hashKey(agent: string, prompt: string, context: string, stateVersion: number, indexVersion: number): string;
+/**
+ * Normalize a prompt for fuzzy cache lookup.
+ * Collapses multiple whitespace characters to single spaces and trims.
+ * Only whitespace is normalized — punctuation and case are preserved
+ * to avoid false cache hits across semantically different queries.
+ */
+export declare function normalizeForCache(text: string): string;
+/**
+ * Like hashKey but using whitespace-normalized prompt and context.
+ * Used as a fallback after the exact key misses.
+ */
+export declare function hashKeyNormalized(agent: string, prompt: string, context: string, stateVersion: number, indexVersion: number): string;
+/**
+ * Retrieve a cached response.
+ *
+ * Lookup order:
+ * 1. Exact key (prompt.trim() + context.trim())
+ * 2. Whitespace-normalized key (collapses multiple spaces/newlines)
+ *
+ * Returns null when:
+ * - Agent is not in CACHEABLE_AGENTS
+ * - No entry exists under either key
+ * - Entry is expired
+ * - stateVersion or indexVersion don't match (state changed since cached)
+ */
+export declare function getCached(dir: string, agent: string, prompt: string, context: string, stateVersion: number, indexVersion: number, safe_to_cache?: boolean): string | null;
+/**
+ * Store a response in the cache.
+ *
+ * No-ops silently when:
+ * - safe_to_cache is false
+ * - Agent is not in CACHEABLE_AGENTS
+ */
+export declare function setCached(dir: string, agent: string, prompt: string, context: string, stateVersion: number, indexVersion: number, response: string, safe_to_cache?: boolean, ttl_ms?: number): void;
+/**
+ * Remove expired entries and trim to MAX_CACHE_ENTRIES.
+ * Called automatically on setCached.
+ */
+export declare function pruneExpired(dir: string): void;
+export declare function getCacheStats(dir: string): CacheStats;
+/** Force-invalidate all cache entries for a given directory (call after state writes). */
+export declare function invalidateCache(dir: string): void;
+//# sourceMappingURL=prompt-cache.d.ts.map