@myagentroam/node 0.1.2 → 0.1.4

package/dist/service/runner-interaction-service.js

@@ -0,0 +1,245 @@
+import { denyPermission } from '../claude-agent-sdk.js';
+import { boundedConversationItemId, claudeUserInputQuestions, isTerminalRunStatus } from '../runner/codex/conversation-parser.js';
+export class RunnerInteractionService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    requestClaudeApproval(runId, toolName, toolInput) {
+        const approvalId = `claude:${crypto.randomUUID()}`;
+        return new Promise((resolve) => {
+            const expiresAt = Date.now() + this.options.approvalTimeoutMs;
+            const settle = (decision) => resolve(decision === 'APPROVED'
+                ? { behavior: 'allow', updatedInput: toolInput }
+                : denyPermission());
+            try {
+                this.options.runtime.createApproval({
+                    runId,
+                    approvalId,
+                    payload: { toolName, input: toolInput },
+                    expiresAt
+                });
+            }
+            catch {
+                resolve(denyPermission('APPROVAL_STORE_FAILED'));
+                return;
+            }
+            const expire = () => {
+                const approvals = this.options.claude().execution.approvals;
+                const active = approvals.get(approvalId);
+                if (active === undefined)
+                    return;
+                try {
+                    this.options.runtime.expireApproval(approvalId);
+                }
+                catch (error) {
+                    if (error instanceof Error && error.message === 'APPROVAL_NOT_EXPIRED') {
+                        const timer = setTimeout(expire, Math.max(1, expiresAt - Date.now()));
+                        approvals.set(approvalId, { ...active, timer });
+                        return;
+                    }
+                }
+                approvals.delete(approvalId);
+                this.options.emitRun(active.runId, 'approval.expired', { approvalId });
+                resolve(denyPermission('APPROVAL_EXPIRED'));
+            };
+            const timer = setTimeout(expire, this.options.approvalTimeoutMs);
+            this.options.claude().execution.approvals.set(approvalId, {
+                runId,
+                timer,
+                resolve: settle
+            });
+            this.options.publishApproval({
+                runId,
+                approvalId,
+                payload: { toolName, input: toolInput },
+                expiresAt
+            });
+        });
+    }
+    requestClaudeUserInput(runId, toolInput, toolUseId) {
+        const questions = claudeUserInputQuestions(toolInput);
+        if (questions.length === 0)
+            return Promise.resolve(denyPermission('USER_INPUT_INVALID'));
+        const requestId = `claude:${runId}:${toolUseId}`;
+        return new Promise((resolve) => {
+            const input = { ...toolInput };
+            const timer = setTimeout(() => {
+                const pending = this.options.claude().execution.userInputs.get(requestId);
+                if (pending === undefined)
+                    return;
+                this.options.claude().execution.userInputs.delete(requestId);
+                pending.reject('USER_INPUT_EXPIRED');
+                this.options.emitItem(runId, {
+                    itemId: boundedConversationItemId('claude-input', requestId),
+                    kind: 'user_input_request',
+                    status: 'FAILED',
+                    payload: { requestId, questions },
+                    merge: true
+                });
+            }, this.options.approvalTimeoutMs);
+            this.options.claude().execution.userInputs.set(requestId, {
+                runId,
+                requestId,
+                questions,
+                input,
+                resolve: (answers) => resolve({ behavior: 'allow', updatedInput: { ...input, answers } }),
+                reject: (message = 'USER_INPUT_EXPIRED') => resolve(denyPermission(message)),
+                timer
+            });
+            this.options.emitItem(runId, {
+                itemId: boundedConversationItemId('claude-input', requestId),
+                kind: 'user_input_request',
+                status: 'PENDING',
+                payload: { requestId, questions }
+            });
+        });
+    }
+    deliverChannel(runner, sessionId, messageId, senderId, token, content) {
+        return this.options.runners
+            .require(runner)
+            .deliverChannel(sessionId, messageId, senderId, token, content, (runId, deliveredMessageId, delivery) => this.options.emitRun(runId, 'channel.delivery', {
+            messageId: deliveredMessageId,
+            delivery
+        }));
+    }
+    decideCodexApproval(approvalId, decision) {
+        const codex = this.options.codex();
+        const requestId = codex.execution.approvals.get(approvalId);
+        if (requestId === undefined)
+            return false;
+        try {
+            codex.respond(requestId, { decision: decision === 'APPROVED' ? 'accept' : 'decline' });
+        }
+        catch {
+            // A disconnected App Server cannot safely receive a late approval.
+        }
+        codex.execution.approvals.delete(approvalId);
+        return true;
+    }
+    decideClaudeApproval(approvalId, decision) {
+        const approvals = this.options.claude().execution.approvals;
+        const approval = approvals.get(approvalId);
+        if (approval === undefined)
+            return false;
+        clearTimeout(approval.timer);
+        approvals.delete(approvalId);
+        approval.resolve(decision);
+        return true;
+    }
+    cancelClaudeRun(runId, intent) {
+        const claudeRun = this.options.claude().execution.runs.get(runId);
+        if (claudeRun === undefined)
+            return false;
+        if (intent === 'CANCEL')
+            claudeRun.handle.cancel();
+        else
+            void claudeRun.handle.interrupt().then(() => {
+                const run = this.options.runtime.getRun(runId);
+                if (run !== undefined && !isTerminalRunStatus(run.status))
+                    this.options.emitRun(runId, 'run.completed', { status: 'INTERRUPTED' }, 'INTERRUPTED');
+            }, () => {
+                const run = this.options.runtime.getRun(runId);
+                if (run !== undefined && !isTerminalRunStatus(run.status))
+                    this.options.emitRun(runId, 'run.failed', { code: 'CLAUDE_INTERRUPT_FAILED' }, 'FAILED');
+            });
+        return true;
+    }
+    async cancelCodexTurn(runId, threadId, turnId, cwd, terminalStatus) {
+        const codex = this.options.codex();
+        try {
+            await codex.interruptTurn(threadId, turnId);
+            const run = this.options.runtime.getRun(runId);
+            if (run !== undefined && !isTerminalRunStatus(run.status))
+                this.options.emitRun(runId, 'run.completed', { status: terminalStatus }, terminalStatus);
+        }
+        catch {
+            const run = this.options.runtime.getRun(runId);
+            if (run !== undefined && !isTerminalRunStatus(run.status))
+                this.options.emitRun(runId, 'run.failed', { code: 'CODEX_INTERRUPT_FAILED' }, 'FAILED');
+        }
+        finally {
+            codex.execution.runs.delete(runId);
+            codex.releaseEnvironment(runId);
+            this.options.state.active.delete(runId);
+            void this.options.captureSnapshot(runId, cwd);
+        }
+    }
+    respondUserInput(runId, requestId, rawAnswers) {
+        if (this.options.codex().execution.userInputs.has(requestId)) {
+            this.respondCodexUserInput(runId, requestId, rawAnswers);
+            return;
+        }
+        const userInputs = this.options.claude().execution.userInputs;
+        const pending = userInputs.get(requestId);
+        if (pending === undefined || pending.runId !== runId)
+            throw new Error('USER_INPUT_NOT_FOUND');
+        const answers = {};
+        for (const question of pending.questions) {
+            const normalized = this.answers(rawAnswers[question.id], question.allowOther, (value) => question.options.some((option) => option.value === value));
+            if (!question.multiSelect && normalized.length !== 1)
+                throw new Error('USER_INPUT_INVALID');
+            answers[question.prompt] = normalized.join(', ');
+        }
+        clearTimeout(pending.timer);
+        userInputs.delete(requestId);
+        pending.resolve(answers);
+        this.options.emitItem(runId, {
+            itemId: boundedConversationItemId('claude-input', requestId),
+            kind: 'user_input_request',
+            status: 'COMPLETED',
+            payload: { requestId, questions: pending.questions },
+            merge: true
+        });
+    }
+    completeCancelledRun(runId, cwd) {
+        const run = this.options.runtime.getRun(runId);
+        if (run === undefined)
+            return false;
+        if (run.status === 'CANCELLING') {
+            const status = this.options.state.interruptRequested.has(runId) ? 'INTERRUPTED' : 'CANCELLED';
+            this.options.emitRun(runId, 'run.completed', { status }, status);
+        }
+        else if (!isTerminalRunStatus(run.status))
+            return false;
+        this.options.codex().execution.runs.delete(runId);
+        this.options.state.active.delete(runId);
+        if (cwd !== undefined)
+            void this.options.captureSnapshot(runId, cwd);
+        return true;
+    }
+    respondCodexUserInput(runId, requestId, rawAnswers) {
+        const codex = this.options.codex();
+        const pending = codex.execution.userInputs.get(requestId);
+        if (pending === undefined ||
+            pending.runId !== runId ||
+            this.options.runtime.getRun(runId) === undefined)
+            throw new Error('USER_INPUT_NOT_FOUND');
+        const answers = {};
+        for (const question of pending.questions)
+            answers[question.id] = {
+                answers: this.answers(rawAnswers[question.id], question.allowOther, (value) => question.options.includes(value))
+            };
+        codex.respond(pending.requestId, { answers });
+        codex.execution.userInputs.delete(requestId);
+        this.options.emitItem(runId, {
+            itemId: boundedConversationItemId('codex-input', requestId),
+            kind: 'user_input_request',
+            status: 'COMPLETED',
+            payload: { requestId, questions: [] },
+            merge: true
+        });
+    }
+    answers(raw, allowOther, supported) {
+        if (!Array.isArray(raw) || raw.length === 0 || raw.length > 8)
+            throw new Error('USER_INPUT_INVALID');
+        return raw.map((value) => {
+            if (typeof value !== 'string' || value.length === 0 || value.length > 500)
+                throw new Error('USER_INPUT_INVALID');
+            if (!allowOther && !supported(value))
+                throw new Error('USER_INPUT_INVALID');
+            return value;
+        });
+    }
+}
+//# sourceMappingURL=runner-interaction-service.js.map

