@askdkc/dsh-cli 0.11.3

package/lib/types/dsh-adapter/channel/job-projection.js

@@ -0,0 +1,150 @@
+import { markChannelReadDirty } from '../../adapter/channel/read-view.js';
+import { t } from '../../i18n.js';
+import { BackgroundJobStore, formatJobDuration } from '../jobs.js';
+/**
+ * Current-binding background-job projection. The registry can publish every
+ * owner's changes, so callbacks must prove their attachment and Channel owner
+ * are still current before they read a service or mutate projected rows.
+ */
+export function createJobProjection(getState, deps) {
+    const jobRowsByJobId = new Map();
+    let jobsRuntime;
+    let detachActive;
+    let attachmentToken;
+    let attachmentCurrent = () => false;
+    const syncRows = () => {
+        if (!attachmentCurrent())
+            return;
+        const state = getState();
+        state.backgroundJobs = store.snapshot();
+        for (const job of state.backgroundJobs) {
+            let row = jobRowsByJobId.get(job.id);
+            if (!row) {
+                row = { id: deps.rowIds.value++, kind: 'job', text: job.label, job: undefined };
+                jobRowsByJobId.set(job.id, row);
+                state.rows.push(row);
+            }
+            row.job = {
+                id: job.id,
+                kind: job.kind,
+                label: job.label,
+                status: job.status,
+                ...(job.detail === undefined ? {} : { detail: job.detail }),
+                startedAt: job.startedAt,
+                ...(job.finishedAt === undefined ? {} : { finishedAt: job.finishedAt }),
+                outputLines: job.outputLines,
+            };
+            row.text = job.label;
+            markChannelReadDirty(row);
+            markChannelReadDirty(state.rows);
+        }
+    };
+    const store = new BackgroundJobStore({
+        onSettled(job) {
+            deps.notify(t(job.status === 'completed' ? 'jobs-toast-completed' : job.status === 'failed' ? 'jobs-toast-failed' : 'jobs-toast-killed', {
+                id: job.id,
+                label: job.label,
+                duration: formatJobDuration(job),
+                detail: job.detail ?? '',
+            }), { color: job.status === 'completed' ? 'success' : job.status === 'failed' ? 'error' : 'warning', timeoutMs: 6000 });
+        },
+        onChanged() {
+            if (!attachmentCurrent())
+                return;
+            syncRows();
+            if (attachmentCurrent())
+                getState().emit();
+        },
+    });
+    const control = {
+        kill(id) {
+            const jobs = jobsRuntime;
+            if (!jobs?.kill)
+                return false;
+            const job = store.get(id);
+            try {
+                jobs.kill(id, deps.agent(), 'dsh-tui /jobs panel');
+            }
+            catch {
+                return false;
+            }
+            if (job !== undefined && (job.status === 'running' || job.status === 'stopping')) {
+                deps.steer(t('jobs-steer-killed', { id, label: job.label }));
+            }
+            return true;
+        },
+    };
+    /**
+     * Each service attachment has one idempotent disposer, dual-owned by the
+     * Channel and (when injected) the service context. Reattachment revokes the
+     * prior token before the replacement may synchronously publish.
+     */
+    const attach = (jobs, ownService) => {
+        if (jobs === undefined)
+            return;
+        detachActive?.();
+        jobsRuntime = jobs;
+        const token = Symbol('jobs-attachment');
+        let detached = false;
+        let detach;
+        const current = () => !detached && attachmentToken === token && detachActive === detach && jobsRuntime === jobs && deps.owner.current();
+        const refresh = () => {
+            // Check before list(): retained callbacks must not touch a revoked or
+            // replaced service, nor invoke any store/row work after owner disposal.
+            if (!current())
+                return;
+            try {
+                const snapshot = jobs.list(deps.agent());
+                if (!current())
+                    return;
+                store.replace(snapshot);
+            }
+            catch { /* optional service is disposing */ }
+        };
+        // Publish the attachment identity before subscription: registries are
+        // allowed to synchronously deliver their current snapshot from on*().
+        // Every registration below is transactional because a second on*() can
+        // throw after the first one successfully subscribed.
+        const disposers = [];
+        let releaseOwner;
+        detach = () => {
+            if (detached)
+                return;
+            detached = true;
+            if (detachActive === detach) {
+                detachActive = undefined;
+                attachmentToken = undefined;
+                attachmentCurrent = () => false;
+            }
+            if (jobsRuntime === jobs)
+                jobsRuntime = undefined;
+            for (const dispose of disposers.splice(0))
+                dispose?.();
+            // A service-context detach happens before channel teardown on remount;
+            // release its Channel owner entry now rather than retaining one cleanup
+            // per remount until the entire channel exits.
+            const release = releaseOwner;
+            releaseOwner = undefined;
+            release?.();
+        };
+        detachActive = detach;
+        attachmentToken = token;
+        attachmentCurrent = current;
+        try {
+            if (typeof jobs.onJobsChanged === 'function')
+                disposers.push(jobs.onJobsChanged(refresh));
+            if (typeof jobs.onJobDone === 'function')
+                disposers.push(jobs.onJobDone(refresh));
+            releaseOwner = deps.owner.own(detach);
+            ownService?.(detach);
+            refresh();
+        }
+        catch (error) {
+            detach();
+            throw error;
+        }
+    };
+    const dropRows = () => { jobRowsByJobId.clear(); };
+    const reset = () => { dropRows(); store.reset(); };
+    return { store, control, attach, dropRows, reset };
+}

