@ai-workbench/remote-agent 0.8.19 → 0.8.23

package/dist/protocol-boundary.js

@@ -1,49 +0,0 @@
-import { createHash } from 'node:crypto';
-import { NeedError } from "./remote.js";
-const fingerprint = (value) => createHash('sha256').update(JSON.stringify(value)).digest('hex');
-/** Byte fragments remain only in memory. A cursor is clean only after SDK consumption. */
-export class ProtocolBoundary {
-    maxBytes;
-    partial = Buffer.alloc(0);
-    pending = [];
-    requests = new Set();
-    constructor(maxBytes) {
-        this.maxBytes = maxBytes;
-    }
-    receive(bytes, gate) {
-        this.partial = Buffer.concat([this.partial, bytes]);
-        let end;
-        while ((end = this.partial.indexOf(10)) >= 0) {
-            if (end > this.maxBytes)
-                throw new NeedError('ACP_MESSAGE_TOO_LARGE', '主机消息超过具名会话容量', 'acpMaxMessageBytes');
-            const line = this.partial.subarray(0, end).toString('utf8').trim();
-            this.partial = this.partial.subarray(end + 1);
-            if (!line)
-                continue;
-            let message;
-            try {
-                message = JSON.parse(line);
-            }
-            catch {
-                throw new NeedError('ACP_OUTPUT_INVALID', '主机消息不是有效JSON', '完整ACP消息');
-            }
-            if (!message || typeof message !== 'object' || Array.isArray(message))
-                throw new NeedError('ACP_OUTPUT_INVALID', '主机消息结构无效', '完整ACP消息');
-            if (gate)
-                gate(message);
-            else
-                this.pending.push(fingerprint(message));
-        }
-        if (this.partial.length > this.maxBytes)
-            throw new NeedError('ACP_MESSAGE_TOO_LARGE', '主机消息超过具名会话容量', 'acpMaxMessageBytes');
-    }
-    consumed(message) {
-        if (this.pending.shift() !== fingerprint(message))
-            throw new NeedError('ACP_BOUNDARY_UNCONFIRMED', '主机消息处理位置无法确认', '完整按序的ACP消息');
-        if (typeof message.method === 'string' && Object.hasOwn(message, 'id'))
-            this.requests.add(JSON.stringify(message.id));
-    }
-    responded(id) { this.requests.delete(JSON.stringify(id)); }
-    get complete() { return this.partial.length === 0 && this.pending.length === 0 && this.requests.size === 0; }
-    get wholeLine() { return this.partial.length === 0; }
-}

package/dist/provider-locale.d.ts

@@ -1,19 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-/** Matches the official locale service's English fallback before a client reports. */
-export declare const PROVIDER_NAMES: Readonly<{
-    en: "Codex (Remote Host)";
-    zh: "Codex（远程主机）";
-}>;
-export type ProviderLanguage = 'en' | 'zh';
-/** Local client presentation only: no host login, model call or locale preference write. */
-export declare class ProviderLocaleRemote extends TypertRemoteService {
-    private readonly update;
-    private language;
-    private disposed;
-    constructor(ctx: Context, update: (language: ProviderLanguage) => void);
-    setLocale(language: unknown, signal: AbortSignal): Promise<{
-        language: ProviderLanguage;
-        name: string;
-    }>;
-}

package/dist/provider-locale.js

