@yuaone/core 0.9.43 → 1.0.1

package/dist/agent-affordance.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @module agent-affordance
+ * @description AgentAffordanceVector calculator.
+ * Pure math, NO LLM, NO async. Deterministic: same input → same output.
+ *
+ * Ported from YUA Decision Orchestrator's computeResponseAffordance
+ * into coding-agent execution-tendency vectors.
+ */
+import type { AgentReasoningResult, AgentAffordanceVector } from "./agent-decision-types.js";
+/**
+ * Smooth ease curve: 0→0, 0.5→0.5, 1→1.
+ * `0.5 * (1 - cos(PI * clamp01(x)))`
+ */
+export declare function cosineEase(x: number): number;
+/**
+ * Cosine similarity between two affordance vectors.
+ * Returns a value in [-1, 1], though for non-negative vectors it's [0, 1].
+ */
+export declare function cosineSimilarity(a: AgentAffordanceVector, b: AgentAffordanceVector): number;
+/**
+ * Compute the 5D agent affordance vector from reasoning output.
+ * Pure function — same inputs produce identical output.
+ *
+ * Pipeline: intentBias → stageMultiplier → depthDecay → cosineEase → clamp →
+ *           hardGuards → trendCorrection → stuckBreaker
+ */
+export declare function computeAgentAffordance(reasoning: AgentReasoningResult, prevAffordance?: AgentAffordanceVector): AgentAffordanceVector;
+/**
+ * If the same decision pattern repeats 3+ times, force a strategy shift
+ * to break out of repetitive loops.
+ *
+ * @param affordance - Current affordance vector (will be shallow-copied, not mutated)
+ * @param repeatCount - Number of consecutive similar decisions
+ * @returns Adjusted affordance vector, or the original if repeatCount < 3
+ */
+export declare function applyStuckBreaker(affordance: Readonly<AgentAffordanceVector>, repeatCount: number): AgentAffordanceVector;
+//# sourceMappingURL=agent-affordance.d.ts.map

package/dist/agent-affordance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-affordance.d.ts","sourceRoot":"","sources":["../src/agent-affordance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EAItB,MAAM,2BAA2B,CAAC;AASnC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,qBAAqB,EACxB,CAAC,EAAE,qBAAqB,GACvB,MAAM,CAeR;AAiDD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,oBAAoB,EAC/B,cAAc,CAAC,EAAE,qBAAqB,GACrC,qBAAqB,CAkDvB;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,QAAQ,CAAC,qBAAqB,CAAC,EAC3C,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAWvB"}

package/dist/agent-affordance.js

