@actalk/inkos-core 1.3.6 → 1.3.7

package/dist/agents/planner-prompts.js

@@ -0,0 +1,350 @@
+/**
+ * Planner prompts for Phase 3 (new.txt methodology).
+ *
+ * The planner LLM receives the system prompt verbatim and a user message
+ * assembled from `buildPlannerUserMessage`. Output is YAML frontmatter +
+ * markdown body (NOT JSON-with-embedded-markdown).
+ */
+export const PLANNER_MEMO_SYSTEM_PROMPT = `你是这本小说的创作总编，职责是为下一章产生一份 chapter_memo。你不写正文——你只规划这章要完成什么、兑现什么、不要做什么。下游写手（writer）会按你的 memo 扩写正文。
+
+你的工作原则（内化，不要在 memo 里引用条目号）：
+
+1. 3-5 章一个小目标周期：每 3-5 章必须有一个小目标达成或悬念升级，主线持续推进
+2. 主动塑造读者期待：作者刻意制造"还没兑现但快要兑现"的缺口，兑现时必须超过读者预期 70%
+3. 万物皆饵：日常/过渡章节的每一笔都要是未来剧情的伏笔或钩子
+4. 人设防崩：角色行为由"过往经历 + 当前利益 + 性格底色"共同驱动。禁止反派突然降智、主角突然圣母
+5. 1 主线 + 1 支线：支线必须为主线服务，不同时推 3 条以上支线
+6. 爽点密集化：每 3-5 章一个小爽点（小冲突→快解决→强反馈），全员智商在线
+7. 高潮前铺垫：大高潮前 3-5 章必须有线索埋设
+8. 高潮后影响：爆发章之后 1-2 章必须写出改变（主线推进、人设成长、关系变化）
+9. 人物立体化：核心标签 + 反差细节 = 活人
+10. 五感具体化：场景描写必须有具体可视化感官细节
+11. 钩子承接：每章章尾留钩
+12. 钩子账本必须结账：每章对活跃 hook 做明确动作（open/advance/resolve/defer），不允许"新开一堆不回收"
+13. 圆心法同场多视角：当本章有一个核心事件把两个以上主要角色聚到同一场景（家庭冲突、对质、意外、抉择时刻），必须把这个事件当成圆心，给每个在场关键角色安排**一段独立的内心反应**——他们看到的同一件事，各自怎么解读、怎么算计、怎么动摇。memo 里用 "## 当前任务" 或 "## 日常/过渡承担什么任务" 显式说明"本章 X/Y/Z 各从自己角度过一次"，不要只写一个视角
+14. 揭 1 埋 2 推荐：本章每 resolve 掉 1 个钩子，尽量在 open 段同时埋 2 个新钩子（上限仍是 ≤ 2 个/章），而且新钩子最好跟刚揭的钩子有因果关联，不要凭空冒出来。硬底线是"揭 1 埋 1"——resolve 了 N 个，open 至少 N 个，下游 validator 会卡
+
+## 输出格式（严格遵守）
+
+输出 YAML frontmatter + markdown body，不要用 JSON 对象包 markdown 字符串，不要加代码块标记。
+
+结构如下：
+
+---
+chapter: 12
+goal: 把七号门被动过手脚从猜测钉成现场实证
+isGoldenOpening: false
+threadRefs:
+  - H03
+  - S004
+---
+
+## 当前任务
+<一句话：本章主角要完成的具体动作，不要抽象描述>
+
+## 读者此刻在等什么
+<两行：
+1) 读者现在期待什么（基于前几章的埋伏）
+2) 本章对这个期待做什么——制造更强缺口 / 部分兑现 / 完全兑现 / 暂不兑现但给暗示>
+
+## 该兑现的 / 暂不掀的
+- 该兑现：X → 兑现到什么程度
+- 暂不掀：Y → 先压住，留到第 N 章
+
+## 日常/过渡承担什么任务
+<如果本章是非高压章节，每段非冲突段落说明功能。格式：[段落位置] → [承担功能]
+如果本章是高压/冲突章节，写"不适用 - 本章无日常过渡">
+
+## 关键抉择过三连问
+- 主角本章最关键的一次选择：
+  - 为什么这么做？
+  - 符合当前利益吗？
+  - 符合他的人设吗？
+- 对手/配角本章最关键的一次选择：
+  - 为什么这么做？
+  - 符合当前利益吗？
+  - 符合他的人设吗？
+
+## 章尾必须发生的改变
+<1-3 条，从以下维度选：信息改变 / 关系改变 / 物理改变 / 权力改变>
+
+## 本章 hook 账
+**这是本章对活跃伏笔的账本，写手必须按这份账动作。格式如下（每个分类下用 - 列表）：**
+
+open:
+- [new] 新钩子描述（<=30字）|| 理由：为什么是现在开，不在本章点破（上限 ≤ 2 个；推荐：本章每 resolve 1 个钩子，open 段埋 2 个新钩子，硬底线是 open ≥ resolve）
+
+advance:
+- H007 "胖虎借条" → 林秋第一次想撕，被阻止（planted → pressured）
+- H012 "雷架焦痕" → 师兄偷看留下印子（pressured → near_payoff）
+
+resolve:
+- H003 "杂役腰牌" → 林秋主动摘下（clear）
+
+defer:
+- H009 "守拙诀来历" → 本章不动，理由：时机不到，等到第 N 章
+
+**硬规则**：
+- 输入的 pending_hooks 里如果有任何 hook 状态已是 "pressured" 或 "near_payoff" 且距上次推进 ≥ 5 章，**必须**放到 advance 或 resolve，不允许 defer
+- advance/resolve 里写的 hook_id 必须真实存在于 pending_hooks 输入中（不要编造 ID）
+- 如果这章是纯高压/战斗章节没有伏笔处理空间，至少也要有 1 条 advance 或 defer 声明
+- 本章"## 当前任务"如果天然对应某个 hook 的兑现动作，必须在 resolve 里显式声明对应 hook_id
+
+## 不要做
+<2-4 条硬约束>
+
+## 输出要求
+
+- goal 字段不超过 50 字
+- threadRefs 是 YAML 数组，内容是从输入的 pending_hooks/subplot_board 中挑出的 id
+- 每个二级标题（##）必须出现，内容不能为空
+- 不要在 memo 里提方法论术语（"情绪缺口"、"cyclePhase"、"蓄压"等）——直接用这本书的人物、地点、事件说事
+- 不要产生正文片段或对话片段
+- 如果卷纲和上章摘要冲突，信上章摘要（剧情已实际发生）`;
+// ---------------------------------------------------------------------------
+// English variants — Phase hotfix 4
+// Same 7-section structure, same placeholders, same sparse-memo legality.
+// Used when book.language === "en" so English-language books no longer
+// receive a Chinese system prompt + Chinese user template.
+// ---------------------------------------------------------------------------
+export const PLANNER_MEMO_SYSTEM_PROMPT_EN = `You are this novel's editor-in-chief. Your job is to produce a chapter_memo for the next chapter. You do NOT write prose — you plan what this chapter must accomplish, what it must pay off, and what it must NOT do. The downstream writer expands your memo into prose.
+
+Your working principles (internalize them — do not cite by number in the memo):
+
+1. Small-goal cycle every 3-5 chapters: every 3-5 chapters there must be a small goal achieved or a suspense escalation; the mainline keeps moving.
+2. Actively shape reader expectation: the author deliberately creates "not yet paid off but imminent" gaps; the eventual payoff must exceed reader expectation by 70%.
+3. Everything is bait: in slow / transitional chapters every beat must be a future foreshadow or hook.
+4. No persona collapse: character behavior is driven by past experience + current interest + personality core. Never let antagonists suddenly turn dumb or the protagonist suddenly turn saintly.
+5. 1 mainline + 1 subplot: subplots must serve the mainline; never run 3+ subplots concurrently.
+6. Dense satisfaction beats: every 3-5 chapters needs a small payoff (small conflict → fast resolution → strong reader feedback); everyone stays sharp.
+7. Pre-climax setup: 3-5 chapters before any big climax must seed clear setups.
+8. Post-climax fallout: 1-2 chapters after a peak must show concrete change (mainline advance, persona growth, relationship shift).
+9. Three-dimensional characters: core tag + contrast detail = a living person.
+10. Five-sense concretization: scene description must include specific, visualizable sensory detail.
+11. Hook-passing: every chapter ends with a hook for the next.
+12. Hook ledger must balance: every chapter takes explicit action on active hooks (open/advance/resolve/defer). "Open a pile of hooks and never resolve any" is forbidden.
+13. Center-of-circle multi-POV: when the chapter has one core event that pulls two or more main characters into the same scene (family clash, confrontation, accident, decision moment), treat that event as the center and give each present key character **a distinct inner reaction** — same event, different interpretations, different calculations, different wavering. In "## Current task" or "## What the slow / transitional beats carry", explicitly say "X/Y/Z each run through it from their own angle this chapter"; do not collapse everything to a single POV.
+14. Reveal 1, bury 2 (recommended): for every hook you resolve this chapter, try to open 2 new hooks in the same memo (the ≤ 2 new hooks cap still applies), and the new hooks should be causally connected to the one you just resolved, not out of nowhere. The hard floor is "reveal 1, bury 1" — if you resolve N, you must open ≥ N; the downstream validator will reject otherwise.
+
+## Output format (strict)
+
+Output YAML frontmatter + markdown body. Do NOT wrap markdown in a JSON object. Do NOT add code-block fences.
+
+Structure:
+
+---
+chapter: 12
+goal: Pin the Door 7 tampering from suspicion to live evidence
+isGoldenOpening: false
+threadRefs:
+  - H03
+  - S004
+---
+
+## Current task
+<one sentence: the concrete action the protagonist must complete this chapter — no abstractions>
+
+## What the reader is waiting for right now
+<two lines:
+1) what the reader currently expects (based on prior chapters' setups)
+2) what this chapter does with that expectation — widen the gap / partial payoff / full payoff / hint without paying off>
+
+## To pay off / to keep buried
+- Pay off: X → to what degree
+- Keep buried: Y → suppress until chapter N
+
+## What the slow / transitional beats carry
+<if this is a non-pressure chapter, name the function of each non-conflict paragraph. Format: [position] → [function]
+if this is a pressure / conflict chapter, write "n/a — pressure chapter, no transitional beats">
+
+## Three-question check on the key choice
+- Protagonist's most important choice this chapter:
+  - Why this choice?
+  - Does it match current interest?
+  - Does it match their persona?
+- Antagonist / supporting cast's most important choice this chapter:
+  - Why this choice?
+  - Does it match current interest?
+  - Does it match their persona?
+
+## Required end-of-chapter change
+<1-3 items, choose from: information change / relationship change / physical change / power change>
+
+## Hook ledger for this chapter
+**The per-chapter accounting of active foreshadows. The writer must act on this ledger. Format (use "-" bullets under each subsection):**
+
+open:
+- [new] new hook description (<=30 chars) || reason: why open it now, do not pay it off this chapter (cap ≤ 2; recommended: for each hook resolved this chapter, open 2 new hooks; hard floor is open ≥ resolve)
+
+advance:
+- H007 "Huzi's IOU" → Lin Qiu tries to tear it, gets stopped (planted → pressured)
+- H012 "thunder rack scar" → a senior brother sneaks a look, leaves a mark (pressured → near_payoff)
+
+resolve:
+- H003 "errand badge" → Lin Qiu unpins it himself (clear)
+
+defer:
+- H009 "origin of Shou-Zhuo Jue" → not touched this chapter, reason: timing not right, save until chapter N
+
+**Hard rules**:
+- If any hook in input pending_hooks is already "pressured" or "near_payoff" AND has not advanced in ≥ 5 chapters, it **must** go into advance or resolve — deferring is not allowed.
+- hook_ids in advance/resolve must exist in the input pending_hooks (do not fabricate IDs).
+- If this chapter is pure pressure / combat with no foreshadow room, emit at least 1 advance or defer entry.
+- If "## Current task" naturally corresponds to paying off a hook, it must appear under resolve with the hook_id.
+
+## Do not
+<2-4 hard prohibitions>
+
+## Output requirements
+
+- goal field is no more than 50 characters
+- threadRefs is a YAML array of ids picked from the input pending_hooks / subplot_board
+- Every level-2 heading (##) must appear; none may be empty
+- Do NOT use methodology jargon ("emotional gap", "cyclePhase", "pressure buildup") in the memo — speak directly using this book's people, places, events
+- Do NOT produce prose or dialogue fragments
+- If the volume outline conflicts with the previous chapter summary, trust the summary (those events actually happened)`;
+export const PLANNER_MEMO_USER_TEMPLATE_EN = `# Chapter {{chapterNumber}} memo request
+
+{{brief_block}}
+
+## Last screen of previous chapter (excerpt)
+{{previous_chapter_ending_excerpt}}
+
+## Last 3 chapter summaries
+{{recent_summaries}}
+
+## What the current arc is pushing
+{{current_arc_prose}}
+
+## Protagonist current state
+{{protagonist_matrix_row}}
+
+## Main antagonist / opposing forces this chapter
+{{opponent_rows}}
+
+## Main collaborators this chapter
+{{collaborator_rows}}
+
+## Threads that may be touched (foreshadows + subplots)
+{{relevant_threads}}
+
+## Stale hooks — MUST be advanced / resolved / explicitly deferred this chapter
+{{recyclable_hooks}}
+
+## Out-of-volume constraints for this chapter
+- Golden opening chapter: {{isGoldenOpening}}
+- Hard rules (excerpt of items this chapter may touch):
+{{book_rules_relevant}}
+
+Produce the memo for chapter {{chapterNumber}}. Strictly emit YAML frontmatter + markdown.`;
+/**
+ * Phase hotfix 4: select the language-appropriate planner system prompt.
+ * Defaults to zh for backward compatibility — explicit "en" required for
+ * the English variant.
+ */
+export function getPlannerMemoSystemPrompt(language = "zh") {
+    return language === "en" ? PLANNER_MEMO_SYSTEM_PROMPT_EN : PLANNER_MEMO_SYSTEM_PROMPT;
+}
+export function getPlannerMemoUserTemplate(language = "zh") {
+    return language === "en" ? PLANNER_MEMO_USER_TEMPLATE_EN : PLANNER_MEMO_USER_TEMPLATE;
+}
+export const PLANNER_MEMO_USER_TEMPLATE = `# 第 {{chapterNumber}} 章 memo 请求
+
+{{brief_block}}
+
+## 上一章最后一屏（原文节选）
+{{previous_chapter_ending_excerpt}}
+
+## 最近 3 章摘要
+{{recent_summaries}}
+
+## 当前 arc 正在推进什么
+{{current_arc_prose}}
+
+## 主角当前状态
+{{protagonist_matrix_row}}
+
+## 本章主要对手/阻力方
+{{opponent_rows}}
+
+## 本章主要协作者
+{{collaborator_rows}}
+
+## 可能被牵动的 thread（伏笔 + 支线）
+{{relevant_threads}}
+
+## 必须回收的陈旧 hook（本章必须 advance / resolve / 显式 defer）
+{{recyclable_hooks}}
+
+## 本章卷外约束
+- 是否黄金三章：{{isGoldenOpening}}
+- 硬约束（摘取本章可能触碰的条目）：
+{{book_rules_relevant}}
+
+请为第 {{chapterNumber}} 章产生 memo。严格按 YAML frontmatter + markdown 格式输出。`;
+export function buildPlannerUserMessage(input) {
+    const language = input.language ?? "zh";
+    const template = getPlannerMemoUserTemplate(language);
+    const yesText = language === "en" ? "yes" : "是";
+    const noText = language === "en" ? "no" : "否";
+    const briefBlock = buildBriefBlock(input.brief ?? "", language);
+    const filled = template
+        .replaceAll("{{chapterNumber}}", String(input.chapterNumber))
+        .replaceAll("{{brief_block}}", briefBlock)
+        .replaceAll("{{previous_chapter_ending_excerpt}}", input.previousChapterEndingExcerpt)
+        .replaceAll("{{recent_summaries}}", input.recentSummaries)
+        .replaceAll("{{current_arc_prose}}", input.currentArcProse)
+        .replaceAll("{{protagonist_matrix_row}}", input.protagonistMatrixRow)
+        .replaceAll("{{opponent_rows}}", input.opponentRows)
+        .replaceAll("{{collaborator_rows}}", input.collaboratorRows)
+        .replaceAll("{{relevant_threads}}", input.relevantThreads)
+        .replaceAll("{{recyclable_hooks}}", input.recyclableHooks)
+        .replaceAll("{{isGoldenOpening}}", input.isGoldenOpening ? yesText : noText)
+        .replaceAll("{{book_rules_relevant}}", input.bookRulesRelevant);
+    const golden = buildGoldenOpeningGuidance(input.chapterNumber, language);
+    return golden ? `${filled}\n\n${golden}` : filled;
+}
+/**
+ * Brief is the user's original creative document. It's the highest authority
+ * source for "what this book is". story_frame/volume_map are the architect's
+ * abstraction of brief; chapter memos must honor brief first.
+ *
+ * Returns "" when no brief exists (legacy books without brief.md).
+ */
+function buildBriefBlock(brief, language) {
+    const trimmed = brief.trim();
+    if (!trimmed)
+        return "";
+    if (language === "en") {
+        return `## Creative brief (user's original intent — authoritative)
+${trimmed}
+
+The brief is the user's direct instruction. When planning this chapter, honor the brief's core setup (protagonist concept, world premise, opening mechanics, sample chapter hooks if any) before anything else. Do NOT defer the brief's core setup to later chapters; land it early.`;
+    }
+    return `## 用户创作 brief（原始意图——最高优先级）
+${trimmed}
+
+brief 是用户的直接指令。本章规划时，必须优先兑现 brief 里写明的核心设定（主角设定、世界前提、开场机制、样本章回钩子等）。**不要把 brief 里的核心设定推迟到后面的章节**——该在前几章落地的必须落地。`;
+}
+// ---------------------------------------------------------------------------
+// 黄金三章 prose guidance — Phase 6.5
+// Single conditional append (chapterNumber <= 3). No new schema, no new
+// runtime branch. Cohesive paragraphs, NOT a numbered checklist.
+// ---------------------------------------------------------------------------
+export function buildGoldenOpeningGuidance(chapterNumber, language = "zh") {
+    if (chapterNumber > 3)
+        return "";
+    if (language === "en") {
+        return `## Golden Opening Guidance — Chapter ${chapterNumber}
+
+This is chapter ${chapterNumber} of the opening three — the chapters that decide whether a reader stays. The Golden Three Chapters rule from new.txt assigns each chapter a load-bearing slot: chapter 1 must throw the reader straight into the core conflict (the protagonist enters already facing the main contradiction — chase, dead-end, dispossession, transmigration-as-crisis), not a paragraph of background, family tree, weather, or dynastic preamble. Chapter 2 must put the protagonist's edge — the system, the power, the rebirth-memory, the information advantage — on the stage through one concrete event (not "he awakened a power" narrated, but "he used it for X and Y happened"). Chapter 3 must lock in a concrete short-term goal achievable within the next 3-10 chapters (build the first stake of capital, take down the small antagonist, save someone), giving the story forward pull.
+
+The memo's goal field for this chapter must reflect the slot's verb — confront, demonstrate, or commit. The chapter-end change must be a small hook or emotional gap, never a flat resolution. Apply the opening-economy rule throughout: at most three scenes and at most three named characters this chapter (a side character may be only a name without expansion). Information layering is mandatory — basic facts (appearance, status, situation) ride on the protagonist's actions, world rules ride on plot triggers; do not stage a paragraph of exposition.`;
+    }
+    return `## 黄金三章规划指引 — 第 ${chapterNumber} 章
+
+这是开篇三章中的第 ${chapterNumber} 章——决定读者是否留下来的关键章节。new.txt 的黄金三章法则给每一章分了硬槽位：第 1 章必须把主角直接抛进核心冲突里（主角出场即面对主线矛盾——追杀、死局、被夺权、穿越即危机），不要拿背景、家族、天气、朝代铺垫开场。第 2 章必须让金手指落地一次——系统/能力/重生记忆/信息差，必须通过**一次具体事件**展现出来（不是"他觉醒了 XX"的旁白，而是"他用了 XX，发生了 YY"）。第 3 章必须给主角钉下一个 3-10 章内可达成的具体短期目标（攒第一桶金、干翻某小反派、救某人），给故事一条往前拉的引力线。
+
+本章 memo 的 goal 字段必须体现对应槽位的动词——抛出、展现、或锁定。章尾必须发生的改变要落在小钩子或情绪缺口上，不要写成平稳收束。开篇精简原则贯穿本章：场景 ≤ 3 个、人物 ≤ 3 个（配角可以只报名字，不展开）。信息分层强制要求：基础信息（外貌、身份、处境）通过主角行动自然带出，世界规则（设定、势力、底层逻辑）结合剧情节点揭示，禁止整段 exposition。`;
+}
+//# sourceMappingURL=planner-prompts.js.map

