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

package/dist/pi-transcript.js

@@ -945,10 +945,9 @@ function systemNoteText(message) {
             const data = message.data;
             const used = typeof data?.inputTokens === 'number' ? data.inputTokens : undefined;
             const prior = typeof data?.priorInputTokens === 'number' ? data.priorInputTokens : undefined;
-            if (used === undefined || prior === undefined) {
-                return 'The provider is dropping or rewriting context: content was appended but its reported usage did not grow. Declare a context window for this model so Maka compacts first.';
-            }
-            return `The provider is dropping or rewriting context: content was appended, and it counted ${used} input tokens against ${prior} before, which is no growth. Declare a context window for this model so Maka compacts first.`;
+            if (used === undefined || prior === undefined)
+                return "After content was appended, the provider-reported input token count did not grow; context may have been truncated or rewritten. If this persists, check that the model's actual context capacity and the connection settings agree.";
+            return `After content was appended, the provider-reported input token count did not grow; context may have been truncated or rewritten (${used} tokens versus ${prior} before). If this persists, check that the model's actual context capacity and the connection settings agree.`;
         }
         case 'context_overflow_after_compaction':
             return 'History was compacted and the provider still called this request too large. What remains also carries the system prompt, the tool schemas, the summary and the recent tail; shortening this message is the part you control.';

package/node_modules/@maka/core/dist/agent-graph-schedule.js

@@ -16,6 +16,7 @@
  * specific language governing permissions and limitations
  * under the License.
  */
+import { isExecutorId } from './executor-id.js';
 export const AGENT_GRAPH_SCHEDULE_UPDATE_SCHEMA_VERSION = 1;
 export const AGENT_GRAPH_SCHEDULE_MAX_ADD_WORK = 32;
 export const AGENT_GRAPH_SCHEDULE_MAX_STOP = 20;