@@ -0,0 +1,139 @@
+/**
+ * @module agent-affordance
+ * @description AgentAffordanceVector calculator.
+ * Pure math, NO LLM, NO async. Deterministic: same input → same output.
+ *
+ * Ported from YUA Decision Orchestrator's computeResponseAffordance
+ * into coding-agent execution-tendency vectors.
+ */
+// ─── Math Utilities ───
+/** Clamp a number to [0, 1]. */
+function clamp01(x) {
+    return Math.max(0, Math.min(1, x));
+}
+/**
+ * Smooth ease curve: 0→0, 0.5→0.5, 1→1.
+ * `0.5 * (1 - cos(PI * clamp01(x)))`
+ */
+export function cosineEase(x) {
+    return 0.5 * (1 - Math.cos(Math.PI * clamp01(x)));
+}
+/**
+ * Cosine similarity between two affordance vectors.
+ * Returns a value in [-1, 1], though for non-negative vectors it's [0, 1].
+ */
+export function cosineSimilarity(a, b) {
+    const keys = [
+        "explain_plan", "inspect_more", "edit_now", "run_checks", "finalize",
+    ];
+    let dot = 0;
+    let magA = 0;
+    let magB = 0;
+    for (const k of keys) {
+        dot += a[k] * b[k];
+        magA += a[k] * a[k];
+        magB += b[k] * b[k];
+    }
+    const denom = Math.sqrt(magA) * Math.sqrt(magB);
+    if (denom === 0)
+        return 0;
+    return dot / denom;
+}
+// ─── Intent Bias Table (9 intents → 5D base vectors, §5.1) ───
+const INTENT_BIAS = {
+    inspect: { explain_plan: 0.3, inspect_more: 0.8, edit_now: 0.1, run_checks: 0.2, finalize: 0.1 },
+    plan: { explain_plan: 0.9, inspect_more: 0.5, edit_now: 0.2, run_checks: 0.3, finalize: 0.1 },
+    search: { explain_plan: 0.2, inspect_more: 0.9, edit_now: 0.1, run_checks: 0.1, finalize: 0.1 },
+    read: { explain_plan: 0.3, inspect_more: 0.7, edit_now: 0.1, run_checks: 0.2, finalize: 0.2 },
+    edit: { explain_plan: 0.3, inspect_more: 0.2, edit_now: 0.9, run_checks: 0.5, finalize: 0.3 },
+    test: { explain_plan: 0.2, inspect_more: 0.2, edit_now: 0.3, run_checks: 0.9, finalize: 0.4 },
+    verify: { explain_plan: 0.1, inspect_more: 0.2, edit_now: 0.2, run_checks: 0.8, finalize: 0.7 },
+    refactor: { explain_plan: 0.5, inspect_more: 0.4, edit_now: 0.8, run_checks: 0.7, finalize: 0.3 },
+    fix: { explain_plan: 0.2, inspect_more: 0.3, edit_now: 0.8, run_checks: 0.8, finalize: 0.4 },
+};
+const STAGE_MULTIPLIER = {
+    underspecified: { explain_plan: 1.3, inspect_more: 1.5, edit_now: 0.3 },
+    blocked: { inspect_more: 1.4, run_checks: 1.3, edit_now: 0.5 },
+    iterating: { edit_now: 1.2, run_checks: 1.1, finalize: 0.8 },
+    ready: {}, // no modifier
+};
+// ─── Depth Decay ───
+const DEPTH_DECAY = {
+    deep: 0.95,
+    normal: 0.85,
+    shallow: 0.7,
+};
+// ─── Affordance Keys ───
+const AFFORDANCE_KEYS = [
+    "explain_plan", "inspect_more", "edit_now", "run_checks", "finalize",
+];
+// ─── Main Calculator ───
+/**
+ * Compute the 5D agent affordance vector from reasoning output.
+ * Pure function — same inputs produce identical output.
+ *
+ * Pipeline: intentBias → stageMultiplier → depthDecay → cosineEase → clamp →
+ *           hardGuards → trendCorrection → stuckBreaker
+ */
+export function computeAgentAffordance(reasoning, prevAffordance) {
+    const { intent, taskStage, complexity, depthHint } = reasoning;
+    const base = INTENT_BIAS[intent];
+    const stageMul = STAGE_MULTIPLIER[taskStage];
+    const depthDecay = DEPTH_DECAY[depthHint];
+    // Compute raw vector with cosineEase
+    const raw = {
+        explain_plan: 0,
+        inspect_more: 0,
+        edit_now: 0,
+        run_checks: 0,
+        finalize: 0,
+    };
+    for (const k of AFFORDANCE_KEYS) {
+        raw[k] = cosineEase(base[k] * (stageMul[k] ?? 1) * depthDecay);
+    }
+    // Clamp all to [0, 1]
+    for (const k of AFFORDANCE_KEYS) {
+        raw[k] = clamp01(raw[k]);
+    }
+    // ─── Hard Guards ───
+    // underspecified → edit_now max 0.15
+    if (taskStage === "underspecified") {
+        raw.edit_now = Math.min(raw.edit_now, 0.15);
+    }
+    // trivial → explain_plan max 0.2, finalize min 0.7
+    if (complexity === "trivial") {
+        raw.explain_plan = Math.min(raw.explain_plan, 0.2);
+        raw.finalize = Math.max(raw.finalize, 0.7);
+    }
+    // ─── Trend Correction ───
+    if (prevAffordance) {
+        const similarity = cosineSimilarity(raw, prevAffordance);
+        if (similarity > 0.92) {
+            // Too similar — induce slight exploration boost
+            raw.inspect_more = clamp01(raw.inspect_more + 0.05);
+        }
+    }
+    return raw;
+}
+// ─── Stuck Breaker (GPT QA #15) ───
+/**
+ * If the same decision pattern repeats 3+ times, force a strategy shift
+ * to break out of repetitive loops.
+ *
+ * @param affordance - Current affordance vector (will be shallow-copied, not mutated)
+ * @param repeatCount - Number of consecutive similar decisions
+ * @returns Adjusted affordance vector, or the original if repeatCount < 3
+ */
+export function applyStuckBreaker(affordance, repeatCount) {
+    if (repeatCount < 3)
+        return { ...affordance };
+    // 3+ repeats → force strategy shift
+    return {
+        explain_plan: clamp01(affordance.explain_plan + 0.2),
+        inspect_more: clamp01(affordance.inspect_more - 0.2),
+        edit_now: clamp01(affordance.edit_now - 0.1),
+        run_checks: clamp01(affordance.run_checks + 0.3),
+        finalize: clamp01(affordance.finalize + 0.2),
+    };
+}
+//# sourceMappingURL=agent-affordance.js.map

