dsh-openwrite 0.2.24 → 0.2.26

package/packages/openwrite-bridge/lib/index.js

@@ -17,6 +17,7 @@ export const Config = Schema.object({
     runtimeRoot: Schema.string(),
     artifacts: Schema.string(),
     baseUrl: Schema.string().default('http://127.0.0.1:4567'),
+    authToken: Schema.string().role('secret'),
     timeoutMs: Schema.number().default(600000),
     outputDir: Schema.string().default(join(tmpdir(), 'openwrite-exports')),
 });
@@ -38,7 +39,8 @@ export function apply(ctx, config) {
         return connection ? connection.requestRejection({ headers }) : 503;
     };
     const domain = new NovelDomainService(ctx, { authorizeRequest, baseUrl: config.baseUrl, timeoutMs: config.timeoutMs, outputDir: config.outputDir, resolveWorkspace,
-        ...(runtime ? { connect: () => runtime.ensure() } : {}),
+        ...(runtime ? { connect: () => runtime.ensure() }
+            : config.authToken ? { connect: async () => ({ baseUrl: config.baseUrl, token: config.authToken }) } : {}),
     });
     ctx.effect(() => () => runtime?.dispose(), 'openwrite: owned runtime cleanup');
     ctx.inject(['webServer'], webCtx => webCtx.effect(() => webCtx.webServer.register({

package/packages/openwrite-bridge/lib/managed-runtime.d.ts

@@ -40,6 +40,12 @@ export interface BackendConnection {
     baseUrl: string;
     token?: string;
 }
+export declare class UnsupportedRuntimePlatformError extends Error {
+    readonly platform: string;
+    readonly code = "RUNTIME_PLATFORM_UNSUPPORTED";
+    readonly status = 503;
+    constructor(platform: string);
+}
 export type SpawnFn = (command: string, args: readonly string[], options: SpawnOptions) => ChildProcess;
 export interface RuntimeOptions {
     spawn?: SpawnFn;

package/packages/openwrite-bridge/lib/managed-runtime.js

@@ -8,6 +8,16 @@ import { createInterface } from 'node:readline';
 import { x as untar } from 'tar';
 import { unzipSync } from 'fflate';
 import { lock as acquireLock } from 'proper-lockfile';
+export class UnsupportedRuntimePlatformError extends Error {
+    platform;
+    code = 'RUNTIME_PLATFORM_UNSUPPORTED';
+    status = 503;
+    constructor(platform) {
+        super(`OpenWrite Studio managed runtime is unavailable on ${platform}. Configure the bridge with mode: external and baseUrl pointing to a supported Studio server; see docs/INSTALL.md#external-studio. File tools that do not require Studio remain available.`);
+        this.platform = platform;
+        this.name = 'UnsupportedRuntimePlatformError';
+    }
+}
 export const DEFAULT_RESTART_LIMIT = 5;
 export const DEFAULT_BACKOFF_MS = [1_000, 2_000, 4_000, 8_000, 16_000];
 /** Budget for the per-request liveness probe of a previously-ready backend. */
@@ -538,7 +548,7 @@ export class ManagedRuntime {
         const manifest = JSON.parse(await readFile(join(this.artifacts, 'runtime-manifest.json'), 'utf8'));
         const platform = manifest.platforms[`${process.platform}-${process.arch}`];
         if (!platform)
-            throw new Error(`Unsupported platform: ${process.platform}/${process.arch}`);
+            throw new UnsupportedRuntimePlatformError(`${process.platform}/${process.arch}`);
         if (!manifest.wheel || !manifest.requirements)
             throw new Error('The package is missing Core or dependency checksums');
         const wheel = join(this.artifacts, manifest.wheel.file);

package/packages/openwrite-bridge/lib/tool-policy.js

@@ -6,6 +6,7 @@ const reads = new Set([
     'novel_revision_get', 'novel_tasks_list', 'novel_continuity', 'novel_diagnostics',
     'novel_research_status', 'novel_research_report', 'novel_model_profiles',
     'novel_manuscript_acceptance', 'novel_export_preflight',
+    'novel_manuscript_metrics', 'novel_outline_audit',
 ]);
 const generates = new Set([
     'novel_write_chapter', 'novel_review_chapter', 'novel_multi_write', 'novel_task_create',
@@ -14,6 +15,7 @@ const generates = new Set([
     'novel_model_test', 'novel_model_embedding_test',
 ]);
 const readActions = {
+    novel_writing_assets: ['get'],
     novel_model_benchmark: ['list', 'get', 'options'],
     novel_chapter_run_action: ['list', 'get'],
     novel_rolling_plan_action: ['list', 'get'],

package/packages/openwrite-bridge/lib/tools.js

@@ -178,6 +178,11 @@ function resolveReviewPath(args) {
 function objectValue(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
 }
+function requireRecord(value, name) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`${name} must be a JSON object`);
+    return value;
+}
 async function deliveryForResponse(client, response, chapterId, signal, threshold) {
     const embedded = objectValue(response)['workspace'];
     const workspace = embedded !== null && typeof embedded === 'object' && !Array.isArray(embedded)
@@ -345,16 +350,17 @@ export function registerNovelTools(ctx, clientFactory, options) {
     }));
     ctx.tools.register(defineTool({
         name: 'novel_context_preview',
-        description: 'Preview the context packet OpenWrite would assemble for writing a chapter (relevant outline, assets, foreshadowing, and prior-chapter memory).',
+        description: 'Preview the context packet OpenWrite would assemble for writing a chapter (relevant outline, assets, foreshadowing, and prior-chapter memory). Set include_agent_payload to inspect canonical writer inputs and document inclusion without calling a model.',
         parameters: {
             chapter: { type: 'string', description: 'Chapter id (e.g. "ch_0007"); omit or pass "next" for the next chapter to write.' },
+            include_agent_payload: { type: 'boolean', description: 'Include the full writer payload, rendered initial messages and document inventory. Later segment/retry messages depend on the write request.' },
         },
         output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
         timeoutMs,
         isConcurrencySafe: () => true,
         async execute(args, exec) {
             const client = clientFor(exec);
-            return await client.getJson('/api/context', { chapter: args.chapter?.trim() || 'next' }, exec.signal);
+            return await client.getJson('/api/context', { chapter: args.chapter?.trim() || 'next', ...(args.include_agent_payload ? { include_agent_payload: 'true' } : {}) }, exec.signal);
         },
     }));
     ctx.tools.register(defineTool({
@@ -798,6 +804,7 @@ export function registerNovelTools(ctx, clientFactory, options) {
             data: { type: 'json', description: 'Object of asset fields to merge (e.g. name, summary, aliases).' },
             body_markdown: { type: 'string', description: 'Replacement markdown body (character/world assets).' },
             raw_text: { type: 'string', description: 'Full replacement document text, validated by the server.' },
+            related_mode: { type: 'string', enum: ['merge', 'replace'], description: 'Preserve and merge existing related entries by default; replace explicitly clears or replaces relations.' },
         },
         output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
         timeoutMs,
@@ -810,6 +817,8 @@ export function registerNovelTools(ctx, clientFactory, options) {
                 body['body_markdown'] = args.body_markdown;
             if (args.raw_text !== undefined)
                 body['raw_text'] = args.raw_text;
+            if (args.related_mode !== undefined)
+                body['related_mode'] = args.related_mode;
             return await client.postJson('/api/assets/update', body, exec.signal);
         },
     }));
@@ -883,7 +892,7 @@ export function registerNovelTools(ctx, clientFactory, options) {
             action: { type: 'string', required: true, enum: ['preview', 'apply', 'reject', 'retry', 'undo'], description: 'Plan lifecycle action.' },
             confirm: { type: 'boolean', description: 'Required true for apply and undo after author acceptance.' },
             path: { type: 'string', description: 'Existing document path for preview, relative to the novel root.' },
-            edits: { type: 'json', description: 'Preview edits: [{old_text,new_text}] or [{start_text,end_text,new_text}].' },
+            edits: { type: 'json', description: 'Preview edits: [{old_text,new_text}] or [{start_text,end_text,new_text,end_inclusive}]. Range end defaults to inclusive for compatibility; end_inclusive:false preserves the end anchor (e.g. the next heading).' },
             preview_token: { type: 'string', description: 'Immutable preview or undo token for apply/reject/retry/undo.' },
         },
         output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
@@ -979,7 +988,7 @@ export function registerNovelTools(ctx, clientFactory, options) {
             'so the downloaded file is bound to the manuscript state that was inspected.',
         parameters: {
             format: { type: 'string', enum: ['md', 'txt', 'epub'], description: 'Export format (default "md").' },
-            purpose: { type: 'string', enum: ['backup', 'delivery'], description: 'Export purpose (default "delivery"). Delivery applies publication gates; backup preserves the current work.' },
+            purpose: { type: 'string', enum: ['backup', 'delivery', 'personal_archive'], description: 'Export purpose (default "delivery"). personal_archive preserves author copies with gate findings recorded as warnings.' },
         },
         output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
         timeoutMs,
@@ -998,7 +1007,7 @@ export function registerNovelTools(ctx, clientFactory, options) {
             'preflight_revision unchanged to bind the download to that inspected manuscript state. Returns the saved file path.',
         parameters: {
             format: { type: 'string', enum: ['md', 'txt', 'epub'], description: 'Export format (default "md").' },
-            purpose: { type: 'string', enum: ['backup', 'delivery'], description: 'Export purpose (default "delivery").' },
+            purpose: { type: 'string', enum: ['backup', 'delivery', 'personal_archive'], description: 'Export purpose (default "delivery").' },
             preflight_revision: { type: 'string', description: 'Revision returned by novel_export_preflight for the same format and purpose.' },
         },
         output: {
@@ -2174,6 +2183,8 @@ export function registerNovelTools(ctx, clientFactory, options) {
             'acknowledge are confirmation-gated by the server.',
         parameters: {
             action: { type: 'string', required: true, enum: ['baseline', 'external', 'resume', 'acknowledge', 'abandon'], description: 'The reconciliation action.' },
+            mode: { type: 'string', enum: ['full', 'fast'], description: 'resume: fast accepts frozen manuscript without calling a model; derived facts remain stale and can be reconciled later.' },
+            no_model: { type: 'boolean', description: 'external: accept manuscript bytes without extracting facts; does not clear the facts guard.' },
             chapter_id: { type: 'string', description: 'Optional chapter id (ch_<digits>); omit for the project-level operation.' },
             operation_id: { type: 'string', description: 'Durable operation id to resume or acknowledge.' },
             domains: { type: 'array', items: { type: 'string' }, description: 'Affected domains to acknowledge or retry; acknowledge defaults to outline and foreshadowing.' },
@@ -2186,7 +2197,7 @@ export function registerNovelTools(ctx, clientFactory, options) {
                 throw new Error(`chapter_id must match ch_<digits>, got "${args.chapter_id}"`);
             }
             const body = {};
-            for (const key of ['chapter_id', 'operation_id', 'domains', 'confirm']) {
+            for (const key of ['chapter_id', 'operation_id', 'domains', 'confirm', 'mode', 'no_model']) {
                 const value = args[key];
                 if (value !== undefined)
                     body[key] = value;
@@ -2197,6 +2208,89 @@ export function registerNovelTools(ctx, clientFactory, options) {
             return await clientFor(exec).postJson(`/api/manuscript/acceptance/${route}`, body, exec.signal);
         },
     }));
+    ctx.tools.register(defineTool({
+        name: 'novel_writing_assets',
+        description: 'Read or save shared project terminology, review_terms toggle, concrete noun lexicon, overlap_threshold and character_groups. Anchors are Markdown files in the novel anchor/ directory. Save requires the revision returned by get. Character groups are optional descriptive material; retain identity and canonical state in character cards.',
+        parameters: {
+            action: { type: 'string', required: true, enum: ['get', 'save', 'save_anchor', 'mark_usage'], description: 'Asset operation.' },
+            assets: { type: 'json', description: 'Object: terms [{term, forbidden?, replacement?, min_occurrences?, example?}], character_groups {name: [{id,text}]}, review_terms?, concrete_nouns?, overlap_threshold?.' },
+            expected_revision: { type: 'string', description: 'Revision from get; empty for a new asset table.' },
+            name: { type: 'string', description: 'save_anchor: simple .md filename.' },
+            content: { type: 'string', description: 'save_anchor: Markdown reference prose.' },
+            chapter_id: { type: 'string', description: 'mark_usage: chapter whose optional character details were used.' },
+            groups: { type: 'json', description: 'mark_usage: character name to group IDs used in this chapter.' },
+        },
+        output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
+        timeoutMs,
+        isConcurrencySafe: args => args.action === 'get',
+        async execute(args, exec) {
+            const client = clientFor(exec);
+            if (args.action === 'get')
+                return await client.getJson('/api/writing-assets', {}, exec.signal);
+            if (args.action === 'save_anchor')
+                return await client.postJson('/api/writing-assets', { action: args.action, name: args.name ?? '', content: args.content ?? '', expected_revision: args.expected_revision ?? '' }, exec.signal);
+            if (args.action === 'mark_usage')
+                return await client.postJson('/api/writing-assets', { action: args.action, chapter_id: args.chapter_id ?? '', groups: requireRecord(args.groups, 'groups') }, exec.signal);
+            const assets = requireRecord(args.assets, 'assets');
+            return await client.postJson('/api/writing-assets', { assets: assets, expected_revision: args.expected_revision ?? '' }, exec.signal);
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'novel_manuscript_metrics',
+        description: 'Read deterministic chapter metrics, terminology findings, overlap against anchors and the previous three chapters, duplicate paragraphs and selected character groups. Overlap spans use Unicode codepoint offsets. No model call.',
+        parameters: { chapter_id: { type: 'string', required: true, description: 'Canonical chapter ID.' } },
+        output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
+        timeoutMs, isConcurrencySafe: () => true,
+        async execute(args, exec) {
+            if (!CHAPTER_ID_PATTERN.test(args.chapter_id))
+                throw new Error('Invalid chapter_id');
+            return await clientFor(exec).getJson(`/api/manuscript/${encodeURIComponent(args.chapter_id)}/metrics`, {}, exec.signal);
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'novel_outline_audit',
+        description: 'Read countable chapter-group facts: budgets/actual words, declared promises and function streaks, declared/confirmed payoffs, overdue hooks and drift ledger. Never generates a score or claims prose fulfilled a promise. No model call.',
+        parameters: {
+            group_id: { type: 'string', description: 'Optional sec_* or arc_* group.' },
+            start: { type: 'string', description: 'Optional first chapter ID.' },
+            end: { type: 'string', description: 'Optional last chapter ID.' },
+        },
+        output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
+        timeoutMs, isConcurrencySafe: () => true,
+        async execute(args, exec) {
+            return await clientFor(exec).getJson('/api/outline/audit', { group_id: args.group_id ?? '', start: args.start ?? '', end: args.end ?? '' }, exec.signal);
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'novel_drift_entry',
+        description: 'Record author-observed chapter drift. Saves an immutable outline/manuscript baseline first. More than two unresolved rewrite drifts in a section freezes generation until explicit reconciliation and replanning.',
+        parameters: {
+            group_id: { type: 'string', required: true, description: 'Section ID sec_*.' },
+            chapter_id: { type: 'string', required: true, description: 'Chapter in this section.' },
+            kind: { type: 'string', required: true, enum: ['growth', 'escape', 'dilution', 'snowball'], description: 'Drift kind.' },
+            impact: { type: 'string', required: true, enum: ['local', 'section', 'arc'], description: 'Impact scope.' },
+            rewrite: { type: 'boolean', description: 'Counts toward rewrite budget; default true.' },
+            note: { type: 'string', required: true, description: 'Observed drift and supporting evidence.' },
+            expected_revision: { type: 'integer', required: true, description: 'ledger.revision from outline audit.' },
+        },
+        output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
+        timeoutMs,
+        async execute(args, exec) {
+            return await clientFor(exec).postJson('/api/arc-reconcile', { ...args, action: 'drift_entry' }, exec.signal);
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'novel_arc_reconcile',
+        description: 'Resolve selected drift entries by absorbing authored outline metadata, scheduling recovery in a later chapter, or freezing. Absorption requires concrete outline_updates and outline_revision; baseline is saved before edits. resume=true explicitly resumes a replanned group within budget. Does not rewrite manuscript.',
+        parameters: {
+            data: { type: 'json', required: true, description: 'Object: group_id, expected_revision, entry_ids[], decision absorb/recover/freeze, confirm:true. absorb: outline_revision, outline_updates[{node_id,metadata}], resume?. recover: plan, target_chapter_id.' },
+        },
+        output: { schema: JSON_OUTPUT_SCHEMA, render: (_args, value) => renderJson(value) },
+        timeoutMs,
+        async execute(args, exec) {
+            return await clientFor(exec).postJson('/api/arc-reconcile', { ...requireRecord(args.data, 'data'), action: 'arc_reconcile' }, exec.signal);
+        },
+    }));
     // ── style sources, reference library, runtime skills, rules ──────────────
     ctx.tools.register(defineTool({
         name: 'novel_source_action',
@@ -2393,13 +2487,14 @@ export function registerNovelTools(ctx, clientFactory, options) {
             run_id: { type: 'string', description: 'Benchmark run id for get.' },
             task_type: { type: 'string', enum: ['chapter', 'outline'], description: 'Run target: chapter (default) or outline. Outline supports framework mode only.' },
             chapter_id: { type: 'string', description: 'Chapter task target: next (default) or an available canonical chapter_id from options, e.g. ch_003. Unavailable targets are rejected without fallback; inspect availability/reason first.' },
+            allow_historical: { type: 'boolean', description: 'Explicit isolated rewrite of an already written chapter using current canon. This is not a reconstructed pre-chapter baseline. Source manuscript and ledgers remain unchanged.' },
             outline_start_chapter: { type: 'integer', description: 'Outline task first chapter number, inclusive, 1-100000. Omit to continue after the last outline chapter.' },
             outline_chapter_count: { type: 'integer', description: 'Outline task range length including its starting chapter, 1-20 (default 3).' },
             writer_profile_ids: { type: 'array', items: { type: 'string' }, description: 'Writing profiles to compare (run).' },
             reviewer_profile_ids: { type: 'array', items: { type: 'string' }, description: 'Independent blind-review profiles (run).' },
             execution_mode: { type: 'string', enum: ['framework', 'creative'], description: 'Execution path: full framework (default); creative diagnostic is available only for chapter tasks. Read task pipelines with options.' },
             repeats: { type: 'integer', description: 'Repeats per writing profile, 1-5.' },
-            target_words: { type: 'integer', description: 'Chapter candidate target length, 200-12000; use outline_chapter_count for outline range.' },
+            target_words: { type: 'integer', description: 'Chapter candidate target length, 200-50000; use outline_chapter_count for outline range.' },
             concurrency: { type: 'integer', description: 'Concurrent model jobs, 1-4.' },
             limit: { type: 'integer', description: 'List limit, default 20.' },
         },
@@ -2429,7 +2524,7 @@ export function registerNovelTools(ctx, clientFactory, options) {
                 writer_profile_ids: args.writer_profile_ids,
                 reviewer_profile_ids: args.reviewer_profile_ids,
             };
-            for (const key of ['task_type', 'chapter_id', 'outline_start_chapter', 'outline_chapter_count', 'execution_mode', 'repeats', 'target_words', 'concurrency']) {
+            for (const key of ['task_type', 'chapter_id', 'allow_historical', 'outline_start_chapter', 'outline_chapter_count', 'execution_mode', 'repeats', 'target_words', 'concurrency']) {
                 const value = args[key];
                 if (value !== undefined)
                     body[key] = value;

package/packages/openwrite-bridge/package.json

@@ -28,12 +28,13 @@
       "patch": "./cordis.patch.yml"
     },
     "compatibility": {
-      "dsh": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2",
+      "dsh": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
       "dshReleases": {
         "0.1.2-rc.1": "compatible",
         "0.1.5-alpha.1": "compatible",
         "0.2.0-rc.2": "compatible",
-        "0.2.1-rc.2": "compatible"
+        "0.2.1-rc.2": "compatible",
+        "0.2.1-rc.3": "compatible"
       }
     }
   },
@@ -45,9 +46,9 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "4.0.2 || ~4.0.4",
-    "@deepseek-ai/dsh-host-webserver": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2",
-    "@deepseek-ai/dsh-workspace": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2"
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
+    "@deepseek-ai/dsh-tools": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3",
+    "@deepseek-ai/dsh-workspace": "0.1.2-rc.1 || 0.1.5-alpha.1 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-host-webserver": {