@@ -1,73 +0,0 @@
-var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
-    var useValue = arguments.length > 2;
-    for (var i = 0; i < initializers.length; i++) {
-        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
-    }
-    return useValue ? value : void 0;
-};
-var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
-    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
-    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
-    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
-    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
-    var _, done = false;
-    for (var i = decorators.length - 1; i >= 0; i--) {
-        var context = {};
-        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
-        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
-        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
-        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
-        if (kind === "accessor") {
-            if (result === void 0) continue;
-            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
-            if (_ = accept(result.get)) descriptor.get = _;
-            if (_ = accept(result.set)) descriptor.set = _;
-            if (_ = accept(result.init)) initializers.unshift(_);
-        }
-        else if (_ = accept(result)) {
-            if (kind === "field") initializers.unshift(_);
-            else descriptor[key] = _;
-        }
-    }
-    if (target) Object.defineProperty(target, contextIn.name, descriptor);
-    done = true;
-};
-import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
-import { NeedError } from "./remote.js";
-/** Matches the official locale service's English fallback before a client reports. */
-export const PROVIDER_NAMES = Object.freeze({ en: 'Codex (Remote Host)', zh: 'Codex（远程主机）' });
-/** Local client presentation only: no host login, model call or locale preference write. */
-let ProviderLocaleRemote = (() => {
-    let _classSuper = TypertRemoteService;
-    let _instanceExtraInitializers = [];
-    let _setLocale_decorators;
-    return class ProviderLocaleRemote extends _classSuper {
-        static {
-            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-            _setLocale_decorators = [Remote];
-            __esDecorate(this, null, _setLocale_decorators, { kind: "method", name: "setLocale", static: false, private: false, access: { has: obj => "setLocale" in obj, get: obj => obj.setLocale }, metadata: _metadata }, null, _instanceExtraInitializers);
-            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-        }
-        update = __runInitializers(this, _instanceExtraInitializers);
-        language = 'en';
-        disposed = false;
-        constructor(ctx, update) {
-            super(ctx, 'awCodexPresentation');
-            this.update = update;
-            ctx.effect(() => () => { this.disposed = true; });
-        }
-        async setLocale(language, signal) {
-            signal.throwIfAborted();
-            if (this.disposed)
-                throw new NeedError('DISPOSED', 'Codex presentation registration is disposed', 'active plugin');
-            if (language !== 'en' && language !== 'zh')
-                throw new NeedError('INVALID_REQUEST', 'Unsupported presentation language', 'official en/zh locale');
-            if (language !== this.language) {
-                this.update(language);
-                this.language = language;
-            }
-            return { language, name: PROVIDER_NAMES[language] };
-        }
-    };
-})();
-export { ProviderLocaleRemote };

package/dist/recovery-checkpoint.d.ts

@@ -1,6 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-import type { RuntimeRequest } from './provider.ts';
-/** A step's accepted batch follows step/start in the official event contract. */
-export declare function currentInputIds(ctx: Context, request: RuntimeRequest): Promise<readonly string[]>;
-/** Read only the official persistence API after its awaited durability checkpoint. */
-export declare function verifyRecoveryCheckpoint(ctx: Context, request: RuntimeRequest, provider: string): Promise<boolean>;

package/dist/recovery-checkpoint.js

@@ -1,71 +0,0 @@
-import { SessionId } from '@deepseek-ai/dsh-session';
-import { BlockAssembler, expandAssistantStream } from '@deepseek-ai/dsh-llm';
-import { isDeepStrictEqual } from 'node:util';
-/** A step's accepted batch follows step/start in the official event contract. */
-export async function currentInputIds(ctx, request) {
-    if (!request.sessionId)
-        return [];
-    const id = SessionId(request.sessionId), store = ctx.get('sessions'), session = store?.get(id);
-    const persistence = ctx.get('sessionPersistence');
-    if (!session || !store || !persistence || !await store.flush(session))
-        return [];
-    const handle = await persistence.open(id, 'read');
-    try {
-        if (handle.id !== id || handle.header?.id !== id || handle.access !== 'read')
-            return [];
-        const { events } = await handle.read();
-        if (!Array.isArray(events))
-            return [];
-        let step;
-        let ids = [];
-        for (const event of events) {
-            if (event.type === 'step/start') {
-                step = event;
-                ids = [];
-            }
-            else if (event.type === 'turn/start' || event.type === 'step/end' || event.type === 'turn/end') {
-                step = undefined;
-                ids = [];
-            }
-            else if (event.type === 'user/message' && step)
-                ids.push(event.data.id);
-        }
-        return ids;
-    }
-    finally {
-        await handle.close();
-    }
-}
-/** Read only the official persistence API after its awaited durability checkpoint. */
-export async function verifyRecoveryCheckpoint(ctx, request, provider) {
-    if (!request.sessionId || !request.recoveryCheckpointId || !request.resumeSessionId)
-        return false;
-    const id = SessionId(request.sessionId), store = ctx.get('sessions'), session = store?.get(id);
-    const persistence = ctx.get('sessionPersistence');
-    if (!session || typeof store?.flush !== 'function' || typeof persistence?.open !== 'function')
-        return false;
-    if (!await store.flush(session))
-        return false;
-    const handle = await persistence.open(id, 'read');
-    try {
-        if (handle?.id !== id || handle.header?.id !== id || handle.access !== 'read')
-            return false;
-        const { events } = await handle.read();
-        if (!Array.isArray(events))
-            return false;
-        const final = events.findLast(e => e.type === 'assistant/message' && e.surfaceOp === 'append');
-        const live = session.deriveMessages().findLast(m => m.role === 'assistant');
-        if (final?.type !== 'assistant/message' || final.data.interrupted || !live || live.id !== final.data.message.id || !isDeepStrictEqual(live, final.data.message))
-            return false;
-        const message = final.data.message, pointer = message.source.replayState?.response;
-        if (message.source.provider !== provider || pointer?.agent !== provider || pointer.dshSessionId !== id || pointer.sessionId !== request.resumeSessionId || pointer.recoveryCheckpointId !== request.recoveryCheckpointId)
-            return false;
-        const assembled = new BlockAssembler();
-        for (const part of expandAssistantStream(final.data.stream))
-            assembled.push(part.chunk);
-        return ['stop', 'max-tokens'].includes(assembled.finish.kind) && isDeepStrictEqual(assembled.replayState, message.source.replayState) && isDeepStrictEqual(assembled.blocks(), message.content);
-    }
-    finally {
-        await handle.close();
-    }
-}

