pulseed 0.5.3 → 0.6.0

package/dist/runtime/store/budget-store.js

@@ -0,0 +1,318 @@
+import { z } from "zod";
+import { createRuntimeStorePaths, } from "./runtime-paths.js";
+import { RuntimeJournal } from "./runtime-journal.js";
+export const RuntimeBudgetDimensionSchema = z.enum([
+    "wall_clock_ms",
+    "iterations",
+    "tasks",
+    "process_ms",
+    "disk_bytes",
+    "artifacts",
+    "llm_tokens",
+    "tool_calls",
+    "evaluator_attempts",
+]);
+export const RuntimeBudgetModeSchema = z.enum([
+    "exploration",
+    "consolidation",
+    "finalization",
+    "exhausted",
+]);
+export const RuntimeBudgetThresholdActionSchema = z.enum([
+    "approval_required",
+    "handoff_required",
+    "finalization_required",
+]);
+export const RuntimeBudgetScopeSchema = z.object({
+    goal_id: z.string().min(1).optional(),
+    run_id: z.string().min(1).optional(),
+}).strict().refine((scope) => Boolean(scope.goal_id || scope.run_id), {
+    message: "budget scope requires goal_id or run_id",
+});
+export const RuntimeBudgetLimitSchema = z.object({
+    dimension: RuntimeBudgetDimensionSchema,
+    limit: z.number().nonnegative(),
+    warn_at_remaining: z.number().nonnegative().optional(),
+    approval_at_remaining: z.number().nonnegative().optional(),
+    handoff_at_remaining: z.number().nonnegative().optional(),
+    finalization_at_remaining: z.number().nonnegative().optional(),
+    mode_transition_at_remaining: z.object({
+        consolidation: z.number().nonnegative().optional(),
+        finalization: z.number().nonnegative().optional(),
+    }).strict().optional(),
+    exhaustion_policy: z.enum(["stop", "approval_required", "handoff_required", "finalize"]).default("approval_required"),
+}).strict();
+export const RuntimeBudgetUsageSchema = z.object({
+    dimension: RuntimeBudgetDimensionSchema,
+    used: z.number().nonnegative(),
+    updated_at: z.string().datetime(),
+    recent: z.array(z.object({
+        amount: z.number().nonnegative(),
+        source: z.enum(["task_execution", "artifact_generation", "tool_usage", "evaluator_call", "manual"]),
+        reason: z.string().min(1).optional(),
+        observed_at: z.string().datetime(),
+    }).strict()).default([]),
+}).strict();
+export const RuntimeBudgetRecordSchema = z.object({
+    schema_version: z.literal("runtime-budget-v1"),
+    budget_id: z.string().min(1),
+    scope: RuntimeBudgetScopeSchema,
+    title: z.string().min(1).optional(),
+    created_at: z.string().datetime(),
+    updated_at: z.string().datetime(),
+    limits: z.array(RuntimeBudgetLimitSchema).min(1),
+    usage: z.array(RuntimeBudgetUsageSchema),
+    notes: z.string().min(1).optional(),
+}).strict().superRefine((budget, ctx) => {
+    const seenLimits = new Set();
+    for (const limit of budget.limits) {
+        if (seenLimits.has(limit.dimension)) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["limits", limit.dimension],
+                message: `duplicate budget limit dimension: ${limit.dimension}`,
+            });
+        }
+        seenLimits.add(limit.dimension);
+    }
+    const seenUsage = new Set();
+    for (const usage of budget.usage) {
+        if (seenUsage.has(usage.dimension)) {
+            ctx.addIssue({
+                code: "custom",
+                path: ["usage", usage.dimension],
+                message: `duplicate budget usage dimension: ${usage.dimension}`,
+            });
+        }
+        seenUsage.add(usage.dimension);
+    }
+});
+const RuntimeBudgetRecordRuntimeSchema = RuntimeBudgetRecordSchema;
+export class RuntimeBudgetStore {
+    paths;
+    journal;
+    now;
+    constructor(runtimeRootOrPaths, options = {}) {
+        this.paths =
+            typeof runtimeRootOrPaths === "string"
+                ? createRuntimeStorePaths(runtimeRootOrPaths)
+                : runtimeRootOrPaths ?? createRuntimeStorePaths();
+        this.journal = new RuntimeJournal(this.paths);
+        this.now = options.now ?? (() => new Date());
+    }
+    async load(budgetId) {
+        return this.journal.load(this.paths.budgetPath(budgetId), RuntimeBudgetRecordRuntimeSchema);
+    }
+    async list() {
+        return this.journal.list(this.paths.budgetsDir, RuntimeBudgetRecordRuntimeSchema);
+    }
+    async create(input) {
+        const existing = await this.load(input.budget_id);
+        if (existing)
+            throw new Error(`Runtime budget already exists: ${input.budget_id}`);
+        const createdAt = input.created_at ?? this.nowIso();
+        const usage = input.limits.map((limit) => ({
+            dimension: limit.dimension,
+            used: 0,
+            updated_at: createdAt,
+            recent: [],
+        }));
+        return this.save({
+            schema_version: "runtime-budget-v1",
+            budget_id: input.budget_id,
+            scope: input.scope,
+            ...(input.title ? { title: input.title } : {}),
+            created_at: createdAt,
+            updated_at: createdAt,
+            limits: input.limits.map((limit) => RuntimeBudgetLimitSchema.parse(limit)),
+            usage,
+            ...(input.notes ? { notes: input.notes } : {}),
+        });
+    }
+    async updateUsage(budgetId, input) {
+        if (input.amount < 0)
+            throw new Error("Budget usage amount must be non-negative");
+        return this.update(budgetId, (budget) => {
+            const observedAt = input.observed_at ?? this.nowIso();
+            const hasLimit = budget.limits.some((limit) => limit.dimension === input.dimension);
+            if (!hasLimit)
+                throw new Error(`Budget ${budgetId} has no limit for ${input.dimension}`);
+            const usageByDimension = new Map(budget.usage.map((usage) => [usage.dimension, usage]));
+            const existing = usageByDimension.get(input.dimension) ?? {
+                dimension: input.dimension,
+                used: 0,
+                updated_at: observedAt,
+                recent: [],
+            };
+            const nextUsage = {
+                ...existing,
+                used: existing.used + input.amount,
+                updated_at: observedAt,
+                recent: [
+                    {
+                        amount: input.amount,
+                        source: input.source,
+                        ...(input.reason ? { reason: input.reason } : {}),
+                        observed_at: observedAt,
+                    },
+                    ...existing.recent,
+                ].slice(0, 20),
+            };
+            usageByDimension.set(input.dimension, nextUsage);
+            return {
+                ...budget,
+                updated_at: observedAt,
+                usage: budget.limits.map((limit) => usageByDimension.get(limit.dimension) ?? {
+                    dimension: limit.dimension,
+                    used: 0,
+                    updated_at: observedAt,
+                    recent: [],
+                }),
+            };
+        });
+    }
+    async recordTaskExecution(budgetId, input) {
+        let budget = await this.mustLoad(budgetId);
+        for (const [dimension, amount] of [
+            ["iterations", input.iterations],
+            ["tasks", input.tasks],
+            ["process_ms", input.process_ms],
+            ["wall_clock_ms", input.wall_clock_ms],
+        ]) {
+            if (amount && amount > 0 && this.hasLimit(budget, dimension)) {
+                budget = await this.updateUsage(budgetId, { dimension, amount, source: "task_execution", observed_at: input.observed_at, reason: input.reason });
+            }
+        }
+        return budget;
+    }
+    async recordArtifactGeneration(budgetId, input) {
+        let budget = await this.mustLoad(budgetId);
+        for (const [dimension, amount] of [
+            ["disk_bytes", input.disk_bytes],
+            ["artifacts", input.artifacts],
+        ]) {
+            if (amount && amount > 0 && this.hasLimit(budget, dimension)) {
+                budget = await this.updateUsage(budgetId, { dimension, amount, source: "artifact_generation", observed_at: input.observed_at, reason: input.reason });
+            }
+        }
+        return budget;
+    }
+    async recordToolUsage(budgetId, input) {
+        let budget = await this.mustLoad(budgetId);
+        for (const [dimension, amount] of [
+            ["llm_tokens", input.llm_tokens],
+            ["tool_calls", input.tool_calls],
+        ]) {
+            if (amount && amount > 0 && this.hasLimit(budget, dimension)) {
+                budget = await this.updateUsage(budgetId, { dimension, amount, source: "tool_usage", observed_at: input.observed_at, reason: input.reason });
+            }
+        }
+        return budget;
+    }
+    async recordEvaluatorCall(budgetId, input) {
+        const attempts = input.attempts ?? 1;
+        return this.updateUsage(budgetId, {
+            dimension: "evaluator_attempts",
+            amount: attempts,
+            source: "evaluator_call",
+            observed_at: input.observed_at,
+            reason: input.reason,
+        });
+    }
+    status(budget) {
+        const usageByDimension = new Map(budget.usage.map((usage) => [usage.dimension, usage]));
+        const dimensions = budget.limits.map((limit) => {
+            const used = usageByDimension.get(limit.dimension)?.used ?? 0;
+            const remaining = Math.max(0, limit.limit - used);
+            const thresholdActions = thresholdActionsFor(limit, remaining, used);
+            return {
+                dimension: limit.dimension,
+                limit: limit.limit,
+                used,
+                remaining,
+                exhausted: used >= limit.limit,
+                exhaustion_policy: limit.exhaustion_policy,
+                threshold_actions: thresholdActions,
+            };
+        });
+        const recent = budget.usage.flatMap((usage) => usage.recent).sort((a, b) => b.observed_at.localeCompare(a.observed_at)).slice(0, 10);
+        const mode = budgetMode(budget.limits, dimensions);
+        return {
+            budget_id: budget.budget_id,
+            scope: budget.scope,
+            mode,
+            dimensions,
+            approval_required: dimensions.some((dimension) => dimension.threshold_actions.includes("approval_required")),
+            handoff_required: dimensions.some((dimension) => dimension.threshold_actions.includes("handoff_required")),
+            finalization_required: dimensions.some((dimension) => dimension.threshold_actions.includes("finalization_required")),
+            exhausted: dimensions.some((dimension) => dimension.exhausted),
+            recent_consumption: recent,
+        };
+    }
+    taskGenerationContext(budget) {
+        const status = this.status(budget);
+        return {
+            budget_id: status.budget_id,
+            scope: status.scope,
+            mode: status.mode,
+            exhausted: status.exhausted,
+            approval_required: status.approval_required,
+            handoff_required: status.handoff_required,
+            finalization_required: status.finalization_required,
+            remaining: Object.fromEntries(status.dimensions.map((dimension) => [dimension.dimension, dimension.remaining])),
+            recent_consumption: status.recent_consumption,
+        };
+    }
+    async mustLoad(budgetId) {
+        const budget = await this.load(budgetId);
+        if (!budget)
+            throw new Error(`Runtime budget not found: ${budgetId}`);
+        return budget;
+    }
+    hasLimit(budget, dimension) {
+        return budget.limits.some((limit) => limit.dimension === dimension);
+    }
+    async update(budgetId, updater) {
+        const budget = await this.mustLoad(budgetId);
+        return this.save(updater(budget));
+    }
+    async save(budget) {
+        return this.journal.save(this.paths.budgetPath(budget.budget_id), RuntimeBudgetRecordRuntimeSchema, budget);
+    }
+    nowIso() {
+        return this.now().toISOString();
+    }
+}
+function thresholdActionsFor(limit, remaining, used) {
+    const actions = new Set();
+    if (limit.approval_at_remaining !== undefined && remaining <= limit.approval_at_remaining)
+        actions.add("approval_required");
+    if (limit.handoff_at_remaining !== undefined && remaining <= limit.handoff_at_remaining)
+        actions.add("handoff_required");
+    if (limit.finalization_at_remaining !== undefined && remaining <= limit.finalization_at_remaining)
+        actions.add("finalization_required");
+    if (used >= limit.limit) {
+        if (limit.exhaustion_policy === "handoff_required")
+            actions.add("handoff_required");
+        if (limit.exhaustion_policy === "finalize")
+            actions.add("finalization_required");
+        if (limit.exhaustion_policy === "approval_required")
+            actions.add("approval_required");
+    }
+    return [...actions];
+}
+function budgetMode(limits, dimensions) {
+    if (dimensions.some((dimension) => dimension.exhausted))
+        return "exhausted";
+    let mode = "exploration";
+    for (const status of dimensions) {
+        const limit = limits.find((candidate) => candidate.dimension === status.dimension);
+        const transitions = limit?.mode_transition_at_remaining;
+        if (transitions?.finalization !== undefined && status.remaining <= transitions.finalization)
+            return "finalization";
+        if (transitions?.consolidation !== undefined && status.remaining <= transitions.consolidation)
+            mode = "consolidation";
+    }
+    return mode;
+}
+//# sourceMappingURL=budget-store.js.map

