dsh-openwrite 0.2.8

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

@@ -0,0 +1,56 @@
+const reads = new Set([
+    'novel_embedding_profiles', 'novel_status', 'novel_review_framework', 'novel_trace_list',
+    'novel_context_preview', 'novel_outline_read', 'novel_reading_order', 'novel_reading_packet',
+    'novel_chapter_work', 'novel_scene_structure', 'novel_chapter_scenes', 'novel_scene_migration_preview',
+    'novel_assets_list', 'novel_search', 'novel_doc_read', 'novel_asset_read', 'novel_revisions_list',
+    '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',
+]);
+const generates = new Set([
+    'novel_write_chapter', 'novel_review_chapter', 'novel_multi_write', 'novel_task_create',
+    'novel_task_retry', 'novel_task_confirm', 'novel_revision_create_selection',
+    'novel_revision_create_from_review', 'novel_revision_regenerate', 'novel_settle_backfill',
+    'novel_model_test', 'novel_model_embedding_test',
+]);
+const readActions = {
+    novel_model_benchmark: ['list', 'get', 'options'],
+    novel_chapter_run_action: ['list', 'get'],
+    novel_rolling_plan_action: ['list', 'get'],
+    novel_narrative_forecast_action: ['list', 'get'],
+    novel_manuscript_edit_action: ['versions', 'version', 'compare', 'annotations'],
+    novel_source_action: ['status_v2', 'profile_v2'],
+    novel_reference_library_action: ['list', 'status', 'profile'],
+    novel_runtime_skill_action: ['list', 'diagnose', 'resolve'],
+    novel_rule_action: ['status'],
+};
+/** Unknown and preview operations fail closed: previews can persist confirmation records. */
+export function novelEffect(name, args) {
+    if (reads.has(name))
+        return 'read';
+    const values = args && typeof args === 'object' ? args : {};
+    if (readActions[name]?.includes(String(values.action)))
+        return 'read';
+    if (name === 'novel_model_benchmark' && values.action === 'run')
+        return 'generate';
+    return generates.has(name) ? 'generate' : 'write';
+}
+export function novelPolicyDenial(ctx, execution) {
+    if (!execution.name.startsWith('novel_'))
+        return;
+    const effect = novelEffect(execution.name, execution.arguments);
+    if (effect === 'read')
+        return;
+    const agent = execution.agent;
+    if (!agent)
+        return 'OPENWRITE_POLICY_REQUIRED: writing requires an Agent session';
+    // Plan state can live in the preset realm; consult the executing Agent.
+    const plan = agent.ctx.get('planMode');
+    if (plan?.get(agent).active)
+        return 'OPENWRITE_PLAN_MODE: plan mode cannot generate or persist changes';
+    const policy = ctx.get('sandboxPolicy');
+    if (!policy || policy.resolve({ session: agent.session }).mode === 'read-only') {
+        return 'OPENWRITE_READ_ONLY: the session does not permit writing';
+    }
+    return;
+}

package/packages/openwrite-bridge/lib/tools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `novel_*` tool definitions bridging dsh agents to the OpenWrite Studio
+ * HTTP action surface. Payload shapes are verified against OpenWrite
+ * `tools/studio_http.py` (POST_ROUTES / do_GET / do_PUT) and
+ * `tools/studio_application.py` (the dispatched methods).
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type ToolRunContext } from '@deepseek-ai/dsh-tools';
+import type { StudioClient, WorkspaceContext } from './client.js';
+/** Plugin-level config the tools need beyond the HTTP client. */
+export interface NovelToolsOptions {
+    /** Cooperative per-call budget (ms), attached as each tool's `timeoutMs`. */
+    timeoutMs: number;
+    /** Directory `novel_export` saves downloaded files into. */
+    outputDir: string;
+}
+/**
+ * Derive the request-scoped Workspace context from the tool execution, failing
+ * closed (docs/WORKSPACE_CONTEXT_CONTRACT.md §2.1): the stamped session cwd is
+ * the only root source — never a fallback to the plugin cwd or a fixed project.
+ */
+export declare function workspaceContextFromExec(exec: ToolRunContext): WorkspaceContext;
+/** Register every `novel_*` tool into the host tools registry. */
+export declare function registerNovelTools(ctx: Context, clientFactory: (exec: ToolRunContext) => StudioClient, options: NovelToolsOptions): void;