package/dist/recovery.d.ts

@@ -1,51 +0,0 @@
-import type { AgentCapabilities, SessionConfigOption } from '@agentclientprotocol/sdk/unstable';
-export interface AcpRecovery {
-    sessionId: string;
-    capabilities: AgentCapabilities;
-    modelConfiguration?: {
-        configOptions: SessionConfigOption[];
-        selectorRoles?: {
-            model?: string;
-            effort?: string;
-        };
-        resolvedEvidence?: {
-            modelValue: string;
-            resolvedModel: string;
-        };
-    };
-    configUpdates?: SessionConfigOption[][];
-}
-export interface RecoveryState {
-    version: 1;
-    phase: 'dirty' | 'clean' | 'ended';
-    scope: string;
-    brokerId: string;
-    instanceId?: string;
-    pid?: number;
-    cursor?: number;
-    checkpointId?: string;
-    acp?: AcpRecovery;
-}
-export interface RecoveryJournal {
-    read(): Promise<RecoveryState | undefined>;
-    write(state: RecoveryState): Promise<void>;
-}
-export declare function validateRecovery(value: unknown): RecoveryState;
-export declare const codexContextPolicy: Readonly<{
-    version: 1;
-    scope: "new-session";
-    mode: "append";
-    content: "text";
-    resume: "omit-only";
-    changed: "new-session-required";
-    mapping: "developerInstructions";
-    nativeCliUnmodified: true;
-}>;
-export declare function supportsCodexContextPolicy(capabilities: AgentCapabilities): boolean;
-/** Known capabilities plus the exact Codex policy whitelist; no arbitrary metadata. */
-export declare function recoveryCapabilities(c: AgentCapabilities): AgentCapabilities;
-export declare function recoveryKey(value: unknown): string;
-/** Preserve legacy lookup bytes; each employee endpoint scope owns a separate journal. */
-export declare function runtimeRecoveryKey(identity: string, provider: string, sessionId: string | undefined, employeeScope?: string): string;
-/** History is immutable; current is atomically replaced only after fsync. No expiry. */
-export declare function recoveryJournal(profileDir: string, key: string): RecoveryJournal;

package/dist/recovery.js