package/dist/service/runner-interaction-service.js.map

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

package/dist/service/runner-service.d.ts

@@ -0,0 +1,43 @@
+import { type NodeCapabilities } from '@myagentroam/protocol';
+import type { NodeDatabase } from '../database.js';
+import type { NodeOperationHandler } from '../connector/node-operation-router.js';
+import type { RunnerRegistry } from '../runner/runner-registry.js';
+import type { RunnerUsageReader } from '../runner-usage.js';
+export declare class RunnerService {
+    private readonly database;
+    private readonly capabilities;
+    private readonly runners;
+    private readonly usage;
+    constructor(database: () => NodeDatabase, capabilities: () => NodeCapabilities, runners: RunnerRegistry, usage: RunnerUsageReader);
+    operations(): Readonly<Record<string, NodeOperationHandler>>;
+    profiles(): readonly {
+        runner: "codex" | "claude-code";
+        capabilities: string[];
+        models: {
+            id: string;
+            label: string;
+            supportedEfforts: string[];
+        }[];
+        accessOptions: {
+            id: string;
+            label: string;
+            description: string;
+        }[];
+        commands: {
+            available: boolean;
+            runner: "codex" | "claude-code";
+            reasonCode: string | null;
+            id: string;
+            label: string;
+            description: string;
+            inputHint: string;
+            source: "CODEX_APP_SERVER" | "CLAUDE_AGENT_SDK";
+            interaction: "RUNNER_TEXT" | "IMMEDIATE_ACTION" | "TOGGLE" | "VALUE";
+            stateLabel?: string | undefined;
+        }[];
+    }[];
+    private usageStatuses;
+    private readUsage;
+    private listProfiles;
+    private saveDefaults;
+}