package/dist/agent-affordance.js.map

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

package/dist/agent-decision-types.d.ts

@@ -0,0 +1,262 @@
+/**
+ * @module agent-decision-types
+ * @description Type definitions for the YUAN Agent Decision Engine.
+ * All types are defined here as SSOT — no duplication across modules.
+ *
+ * Ported from YUA Decision Orchestrator types into coding-agent domain.
+ */
+import type { SubAgentRole } from "./sub-agent-prompts.js";
+/** Coding agent task intent (9 variants) */
+export type AgentIntent = "inspect" | "plan" | "search" | "read" | "edit" | "test" | "verify" | "refactor" | "fix";
+/** User's task readiness stage */
+export type AgentTaskStage = "underspecified" | "ready" | "blocked" | "iterating";
+/** Task complexity */
+export type AgentComplexity = "trivial" | "simple" | "moderate" | "complex" | "massive";
+/** Next execution direction hint */
+export type AgentFlowAnchor = "SEARCH_REPO" | "READ_FILES" | "PREPARE_PATCH" | "RUN_TESTS" | "VERIFY_RESULT" | "SUMMARIZE_CHANGE";
+/** Intent family for downstream branching (GPT QA #11) */
+export type IntentFamily = "explore" | "modify" | "validate";
+/** Decision Engine이 결정하는 실행 모드 */
+export type InteractionMode = "CHAT" | "AGENT" | "HYBRID";
+export declare const INTENT_FAMILY: Record<AgentIntent, IntentFamily>;
+export interface AgentReasoningResult {
+    intent: AgentIntent;
+    taskStage: AgentTaskStage;
+    complexity: AgentComplexity;
+    confidence: number;
+    depthHint: "shallow" | "normal" | "deep";
+    cognitiveLoad: "low" | "medium" | "high";
+    nextAnchors: AgentFlowAnchor[];
+}
+/** 5D execution-tendency vector (not response style) */
+export interface AgentAffordanceVector {
+    explain_plan: number;
+    inspect_more: number;
+    edit_now: number;
+    run_checks: number;
+    finalize: number;
+}
+export interface AgentComputePolicy {
+    maxIterations: number;
+    maxTokenBudget: number;
+    modelTier: "fast" | "standard" | "deep";
+    parallelAgents: number;
+}
+/** Decision-determined next action mode */
+export type AgentNextAction = "proceed" | "ask_user" | "blocked_external";
+/** Structured clarification request for ask_user */
+export interface ClarificationRequest {
+    reason: string;
+    missingFields: string[];
+    suggestedOptions: string[];
+    allowProceedWithAssumptions: boolean;
+}
+export interface AgentFailureSurface {
+    patchRisk: number;
+    buildRisk: number;
+    testRisk: number;
+    blastRadius: number;
+    ambiguityRisk: number;
+}
+export interface AgentVetoFlags {
+    /** patchRisk >= 0.8 and no plan -> direct edit forbidden */
+    editVetoed: boolean;
+    /** blastRadius >= 0.6 -> verifyDepth minimum quick */
+    verifyRequired: boolean;
+    /** ambiguityRisk >= 0.7 -> ask_user forced */
+    clarifyForced: boolean;
+    /** buildRisk >= 0.7 -> finalize forbidden, verify required */
+    finalizeBlocked: boolean;
+}
+export interface AgentToolBudget {
+    maxFileReads: number;
+    maxEdits: number;
+    maxShellExecs: number;
+    maxTestRuns: number;
+    maxSearches: number;
+    maxWebLookups: number;
+    shellCostUnits: number;
+    maxSameFileEdits: number;
+}
+/** Budget enforcement mode (GPT QA #9) */
+export type BudgetEnforcementMode = "soft" | "hard";
+export type AgentMemoryCategory = "tool_pattern" | "error_pattern" | "project_rule" | "file_structure" | "user_preference" | "failure_avoidance";
+export interface AgentMemoryIntent {
+    shouldSave: boolean;
+    categories: AgentMemoryCategory[];
+    priority: "low" | "normal" | "high";
+    target: "local" | "backend" | "both";
+}
+export interface AgentTaskContinuation {
+    isContinuation: boolean;
+    continuityScore: number;
+    carryover: {
+        modifiedFiles: string[];
+        failedAttempts: string[];
+        prevIntent?: AgentIntent;
+        prevStage?: AgentTaskStage;
+    };
+}
+export interface AgentProjectContext {
+    hasTests: boolean;
+    fileCount: number;
+    language: string;
+    repoIndexed: boolean;
+    monorepo: boolean;
+    packageManager?: string;
+    testFrameworkPresent: boolean;
+    dirtyWorkingTree: boolean;
+    currentBranchProtected: boolean;
+    recentFailureCount: number;
+    changedFilesCount: number;
+    hasBuildErrors: boolean;
+    hasConflicts: boolean;
+    missingDeps: boolean;
+    buildTool?: string;
+    testRunner?: string;
+    avgCyclomaticComplexity?: number;
+    avgCognitiveComplexity?: number;
+    maxFileComplexity?: number;
+    avgLoc?: number;
+}
+/** FailureRecovery provides this hint — does NOT regenerate decision */
+export interface RecoveryHint {
+    action: "retry" | "rollback" | "skip" | "ask_user" | "alternative_approach";
+    reason: string;
+    /** Stage hint for next run (replaces prevDecision stage) */
+    stageHint?: AgentTaskStage;
+}
+/** Sub-agent orchestration plan — Decision determines WHAT agents to use */
+export interface AgentSubAgentPlan {
+    /** Whether to use sub-agents at all */
+    enabled: boolean;
+    /** Maximum concurrent agents */
+    maxAgents: number;
+    /** Which roles to activate (from existing SubAgentRole type) */
+    roles: SubAgentRole[];
+    /** Execution strategy */
+    strategy: "parallel" | "sequential" | "pipeline";
+}
+/** Skill/Plugin activation — Decision determines WHAT to enable */
+export interface AgentSkillActivation {
+    /** Enable ToolPlanner (tool sequence optimization) */
+    enableToolPlanning: boolean;
+    /** Enable SkillLearner (learn from execution patterns) */
+    enableSkillLearning: boolean;
+    /** Enable plugin system */
+    enablePlugins: boolean;
+    /** Enable specialist routing */
+    enableSpecialist: boolean;
+    /** Specialist domain (if detected from intent) */
+    specialistDomain?: string;
+}
+/** Persona/tone hint — Decision determines communication style */
+export interface AgentPersonaHint {
+    /** Tone for responses */
+    tone: "casual" | "professional" | "technical" | "friendly";
+    /** Preferred language */
+    language: "ko" | "en" | "auto";
+}
+/** Direction strength for the agent's response */
+export type AgentLeadHint = "NONE" | "SOFT" | "HARD";
+/** Structured output guidance — determines response format and forbidden patterns */
+export interface AgentResponseHint {
+    structure: "direct_answer" | "problem_solution" | "stepwise_explanation" | "code_first";
+    expansion: "none" | "soft" | "guided" | "full";
+    forbid: {
+        metaComment: boolean;
+        narration: boolean;
+        apology: boolean;
+    };
+}
+/** Tool access level — determines which tools are available */
+export type AgentToolLevel = "FULL" | "LIMITED" | "READ_ONLY";
+/** Tool gate — controls tool access based on intent/risk */
+export interface AgentToolGate {
+    level: AgentToolLevel;
+    blockedTools: string[];
+    verifierBudget: number;
+}
+/** Execution pressure — how assertively the agent pushes forward */
+export type AgentResponsePressure = "GENTLE" | "NEUTRAL" | "ASSERTIVE";
+/** Pressure + momentum combined decision */
+export interface AgentPressureDecision {
+    pressure: AgentResponsePressure;
+    momentum: "LOW" | "MEDIUM" | "HIGH";
+}
+/** Continuation context capsule — injected when resuming a previous task */
+export interface AgentContinuityCapsule {
+    enabled: boolean;
+    summary?: string;
+    rules: string[];
+}
+/** Fine-grained style tracking derived from user message */
+export interface AgentStyleHint {
+    formality: "casual" | "neutral" | "formal";
+    language: "ko" | "en" | "mixed";
+    brevity: "terse" | "normal" | "verbose";
+}
+/** Memory load decision — what to load at init */
+export interface AgentMemoryLoad {
+    /** Whether to load memory at all */
+    shouldLoad: boolean;
+    /** Which categories to prioritize */
+    categories: AgentMemoryCategory[];
+}
+/** Code quality enforcement policy — set by Decision, consumed by PromptRuntime + AgentLoop */
+export interface AgentCodeQualityPolicy {
+    /** Whether this task involves code modification */
+    isCodeTask: boolean;
+    /** Code task subtype */
+    codeTaskType: "generation" | "fix" | "refactor" | "review" | "test" | "none";
+    /** Primary risk category */
+    primaryRisk: "extension_pain" | "type_safety" | "async_race" | "state_corruption" | "blast_radius" | "none";
+    /** Quality constraints injected into prompt */
+    constraints: string[];
+    /** Whether to enforce strict mode (no TODO/stub/placeholder) */
+    strictMode: boolean;
+    /** Pre-edit verification required */
+    preEditVerify: boolean;
+}
+/** Deterministic core — same input yields same result */
+export interface AgentDecisionCore {
+    readonly reasoning: AgentReasoningResult;
+    readonly affordance: AgentAffordanceVector;
+    readonly computePolicy: AgentComputePolicy;
+    readonly failureSurface: AgentFailureSurface;
+    readonly vetoFlags: AgentVetoFlags;
+    readonly toolBudget: AgentToolBudget;
+    readonly nextAction: AgentNextAction;
+    readonly clarification?: ClarificationRequest;
+    readonly planRequired: boolean;
+    readonly scanBreadth: "narrow" | "normal" | "wide";
+    readonly verifyDepth: "skip" | "quick" | "thorough";
+    readonly memoryIntent: AgentMemoryIntent;
+    readonly continuation: AgentTaskContinuation;
+    readonly microPlan?: readonly string[];
+    readonly interactionMode: InteractionMode;
+    readonly subAgentPlan: AgentSubAgentPlan;
+    readonly skillActivation: AgentSkillActivation;
+    readonly personaHint: AgentPersonaHint;
+    readonly memoryLoad: AgentMemoryLoad;
+    readonly codeQuality: AgentCodeQualityPolicy;
+    readonly leadHint: AgentLeadHint;
+    readonly responseHint: AgentResponseHint;
+    readonly toolGate: AgentToolGate;
+    readonly pressureDecision: AgentPressureDecision;
+    readonly continuityCapsule: AgentContinuityCapsule;
+    readonly styleHint: AgentStyleHint;
+}
+/** Runtime metadata — excluded from determinism verification (GPT QA #2) */
+export interface AgentDecisionMeta {
+    readonly sessionId: string;
+    readonly createdAt: number;
+    /** Consecutive same-intent+stage count (for stuck breaker) */
+    readonly repeatCount: number;
+}
+/** Final SSOT — deep-frozen, immutable after creation (GPT QA #1) */
+export interface AgentDecisionContext {
+    readonly core: AgentDecisionCore;
+    readonly meta: AgentDecisionMeta;
+}
+//# sourceMappingURL=agent-decision-types.d.ts.map