@@ -1,61 +0,0 @@
-import { createHash, randomUUID } from 'node:crypto';
-import { join } from 'node:path';
-import { open, rename } from 'node:fs/promises';
-import { constants } from 'node:fs';
-import { privateDirectory, durableWrite, readJournal } from "./remote-details.js";
-import { NeedError } from "./remote.js";
-const invalid = () => new NeedError('RECOVERY_STORAGE_INVALID', '会话恢复记录无效，本轮尚未发送', '有效的私有会话恢复记录');
-export function validateRecovery(value) {
-    const s = value;
-    if (!s || s.version !== 1 || !['dirty', 'clean', 'ended'].includes(s.phase) || !/^[a-f0-9]{64}$/.test(s.scope) || !/^r[a-f0-9]{23}$/.test(s.brokerId))
-        throw invalid();
-    if (s.instanceId !== undefined && !/^[a-f0-9-]{36}$/.test(s.instanceId) || s.pid !== undefined && (!Number.isSafeInteger(s.pid) || s.pid < 1))
-        throw invalid();
-    if (s.phase === 'clean' && (!s.instanceId || !Number.isSafeInteger(s.cursor) || s.cursor < 0 || typeof s.checkpointId !== 'string' || !s.checkpointId || !s.acp || typeof s.acp.sessionId !== 'string' || !s.acp.sessionId || !s.acp.capabilities || typeof s.acp.capabilities !== 'object' || Array.isArray(s.acp.capabilities)))
-        throw invalid();
-    return structuredClone(s);
-}
-export const codexContextPolicy = Object.freeze({ version: 1, scope: 'new-session', mode: 'append', content: 'text', resume: 'omit-only', changed: 'new-session-required', mapping: 'developerInstructions', nativeCliUnmodified: true });
-export function supportsCodexContextPolicy(capabilities) {
-    const policy = capabilities._meta?.aiWorkbenchSystemPrompt;
-    return !!policy && typeof policy === 'object' && !Array.isArray(policy) && Object.keys(policy).length === Object.keys(codexContextPolicy).length && Object.entries(codexContextPolicy).every(([key, value]) => policy[key] === value);
-}
-/** Known capabilities plus the exact Codex policy whitelist; no arbitrary metadata. */
-export function recoveryCapabilities(c) {
-    return { loadSession: c.loadSession === true, promptCapabilities: { image: c.promptCapabilities?.image === true, audio: c.promptCapabilities?.audio === true, embeddedContext: c.promptCapabilities?.embeddedContext === true }, sessionCapabilities: { ...(c.sessionCapabilities?.resume ? { resume: {} } : {}), ...(c.sessionCapabilities?.systemPrompt ? { systemPrompt: {} } : {}) }, ...(supportsCodexContextPolicy(c) ? { _meta: { aiWorkbenchSystemPrompt: { ...codexContextPolicy } } } : {}) };
-}
-export function recoveryKey(value) { return createHash('sha256').update(JSON.stringify(value)).digest('hex'); }
-/** Preserve legacy lookup bytes; each employee endpoint scope owns a separate journal. */
-export function runtimeRecoveryKey(identity, provider, sessionId, employeeScope) {
-    return recoveryKey([identity, provider, sessionId, ...(employeeScope ? ['employee', employeeScope] : [])]);
-}
-/** History is immutable; current is atomically replaced only after fsync. No expiry. */
-export function recoveryJournal(profileDir, key) {
-    if (!/^[a-f0-9]{64}$/.test(key))
-        throw invalid();
-    const parent = join(profileDir, 'ai-workbench-remote-agent'), dir = join(parent, 'recovery', key), current = join(dir, 'current.json');
-    let tail = Promise.resolve();
-    const prepare = async () => { await privateDirectory(parent); await privateDirectory(join(parent, 'recovery')); await privateDirectory(dir); };
-    return {
-        async read() { await tail; await prepare(); try {
-            return validateRecovery(await readJournal(current));
-        }
-        catch (error) {
-            if (error?.code === 'ENOENT')
-                return;
-            throw error;
-        } },
-        write(state) { const value = validateRecovery(state); const task = tail.then(async () => { await prepare(); const id = randomUUID(); await durableWrite(join(dir, id + '.json'), value); const temp = join(dir, id + '.current'); const file = await open(temp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600); try {
-            await file.writeFile(JSON.stringify(value) + '\n');
-            await file.sync();
-        }
-        finally {
-            await file.close();
-        } await rename(temp, current); const directory = await open(dir, 'r'); try {
-            await directory.sync();
-        }
-        finally {
-            await directory.close();
-        } }); tail = task; return task; },
-    };
-}

