@agi-fans/dsh-tui 0.20.0 → 0.22.0

package/lib/prompt-intents.js

@@ -0,0 +1,127 @@
+/**
+ * The four intents a caller actually has when it asks the reader something.
+ *
+ * `TuiPrompt` grew to forty-six optional fields because every new surface added
+ * one: `presentation`, `filterable`, `approveValue`,
+ * `dismissLabel`, `skippable`, `wait`, `interrupt`, `onSuperseded`,
+ * `refreshDocument`, `refreshOptions` … A caller passing `{ title, question,
+ * allowCustom: true }` had to know that omitting `options` means "free text" and
+ * that `allowCustom: false` is what makes a list non-editable. Nothing in the
+ * type said which fields belong together, so each new caller assembled its own
+ * combination and the interface kept widening.
+ *
+ * These four intents are measured, not invented: across 196 call sites, 109 ask
+ * for free text, 45 offer a list, 14 read a document, and the rest are those
+ * shapes with one extra field. Each function below names the intent, defaults
+ * what the intent always wants, and leaves the escape hatch — {@link TuiService.prompt}
+ * with the full type — for the handful of surfaces that genuinely need it.
+ *
+ * @module @agi-fans/dsh-tui/prompt-intents
+ */
+/**
+ * Ask for free text.
+ *
+ * This is the shape 109 of 196 call sites wanted and had to spell as
+ * `{ allowCustom: true, notify: false }`. A bare input needs no `options` array
+ * and no `presentation`; both are supplied here so the caller states one thing.
+ */
+export function askPrompt(request) {
+    return {
+        title: request.title,
+        question: request.question,
+        ...(request.detail === undefined ? {} : { detail: request.detail }),
+        ...(request.initialInput === undefined ? {} : { initialInput: request.initialInput }),
+        ...(request.preserveWhitespace === true ? { preserveWhitespace: true } : {}),
+        ...(request.secret === true ? { secret: true } : {}),
+        ...(request.onCancelDraft === undefined ? {} : { onCancelDraft: request.onCancelDraft }),
+        ...(request.submitLabel === undefined ? {} : { submitLabel: request.submitLabel }),
+        ...(request.signal === undefined ? {} : { signal: request.signal }),
+        allowCustom: true,
+        notify: request.notify ?? false,
+    };
+}
+/**
+ * Offer a list of choices.
+ *
+ * The list is not editable: a caller that wants both a list and free text wants
+ * {@link askPrompt} with `detail`, or the full {@link TuiPrompt} if it really
+ * needs both. Keeping the two apart is what lets this function state the shape
+ * without an `allowCustom` flag the caller has to reason about.
+ */
+export function choosePrompt(request) {
+    return {
+        title: request.title,
+        question: request.question,
+        ...(request.detail === undefined ? {} : { detail: request.detail }),
+        options: request.options,
+        ...(request.initialValue === undefined ? {} : { initialValue: request.initialValue }),
+        ...(request.filterable === true ? { filterable: true } : {}),
+        ...(request.emptyText === undefined ? {} : { emptyText: request.emptyText }),
+        ...(request.actions === undefined ? {} : { actions: request.actions }),
+        ...(request.multiSelect === true ? { multiSelect: true } : {}),
+        ...(request.initialValues === undefined ? {} : { initialValues: request.initialValues }),
+        ...(request.allowEmptySelection === true ? { allowEmptySelection: true } : {}),
+        ...(request.submitLabel === undefined ? {} : { submitLabel: request.submitLabel }),
+        ...(request.signal === undefined ? {} : { signal: request.signal }),
+        allowCustom: false,
+        notify: request.notify ?? false,
+    };
+}
+/**
+ * Ask one yes/no question.
+ *
+ * Returns a boolean rather than a string or null, because "dismissed" and "no"
+ * are the same answer: a reader who presses Escape has not agreed to anything.
+ * Callers that need to tell those apart use the full prompt.
+ */
+export async function confirmPrompt(prompt, request) {
+    const accept = request.acceptLabel ?? 'Continue';
+    const answer = await prompt({
+        title: request.title,
+        question: request.question,
+        ...(request.detail === undefined ? {} : { detail: request.detail }),
+        options: request.cancelLabel === null
+            ? [{ label: accept, value: 'accept', ...(request.acceptDescription === undefined ? {} : { description: request.acceptDescription }) }]
+            : [
+                { label: accept, value: 'accept', ...(request.acceptDescription === undefined ? {} : { description: request.acceptDescription }) },
+                { label: request.cancelLabel ?? 'Cancel', value: 'cancel', ...(request.cancelDescription === undefined ? {} : { description: request.cancelDescription }) },
+            ],
+        // A one-way door preselects its only row; dismissal is still a no.
+        ...(request.cancelLabel === null ? { initialValue: 'accept' } : { initialValue: 'cancel' }),
+        allowCustom: false,
+        notify: request.notify ?? false,
+        ...(request.signal === undefined ? {} : { signal: request.signal }),
+    });
+    return answer === 'accept';
+}
+/**
+ * Show a document the reader can scroll, search, and leave.
+ *
+ * The surface is dropped automatically when the work it describes ends, so the
+ * caller does not have to pair an open with a close.
+ */
+export function readPrompt(request) {
+    return {
+        title: request.title,
+        question: request.question,
+        ...(request.detail === undefined ? {} : { detail: request.detail }),
+        // A plain string becomes a source so the reader gets line numbers and search
+        // rather than a wrapped prose page; an explicit source wins.
+        ...(request.source !== undefined
+            ? { documentSource: request.source }
+            : request.text === undefined ? {} : { documentSource: { text: request.text } }),
+        ...(request.position === undefined ? {} : { documentPosition: request.position }),
+        ...(request.tail === true ? { documentTail: true } : {}),
+        ...(request.image === undefined ? {} : { documentImage: request.image }),
+        ...(request.refresh === undefined ? {} : { refreshDocument: request.refresh }),
+        ...(request.onPosition === undefined ? {} : { onDocumentPosition: request.onPosition }),
+        options: [{ label: request.cancelLabel ?? 'Cancel', value: 'cancel' }],
+        presentation: 'document',
+        allowCustom: false,
+        notify: false,
+        ...(request.signal === undefined ? {} : { signal: request.signal }),
+        ...(request.interrupt === undefined ? {} : { interrupt: request.interrupt }),
+        ...(request.onSuperseded === undefined ? {} : { onSuperseded: request.onSuperseded }),
+    };
+}
+//# sourceMappingURL=prompt-intents.js.map