package/dist/service/runner-service.js

@@ -0,0 +1,55 @@
+import { runnerDefaultConfigurationSchema } from '@myagentroam/protocol';
+export class RunnerService {
+    database;
+    capabilities;
+    runners;
+    usage;
+    constructor(database, capabilities, runners, usage) {
+        this.database = database;
+        this.capabilities = capabilities;
+        this.runners = runners;
+        this.usage = usage;
+    }
+    operations() {
+        return {
+            'runner.usage.status': () => this.usageStatuses(),
+            'runner.usage.read': (data) => this.readUsage(data),
+            'runner.profiles.list': () => this.listProfiles(),
+            'runner.defaults.save': (data) => this.saveDefaults(data)
+        };
+    }
+    profiles() {
+        return this.runners.profiles(this.capabilities());
+    }
+    async usageStatuses() {
+        return {
+            statuses: await Promise.all(this.runners
+                .advertised()
+                .map((runner) => this.usage.status(runner.name)))
+        };
+    }
+    async readUsage(data) {
+        const input = data;
+        const runner = this.runners.product(input.runner);
+        if (runner === undefined)
+            throw new Error('RUNNER_USAGE_INVALID');
+        return { usage: await this.usage.read(runner.name) };
+    }
+    listProfiles() {
+        return {
+            profiles: this.profiles(),
+            defaults: this.database()
+                .getRunnerDefaults()
+                .filter((value) => this.runners.supportsConfiguration(value))
+        };
+    }
+    saveDefaults(data) {
+        const parsed = runnerDefaultConfigurationSchema.safeParse(data);
+        if (!parsed.success)
+            throw new Error('RUNNER_DEFAULT_INVALID');
+        if (!this.runners.supportsConfiguration(parsed.data))
+            throw new Error('RUNNER_CONFIGURATION_UNSUPPORTED');
+        return { defaults: this.database().saveRunnerDefaults(parsed.data) };
+    }
+}
+//# sourceMappingURL=runner-service.js.map

