dsh-novel 0.1.0

package/lib/index.js

@@ -0,0 +1,1436 @@
+import { access, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import { PGlite } from "@electric-sql/pglite";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import { BUNDLED_SKILL_RANK } from "@deepseek-ai/dsh-skill";
+//#region src/novel/contract.ts
+/** Same-origin HTTP prefix for the novel Host API. */
+const NOVEL_API_PREFIX = "/dsh-novel/api";
+//#endregion
+//#region src/novel/domains.ts
+/** Entity domains aligned with Noveel registry names. */
+const ENTITY_DOMAINS = [
+	"role",
+	"roleRelation",
+	"roleTimeline",
+	"creature",
+	"creatureTimeline",
+	"item",
+	"itemTimeline",
+	"level",
+	"world",
+	"worldTimeline",
+	"timeline",
+	"outline",
+	"chapter"
+];
+function isEntityDomain(value) {
+	return ENTITY_DOMAINS.includes(value);
+}
+//#endregion
+//#region src/novel/schema.ts
+/** Create the single-novel schema used inside one workspace PGlite directory. */
+async function initNovelSchema(db) {
+	await db.exec(`
+    CREATE TABLE IF NOT EXISTS novels (
+      id TEXT PRIMARY KEY,
+      title TEXT NOT NULL,
+      description TEXT,
+      cover TEXT,
+      category TEXT NOT NULL DEFAULT '玄幻',
+      writing_style_id TEXT,
+      chapter_count INTEGER NOT NULL DEFAULT 0,
+      word_count INTEGER NOT NULL DEFAULT 0,
+      blueprint_json JSONB NOT NULL DEFAULT '{}'::jsonb,
+      outline_draft_md TEXT,
+      outline_final_md TEXT,
+      outline_status TEXT NOT NULL DEFAULT 'none',
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE TABLE IF NOT EXISTS writing_styles (
+      id TEXT PRIMARY KEY,
+      slug TEXT NOT NULL UNIQUE,
+      name TEXT NOT NULL,
+      summary TEXT NOT NULL DEFAULT '',
+      content TEXT NOT NULL DEFAULT '',
+      origin TEXT NOT NULL DEFAULT 'user',
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE TABLE IF NOT EXISTS form_templates (
+      id TEXT PRIMARY KEY,
+      novel_id TEXT NOT NULL UNIQUE,
+      config JSONB NOT NULL DEFAULT '{}'::jsonb,
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+
+    CREATE TABLE IF NOT EXISTS novel_entities (
+      domain TEXT NOT NULL,
+      id TEXT PRIMARY KEY,
+      name TEXT,
+      data JSONB NOT NULL DEFAULT '{}'::jsonb,
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+    CREATE INDEX IF NOT EXISTS idx_novel_entities_domain ON novel_entities (domain);
+    CREATE INDEX IF NOT EXISTS idx_novel_entities_name ON novel_entities (domain, name);
+
+    CREATE TABLE IF NOT EXISTS novel_skills (
+      id TEXT PRIMARY KEY,
+      section TEXT NOT NULL,
+      folder TEXT NOT NULL DEFAULT '',
+      agent_kind TEXT NOT NULL DEFAULT 'write',
+      title TEXT NOT NULL,
+      body TEXT NOT NULL DEFAULT '',
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+    );
+    ALTER TABLE novel_skills ADD COLUMN IF NOT EXISTS folder TEXT NOT NULL DEFAULT '';
+    UPDATE novel_skills SET folder = CASE
+      WHEN folder <> '' THEN folder
+      WHEN agent_kind = 'review' AND section IN ('outline') THEN '审查/大纲'
+      WHEN agent_kind = 'review' AND section IN ('chapters', 'chapter') THEN '审查/章节'
+      WHEN section = 'overview' THEN '概述'
+      WHEN section = 'role' THEN '人物'
+      WHEN section = 'creature' THEN '生物'
+      WHEN section = 'item' THEN '物品'
+      WHEN section = 'level' THEN '等级'
+      WHEN section = 'world' THEN '世界'
+      WHEN section = 'timeline' THEN '时间线'
+      WHEN section = 'outline' THEN '大纲'
+      WHEN section IN ('chapter', 'chapters') THEN '章节'
+      ELSE '其他'
+    END
+    WHERE folder = '';
+
+
+    CREATE TABLE IF NOT EXISTS novel_chapter_change_batches (
+      id TEXT PRIMARY KEY,
+      chapter_id TEXT NOT NULL,
+      summary TEXT NOT NULL DEFAULT '',
+      ops_json JSONB NOT NULL DEFAULT '[]'::jsonb,
+      created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+      rolled_back_at TIMESTAMPTZ
+    );
+  `);
+	await db.exec(`
+    DELETE FROM novel_skills WHERE folder = '题材' OR folder LIKE '题材/%'
+  `);
+}
+//#endregion
+//#region src/novel/defaults.ts
+/** Minimal form template so a new workspace is immediately writable. */
+const DEFAULT_FORM_TEMPLATE = {
+	version: 1,
+	overview: { fields: [
+		{
+			key: "genre",
+			label: "小说类型",
+			component: "text"
+		},
+		{
+			key: "tone",
+			label: "基调",
+			component: "text"
+		},
+		{
+			key: "coreConflict",
+			label: "核心冲突",
+			component: "textarea"
+		},
+		{
+			key: "logline",
+			label: "一句话故事",
+			component: "textarea"
+		}
+	] },
+	role: { detailFields: [{
+		key: "summary",
+		label: "简介",
+		component: "textarea"
+	}] },
+	creature: { detailFields: [{
+		key: "summary",
+		label: "简介",
+		component: "textarea"
+	}] },
+	item: { detailFields: [{
+		key: "summary",
+		label: "简介",
+		component: "textarea"
+	}] },
+	level: { detailFields: [{
+		key: "summary",
+		label: "体系说明",
+		component: "textarea"
+	}] },
+	world: { detailFields: [{
+		key: "summary",
+		label: "说明",
+		component: "textarea"
+	}] },
+	timeline: { detailFields: [{
+		key: "content",
+		label: "内容",
+		component: "textarea"
+	}] },
+	outline: { detailFields: [{
+		key: "summary",
+		label: "说明",
+		component: "textarea"
+	}] }
+};
+//#endregion
+//#region src/novel/template-fields.ts
+const TEMPLATE_PRESET_MAIN_CATEGORIES = [
+	"玄幻",
+	"都市",
+	"科幻",
+	"末世",
+	"仙侠",
+	"言情",
+	"悬疑",
+	"历史"
+];
+const CATEGORY_ALIASES = {
+	玄幻: "玄幻",
+	东方玄幻: "玄幻",
+	异世大陆: "玄幻",
+	高武世界: "玄幻",
+	都市: "都市",
+	都市异能: "都市",
+	科幻: "科幻",
+	星际: "科幻",
+	末世: "末世",
+	末日: "末世",
+	仙侠: "仙侠",
+	修真: "仙侠",
+	言情: "言情",
+	悬疑: "悬疑",
+	推理: "悬疑",
+	历史: "历史"
+};
+function normalizeTemplatePresetCategory(raw) {
+	const t = (raw ?? "").trim();
+	if (t.length === 0) return "玄幻";
+	const direct = CATEGORY_ALIASES[t];
+	if (direct !== void 0) return direct;
+	for (const main of TEMPLATE_PRESET_MAIN_CATEGORIES) if (t.includes(main)) return main;
+	return "玄幻";
+}
+//#endregion
+//#region src/novel/seed.ts
+function packageRoot() {
+	const here = dirname(fileURLToPath(import.meta.url));
+	if (basename(here) === "novel") return join(here, "..", "..");
+	return join(here, "..");
+}
+function seedTemplatesDir() {
+	return join(packageRoot(), "seed", "templates");
+}
+function seedSkillsDir() {
+	return join(packageRoot(), "seed", "skills");
+}
+function loadRecommendedTemplate(category) {
+	const main = normalizeTemplatePresetCategory(category);
+	const primary = join(seedTemplatesDir(), `${main}.json`);
+	const fallback = join(seedTemplatesDir(), "玄幻.json");
+	const path = existsSync(primary) ? primary : fallback;
+	if (!existsSync(path)) throw new Error(`未找到推荐模板：seed/templates/${main}.json`);
+	return JSON.parse(readFileSync(path, "utf8"));
+}
+function listBuiltinWritingStylePresets() {
+	const root = join(seedSkillsDir(), "writing-style");
+	if (!existsSync(root)) return [];
+	const out = [];
+	for (const ent of readdirSync(root, { withFileTypes: true })) {
+		if (!ent.isDirectory() || ent.name.startsWith("_")) continue;
+		if (!existsSync(join(root, ent.name, "STYLE.md"))) continue;
+		const metaPath = join(root, ent.name, "meta.json");
+		let name = ent.name;
+		if (existsSync(metaPath)) try {
+			const meta = JSON.parse(readFileSync(metaPath, "utf8"));
+			if (typeof meta.name === "string" && meta.name.trim().length > 0) name = meta.name.trim();
+		} catch {}
+		const id = createHash("sha256").update(`builtin-ws:${ent.name}`).digest("hex").slice(0, 8);
+		out.push({
+			id,
+			slug: ent.name,
+			name
+		});
+	}
+	return out;
+}
+async function seedWritingStyleBuiltins(db) {
+	const root = join(seedSkillsDir(), "writing-style");
+	if (!existsSync(root)) return;
+	for (const preset of listBuiltinWritingStylePresets()) {
+		const content = readFileSync(join(root, preset.slug, "STYLE.md"), "utf8");
+		const metaPath = join(root, preset.slug, "meta.json");
+		let summary = "";
+		if (existsSync(metaPath)) try {
+			summary = JSON.parse(readFileSync(metaPath, "utf8")).summary?.trim() ?? "";
+		} catch {
+			summary = "";
+		}
+		await db.query(`INSERT INTO writing_styles (id, slug, name, summary, content, origin)
+       VALUES ($1, $2, $3, $4, $5, 'builtin')
+       ON CONFLICT (slug) DO UPDATE SET
+         name = EXCLUDED.name,
+         summary = EXCLUDED.summary,
+         content = EXCLUDED.content,
+         updated_at = NOW()`, [
+			preset.id,
+			preset.slug,
+			preset.name,
+			summary,
+			content
+		]);
+	}
+}
+const DIR_TO_SECTION = {
+	overview: "overview",
+	role: "role",
+	creature: "creature",
+	level: "level",
+	world: "world",
+	timeline: "timeline",
+	outline: "outline",
+	chapter: "chapters",
+	item: "item"
+};
+const SECTION_TO_FOLDER = {
+	overview: "概述",
+	role: "人物",
+	creature: "生物",
+	item: "物品",
+	level: "等级",
+	world: "世界",
+	timeline: "时间线",
+	outline: "大纲",
+	chapter: "章节",
+	chapters: "章节"
+};
+function readMdDir(dir, section, agentKind, folder) {
+	if (!existsSync(dir)) return [];
+	const out = [];
+	for (const file of readdirSync(dir).filter((name) => name.endsWith(".md"))) {
+		const body = readFileSync(join(dir, file), "utf8");
+		if (body.trim().length === 0) continue;
+		out.push({
+			section,
+			folder,
+			agent_kind: agentKind,
+			title: basename(file, ".md"),
+			body
+		});
+	}
+	return out;
+}
+/** Disk skill markdown used both to seed a workspace and to advertise module skills before init. */
+function listSeedSkillRows() {
+	const ref = seedSkillsDir();
+	const rows = [];
+	for (const [dir, section] of Object.entries(DIR_TO_SECTION)) rows.push(...readMdDir(join(ref, dir), section, "write", SECTION_TO_FOLDER[dir] ?? dir));
+	rows.push(...readMdDir(join(ref, "review", "outline"), "outline", "review", "审查/大纲"));
+	rows.push(...readMdDir(join(ref, "review", "chapter"), "chapters", "review", "审查/章节"));
+	return rows;
+}
+/** Seed generic skill markdown (genre-specific files under seed/skills/genres are not loaded). */
+async function seedNovelSkills(db, _category) {
+	for (const row of listSeedSkillRows()) await db.query(`INSERT INTO novel_skills (id, section, folder, agent_kind, title, body)
+       VALUES ($1, $2, $3, $4, $5, $6)`, [
+		randomUUID(),
+		row.section,
+		row.folder,
+		row.agent_kind,
+		row.title,
+		row.body
+	]);
+}
+async function listWritingStyles(db) {
+	const { rows } = await db.query(`SELECT id, name, slug FROM writing_styles ORDER BY origin, name`);
+	return rows;
+}
+//#endregion
+//#region src/novel/outline-labels.ts
+function asOrdinal(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim() !== "") {
+		const n = Number(value.trim());
+		if (Number.isFinite(n)) return n;
+	}
+}
+function canonicalizeOutlineKind(raw) {
+	if (typeof raw !== "string") return void 0;
+	const key = raw.trim();
+	if (key === "chapter_segment" || key === "chapter" || key === "章") return "chapter_segment";
+	if (key === "volume" || key === "卷") return "volume";
+}
+function outlineKindOf(data) {
+	const explicit = canonicalizeOutlineKind(data.kind ?? data.nodeKind);
+	if (explicit !== void 0) return explicit;
+	return typeof data.parentId === "string" && data.parentId.length > 0 || typeof data.parentName === "string" && data.parentName.length > 0 ? "chapter_segment" : "volume";
+}
+//#endregion
+//#region src/novel/normalize-entity.ts
+function asRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asNonEmptyString(value) {
+	if (typeof value !== "string") return void 0;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : void 0;
+}
+/** Merge nested `profile` onto the root; existing top-level keys win. */
+function hoistProfile(data) {
+	return {
+		...asRecord(data.profile),
+		...data
+	};
+}
+/** Merge outline `extra` onto the root; existing top-level keys win. */
+function hoistOutlineExtra(data) {
+	return {
+		...asRecord(data.extra),
+		...data
+	};
+}
+function levelNameOf(data) {
+	return asNonEmptyString(data.name) ?? asNonEmptyString(data.title) ?? asNonEmptyString(asRecord(data.system).name);
+}
+const FROM_KEYS = [
+	"roleId",
+	"from",
+	"fromName",
+	"source",
+	"fromRole"
+];
+const TO_KEYS = [
+	"targetRoleId",
+	"to",
+	"toName",
+	"target",
+	"toRole"
+];
+function pickFirstString(data, keys) {
+	for (const key of keys) {
+		const value = asNonEmptyString(data[key]);
+		if (value !== void 0) return value;
+	}
+}
+function omitKeys(data, keys) {
+	const next = { ...data };
+	for (const key of keys) delete next[key];
+	return next;
+}
+function resolveRef(ref, map, label) {
+	const id = map.get(ref);
+	if (id === void 0) throw new Error(`${label} not found: ${ref}`);
+	return id;
+}
+/** Canonicalize mutate payloads so the content tab can read template keys. */
+function normalizeEntityPayload(domain, raw, lookups) {
+	let data = hoistProfile(raw);
+	if (domain === "outline") data = hoistOutlineExtra(data);
+	if (domain === "level") {
+		const name = levelNameOf(data);
+		if (name !== void 0) data = {
+			...data,
+			name
+		};
+	}
+	if (domain === "world") {
+		const parentId = asNonEmptyString(data.parentId);
+		const parentName = asNonEmptyString(data.parentName);
+		if (parentId === void 0 && parentName !== void 0) data = {
+			...data,
+			parentId: resolveRef(parentName, lookups.worldIdByName, "world parent")
+		};
+		data = omitKeys(data, ["parentName"]);
+	}
+	if (domain === "outline") {
+		const parentId = asNonEmptyString(data.parentId);
+		const parentName = asNonEmptyString(data.parentName);
+		if (parentId === void 0 && parentName !== void 0) data = {
+			...data,
+			parentId: resolveRef(parentName, lookups.outlineIdByName, "outline parent")
+		};
+		const ordinal = asOrdinal(data.ordinal) ?? asOrdinal(data.chapterNo);
+		data = {
+			...data,
+			kind: outlineKindOf(data),
+			...ordinal !== void 0 ? { ordinal } : {}
+		};
+		data = omitKeys(data, [
+			"parentName",
+			"nodeKind",
+			"volumeNo",
+			"chapterNo"
+		]);
+	}
+	if (domain === "chapter") {
+		const relatedId = asNonEmptyString(data.relatedOutlineId);
+		const relatedName = asNonEmptyString(data.relatedOutlineName);
+		if (relatedId === void 0 && relatedName !== void 0) {
+			const id = lookups.outlineChapterIdByName.get(relatedName) ?? lookups.outlineIdByName.get(relatedName);
+			if (id === void 0) throw new Error(`outline chapter not found: ${relatedName}`);
+			data = {
+				...data,
+				relatedOutlineId: id
+			};
+		}
+		const ordinal = asOrdinal(data.ordinal) ?? asOrdinal(data.chapterNo);
+		if (ordinal !== void 0) data = {
+			...data,
+			ordinal
+		};
+		data = omitKeys(data, [
+			"relatedOutlineName",
+			"chapterNo",
+			"volumeNo"
+		]);
+	}
+	if (domain === "roleRelation") {
+		const fromRef = pickFirstString(data, FROM_KEYS);
+		const toRef = pickFirstString(data, TO_KEYS);
+		if (fromRef === void 0 || toRef === void 0) throw new Error("roleRelation requires both ends (roleId/from and targetRoleId/to)");
+		data = {
+			...data,
+			roleId: resolveRef(fromRef, lookups.roleIdByRef, "role"),
+			targetRoleId: resolveRef(toRef, lookups.roleIdByRef, "role")
+		};
+	}
+	return data;
+}
+//#endregion
+//#region src/novel/store.ts
+const NOVEL_DIR = ".dsh-novel";
+const LEGACY_NOVEL_DIR = ".noveel";
+const META_FILE = "meta.json";
+function novelRoot(workspacePath) {
+	return join(workspacePath, NOVEL_DIR);
+}
+async function migrateLegacyNovelDir(workspacePath) {
+	const next = join(workspacePath, NOVEL_DIR);
+	const legacy = join(workspacePath, LEGACY_NOVEL_DIR);
+	try {
+		await access(next);
+		return;
+	} catch {}
+	try {
+		await access(legacy);
+	} catch {
+		return;
+	}
+	await rename(legacy, next);
+}
+function pgliteDir(workspacePath) {
+	return join(novelRoot(workspacePath), "pglite");
+}
+function metaPath(workspacePath) {
+	return join(novelRoot(workspacePath), META_FILE);
+}
+/** Return whether a workspace directory has been provisioned as a novel. */
+async function isNovelWorkspace(workspacePath) {
+	await migrateLegacyNovelDir(workspacePath);
+	try {
+		const raw = await readFile(metaPath(workspacePath), "utf8");
+		return JSON.parse(raw).version === 1;
+	} catch {
+		return false;
+	}
+}
+const connections = /* @__PURE__ */ new Map();
+async function openDb(workspacePath) {
+	await migrateLegacyNovelDir(workspacePath);
+	const existing = connections.get(workspacePath);
+	if (existing !== void 0) return existing;
+	const pending = (async () => {
+		const db = await PGlite.create(pgliteDir(workspacePath));
+		await initNovelSchema(db);
+		return db;
+	})();
+	connections.set(workspacePath, pending);
+	try {
+		return await pending;
+	} catch (cause) {
+		connections.delete(workspacePath);
+		throw cause;
+	}
+}
+/** Initialize `.dsh-novel` + PGlite + default novel row for one workspace directory. */
+async function provisionNovelWorkspace(workspacePath, input = {}) {
+	await migrateLegacyNovelDir(workspacePath);
+	if (await isNovelWorkspace(workspacePath)) {
+		const novel = await getNovel(workspacePath);
+		return {
+			meta: JSON.parse(await readFile(metaPath(workspacePath), "utf8")),
+			novel,
+			alreadyInitialized: true
+		};
+	}
+	const novelId = randomUUID().replace(/-/g, "").slice(0, 8);
+	const title = input.title?.trim() || basename(workspacePath);
+	const category = normalizeTemplatePresetCategory(input.category);
+	const meta = {
+		version: 1,
+		novelId,
+		createdAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	await mkdir(pgliteDir(workspacePath), { recursive: true });
+	await writeFile(metaPath(workspacePath), `${JSON.stringify(meta, null, 2)}\n`);
+	const db = await openDb(workspacePath);
+	await seedWritingStyleBuiltins(db);
+	const writingStyleId = input.writingStyleId?.trim() || null;
+	const template = (() => {
+		try {
+			return loadRecommendedTemplate(category);
+		} catch {
+			return DEFAULT_FORM_TEMPLATE;
+		}
+	})();
+	await db.query(`INSERT INTO novels (id, title, category, writing_style_id) VALUES ($1, $2, $3, $4)`, [
+		novelId,
+		title,
+		category,
+		writingStyleId
+	]);
+	await db.query(`INSERT INTO form_templates (id, novel_id, config) VALUES ($1, $2, $3::jsonb)`, [
+		randomUUID(),
+		novelId,
+		JSON.stringify(template)
+	]);
+	await seedNovelSkills(db, category);
+	return {
+		meta,
+		novel: await getNovel(workspacePath),
+		alreadyInitialized: false
+	};
+}
+/** Load the singleton novel row. */
+async function getNovel(workspacePath) {
+	const { rows } = await (await openDb(workspacePath)).query(`SELECT * FROM novels LIMIT 1`);
+	const row = rows[0];
+	if (row === void 0) throw new Error("novel row missing; re-provision this workspace");
+	return row;
+}
+/** Patch novel metadata / blueprint. */
+async function updateNovel(workspacePath, patch) {
+	const current = await getNovel(workspacePath);
+	const next = {
+		...current,
+		...patch,
+		updated_at: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	await (await openDb(workspacePath)).query(`UPDATE novels SET
+      title = $1, description = $2, cover = $3, category = $4, writing_style_id = $5,
+      blueprint_json = $6::jsonb, outline_draft_md = $7, outline_final_md = $8,
+      outline_status = $9, updated_at = NOW()
+     WHERE id = $10`, [
+		next.title,
+		next.description,
+		next.cover,
+		next.category,
+		next.writing_style_id,
+		JSON.stringify(next.blueprint_json ?? {}),
+		next.outline_draft_md,
+		next.outline_final_md,
+		next.outline_status,
+		current.id
+	]);
+	return getNovel(workspacePath);
+}
+/** List entities in one domain. */
+async function listEntities(workspacePath, domain) {
+	const { rows } = await (await openDb(workspacePath)).query(`SELECT * FROM novel_entities WHERE domain = $1 ORDER BY name NULLS LAST, updated_at DESC`, [domain]);
+	return rows;
+}
+/** Load one entity. */
+async function getEntity(workspacePath, id) {
+	const { rows } = await (await openDb(workspacePath)).query(`SELECT * FROM novel_entities WHERE id = $1`, [id]);
+	return rows[0];
+}
+async function lookupsFor(workspacePath, domain, entityId) {
+	const worldIdByName = /* @__PURE__ */ new Map();
+	const roleIdByRef = /* @__PURE__ */ new Map();
+	const outlineIdByName = /* @__PURE__ */ new Map();
+	const outlineChapterIdByName = /* @__PURE__ */ new Map();
+	if (domain === "world") for (const row of await listEntities(workspacePath, "world")) {
+		if (row.id === entityId) continue;
+		if (typeof row.name === "string" && row.name.length > 0) worldIdByName.set(row.name, row.id);
+	}
+	if (domain === "roleRelation") for (const row of await listEntities(workspacePath, "role")) {
+		roleIdByRef.set(row.id, row.id);
+		if (typeof row.name === "string" && row.name.length > 0) roleIdByRef.set(row.name, row.id);
+	}
+	if (domain === "outline" || domain === "chapter") {
+		const rows = await listEntities(workspacePath, "outline");
+		for (const row of rows) {
+			if (row.id === entityId) continue;
+			if (typeof row.name !== "string" || row.name.length === 0) continue;
+			outlineIdByName.set(row.name, row.id);
+			if (outlineKindOf(asRecord(row.data)) === "chapter_segment") outlineChapterIdByName.set(row.name, row.id);
+		}
+		for (const row of rows) {
+			if (row.id === entityId) continue;
+			if (typeof row.name !== "string" || row.name.length === 0) continue;
+			if (outlineKindOf(asRecord(row.data)) === "volume") outlineIdByName.set(row.name, row.id);
+		}
+	}
+	return {
+		worldIdByName,
+		roleIdByRef,
+		outlineIdByName,
+		outlineChapterIdByName
+	};
+}
+/** Insert or replace an entity. */
+async function upsertEntity(workspacePath, domain, data, id) {
+	if (!isEntityDomain(domain)) throw new Error(`unknown domain ${domain}`);
+	const entityId = id ?? (typeof data.id === "string" && data.id.length > 0 ? data.id : randomUUID());
+	const normalized = normalizeEntityPayload(domain, data, await lookupsFor(workspacePath, domain, entityId));
+	const name = typeof normalized.name === "string" ? normalized.name : typeof normalized.title === "string" ? normalized.title : levelNameOf(normalized) ?? null;
+	await (await openDb(workspacePath)).query(`INSERT INTO novel_entities (domain, id, name, data)
+     VALUES ($1, $2, $3, $4::jsonb)
+     ON CONFLICT (id) DO UPDATE SET
+       domain = EXCLUDED.domain,
+       name = EXCLUDED.name,
+       data = EXCLUDED.data,
+       updated_at = NOW()`, [
+		domain,
+		entityId,
+		name,
+		JSON.stringify({
+			...normalized,
+			id: entityId
+		})
+	]);
+	const row = await getEntity(workspacePath, entityId);
+	if (row === void 0) throw new Error("entity upsert failed");
+	return row;
+}
+/** Delete one entity. */
+async function deleteEntity(workspacePath, id) {
+	const { rows } = await (await openDb(workspacePath)).query(`DELETE FROM novel_entities WHERE id = $1 RETURNING id`, [id]);
+	return rows.length > 0;
+}
+/** Form template JSON for the workspace novel. */
+async function getTemplate(workspacePath) {
+	const { rows } = await (await openDb(workspacePath)).query(`SELECT config FROM form_templates LIMIT 1`);
+	return rows[0]?.config ?? DEFAULT_FORM_TEMPLATE;
+}
+/** Replace the form template. */
+async function saveTemplate(workspacePath, config) {
+	const novel = await getNovel(workspacePath);
+	await (await openDb(workspacePath)).query(`INSERT INTO form_templates (id, novel_id, config) VALUES ($1, $2, $3::jsonb)
+     ON CONFLICT (novel_id) DO UPDATE SET config = EXCLUDED.config, updated_at = NOW()`, [
+		randomUUID(),
+		novel.id,
+		JSON.stringify(config)
+	]);
+	return getTemplate(workspacePath);
+}
+/** List writing skills. */
+async function listSkills(workspacePath) {
+	const { rows } = await (await openDb(workspacePath)).query(`SELECT * FROM novel_skills
+     WHERE folder <> '题材' AND folder NOT LIKE '题材/%'
+     ORDER BY folder, title`);
+	return rows;
+}
+/** Create or update a skill. */
+async function upsertSkill(workspacePath, skill) {
+	const id = skill.id ?? randomUUID();
+	const folder = skill.folder ?? SECTION_TO_FOLDER[skill.section] ?? "其他";
+	const db = await openDb(workspacePath);
+	await db.query(`INSERT INTO novel_skills (id, section, folder, agent_kind, title, body)
+     VALUES ($1, $2, $3, $4, $5, $6)
+     ON CONFLICT (id) DO UPDATE SET
+       section = EXCLUDED.section,
+       folder = EXCLUDED.folder,
+       agent_kind = EXCLUDED.agent_kind,
+       title = EXCLUDED.title,
+       body = EXCLUDED.body,
+       updated_at = NOW()`, [
+		id,
+		skill.section,
+		folder,
+		skill.agentKind ?? "write",
+		skill.title,
+		skill.body
+	]);
+	const { rows } = await db.query(`SELECT * FROM novel_skills WHERE id = $1`, [id]);
+	const row = rows[0];
+	if (row === void 0) throw new Error("skill upsert failed");
+	return row;
+}
+/** Delete a skill. */
+async function deleteSkill(workspacePath, id) {
+	const { rows } = await (await openDb(workspacePath)).query(`DELETE FROM novel_skills WHERE id = $1 RETURNING id`, [id]);
+	return rows.length > 0;
+}
+/** Static write contract for tools. Book-specific field keys still come from get_template. */
+function describeSchema() {
+	return {
+		domains: ENTITY_DOMAINS,
+		notes: "One DSH workspace is one novel. overview lives on novels.blueprint_json. Call get_template for this book's field keys, then write those keys at the top level (not nested under profile).",
+		write: {
+			overview: "update_novel blueprint_json; keys from get_template overview.fields (genre, tone, coreConflict, …).",
+			world: "name, kind, parentId or parentName (resolved to parentId), geography/culture/history/factions at top level.",
+			role: "name plus get_template role.detailFields keys at top level; faction must match an existing world name.",
+			roleRelation: "one directed edge: roleId/targetRoleId or from/to names, relationType, content. UI shows the edge on both people; do not duplicate a reverse row.",
+			level: "system.name and system.levels[] (name, promotionCondition, abilities, subLevels). Entity name = system.name.",
+			item: "name plus get_template item.detailFields keys at top level.",
+			creature: "name plus get_template creature.detailFields keys at top level.",
+			timeline: "title, content, timeLabel, timePoint, eventType; optional isResolved / relatedChapterNo.",
+			outline: "identity: ordinal + name (UI shows 第N卷/章 + name). Volume = no parent; chapter = parentId or parentName. Optional theme/conflict/majorEvents/content at top level (or extra, which is hoisted). Do not put 第N卷/章 into name. No volumeNo/chapterNo.",
+			chapter: "identity: ordinal + name (UI shows 第N章 + name; chapterNo is an alias for ordinal). Optional content (body) and relatedOutlineId or relatedOutlineName."
+		}
+	};
+}
+async function listWorkspaceWritingStyles(workspacePath) {
+	const db = await openDb(workspacePath);
+	await seedWritingStyleBuiltins(db);
+	return listWritingStyles(db);
+}
+//#endregion
+//#region src/novel/http.ts
+function finish(res, status, body) {
+	res.statusCode = status;
+	if (body === void 0) {
+		res.end();
+		return;
+	}
+	res.setHeader("content-type", "application/json; charset=utf-8");
+	res.end(JSON.stringify(body));
+}
+async function readJson(req) {
+	const chunks = [];
+	for await (const chunk of req) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+	if (chunks.length === 0) return {};
+	return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+}
+function pathOf(req) {
+	const url = new URL(req.url ?? "/", "http://127.0.0.1");
+	return {
+		pathname: url.pathname,
+		search: url.searchParams
+	};
+}
+function requirePath(value) {
+	if (typeof value !== "string" || value.length === 0) throw new Error("path is required");
+	return value;
+}
+/** Same-origin JSON API for the novel client and tools. */
+async function handleNovelApi(req, res, expectedOrigin) {
+	if (req.headers.origin !== void 0 && req.headers.origin !== expectedOrigin) {
+		finish(res, 403);
+		return;
+	}
+	try {
+		const { pathname, search } = pathOf(req);
+		const method = req.method ?? "GET";
+		const rel = pathname.slice(14) || "/";
+		if (method === "GET" && rel === "/status") {
+			finish(res, 200, { novel: await isNovelWorkspace(requirePath(search.get("path"))) });
+			return;
+		}
+		if (method === "POST" && rel === "/provision") {
+			const body = await readJson(req);
+			finish(res, 200, await provisionNovelWorkspace(requirePath(body.path), {
+				title: typeof body.title === "string" ? body.title : void 0,
+				category: typeof body.category === "string" ? body.category : void 0,
+				writingStyleId: typeof body.writingStyleId === "string" ? body.writingStyleId : void 0
+			}));
+			return;
+		}
+		if (method === "GET" && rel === "/schema") {
+			finish(res, 200, describeSchema());
+			return;
+		}
+		if (method === "GET" && rel === "/novel") {
+			finish(res, 200, await getNovel(requirePath(search.get("path"))));
+			return;
+		}
+		if (method === "PATCH" && rel === "/novel") {
+			const body = await readJson(req);
+			finish(res, 200, await updateNovel(requirePath(body.path), {
+				...typeof body.title === "string" ? { title: body.title } : {},
+				...typeof body.description === "string" ? { description: body.description } : {},
+				...typeof body.cover === "string" ? { cover: body.cover } : {},
+				...typeof body.category === "string" ? { category: body.category } : {},
+				...body.writing_style_id === null || typeof body.writing_style_id === "string" ? { writing_style_id: body.writing_style_id } : {},
+				...body.blueprint_json !== void 0 ? { blueprint_json: body.blueprint_json } : {},
+				...typeof body.outline_draft_md === "string" ? { outline_draft_md: body.outline_draft_md } : {},
+				...typeof body.outline_final_md === "string" ? { outline_final_md: body.outline_final_md } : {},
+				...typeof body.outline_status === "string" ? { outline_status: body.outline_status } : {}
+			}));
+			return;
+		}
+		if (method === "GET" && rel === "/entities") {
+			const workspacePath = requirePath(search.get("path"));
+			const domain = search.get("domain") ?? "";
+			const id = search.get("id");
+			if (id !== null) {
+				finish(res, 200, await getEntity(workspacePath, id) ?? null);
+				return;
+			}
+			if (!isEntityDomain(domain)) {
+				finish(res, 400, { error: `unknown domain; expected one of ${ENTITY_DOMAINS.join(", ")}` });
+				return;
+			}
+			finish(res, 200, await listEntities(workspacePath, domain));
+			return;
+		}
+		if ((method === "POST" || method === "PATCH") && rel === "/entities") {
+			const body = await readJson(req);
+			const workspacePath = requirePath(body.path);
+			const domain = String(body.domain ?? "");
+			if (!isEntityDomain(domain)) throw new Error("unknown domain");
+			finish(res, 200, await upsertEntity(workspacePath, domain, body.data ?? {}, typeof body.id === "string" ? body.id : void 0));
+			return;
+		}
+		if (method === "DELETE" && rel === "/entities") {
+			const body = await readJson(req);
+			finish(res, 200, { deleted: await deleteEntity(requirePath(body.path), String(body.id ?? "")) });
+			return;
+		}
+		if (method === "GET" && rel === "/template") {
+			finish(res, 200, await getTemplate(requirePath(search.get("path"))));
+			return;
+		}
+		if (method === "PUT" && rel === "/template") {
+			const body = await readJson(req);
+			finish(res, 200, await saveTemplate(requirePath(body.path), body.config));
+			return;
+		}
+		if (method === "GET" && rel === "/style-presets") {
+			finish(res, 200, listBuiltinWritingStylePresets());
+			return;
+		}
+		if (method === "GET" && rel === "/styles") {
+			finish(res, 200, await listWorkspaceWritingStyles(requirePath(search.get("path"))));
+			return;
+		}
+		if (method === "GET" && rel === "/skills") {
+			finish(res, 200, await listSkills(requirePath(search.get("path"))));
+			return;
+		}
+		if ((method === "POST" || method === "PATCH") && rel === "/skills") {
+			const body = await readJson(req);
+			finish(res, 200, await upsertSkill(requirePath(body.path), {
+				id: typeof body.id === "string" ? body.id : void 0,
+				section: String(body.section ?? "overview"),
+				folder: typeof body.folder === "string" ? body.folder : void 0,
+				agentKind: typeof body.agentKind === "string" ? body.agentKind : void 0,
+				title: String(body.title ?? ""),
+				body: String(body.body ?? "")
+			}));
+			return;
+		}
+		if (method === "DELETE" && rel === "/skills") {
+			const body = await readJson(req);
+			finish(res, 200, { deleted: await deleteSkill(requirePath(body.path), String(body.id ?? "")) });
+			return;
+		}
+		finish(res, 404, { error: "not found" });
+	} catch (cause) {
+		finish(res, 400, { error: cause instanceof Error ? cause.message : String(cause) });
+	}
+}
+//#endregion
+//#region src/novel/host-skills.ts
+const NOVEL_CREATE_SKILL_NAME = "novel-create";
+const MODULE_SKILL_SPECS = [
+	{
+		name: "novel-overview",
+		root: "概述",
+		description: "概述与开书：标题、卖点、种子。"
+	},
+	{
+		name: "novel-world",
+		root: "世界",
+		description: "世界规则、势力与伏笔。"
+	},
+	{
+		name: "novel-role",
+		root: "人物",
+		description: "人物档案、塑造与关系。"
+	},
+	{
+		name: "novel-creature",
+		root: "生物",
+		description: "生物与灵植档案。"
+	},
+	{
+		name: "novel-item",
+		root: "物品",
+		description: "物品档案与归属。"
+	},
+	{
+		name: "novel-level",
+		root: "等级",
+		description: "等级、能力与代价。"
+	},
+	{
+		name: "novel-timeline",
+		root: "时间线",
+		description: "事件轴与状态同步。"
+	},
+	{
+		name: "novel-outline",
+		root: "大纲",
+		description: "大纲结构与剧情骨架。"
+	},
+	{
+		name: "novel-chapter",
+		root: "章节",
+		description: "章节节奏、对话与质检。"
+	},
+	{
+		name: "novel-review",
+		root: "审查",
+		description: "大纲与章节审查。"
+	}
+];
+const PROVIDER = "dsh-novel";
+const NOVEL_CREATE_CONTENT = [
+	"# 创建小说工作区",
+	"",
+	"对当前会话工作区目录调用工具 `novel_create`（可选 `title`、`category`）。",
+	"该工具会写入 `.dsh-novel`、建 PGlite、播种模板与技能。",
+	"若已经是小说工作区，工具返回 `alreadyInitialized: true`：告知用户已忽略，**不要**改书名或题材。",
+	"",
+	"然后只做开书设定（不要写大纲或章节）：",
+	"1. 先 `get_template`，按返回的字段 **顶层 key** 写入（不要包在 `profile` 里）。",
+	"2. 加载 `novel-overview`，以及按用户素材选用 `novel-world` / `novel-role` / `novel-level` / `novel-item` / `novel-timeline`。",
+	"3. 写入概述 blueprint、世界树（先父后子，子节点用 `parentName`）、人物顶层字段、`roleRelation`、等级 `system`。",
+	"4. 按素材写入全书 `timeline` 关键事件：`title` + `content` + `timeLabel` + `timePoint` + `eventType`。伏笔/冲突/悬念必须带 `eventType`（`foreshadow` / `conflict` / `suspense`）和 `isResolved`（开书多为 `false`）。",
+	"5. **禁止**加载 `novel-outline` / `novel-chapter`，禁止 mutate `outline` 或 `chapter`。",
+	"6. 设定写完即停，告诉用户：大纲用 `/novel-outline`，章节用 `/novel-chapter`。"
+].join("\n");
+function moduleSkillInvocation(name) {
+	return {
+		modelInvocable: true,
+		userInvocable: name === "novel-outline" || name === "novel-chapter"
+	};
+}
+/** Filter DB skill rows that belong to one DSH module skill. */
+function rowsForModule(rows, name) {
+	return rows.filter((row) => folderMatchesModule(row.folder, name));
+}
+/** Module skills that currently have at least one row. */
+function moduleSkillsFromRows(rows) {
+	return MODULE_SKILL_SPECS.filter((spec) => rowsForModule(rows, spec.name).length > 0).map((spec) => spec.name);
+}
+function composeModuleSkillBody(rows, name) {
+	return rowsForModule(rows, name).map((row) => `## ${row.title}\n\n${row.body}`).join("\n\n");
+}
+function folderMatchesModule(folder, name) {
+	if (name === "novel-review") return isReviewFolder(folder);
+	const spec = MODULE_SKILL_SPECS.find((item) => item.name === name);
+	if (spec === void 0) return false;
+	if (isReviewFolder(folder)) return false;
+	return folder === spec.root || folder.startsWith(`${spec.root}/`);
+}
+function isReviewFolder(folder) {
+	return folder === "审查" || folder.startsWith("审查/") || /\/审查(?:\/|$)/u.test(folder);
+}
+/** Register /novel-create and cwd-scoped module skills from the novel database. */
+function registerNovelSkills(ctx) {
+	ctx.effect(() => ctx.skills.register({
+		name: NOVEL_CREATE_SKILL_NAME,
+		description: "把当前工作区初始化为小说工作区（已初始化则忽略）。",
+		whenToUse: "用户要开新书、初始化小说目录，或输入 /novel-create。",
+		source: "bundled",
+		content: NOVEL_CREATE_CONTENT,
+		invocation: {
+			modelInvocable: true,
+			userInvocable: true
+		}
+	}), "dsh-plugin-novel: novel-create skill");
+	ctx.effect(() => ctx.skills.registerProvider(() => ({
+		name: PROVIDER,
+		async list(options) {
+			return moduleSkillsFromRows(await loadRows(options.cwd)).map((name) => candidateOf(name));
+		},
+		async get(candidate, options) {
+			const name = asModuleName(candidate.locator);
+			if (name === void 0) return void 0;
+			const content = composeModuleSkillBody(await loadRows(options.cwd), name);
+			if (content.length === 0) return void 0;
+			return definitionOf(name, content);
+		}
+	})), "dsh-plugin-novel: module skill provider");
+}
+async function loadRows(cwd) {
+	if (typeof cwd === "string" && cwd.length > 0 && await isNovelWorkspace(cwd)) return listSkills(cwd);
+	return listSeedSkillRows().map((row) => ({
+		id: `seed:${row.folder}/${row.title}`,
+		section: row.section,
+		folder: row.folder,
+		agent_kind: row.agent_kind,
+		title: row.title,
+		body: row.body,
+		created_at: "",
+		updated_at: ""
+	}));
+}
+function asModuleName(locator) {
+	if (typeof locator !== "string") return void 0;
+	return MODULE_SKILL_SPECS.some((spec) => spec.name === locator) ? locator : void 0;
+}
+function candidateOf(name) {
+	const spec = MODULE_SKILL_SPECS.find((item) => item.name === name);
+	return {
+		name: spec.name,
+		description: spec.description,
+		invocation: moduleSkillInvocation(name),
+		source: "bundled",
+		provider: PROVIDER,
+		rank: BUNDLED_SKILL_RANK,
+		locator: spec.name
+	};
+}
+function definitionOf(name, content) {
+	const spec = MODULE_SKILL_SPECS.find((item) => item.name === name);
+	return {
+		name: spec.name,
+		description: spec.description,
+		invocation: moduleSkillInvocation(name),
+		source: "bundled",
+		provider: PROVIDER,
+		content
+	};
+}
+//#endregion
+//#region src/novel/tools.ts
+function jsonText(value) {
+	return JSON.stringify(value, null, 2);
+}
+function asJson(value) {
+	return JSON.parse(JSON.stringify(value));
+}
+function workspaceFrom(args, exec) {
+	const path = args.workspace_path ?? exec.agent?.cwd ?? exec.agent?.session?.header?.cwd;
+	if (typeof path !== "string" || path.length === 0) throw new Error("workspace_path is required (or the session must have a cwd)");
+	return path;
+}
+function jsonOutput() {
+	return {
+		schema: { type: "json" },
+		render: (_args, value) => [{
+			type: "text",
+			text: jsonText(value)
+		}]
+	};
+}
+/** Register novel CRUD tools, DSH skills, and a system-prompt context dump. */
+function registerNovelHost(ctx) {
+	registerNovelSkills(ctx);
+	ctx.tools.register(defineTool({
+		name: "novel_status",
+		description: "Check whether the current workspace is a novel workspace (.dsh-novel).",
+		parameters: { workspace_path: {
+			type: "string",
+			description: "Workspace directory; defaults to session cwd"
+		} },
+		output: jsonOutput(),
+		async execute(args, exec) {
+			const path = workspaceFrom(args, exec);
+			return asJson({
+				path,
+				novel: await isNovelWorkspace(path)
+			});
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "novel_create",
+		description: "Initialize the current directory as a novel workspace. If it already is one, returns alreadyInitialized and does not change title or category.",
+		parameters: {
+			workspace_path: {
+				type: "string",
+				description: "Workspace directory; defaults to session cwd"
+			},
+			title: {
+				type: "string",
+				description: "Novel title"
+			},
+			category: {
+				type: "string",
+				description: "Genre such as 玄幻"
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			const path = workspaceFrom(args, exec);
+			const result = await provisionNovelWorkspace(path, {
+				title: args.title,
+				category: args.category
+			});
+			if (!result.alreadyInitialized) {
+				const registry = ctx.get("workspaceRegistry");
+				try {
+					await registry?.create?.(path, result.novel.title);
+				} catch {}
+			}
+			return asJson(result);
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "get_novel",
+		description: "Read the current novel metadata and blueprint (overview).",
+		parameters: { workspace_path: { type: "string" } },
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson(await getNovel(workspaceFrom(args, exec)));
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "update_novel",
+		description: "Update novel title, category, description, or blueprint_json overview.",
+		parameters: {
+			workspace_path: { type: "string" },
+			title: { type: "string" },
+			category: { type: "string" },
+			description: { type: "string" },
+			blueprint_json: {
+				type: "string",
+				description: "JSON object string for the overview blueprint"
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			const path = workspaceFrom(args, exec);
+			const patch = {};
+			if (args.title !== void 0) patch.title = args.title;
+			if (args.category !== void 0) patch.category = args.category;
+			if (args.description !== void 0) patch.description = args.description;
+			if (args.blueprint_json !== void 0) patch.blueprint_json = JSON.parse(args.blueprint_json);
+			return asJson(await updateNovel(path, patch));
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "describe_schema",
+		description: "Describe novel entity domains available in this workspace.",
+		parameters: {},
+		output: jsonOutput(),
+		async execute() {
+			return asJson(describeSchema());
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "query_entities",
+		description: `List entities in a domain (${ENTITY_DOMAINS.join(", ")}).`,
+		parameters: {
+			workspace_path: { type: "string" },
+			domain: {
+				type: "string",
+				required: true
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			const domain = args.domain;
+			if (!isEntityDomain(domain)) throw new Error(`unknown domain ${domain}`);
+			return asJson({ items: await listEntities(workspaceFrom(args, exec), domain) });
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "get_entities",
+		description: "Load one entity by id.",
+		parameters: {
+			workspace_path: { type: "string" },
+			id: {
+				type: "string",
+				required: true
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson(await getEntity(workspaceFrom(args, exec), args.id) ?? { missing: true });
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "mutate_entities",
+		description: "Create or update an entity. Pass domain and a JSON object string as data.",
+		parameters: {
+			workspace_path: { type: "string" },
+			domain: {
+				type: "string",
+				required: true
+			},
+			data: {
+				type: "string",
+				required: true,
+				description: "JSON object, typically including name"
+			},
+			id: { type: "string" }
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			if (!isEntityDomain(args.domain)) throw new Error(`unknown domain ${args.domain}`);
+			const data = JSON.parse(args.data);
+			return asJson(await upsertEntity(workspaceFrom(args, exec), args.domain, data, args.id));
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "delete_entity",
+		description: "Delete one entity by id.",
+		parameters: {
+			workspace_path: { type: "string" },
+			id: {
+				type: "string",
+				required: true
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson({ deleted: await deleteEntity(workspaceFrom(args, exec), args.id) });
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "skill_list",
+		description: "List writing/review skills for the current novel (per-file rows in the database).",
+		parameters: { workspace_path: { type: "string" } },
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson({ items: await listSkills(workspaceFrom(args, exec)) });
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "upsert_skill",
+		description: "Create or update one skill row in this novel. Changes the book skill table; do not overwrite the whole catalog without asking.",
+		parameters: {
+			workspace_path: { type: "string" },
+			id: { type: "string" },
+			section: {
+				type: "string",
+				required: true
+			},
+			folder: {
+				type: "string",
+				description: "Chinese folder path such as 概述"
+			},
+			agentKind: { type: "string" },
+			title: {
+				type: "string",
+				required: true
+			},
+			body: {
+				type: "string",
+				required: true
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson(await upsertSkill(workspaceFrom(args, exec), {
+				id: args.id,
+				section: args.section,
+				folder: args.folder,
+				agentKind: args.agentKind,
+				title: args.title,
+				body: args.body
+			}));
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "delete_skill",
+		description: "Delete one skill row by id. Destructive; confirm with the user first.",
+		parameters: {
+			workspace_path: { type: "string" },
+			id: {
+				type: "string",
+				required: true
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson({ deleted: await deleteSkill(workspaceFrom(args, exec), args.id) });
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "get_template",
+		description: "Read the form template JSON used to render field labels for this novel.",
+		parameters: { workspace_path: { type: "string" } },
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson(await getTemplate(workspaceFrom(args, exec)));
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "save_template",
+		description: "Replace the entire form template JSON for this novel. Destructive; do not overwrite the whole template without asking.",
+		parameters: {
+			workspace_path: { type: "string" },
+			config: {
+				type: "string",
+				required: true,
+				description: "JSON object string for form_templates.config"
+			}
+		},
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson(await saveTemplate(workspaceFrom(args, exec), JSON.parse(args.config)));
+		}
+	}));
+	ctx.tools.register(defineTool({
+		name: "list_writing_styles",
+		description: "List writing styles available in this novel workspace.",
+		parameters: { workspace_path: { type: "string" } },
+		output: jsonOutput(),
+		async execute(args, exec) {
+			return asJson({ items: await listWorkspaceWritingStyles(workspaceFrom(args, exec)) });
+		}
+	}));
+	ctx.effect(() => ctx.systemPrompt.section({
+		name: "novel-authoring",
+		order: 80,
+		text: [
+			"You are helping write a novel bound to the current DSH workspace.",
+			"One workspace directory is one novel, stored in `.dsh-novel/pglite`.",
+			"To create a novel workspace and write setting (overview/world/roles/levels), use /novel-create. Do not write outline or chapters in that command.",
+			"To write the outline, the user must invoke /novel-outline. To write chapters, /novel-chapter.",
+			"Before writing a section, load the matching skill novel-overview, novel-world, novel-role, novel-creature, novel-item, novel-level, novel-timeline, novel-outline, novel-chapter, or novel-review; or call skill_list for a single file.",
+			"Call get_template and write template keys at the top level of mutate_entities data (not nested under profile). World children use parentName; relations use from/to names or roleId/targetRoleId.",
+			"Use get_novel, query_entities, mutate_entities, and update_novel to read and write canon.",
+			"Prefer existing names; do not invent duplicate characters."
+		].join("\n")
+	}), "dsh-plugin-novel: system prompt section");
+	ctx.effect(() => ctx.systemPrompt.context({
+		name: "novel-snapshot",
+		order: 80,
+		text: () => "Novel data is in the workspace `.dsh-novel` database. Call get_novel and query_entities before writing."
+	}), "dsh-plugin-novel: system prompt context");
+}
+//#endregion
+//#region src/index.ts
+const name = "novel";
+const inject = [
+	"webServer",
+	"tools",
+	"systemPrompt",
+	"skills"
+];
+function apply(ctx) {
+	const rendererOrigin = `http://${ctx.webServer.host}:${String(ctx.webServer.port)}`;
+	ctx.effect(() => ctx.webServer.register({
+		kind: "prefix",
+		path: NOVEL_API_PREFIX,
+		handler: (req, res) => {
+			handleNovelApi(req, res, rendererOrigin);
+		}
+	}), "dsh-novel: JSON API");
+	registerNovelHost(ctx);
+}
+//#endregion
+export { apply, inject, name };
+
+//# sourceMappingURL=index.js.map