inkos-n-core 1.2.0

package/dist/agents/writer.d.ts

@@ -0,0 +1,103 @@
+import { BaseAgent } from "./base.js";
+import type { BookConfig } from "../models/book.js";
+import { type PostWriteViolation } from "./post-write-validator.js";
+import type { ChapterTrace, ContextPackage, RuleStack } from "../models/input-governance.js";
+import type { LengthSpec } from "../models/length-governance.js";
+import type { RuntimeStateDelta } from "../models/runtime-state.js";
+import type { RuntimeStateSnapshot } from "../state/state-reducer.js";
+export interface WriteChapterInput {
+    readonly book: BookConfig;
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly externalContext?: string;
+    readonly chapterIntent?: string;
+    readonly contextPackage?: ContextPackage;
+    readonly ruleStack?: RuleStack;
+    readonly trace?: ChapterTrace;
+    readonly lengthSpec?: LengthSpec;
+    readonly wordCountOverride?: number;
+    readonly temperatureOverride?: number;
+}
+export interface SettleChapterStateInput {
+    readonly book: BookConfig;
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly title: string;
+    readonly content: string;
+    readonly allowReapply?: boolean;
+    readonly chapterIntent?: string;
+    readonly contextPackage?: ContextPackage;
+    readonly ruleStack?: RuleStack;
+    readonly validationFeedback?: string;
+}
+export interface TokenUsage {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalTokens: number;
+}
+export interface WriteChapterOutput {
+    readonly chapterNumber: number;
+    readonly title: string;
+    readonly content: string;
+    readonly wordCount: number;
+    readonly preWriteCheck: string;
+    readonly postSettlement: string;
+    readonly runtimeStateDelta?: RuntimeStateDelta;
+    readonly runtimeStateSnapshot?: RuntimeStateSnapshot;
+    readonly updatedState: string;
+    readonly updatedLedger: string;
+    readonly updatedHooks: string;
+    readonly chapterSummary: string;
+    readonly updatedChapterSummaries?: string;
+    readonly updatedSubplots: string;
+    readonly updatedEmotionalArcs: string;
+    readonly updatedCharacterMatrix: string;
+    readonly postWriteErrors: ReadonlyArray<PostWriteViolation>;
+    readonly postWriteWarnings: ReadonlyArray<PostWriteViolation>;
+    readonly hookHealthIssues?: ReadonlyArray<{
+        readonly severity: "critical" | "warning" | "info";
+        readonly category: string;
+        readonly description: string;
+        readonly suggestion: string;
+    }>;
+    readonly tokenUsage?: TokenUsage;
+}
+export declare class WriterAgent extends BaseAgent {
+    get name(): string;
+    private localize;
+    private logInfo;
+    private logWarn;
+    writeChapter(input: WriteChapterInput): Promise<WriteChapterOutput>;
+    settleChapterState(input: SettleChapterStateInput): Promise<WriteChapterOutput>;
+    private settle;
+    saveChapter(bookDir: string, output: WriteChapterOutput, numericalSystem?: boolean, language?: "zh" | "en"): Promise<void>;
+    private buildUserPrompt;
+    private buildGovernedUserPrompt;
+    private joinGovernedEvidenceBlocks;
+    private extractMarkdownSection;
+    private buildSettlerGovernedControlBlock;
+    private buildLengthRequirementBlock;
+    private loadRecentChapters;
+    private readFileOrDefault;
+    /** Save new truth files (summaries, subplots, emotional arcs, character matrix). */
+    saveNewTruthFiles(bookDir: string, output: WriteChapterOutput, language?: "zh" | "en"): Promise<void>;
+    private renderDeltaSummaryRow;
+    private normalizeRuntimeStateDeltaChapter;
+    private buildRuntimeStateArtifactsIfPresent;
+    private resolveRuntimeStateArtifactsForOutput;
+    private appendChapterSummary;
+    private buildStyleFingerprint;
+    /**
+     * Extract dialogue fingerprints from recent chapters.
+     * For each character with multiple dialogue lines, compute speaking style markers.
+     */
+    private extractDialogueFingerprints;
+    /**
+     * Find relevant chapter summaries based on volume outline context.
+     * Extracts character names and hook IDs from the current volume's outline,
+     * then searches chapter summaries for matching entries.
+     */
+    private findRelevantSummaries;
+    private sanitizeFilename;
+}
+//# sourceMappingURL=writer.d.ts.map

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

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