@@ -192,14 +193,24 @@ function isSelectedResultInput(value) {
 function isWorkTarget(value) {
     if (!value || typeof value !== 'object' || Array.isArray(value))
         return false;
-    if (isExactRecord(value, ['kind', 'agentId']) &&
+    if (isExactRecord(value, [
+        'kind',
+        'agentId',
+        ...(hasOwn(value, 'executorId') ? ['executorId'] : []),
+    ]) &&
         value.kind === 'agent' &&
-        isOpaqueIdentity(value.agentId)) {
+        isOpaqueIdentity(value.agentId) &&
+        (value.executorId === undefined || isExecutorId(value.executorId))) {
         return true;
     }
-    if (isExactRecord(value, ['kind', 'presetId']) &&
+    if (isExactRecord(value, [
+        'kind',
+        'presetId',
+        ...(hasOwn(value, 'executorId') ? ['executorId'] : []),
+    ]) &&
         value.kind === 'preset' &&
-        isOpaqueIdentity(value.presetId)) {
+        isOpaqueIdentity(value.presetId) &&
+        (value.executorId === undefined || isExecutorId(value.executorId))) {
         return true;
     }
     return (isExactRecord(value, ['kind', 'operatorId']) &&

package/node_modules/@maka/core/dist/executor-id.js

@@ -0,0 +1,22 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+export const EXECUTOR_ID_PATTERN = /^[A-Za-z][A-Za-z0-9._:-]{0,127}$/u;
+export function isExecutorId(value) {
+    return typeof value === 'string' && EXECUTOR_ID_PATTERN.test(value);
+}

package/node_modules/@maka/core/dist/external-session.js

@@ -114,6 +114,24 @@ function normalizeExternalSessionPath(value) {
     const trimmed = stripped.length > 0 ? stripped : folded.length > 0 ? '/' : '';
     return /^[A-Za-z]:\//u.test(trimmed) ? trimmed.toLowerCase() : trimmed;
 }
+export const EXTERNAL_SESSION_LIMIT_KINDS = [
+    'transcript_bytes',
+    'record_bytes',
+    'records',
+    'converted_bytes',
+    'messages',
+];
+export class ExternalSessionLimitError extends Error {
+    limit;
+    constructor(kind, max, message) {
+        super(message);
+        if (!EXTERNAL_SESSION_LIMIT_KINDS.includes(kind) || !Number.isSafeInteger(max) || max <= 0) {
+            throw new Error('Invalid external Session import limit');
+        }
+        this.name = 'ExternalSessionLimitError';
+        this.limit = Object.freeze({ kind, max });
+    }
+}
 export class ExternalSessionAdapterRegistry {
     adapters = new Map();
     constructor(adapters = []) {

package/node_modules/@maka/core/dist/model-call-usage-projection.js

@@ -29,19 +29,6 @@ export function resolveUsageRange(range, now) {
     };
     return { from: now - spans[range], to: now };
 }
-/**
- * Maps a physical attempt outcome onto the status vocabulary the Usage surface
- * filters by. `interrupted` joins `aborted`: both mean the call stopped short
- * without the provider reporting a failure, and collapsing it into `error`
- * would inflate the error rate with user cancellations.
- */
-export function usageStatusForAttempt(status) {
-    if (status === 'completed')
-        return 'success';
-    if (status === 'failed')
-        return 'error';
-    return 'aborted';
-}
 export function clampCacheReadTokens(inputTokens, cacheReadTokens) {
     return Math.min(cacheReadTokens, inputTokens);
 }

package/node_modules/@maka/core/dist/runtime-event.js

@@ -40,6 +40,7 @@ import { isPermissionMode, } from './permission.js';
 import { isCollaborationMode } from './collaboration.js';
 import { isAgentSwarmAuthorizationSource, isEffectiveOrchestrationSource, isOrchestrationMode, } from './orchestration.js';
 import { isToolMode } from './tool-mode.js';
+import { isExecutorId } from './executor-id.js';
 import { isRuntimeSystemNoteKind, } from './session.js';
 import { decodeTurnOrigin } from './turn-origin.js';
 import { defineObjectShape, hasExactShape, isFiniteNumber, isOptionalMember, isOptionalString, isRecord, isStringArray, } from './record-schema.js';
@@ -172,6 +173,7 @@ export function runtimeEventEnvelopeValueDomains() {
 const RUNTIME_EVENT_SHAPE = defineObjectShape()(['id', 'invocationId', 'runId', 'sessionId', 'turnId', 'ts', 'partial', 'role', 'author'], ['branch', 'origin', 'modelVisibility', 'status', 'content', 'actions', 'refs']);
 const TEXT_CONTENT_SHAPE = defineObjectShape()(['kind', 'text'], [
     'displayText',
+    'interrupted',
     'origin',
     'attachments',
     'directoryReferences',
@@ -186,7 +188,15 @@ const FUNCTION_RESPONSE_CONTENT_SHAPE = defineObjectShape()(['kind', 'id', 'name
 const ERROR_CONTENT_SHAPE = defineObjectShape()(['kind', 'message'], ['code', 'reason', 'details', 'retry']);
 const SYSTEM_NOTE_CONTENT_SHAPE = defineObjectShape()(['kind', 'note'], ['data']);
 const INVOCATION_OPENED_CONTENT_SHAPE = defineObjectShape()(['kind', 'protocol', 'route', 'configuration', 'root', 'source'], ['lineage']);
-const INVOCATION_ROUTE_RUNTIME_SHAPE = defineObjectShape()(['provenance', 'backendKind', 'llmConnectionId', 'llmConnectionSlug', 'modelId'], ['providerStateIdentity']);
+const INVOCATION_ROUTE_RUNTIME_MODEL_SHAPE = defineObjectShape()(['provenance', 'backendKind', 'llmConnectionId', 'llmConnectionSlug', 'modelId'], ['providerStateIdentity']);
+const INVOCATION_ROUTE_RUNTIME_EXECUTOR_SHAPE = defineObjectShape()([
+    'provenance',
+    'backendKind',
+    'executorId',
+    'llmConnectionSlug',
+    'modelId',
+    'providerStateIdentity',
+], []);
 const INVOCATION_ROUTE_UNKNOWN_SHAPE = defineObjectShape()(['provenance', 'backendKind', 'llmConnectionSlug', 'modelId'], []);
 const INVOCATION_CONFIGURATION_SHAPE = defineObjectShape()([
     'cwd',
@@ -394,6 +404,7 @@ function isRuntimeEventContent(value) {
             if (!hasExactShape(value, TEXT_CONTENT_SHAPE) ||
                 (value.origin !== undefined && !isTurnOrigin(value.origin)) ||
                 (value.steering !== undefined && value.steering !== true) ||
+                (value.interrupted !== undefined && value.interrupted !== true) ||
                 (value.providerOptions !== undefined && !isRecord(value.providerOptions))) {
                 return false;
             }
@@ -481,14 +492,19 @@ function isRuntimeInvocationRoute(value) {
         return false;
     }
     if (value.provenance === 'runtime') {
-        return (hasExactShape(value, INVOCATION_ROUTE_RUNTIME_SHAPE) &&
+        if (value.backendKind === 'plugin-executor') {
+            return (hasExactShape(value, INVOCATION_ROUTE_RUNTIME_EXECUTOR_SHAPE) &&
+                isExecutorId(value.executorId) &&
+                isSha256Digest(value.providerStateIdentity));
+        }
+        return (hasExactShape(value, INVOCATION_ROUTE_RUNTIME_MODEL_SHAPE) &&
             isNonEmptyString(value.llmConnectionId) &&
             (value.providerStateIdentity === undefined || isSha256Digest(value.providerStateIdentity)));
     }
     return value.provenance === 'unknown' && hasExactShape(value, INVOCATION_ROUTE_UNKNOWN_SHAPE);
 }
 function isPersistedBackendKind(value) {
-    return value === 'ai-sdk' || value === 'fake';
+    return value === 'ai-sdk' || value === 'plugin-executor' || value === 'fake';
 }
 function isRuntimeInvocationConfiguration(value) {
     return (isRecord(value) &&

package/node_modules/@maka/core/dist/session-send-projection.js

@@ -26,11 +26,12 @@
  * whether that exact target looks usable for presentation and readiness checks.
  *
  * The compatibility rules are:
- *   1. The session's own connection must pass `isConnectionReady` with
+ *   1. Plugin executor Sessions do not depend on Maka model connections.
+ *   2. The session's own connection must pass `isConnectionReady` with
  *      the sticky session model.
- *   2. Legacy Sessions without an immutable connection id are blocked until
+ *   3. Legacy Sessions without an immutable connection id are blocked until
  *      the user explicitly selects an account.
- *   3. A missing id, slug mismatch, or unusable exact connection is blocked.
+ *   4. A missing id, slug mismatch, or unusable exact connection is blocked.
  *
  * `lastTestStatus` deliberately plays no part here (E4): telemetry about
  * a past credential test must not gate send, so it must not gate the
@@ -71,6 +72,8 @@ function sessionOwnConnectionBlockReason(session, ownConnection, hasSecret) {
     return verdict.ready ? undefined : verdict.reason;
 }
 function ownConnectionBlockReason(session, connections, hasSecret) {
+    if (session.backend === 'plugin-executor')
+        return undefined;
     if (session.backend === 'fake')
         return 'fake_backend';
     if (!session.llmConnectionId)

package/node_modules/@maka/core/dist/session.js

@@ -17,6 +17,7 @@
  * under the License.
  */
 import { isWorkHubActionReceipt } from './workhub-action-result.js';
+import { isExecutorId } from './executor-id.js';
 import { MODEL_FAILURE_MESSAGE_MAX_BYTES, isModelRetryDecision, } from './model-failure.js';
 import { decodeMessageContent, TOOL_ACTIVITY_KINDS, } from './events.js';
 import { isPermissionMode, isToolCategory, } from './permission.js';
@@ -290,10 +291,14 @@ export const WORKHUB_COORDINATION_REPLACEMENT_SCHEMA_VERSION = 2;
 export const WORKHUB_COORDINATION_STOP_SCHEMA_VERSION = 3;
 export function isWorkHubCreateDefaults(value) {
     if (!isRecord(value) ||
-        Object.keys(value).some((key) => key !== 'model' && key !== 'permissionMode'))
+        Object.keys(value).some((key) => key !== 'executorId' && key !== 'model' && key !== 'permissionMode'))
         return false;
     if (value.permissionMode !== undefined && !isPermissionMode(value.permissionMode))
         return false;
+    if (value.executorId !== undefined && !isExecutorId(value.executorId))
+        return false;
+    if (value.executorId !== undefined && value.model !== undefined)
+        return false;
     if (value.model === undefined)
         return true;
     const model = value.model;
@@ -349,7 +354,7 @@ const USER_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 'ts', 't
     'coordinationActionId',
     'origin',
 ]);
-const ASSISTANT_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 'ts', 'text', 'modelId'], ['thinking', 'contentOrder', 'providerOptions']);
+const ASSISTANT_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 'ts', 'text', 'modelId'], ['thinking', 'contentOrder', 'providerOptions', 'interrupted']);
 const TOOL_CALL_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 'ts', 'toolName', 'args'], [
     'activityKind',
     'displayName',
@@ -567,6 +572,7 @@ function decodeMessage(value, decodeToolResultContent) {
                 hasMessageEnvelope(message, true) &&
                 typeof message.text === 'string' &&
                 typeof message.modelId === 'string' &&
+                (message.interrupted === undefined || message.interrupted === true) &&
                 (message.providerOptions === undefined || isRecord(message.providerOptions)) &&
                 (message.thinking === undefined || isAssistantThinking(message.thinking)) &&
                 (message.contentOrder === undefined ||

package/node_modules/@maka/core/dist/shell-run-result.js

@@ -67,6 +67,7 @@ export class ShellRunUpdateBuffer {
 }
 const CURRENT_TERMINAL_RESULT_SHAPE = defineObjectShape()(['kind', 'cwd', 'cmd', 'status', 'output'], ['exitCode', 'failureMessage', 'sandboxDenial']);
 const CURRENT_SHELL_RUN_RESULT_SHAPE = defineObjectShape()(['kind', 'ref', 'mode', 'status', 'cwd', 'cmd', 'startedAt', 'updatedAt', 'revision'], [
+    'pid',
     'completedAt',
     'exitCode',
     'failureMessage',

package/node_modules/@maka/core/dist/shell-run.js

@@ -162,6 +162,7 @@ export function isValidShellRunState(value) {
 const SHELL_RUN_SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
 const SHELL_RUN_PATCH_KEYS = new Set([
     'status',
+    'pid',
     'exitCode',
     'failureMessage',
     'updatedAt',
@@ -179,6 +180,7 @@ const SHELL_RUN_RECORD_KEYS = new Set([
     'cwd',
     'command',
     'status',
+    'pid',
     'startedAt',
     'updatedAt',
     'completedAt',
@@ -227,6 +229,7 @@ export function normalizeShellRunRecord(value, sessionId, shellRunId) {
         record.sessionId === sessionId &&
         record.shellRunId === shellRunId &&
         isShellRunStatus(record.status) &&
+        (record.pid === undefined || isPositiveInteger(record.pid)) &&
         isFiniteNumber(record.startedAt) &&
         isFiniteNumber(record.updatedAt) &&
         isPositiveInteger(record.revision) &&
@@ -349,6 +352,7 @@ function isShellRunSandboxEscalation(value, execution) {
 }
 function canonicalShellRunRecord(record) {
     return {
+        ...(record.pid !== undefined ? { pid: record.pid } : {}),
         shellRunId: record.shellRunId,
         sessionId: record.sessionId,
         ...(record.sourceRunId !== undefined ? { sourceRunId: record.sourceRunId } : {}),

package/node_modules/@maka/core/dist/work-board.js

@@ -32,9 +32,18 @@ export const WORK_BOARD_ID_MAX_CHARS = 64;
 export const WORK_BOARD_SESSION_ID_MAX_CHARS = 160;
 export const WORK_BOARD_MESSAGE_ID_MAX_CHARS = 256;
 export const WORK_BOARD_PROJECT_ID_MAX_CHARS = 160;
+export const WORK_BOARD_HOST_ID_MAX_CHARS = 160;
+export const WORK_BOARD_PROFILE_ID_MAX_CHARS = 160;
 export const WORK_BOARD_DEFAULT_PAGE_SIZE = 50;
 export const WORK_BOARD_PAGE_SIZE_MAX = 100;
 export const WORK_BOARD_CURSOR_MAX_CHARS = 1024;
+/**
+ * Single-link contract: a project-scoped item owns at most one started
+ * Session at a time. Linking a freshly started Session replaces any previous
+ * link, keeping `linkedSessions` bounded instead of growing on repeated
+ * starts. Read paths stay tolerant of legacy arrays with more entries.
+ */
+export const WORK_BOARD_MAX_LINKED_SESSIONS = 1;
 export const WORK_BOARD_ITEM_STATES = ['todo', 'in_progress', 'done'];
 const WORK_BOARD_SCOPE_INBOX_SHAPE = defineObjectShape()(['kind'], []);
 const WORK_BOARD_SCOPE_PROJECT_SHAPE = defineObjectShape()(['kind', 'projectId'], []);
@@ -55,7 +64,7 @@ const WORK_BOARD_ITEM_SHAPE = defineObjectShape()([
     'createdAt',
     'updatedAt',
     'archived',
-], ['notes', 'archivedAt']);
+], ['notes', 'archivedAt', 'linkedSessions']);
 const WORK_BOARD_CREATE_INPUT_SHAPE = defineObjectShape()(['scope', 'title', 'creator', 'provenance'], ['notes']);
 const WORK_BOARD_UPDATE_INPUT_SHAPE = defineObjectShape()([], ['title', 'notes', 'scope', 'state']);
 const WORK_BOARD_LIST_QUERY_SHAPE = defineObjectShape()([], ['scope', 'projectIds', 'includeArchived', 'limit', 'cursor']);
@@ -236,6 +245,87 @@ export function normalizeCreateWorkBoardItemInput(input) {
         },
     };
 }
+const WORK_BOARD_LINKED_SESSION_SHAPE = defineObjectShape()(['profileId', 'hostId', 'sessionId', 'linkedAt'], []);
+export function normalizeWorkBoardLinkedSession(input) {
+    if (!isRecord(input) || !hasExactShape(input, WORK_BOARD_LINKED_SESSION_SHAPE)) {
+        return fail('Work Board linked Session reference is invalid');
+    }
+    const profileId = normalizeIdString(input.profileId, {
+        field: 'linkedSessions.profileId',
+        max: WORK_BOARD_PROFILE_ID_MAX_CHARS,
+    });
+    if (!profileId.ok)
+        return profileId;
+    const hostId = normalizeIdString(input.hostId, {
+        field: 'linkedSessions.hostId',
+        max: WORK_BOARD_HOST_ID_MAX_CHARS,
+    });
+    if (!hostId.ok)
+        return hostId;
+    const sessionId = normalizeIdString(input.sessionId, {
+        field: 'linkedSessions.sessionId',
+        max: WORK_BOARD_SESSION_ID_MAX_CHARS,
+    });
+    if (!sessionId.ok)
+        return sessionId;
+    const linkedAt = asSafeInteger(input.linkedAt);
+    if (linkedAt === null || linkedAt < 0)
+        return fail('linkedAt must be a non-negative integer');
+    return {
+        ok: true,
+        value: {
+            profileId: profileId.value,
+            hostId: hostId.value,
+            sessionId: sessionId.value,
+            linkedAt,
+        },
+    };
+}
+export function normalizeWorkBoardLinkedSessions(input) {
+    if (input === undefined)
+        return { ok: true, value: [] };
+    if (!Array.isArray(input))
+        return fail('linkedSessions must be an array');
+    const result = [];
+    const seen = new Set();
+    for (const entry of input) {
+        const normalized = normalizeWorkBoardLinkedSession(entry);
+        if (!normalized.ok)
+            return normalized;
+        const key = `${normalized.value.profileId}\u0000${normalized.value.hostId}\u0000${normalized.value.sessionId}`;
+        if (seen.has(key))
+            return fail('linkedSessions contains duplicates');
+        seen.add(key);
+        result.push(normalized.value);
+    }
+    if (result.length > WORK_BOARD_MAX_LINKED_SESSIONS) {
+        return fail(`linkedSessions must hold at most ${WORK_BOARD_MAX_LINKED_SESSIONS} entry (single-link contract)`);
+    }
+    return { ok: true, value: result };
+}
+/**
+ * Lenient read path for stored items: drop malformed or duplicate link entries
+ * instead of failing the whole item, so one corrupt reference cannot hide an
+ * otherwise valid board item. The strict {@link normalizeWorkBoardLinkedSessions}
+ * guard remains on the write path.
+ */
+function tolerantWorkBoardLinkedSessions(value) {
+    if (!Array.isArray(value))
+        return [];
+    const result = [];
+    const seen = new Set();
+    for (const entry of value) {
+        const normalized = normalizeWorkBoardLinkedSession(entry);
+        if (!normalized.ok)
+            continue;
+        const key = `${normalized.value.profileId}\u0000${normalized.value.hostId}\u0000${normalized.value.sessionId}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(normalized.value);
+    }
+    return result;
+}
 export function normalizeUpdateWorkBoardItemInput(input) {
     if (!isRecord(input))
         return fail('Work Board update must be an object');
@@ -395,6 +485,7 @@ export function decodeWorkBoardItem(value) {
     const provenance = normalizeWorkBoardProvenance(value.provenance);
     if (!provenance.ok)
         return null;
+    const linkedSessions = tolerantWorkBoardLinkedSessions(value.linkedSessions);
     const createdAt = asSafeInteger(value.createdAt);
     const updatedAt = asSafeInteger(value.updatedAt);
     if (createdAt === null || updatedAt === null)
@@ -418,6 +509,7 @@ export function decodeWorkBoardItem(value) {
             archivedAt,
             creator: creator.value,
             provenance: provenance.value,
+            linkedSessions,
             createdAt,
             updatedAt,
         };
@@ -435,6 +527,7 @@ export function decodeWorkBoardItem(value) {
         archived: false,
         creator: creator.value,
         provenance: provenance.value,
+        linkedSessions,
         createdAt,
         updatedAt,
     };

package/node_modules/@maka/core/package.json

@@ -6,6 +6,7 @@
   "type": "module",
   "sideEffects": false,
   "exports": {
+    "./executor-id": "./dist/executor-id.js",
     "./durable-tool-result-projection": "./dist/durable-tool-result-projection.js",
     "./model-projection-transition": "./dist/model-projection-transition.js",
     "./canonical-runtime-event": "./dist/canonical-runtime-event.js",