package/dist/runtime/store/budget-store.js.map

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

package/dist/runtime/store/dream-checkpoints.d.ts

@@ -0,0 +1,9 @@
+import type { RuntimeEvidenceDreamCheckpoint, RuntimeEvidenceEntry } from "./evidence-ledger.js";
+export interface RuntimeDreamCheckpointContext extends RuntimeEvidenceDreamCheckpoint {
+    entry_id: string;
+    occurred_at: string;
+    loop_index?: number;
+    phase?: string;
+}
+export declare function summarizeEvidenceDreamCheckpoints(entries: RuntimeEvidenceEntry[]): RuntimeDreamCheckpointContext[];
+//# sourceMappingURL=dream-checkpoints.d.ts.map

package/dist/runtime/store/dream-checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream-checkpoints.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/dream-checkpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,6BAA8B,SAAQ,8BAA8B;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,oBAAoB,EAAE,GAC9B,6BAA6B,EAAE,CAcjC"}

package/dist/runtime/store/dream-checkpoints.js

@@ -0,0 +1,16 @@
+export function summarizeEvidenceDreamCheckpoints(entries) {
+    const checkpoints = [];
+    for (const entry of entries) {
+        for (const checkpoint of entry.dream_checkpoints ?? []) {
+            checkpoints.push({
+                ...checkpoint,
+                entry_id: entry.id,
+                occurred_at: entry.occurred_at,
+                ...(entry.scope.loop_index !== undefined ? { loop_index: entry.scope.loop_index } : {}),
+                ...(entry.scope.phase ? { phase: entry.scope.phase } : {}),
+            });
+        }
+    }
+    return checkpoints.sort((a, b) => b.occurred_at.localeCompare(a.occurred_at));
+}
+//# sourceMappingURL=dream-checkpoints.js.map

