@actalk/inkos-core 1.2.0 → 1.3.0

package/dist/agent/agent-session.d.ts

@@ -0,0 +1,48 @@
+import type { AgentEvent } from "@mariozechner/pi-agent-core";
+import type { Model, Api } from "@mariozechner/pi-ai";
+import type { PipelineRunner } from "../pipeline/runner.js";
+export interface AgentSessionConfig {
+    /** Unique session identifier (typically the BookSession id). */
+    sessionId: string;
+    /** Book ID, or null if in "new book" mode. */
+    bookId: string | null;
+    /** Language for the system prompt. */
+    language: string;
+    /** PipelineRunner for sub-agent tool delegation. */
+    pipeline: PipelineRunner;
+    /** Project root directory (books/ lives under this). */
+    projectRoot: string;
+    /** pi-ai Model to use, or provider+modelId to resolve via getModel. */
+    model: Model<Api> | {
+        provider: string;
+        modelId: string;
+    };
+    /** Optional API key. When omitted, falls back to env-based key lookup. */
+    apiKey?: string;
+    /** Optional listener for streaming events (for SSE forwarding). */
+    onEvent?: (event: AgentEvent) => void;
+}
+export interface AgentSessionResult {
+    /** Extracted text from the final assistant message. */
+    responseText: string;
+    /** Full conversation history for persistence. */
+    messages: Array<{
+        role: string;
+        content: string;
+        thinking?: string;
+    }>;
+}
+/**
+ * Run a single conversation turn within a cached Agent session.
+ *
+ * If the session already exists in the cache, reuses the Agent (with its full
+ * in-memory message history including tool calls). Otherwise creates a new
+ * Agent, optionally restoring messages from `initialMessages`.
+ */
+export declare function runAgentSession(config: AgentSessionConfig, userMessage: string, initialMessages?: Array<{
+    role: string;
+    content: string;
+}>): Promise<AgentSessionResult>;
+/** Manually evict a cached Agent session. */
+export declare function evictAgentCache(sessionId: string): boolean;
+//# sourceMappingURL=agent-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../src/agent/agent-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,6BAA6B,CAAC;AAE5E,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAiC,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAc5D,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,cAAc,CAAC;IACzB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAoJD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACzD,OAAO,CAAC,kBAAkB,CAAC,CA+E7B;AAoBD,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/agent/agent-session.js

