taskflow-core 0.1.4 → 0.1.6

package/dist/scorers.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Scoring gates (`score`) — deterministic, composable output scorers.
+ *
+ * A `gate` phase may declare `score`: a list of zero-token deterministic
+ * scorers (exact-match, contains, regex, json-schema, length-range,
+ * code-compiles) evaluated against a target string, combined via
+ * `all`/`any`/`weighted` against a threshold. When the deterministic
+ * combination passes, the gate auto-passes with NO LLM call (mirroring the
+ * `eval` fast-path); when it fails, control falls to the optional `llm-judge`
+ * (`score.judge`) or the gate's regular `task`.
+ *
+ * This module is the PURE half (mirrors contract.ts): shape validation,
+ * the 5 string scorers, combination, and report formatting. The impure
+ * `code-compiles` scorer (spawns a compiler) lives in scorer-runtime.ts and
+ * is dispatched by the runtime — never imported here.
+ */
+export declare const SCORER_TYPES: readonly ["exact-match", "contains", "regex", "json-schema", "length-range", "code-compiles"];
+export type ScorerType = (typeof SCORER_TYPES)[number];
+export declare const SCORE_COMBINE_MODES: readonly ["all", "any", "weighted"];
+export type ScoreCombineMode = (typeof SCORE_COMBINE_MODES)[number];
+/** Default weighted-combine threshold (used when `score.threshold` is omitted). */
+export declare const SCORE_DEFAULT_THRESHOLD = 0.5;
+/** Languages the code-compiles scorer can check (see scorer-runtime.ts). */
+export declare const CODE_COMPILES_LANGUAGES: readonly ["javascript", "typescript"];
+export interface Scorer {
+    type: ScorerType;
+    /** Result label; defaults to `<type>-<index>`. */
+    name?: string;
+    /** [exact-match|contains] The string to compare/find. */
+    value?: string;
+    /** [regex] JS RegExp source. An invalid pattern fails the scorer (with detail). */
+    pattern?: string;
+    /** [regex] Invert the match result. */
+    negate?: boolean;
+    /** [json-schema] An `expect`-style contract for the parsed target. */
+    schema?: unknown;
+    /** [length-range] Inclusive bounds on target length (chars). */
+    min?: number;
+    max?: number;
+    /** [code-compiles] Which compiler to run. */
+    language?: (typeof CODE_COMPILES_LANGUAGES)[number];
+}
+export interface ScorerResult {
+    name: string;
+    type: ScorerType;
+    passed: boolean;
+    /** 0 or 1 for deterministic scorers; the judge's [0,1] score when present. */
+    score: number;
+    detail?: string;
+}
+/** The `score` field's shape (validated by scorerShapeErrors, not TypeBox —
+ *  keeps diagnostics precise and the surface documented in one place). */
+export interface ScoreConfig {
+    /** Interpolation ref for the scored string. Default: "{previous.output}". */
+    target?: string;
+    scorers: Scorer[];
+    combine?: ScoreCombineMode;
+    /** [weighted] Aligned to scorers (+1 trailing judge weight when judge present). */
+    weights?: number[];
+    /** [weighted] Combined score cutoff in (0, 1]. Default 0.5. */
+    threshold?: number;
+    /** Optional LLM-as-judge fallback, run only when the deterministics fail. */
+    judge?: {
+        agent?: string;
+        task: string;
+    };
+}
+/**
+ * Statically check an author-written `score` value. Returns human-readable
+ * shape errors ([] = valid). Total: never throws on arbitrary JSON-valid
+ * input. Mirrors contractShapeErrors (the `expect` validator).
+ */
+export declare function scorerShapeErrors(score: unknown, path?: string): string[];
+/** Default result label for a scorer. */
+export declare function scorerName(s: Scorer, index: number): string;
+/**
+ * Evaluate one PURE scorer against the target string. Total: never throws —
+ * an invalid configuration (e.g. a bad regex) fails the scorer with a detail.
+ * `code-compiles` is NOT handled here (impure — see scorer-runtime.ts).
+ */
+export declare function evaluatePureScorer(scorer: Scorer, index: number, target: string): ScorerResult;
+/**
+ * Combine deterministic scorer results per the combine mode. `judgeWeight`
+ * (weighted mode, judge configured but NOT yet run) enlarges the denominator
+ * so the deterministic-only combination is a LOWER BOUND: when it already
+ * clears the threshold, the judge's score could not change the outcome and
+ * the gate may auto-pass without spending judge tokens.
+ */
+export declare function combineScores(results: ScorerResult[], combine: ScoreCombineMode, weights?: number[], threshold?: number, judgeWeight?: number): {
+    combined: number;
+    passed: boolean;
+};
+/** Fold a completed judge result into a weighted combination (judge = last weight). */
+export declare function combineWithJudge(results: ScorerResult[], weights: number[] | undefined, threshold: number, judgeScore: number): {
+    combined: number;
+    passed: boolean;
+};
+/** Human-readable scorer report — appended to the judge/gate prompt so the
+ *  LLM sees exactly which deterministic checks failed and why. */
+export declare function formatScorerReport(results: ScorerResult[], combined: number, threshold?: number): string;
+/** The structured score result stored as the gate's `ps.json` — reachable
+ *  downstream via `{steps.<gate>.json.combined}` / `...json.results.0.passed`. */
+export declare function scoreResultJSON(results: ScorerResult[], combined: number, verdict: "pass" | "block", threshold?: number, judge?: {
+    score: number;
+    reason?: string;
+}): Record<string, unknown>;
+/**
+ * Parse an LLM judge's output into a score + verdict. Accepts JSON
+ * ({score: 0..1, verdict?, reason?}), bare {verdict}, or a text
+ * `SCORE: 0.x` / `VERDICT: PASS|BLOCK` marker. Fail-open per the project
+ * invariant: unparseable output PASSES with score 1 (ambiguity must not
+ * block the flow — same stance as parseGateVerdict).
+ */
+export declare function parseJudgeOutput(output: string): {
+    score: number;
+    verdict: "pass" | "block";
+    reason?: string;
+    parsed: boolean;
+};
+//# sourceMappingURL=scorers.d.ts.map