package/lib/prompt-intents.js.map

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

package/lib/runtime/agent-profile.d.ts

@@ -1,6 +1,7 @@
 /** Agent-preset helpers owned by the omdsh product composition. */
 import type { Context } from '@deepseek-ai/cordis';
 import type { ToolRestriction } from '@deepseek-ai/dsh-tools';
+import { type Agent, type ModelSelectionRef } from '@deepseek-ai/dsh-agent';
 export declare const name = "omdsh-agent-profile";
 export declare const inject: string[];
 /**
@@ -10,6 +11,10 @@ export declare const inject: string[];
  * tool registered.
  */
 export declare const SHELL_TOOL_ALIAS = "shell";
+/** Compose a model selection and the session's preset before Agent publication. */
+export declare function configureAgentContext(ctx: Context, agent: Agent, selection: ModelSelectionRef): Promise<{
+    agentPreset: string;
+}>;
 export interface Config {
     /** Restrict inherited tools while preserving tools registered by this preset. */
     tools?: ToolRestriction;

package/lib/runtime/agent-profile.js

@@ -1,4 +1,5 @@
 /** Agent-preset helpers owned by the omdsh product composition. */
+import { installModelSelection } from '@deepseek-ai/dsh-agent';
 export const name = 'omdsh-agent-profile';
 export const inject = ['tools'];
 /**
@@ -8,6 +9,17 @@ export const inject = ['tools'];
  * tool registered.
  */
 export const SHELL_TOOL_ALIAS = 'shell';
+/** Compose a model selection and the session's preset before Agent publication. */
+export async function configureAgentContext(ctx, agent, selection) {
+    installModelSelection(ctx, selection);
+    const presets = ctx.get('agentPresets');
+    const projections = ctx.get('sessionProjections');
+    if (presets === undefined || projections === undefined)
+        throw new Error('agent configuration services are unavailable');
+    const preset = projections.stateOf(agent.session, 'agentPreset') ?? presets.defaultId;
+    const mounted = await presets.mount(ctx, preset);
+    return { agentPreset: mounted.id };
+}
 /** Global shell tool name mounted for one platform. */
 export function shellToolName(platform = process.platform) {
     return platform === 'win32' ? 'pwsh' : 'bash';

package/lib/runtime/agent-profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-profile.js","sourceRoot":"","sources":["../../src/runtime/agent-profile.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAKnE,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAA;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAOvC,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,WAA4B,OAAO,CAAC,QAAQ;IACxE,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;AAC/C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAC/B,WAA4B,EAC5B,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAA;IACvD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACvG,OAAO,EAAE,GAAG,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAiB,EAAE;IACrD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAM;IACtC,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnD,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,qCAAqC,CAAC,CAAA;AAC1F,CAAC"}
+{"version":3,"file":"agent-profile.js","sourceRoot":"","sources":["../../src/runtime/agent-profile.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAInE,OAAO,EAAE,qBAAqB,EAAsC,MAAM,wBAAwB,CAAA;AAIlG,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAA;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAEvC,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAY,EAAE,KAAY,EAAE,SAA4B;IAClG,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IACvC,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IACjD,IAAI,OAAO,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACvH,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,OAAO,CAAC,SAAS,CAAA;IACrF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAChD,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,CAAA;AACpC,CAAC;AAOD,uDAAuD;AACvD,MAAM,UAAU,aAAa,CAAC,WAA4B,OAAO,CAAC,QAAQ;IACxE,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;AAC/C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAC/B,WAA4B,EAC5B,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAA;IACvD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACvG,OAAO,EAAE,GAAG,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAiB,EAAE;IACrD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAM;IACtC,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnD,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,qCAAqC,CAAC,CAAA;AAC1F,CAAC"}

package/lib/runtime/approval-rules.d.ts

@@ -0,0 +1,59 @@
+/** Remembered decisions over the Harness approval waterfall, never a sandbox override. */
+import { Context, Service } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { ApprovalRequestEvent } from '@deepseek-ai/dsh-user-approval/types';
+export interface ApprovalAction {
+    tool: string;
+    arguments: string;
+    cwd: string;
+    workspace: string;
+    sandbox: string;
+    reason: string;
+}
+export interface ApprovalRule extends ApprovalAction {
+    version: 1;
+    id: string;
+    scope: 'session' | 'workspace';
+    sessionId: string;
+    decision: 'allow' | 'reject';
+    createdAt: number;
+}
+export interface Config {
+    stateDir: string;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        omdshApprovalRules: ApprovalRules;
+    }
+}
+declare module '@deepseek-ai/dsh-session/types' {
+    interface PluginRecordMap {
+        'plugin:omdsh/approval-rule-matched': {
+            id: string;
+            scope: 'session' | 'workspace';
+            decision: 'allow' | 'reject';
+        };
+        'plugin:omdsh/approval-rule-error': {
+            message: string;
+        };
+        'plugin:omdsh/workspace-changes': {
+            turn: number;
+            summary: import('@deepseek-ai/dsh-workspace-changes').WorkspaceChangesSummary;
+        };
+    }
+}
+/** Stable exact JSON comparison; whitespace and object-key order are not permissions. */
+export declare function exactArguments(value: unknown): string;
+export declare class ApprovalRules extends Service {
+    static inject: string[];
+    private readonly ownerContext;
+    private readonly directory;
+    private readonly pending;
+    constructor(ctx: Context, config: Config);
+    private observe;
+    describe(request: ApprovalRequestEvent): ApprovalAction | undefined;
+    list(agent: Agent): ApprovalRule[];
+    remember(request: ApprovalRequestEvent, scope: ApprovalRule['scope'], decision: ApprovalRule['decision']): ApprovalRule;
+    revoke(agent: Agent, id: string): void;
+}
+export default ApprovalRules;

package/lib/runtime/approval-rules.js

@@ -0,0 +1,179 @@
+/** Remembered decisions over the Harness approval waterfall, never a sandbox override. */
+import { Service } from '@deepseek-ai/cordis';
+import { randomUUID } from 'node:crypto';
+import { lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { appendPluginRecord } from '@deepseek-ai/dsh-session';
+import { currentWorkingDirectory } from "../session/working-directory.js";
+/** Stable exact JSON comparison; whitespace and object-key order are not permissions. */
+export function exactArguments(value) {
+    const canonical = (item) => {
+        if (item === null || typeof item === 'string' || typeof item === 'boolean')
+            return item;
+        if (typeof item === 'number' && Number.isFinite(item))
+            return item;
+        if (Array.isArray(item))
+            return item.map(canonical);
+        if (typeof item === 'object' && item !== null)
+            return Object.fromEntries(Object.entries(item).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, child]) => [key, canonical(child)]));
+        throw new Error('Approval arguments must be lossless JSON.');
+    };
+    const text = JSON.stringify(canonical(value));
+    if (Buffer.byteLength(text) > 64 * 1024)
+        throw new Error('This action is too large to remember; approve it once.');
+    return text;
+}
+function sameAction(rule, action) {
+    return rule.tool === action.tool && rule.arguments === action.arguments && rule.cwd === action.cwd
+        && rule.workspace === action.workspace && rule.sandbox === action.sandbox && rule.reason === action.reason;
+}
+export class ApprovalRules extends Service {
+    static inject = ['tools', 'approval', 'sandboxPolicy'];
+    ownerContext;
+    directory;
+    pending = new Map();
+    constructor(ctx, config) {
+        super(ctx, 'omdshApprovalRules');
+        if (typeof config?.stateDir !== 'string' || config.stateDir.trim() === '')
+            throw new Error('Approval rules require a private state directory.');
+        this.ownerContext = ctx;
+        this.directory = config.stateDir;
+        // Both hook asks before dispatch and capability-owned asks inside the body
+        // carry the registry's immutable execution, including native and PTC calls.
+        ctx.on('tools/pre-execute', (exec, next) => this.observe(exec, next), true);
+        ctx.on('tools/execute', (exec, next) => this.observe(exec, next), true);
+        ctx.on('approval/request', async (request, next) => {
+            if (request.signal?.aborted)
+                return 'cancelled';
+            try {
+                const action = this.describe(request);
+                if (action === undefined)
+                    return next();
+                const matches = this.list(request.agent).filter(rule => sameAction(rule, action));
+                const rule = matches.find(rule => rule.decision === 'reject') ?? matches[0];
+                if (rule === undefined)
+                    return next();
+                appendPluginRecord(request.agent.session, 'plugin:omdsh/approval-rule-matched', { id: rule.id, scope: rule.scope, decision: rule.decision });
+                return rule.decision === 'allow' ? 'allowed-once' : 'rejected';
+            }
+            catch {
+                // Corrupt/unreadable permission state must never grant the request.
+                appendPluginRecord(request.agent.session, 'plugin:omdsh/approval-rule-error', { message: 'Approval rule storage is invalid or unavailable. The request was rejected; inspect /permission → Approval rules.' });
+                return 'rejected';
+            }
+        }, true);
+        ctx.effect(() => () => { this.pending.clear(); });
+    }
+    async observe(exec, next) {
+        if (exec.agent === undefined)
+            return next();
+        let argumentsText;
+        try {
+            argumentsText = exactArguments(exec.arguments);
+        }
+        catch {
+            return next();
+        }
+        const policy = this.ownerContext.get('sandboxPolicy').resolve({ session: exec.agent.session });
+        const action = { tool: exec.name, arguments: argumentsText, cwd: resolve(currentWorkingDirectory(this.ownerContext, exec.agent.session)),
+            workspace: resolve(policy.workspaceRoot), sandbox: policy.mode };
+        let calls = this.pending.get(exec.agent);
+        if (calls === undefined) {
+            calls = new Map();
+            this.pending.set(exec.agent, calls);
+        }
+        if (calls.has(exec.callId))
+            throw new Error('Duplicate pending approval call identity.');
+        calls.set(exec.callId, action);
+        try {
+            return await next();
+        }
+        finally {
+            calls.delete(exec.callId);
+            if (calls.size === 0)
+                this.pending.delete(exec.agent);
+        }
+    }
+    describe(request) {
+        const action = request.callId === undefined ? undefined : this.pending.get(request.agent)?.get(request.callId);
+        if (action === undefined || action.tool !== request.toolName || request.signal?.aborted)
+            return undefined;
+        const reason = request.reason ?? '';
+        if (Buffer.byteLength(reason) > 64 * 1024)
+            return undefined;
+        return { ...action, reason };
+    }
+    list(agent) {
+        const workspace = resolve(this.ownerContext.get('sandboxPolicy').resolve({ session: agent.session }).workspaceRoot);
+        let names;
+        try {
+            names = readdirSync(this.directory).filter(name => name.endsWith('.json'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        if (names.length > 500)
+            throw new Error('Too many approval rules; revoke unused decisions.');
+        return names.sort().map(name => {
+            const path = join(this.directory, name), stat = lstatSync(path);
+            if (!stat.isFile() || stat.size > 160 * 1024)
+                throw new Error('Approval rule must be a bounded regular file.');
+            const text = readFileSync(path, 'utf8');
+            if (Buffer.byteLength(text) > 160 * 1024)
+                throw new Error('Approval rule exceeds the record limit.');
+            const rule = JSON.parse(text);
+            if (!validRule(rule) || name !== rule.id + '.json')
+                throw new Error('Invalid approval rule record.');
+            if (exactArguments(JSON.parse(rule.arguments)) !== rule.arguments)
+                throw new Error('Approval rule arguments are not canonical JSON.');
+            return rule;
+        }).filter(rule => rule.workspace === workspace && (rule.scope === 'workspace' || rule.sessionId === agent.id));
+    }
+    remember(request, scope, decision) {
+        request.signal?.throwIfAborted();
+        if (!['session', 'workspace'].includes(scope) || !['allow', 'reject'].includes(decision))
+            throw new Error('Invalid approval rule selection.');
+        const action = this.describe(request);
+        if (action === undefined)
+            throw new Error('The requested action is no longer pending; no rule was saved.');
+        // Read before mutation; do not overwrite corrupted permissions or duplicate
+        // an existing decision. Files are independent so other processes can revoke
+        // or add unrelated rules without a read-modify-write race on one document.
+        const rules = this.list(request.agent);
+        const existing = rules.find(rule => rule.scope === scope && rule.decision === decision && sameAction(rule, action));
+        if (existing !== undefined)
+            return existing;
+        const rule = { ...action, version: 1, id: randomUUID(), scope, decision, sessionId: request.agent.id, createdAt: Date.now() };
+        mkdirSync(this.directory, { recursive: true, mode: 0o700 });
+        if (readdirSync(this.directory).filter(name => name.endsWith('.json')).length >= 500)
+            throw new Error('Revoke an unused approval rule before adding another.');
+        const target = join(this.directory, rule.id + '.json'), temp = target + '.tmp';
+        try {
+            writeFileSync(temp, JSON.stringify(rule) + '\n', { mode: 0o600, flag: 'wx' });
+            renameSync(temp, target);
+        }
+        finally {
+            rmSync(temp, { force: true });
+        }
+        return rule;
+    }
+    revoke(agent, id) {
+        const rule = this.list(agent).find(rule => rule.id === id);
+        if (rule === undefined)
+            throw new Error('That approval rule does not belong to this session or workspace.');
+        rmSync(join(this.directory, rule.id + '.json'), { force: true });
+    }
+}
+function validRule(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const rule = value;
+    return rule.version === 1 && typeof rule.id === 'string' && /^[0-9a-f-]{36}$/u.test(rule.id)
+        && ['tool', 'arguments', 'cwd', 'workspace', 'sandbox', 'reason', 'sessionId'].every(key => typeof rule[key] === 'string')
+        && ['session', 'workspace'].includes(String(rule.scope)) && ['allow', 'reject'].includes(String(rule.decision))
+        && Number.isSafeInteger(rule.createdAt);
+}
+export default ApprovalRules;
+//# sourceMappingURL=approval-rules.js.map

package/lib/runtime/approval-rules.js.map

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

package/lib/runtime/btw-policy.d.ts

@@ -0,0 +1,7 @@
+/** Durable preset policy for tool-free side consultations. */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const BTW_PRESET = "btw";
+export declare const name = "omdsh-btw-policy";
+export declare const inject: string[];
+/** No scope-local tool or an earlier allow decision may bypass this guard. */
+export declare function apply(ctx: Context): void;

package/lib/runtime/btw-policy.js

@@ -0,0 +1,18 @@
+/** Durable preset policy for tool-free side consultations. */
+export const BTW_PRESET = 'btw';
+export const name = 'omdsh-btw-policy';
+export const inject = ['tools', 'systemPrompt'];
+/** No scope-local tool or an earlier allow decision may bypass this guard. */
+export function apply(ctx) {
+    ctx.effect(() => ctx.tools.presentAs('native'), 'side consultation tool presentation');
+    ctx.effect(() => ctx.tools.restrict({ allow: [] }), 'side consultation inherited tools');
+    ctx.effect(() => ctx.tools.guard(() => 'Side consultations cannot use tools.'), 'side consultation execution guard');
+    ctx.on('system-prompt/assemble', async (_assembly, _context, next) => ({ ...await next(), tools: [], contexts: [] }));
+    // New workspace observations belong to the primary run. Preserve rejection
+    // policies, but admit only explicit side questions after the copied prefix.
+    ctx.on('agent/pre-step', async ({ messages }, next) => {
+        const decision = await next();
+        return decision.kind === 'reject' ? decision : { ...decision, messages: messages.filter(message => message.source.kind === 'user') };
+    }, true);
+}
+//# sourceMappingURL=btw-policy.js.map

package/lib/runtime/btw-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"btw-policy.js","sourceRoot":"","sources":["../../src/runtime/btw-policy.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAM9D,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAA;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAA;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;AAE/C,8EAA8E;AAC9E,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,qCAAqC,CAAC,CAAA;IACtF,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,mCAAmC,CAAC,CAAA;IACxF,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC,EAAE,mCAAmC,CAAC,CAAA;IACpH,GAAG,CAAC,EAAE,CAAC,wBAAwB,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IACrH,2EAA2E;IAC3E,4EAA4E;IAC5E,GAAG,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7B,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAA;IACtI,CAAC,EAAE,IAAI,CAAC,CAAA;AACV,CAAC"}

package/lib/runtime/btw.d.ts

@@ -0,0 +1,47 @@
+/** Durable side consultations over the public Harness Agent and fork seams. */
+import { Context, Service } from '@deepseek-ai/cordis';
+import type { Agent, ModelSelection } from '@deepseek-ai/dsh-agent';
+import { Session, SessionId, type SessionEvent } from '@deepseek-ai/dsh-session';
+import { type TurnTokenUsage } from '@deepseek-ai/dsh-token-meter/client';
+export interface BtwTopic {
+    version: 1;
+    sessionId: string;
+    parentSessionId: string;
+    prefixEvents: number;
+    question: string;
+    createdAt: number;
+    updatedAt: number;
+    status: 'running' | 'completed' | 'cancelled' | 'failed';
+}
+export interface BtwReply {
+    topic: BtwTopic;
+    text: string;
+    usage?: TurnTokenUsage;
+    error?: string;
+}
+export interface Config {
+    stateDir?: string;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        omdshBtw: BtwService;
+    }
+}
+/** Preserve the exact source prefix, then select the child's independent world. */
+export declare function btwSeed(parent: Session, id: SessionId, cwd: string): readonly SessionEvent[];
+export declare class BtwService extends Service {
+    static inject: string[];
+    private readonly ownerContext;
+    private readonly stateDir;
+    private readonly topics;
+    private readonly active;
+    private readonly tasks;
+    private readonly closing;
+    constructor(ctx: Context, config?: Config);
+    list(parent: Agent): BtwTopic[];
+    read(parent: Agent, id: string, signal: AbortSignal): Promise<string>;
+    consult(parent: Agent, question: string, selection: ModelSelection, signal: AbortSignal, update: (text: string) => void, topicId?: string): Promise<BtwReply>;
+    private runQuestion;
+    private saveTopic;
+}
+export default BtwService;