package/dist/service/runner-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-service.js","sourceRoot":"","sources":["../../src/service/runner-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAyB,MAAM,uBAAuB,CAAC;AAMhG,MAAM,OAAO,aAAa;IAEL;IACA;IACA;IACA;IAJnB,YACmB,QAA4B,EAC5B,YAAoC,EACpC,OAAuB,EACvB,KAAwB;QAHxB,aAAQ,GAAR,QAAQ,CAAoB;QAC5B,iBAAY,GAAZ,YAAY,CAAwB;QACpC,YAAO,GAAP,OAAO,CAAgB;QACvB,UAAK,GAAL,KAAK,CAAmB;IACxC,CAAC;IAEJ,UAAU;QACR,OAAO;YACL,qBAAqB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE;YACjD,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YACnD,sBAAsB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE;YACjD,sBAAsB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;SAC1D,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,OAAO;YACL,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CACzB,IAAI,CAAC,OAAO;iBACT,UAAU,EAAE;iBACZ,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAA+B,CAAC,CAAC,CAC9E;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,IAAa;QACnC,MAAM,KAAK,GAAG,IAA+B,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAClE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACvD,CAAC;IAEO,YAAY;QAClB,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;iBACtB,iBAAiB,EAAE;iBACnB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;SAChE,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,IAAa;QAChC,MAAM,MAAM,GAAG,gCAAgC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACvE,CAAC;CACF"}

package/dist/service/session-catalog-service.d.ts