package/dist/runtime/store/dream-checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream-checkpoints.js","sourceRoot":"","sources":["../../../src/runtime/store/dream-checkpoints.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,iCAAiC,CAC/C,OAA+B;IAE/B,MAAM,WAAW,GAAoC,EAAE,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;YACvD,WAAW,CAAC,IAAI,CAAC;gBACf,GAAG,UAAU;gBACb,QAAQ,EAAE,KAAK,CAAC,EAAE;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvF,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/runtime/store/evaluator-results.d.ts

@@ -0,0 +1,97 @@
+import type { RuntimeEvidenceArtifactRef, RuntimeEvidenceEntry, RuntimeEvidenceEvaluatorBudget, RuntimeEvidenceEvaluatorCalibration, RuntimeEvidenceEvaluatorCandidateSnapshot, RuntimeEvidenceEvaluatorObservation, RuntimeEvidenceEvaluatorProvenance, RuntimeEvidenceEvaluatorPublishAction, RuntimeEvidenceEvaluatorStatus } from "./evidence-ledger.js";
+type EvaluatorDirection = "maximize" | "minimize" | "neutral";
+export interface RuntimeEvaluatorObservationContext {
+    entry_id: string;
+    entry_kind: RuntimeEvidenceEntry["kind"];
+    occurred_at: string;
+    observed_at: string;
+    evaluator_id: string;
+    signal: "local" | "external";
+    source: string;
+    candidate_id: string;
+    candidate_label?: string;
+    artifact_labels: string[];
+    artifacts: RuntimeEvidenceArtifactRef[];
+    status: RuntimeEvidenceEvaluatorStatus;
+    score?: string | number | boolean | null;
+    score_label?: string;
+    direction?: EvaluatorDirection;
+    expected_score?: string | number | boolean | null;
+    expected_status?: RuntimeEvidenceEvaluatorStatus;
+    expectation_source?: string;
+    validation?: RuntimeEvidenceEvaluatorObservation["validation"];
+    publish_action?: RuntimeEvidenceEvaluatorPublishAction;
+    provenance?: RuntimeEvidenceEvaluatorProvenance;
+    budget?: RuntimeEvidenceEvaluatorBudget;
+    candidate_snapshot?: RuntimeEvidenceEvaluatorCandidateSnapshot;
+    calibration?: RuntimeEvidenceEvaluatorCalibration;
+    summary?: string;
+    raw_refs: RuntimeEvidenceEntry["raw_refs"];
+}
+export interface RuntimeEvaluatorApprovalRequiredAction extends Omit<RuntimeEvidenceEvaluatorPublishAction, "status"> {
+    status: "approval_required" | "approved" | "submitted" | "completed" | "blocked";
+    entry_id: string;
+    evaluator_id: string;
+    signal: "local" | "external";
+    source: string;
+    candidate_id: string;
+    observed_at: string;
+}
+export type RuntimeEvaluatorGapKind = "none" | "local_only" | "pending_external" | "external_success" | "external_regression" | "candidate_mismatch" | "inconclusive";
+export interface RuntimeEvaluatorGap {
+    kind: RuntimeEvaluatorGapKind;
+    summary: string;
+    evaluator_id?: string;
+    candidate_id?: string;
+    local_candidate_id?: string;
+    external_candidate_id?: string;
+    score_delta?: number;
+    direction?: EvaluatorDirection;
+}
+export interface RuntimeEvaluatorBudgetSummary {
+    evaluator_id: string;
+    source: string;
+    policy_id?: string;
+    max_attempts?: number;
+    used_attempts?: number;
+    remaining_attempts: number;
+    approval_required: boolean;
+    deadline_at?: string;
+    phase?: "exploration" | "consolidation" | "finalization" | "other";
+    diversified_portfolio_required: boolean;
+    reserve_for_finalization: boolean;
+    min_strategy_families?: number;
+    observed_at: string;
+}
+export interface RuntimeEvaluatorCalibrationContext {
+    evaluator_id: string;
+    source: string;
+    candidate_id: string;
+    observed_at: string;
+    local_evidence_entry_id?: string;
+    external_evidence_entry_id: string;
+    local_score?: number;
+    external_score?: number;
+    score_delta?: number;
+    direction?: EvaluatorDirection;
+    use_for_selection: boolean;
+    direct_optimization_allowed: false;
+    minimum_observations: number;
+    selection_adjustment: number;
+    conclusion: string;
+    provenance?: RuntimeEvidenceEvaluatorProvenance;
+    candidate_snapshot?: RuntimeEvidenceEvaluatorCandidateSnapshot;
+}
+export interface RuntimeEvaluatorSummary {
+    local_best: RuntimeEvaluatorObservationContext | null;
+    external_best: RuntimeEvaluatorObservationContext | null;
+    gap: RuntimeEvaluatorGap | null;
+    budgets: RuntimeEvaluatorBudgetSummary[];
+    calibration: RuntimeEvaluatorCalibrationContext[];
+    approval_required_actions: RuntimeEvaluatorApprovalRequiredAction[];
+    observations: RuntimeEvaluatorObservationContext[];
+}
+export declare function extractEvaluatorObservationsFromEvidence(entries: RuntimeEvidenceEntry[]): RuntimeEvaluatorObservationContext[];
+export declare function summarizeEvidenceEvaluatorResults(entries: RuntimeEvidenceEntry[]): RuntimeEvaluatorSummary;
+export {};
+//# sourceMappingURL=evaluator-results.d.ts.map

package/dist/runtime/store/evaluator-results.d.ts.map

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