package/lib/types/dsh-adapter/channel/lifetime-resources.d.ts

@@ -0,0 +1,9 @@
+import type { AgentHandle } from '@deepseek-ai/dsh-agent';
+import type { ChannelOwner } from './owner.js';
+/** Owns temporary Agent handles until a caller explicitly transfers them. */
+export declare function createDetachedHandleFactory(owner: Pick<ChannelOwner, 'assertActive' | 'current' | 'own'>): (create: () => Promise<AgentHandle>) => Promise<{
+    handle: AgentHandle;
+    transfer(): void;
+    release(): Promise<void>;
+}>;
+//# sourceMappingURL=lifetime-resources.d.ts.map

package/lib/types/dsh-adapter/channel/lifetime-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifetime-resources.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/lifetime-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,6EAA6E;AAC7E,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,SAAS,GAAG,KAAK,CAAC,IACzF,QAAQ,MAAM,OAAO,CAAC,WAAW,CAAC,KAAG,OAAO,CAAC;IACzD,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,IAAI,IAAI,CAAA;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB,CAAC,CA4BH"}

package/lib/types/dsh-adapter/channel/lifetime-resources.js

@@ -0,0 +1,33 @@
+/** Owns temporary Agent handles until a caller explicitly transfers them. */
+export function createDetachedHandleFactory(owner) {
+    return async (create) => {
+        owner.assertActive();
+        let handle;
+        let transferred = false;
+        let disposePromise;
+        const release = () => {
+            if (transferred || handle === undefined)
+                return Promise.resolve();
+            disposePromise ??= handle.dispose().catch(() => undefined);
+            return disposePromise;
+        };
+        const unregister = owner.own(() => { void release(); });
+        try {
+            handle = await create();
+            if (!owner.current()) {
+                await release();
+                throw new Error('dsh-tui: Channel lifetime has ended');
+            }
+            return {
+                handle,
+                transfer() { transferred = true; unregister(); },
+                async release() { unregister(); await release(); },
+            };
+        }
+        catch (error) {
+            unregister();
+            await release();
+            throw error;
+        }
+    };
+}

package/lib/types/dsh-adapter/channel/loaded-context.d.ts