@@ -0,0 +1,229 @@
+import { Agent } from "@mariozechner/pi-agent-core";
+import { streamSimple, getModel, getEnvApiKey } from "@mariozechner/pi-ai";
+import { buildAgentSystemPrompt } from "./agent-system-prompt.js";
+import { createSubAgentTool, createReadTool, createEditTool, createGrepTool, createLsTool, } from "./agent-tools.js";
+const agentCache = new Map();
+/** TTL for cached agents: 5 minutes. */
+const CACHE_TTL_MS = 5 * 60 * 1000;
+/** Cleanup interval handle (lazy-started). */
+let cleanupTimer = null;
+function ensureCleanupTimer() {
+    if (cleanupTimer)
+        return;
+    cleanupTimer = setInterval(() => {
+        const now = Date.now();
+        for (const [id, entry] of agentCache) {
+            if (now - entry.lastActive > CACHE_TTL_MS) {
+                agentCache.delete(id);
+            }
+        }
+        // Stop the timer when nothing left to watch.
+        if (agentCache.size === 0 && cleanupTimer) {
+            clearInterval(cleanupTimer);
+            cleanupTimer = null;
+        }
+    }, 60_000); // run every 60 s
+    // Allow the process to exit even if this timer is alive.
+    if (cleanupTimer && typeof cleanupTimer === "object" && "unref" in cleanupTimer) {
+        cleanupTimer.unref();
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function resolveModel(spec) {
+    if (!spec) {
+        throw new Error("Model is required but was undefined. Check LLM configuration.");
+    }
+    if (typeof spec === "object" && "id" in spec && "api" in spec) {
+        // Already a Model object.
+        return spec;
+    }
+    const { provider, modelId } = spec;
+    if (!provider || !modelId) {
+        throw new Error(`Invalid model spec: provider=${provider}, modelId=${modelId}`);
+    }
+    return getModel(provider, modelId);
+}
+/**
+ * Extract readable text from an AssistantMessage's content array.
+ * Filters out tool-call blocks; concatenates text blocks.
+ */
+function extractTextFromAssistant(msg) {
+    return msg.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("");
+}
+/**
+ * Extract thinking/reasoning text from an AssistantMessage's content array.
+ */
+function extractThinkingFromAssistant(msg) {
+    return msg.content
+        .filter((c) => c.type === "thinking")
+        .map((c) => c.thinking ?? "")
+        .join("");
+}
+/**
+ * Convert plain `{ role, content }` messages (from BookSession disk storage)
+ * back into pi-agent AgentMessage format so they can be loaded into an Agent.
+ */
+function plainToAgentMessages(plain) {
+    return plain.map((m) => {
+        const ts = Date.now();
+        if (m.role === "user") {
+            return { role: "user", content: m.content, timestamp: ts };
+        }
+        // For stored assistant messages we only have the text.
+        // Re-wrap as a minimal AssistantMessage with a single TextContent.
+        return {
+            role: "assistant",
+            content: [{ type: "text", text: m.content }],
+            api: "anthropic-messages",
+            provider: "anthropic",
+            model: "unknown",
+            usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
+            stopReason: "stop",
+            timestamp: ts,
+        };
+    });
+}
+/**
+ * Flatten the Agent's in-memory messages to plain `{ role, content }` pairs
+ * suitable for BookSession persistence.
+ */
+function agentMessagesToPlain(messages) {
+    const out = [];
+    for (const msg of messages) {
+        if (!msg || typeof msg !== "object" || !("role" in msg))
+            continue;
+        const m = msg;
+        if (m.role === "user") {
+            const content = typeof m.content === "string"
+                ? m.content
+                : Array.isArray(m.content)
+                    ? m.content
+                        .filter((c) => c.type === "text")
+                        .map((c) => c.text)
+                        .join("")
+                    : "";
+            if (content)
+                out.push({ role: "user", content });
+        }
+        else if (m.role === "assistant") {
+            const text = extractTextFromAssistant(m);
+            const thinking = extractThinkingFromAssistant(m);
+            if (text || thinking) {
+                const entry = { role: "assistant", content: text };
+                if (thinking)
+                    entry.thinking = thinking;
+                out.push(entry);
+            }
+        }
+        // ToolResult messages are internal; skip them for persistence.
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Run a single conversation turn within a cached Agent session.
+ *
+ * If the session already exists in the cache, reuses the Agent (with its full
+ * in-memory message history including tool calls). Otherwise creates a new
+ * Agent, optionally restoring messages from `initialMessages`.
+ */
+export async function runAgentSession(config, userMessage, initialMessages) {
+    const { sessionId, bookId, language, pipeline, projectRoot, onEvent } = config;
+    // ----- Resolve or create Agent -----
+    let cached = agentCache.get(sessionId);
+    if (cached) {
+        // Check if model changed — evict and rebuild if so
+        const currentModelId = cached.agent.state.model?.id;
+        const newModelId = typeof config.model === 'object' && 'id' in config.model
+            ? config.model.id
+            : undefined;
+        if (currentModelId && newModelId && currentModelId !== newModelId) {
+            // Preserve conversation messages for re-injection
+            const preservedMessages = agentMessagesToPlain(cached.agent.state.messages);
+            agentCache.delete(sessionId);
+            cached = undefined;
+            // Pass preserved messages as initialMessages if none were provided
+            if (!initialMessages || initialMessages.length === 0) {
+                initialMessages = preservedMessages;
+            }
+        }
+    }
+    if (!cached) {
+        const model = resolveModel(config.model);
+        const agent = new Agent({
+            initialState: {
+                model,
+                systemPrompt: buildAgentSystemPrompt(bookId, language),
+                tools: [
+                    createSubAgentTool(pipeline, bookId),
+                    createReadTool(projectRoot),
+                    createEditTool(projectRoot),
+                    createGrepTool(projectRoot),
+                    createLsTool(projectRoot),
+                ],
+            },
+            streamFn: streamSimple,
+            getApiKey: (provider) => {
+                if (config.apiKey)
+                    return config.apiKey;
+                return getEnvApiKey(provider);
+            },
+        });
+        // Restore prior conversation if provided.
+        if (initialMessages && initialMessages.length > 0) {
+            agent.state.messages = plainToAgentMessages(initialMessages);
+        }
+        cached = { agent, lastActive: Date.now() };
+        agentCache.set(sessionId, cached);
+        ensureCleanupTimer();
+    }
+    cached.lastActive = Date.now();
+    const { agent } = cached;
+    // ----- Subscribe to events (for SSE streaming to frontend) -----
+    let unsubscribe;
+    if (onEvent) {
+        unsubscribe = agent.subscribe((event) => {
+            onEvent(event);
+        });
+    }
+    // ----- Execute the turn -----
+    try {
+        await agent.prompt(userMessage);
+    }
+    finally {
+        unsubscribe?.();
+    }
+    // ----- Extract result -----
+    const allMessages = agent.state.messages;
+    const responseText = extractResponseText(allMessages);
+    const plainMessages = agentMessagesToPlain(allMessages);
+    return { responseText, messages: plainMessages };
+}
+/**
+ * Walk backward through messages to find the last assistant message and
+ * extract its text content.
+ */
+function extractResponseText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg && typeof msg === "object" && "role" in msg && msg.role === "assistant") {
+            return extractTextFromAssistant(msg);
+        }
+    }
+    return "";
+}
+// ---------------------------------------------------------------------------
+// Cache management
+// ---------------------------------------------------------------------------
+/** Manually evict a cached Agent session. */
+export function evictAgentCache(sessionId) {
+    return agentCache.delete(sessionId);
+}
+//# sourceMappingURL=agent-session.js.map

package/dist/agent/agent-session.js.map

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

package/dist/agent/agent-system-prompt.d.ts

@@ -0,0 +1,2 @@
+export declare function buildAgentSystemPrompt(bookId: string | null, language: string): string;
+//# sourceMappingURL=agent-system-prompt.d.ts.map

package/dist/agent/agent-system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-system-prompt.d.ts","sourceRoot":"","sources":["../../src/agent/agent-system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiGtF"}

package/dist/agent/agent-system-prompt.js

@@ -0,0 +1,97 @@
+export function buildAgentSystemPrompt(bookId, language) {
+    const isZh = language === "zh";
+    if (!bookId) {
+        return isZh
+            ? `你是 InkOS 建书助手。你的任务是帮用户从零开始创建一本新书。
+
+## 工作流程
+
+1. **收集信息**（对话阶段）— 通过自然对话逐步了解：
+   - 题材/类型（如玄幻、都市、悬疑、言情等）
+   - 目标平台（番茄小说、起点中文网、飞卢等）
+   - 世界观设定（什么样的世界？有什么特殊规则？）
+   - 主角设定（谁？什么背景？什么性格？）
+   - 核心冲突（主线矛盾是什么？）
+   - 写作语言（中文/English）
+
+2. **确认建书**（调用阶段）— 当信息足够时，调用 sub_agent 工具委托 architect 子智能体建书：
+   - instruction 中包含收集到的所有信息（题材、世界观、主角、冲突等）
+   - architect 会生成完整的 foundation（世界观设定、卷纲规划、叙事规则等）
+
+## 对话风格
+
+- 每次只问一个问题，不要一次问太多
+- 用户回答模糊时，给出 2-3 个具体选项引导
+- 当信息基本齐了，主动提议建书，不要无限追问
+- 保持简短、自然
+- **不要在回复中添加表情符号**`
+            : `You are the InkOS book creation assistant. Help the user create a new book from scratch.
+
+## Workflow
+
+1. **Collect information** — Through conversation, gradually learn:
+   - Genre (fantasy, urban, mystery, romance, etc.)
+   - Target platform
+   - World setting
+   - Protagonist
+   - Core conflict
+   - Writing language
+
+2. **Create book** — When you have enough info, call the sub_agent tool with agent="architect":
+   - Include all collected info in the instruction
+   - The architect will generate the complete foundation
+
+## Style
+
+- Ask one question at a time
+- Offer 2-3 concrete options when the user is vague
+- Proactively suggest creating the book when enough info is collected
+- Keep responses brief and natural
+- **Do NOT use emoji in your responses**`;
+    }
+    return isZh
+        ? `你是 InkOS 写作助手，当前正在处理书籍「${bookId}」。
+
+## 可用工具
+
+- **sub_agent** — 委托子智能体执行重操作：
+  - agent="writer" 写下一章
+  - agent="auditor" 审计章节质量
+  - agent="reviser" 修订章节
+  - agent="exporter" 导出书籍
+- **read** — 读取书籍的设定文件或章节内容
+- **edit** — 编辑设定文件（如修改角色名、调整世界观）
+- **grep** — 搜索内容（如"哪一章提到了某个角色"）
+- **ls** — 列出文件或章节
+
+## 使用原则
+
+- 写章节、修订、审计等重操作 → 使用 sub_agent 委托对应子智能体
+- 用户问设定相关问题 → 先用 read 读取对应文件再回答
+- 用户想做小修改（改名字、调设定）→ 用 edit 直接修改
+- 其他情况 → 直接对话回答
+- **注意：不要调用 architect，当前已有书籍，不需要建书**
+- **不要在回复中添加表情符号**`
+        : `You are the InkOS writing assistant, working on book "${bookId}".
+
+## Available Tools
+
+- **sub_agent** — Delegate to sub-agents:
+  - agent="writer" for writing next chapter
+  - agent="auditor" for chapter quality audit
+  - agent="reviser" for chapter revision
+  - agent="exporter" for book export
+- **read** — Read truth files or chapter content
+- **edit** — Edit truth files (rename characters, adjust world settings)
+- **grep** — Search content across chapters
+- **ls** — List files or chapters
+
+## Guidelines
+
+- Use sub_agent for heavy operations (writing, revision, auditing)
+- Use read/edit for settings inquiries and small changes
+- Chat directly for other questions
+- **Do NOT call architect — a book already exists**
+- **Do NOT use emoji in your responses**`;
+}
+//# sourceMappingURL=agent-system-prompt.js.map

package/dist/agent/agent-system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-system-prompt.js","sourceRoot":"","sources":["../../src/agent/agent-system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,QAAgB;IAC5E,MAAM,IAAI,GAAG,QAAQ,KAAK,IAAI,CAAC;IAE/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI;YACT,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;mBAsBW;YACb,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;yCAsBiC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI;QACT,CAAC,CAAC,0BAA0B,MAAM;;;;;;;;;;;;;;;;;;;;;mBAqBnB;QACf,CAAC,CAAC,yDAAyD,MAAM;;;;;;;;;;;;;;;;;;;;yCAoB5B,CAAC;AAC1C,CAAC"}

package/dist/agent/agent-tools.d.ts

@@ -0,0 +1,30 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { PipelineRunner } from "../pipeline/runner.js";
+declare const SubAgentParams: import("@sinclair/typebox").TObject<{
+    agent: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"architect">, import("@sinclair/typebox").TLiteral<"writer">, import("@sinclair/typebox").TLiteral<"auditor">, import("@sinclair/typebox").TLiteral<"reviser">, import("@sinclair/typebox").TLiteral<"exporter">]>;
+    instruction: import("@sinclair/typebox").TString;
+    bookId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function createSubAgentTool(pipeline: PipelineRunner, activeBookId: string | null): AgentTool<typeof SubAgentParams>;
+declare const ReadParams: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+}>;
+export declare function createReadTool(projectRoot: string): AgentTool<typeof ReadParams>;
+declare const EditParams: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    old_string: import("@sinclair/typebox").TString;
+    new_string: import("@sinclair/typebox").TString;
+}>;
+export declare function createEditTool(projectRoot: string): AgentTool<typeof EditParams>;
+declare const GrepParams: import("@sinclair/typebox").TObject<{
+    bookId: import("@sinclair/typebox").TString;
+    pattern: import("@sinclair/typebox").TString;
+}>;
+export declare function createGrepTool(projectRoot: string): AgentTool<typeof GrepParams>;
+declare const LsParams: import("@sinclair/typebox").TObject<{
+    bookId: import("@sinclair/typebox").TString;
+    subdir: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function createLsTool(projectRoot: string): AgentTool<typeof LsParams>;
+export {};
+//# sourceMappingURL=agent-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../src/agent/agent-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAA4C,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA6B5D,QAAA,MAAM,cAAc;;;;EAUlB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CA0F1H;AAMD,QAAA,MAAM,UAAU;;EAEd,CAAC;AAEH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAwBhF;AAMD,QAAA,MAAM,UAAU;;;;EAId,CAAC;AAEH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAgChF;AAMD,QAAA,MAAM,UAAU;;;EAGd,CAAC;AAEH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CA8DhF;AAMD,QAAA,MAAM,QAAQ;;;EAKZ,CAAC;AAEH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,QAAQ,CAAC,CAwC5E"}