package/dist/sdk-ssh-wrapper.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/sdk-ssh-wrapper.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-/** Codex SDK executable override. Prompt travels through stdin, never SSH argv. */
-import { readFile, lstat } from 'node:fs/promises';
-import { executeJob } from "./job.js";
-let child;
-let stopped = false;
-const lifetime = new AbortController();
-for (const sig of ['SIGTERM', 'SIGINT'])
-    process.on(sig, () => { stopped = true; lifetime.abort(); child?.kill('SIGTERM'); });
-try {
-    const path = process.env.AW_X_JOB_FILE;
-    if (!path)
-        throw new Error('job missing');
-    const meta = await lstat(path);
-    if (!meta.isFile() || meta.isSymbolicLink() || meta.uid !== process.getuid?.() || (meta.mode & 0o077) !== 0)
-        throw new Error('job permissions');
-    const spec = JSON.parse(await readFile(path, 'utf8'));
-    let input = '';
-    for await (const chunk of process.stdin)
-        input += chunk;
-    if (!stopped) {
-        const code = await executeJob(spec, 'stage', JSON.stringify({ argv: process.argv.slice(2), input, cwd: spec.cwd, codex: spec.codex }), c => { child = c; }, false, lifetime.signal);
-        if (code !== 0)
-            throw new Error('stage failed');
-    }
-    if (!stopped)
-        process.exitCode = (await executeJob(spec, 'run', undefined, c => { child = c; }, true, lifetime.signal)) ?? 1;
-    else
-        process.exitCode = 143;
-}
-catch {
-    process.stderr.write('远端单次运行失败；需要连接诊断，根因未查明。\n');
-    process.exitCode = 1;
-}

package/dist/stage-timing.d.ts

@@ -1,31 +0,0 @@
-import type { DetailObservation } from './conversation-details.ts';
-export declare const STAGES: Readonly<{
-    readonly 'login-ready': "登录就绪检查";
-    readonly 'connection-confirm': "核对当前连接状态";
-    readonly 'input-prepare': "准备本轮输入";
-    readonly 'workspace-resolve': "解析工作区";
-    readonly 'details-open': "打开技术详情";
-    readonly 'details-flush': "等待技术详情持久确认";
-    readonly 'workspace-notice': "记录工作区说明";
-    readonly 'broker-list': "查询主机会话";
-    readonly 'broker-start': "启动主机会话";
-    readonly 'broker-attach': "连接主机会话";
-    readonly 'acp-initialize': "初始化远程模型";
-    readonly 'acp-session-new': "新建模型会话";
-    readonly 'acp-session-load': "加载模型会话";
-    readonly 'acp-session-resume': "恢复模型会话";
-    readonly 'acp-prompt': "模型处理本轮（含等待审批）";
-}>;
-export type Stage = keyof typeof STAGES;
-/** Passive client observations; no thresholds, retries, or remote-clock claims. */
-export declare class StageTiming {
-    private readonly started;
-    private pending;
-    private sink?;
-    private confirmations;
-    private emit;
-    /** Presentation aggregation only: no duration threshold and no new execution gate. */
-    summarize(): void;
-    bind(sink: (detail: DetailObservation) => void): void;
-    run<T>(phase: Stage, operation: () => Promise<T>): Promise<T>;
-}

package/dist/stage-timing.js

