maka-agent 0.1.0-beta.1 → 0.2.0-dev.3.20260830

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

@@ -1,23 +1,36 @@
+/*
+ * 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.
+ */
 import { decodeMessageContent, TOOL_ACTIVITY_KINDS, } from './events.js';
-import { isPermissionMode, isToolCategory, } from './permission.js';
+import { isToolCategory, } from './permission.js';
 import { defineObjectShape, hasExactShape, isFiniteNumber, isOptionalString, isRecord, } from './record-schema.js';
 import { isPermissionDecisionFields } from './interaction-record-schema.js';
 import { isTokenUsageFields } from './usage-record-schema.js';
-import { decodeCanonicalToolResultContent } from './tool-result-record-schema.js';
+import { decodeCanonicalToolResultContent, decodePersistedToolResultContent, } from './tool-result-record-schema.js';
+import { markPersisted } from './persisted-value.js';
 import { decodeTurnOrigin } from './turn-origin.js';
-export { DEEP_RESEARCH_SESSION_LABEL, isDeepResearchSession } from './explore-agent.js';
-/**
- * `archived` is still here and still written by `SessionStore.archive()`
- * alongside `isArchived`; consolidating those two onto one authority is its own
- * change (#2984, PR 3) because it rewrites stored rows.
- *
- */
+export { DEEP_RESEARCH_SESSION_LABEL, isDeepResearchSession } from './deep-research.js';
+/** Runtime execution states. Archive visibility is represented by `isArchived`. */
 export const SESSION_STATUSES = [
     'active',
     'running',
     'waiting_for_user',
     'blocked',
-    'archived',
     'aborted',
 ];
 export const SESSION_BLOCKED_REASONS = [
@@ -27,6 +40,13 @@ export const SESSION_BLOCKED_REASONS = [
     'tool_failed',
     'unknown',
 ];
+/** Reserved durable role for the one WorkHub coordination conversation owned by a Runtime Host. */
+export const WORKHUB_COORDINATION_SESSION_ROLE = 'workhub_coordination';
+export const WORKHUB_COORDINATION_SESSION_ID = 'maka_workhub_coordination';
+/** Whether an identifier targets the reserved WorkHub Coordination Session. */
+export function isWorkHubCoordinationSessionId(sessionId) {
+    return sessionId === WORKHUB_COORDINATION_SESSION_ID;
+}
 export const TURN_STATUSES = ['running', 'completed', 'aborted', 'failed'];
 export const SUBAGENT_SESSION_LIFECYCLES = ['foreground'];
 export const SUBAGENT_SESSION_RUNTIME_SCHEMA_VERSION = 1;
@@ -43,10 +63,17 @@ export function isTurnStatus(value) {
 // ============================================================================
 // Header (JSONL line 1)
 // ============================================================================
-export const SESSION_TOOL_PROFILES = ['headless-coding-v1'];
+export const SESSION_TOOL_PROFILES = ['headless-coding-v1', 'workhub-coordination-v1'];
 export function isSessionToolProfile(value) {
     return typeof value === 'string' && SESSION_TOOL_PROFILES.includes(value);
 }
+export function isWorkHubCoordinationSession(session) {
+    return session.role === WORKHUB_COORDINATION_SESSION_ROLE;
+}
+/** Whether durable state claims either half of the reserved Coordination identity/role pair. */
+export function isWorkHubCoordinationSessionTarget(session) {
+    return isWorkHubCoordinationSessionId(session.id) || isWorkHubCoordinationSession(session);
+}
 export function sessionRevisionFamilyId(session) {
     return session.revisionRootSessionId ?? session.id;
 }
@@ -63,9 +90,18 @@ const SUBAGENT_SESSION_RUNTIME_SHAPE = defineObjectShape()([
     'systemPrompt',
     'toolNames',
     'categoryPolicy',
-], ['permissionCeiling', 'presetId']);
+], ['presetId']);
+/**
+ * Keys older child sessions wrote that this type no longer has.
+ *
+ * `hasExactShape` rejects unknown keys, so without this a record written before
+ * the key was dropped would fail validation and make the whole child Session
+ * unreadable. Nothing reads the values, and they stay in the stored JSON as
+ * written — this only stops their presence from being treated as corruption.
+ */
+const RETIRED_SUBAGENT_RUNTIME_KEYS = ['permissionCeiling'];
 const SUBAGENT_SESSION_SPAWN_IDENTITY_SHAPE = defineObjectShape()(['schemaVersion', 'requestFingerprint', 'initialTurnId', 'initialRunId'], []);
-const SESSION_CONVERSATION_COPY_SHAPE = defineObjectShape()(['kind', 'sourceSessionId', 'sourceTurnId', 'requestFingerprint', 'state'], []);
+const SESSION_CONVERSATION_COPY_SHAPE = defineObjectShape()(['kind', 'sourceSessionId', 'sourceTurnId', 'requestFingerprint', 'state'], ['intent']);
 const SESSION_LINEAGE_ID_MAX_CHARS = 512;
 const SESSION_LINEAGE_CONTROL_CHARACTERS = /[\u0000-\u001f\u007f]/;
 const SUBAGENT_RUNTIME_NAME_MAX_CHARS = 512;