@@ -0,0 +1,30 @@
+import type { NodeOperationHandler } from '../connector/node-operation-router.js';
+import type { NodeAgentSession, NodeDatabase } from '../database.js';
+import type { NodeRuntimeState } from '../runtime-state.js';
+import type { ExternalSessionResumeService } from './external-session-resume-service.js';
+import type { NativeSessionProjectionService } from './native-session-projection-service.js';
+interface SessionCatalogServiceOptions {
+    readonly database: () => NodeDatabase;
+    readonly nodeId: () => string;
+    readonly runtime: NodeRuntimeState;
+    readonly projection: NativeSessionProjectionService;
+    readonly resume: ExternalSessionResumeService;
+    readonly cachedNative: () => readonly NodeAgentSession[];
+    readonly cachedWorkspace: (workspaceId: string) => Promise<readonly NodeAgentSession[]>;
+    readonly present: (session: NodeAgentSession) => NodeAgentSession;
+    readonly projectionForNative: (session: NodeAgentSession) => NodeAgentSession | undefined;
+    readonly nativeIds: (session: NodeAgentSession) => ReadonlySet<string>;
+    readonly forget: (session: NodeAgentSession, nativeIds: ReadonlySet<string>) => void;
+    readonly refreshActivity: (session: NodeAgentSession) => Promise<void>;
+    readonly externalActivity: (sessionId: string) => unknown;
+}
+export declare class SessionCatalogService {
+    private readonly options;
+    constructor(options: SessionCatalogServiceOptions);
+    operations(): Readonly<Record<string, NodeOperationHandler>>;
+    private list;
+    private mergePersisted;
+    private resume;
+    private remove;
+}
+export {};

package/dist/service/session-catalog-service.js