@@ -1,61 +0,0 @@
-export const STAGES = Object.freeze({
-    'login-ready': '登录就绪检查', 'connection-confirm': '核对当前连接状态', 'input-prepare': '准备本轮输入', 'workspace-resolve': '解析工作区',
-    'details-open': '打开技术详情', 'details-flush': '等待技术详情持久确认', 'workspace-notice': '记录工作区说明',
-    'broker-list': '查询主机会话', 'broker-start': '启动主机会话', 'broker-attach': '连接主机会话',
-    'acp-initialize': '初始化远程模型', 'acp-session-new': '新建模型会话',
-    'acp-session-load': '加载模型会话', 'acp-session-resume': '恢复模型会话',
-    'acp-prompt': '模型处理本轮（含等待审批）',
-});
-/** Passive client observations; no thresholds, retries, or remote-clock claims. */
-export class StageTiming {
-    started = performance.now();
-    pending = [];
-    sink;
-    confirmations = { count: 0, total: 0, min: Infinity, max: 0, elapsed: 0 };
-    emit(detail) { if (this.sink)
-        this.sink(detail);
-    else
-        this.pending.push(detail); }
-    /** Presentation aggregation only: no duration threshold and no new execution gate. */
-    summarize() {
-        const current = this.confirmations;
-        if (!current.count)
-            return;
-        this.confirmations = { count: 0, total: 0, min: Infinity, max: 0, elapsed: 0 };
-        this.emit({ kind: 'session', severity: 'info', code: 'REMOTE_STAGE_TIMING', summary: STAGES['connection-confirm'] + '：' + current.count + '次，共' + current.total.toFixed(1) + '毫秒，最大' + current.max.toFixed(1) + '毫秒', payload: { phase: 'connection-confirm', count: current.count, totalDurationMs: current.total, minDurationMs: current.min, maxDurationMs: current.max, elapsedMs: current.elapsed, outcome: 'ok', clock: 'client-monotonic' } });
-    }
-    bind(sink) {
-        this.sink = sink;
-        const pending = this.pending;
-        this.pending = [];
-        for (const detail of pending)
-            sink(detail);
-    }
-    async run(phase, operation) {
-        const started = performance.now();
-        let outcome = 'failed';
-        try {
-            const result = await operation();
-            outcome = 'ok';
-            return result;
-        }
-        finally {
-            const ended = performance.now();
-            const durationMs = ended - started, elapsedMs = ended - this.started;
-            if (phase === 'connection-confirm' && outcome === 'ok') {
-                const current = this.confirmations;
-                current.count++;
-                current.total += durationMs;
-                current.min = Math.min(current.min, durationMs);
-                current.max = Math.max(current.max, durationMs);
-                current.elapsed = elapsedMs;
-            }
-            else {
-                if (phase !== 'connection-confirm')
-                    this.summarize();
-                const detail = { kind: 'session', severity: outcome === 'ok' ? 'info' : 'warning', code: 'REMOTE_STAGE_TIMING', summary: STAGES[phase] + '：' + durationMs.toFixed(1) + '毫秒', payload: { phase, durationMs, elapsedMs, outcome, clock: 'client-monotonic' } };
-                this.emit(detail);
-            }
-        }
-    }
-}

package/dist/workspace-notice.d.ts

@@ -1,47 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-import { type RequestMessage } from '@deepseek-ai/dsh-llm';
-import { type AgentDefinition } from './agents.ts';
-import type { ConnectApi, RuntimeRequest } from './provider.ts';
-import type { WorkspaceNotice, SessionProjectTarget } from './connect-contract.ts';
-/** X-owned adapter metadata; this is not a DSH renderer acknowledgement. */
-export interface WorkspaceNoticeMarker {
-    readonly kind: 'workspace-notice';
-    readonly version: 1;
-    readonly provider: string;
-    readonly loginProvider: 'claude' | 'codex';
-    readonly sessionId: string;
-    readonly noticeId: string;
-    readonly claimId: string;
-    readonly deliveryId: string;
-    readonly messageId: string;
-    readonly workspaceName: string;
-    readonly bindingId: string;
-    readonly workspaceId: string;
-}
-export declare function parseWorkspaceNoticeMarker(message: unknown): WorkspaceNoticeMarker | undefined;
-/** Only this plugin's complete, source-bound notice may be excluded from remote model history. */
-export declare function isWorkspaceNoticeMessage(message: unknown): boolean;
-/** A verified first block in the actual model reply, never a second final message. */
-export interface WorkspaceNoticePresentation {
-    readonly kind: 'workspace-notice';
-    readonly version: 2;
-    readonly provider: string;
-    readonly loginProvider: 'claude' | 'codex';
-    readonly sessionId: string;
-    readonly noticeId: string;
-    readonly claimId: string;
-    readonly workspaceName: string;
-    readonly bindingId: string;
-    readonly workspaceId: string;
-    readonly turn: number;
-    readonly step: number;
-    readonly blockIndex: 0;
-    readonly text: string;
-}
-export declare function workspaceNoticeFromMessage(message: unknown): WorkspaceNoticePresentation | undefined;
-/** Preserve the model answer and exact remote replay pointer; ordinary text is never searched. */
-export declare function withoutWorkspaceNotice<T extends RequestMessage>(message: T): T;
-export declare function createWorkspaceNoticeConsumer(ctx: Context, agent: AgentDefinition): {
-    reconcile: (request: RuntimeRequest, api: ConnectApi) => Promise<void>;
-    deliver: (notice: WorkspaceNotice, resolved: SessionProjectTarget, request: RuntimeRequest, api: ConnectApi) => Promise<WorkspaceNoticePresentation | undefined>;
-};