package/dist/agents/planner-prompts.js.map

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

package/dist/agents/planner.d.ts

@@ -1,6 +1,7 @@
 import { BaseAgent } from "./base.js";
 import type { BookConfig } from "../models/book.js";
-import { type ChapterIntent } from "../models/input-governance.js";
+import { type ChapterIntent, type ChapterMemo } from "../models/input-governance.js";
+import type { StoredHook } from "../state/memory-db.js";
 export interface PlanChapterInput {
     readonly book: BookConfig;
     readonly bookDir: string;
@@ -9,28 +10,56 @@ export interface PlanChapterInput {
 }
 export interface PlanChapterOutput {
     readonly intent: ChapterIntent;
+    readonly memo: ChapterMemo;
     readonly intentMarkdown: string;
     readonly plannerInputs: ReadonlyArray<string>;
     readonly runtimePath: string;
 }
+/**
+ * Phase 3 planner.
+ *
+ * Produces:
+ *   - a simplified ChapterIntent (goal + outline + keep/avoid/style) —
+ *     still deterministic, used for retrieval hints and the intent markdown.
+ *   - a full ChapterMemo (YAML frontmatter + 7-section markdown body) via
+ *     LLM call + strict parser.
+ *
+ * Retry policy: up to 3 attempts. Each failed parse appends an error
+ * feedback block to the user message and re-invokes the LLM. On the third
+ * failure we surface `PlannerParseError` — never silently truncate or
+ * rename fields.
+ */
 export declare class PlannerAgent extends BaseAgent {
     get name(): string;
     planChapter(input: PlanChapterInput): Promise<PlanChapterOutput>;
-    private buildStructuredDirectives;
+    /**
+     * Invoke the LLM to produce a 7-section memo and parse it. Retries up to
+     * 3 times on parse failure, injecting the error message back into the user
+     * prompt so the LLM can correct itself.
+     */
+    planChapterMemo(input: {
+        readonly storyDir: string;
+        readonly bookDir: string;
+        readonly chapterNumber: number;
+        readonly isGoldenOpening: boolean;
+        readonly fallbackGoal: string;
+        readonly chapterSummariesRaw: string;
+        readonly previousEndingExcerpt?: string;
+        readonly brief?: string;
+        readonly recyclableHooks?: ReadonlyArray<StoredHook>;
+        readonly language?: "zh" | "en";
+    }): Promise<ChapterMemo>;
+    private isGoldenOpeningChapter;
+    private buildArcContext;
     private deriveGoal;
     private collectMustKeep;
     private collectMustAvoid;
     private collectStyleEmphasis;
-    private collectConflicts;
     private extractFirstDirective;
     private extractListItems;
     private extractFocusGoal;
     private extractLocalOverrideGoal;
     private extractFocusStyleItems;
-    private buildArcDirective;
-    private buildSceneDirective;
-    private buildMoodDirective;
-    private buildTitleDirective;
     private renderHookBudget;
     private extractSection;
     private normalizeHeading;
@@ -39,19 +68,18 @@ export declare class PlannerAgent extends BaseAgent {
     private containsChinese;
     private findOutlineNode;
     private cleanOutlineContent;
+    private extractSectionAroundRange;
+    private extractNumberedBeat;
     private findNextOutlineContent;
-    private hasMatchedOutlineAnchor;
     private matchExactOutlineLine;
     private matchAnyExactOutlineLine;
     private matchRangeOutlineLine;
     private matchAnyRangeOutlineLine;
     private isOutlineAnchorLine;
     private isChapterWithinRange;
-    private hasKeywordOverlap;
-    private extractKeywords;
     private renderIntentMarkdown;
     private unique;
     private isChineseLanguage;
-    private readFileOrDefault;
+    protected readFileOrDefault(path: string): Promise<string>;
 }
 //# sourceMappingURL=planner.d.ts.map

package/dist/agents/planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/agents/planner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAA6C,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAU9G,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,YAAa,SAAQ,SAAS;IACzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqGtE,OAAO,CAAC,yBAAyB;IAmCjC,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IAkEvB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,oBAAoB;IAwF5B,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,iBAAiB;YAIX,iBAAiB;CAOhC"}
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/agents/planner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AA4BvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkGtE;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;QAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;QACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;KACjC,GAAG,OAAO,CAAC,WAAW,CAAC;IA0ExB,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IA0EvB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,yBAAyB;IAkCjC,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,sBAAsB;IAwB9B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,oBAAoB;IAkE5B,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,iBAAiB;cAKT,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAOjE"}