package/dist/agent-decision-types.d.ts.map

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

package/dist/agent-decision-types.js

@@ -0,0 +1,19 @@
+/**
+ * @module agent-decision-types
+ * @description Type definitions for the YUAN Agent Decision Engine.
+ * All types are defined here as SSOT — no duplication across modules.
+ *
+ * Ported from YUA Decision Orchestrator types into coding-agent domain.
+ */
+export const INTENT_FAMILY = {
+    inspect: "explore",
+    read: "explore",
+    search: "explore",
+    plan: "explore",
+    edit: "modify",
+    refactor: "modify",
+    fix: "modify",
+    test: "validate",
+    verify: "validate",
+};
+//# sourceMappingURL=agent-decision-types.js.map

package/dist/agent-decision-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-decision-types.js","sourceRoot":"","sources":["../src/agent-decision-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmDH,MAAM,CAAC,MAAM,aAAa,GAAsC;IAC9D,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,QAAQ;IAClB,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,UAAU;CACnB,CAAC"}

package/dist/agent-decision.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @module agent-decision
+ * @description Main Agent Decision Orchestrator.
+ * Single entry point: `agentDecide()` — called once per user message.
+ * Produces an immutable, deep-frozen `AgentDecisionContext` (SSOT).
+ *
+ * Pure function (except `crypto.randomUUID()` for session ID in meta).
+ * NO LLM calls, NO async.
+ *
+ * Design spec: docs/superpowers/specs/2026-03-17-yuan-agent-decision-engine-design.md, section 6
+ */
+import type { AgentDecisionContext, AgentProjectContext, AgentReasoningResult, InteractionMode, RecoveryHint } from "./agent-decision-types.js";
+/**
+ * Derive the interaction mode from reasoning result.
+ * Deterministic: same reasoning always yields the same mode.
+ *
+ * Rules:
+ * - CHAT: trivial + explore intents (inspect/read/search), OR underspecified
+ * - AGENT: complex/massive, OR plan/refactor intent, OR fix+moderate+
+ * - HYBRID: moderate edit/fix/test/verify, OR simple edit/fix
+ * - Default: CHAT
+ */
+export declare function deriveInteractionMode(reasoning: AgentReasoningResult): InteractionMode;
+/**
+ * Single entry point for the Agent Decision Engine.
+ * Called once per user message. Produces an immutable `AgentDecisionContext`.
+ *
+ * Pipeline:
+ *   agentReason → computeAgentAffordance → deriveComputePolicy →
+ *   estimateFailureSurface → computeVetoFlags → deriveToolBudget →
+ *   deriveMemoryIntent → detectTaskContinuation → deriveMicroPlan → deepFreeze
+ *
+ * Supports recoveryHint (GPT QA #8): if provided, adjusts the reasoning stage.
+ */
+export declare function agentDecide(input: {
+    message: string;
+    projectContext?: AgentProjectContext;
+    prevDecision?: AgentDecisionContext;
+    recoveryHint?: RecoveryHint;
+}): AgentDecisionContext;
+/**
+ * Safe default decision — used when agentDecide() fails or is skipped.
+ * Trivial/CHAT/proceed = most conservative, safest behavior.
+ * This ensures Decision is NEVER null in the pipeline.
+ */
+export declare const DEFAULT_DECISION: AgentDecisionContext;
+/**
+ * Convert a WorldStateSnapshot into AgentProjectContext for Decision Engine input.
+ * This bridges the gap between runtime world state and decision-time project context.
+ */
+export declare function worldStateToProjectContext(ws: import("./world-state.js").WorldStateSnapshot): AgentProjectContext;
+//# sourceMappingURL=agent-decision.d.ts.map

package/dist/agent-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-decision.d.ts","sourceRoot":"","sources":["../src/agent-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAMV,oBAAoB,EAYpB,mBAAmB,EACnB,oBAAoB,EAUpB,eAAe,EACf,YAAY,EACb,MAAM,2BAA2B,CAAC;AAuRnC;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,GAAG,eAAe,CAwCtF;AAwTD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,GAAG,oBAAoB,CA+LvB;AAID;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAyEL,CAAC;AAI3B;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,OAAO,kBAAkB,EAAE,kBAAkB,GAChD,mBAAmB,CAmBrB"}