opencandle 0.4.0 → 0.5.0

package/dist/runtime/answer-contracts.js

@@ -0,0 +1,414 @@
+export const COMMITMENT_MODE_CONTRACTS = {
+    decision: {
+        mode: "decision",
+        requiredFinalFields: ["clear_commitment", "risk_downside"],
+        requiresConcreteCommitment: true,
+        description: "Make a clear call with major risks and conditions.",
+    },
+    compare_tradeoffs: {
+        mode: "compare_tradeoffs",
+        requiredFinalFields: ["comparison_tradeoffs", "risk_downside"],
+        requiresConcreteCommitment: false,
+        description: "Compare options without converting the task into construction unless requested.",
+    },
+    framework: {
+        mode: "framework",
+        requiredFinalFields: ["framework_or_checklist"],
+        requiresConcreteCommitment: false,
+        description: "Give a useful framework or checklist without inventing current facts.",
+    },
+    construct: {
+        mode: "construct",
+        requiredFinalFields: ["constructed_output", "risk_downside"],
+        requiresConcreteCommitment: true,
+        description: "Construct the requested allocation, screen, or plan.",
+    },
+    update_state: {
+        mode: "update_state",
+        requiredFinalFields: ["state_update_confirmation"],
+        requiresConcreteCommitment: false,
+        description: "Confirm the state change and preserve relevant context.",
+    },
+    clarify: {
+        mode: "clarify",
+        requiredFinalFields: ["clarifying_question"],
+        requiresConcreteCommitment: false,
+        description: "Ask only for the missing information required to proceed.",
+    },
+};
+export const ANSWER_CONTRACT_REGISTRY = {
+    single_asset_decision: {
+        id: "single_asset_decision",
+        taskFamily: "single_asset_decision",
+        commitmentMode: "decision",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["clear_commitment", "risk_downside", "freshness_disclosure", "data_gap_disclosure"],
+        requiresFreshness: true,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: true,
+        requiresSourceCoverage: false,
+        requiresConcreteCommitment: true,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    },
+    asset_compare_tradeoff: {
+        id: "asset_compare_tradeoff",
+        taskFamily: "asset_compare",
+        commitmentMode: "compare_tradeoffs",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["comparison_tradeoffs", "risk_downside", "data_gap_disclosure", "source_coverage"],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: true,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: ["etf_holdings_overlap"],
+        frameworkFallback: "not_allowed",
+    },
+    portfolio_build: placeholderContract("portfolio_build", "portfolio_build", "construct", ["constructed_output"]),
+    portfolio_review: {
+        id: "portfolio_review",
+        taskFamily: "portfolio_review",
+        commitmentMode: "decision",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: [
+            "clear_commitment",
+            "risk_downside",
+            "framework_or_checklist",
+            "data_gap_disclosure",
+            "source_coverage",
+        ],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: true,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: true,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    },
+    macro_allocation_review: {
+        id: "macro_allocation_review",
+        taskFamily: "macro_allocation_review",
+        commitmentMode: "decision",
+        implemented: true,
+        requiredEvidenceTypes: ["market_status"],
+        requiredFinalFields: [
+            "clear_commitment",
+            "risk_downside",
+            "framework_or_checklist",
+            "freshness_disclosure",
+            "data_gap_disclosure",
+            "source_coverage",
+        ],
+        requiresFreshness: true,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: true,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: true,
+        capabilityGapIds: ["market_calendar", "forward_rate_probabilities"],
+        frameworkFallback: "not_allowed",
+    },
+    options_strategy: {
+        id: "options_strategy",
+        taskFamily: "options_strategy",
+        commitmentMode: "decision",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: [
+            "clear_commitment",
+            "risk_downside",
+            "freshness_disclosure",
+            "data_gap_disclosure",
+            "source_coverage",
+        ],
+        requiresFreshness: true,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: true,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: true,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    },
+    backtest_review: {
+        id: "backtest_review",
+        taskFamily: "backtest_review",
+        commitmentMode: "framework",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["framework_or_checklist", "risk_downside", "data_gap_disclosure", "source_coverage"],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: true,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    },
+    stateful_tracking_update: {
+        id: "stateful_tracking_update",
+        taskFamily: "stateful_tracking_update",
+        commitmentMode: "update_state",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["state_update_confirmation", "data_gap_disclosure"],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: false,
+        requiresSourceCoverage: false,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    },
+    current_event_explanation: {
+        id: "current_event_explanation",
+        taskFamily: "current_event_explanation",
+        commitmentMode: "framework",
+        implemented: true,
+        requiredEvidenceTypes: ["market_status"],
+        requiredFinalFields: ["framework_or_checklist", "freshness_disclosure", "source_coverage", "data_gap_disclosure"],
+        requiresFreshness: true,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: false,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: ["market_calendar"],
+        frameworkFallback: "not_allowed",
+    },
+    ticker_disambiguation: {
+        id: "ticker_disambiguation",
+        taskFamily: "ticker_disambiguation",
+        commitmentMode: "framework",
+        implemented: true,
+        requiredEvidenceTypes: ["ticker_disambiguation"],
+        requiredFinalFields: [
+            "symbol_verification_disclosure",
+            "framework_or_checklist",
+            "data_gap_disclosure",
+            "risk_downside",
+        ],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: true,
+        requiresSourceCoverage: false,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: ["earnings_event_risk"],
+        frameworkFallback: "diagnostic_until_parity",
+    },
+    sentiment_snapshot: {
+        id: "sentiment_snapshot",
+        taskFamily: "sentiment_snapshot",
+        commitmentMode: "framework",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["source_coverage", "data_gap_disclosure"],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: false,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: ["sentiment_sample_depth"],
+        frameworkFallback: "not_allowed",
+    },
+    filing_thesis_review: {
+        id: "filing_thesis_review",
+        taskFamily: "filing_thesis_review",
+        commitmentMode: "framework",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["source_coverage", "data_gap_disclosure", "framework_or_checklist"],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: false,
+        requiresSourceCoverage: true,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    },
+    retail_tradeoff_framework: {
+        id: "retail_tradeoff_framework",
+        taskFamily: "retail_finance_tradeoff",
+        commitmentMode: "framework",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["comparison_tradeoffs", "data_gap_disclosure", "framework_or_checklist"],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: true,
+        requiresRiskDownside: false,
+        requiresSourceCoverage: false,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: ["brokerage_comparison", "cash_yield_products", "fund_tax_efficiency"],
+        frameworkFallback: "not_allowed",
+    },
+    concept_explainer: {
+        id: "concept_explainer",
+        taskFamily: "concept_explainer",
+        commitmentMode: "framework",
+        implemented: true,
+        requiredEvidenceTypes: [],
+        requiredFinalFields: ["framework_or_checklist"],
+        requiresFreshness: false,
+        requiresDataGapDisclosure: false,
+        requiresRiskDownside: false,
+        requiresSourceCoverage: false,
+        requiresConcreteCommitment: false,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    },
+    general_fallback: placeholderContract("general_fallback", "general_fallback", "framework", ["data_gap_disclosure"]),
+};
+export function runStructuredChecks(input) {
+    const requestedChecks = new Set(input.structuredCheckIds ?? []);
+    const results = [
+        checkRequiredEvidence(input.contract, input.evidenceRecords),
+        checkFreshness(input.contract, input.finalAnswerMetadata),
+        checkDataGapDisclosure(input.contract, input.evidenceRecords, input.finalAnswerMetadata),
+        checkCommitmentMode(input.contract, input.finalAnswerMetadata),
+        checkSourceCoverage(input.contract, input.finalAnswerMetadata),
+        checkCapabilityGapDisclosure(input.contract, input.evidenceRecords, input.finalAnswerMetadata),
+        ...semanticChecks(requestedChecks, input.answerText),
+    ];
+    const failures = results.filter((result) => !result.passed);
+    const retryReasons = failures.map((failure) => `${failure.checkId}: ${failure.failureReason ?? "failed"}`);
+    return {
+        mode: "observe_only",
+        answerContractId: input.contract.id,
+        results,
+        failures,
+        retryEligibility: {
+            eligible: failures.length > 0,
+            activeRetryAllowed: false,
+            reasons: retryReasons,
+        },
+        activeRetryAllowed: false,
+    };
+}
+function semanticChecks(requestedChecks, answerText) {
+    const checks = [];
+    if (requestedChecks.has("assumption_disclosed")) {
+        checks.push(checkAnswerText("assumption_disclosed", answerText, /\b(?:assuming|assumption|assuming that|if your|based on your stated|given your stated)\b/i, "Explicit assumption disclosure is missing."));
+    }
+    if (requestedChecks.has("tax_caveat_present")) {
+        checks.push(checkAnswerText("tax_caveat_present", answerText, /\b(?:tax|taxable|after[-\s]?tax|capital gains?|ordinary income|qualified dividend|tax advisor|jurisdiction|account type)\b/i, "Tax/account caveat is missing."));
+    }
+    if (requestedChecks.has("target_bands_present")) {
+        checks.push(checkAnswerText("target_bands_present", answerText, /\b(?:target bands?|bands?|range|threshold|drift|5\s*%|percentage points?)\b/i, "Target band, range, or rebalance threshold guidance is missing."));
+    }
+    if (requestedChecks.has("when_not_ideal_present")) {
+        checks.push(checkAnswerText("when_not_ideal_present", answerText, /\b(?:not ideal|avoid|bad fit|poor fit|when this fails|where it fails|doesn'?t work|not suitable|watch out)\b/i, "When-not-ideal or unsuitability guidance is missing."));
+    }
+    return checks;
+}
+function checkAnswerText(checkId, answerText, pattern, failureReason) {
+    const passed = typeof answerText === "string" && pattern.test(answerText);
+    return structuredResult(checkId, passed, passed ? undefined : failureReason);
+}
+export function evaluateFrameworkFallbackEligibility(input) {
+    if (input.contract.frameworkFallback === "not_allowed") {
+        return {
+            eligible: false,
+            active: false,
+            mode: "not_applicable",
+            reason: "Contract does not allow framework fallback.",
+        };
+    }
+    const hasUnresolvedSymbol = input.evidenceRecords.some((record) => record.evidenceType === "ticker_disambiguation" &&
+        (record.caveats.length > 0 || record.entityScope.symbols === undefined || record.entityScope.symbols.length === 0));
+    if (!hasUnresolvedSymbol) {
+        return {
+            eligible: false,
+            active: false,
+            mode: "not_applicable",
+            reason: "No unresolved selected-slice evidence gap was observed.",
+        };
+    }
+    const parityAllowsActive = input.parityStatus === "replacement_active" || input.parityStatus === "legacy_removed";
+    return {
+        eligible: true,
+        active: parityAllowsActive,
+        mode: parityAllowsActive ? "active" : "diagnostic_only",
+        reason: parityAllowsActive
+            ? "Selected-slice parity permits active framework fallback."
+            : "Selected-slice fallback is recorded diagnostically until parity passes.",
+    };
+}
+function placeholderContract(id, taskFamily, commitmentMode, requiredFinalFields) {
+    return {
+        id,
+        taskFamily,
+        commitmentMode,
+        implemented: false,
+        requiredEvidenceTypes: [],
+        requiredFinalFields,
+        requiresFreshness: false,
+        requiresDataGapDisclosure: requiredFinalFields.includes("data_gap_disclosure"),
+        requiresRiskDownside: requiredFinalFields.includes("risk_downside"),
+        requiresSourceCoverage: requiredFinalFields.includes("source_coverage"),
+        requiresConcreteCommitment: COMMITMENT_MODE_CONTRACTS[commitmentMode].requiresConcreteCommitment,
+        capabilityGapIds: [],
+        frameworkFallback: "not_allowed",
+    };
+}
+function checkRequiredEvidence(contract, evidenceRecords) {
+    const evidenceTypes = new Set(evidenceRecords.map((record) => record.evidenceType));
+    const missing = contract.requiredEvidenceTypes.filter((type) => !evidenceTypes.has(type));
+    return structuredResult("required_evidence_present", missing.length === 0, missing.length > 0 ? `Missing evidence types: ${missing.join(", ")}` : undefined);
+}
+function checkFreshness(contract, metadata) {
+    if (!contract.requiresFreshness)
+        return structuredResult("freshness_disclosed", true);
+    const present = metadata.finalFields.includes("freshness_disclosure") && metadata.freshness !== undefined;
+    return structuredResult("freshness_disclosed", present, present ? undefined : "Freshness metadata or freshness disclosure field is missing.");
+}
+function checkDataGapDisclosure(contract, evidenceRecords, metadata) {
+    if (!contract.requiresDataGapDisclosure)
+        return structuredResult("data_gap_disclosed", true);
+    const evidenceHasGaps = evidenceRecords.some((record) => record.gaps.length > 0);
+    const fieldPresent = metadata.finalFields.includes("data_gap_disclosure");
+    const disclosedProvider = (metadata.disclosedProviderStatuses?.length ?? 0) > 0;
+    const disclosedCapability = (metadata.disclosedCapabilityGapIds?.length ?? 0) > 0;
+    const passed = fieldPresent && (!evidenceHasGaps || disclosedProvider || disclosedCapability);
+    return structuredResult("data_gap_disclosed", passed, passed ? undefined : "Data-gap disclosure metadata does not cover observed evidence gaps.");
+}
+function checkCommitmentMode(contract, metadata) {
+    const modeContract = COMMITMENT_MODE_CONTRACTS[contract.commitmentMode];
+    const fields = new Set(metadata.finalFields);
+    const requiredFieldsPresent = modeContract.requiredFinalFields.every((field) => fields.has(field));
+    const passed = metadata.commitmentMode === contract.commitmentMode &&
+        requiredFieldsPresent &&
+        (!contract.requiresConcreteCommitment || fields.has("clear_commitment"));
+    return structuredResult("commitment_mode_respected", passed, passed ? undefined : `Expected ${contract.commitmentMode} metadata and fields: ${modeContract.requiredFinalFields.join(", ")}`);
+}
+function checkSourceCoverage(contract, metadata) {
+    if (!contract.requiresSourceCoverage)
+        return structuredResult("source_coverage_disclosed", true);
+    const present = metadata.finalFields.includes("source_coverage") &&
+        metadata.sourceCoverage !== undefined &&
+        metadata.sourceCoverage.sources.length > 0;
+    return structuredResult("source_coverage_disclosed", present, present ? undefined : "Source-coverage metadata is missing.");
+}
+function checkCapabilityGapDisclosure(contract, evidenceRecords, metadata) {
+    const required = new Set(contract.capabilityGapIds);
+    for (const record of evidenceRecords) {
+        for (const gap of record.gaps) {
+            if (gap.capabilityGapId)
+                required.add(gap.capabilityGapId);
+        }
+    }
+    if (required.size === 0)
+        return structuredResult("capability_gap_disclosure", true);
+    const disclosed = new Set(metadata.disclosedCapabilityGapIds ?? []);
+    const missing = [...required].filter((gapId) => !disclosed.has(gapId));
+    return structuredResult("capability_gap_disclosure", missing.length === 0, missing.length > 0 ? `Missing capability-gap disclosures: ${missing.join(", ")}` : undefined);
+}
+function structuredResult(checkId, passed, failureReason) {
+    return {
+        checkId,
+        passed,
+        observedOnly: true,
+        failureReason,
+    };
+}
+//# sourceMappingURL=answer-contracts.js.map

package/dist/runtime/answer-contracts.js.map

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

package/dist/runtime/artifact-contracts.d.ts

@@ -0,0 +1,14 @@
+import type { PolicyCardId, TaskFamily } from "../routing/planning.js";
+export type ArtifactContractId = "concept_example_table" | "portfolio_exposure_map" | "rebalance_action_plan" | "source_coverage_table";
+export interface ArtifactContractDefinition {
+    id: ArtifactContractId;
+    taskFamilies: TaskFamily[];
+    description: string;
+    status: "trace_only";
+}
+export declare const ARTIFACT_CONTRACT_REGISTRY: Record<ArtifactContractId, ArtifactContractDefinition>;
+export declare function artifactContractIdsForPlanning(input: {
+    taskFamily: TaskFamily;
+    policyCardId: PolicyCardId;
+}): ArtifactContractId[];
+export declare function validateArtifactContractRegistry(): string[];

package/dist/runtime/artifact-contracts.js

@@ -0,0 +1,57 @@
+export const ARTIFACT_CONTRACT_REGISTRY = {
+    concept_example_table: {
+        id: "concept_example_table",
+        taskFamilies: ["concept_explainer"],
+        description: "Compact examples, cross-checks, or comparison rows for educational answers.",
+        status: "trace_only",
+    },
+    portfolio_exposure_map: {
+        id: "portfolio_exposure_map",
+        taskFamilies: ["portfolio_review"],
+        description: "Structural exposure map for portfolio review and rebalance prompts.",
+        status: "trace_only",
+    },
+    rebalance_action_plan: {
+        id: "rebalance_action_plan",
+        taskFamilies: ["portfolio_review"],
+        description: "Staged rebalance action plan with target ranges and execution caveats.",
+        status: "trace_only",
+    },
+    source_coverage_table: {
+        id: "source_coverage_table",
+        taskFamilies: ["sentiment_snapshot", "filing_thesis_review", "current_event_explanation"],
+        description: "Source and provider-gap coverage table for source-heavy answers.",
+        status: "trace_only",
+    },
+};
+export function artifactContractIdsForPlanning(input) {
+    if (input.policyCardId === "concept_options_education" ||
+        input.policyCardId === "concept_inflation_cash_education" ||
+        input.policyCardId === "concept_valuation_metric_education") {
+        return ["concept_example_table"];
+    }
+    if (input.policyCardId === "portfolio_rebalance_review") {
+        return ["portfolio_exposure_map", "rebalance_action_plan"];
+    }
+    if (input.taskFamily === "sentiment_snapshot" ||
+        input.taskFamily === "filing_thesis_review" ||
+        input.taskFamily === "current_event_explanation") {
+        return ["source_coverage_table"];
+    }
+    return [];
+}
+export function validateArtifactContractRegistry() {
+    const errors = [];
+    for (const [id, contract] of Object.entries(ARTIFACT_CONTRACT_REGISTRY)) {
+        if (contract.id !== id)
+            errors.push(`${id} key must match contract id`);
+        if (contract.status !== "trace_only")
+            errors.push(`${id} must remain trace-only in V1`);
+        if (contract.taskFamilies.length === 0)
+            errors.push(`${id} must declare at least one task family`);
+        if (!contract.description.trim())
+            errors.push(`${id} must include a description`);
+    }
+    return errors;
+}
+//# sourceMappingURL=artifact-contracts.js.map

package/dist/runtime/artifact-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-contracts.js","sourceRoot":"","sources":["../../src/runtime/artifact-contracts.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,0BAA0B,GAA2D;IAChG,qBAAqB,EAAE;QACrB,EAAE,EAAE,uBAAuB;QAC3B,YAAY,EAAE,CAAC,mBAAmB,CAAC;QACnC,WAAW,EAAE,6EAA6E;QAC1F,MAAM,EAAE,YAAY;KACrB;IACD,sBAAsB,EAAE;QACtB,EAAE,EAAE,wBAAwB;QAC5B,YAAY,EAAE,CAAC,kBAAkB,CAAC;QAClC,WAAW,EAAE,qEAAqE;QAClF,MAAM,EAAE,YAAY;KACrB;IACD,qBAAqB,EAAE;QACrB,EAAE,EAAE,uBAAuB;QAC3B,YAAY,EAAE,CAAC,kBAAkB,CAAC;QAClC,WAAW,EAAE,wEAAwE;QACrF,MAAM,EAAE,YAAY;KACrB;IACD,qBAAqB,EAAE;QACrB,EAAE,EAAE,uBAAuB;QAC3B,YAAY,EAAE,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,2BAA2B,CAAC;QACzF,WAAW,EAAE,kEAAkE;QAC/E,MAAM,EAAE,YAAY;KACrB;CACF,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAAC,KAG9C;IACC,IACE,KAAK,CAAC,YAAY,KAAK,2BAA2B;QAClD,KAAK,CAAC,YAAY,KAAK,kCAAkC;QACzD,KAAK,CAAC,YAAY,KAAK,oCAAoC,EAC3D,CAAC;QACD,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,4BAA4B,EAAE,CAAC;QACxD,OAAO,CAAC,wBAAwB,EAAE,uBAAuB,CAAC,CAAC;IAC7D,CAAC;IACD,IACE,KAAK,CAAC,UAAU,KAAK,oBAAoB;QACzC,KAAK,CAAC,UAAU,KAAK,sBAAsB;QAC3C,KAAK,CAAC,UAAU,KAAK,2BAA2B,EAChD,CAAC;QACD,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACxE,IAAI,QAAQ,CAAC,EAAE,KAAK,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;QACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,YAAY;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;QACxF,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,wCAAwC,CAAC,CAAC;QACnG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/runtime/planning-evidence.d.ts

@@ -0,0 +1,99 @@
+import type { CapabilityGapId, EvidencePlanId, TaskFamily } from "../routing/planning.js";
+import type { ProviderResult } from "./evidence.js";
+export type PlanningEvidenceType = "market_status" | "ticker_disambiguation" | "portfolio_exposure_map" | "tool_result" | "provider_gap";
+export type PlanningProviderStatus = "available" | "unavailable" | "credential_required" | "soft_degraded" | "skipped";
+export interface EvidenceSource {
+    toolName?: string;
+    provider?: string;
+}
+export interface EntityScope {
+    symbols?: string[];
+    query?: string;
+}
+export interface RawTracePointer {
+    traceId?: string;
+    turnIndex?: number;
+    toolCallIndex?: number;
+    toolCallId?: string;
+    toolName?: string;
+    customEntryType?: string;
+}
+export interface EvidenceGap {
+    kind: "provider_status" | "capability_gap" | "roadmap_placeholder";
+    providerStatus?: Exclude<PlanningProviderStatus, "available">;
+    provider?: string;
+    capabilityGapId?: CapabilityGapId;
+    reason: string;
+    remediation?: string;
+    silenced?: boolean;
+    rawTag?: string;
+}
+export interface PlanningEvidenceRecord {
+    id: string;
+    evidenceType: PlanningEvidenceType;
+    source: EvidenceSource;
+    entityScope: EntityScope;
+    observedAt: string;
+    providerStatus: PlanningProviderStatus;
+    normalizedFacts: Record<string, unknown>;
+    rawTracePointer?: RawTracePointer;
+    gaps: EvidenceGap[];
+    caveats: string[];
+}
+export interface EvidencePlanDefinition {
+    id: EvidencePlanId;
+    taskFamilies: TaskFamily[];
+    implemented: boolean;
+    requiredEvidence: PlanningEvidenceType[];
+    optionalEvidence: PlanningEvidenceType[];
+    capabilityGapIds: CapabilityGapId[];
+    roadmapPlaceholder?: string;
+}
+export interface MarketStatusInput {
+    text: string;
+    now?: Date;
+    timezone?: string;
+    traceId?: string;
+}
+export interface TickerDisambiguationInput {
+    text: string;
+    symbols?: string[];
+    traceId?: string;
+}
+export interface PortfolioExposureMapInput {
+    text: string;
+    now?: Date;
+    traceId?: string;
+}
+export interface PortfolioExposureSleeve {
+    label: string;
+    normalizedSleeve: string;
+    percent: number;
+}
+export interface ToolCallEvidenceInput {
+    name: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    isError?: boolean;
+}
+export interface ToolTraceOptions {
+    traceId?: string;
+    turnIndex?: number;
+    toolCallIndex?: number;
+    toolCallId?: string;
+}
+export interface NormalizedProviderGap {
+    providerStatus: Exclude<PlanningProviderStatus, "available">;
+    provider: string;
+    reason: string;
+    remediation?: string;
+    silenced?: boolean;
+    rawTag: string;
+}
+export declare const EVIDENCE_PLAN_REGISTRY: Record<EvidencePlanId, EvidencePlanDefinition>;
+export declare function buildMarketStatusEvidence(input: MarketStatusInput): PlanningEvidenceRecord;
+export declare function buildTickerDisambiguationEvidence(input: TickerDisambiguationInput): PlanningEvidenceRecord;
+export declare function buildPortfolioExposureMapEvidence(input: PortfolioExposureMapInput): PlanningEvidenceRecord;
+export declare function captureEvidenceFromToolCall(toolCall: ToolCallEvidenceInput, options?: ToolTraceOptions): PlanningEvidenceRecord;
+export declare function normalizeProviderGapFromToolText(text: string): NormalizedProviderGap | undefined;
+export declare function providerResultToPlanningEvidence<T>(label: string, result: ProviderResult<T>, rawTracePointer?: RawTracePointer): PlanningEvidenceRecord;