maka-agent 0.2.0-dev.31.20260913 → 0.2.0-dev.32.20260914

package/node_modules/@maka/runtime/package.json

@@ -12,6 +12,7 @@
     "./builtin-tools": "./dist/builtin-tools.js",
     "./shell-tools": "./dist/shell-tools.js",
     "./shell-run-manager": "./dist/shell-run-manager.js",
+    "./background-task-health-tool": "./dist/background-task-health-tool.js",
     "./deep-research-tools": "./dist/deep-research-tools.js",
     "./durable-tool-result-projection": "./dist/durable-tool-result-projection.js",
     "./tool-artifacts": "./dist/tool-artifacts.js",
@@ -79,6 +80,8 @@
     "./plugin-composition-loader": "./dist/plugin-composition-loader.js",
     "./plugin-command-service": "./dist/plugin-command-service.js",
     "./plugin-data-services": "./dist/plugin-data-services.js",
+    "./plugin-executor-backend": "./dist/plugin-executor-backend.js",
+    "./plugin-executor-service": "./dist/plugin-executor-service.js",
     "./plugin-goal-service": "./dist/plugin-goal-service.js",
     "./plugin-lsp-service": "./dist/plugin-lsp-service.js",
     "./plugin-session-query-service": "./dist/plugin-session-query-service.js",

package/node_modules/@maka/runtime-host/dist/adapter/session-projector.js

@@ -58,12 +58,13 @@ export class RuntimeHostSessionProjector {
                     replacing: false,
                 });
             }
-            if (message.text) {
+            if (message.text || message.interrupted) {
                 this.#accumulators.set(accumulatorKey('text', message.id), {
                     kind: 'text',
                     turnId: root.turnId,
                     messageId: message.id,
                     text: message.text,
+                    ...(message.interrupted ? { interrupted: true } : {}),
                     complete: true,
                     replacing: false,
                 });
@@ -194,7 +195,7 @@ export class RuntimeHostSessionProjector {
                     text: message.thinking.text,
                 });
             }
-            if (message.text) {
+            if (message.text || message.interrupted) {
                 events.push({
                     type: 'text_complete',
                     id: `${terminal.id}:text:${message.id}`,
@@ -202,6 +203,7 @@ export class RuntimeHostSessionProjector {
                     messageId: message.id,
                     ts: terminal.ts,
                     text: message.text,
+                    ...(message.interrupted ? { interrupted: true } : {}),
                 });
             }
         }
@@ -290,6 +292,7 @@ export class RuntimeHostSessionProjector {
                 turnId: delta.turnId,
                 messageId: delta.messageId,
                 text: folded.text,
+                ...(delta.interrupted ? { interrupted: true } : {}),
                 complete: delta.complete === true,
                 replacing: delta.complete === true ? false : replacing,
             });