package/dist/scorers.d.ts.map

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

package/dist/scorers.js

@@ -0,0 +1,313 @@
+/**
+ * Scoring gates (`score`) — deterministic, composable output scorers.
+ *
+ * A `gate` phase may declare `score`: a list of zero-token deterministic
+ * scorers (exact-match, contains, regex, json-schema, length-range,
+ * code-compiles) evaluated against a target string, combined via
+ * `all`/`any`/`weighted` against a threshold. When the deterministic
+ * combination passes, the gate auto-passes with NO LLM call (mirroring the
+ * `eval` fast-path); when it fails, control falls to the optional `llm-judge`
+ * (`score.judge`) or the gate's regular `task`.
+ *
+ * This module is the PURE half (mirrors contract.ts): shape validation,
+ * the 5 string scorers, combination, and report formatting. The impure
+ * `code-compiles` scorer (spawns a compiler) lives in scorer-runtime.ts and
+ * is dispatched by the runtime — never imported here.
+ */
+import { contractShapeErrors, contractViolations } from "./contract.js";
+import { safeParse } from "./interpolate.js";
+export const SCORER_TYPES = ["exact-match", "contains", "regex", "json-schema", "length-range", "code-compiles"];
+export const SCORE_COMBINE_MODES = ["all", "any", "weighted"];
+/** Default weighted-combine threshold (used when `score.threshold` is omitted). */
+export const SCORE_DEFAULT_THRESHOLD = 0.5;
+/** Languages the code-compiles scorer can check (see scorer-runtime.ts). */
+export const CODE_COMPILES_LANGUAGES = ["javascript", "typescript"];
+/** Fields every scorer may carry, plus the per-type applicable ones. A field
+ *  set on a scorer whose type ignores it is a shape error — silently dropping
+ *  `{type:"contains", negate:true}` would let the author believe negation
+ *  happened. */
+const SCORER_COMMON_KEYS = ["type", "name"];
+const SCORER_TYPE_KEYS = {
+    "exact-match": ["value"],
+    contains: ["value"],
+    regex: ["pattern", "negate"],
+    "json-schema": ["schema"],
+    "length-range": ["min", "max"],
+    "code-compiles": ["language"],
+};
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * Statically check an author-written `score` value. Returns human-readable
+ * shape errors ([] = valid). Total: never throws on arbitrary JSON-valid
+ * input. Mirrors contractShapeErrors (the `expect` validator).
+ */
+export function scorerShapeErrors(score, path = "score") {
+    if (!isPlainObject(score))
+        return [`${path}: must be an object ({scorers: [...], combine?, threshold?, judge?})`];
+    const errors = [];
+    if (score.target !== undefined && typeof score.target !== "string")
+        errors.push(`${path}.target: must be a string interpolation ref (e.g. "{steps.gen.output}")`);
+    if (!Array.isArray(score.scorers) || score.scorers.length === 0) {
+        errors.push(`${path}.scorers: must be a non-empty array of scorers`);
+        return errors; // scorer-dependent checks below would be noise
+    }
+    score.scorers.forEach((s, i) => {
+        const p = `${path}.scorers[${i}]`;
+        if (!isPlainObject(s)) {
+            errors.push(`${p}: must be an object with a 'type'`);
+            return;
+        }
+        const t = s.type;
+        if (typeof t !== "string" || !SCORER_TYPES.includes(t)) {
+            errors.push(`${p}.type: must be one of ${SCORER_TYPES.join("|")}`);
+            return;
+        }
+        // Reject fields the scorer's type ignores (and unknown fields outright).
+        const allowed = new Set([...SCORER_COMMON_KEYS, ...SCORER_TYPE_KEYS[t]]);
+        for (const k of Object.keys(s)) {
+            if (!allowed.has(k))
+                errors.push(`${p}.${k}: not applicable to '${t}' scorers (allowed: ${[...allowed].join(", ")})`);
+        }
+        if (s.name !== undefined && typeof s.name !== "string")
+            errors.push(`${p}.name: must be a string`);
+        if ((t === "exact-match" || t === "contains") && typeof s.value !== "string")
+            errors.push(`${p}.value: required string for '${t}'`);
+        if (t === "regex") {
+            if (typeof s.pattern !== "string")
+                errors.push(`${p}.pattern: required string for 'regex'`);
+            if (s.negate !== undefined && typeof s.negate !== "boolean")
+                errors.push(`${p}.negate: must be a boolean`);
+        }
+        if (t === "json-schema") {
+            if (s.schema === undefined)
+                errors.push(`${p}.schema: required for 'json-schema'`);
+            else
+                errors.push(...contractShapeErrors(s.schema, `${p}.schema`));
+        }
+        if (t === "length-range") {
+            if (s.min === undefined && s.max === undefined)
+                errors.push(`${p}: 'length-range' requires 'min' and/or 'max'`);
+            if (s.min !== undefined && (typeof s.min !== "number" || s.min < 0))
+                errors.push(`${p}.min: must be a number >= 0`);
+            if (s.max !== undefined && (typeof s.max !== "number" || s.max < 0))
+                errors.push(`${p}.max: must be a number >= 0`);
+            if (typeof s.min === "number" && typeof s.max === "number" && s.min > s.max)
+                errors.push(`${p}: min (${s.min}) must be <= max (${s.max})`);
+        }
+        if (t === "code-compiles") {
+            if (typeof s.language !== "string" || !CODE_COMPILES_LANGUAGES.includes(s.language))
+                errors.push(`${p}.language: must be one of ${CODE_COMPILES_LANGUAGES.join("|")}`);
+        }
+    });
+    const combine = score.combine ?? "all";
+    if (typeof combine !== "string" || !SCORE_COMBINE_MODES.includes(combine)) {
+        errors.push(`${path}.combine: must be one of ${SCORE_COMBINE_MODES.join("|")}`);
+    }
+    else if (combine === "weighted") {
+        const judgeCount = isPlainObject(score.judge) ? 1 : 0;
+        const expected = score.scorers.length + judgeCount;
+        if (!Array.isArray(score.weights)) {
+            errors.push(`${path}.weights: required array for combine:"weighted" (${expected} entries${judgeCount ? " — last one is the judge's weight" : ""})`);
+        }
+        else {
+            if (score.weights.length !== expected)
+                errors.push(`${path}.weights: expected ${expected} entries (scorers${judgeCount ? " + judge" : ""}), got ${score.weights.length}`);
+            score.weights.forEach((w, i) => {
+                if (typeof w !== "number" || !Number.isFinite(w) || w <= 0)
+                    errors.push(`${path}.weights[${i}]: must be a number > 0`);
+            });
+        }
+        if (score.threshold !== undefined && (typeof score.threshold !== "number" || !(score.threshold > 0) || score.threshold > 1))
+            errors.push(`${path}.threshold: must be a number in (0, 1]`);
+    }
+    else {
+        if (score.weights !== undefined)
+            errors.push(`${path}.weights: only valid with combine:"weighted"`);
+        if (score.threshold !== undefined)
+            errors.push(`${path}.threshold: only valid with combine:"weighted"`);
+    }
+    if (score.judge !== undefined) {
+        if (!isPlainObject(score.judge))
+            errors.push(`${path}.judge: must be an object ({agent?, task})`);
+        else {
+            if (typeof score.judge.task !== "string" || !score.judge.task.trim())
+                errors.push(`${path}.judge.task: required non-empty string`);
+            if (score.judge.agent !== undefined && typeof score.judge.agent !== "string")
+                errors.push(`${path}.judge.agent: must be a string agent name`);
+        }
+    }
+    for (const k of Object.keys(score)) {
+        if (!["target", "scorers", "combine", "weights", "threshold", "judge"].includes(k))
+            errors.push(`${path}.${k}: unknown score keyword (supported: target, scorers, combine, weights, threshold, judge)`);
+    }
+    return errors;
+}
+/** Default result label for a scorer. */
+export function scorerName(s, index) {
+    return typeof s.name === "string" && s.name.trim() ? s.name.trim() : `${s.type}-${index}`;
+}
+/**
+ * Evaluate one PURE scorer against the target string. Total: never throws —
+ * an invalid configuration (e.g. a bad regex) fails the scorer with a detail.
+ * `code-compiles` is NOT handled here (impure — see scorer-runtime.ts).
+ */
+export function evaluatePureScorer(scorer, index, target) {
+    const name = scorerName(scorer, index);
+    const mk = (passed, detail) => ({
+        name,
+        type: scorer.type,
+        passed,
+        score: passed ? 1 : 0,
+        detail,
+    });
+    switch (scorer.type) {
+        case "exact-match": {
+            const passed = target === (scorer.value ?? "");
+            return mk(passed, passed ? undefined : `target (${target.length} chars) !== value (${(scorer.value ?? "").length} chars)`);
+        }
+        case "contains": {
+            const passed = target.includes(scorer.value ?? "");
+            return mk(passed, passed ? undefined : `target does not contain ${JSON.stringify(truncate(scorer.value ?? "", 80))}`);
+        }
+        case "regex": {
+            let re;
+            try {
+                re = new RegExp(scorer.pattern ?? "");
+            }
+            catch (e) {
+                return mk(false, `invalid pattern: ${e instanceof Error ? e.message : String(e)}`);
+            }
+            const matched = re.test(target);
+            const passed = scorer.negate === true ? !matched : matched;
+            return mk(passed, passed ? undefined : `/${scorer.pattern}/ ${scorer.negate ? "matched (negated)" : "did not match"}`);
+        }
+        case "json-schema": {
+            // Same lenient parse as the `expect` contract path (fence-extraction
+            // included) so a json-schema scorer and an expect contract agree on
+            // what "the JSON output" is.
+            const parsed = safeParse(target);
+            if (parsed === undefined)
+                return mk(false, "target is not valid JSON");
+            const violations = contractViolations(parsed, scorer.schema);
+            return mk(violations.length === 0, violations.length ? violations.join("; ") : undefined);
+        }
+        case "length-range": {
+            const len = target.length;
+            const min = typeof scorer.min === "number" ? scorer.min : 0;
+            const max = typeof scorer.max === "number" ? scorer.max : Infinity;
+            const passed = len >= min && len <= max;
+            return mk(passed, passed ? undefined : `length ${len} outside [${min}, ${max === Infinity ? "∞" : max}]`);
+        }
+        case "code-compiles":
+            // Dispatched by the runtime to scorer-runtime.ts; reaching here means
+            // the dispatch was missed — fail visibly rather than fake a pass.
+            return mk(false, "code-compiles must be evaluated by the runtime (impure scorer)");
+        default:
+            return mk(false, `unknown scorer type '${scorer.type}'`);
+    }
+}
+/**
+ * Combine deterministic scorer results per the combine mode. `judgeWeight`
+ * (weighted mode, judge configured but NOT yet run) enlarges the denominator
+ * so the deterministic-only combination is a LOWER BOUND: when it already
+ * clears the threshold, the judge's score could not change the outcome and
+ * the gate may auto-pass without spending judge tokens.
+ */
+export function combineScores(results, combine, weights, threshold = SCORE_DEFAULT_THRESHOLD, judgeWeight = 0) {
+    if (results.length === 0)
+        return { combined: 0, passed: false };
+    if (combine === "any") {
+        const passed = results.some((r) => r.passed);
+        return { combined: passed ? 1 : 0, passed };
+    }
+    if (combine === "weighted") {
+        const w = Array.isArray(weights) && weights.length >= results.length ? weights : results.map(() => 1);
+        let sum = 0;
+        let total = judgeWeight;
+        for (let i = 0; i < results.length; i++) {
+            const wi = typeof w[i] === "number" && w[i] > 0 ? w[i] : 1;
+            sum += results[i].score * wi;
+            total += wi;
+        }
+        const combined = total > 0 ? sum / total : 0;
+        return { combined, passed: combined >= threshold };
+    }
+    // "all" (default)
+    const passed = results.every((r) => r.passed);
+    return { combined: passed ? 1 : 0, passed };
+}
+/** Fold a completed judge result into a weighted combination (judge = last weight). */
+export function combineWithJudge(results, weights, threshold, judgeScore) {
+    const w = Array.isArray(weights) && weights.length === results.length + 1 ? weights : [...results.map(() => 1), 1];
+    let sum = 0;
+    let total = 0;
+    for (let i = 0; i < results.length; i++) {
+        sum += results[i].score * w[i];
+        total += w[i];
+    }
+    const jw = w[results.length];
+    sum += Math.max(0, Math.min(1, judgeScore)) * jw;
+    total += jw;
+    const combined = total > 0 ? sum / total : 0;
+    return { combined, passed: combined >= threshold };
+}
+/** Human-readable scorer report — appended to the judge/gate prompt so the
+ *  LLM sees exactly which deterministic checks failed and why. */
+export function formatScorerReport(results, combined, threshold) {
+    const lines = results.map((r) => `- [${r.passed ? "PASS" : "FAIL"}] ${r.name} (${r.type})${r.detail ? `: ${r.detail}` : ""}`);
+    const summary = threshold !== undefined
+        ? `Combined score: ${combined.toFixed(3)} (threshold ${threshold})`
+        : `Combined score: ${combined.toFixed(3)}`;
+    return `## Deterministic scorer report\n${lines.join("\n")}\n${summary}`;
+}
+/** The structured score result stored as the gate's `ps.json` — reachable
+ *  downstream via `{steps.<gate>.json.combined}` / `...json.results.0.passed`. */
+export function scoreResultJSON(results, combined, verdict, threshold, judge) {
+    const out = { verdict, combined, results };
+    if (threshold !== undefined)
+        out.threshold = threshold;
+    if (judge)
+        out.judge = judge;
+    return out;
+}
+/**
+ * Parse an LLM judge's output into a score + verdict. Accepts JSON
+ * ({score: 0..1, verdict?, reason?}), bare {verdict}, or a text
+ * `SCORE: 0.x` / `VERDICT: PASS|BLOCK` marker. Fail-open per the project
+ * invariant: unparseable output PASSES with score 1 (ambiguity must not
+ * block the flow — same stance as parseGateVerdict).
+ */
+export function parseJudgeOutput(output) {
+    const clamp = (n) => Math.max(0, Math.min(1, n));
+    const json = safeParse(output);
+    if (json && typeof json === "object" && !Array.isArray(json)) {
+        const o = json;
+        const reason = typeof o.reason === "string" && o.reason.trim() ? o.reason.trim() : undefined;
+        const rawScore = typeof o.score === "number" ? o.score : typeof o.score === "string" ? Number(o.score) : NaN;
+        const hasScore = Number.isFinite(rawScore);
+        if (typeof o.verdict === "string") {
+            const block = /block|fail|stop|reject|halt/i.test(o.verdict);
+            return { score: hasScore ? clamp(rawScore) : block ? 0 : 1, verdict: block ? "block" : "pass", reason, parsed: true };
+        }
+        if (hasScore) {
+            const s = clamp(rawScore);
+            return { score: s, verdict: s >= 0.5 ? "pass" : "block", reason, parsed: true };
+        }
+    }
+    const scoreMatches = [...output.matchAll(/SCORE\s*[:=]\s*([01](?:\.\d+)?)/gi)];
+    const verdictMatches = [...output.matchAll(/VERDICT\s*[:=]\s*(PASS|BLOCK|FAIL|STOP|OK|REJECT|HALT)/gi)];
+    if (scoreMatches.length || verdictMatches.length) {
+        const s = scoreMatches.length ? clamp(Number(scoreMatches[scoreMatches.length - 1][1])) : undefined;
+        const v = verdictMatches.length ? verdictMatches[verdictMatches.length - 1][1].toUpperCase() : undefined;
+        const blocked = v !== undefined ? !(v === "PASS" || v === "OK") : (s ?? 1) < 0.5;
+        return { score: s ?? (blocked ? 0 : 1), verdict: blocked ? "block" : "pass", parsed: true };
+    }
+    // Fail-open: ambiguous judge output must not block the flow.
+    return { score: 1, verdict: "pass", reason: "unparseable judge output (fail-open pass)", parsed: false };
+}
+function truncate(s, n) {
+    return s.length <= n ? s : `${s.slice(0, n)}…`;
+}
+//# sourceMappingURL=scorers.js.map