@@ -99,10 +135,15 @@ export function isSubagentSessionParent(value) {
             isSessionLineageId(value.graph.operatorId));
     return swarmValid && graphValid && !(value.swarm && value.graph);
 }
+function withoutRetiredSubagentRuntimeKeys(value) {
+    if (!RETIRED_SUBAGENT_RUNTIME_KEYS.some((key) => Object.hasOwn(value, key)))
+        return value;
+    return Object.fromEntries(Object.entries(value).filter(([key]) => !RETIRED_SUBAGENT_RUNTIME_KEYS.includes(key)));
+}
 /** Strict decoder guard for the persisted child execution snapshot. */
 export function isSubagentSessionRuntime(value) {
     if (!isRecord(value) ||
-        !hasExactShape(value, SUBAGENT_SESSION_RUNTIME_SHAPE) ||
+        !hasExactShape(withoutRetiredSubagentRuntimeKeys(value), SUBAGENT_SESSION_RUNTIME_SHAPE) ||
         value.schemaVersion !== SUBAGENT_SESSION_RUNTIME_SCHEMA_VERSION ||
         !Number.isSafeInteger(value.definitionVersion) ||
         value.definitionVersion < 1 ||
@@ -124,7 +165,7 @@ export function isSubagentSessionRuntime(value) {
         !isSubagentCategoryPolicy(value.categoryPolicy)) {
         return false;
     }
-    return value.permissionCeiling === undefined || isPermissionMode(value.permissionCeiling);
+    return true;
 }
 /** Strict decoder guard for durable child-spawn idempotency metadata. */
 export function isSubagentSessionSpawn(value) {
@@ -141,6 +182,8 @@ export function isSessionConversationCopy(value) {
     return (isRecord(value) &&
         hasExactShape(value, SESSION_CONVERSATION_COPY_SHAPE) &&
         (value.kind === 'branch' || value.kind === 'revision') &&
+        (value.intent === undefined ||
+            (value.kind === 'branch' && value.intent === 'side_conversation')) &&
         isSessionLineageId(value.sourceSessionId) &&
         isSessionLineageId(value.sourceTurnId) &&
         typeof value.requestFingerprint === 'string' &&
@@ -241,6 +284,16 @@ function isSubagentCategoryPolicy(value) {
 export function userFacingText(message) {
     return message.displayText ?? message.text;
 }
+const USER_VISIBLE_SESSION_SYSTEM_NOTES = new Set([
+    'context_compacted',
+    'context_compaction_failed_open',
+    'step_limit',
+]);
+/** Closed policy for system notes that are part of the user-visible transcript. */
+export function isUserVisibleSessionSystemNote(kind) {
+    return USER_VISIBLE_SESSION_SYSTEM_NOTES.has(kind);
+}
+export const WORKHUB_COORDINATION_RECORD_SCHEMA_VERSION = 1;
 const USER_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 'ts', 'text'], ['displayText', 'attachments', 'quotes', 'inlineReferences', 'steeringEventId', 'origin']);
 const ASSISTANT_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 'ts', 'text', 'modelId'], ['thinking', 'contentOrder', 'providerOptions']);
 const TOOL_CALL_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 'ts', 'toolName', 'args'], [
@@ -297,6 +350,27 @@ const TURN_STATE_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'turnId', 't
     'abortSource',
     'errorClass',
 ]);
+const WORKHUB_DELEGATION_ASSIGNED_MESSAGE_SHAPE = defineObjectShape()([
+    'type',
+    'id',
+    'turnId',
+    'ts',
+    'schemaVersion',
+    'kind',
+    'actionId',
+    'actionFingerprint',
+    'coordinationTurnId',
+    'targetSessionId',
+    'disposition',
+    'userText',
+    'delegationId',
+    'targetTurnId',
+    'targetMessageId',
+    'targetSessionName',
+], ['create', 'steered']);
+const WORKHUB_DELEGATION_CREATE_SHAPE = defineObjectShape()(['title', 'workspace'], []);
+const WORKHUB_DELEGATION_PROJECT_WORKSPACE_SHAPE = defineObjectShape()(['kind', 'projectId'], []);
+const WORKHUB_DELEGATION_HOST_PATH_WORKSPACE_SHAPE = defineObjectShape()(['kind', 'path'], []);
 const SYSTEM_NOTE_MESSAGE_SHAPE = defineObjectShape()(['type', 'id', 'ts', 'kind'], ['turnId', 'data']);
 const ASSISTANT_THINKING_PART_SHAPE = defineObjectShape()(['text'], ['signature', 'providerOptions']);
 const ASSISTANT_THINKING_SHAPE = defineObjectShape()(['text'], ['signature', 'providerOptions', 'parts']);
@@ -311,8 +385,14 @@ const SYSTEM_NOTE_KINDS = new Set([
     'error',
     'abort',
 ]);