@@ -301,6 +304,7 @@ export class RuntimeHostSessionProjector {
                     messageId: delta.messageId,
                     ts: this.#now(),
                     text: folded.text,
+                    ...(delta.interrupted ? { interrupted: true } : {}),
                 });
             }
             else if (folded.tail && !replacing) {
@@ -404,6 +408,7 @@ export class RuntimeHostSessionProjector {
                 messageId: accumulator.messageId,
                 ts: this.#now(),
                 text: accumulator.text,
+                ...(accumulator.interrupted ? { interrupted: true } : {}),
             });
         }
         if (root.status === 'completed') {

package/node_modules/@maka/runtime-host/dist/client/session-catalog-summary.js

@@ -54,6 +54,7 @@ export function projectSessionCatalogSummary(session) {
         ...(session.revisionIndex === undefined ? {} : { revisionIndex: session.revisionIndex }),
         ...(session.revisionState === undefined ? {} : { revisionState: session.revisionState }),
         backend: session.backend,
+        ...(session.executorId ? { executorId: session.executorId } : {}),
         ...(session.llmConnectionId === null ? {} : { llmConnectionId: session.llmConnectionId }),
         llmConnectionSlug: session.llmConnectionSlug,
         connectionLocked: session.connectionLocked,

package/node_modules/@maka/runtime-host/dist/protocol/external-session.js

@@ -16,7 +16,8 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-import { requireCount, requireEncodedByteLimit, requireEntityId, requireExactRecord, requireShapedRecord, requireUtf8String, } from './codec.js';
+import { EXTERNAL_SESSION_LIMIT_KINDS, } from '@maka/core/external-session';
+import { requireCount, requireEncodedByteLimit, requireEntityId, requireExactRecord, requireRecord, requireShapedRecord, requireUtf8String, } from './codec.js';
 import { invalidProtocolFrame } from './errors.js';
 import { defineHostPathOperation, defineOperation } from './operation-spec.js';
 import { decodeSessionCatalogItem } from './session-catalog.js';
@@ -129,8 +130,28 @@ export function decodeExternalSessionImportInput(value) {
     return { adapterId: adapterId(input.adapterId), sourceSessionId };
 }
 export function decodeExternalSessionImportResult(value) {
-    const result = requireExactRecord(value, 'external Session import result', ['session']);
-    const decoded = { session: decodeSessionCatalogItem(result.session) };
+    const result = requireRecord(value, 'external Session import result');
+    if (result.kind === 'source_limit_exceeded') {
+        requireExactRecord(result, 'external Session import limit result', ['kind', 'limit']);
+        const limit = requireExactRecord(result.limit, 'external Session import limit', [
+            'kind',
+            'max',
+        ]);
+        if (!EXTERNAL_SESSION_LIMIT_KINDS.some((kind) => kind === limit.kind)) {
+            throw invalidProtocolFrame('Invalid external Session import limit kind');
+        }
+        const max = requireCount(limit.max, 'external Session import limit maximum');
+        if (max === 0)
+            throw invalidProtocolFrame('Invalid external Session import limit maximum');
+        return {
+            kind: 'source_limit_exceeded',
+            limit: { kind: limit.kind, max },
+        };
+    }
+    if (result.kind !== 'imported')
+        throw invalidProtocolFrame('Invalid external Session import result kind');
+    requireExactRecord(result, 'external Session import result', ['kind', 'session']);
+    const decoded = { kind: 'imported', session: decodeSessionCatalogItem(result.session) };
     requireEncodedByteLimit(decoded, 'external Session import result', EXTERNAL_SESSION_RESULT_MAX_BYTES);
     return decoded;
 }

package/node_modules/@maka/runtime-host/dist/protocol/index.js

@@ -62,7 +62,10 @@ export const RUNTIME_HOST_REGISTRATION_SCHEMA_VERSION = 1;
 export const RUNTIME_HOST_PROTOCOL_VERSION = 0;
 // Increment when the same protocol version no longer guarantees safe Client-Host
 // interoperability. Mismatches are rejected before domain commands are admitted.
-export const RUNTIME_HOST_COMPATIBILITY_EPOCH = 151;
+export const RUNTIME_HOST_COMPATIBILITY_EPOCH = 154;
+// 154: External Session import results distinguish committed Sessions from typed source limits.
+// 153: Sessions may select plugin executors and Plugin Platform queries expose them.
+// 152: Assistant completions and transcript rows preserve interrupted responses.
 // 151: WorkHub selects and delegates through a durable Host Form interaction.
 // 150: Message admission accepts an empty-text Message that carries a quote or
 // an attachment (#4804). Peers older than this epoch reject that frame at

package/node_modules/@maka/runtime-host/dist/protocol/plugin-platform.js

@@ -108,7 +108,7 @@ export const PLUGIN_PLATFORM_OPERATION_SPECS = {
 };
 function decodePluginPlatformQueryInput(value) {
     const input = requireShapedRecord(value, 'Plugin Platform query input', ['view'], ['rootId', 'cursor', 'limit']);
-    if (!['status', 'packages', 'entries', 'tools', 'commands', 'failures'].includes(input.view)) {
+    if (!['status', 'packages', 'entries', 'tools', 'commands', 'executors', 'failures'].includes(input.view)) {
         throw invalidProtocolFrame('Invalid Plugin Platform query view');
     }
     const view = input.view;
@@ -125,8 +125,12 @@ function decodePluginPlatformQueryInput(value) {
         (input.rootId !== undefined || cursor !== undefined || limit !== undefined)) {
         throw invalidProtocolFrame('Plugin Platform status query does not accept paging');
     }
-    if (input.rootId !== undefined && view !== 'entries' && view !== 'tools' && view !== 'commands') {
-        throw invalidProtocolFrame('Plugin root identity is only valid for Entry, Tool, and Command queries');
+    if (input.rootId !== undefined &&
+        view !== 'entries' &&
+        view !== 'tools' &&
+        view !== 'commands' &&
+        view !== 'executors') {
+        throw invalidProtocolFrame('Plugin root identity is only valid for Entry, Tool, Command, and Executor queries');
     }
     let rootId;
     if (input.rootId !== undefined) {
@@ -190,7 +194,7 @@ function decodePluginPlatformQueryResult(value) {
         ]);
         if (!Array.isArray(output.items) ||
             output.items.length > 64 ||
-            !['packages', 'entries', 'tools', 'commands', 'failures'].includes(view)) {
+            !['packages', 'entries', 'tools', 'commands', 'executors', 'failures'].includes(view)) {
             throw invalidProtocolFrame('Invalid Plugin Platform page');
         }
         const nextCursor = output.nextCursor === null
@@ -205,7 +209,9 @@ function decodePluginPlatformQueryResult(value) {
                         ? { view, items: output.items.map(decodeToolInspection), nextCursor }
                         : view === 'commands'
                             ? { view, items: output.items.map(decodeCommandInspection), nextCursor }
-                            : { view: 'failures', items: output.items.map(decodePlatformFailure), nextCursor };
+                            : view === 'executors'
+                                ? { view, items: output.items.map(decodeExecutorInspection), nextCursor }
+                                : { view: 'failures', items: output.items.map(decodePlatformFailure), nextCursor };
     }
     requireEncodedByteLimit(decoded, 'Plugin Platform query result', PLUGIN_PLATFORM_QUERY_RESULT_MAX_BYTES);
     return decoded;
@@ -233,6 +239,37 @@ function decodeCommandInspection(value) {
         aliases: item.aliases.map((alias) => requireString(alias, 'Plugin Command alias', 128)),
     };
 }
+function decodeExecutorInspection(value) {
+    const item = requireExactRecord(value, 'Plugin Executor inspection', [
+        'entryId',
+        'scopeId',
+        'extensionId',
+        'generation',
+        'id',
+        'displayName',
+        'capabilities',
+    ]);
+    const capabilities = requireExactRecord(item.capabilities, 'Plugin Executor capabilities', [
+        'thinking',
+        'toolActivity',
+    ]);
+    if (typeof capabilities.thinking !== 'boolean' ||
+        typeof capabilities.toolActivity !== 'boolean') {
+        throw invalidProtocolFrame('Invalid Plugin Executor capabilities');
+    }
+    return {
+        entryId: requireId(item.entryId, 'Plugin Entry identity'),
+        scopeId: requireString(item.scopeId, 'Plugin scope identity', 256),
+        extensionId: requireId(item.extensionId, 'Plugin package identity'),
+        generation: requireCount(item.generation, 'Plugin generation'),
+        id: requireString(item.id, 'Plugin Executor id', 128),
+        displayName: requireString(item.displayName, 'Plugin Executor display name', 256),
+        capabilities: {
+            thinking: capabilities.thinking,
+            toolActivity: capabilities.toolActivity,
+        },
+    };
+}
 function decodePlatformFailure(value) {
     const failure = requireShapedRecord(value, 'Plugin Platform failure', ['diagnostic'], ['entryId', 'extensionId']);
     if (failure.entryId === undefined && failure.extensionId === undefined) {

package/node_modules/@maka/runtime-host/dist/protocol/session-catalog.js

@@ -22,6 +22,7 @@ import { isPermissionMode } from '@maka/core/permission';
 import { isSessionStartMode } from '@maka/core/session-start-mode';
 import { isSessionBlockedReason, isSessionToolProfile, } from '@maka/core/session';
 import { isThinkingLevel } from '@maka/core/model-thinking';
+import { isExecutorId } from '@maka/core/executor-id';
 import { assertAllowedKeys, requireCount, requireEncodedByteLimit, requireEntityId, requireExactRecord, requireRecord, requireShapedRecord, requireUtf8String, } from './codec.js';
 import { invalidProtocolFrame } from './errors.js';
 import { defineHostPathOperation, defineOperation } from './operation-spec.js';
@@ -92,6 +93,7 @@ const PROJECTION_FIELDS = [
     'revisionOfTurnId',
     'revisionIndex',
     'revisionState',
+    'executorId',
     'thinkingLevel',
     'lastReadMessageId',
     'liveRunState',
@@ -243,23 +245,33 @@ export function decodeSessionCatalogQueryInput(value) {
     throw invalidProtocolFrame('Invalid Session catalog query kind');
 }
 export function decodeSessionCreateInput(value) {
-    const input = requireShapedRecord(value, 'Session create input', ['sessionId', 'workspace', 'modelTarget'], [
+    const input = requireShapedRecord(value, 'Session create input', ['sessionId', 'workspace'], [
         'mode',
         'name',
         'labels',
+        'modelTarget',
+        'executorId',
         'thinkingLevel',
         'toolProfile',
         'permissionMode',
         'collaborationMode',
         'orchestrationMode',
     ]);
+    const executorId = Object.hasOwn(input, 'executorId')
+        ? executorIdValue(input.executorId)
+        : undefined;
+    const target = Object.hasOwn(input, 'modelTarget') ? modelTarget(input.modelTarget) : undefined;
+    if ((executorId === undefined) === (target === undefined)) {
+        throw invalidProtocolFrame('Session creation requires exactly one model target or executor id');
+    }
     return {
         sessionId: requireEntityId(input.sessionId, 'sessionId'),
         workspace: decodeWorkspaceTarget(input.workspace),
         ...(Object.hasOwn(input, 'mode') ? { mode: sessionStartMode(input.mode) } : {}),
         ...(Object.hasOwn(input, 'name') ? { name: sessionName(input.name) } : {}),
         ...(Object.hasOwn(input, 'labels') ? { labels: labels(input.labels) } : {}),
-        modelTarget: modelTarget(input.modelTarget),
+        ...(target ? { modelTarget: target } : {}),
+        ...(executorId ? { executorId } : {}),
         ...(Object.hasOwn(input, 'thinkingLevel')
             ? { thinkingLevel: thinkingLevel(input.thinkingLevel) }
             : {}),
@@ -465,6 +477,7 @@ export function decodeSessionCatalogProjection(value) {
         ...optionalRevisionIndex(record),
         ...optionalRevisionState(record),
         backend: backend(record.backend),
+        ...optionalExecutorId(record),
         llmConnectionId: record.llmConnectionId === null
             ? null
             : requireEntityId(record.llmConnectionId, 'Session Connection id'),
@@ -476,6 +489,9 @@ export function decodeSessionCatalogProjection(value) {
         collaborationMode: collaborationMode(record.collaborationMode),
         orchestrationMode: orchestrationMode(record.orchestrationMode),
     };
+    if ((projection.backend === 'plugin-executor') !== (projection.executorId !== undefined)) {
+        throw invalidProtocolFrame('Session executor identity does not match its backend');
+    }
     requireEncodedByteLimit(projection, 'Session catalog projection', SESSION_CATALOG_RESULT_MAX_BYTES);
     return projection;
 }
@@ -631,11 +647,23 @@ function optionalThinkingLevel(record) {
 // header's durable backend, and rows written by builds that shipped
 // FakeBackend still hold it (#3211).
 function backend(value) {
-    if (value !== 'ai-sdk' && value !== 'fake') {
+    if (value !== 'ai-sdk' && value !== 'plugin-executor' && value !== 'fake') {
         throw invalidProtocolFrame('Invalid Session backend');
     }
     return value;
 }
+function executorIdValue(value) {
+    const id = requireUtf8String(value, 'Executor id', 128);
+    if (!isExecutorId(id)) {
+        throw invalidProtocolFrame('Invalid Executor id');
+    }
+    return id;
+}
+function optionalExecutorId(record) {
+    if (record.executorId === undefined)
+        return {};
+    return { executorId: executorIdValue(record.executorId) };
+}
 function thinkingLevel(value) {
     if (!isThinkingLevel(value))
         throw invalidProtocolFrame('Invalid Session thinking level');

package/node_modules/@maka/runtime-host/dist/protocol/session-continuity.js

@@ -452,6 +452,7 @@ function decodeAssistantDelta(value) {
         'text',
         'reset',
         'complete',
+        'interrupted',
     ]);
     assertRequiredKeys(record, 'Session assistant delta', [
         'kind',
@@ -467,6 +468,10 @@ function decodeAssistantDelta(value) {
     if (record.complete !== undefined && record.complete !== true) {
         throw invalidProtocolFrame('Invalid Session assistant delta completion');
     }
+    if (record.interrupted !== undefined &&
+        (record.interrupted !== true || record.complete !== true)) {
+        throw invalidProtocolFrame('Interrupted assistant delta must be complete');
+    }
     if (record.reset !== undefined && record.reset !== true) {
         throw invalidProtocolFrame('Invalid Session assistant delta reset');
     }
@@ -487,6 +492,7 @@ function decodeAssistantDelta(value) {
             : requireUtf8BoundedString(record.text, 'Session assistant delta text', SESSION_LIVE_DELTA_MAX_BYTES),
         ...(record.reset === true ? { reset: true } : {}),
         ...(record.complete === true ? { complete: true } : {}),
+        ...(record.interrupted === true ? { interrupted: true } : {}),
     };
 }
 function decodeSessionFrameEvent(value) {

package/node_modules/@maka/runtime-host/dist/server/child-agent-composition.js

@@ -43,6 +43,7 @@ export function bindHostChildAgentBackend(authority, parentSessionId) {
             },
             agentProfile: input.agentProfile,
             ...(input.subagentId ? { subagentId: input.subagentId } : {}),
+            ...(input.executorId ? { executorId: input.executorId } : {}),
             prompt: input.prompt,
             ...(input.swarm ? { swarm: input.swarm } : {}),
             abortSignal: input.abortSignal,

package/node_modules/@maka/runtime-host/dist/server/execution-artifacts.js

@@ -101,7 +101,7 @@ export function createHostExecutionArtifactServices(input) {
             archiveToolResult: prepareLedgerForCommit,
             readArchivedToolResultResource: (event) => event.storage === 'ledger' || event.storage === 'event'
                 ? (readLedgerResource?.(event) ?? { ok: false, reason: 'read_failed' })
-                : readArchive(input.artifacts, event),
+                : { ok: false, reason: 'read_failed' },
         }),
     };
     return Object.freeze(services);
@@ -160,24 +160,3 @@ async function readBoundedSourceFile(cwd, sourcePath) {
 function contentBytes(content) {
     return typeof content === 'string' ? Buffer.byteLength(content, 'utf8') : content.byteLength;
 }
-async function readArchive(artifacts, event) {
-    const entry = await artifacts.getInSession(event.sessionId, event.artifactId);
-    const record = entry.record;
-    if (!record)
-        return { ok: false, reason: 'not_found' };
-    if (record.source !== 'tool_result_archive')
-        return { ok: false, reason: 'source_mismatch' };
-    if (record.sizeBytes !== event.originalBytes)
-        return { ok: false, reason: 'size_mismatch' };
-    const read = await artifacts.readTextInSession(event.sessionId, event.artifactId, {
-        maxBytes: event.maxBytes ?? event.originalBytes,
-    });
-    if (!read.ok)
-        return read;
-    if (sha256(read.text) !== event.bodySha256)
-        return { ok: false, reason: 'corrupt' };
-    return { ok: true, serializedResult: read.text };
-}
-function sha256(text) {
-    return createHash('sha256').update(text).digest('hex');
-}

package/node_modules/@maka/runtime-host/dist/server/execution-composition.js

@@ -51,6 +51,8 @@ import { PluginAttachmentService } from '@maka/runtime/plugin-attachment-service
 import { PluginApprovalService } from '@maka/runtime/plugin-approval-service';
 import { PluginFilesystemService } from '@maka/runtime/plugin-fs-service';
 import { PluginLlmService } from '@maka/runtime/plugin-llm-service';
+import { PluginExecutorBackend } from '@maka/runtime/plugin-executor-backend';
+import { PluginExecutorService } from '@maka/runtime/plugin-executor-service';
 import { PluginShellService } from '@maka/runtime/plugin-shell-service';
 import { PluginUserQuestionService } from '@maka/runtime/plugin-user-question-service';
 import { PluginWebService } from '@maka/runtime/plugin-web-service';
@@ -153,6 +155,7 @@ import { HostWorkHubCoordinationCoordinator } from './workhub-coordination-coord
 import { WorkHubActionEffectFailure, workHubResumedTurnId, } from './workhub-coordination-action-gate.js';
 import { createHostWebSearchService, createHostWebSearchToolFromService, resolveHostTavilyWebSearchReadiness, shouldResolveHostTavilyWebSearchReadiness, } from './web-search-tool.js';
 import { createHostWebFetchService, createHostWebFetchToolFromService } from './web-fetch-tool.js';
+import { buildBackgroundTaskHealthTool } from '@maka/runtime/background-task-health-tool';
 import { createHostExecutionArtifactServices } from './execution-artifacts.js';
 import { openToolResultArchiveEvidenceReader } from '@maka/storage/tool-result-archive-evidence';
 import { createRuntimeHostWorkspaceExecutionComposition, RuntimeHostWorkspaceExecutionError, } from './workspace-execution-composition.js';
@@ -198,6 +201,7 @@ export async function createExecutionRuntimeHostComposition(context, options = {
     let goalExecutions;
     let pluginPlatform;
     let manager;
+    let invalidatePluginExecutorBackends = () => undefined;
     let modelMetadataRefresh;
     let archiveEvidence;
     try {
@@ -208,6 +212,11 @@ export async function createExecutionRuntimeHostComposition(context, options = {
         new PluginUserQuestionService(pluginRoot, pluginAgents);
         const pluginFilesystem = new PluginFilesystemService(pluginRoot, pluginAgents);
         const pluginLlm = new PluginLlmService(pluginRoot, pluginAgents);
+        const pluginExecutors = new PluginExecutorService(pluginRoot, {
+            // Retirement aborts its generation before backend disposal begins, so the
+            // terminal event preserves executor-retired instead of looking like Stop.
+            onChanged: () => queueMicrotask(invalidatePluginExecutorBackends),
+        });
         const pluginShellEnv = new PluginShellEnvService(pluginRoot);
         const pluginShell = new PluginShellService(pluginRoot, pluginAgents, pluginShellEnv);
         const pluginWeb = new PluginWebService(pluginRoot, pluginAgents);
@@ -231,6 +240,7 @@ export async function createExecutionRuntimeHostComposition(context, options = {
             tools: pluginTools,
             systemPrompt: pluginSystemPrompt,
             commands: pluginCommands,
+            executors: pluginExecutors,
         });
         const pluginPlatformCoordinator = new HostPluginPlatformCoordinator(pluginPlatform);
         const openedProjectCatalog = storage.projectCatalog;
@@ -457,6 +467,7 @@ export async function createExecutionRuntimeHostComposition(context, options = {
         const webFetchService = createHostWebFetchService({
             policy: runtimePolicyStores.operations,
         });
+        const backgroundTaskHealthTool = buildBackgroundTaskHealthTool(runtimeResources, webFetchService);
         pluginWeb.bindRuntime({
             search: ({ query, limit, abortSignal }) => webSearchService.search({ query, limit, ...(abortSignal ? { abortSignal } : {}) }),
             fetch: (input) => webFetchService.fetch(input),
@@ -479,6 +490,7 @@ export async function createExecutionRuntimeHostComposition(context, options = {
         const childHostTools = [
             createHostWebSearchToolFromService(webSearchService),
             createHostWebFetchToolFromService(webFetchService),
+            backgroundTaskHealthTool,
             ...runtimePolicy.modelTools,
         ];
         const hostTools = [...childHostTools, ...historyTools];
@@ -751,6 +763,23 @@ export async function createExecutionRuntimeHostComposition(context, options = {
         backends.register('ai-sdk', dependencies.primaryBackendFactory ?? {
             prepare: (backendContext) => prepareHostAiSdkBackend(hostAiSdkBackendInput(backendContext)),
         });
+        backends.register('plugin-executor', {
+            prepare: async (backendContext) => {
+                const executorId = backendContext.header.executorId;
+                if (!executorId)
+                    throw new Error('Plugin executor Session is missing its executor id');
+                const binding = pluginExecutors.bind(backendContext.sessionId, executorId);
+                return {
+                    providerStateIdentity: binding.providerStateIdentity,
+                    build: (factoryContext) => new PluginExecutorBackend({
+                        sessionId: factoryContext.sessionId,
+                        cwd: factoryContext.header.cwd,
+                        ...(factoryContext.systemPrompt ? { instructions: factoryContext.systemPrompt } : {}),
+                        binding,
+                    }),
+                };
+            },
+        });
         const runtimeAuthority = {
             bindRun: (identity) => messages.bindRun(identity),
             executeRoot: (input) => executeHostedExecutionToSettlement(requireRootCoordinator(rootCoordinator), input),
@@ -793,6 +822,8 @@ export async function createExecutionRuntimeHostComposition(context, options = {
         };
         resolveAvailableToolNames = async (sessionId) => {
             const header = await stores.sessionStore.readHeaderSnapshot(sessionId);
+            if (header.backend === 'plugin-executor')
+                return [];
             if (header.subagentRuntime) {
                 if (!header.subagentParent) {
                     throw new Error('Subagent runtime snapshot requires a linked child session');
@@ -970,6 +1001,12 @@ export async function createExecutionRuntimeHostComposition(context, options = {
             toolBoundaryProtocol: stores.runtimeEventStore.toolBoundaryProtocol,
             backends,
             subagentCatalog,
+            assertChildExecutorAvailable: (parentSessionId, executorId) => {
+                const identity = pluginExecutors.identity(parentSessionId, executorId);
+                if (identity.scopeId !== 'profile') {
+                    throw new Error(`Session-scoped executor cannot be inherited by a child Session: ${executorId}`);
+                }
+            },
             newId: randomUUID,
             now: Date.now,
             safeBoundaryResumeEnabled: process.env.MAKA_RUNTIME_SAFE_BOUNDARY_RESUME === '1',
@@ -1052,6 +1089,7 @@ export async function createExecutionRuntimeHostComposition(context, options = {
         const registerBackendInvalidation = () => {
             observeBackendInvalidation(requireSessionManager(manager).refreshIdleBackends());
         };
+        invalidatePluginExecutorBackends = registerBackendInvalidation;
         const registerConfigurationMutation = () => {
             hostChanges.publishConfiguration();
             registerBackendInvalidation();
@@ -1263,6 +1301,7 @@ export async function createExecutionRuntimeHostComposition(context, options = {
                 return new Promise((resolve, reject) => {
                     void spawn({
                         agentProfile: options.agentProfile ?? 'implementation',
+                        ...(options.executorId ? { executorId: options.executorId } : {}),
                         prompt: options.prompt,
                         ...(options.signal ? { abortSignal: options.signal } : {}),
                         onReady: (ready) => resolve({
@@ -1512,6 +1551,9 @@ export async function createExecutionRuntimeHostComposition(context, options = {
             continuity: continuityCoordinator,
             workspaceResolver,
             requestDrain: context.requestDrain,
+            assertExecutorAvailable: (sessionId, executorId) => {
+                pluginExecutors.identity(sessionId, executorId);
+            },
             ...(context.sessionAccessAuthority
                 ? { sessionAccessAuthority: context.sessionAccessAuthority }
                 : {}),
@@ -1659,14 +1701,18 @@ export async function createExecutionRuntimeHostComposition(context, options = {
                             sessionId: input.targetSessionId,
                             workspace: input.create.workspace,
                             name: input.create.title,
-                            modelTarget: input.create.defaults?.model
-                                ? {
-                                    kind: 'explicit',
-                                    connectionId: input.create.defaults.model.llmConnectionId,
-                                    connectionSlug: input.create.defaults.model.llmConnectionSlug,
-                                    model: input.create.defaults.model.model,
-                                }
-                                : { kind: 'default' },
+                            ...(input.create.defaults?.executorId
+                                ? { executorId: input.create.defaults.executorId }
+                                : {
+                                    modelTarget: input.create.defaults?.model
+                                        ? {
+                                            kind: 'explicit',
+                                            connectionId: input.create.defaults.model.llmConnectionId,
+                                            connectionSlug: input.create.defaults.model.llmConnectionSlug,
+                                            model: input.create.defaults.model.model,
+                                        }
+                                        : { kind: 'default' },
+                                }),
                             ...(input.create.defaults?.permissionMode
                                 ? { permissionMode: input.create.defaults.permissionMode }
                                 : {}),

package/node_modules/@maka/runtime-host/dist/server/external-session-coordinator.js

@@ -17,6 +17,7 @@
  * under the License.
  */
 import { JsonArrayPageBudget } from './json-array-page-budget.js';
+import { ExternalSessionLimitError, } from '@maka/core/external-session';
 import { ExternalSessionImporter } from '@maka/storage/external-sessions';
 import { EXTERNAL_SESSION_CWD_MAX_BYTES, EXTERNAL_SESSION_IMPORTED_SESSION_IDS_MAX_ITEMS, EXTERNAL_SESSION_NAME_MAX_BYTES, EXTERNAL_SESSION_PAGE_MAX_ITEMS, EXTERNAL_SESSION_RESULT_MAX_BYTES, EXTERNAL_SESSION_SOURCE_MAX_ITEMS, EXTERNAL_SESSION_SOURCE_SESSION_ID_MAX_BYTES, } from '../protocol/index.js';
 import { projectSessionCatalogRecord, SessionOperationFailure, NoUsableImportModelError, } from './session-catalog-coordinator.js';
@@ -198,6 +199,15 @@ export class HostExternalSessionCoordinator {
         }
         catch (error) {
             if (!commitAttempted) {
+                if (error instanceof ExternalSessionLimitError) {
+                    return {
+                        ok: true,
+                        result: {
+                            kind: 'source_limit_exceeded',
+                            limit: { kind: error.limit.kind, max: error.limit.max },
+                        },
+                    };
+                }
                 return importFailure(isSourceSessionNotFound(error) ? 'not_found' : 'source_unreadable', isSourceSessionNotFound(error)
                     ? 'External Session does not exist'
                     : 'External Session could not be read or converted');
@@ -218,7 +228,10 @@ export class HostExternalSessionCoordinator {
         }
         try {
             const record = await this.#sessions.readCatalogRecord(header.id);
-            return { ok: true, result: { session: projectSessionCatalogRecord(record) } };
+            return {
+                ok: true,
+                result: { kind: 'imported', session: projectSessionCatalogRecord(record) },
+            };
         }
         catch {
             this.#requestDrain();

package/node_modules/@maka/runtime-host/dist/server/host-session-availability.js

@@ -23,6 +23,11 @@ const IMPORT_STAGING_UNAVAILABLE_REASON = 'Imported Session history is still bei
 export const WORKHUB_COORDINATION_EXECUTION_UNAVAILABLE_REASON = 'WorkHub Coordination Session execution requires WorkHub authority';
 export const WORKHUB_COORDINATION_TARGET_UNAVAILABLE_REASON = 'WorkHub Coordination execution requires the reserved Coordination Session';
 export const LEGACY_CONNECTION_IDENTITY_EXECUTION_UNAVAILABLE_REASON = 'This Session requires an explicit account selection before it can run.';
+export const PLUGIN_EXECUTOR_CONTINUATION_UNAVAILABLE_REASON = 'Plugin executor Sessions cannot resume without provider-owned durable continuation support.';
+export const PLUGIN_EXECUTOR_COPY_UNAVAILABLE_REASON = 'Plugin executor Sessions cannot be copied without provider-owned conversation cloning';
+export function runtimeHostConversationCopyUnavailableReason(header) {
+    return header.backend === 'plugin-executor' ? PLUGIN_EXECUTOR_COPY_UNAVAILABLE_REASON : undefined;
+}
 export function runtimeHostExternalTurnUnavailableReason(header) {
     return runtimeHostExecutionUnavailableReason(header, { kind: 'external_message' });
 }
@@ -31,9 +36,12 @@ export function runtimeHostSafeBoundaryContinuationUnavailableReason(header) {
         ? WORKHUB_COORDINATION_EXECUTION_UNAVAILABLE_REASON
         : undefined) ??
         (header.transcriptLedgerVersion === 0 ? IMPORT_STAGING_UNAVAILABLE_REASON : undefined) ??
-        (header.llmConnectionId === undefined && header.backend !== 'fake'
+        (header.llmConnectionId === undefined && header.backend === 'ai-sdk'
             ? LEGACY_CONNECTION_IDENTITY_EXECUTION_UNAVAILABLE_REASON
             : undefined) ??
+        (header.backend === 'plugin-executor'
+            ? PLUGIN_EXECUTOR_CONTINUATION_UNAVAILABLE_REASON
+            : undefined) ??
         (header.subagentParent ? CHILD_CONTINUATION_UNAVAILABLE_REASON : undefined));
 }
 export function runtimeHostExecutionUnavailableReason(header, execution) {
@@ -58,7 +66,7 @@ export function runtimeHostExecutionUnavailableReason(header, execution) {
             ? WORKHUB_COORDINATION_EXECUTION_UNAVAILABLE_REASON
             : undefined) ??
         (header.transcriptLedgerVersion === 0 ? IMPORT_STAGING_UNAVAILABLE_REASON : undefined) ??
-        (header.llmConnectionId === undefined && header.backend !== 'fake'
+        (header.llmConnectionId === undefined && header.backend === 'ai-sdk'
             ? LEGACY_CONNECTION_IDENTITY_EXECUTION_UNAVAILABLE_REASON
             : undefined) ??
         (header.collaborationMode === 'plan' &&

package/node_modules/@maka/runtime-host/dist/server/plugin-platform-coordinator.js

@@ -69,6 +69,12 @@ export class HostPluginPlatformCoordinator {
                         result: boundedPage('commands', this.platform.inspectCommands(input.rootId), input),
                     };
                 }
+                if (input.view === 'executors') {
+                    return {
+                        ok: true,
+                        result: boundedPage('executors', this.platform.inspectExecutors(input.rootId), input),
+                    };
+                }
                 if (input.view === 'failures') {
                     return { ok: true, result: boundedPage('failures', failures, input) };
                 }