@@ -0,0 +1,145 @@
+import { removeNativeSession } from '../native-session-history.js';
+import { isTerminalRunStatus, sessionPage } from '../util/node-operation-parsers.js';
+export class SessionCatalogService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    operations() {
+        return {
+            'session.list': (data) => this.list(record(data)),
+            'session.resume': (data) => this.resume(record(data)),
+            'session.remove': (data) => this.remove(record(data))
+        };
+    }
+    async list(input) {
+        const workspaceId = typeof input.workspaceId === 'string' ? input.workspaceId : undefined;
+        const nativeSessions = workspaceId === undefined
+            ? this.options.cachedNative()
+            : await this.options.cachedWorkspace(workspaceId);
+        const native = nativeSessions.map((session) => this.options.present({ ...session, externalDiscovered: true }));
+        const projected = this.options.runtime
+            .listAgentSessions()
+            .filter((session) => session.nativeControl === 'MAR_MANAGED' ||
+            (session.nativeControl === 'EXTERNAL' && session.externalSessionId !== null))
+            .map((session) => {
+            const source = native.find((candidate) => this.options.projectionForNative(candidate)?.id === session.id);
+            return this.options.present(source === undefined
+                ? session
+                : {
+                    ...session,
+                    runnerTitle: source.runnerTitle,
+                    pinnedAt: source.pinnedAt,
+                    pinOrder: source.pinOrder ?? null,
+                    externalDiscovered: true,
+                    titleSource: session.customTitle === null ? source.titleSource : session.titleSource,
+                    lastActivityAt: source.lastActivityAt
+                });
+        });
+        const merged = new Map([
+            ...projected,
+            ...native.filter((candidate) => candidate.externalSessionId === null ||
+                this.options.projectionForNative(candidate) === undefined)
+        ].map((session) => [session.id, session]));
+        if (workspaceId !== undefined)
+            this.mergePersisted(merged, workspaceId);
+        const sessions = [...merged.values()];
+        return sessionPage(workspaceId === undefined
+            ? sessions
+            : sessions.filter((session) => session.workspaceId === workspaceId), input);
+    }
+    mergePersisted(merged, workspaceId) {
+        const database = this.options.database();
+        const workspace = database.getWorkspace(workspaceId);
+        if (workspace === undefined)
+            throw new Error('WORKSPACE_NOT_FOUND');
+        for (const persisted of database.listSessionRecords(workspaceId)) {
+            if (merged.has(persisted.id))
+                continue;
+            merged.set(persisted.id, this.options.present({
+                id: persisted.id,
+                nodeId: this.options.nodeId(),
+                workspaceId,
+                runner: persisted.runner,
+                externalSessionId: persisted.id,
+                nativeControl: 'EXTERNAL',
+                channelToken: null,
+                cwd: workspace.path,
+                model: persisted.metadata.model,
+                effort: persisted.metadata.effort,
+                access: persisted.metadata.access,
+                customTitle: persisted.metadata.customTitle,
+                runnerTitle: persisted.metadata.runnerTitle,
+                pinnedAt: persisted.pinOrder === null ? null : 1,
+                pinOrder: persisted.pinOrder,
+                externalDiscovered: false,
+                titleSource: persisted.metadata.customTitle === null ? 'RUNNER' : 'CUSTOM',
+                lastActivityAt: 0,
+                createdAt: 0
+            }));
+        }
+    }
+    async resume(input) {
+        if (typeof input.sessionId !== 'string')
+            throw new Error('SESSION_INVALID');
+        const value = this.options.runtime.getAgentSession(input.sessionId) ??
+            (await this.options.projection.resolve(input.sessionId));
+        if (value === undefined)
+            throw new Error('SESSION_NOT_FOUND');
+        if (value.nativeControl !== 'EXTERNAL')
+            return {
+                session: this.options.present(value),
+                delivery: this.options.resume.delivery(value)
+            };
+        const resumed = await this.options.resume.resume(value, true);
+        const failure = resumed === undefined ? this.options.resume.failure(value.id) : undefined;
+        return {
+            session: this.options.present(resumed ?? value),
+            delivery: resumed === undefined ? 'REJECTED' : 'RESUMABLE',
+            ...(resumed === undefined
+                ? {
+                    reasonCode: failure?.code ?? 'SESSION_RESUME_REJECTED',
+                    ...(failure?.detail === undefined ? {} : { reasonDetail: failure.detail })
+                }
+                : {})
+        };
+    }
+    async remove(input) {
+        if (typeof input.sessionId !== 'string')
+            throw new Error('SESSION_INVALID');
+        const session = this.options.runtime.getAgentSession(input.sessionId) ??
+            (await this.options.projection.resolve(input.sessionId));
+        if (session === undefined)
+            throw new Error('SESSION_NOT_FOUND');
+        if (session.externalSessionId === null)
+            throw new Error('NATIVE_TRANSCRIPT_UNAVAILABLE');
+        if (this.options.runtime
+            .listRunsForSession(session.id)
+            .some((run) => !isTerminalRunStatus(run.status)))
+            throw new Error('SESSION_ACTIVE');
+        if (session.nativeControl === 'EXTERNAL') {
+            await this.options.refreshActivity(session);
+            if (this.options.externalActivity(session.id) === 'EXTERNAL_ACTIVE')
+                throw new Error('SESSION_ACTIVE');
+        }
+        const nativeIds = this.options.nativeIds(session);
+        for (const externalSessionId of nativeIds) {
+            try {
+                await removeNativeSession(session.runner, session.cwd, externalSessionId);
+            }
+            catch (error) {
+                if (!(error instanceof Error) || error.message !== 'NATIVE_TRANSCRIPT_UNAVAILABLE')
+                    throw error;
+            }
+        }
+        this.options.database().deleteSessionRecord(session.id);
+        this.options.forget(session, nativeIds);
+        return { deleted: true };
+    }
+}
+function record(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    return value;
+}
+//# sourceMappingURL=session-catalog-service.js.map

package/dist/service/session-catalog-service.js.map

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

package/dist/service/session-command-service.d.ts