-export function decodeStoredMessage(value) {
-    const message = decodeStoredMessageContent(value, decodeCanonicalToolResultContent);
+export function decodeCanonicalMessage(value) {
+    return decodeMessage(value, decodeCanonicalToolResultContent);
+}
+export function decodeStoredMessage(persisted) {
+    return decodeMessage(persisted, (content) => decodePersistedToolResultContent(markPersisted(content)));
+}
+function decodeMessage(value, decodeToolResultContent) {
+    const message = decodeStoredMessageContent(value, decodeToolResultContent);
     if (!isRecord(message))
         throw new Error('Invalid stored message schema');
     switch (message.type) {
@@ -407,6 +487,11 @@ export function decodeStoredMessage(value) {
                 isOptionalString(message.errorClass))
                 return message;
             break;
+        case 'workhub_coordination':
+            if (isWorkHubCoordinationMessage(message)) {
+                return message;
+            }
+            break;
         case 'system_note':
             if (hasExactShape(message, SYSTEM_NOTE_MESSAGE_SHAPE) &&
                 hasMessageEnvelope(message, false) &&
@@ -417,6 +502,49 @@ export function decodeStoredMessage(value) {
     }
     throw new Error('Invalid stored message schema');
 }
+function isWorkHubCoordinationMessage(message) {
+    const common = hasMessageEnvelope(message, true) &&
+        message.schemaVersion === WORKHUB_COORDINATION_RECORD_SCHEMA_VERSION &&
+        typeof message.actionId === 'string' &&
+        typeof message.actionFingerprint === 'string' &&
+        /^sha256:[a-f0-9]{64}$/u.test(message.actionFingerprint) &&
+        typeof message.coordinationTurnId === 'string' &&
+        message.turnId === message.coordinationTurnId &&
+        typeof message.targetSessionId === 'string' &&
+        typeof message.userText === 'string' &&
+        message.userText.trim().length > 0 &&
+        ((message.disposition === 'delegate_existing' && message.create === undefined) ||
+            (message.disposition === 'create_new' && isWorkHubDelegationCreateSpec(message.create))) &&
+        (message.disposition === 'delegate_existing' || message.disposition === 'create_new');
+    if (!common)
+        return false;
+    return (message.kind === 'delegation_assigned' &&
+        hasExactShape(message, WORKHUB_DELEGATION_ASSIGNED_MESSAGE_SHAPE) &&
+        typeof message.delegationId === 'string' &&
+        typeof message.targetTurnId === 'string' &&
+        typeof message.targetMessageId === 'string' &&
+        typeof message.targetSessionName === 'string' &&
+        message.targetSessionName.trim().length > 0 &&
+        (message.steered === undefined || message.steered === true));
+}
+function isWorkHubDelegationCreateSpec(value) {
+    if (!isRecord(value) ||
+        !hasExactShape(value, WORKHUB_DELEGATION_CREATE_SHAPE) ||
+        typeof value.title !== 'string' ||
+        value.title.trim().length === 0 ||
+        !isRecord(value.workspace)) {
+        return false;
+    }
+    if (value.workspace.kind === 'project') {
+        return (hasExactShape(value.workspace, WORKHUB_DELEGATION_PROJECT_WORKSPACE_SHAPE) &&
+            typeof value.workspace.projectId === 'string' &&
+            value.workspace.projectId.length > 0);
+    }
+    return (value.workspace.kind === 'host_path' &&
+        hasExactShape(value.workspace, WORKHUB_DELEGATION_HOST_PATH_WORKSPACE_SHAPE) &&
+        typeof value.workspace.path === 'string' &&
+        value.workspace.path.length > 0);
+}
 function decodeStoredMessageContent(value, decodeToolResultContent) {
     if (!isRecord(value) || value.type !== 'tool_result')
         return value;
@@ -460,25 +588,14 @@ function isToolActivityIdentity(value) {
         isOptionalString(value.parentOperationId));
 }
 export const STEP_LIMIT_NOTICE_TEXT = 'Reached the configured step limit. The task may be incomplete. Send “continue” to resume.';
-/**
- * View-boundary facts for explaining a model selection without adding a
- * second persisted model authority. Assistant rows already record the actual
- * model used by each completed step, so the latest such row is the only
- * durable model fact the switcher needs.
- */
-export function deriveModelSwitchTranscript(messages) {
-    let lastUsedModel;
+/** Latest actual model recorded by a completed assistant step. */
+export function latestAssistantModelId(messages) {
     for (let index = messages.length - 1; index >= 0; index -= 1) {
         const message = messages[index];
-        if (message?.type !== 'assistant')
-            continue;
-        lastUsedModel = message.modelId;
-        break;
+        if (message?.type === 'assistant')
+            return message.modelId;
     }
-    return {
-        hasConversation: messages.length > 0,
-        ...(lastUsedModel ? { lastUsedModel } : {}),
-    };
+    return undefined;
 }
 export function deriveTurnRecords(messages) {
     const order = [];

package/node_modules/@maka/core/dist/settings/network-settings.js

@@ -1,3 +1,21 @@
+/*
+ * 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 SENSITIVE_PLACEHOLDER = '••••••••';
 export function applySensitivePatch(prev, next) {
     if (next === undefined || next === SENSITIVE_PLACEHOLDER)