@@ -0,0 +1,40 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type SkillSummary } from '@deepseek-ai/dsh-skill';
+import type { LoadedContextEntry, LoadedContextFile, LoadedContextSkill, LoadedContextTool } from './types.js';
+import type { ChannelOwner } from './owner.js';
+export type SkillRegistry = {
+    snapshot(options?: {
+        scope?: unknown;
+        cwd?: string;
+    }): Promise<{
+        skills: readonly SkillSummary[];
+        complete: boolean;
+    }>;
+    get(name: string, options?: {
+        scope?: unknown;
+        cwd?: string;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+};
+/** Assembles the loaded-context panel. A result belongs only to its origin Agent. */
+export declare function createLoadedContextRefresher(ctx: Context, deps: {
+    owner: Pick<ChannelOwner, 'current'>;
+    agent(): Agent;
+    cwd(): string;
+    publish(context: {
+        sections: LoadedContextEntry[];
+        contexts: LoadedContextEntry[];
+        files: LoadedContextFile[];
+        skills: LoadedContextSkill[];
+        tools: LoadedContextTool[];
+    }): void;
+    skillRegistryFor(agent: Agent): SkillRegistry | undefined;
+    skillViewOptions(agent: Agent): {
+        scope: Agent;
+        cwd: string;
+    };
+}): {
+    refresh: () => Promise<void>;
+};
+//# sourceMappingURL=loaded-context.d.ts.map

package/lib/types/dsh-adapter/channel/loaded-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-context.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/loaded-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAGnD,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC7D,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;QAC/B,QAAQ,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvG,CAAA;AAED,qFAAqF;AACrF,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,KAAK,IAAI,KAAK,CAAA;IACd,GAAG,IAAI,MAAM,CAAA;IACb,OAAO,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;QAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;QAAC,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAAC,KAAK,EAAE,iBAAiB,EAAE,CAAA;KAAE,GAAG,IAAI,CAAA;IAChL,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,GAAG,SAAS,CAAA;IACzD,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9D;mBAEyB,OAAO,CAAC,IAAI,CAAC;EA+CxC"}

package/lib/types/dsh-adapter/channel/loaded-context.js

@@ -0,0 +1,62 @@
+import { assembleContextFor } from '@deepseek-ai/dsh-agent';
+import { loadBaselineInstructions } from '@deepseek-ai/dsh-agent-instructions';
+import { isModelInvocable } from '@deepseek-ai/dsh-skill';
+import { renderContextSections, renderPrompt } from '@deepseek-ai/dsh-system-prompt';
+/** Assembles the loaded-context panel. A result belongs only to its origin Agent. */
+export function createLoadedContextRefresher(ctx, deps) {
+    const refresh = async () => {
+        if (!deps.owner.current())
+            return;
+        const target = deps.agent();
+        const sections = [];
+        const contexts = [];
+        const files = [];
+        const skills = [];
+        const tools = [];
+        try {
+            const systemPrompt = ctx.get('systemPrompt');
+            if (systemPrompt !== undefined) {
+                const assembly = await systemPrompt.assemble(assembleContextFor(target));
+                if (!deps.owner.current() || target !== deps.agent())
+                    return;
+                for (const section of assembly.sections) {
+                    const text = renderPrompt({ sections: [section], contexts: [], tools: [], variables: assembly.variables });
+                    if (text.length > 0)
+                        sections.push({ name: section.name, text });
+                }
+                contexts.push(...renderContextSections(assembly));
+                for (const tool of assembly.tools)
+                    tools.push({ name: tool.name, description: tool.description ?? '' });
+            }
+            const renderedInstructions = await loadBaselineInstructions({
+                cwd: deps.cwd(), maxBytes: 1024 * 1024, maxSourceBytes: 1024 * 1024,
+            }, ctx.get('fs'));
+            if (!deps.owner.current() || target !== deps.agent())
+                return;
+            const sources = renderedInstructions;
+            const paths = new Set([
+                ...(sources?.represented ?? []).map(file => file.displayPath),
+                ...(renderedInstructions?.omitted ?? []).map(file => file.displayPath),
+                ...(renderedInstructions?.truncated ?? []).map(file => file.displayPath),
+            ]);
+            files.push(...[...paths].map(displayPath => ({ displayPath })));
+            const registry = tools.some(tool => tool.name === 'skill') ? deps.skillRegistryFor(target) : undefined;
+            if (registry !== undefined) {
+                const observation = await registry.snapshot(deps.skillViewOptions(target));
+                if (!deps.owner.current() || target !== deps.agent())
+                    return;
+                if (observation.complete) {
+                    skills.push(...observation.skills.filter(isModelInvocable).map(skill => ({ name: skill.name, description: skill.description })));
+                }
+            }
+        }
+        catch (error) {
+            ctx.logger.warn('loaded-context snapshot failed: %o', error);
+            return;
+        }
+        if (!deps.owner.current() || target !== deps.agent())
+            return;
+        deps.publish({ sections, contexts, files, skills, tools });
+    };
+    return { refresh };
+}

package/lib/types/dsh-adapter/channel/local-actions.d.ts

@@ -0,0 +1,54 @@
+import { type ForegroundShell } from '../compat/shell.js';
+import { type foldBack as FoldBack } from './transcript.js';
+import type { ChannelState, ToolViewPresenter } from './types.js';
+/** Owns local-only transcript mutations, shell output, and live subagent queries. */
+export declare function createLocalActions(deps: {
+    ctx: {
+        get(name: string): unknown;
+    };
+    owner: {
+        current(): boolean;
+    };
+    binding: {
+        capture(): unknown;
+        isCurrent(capture: unknown): boolean;
+        readonly agent: {
+            session: unknown;
+            followup(message: unknown): void;
+        };
+    };
+    state: ChannelState;
+    rowIds: {
+        value: number;
+    };
+    projector: {
+        reset(): void;
+        presentCallView: NonNullable<ToolViewPresenter>['call'];
+        presentResultView: NonNullable<ToolViewPresenter>['result'];
+    };
+    subagents: {
+        dropRows(): void;
+    };
+    jobs: {
+        dropRows(): void;
+    };
+    foldBack: typeof FoldBack;
+    workspace: {
+        describe(cwd: string): {
+            kind: string;
+            badge: string;
+            label: string;
+        };
+        commandShell(cwd: string): Promise<ForegroundShell | undefined>;
+    };
+    shell?: ForegroundShell;
+    notify: ChannelState['notify'];
+}): {
+    loadOlder(): number;
+    clear(): void;
+    pushLocal(title: string, lines: readonly string[]): void;
+    setActivityFrames(name: string): boolean;
+    listSubagents(): Promise<string[]>;
+    runLocalCommand(command: string, includeInContext: boolean): Promise<void>;
+};
+//# sourceMappingURL=local-actions.d.ts.map

package/lib/types/dsh-adapter/channel/local-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/local-actions.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC7E,OAAO,EAA+B,KAAK,QAAQ,IAAI,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEjE,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IACnC,KAAK,EAAE;QAAE,OAAO,IAAI,OAAO,CAAA;KAAE,CAAA;IAC7B,OAAO,EAAE;QACP,OAAO,IAAI,OAAO,CAAA;QAClB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAA;QACpC,QAAQ,CAAC,KAAK,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;SAAE,CAAA;KACvE,CAAA;IACD,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,SAAS,EAAE;QAAE,KAAK,IAAI,IAAI,CAAC;QAAC,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;QAAC,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;IAClJ,SAAS,EAAE;QAAE,QAAQ,IAAI,IAAI,CAAA;KAAE,CAAA;IAC/B,IAAI,EAAE;QAAE,QAAQ,IAAI,IAAI,CAAA;KAAE,CAAA;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAA;IACzB,SAAS,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAA;KAAE,CAAA;IACrJ,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAC/B;iBAIgB,MAAM;aAKV,IAAI;qBAYI,MAAM,SAAS,SAAS,MAAM,EAAE,GAAG,IAAI;4BAKhC,MAAM,GAAG,OAAO;qBAajB,OAAO,CAAC,MAAM,EAAE,CAAC;6BAmBT,MAAM,oBAAoB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;EAqBnF"}

package/lib/types/dsh-adapter/channel/local-actions.js

@@ -0,0 +1,109 @@
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { markChannelReadDirty } from '../../adapter/channel/read-view.js';
+import { writeActivityFrames } from '../../activityPrefs.js';
+import { isPresetName, normalizeActivityPreset } from '../../components/activityFrames.js';
+import { t } from '../../i18n.js';
+import { snapshotLiveSessionEvents } from '../compat/liveSession.js';
+import { runForegroundShell } from '../compat/shell.js';
+import { LOCAL_OUTPUT_LIMIT, preview } from './transcript.js';
+/** Owns local-only transcript mutations, shell output, and live subagent queries. */
+export function createLocalActions(deps) {
+    const { ctx, owner, binding, state, rowIds, projector, subagents, jobs, foldBack, workspace, shell, notify } = deps;
+    const current = (capture) => owner.current() && binding.isCurrent(capture);
+    return {
+        loadOlder() {
+            const restored = foldBack(state.rows, snapshotLiveSessionEvents(binding.agent.session), { call: projector.presentCallView, result: projector.presentResultView });
+            if (restored > 0)
+                state.emit();
+            return restored;
+        },
+        clear() {
+            state.rows.length = 0;
+            markChannelReadDirty(state.rows);
+            rowIds.value = 0;
+            projector.reset();
+            subagents.dropRows();
+            jobs.dropRows();
+            state.activeToolCount = 0;
+            state.responseChars = 0;
+            state.rows.push({ id: rowIds.value++, kind: 'notice', text: 'Session cleared' });
+            state.emit();
+        },
+        pushLocal(title, lines) {
+            state.rows.push({ id: rowIds.value++, kind: 'local', text: title });
+            for (const line of lines)
+                state.rows.push({ id: rowIds.value++, kind: 'local-output', text: preview(line, LOCAL_OUTPUT_LIMIT) });
+            state.emit();
+        },
+        setActivityFrames(name) {
+            // A retired preset id normalizes to the current default, so the
+            // in-memory state, the persisted preference and the toast agree instead
+            // of diverging until restart.
+            const preset = normalizeActivityPreset(name) ?? name;
+            if (!isPresetName(preset)) {
+                notify(t('unknown-activity-preset', { name }), { color: 'error' });
+                return false;
+            }
+            if (preset === state.activityFrames) {
+                notify(t('activity-indicator-already', { name: preset }), { color: 'success' });
+                return true;
+            }
+            if (!writeActivityFrames(preset)) {
+                notify(t('activity-pref-write-failed'), { color: 'error' });
+                return false;
+            }
+            state.activityFrames = preset;
+            state.emit();
+            notify(t('activity-indicator-switched', { name: preset }));
+            return true;
+        },
+        async listSubagents() {
+            const service = ctx.get('subagents');
+            if (!service)
+                return [t('subagent-not-mounted')];
+            const capture = binding.capture();
+            try {
+                const children = await service.listChildren(binding.agent.session.id);
+                if (!current(capture))
+                    throw new Error('dsh-tui: Channel lifetime has ended');
+                if (children.length === 0)
+                    return [t('subagent-none')];
+                return children.map(child => {
+                    const id = typeof child.id === 'string' ? child.id : (child.id.value ?? '');
+                    return t('subagent-row', { mode: child.mode === 'continuable' ? t('subagent-resumable') : t('subagent-oneshot'), label: child.label ? `「${child.label}」` : '', activity: child.activity === 'running' ? t('subagent-running') : t('subagent-archived'), id: id.slice(0, 8) });
+                });
+            }
+            catch (error) {
+                if (!current(capture))
+                    throw error;
+                return [t('subagent-query-failed', { err: error instanceof Error ? error.message : String(error) })];
+            }
+        },
+        async runLocalCommand(command, includeInContext) {
+            const capture = binding.capture();
+            const cwd = state.cwd;
+            const target = workspace.describe(cwd);
+            state.rows.push({ id: rowIds.value++, kind: 'local', text: command, executionTarget: target.kind === 'local' ? target.badge : `${target.badge} · ${target.label}` });
+            state.emit();
+            let output = '(no output)';
+            const executor = await workspace.commandShell(cwd) ?? shell;
+            if (!current(capture))
+                return;
+            if (executor) {
+                try {
+                    const result = await runForegroundShell(executor, { command, workdir: cwd, timeoutMs: 30000 });
+                    output = result.stdout.text.trim() || result.stderr.text.trim() || (result.timedOut ? '(timed out)' : '(no output)');
+                }
+                catch (error) {
+                    output = error instanceof Error ? error.message : String(error);
+                }
+            }
+            if (!current(capture))
+                return;
+            state.rows.push({ id: rowIds.value++, kind: 'local-output', text: preview(output, LOCAL_OUTPUT_LIMIT) });
+            state.emit();
+            if (includeInContext)
+                binding.agent.followup(createUserMessage({ content: [{ type: 'text', text: `<bash-stdout>\n${output}\n</bash-stdout>` }], source: { kind: 'user' } }));
+        },
+    };
+}

package/lib/types/dsh-adapter/channel/mentions.d.ts

@@ -0,0 +1,29 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { MentionAttachments, MentionExpansion, MentionFs, MentionImageBlock, MentionImageMediaType, ResolvedMention } from './types.js';
+/** One attached file's contribution is capped so an absent-minded `@` of a
+ *  huge file cannot blow the context window. */
+export declare const MENTION_MAX_FILE_CHARS = 50000;
+/** Total budget across all attachments in one message. */
+export declare const MENTION_MAX_TOTAL_CHARS = 200000;
+/** A directory mention contributes a shallow listing, capped at this many
+ *  entries. */
+export declare const MENTION_MAX_DIR_ENTRIES = 200;
+/** The leaf's fs service in the shape mention expansion needs; undefined
+ *  when the plugin is not mounted (mentions then stay literal text). */
+export declare function mentionFs(ctx: Context): MentionFs | undefined;
+export declare function mentionAttachments(ctx: Context): MentionAttachments | undefined;
+export declare const MENTION_IMAGE_MEDIA_TYPES: Readonly<Record<string, MentionImageMediaType>>;
+export declare function mentionImageMediaType(path: string): MentionImageMediaType | undefined;
+/** Resolve+stat one candidate path; undefined when it throws OR stats
+ * absent — both are a miss for strip-first mention resolution (issue #359). */
+export declare function tryResolveMention(fs: MentionFs, absolute: string): Promise<ResolvedMention | undefined>;
+/**
+ * Expand a submitted text's `@` mentions (issue #15) into model-facing
+ * attachment blocks: supported image files become durable image blocks,
+ * other files contribute capped text, and directories contribute a shallow
+ * listing. Reads always go through the active fs service, so provider-owned
+ * workspaces keep their routing semantics. The typed text stays first and
+ * verbatim. Best-effort failures degrade to `missing`, never a failed send.
+ */
+export declare function expandMentions(fs: MentionFs | undefined, cwd: string, text: string, attachments?: MentionAttachments, stagedImages?: ReadonlyMap<string, MentionImageBlock['attachment']>): Promise<MentionExpansion>;
+//# sourceMappingURL=mentions.d.ts.map

package/lib/types/dsh-adapter/channel/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/mentions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5I;gDACgD;AAChD,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAE5C,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB,SAAU,CAAA;AAE9C;eACe;AACf,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C;wEACwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAE/E;AAED,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAMrF,CAAA;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAErF;AAED;+EAC+E;AAC/E,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAS7G;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,SAAS,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,kBAAkB,EAChC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,GAClE,OAAO,CAAC,gBAAgB,CAAC,CAqL3B"}