@@ -0,0 +1,23 @@
+import type { RunnerProfile } from '@myagentroam/protocol';
+import type { NodeOperationHandler } from '../connector/node-operation-router.js';
+import type { NodeAgentSession } from '../database.js';
+import type { NodeRuntimeState } from '../runtime-state.js';
+import type { RunnerRegistry } from '../runner/runner-registry.js';
+import type { ExternalSessionResumeService } from './external-session-resume-service.js';
+import type { NativeSessionProjectionService } from './native-session-projection-service.js';
+interface SessionCommandServiceOptions {
+    readonly runtime: NodeRuntimeState;
+    readonly runners: RunnerRegistry;
+    readonly projection: NativeSessionProjectionService;
+    readonly resume: ExternalSessionResumeService;
+    readonly profiles: () => readonly RunnerProfile[];
+    readonly present: (session: NodeAgentSession) => unknown;
+}
+export declare class SessionCommandService {
+    private readonly options;
+    constructor(options: SessionCommandServiceOptions);
+    operations(): Readonly<Record<string, NodeOperationHandler>>;
+    private runnerCommand;
+    private sessionCommand;
+}
+export {};

package/dist/service/session-command-service.js

@@ -0,0 +1,70 @@
+import { parseCommandInvocation } from '../runner-command-engine.js';
+import { isPlainRecord } from '../util/node-operation-parsers.js';
+import { parseSecretEnvironment } from '../util/secret-environment.js';
+export class SessionCommandService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    operations() {
+        return {
+            'runner.command.execute': (data) => this.runnerCommand(record(data)),
+            'session.command.execute': (data) => this.sessionCommand(record(data))
+        };
+    }
+    runnerCommand(input) {
+        const runner = this.options.runners.product(input.runner);
+        if (runner === undefined ||
+            typeof input.commandId !== 'string' ||
+            typeof input.input !== 'string')
+            throw new Error('RUNNER_COMMAND_INVALID');
+        try {
+            return runner.executeGlobalCommand(input.commandId, input.input);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message === 'RUNNER_COMMAND_INVALID')
+                throw error;
+            throw new Error('RUNNER_COMMAND_INVALID');
+        }
+    }
+    async sessionCommand(input) {
+        if (typeof input.sessionId !== 'string' ||
+            typeof input.commandId !== 'string' ||
+            input.commandId.length === 0 ||
+            typeof input.input !== 'string' ||
+            input.input.length < 2 ||
+            input.input.length > 20_000)
+            throw new Error('RUNNER_COMMAND_INVALID');
+        const resolved = this.options.runtime.getAgentSession(input.sessionId) ??
+            (await this.options.projection.resolve(input.sessionId));
+        if (resolved === undefined)
+            throw new Error('SESSION_NOT_FOUND');
+        const session = resolved.nativeControl === 'EXTERNAL' ? await this.options.resume.resume(resolved) : resolved;
+        if (session === undefined)
+            throw new Error('RUNNER_COMMAND_UNAVAILABLE');
+        const command = this.options
+            .profiles()
+            .find((profile) => profile.runner === session.runner)
+            ?.commands.find((candidate) => isPlainRecord(candidate) && candidate.id === input.commandId);
+        if (command?.available !== true)
+            throw new Error('RUNNER_COMMAND_UNAVAILABLE');
+        const invocation = parseCommandInvocation({ descriptor: command }, input.input);
+        const secretEnvironment = parseSecretEnvironment(input.secretEnvironment);
+        const runner = this.options.runners.product(session.runner);
+        if (runner === undefined)
+            throw new Error('RUNNER_COMMAND_UNAVAILABLE');
+        const result = await runner.executeCommand(session, command, invocation.input, {
+            secretEnvironment
+        });
+        return {
+            ...(isPlainRecord(result) ? result : { result }),
+            session: this.options.present(session)
+        };
+    }
+}
+function record(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    return value;
+}
+//# sourceMappingURL=session-command-service.js.map