package/dist/scorers.js.map

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

package/dist/store.d.ts

@@ -16,6 +16,8 @@
 import type { Taskflow } from "./schema.ts";
 import type { UsageStats } from "./usage.ts";
 import type { DeclaredDeps } from "./flowir/meta.ts";
+import type { ScorerResult } from "./scorers.ts";
+import type { FlowMeta } from "./library/types.ts";
 export interface SavedFlow {
     name: string;
     scope: "user" | "project";
@@ -53,7 +55,20 @@ export interface PhaseState {
     gate?: {
         verdict: "pass" | "block";
         reason?: string;
+        /** Deterministic scorer results (score gates only). Present whenever the
+         *  gate declared `score` and the scorers actually ran. `combined` is the
+         *  [0,1] combined score; `threshold` echoes the configured cutoff. */
+        scores?: {
+            results: ScorerResult[];
+            combined: number;
+            threshold?: number;
+        };
     };
+    /** True when this phase declared `idempotent: false` (irreversible side
+     *  effects). Such a phase is never cached (in any scope) and transient
+     *  provider errors are not auto-retried. De facto mutually exclusive with
+     *  `cacheHit` (caching is disabled for side-effecting phases). */
+    sideEffect?: true;
     /** Total subagent attempts incl. retries (when > calls, a retry happened). */
     attempts?: number;
     /** True when the phase's `timeout` cap expired and the subagent was aborted.
@@ -69,10 +84,19 @@ export interface PhaseState {
         note?: string;
         auto?: boolean;
     };
-    /** Loop iteration accounting (loop phases only). */
+    /** Loop iteration accounting (loop phases only). `reflexion` is the last
+     *  failure summary injected into an iteration (audit trail for reflexion loops).
+     *  `failures` records each failed iteration's (sanitized) error — useful when a
+     *  reflexion loop continues past failures and only the terminal one would
+     *  otherwise survive in `error`. Bounded (most-recent kept). */
     loop?: {
         iterations: number;
         stop: "until" | "converged" | "maxIterations" | "failed" | "aborted";
+        reflexion?: string;
+        failures?: Array<{
+            iteration: number;
+            error: string;
+        }>;
     };
     /** Tournament outcome (tournament phases only). */
     tournament?: {
@@ -175,6 +199,16 @@ export declare function validateRunId(runId: string): boolean;
  * Execute `fn` while holding a file lock.  Guarantees release even on throw.
  */
 export declare function withLock<T>(lockPath: string, fn: () => T): T;
+/**
+ * Read a flow definition from a file on disk. Supports raw JSON or a Markdown
+ * document with a fenced ```json block (reuses safeParse). Used by the
+ * `defineFile` parameter so verify/compile/run can share one persisted draft
+ * (e.g. in the OS temp dir) without saving it into the project's .pi/taskflows.
+ *
+ * Returns the parsed definition (object/array/shorthand), or null if the file
+ * can't be read or parsed. Callers surface an explicit error in that case.
+ */
+export declare function readDefineFile(filePath: string): unknown;
 /** List all saved flows (project overrides user on name collision). */
 /** Internal-but-exported for tests: walk-up `.pi` finder with home-dir stop. */
 export declare function findProjectFlowsDir(cwd: string, create?: boolean): string | null;
@@ -183,6 +217,27 @@ export declare function getFlow(cwd: string, name: string): SavedFlow | null;
 export declare function saveFlow(cwd: string, def: Taskflow, scope?: "user" | "project"): {
     filePath: string;
 };
+/** Path to a flow's library sidecar. Uses the SAME safeFlowDirName as the flow
+ *  file itself (N1 fix) so path-safety normalization is consistent. */
+export declare function sidecarPathFor(cwd: string, flowName: string, scope?: "user" | "project"): string;
+/** Read a flow's library sidecar. Returns null if missing/unparseable. */
+export declare function readMeta(cwd: string, flowName: string): FlowMeta | null;
+/** Read a sidecar next to a specific flow file (avoids name→scope lookup when
+ *  we already have the SavedFlow from listFlows). */
+export declare function readMetaNextTo(flowFilePath: string): FlowMeta | null;
+/** Write a flow + its sidecar atomically (same withLock critical section — R2).
+ *  Embedding (Phase 2) is computed by the caller BEFORE this call and passed in
+ *  via meta; this function does only synchronous I/O under the lock (R2R3). */
+export declare function saveFlowWithMeta(cwd: string, def: Taskflow, meta: FlowMeta, scope?: "user" | "project"): {
+    filePath: string;
+    metaPath: string;
+};
+/** Bump reuseCount/lastUsedAt for a flow's sidecar. Idempotent under the flow
+ *  lock. If no sidecar exists yet, creates a minimal one carrying just the
+ *  reuse bookkeeping (structural fields are filled next time the flow is
+ *  re-saved with deriveMeta). Returns the new reuseCount, or null if the flow
+ *  itself doesn't exist. */
+export declare function bumpReuseInSidecar(cwd: string, flowName: string): number | null;
 export declare function runsDir(cwd: string): string;
 /** Root dir for the cross-run memoization cache (sibling of `runs`). */
 export declare function cacheDir(cwd: string): string;

package/dist/store.d.ts.map

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