maka-agent 0.2.0-dev.25.20260908 → 0.2.0-dev.26.20260909

package/node_modules/@maka/runtime-host/dist/server/workhub-coordination-action-gate.js

@@ -18,7 +18,6 @@
  */
 import { createHash } from 'node:crypto';
 import { WORKHUB_COORDINATION_SESSION_ID, isWorkHubCoordinationSessionTarget, } from '@maka/core/session';
-import { readWorkHubRequestIntent, workHubCorrectionTargetsSession, workHubCreationAuthorizesTitle, workHubNamedDelegationActionTargetsSession, } from '@maka/core/workhub-creation-intent';
 import { WORKHUB_COORDINATION_CANDIDATE_MAX_ITEMS } from '../protocol/index.js';
 const SIDE_CONVERSATION_LABEL = 'mode:side_conversation';
 const ACTION_REPLAY_MAX_ITEMS = 256;
@@ -54,10 +53,17 @@ export class WorkHubCoordinationActionGate {
     async candidates() {
         return candidateSet(await this.#effects.listSessions());
     }
-    act(input, context) {
+    act(input, context, admittedTurnId) {
         if (!input.userText.trim()) {
             return Promise.reject(new WorkHubActionGateFailure('action_conflict', 'WorkHub action text is empty'));
         }
+        if (input.delegationText !== undefined &&
+            (!input.delegationText.trim() ||
+                (input.proposal.disposition !== 'delegate_existing' &&
+                    input.proposal.disposition !== 'create_new' &&
+                    input.proposal.disposition !== 'replace'))) {
+            return Promise.reject(new WorkHubActionGateFailure('action_conflict', 'Invalid WorkHub delegation text'));
+        }
         if (input.proposal.disposition === 'create_new' && !input.proposal.title.trim()) {
             return Promise.reject(new WorkHubActionGateFailure('action_conflict', 'WorkHub creation title is empty'));
         }
@@ -70,7 +76,7 @@ export class WorkHubCoordinationActionGate {
             }
             return replay.result;
         }
-        const result = this.#act(input, fingerprint, context);
+        const result = this.#act({ ...input, ...(admittedTurnId ? { coordinationTurnId: admittedTurnId } : {}) }, fingerprint, context);
         const action = { requestFingerprint, result };
         this.#actions.set(input.actionId, action);
         // Successful actions remain a Host-lifetime fast path. Rejections release
@@ -87,12 +93,6 @@ export class WorkHubCoordinationActionGate {
     }
     async #act(input, fingerprint, context) {
         const proposal = input.proposal;
-        const requestIntent = readWorkHubRequestIntent(input.userText);
-        if (requestIntent.execution === 'ambiguous' &&
-            proposal.disposition !== 'answer_here' &&
-            proposal.disposition !== 'clarify') {
-            throw new WorkHubActionGateFailure('action_conflict', 'WorkHub cannot write from an ambiguous instruction');
-        }
         const durable = await this.#effects.readAssignment(input.actionId);
         if (durable) {
             const replayFingerprint = durable.replacesActionId
@@ -106,30 +106,7 @@ export class WorkHubCoordinationActionGate {
             }
             return this.#assign(assignmentInputFromRecord(durable), context);
         }
-        if (proposal.disposition === 'answer_here') {
-            const turnId = coordinationTurnId(input.actionId, 'answer');
-            await this.#claimAction(input.actionId, 'answer_here', fingerprint, turnId);
-            await this.#effects.answer({
-                turnId,
-                text: input.userText,
-                ...(input.attachments ? { attachments: input.attachments } : {}),
-            }, context);
-            return { disposition: 'answer_here', coordinationTurnId: turnId };
-        }
-        if (proposal.disposition === 'clarify') {
-            const turnId = coordinationTurnId(input.actionId, 'clarify');
-            await this.#claimAction(input.actionId, 'clarify', fingerprint, turnId);
-            await this.#effects.clarify({
-                turnId,
-                userText: input.userText,
-                assistantText: proposal.assistantText,
-            });
-            return { disposition: 'clarify', coordinationTurnId: turnId };
-        }
         if (proposal.disposition === 'stop_work') {
-            if (input.confirmation?.kind !== 'user_stop' || !requestIntent.stop.imperative) {
-                throw new WorkHubActionGateFailure('action_conflict', 'WorkHub stop requires an explicit named command in trusted user text');
-            }
             const source = await this.#stopSource(input.actionId, proposal.expects.targetSessionId);
             const stopFingerprint = stopActionFingerprint(input, source);
             await this.#claimAction(input.actionId, 'stop', stopFingerprint, source.delegationId);
@@ -171,6 +148,7 @@ export class WorkHubCoordinationActionGate {
             }
             const requested = await this.#effects.prepareStop({
                 actionId: input.actionId,
+                coordinationTurnId: input.coordinationTurnId,
                 actionFingerprint: stopFingerprint,
                 stopsActionId: source.actionId,
                 stopsDelegationId: source.delegationId,
@@ -182,36 +160,33 @@ export class WorkHubCoordinationActionGate {
             return this.#stop(requested, source);
         }
         if (proposal.disposition === 'resume_work') {
-            if (!requestIntent.resume.imperative) {
-                throw new WorkHubActionGateFailure('action_conflict', 'WorkHub resume requires an explicit named command in trusted user text');
-            }
-            const candidates = await this.candidates();
-            const target = candidates.candidates.find((candidate) => candidate.sessionId === proposal.expects.targetSessionId);
-            if (!target)
-                throw new WorkHubActionGateFailure('candidate_unavailable', 'WorkHub resume target is unavailable');
-            this.#assertTarget(target);
-            const source = await this.#soleWorkingDelegation(target.sessionId, 'resume');
-            if (source.actionId !== proposal.resumesActionId) {
+            const source = await this.#effects.readAssignment(proposal.resumesActionId);
+            if (!source || source.targetSessionId !== proposal.expects.targetSessionId) {
                 throw new WorkHubActionGateFailure('action_conflict', 'WorkHub resume target delegation changed');
             }
-            const currentTargetName = target.sessionName;
-            if (!currentTargetName ||
-                !workHubNamedDelegationActionTargetsSession(requestIntent.resume, currentTargetName)) {
-                throw new WorkHubActionGateFailure('action_conflict', 'WorkHub resume target is not affirmed in trusted user text');
-            }
-            return this.#effects.resume({ actionId: input.actionId, source }, context);
+            const validateFreshTarget = async () => {
+                const candidates = await this.candidates();
+                const target = candidates.candidates.find((candidate) => candidate.sessionId === proposal.expects.targetSessionId);
+                if (!target)
+                    throw new WorkHubActionGateFailure('candidate_unavailable', 'WorkHub resume target is unavailable');
+                this.#assertTarget(target);
+                const current = await this.#soleWorkingDelegation(target.sessionId, 'resume');
+                if (current.actionId !== source.actionId) {
+                    throw new WorkHubActionGateFailure('action_conflict', 'WorkHub resume target delegation changed');
+                }
+                if (!target.sessionName)
+                    throw new WorkHubActionGateFailure('action_conflict', 'WorkHub resume target is unavailable');
+            };
+            return this.#effects.resume({ actionId: input.actionId, source, validateFreshTarget }, context);
         }
         if (proposal.disposition === 'create_new') {
-            if (!input.create || !workHubCreationAuthorizesTitle(requestIntent, proposal.title)) {
-                throw new WorkHubActionGateFailure('action_conflict', 'WorkHub creation requires an unambiguous instruction and creation context');
+            if (!input.create) {
+                throw new WorkHubActionGateFailure('action_conflict', 'WorkHub creation context is unavailable');
             }
             const sessionId = workHubCreatedSessionId(input.actionId);
             return this.#assign(delegationAssignment(input, fingerprint, sessionId, proposal.title), context);
         }
         if (proposal.disposition === 'replace') {
-            if (input.confirmation?.kind !== 'user_correction' || !requestIntent.correction.cue) {
-                throw new WorkHubActionGateFailure('action_conflict', 'WorkHub replacement requires explicit correction in trusted user text');
-            }
             const replaced = await this.#effects.readAssignment(proposal.replacesActionId);
             if (!replaced) {
                 throw new WorkHubActionGateFailure('action_conflict', 'WorkHub can replace only a durable delegation it owns');
@@ -221,9 +196,6 @@ export class WorkHubCoordinationActionGate {
             }
             const prepared = await this.#effects.readReplacement(replaced.delegationId);
             if (prepared) {
-                if (!isExplicitWorkHubCorrectionText(input.userText, prepared.disposition, prepared.targetSessionName)) {
-                    throw new WorkHubActionGateFailure('action_conflict', 'WorkHub replacement target is not affirmed in trusted user text');
-                }
                 if (prepared.actionId !== input.actionId ||
                     prepared.actionFingerprint !==
                         replacementActionFingerprint(input, prepared.targetSessionId)) {
@@ -374,21 +346,20 @@ export class WorkHubCoordinationActionGate {
         }
         const target = input.proposal.target;
         if (target.disposition === 'create_new') {
-            if (!isExplicitWorkHubCorrectionText(input.userText, 'create_new', target.title)) {
-                throw new WorkHubActionGateFailure('action_conflict', 'WorkHub replacement creation requires explicit non-negated user intent');
-            }
             if (!input.create) {
                 throw new WorkHubActionGateFailure('action_conflict', 'WorkHub replacement creation context is unavailable');
             }
             const targetSessionId = workHubCreatedSessionId(input.actionId);
             return {
                 actionId: input.actionId,
+                coordinationTurnId: input.coordinationTurnId,
                 actionFingerprint: replacementActionFingerprint(input, targetSessionId),
                 targetSessionId,
                 targetSessionName: target.title,
                 disposition: 'create_new',
                 userText: input.userText,
                 ...(input.attachments ? { attachments: input.attachments } : {}),
+                ...(input.delegationText === undefined ? {} : { delegationText: input.delegationText }),
                 create: {
                     title: target.title,
                     workspace: input.create.workspace,
@@ -409,20 +380,19 @@ export class WorkHubCoordinationActionGate {
             throw new WorkHubActionGateFailure('candidate_unavailable', 'WorkHub replacement target is not in the admitted candidate set');
         }
         this.#assertTarget(destination);
-        if (!isExplicitWorkHubCorrectionText(input.userText, 'delegate_existing', destination.sessionName)) {
-            throw new WorkHubActionGateFailure('action_conflict', 'WorkHub replacement target is not affirmed in trusted user text');
-        }
         if (destination.sessionId === replaced.targetSessionId) {
             throw new WorkHubActionGateFailure('action_conflict', 'WorkHub replacement must choose a different Session');
         }
         return {
             actionId: input.actionId,
+            coordinationTurnId: input.coordinationTurnId,
             actionFingerprint: replacementActionFingerprint(input, destination.sessionId),
             targetSessionId: destination.sessionId,
             targetSessionName: destination.sessionName,
             disposition: 'delegate_existing',
             userText: input.userText,
             ...(input.attachments ? { attachments: input.attachments } : {}),
+            ...(input.delegationText === undefined ? {} : { delegationText: input.delegationText }),
             replacesActionId: replaced.actionId,
             replacesDelegationId: replaced.delegationId,
             replacedTargetSessionId: replaced.targetSessionId,
@@ -609,9 +579,6 @@ function isCandidateSession(session) {
 function candidateRef(candidateSetId, sessionId) {
     return `whc_${hash(`${candidateSetId}\0${sessionId}`).slice(0, 48)}`;
 }
-function coordinationTurnId(actionId, kind) {
-    return `wha_${hash(`${actionId}\0${kind}`).slice(0, 48)}`;
-}
 function delegationAssignment(input, actionFingerprint, targetSessionId, targetSessionName) {
     const create = input.create;
     if (input.proposal.disposition !== 'delegate_existing' &&
@@ -620,12 +587,14 @@ function delegationAssignment(input, actionFingerprint, targetSessionId, targetS
     }
     const base = {
         actionId: input.actionId,
+        coordinationTurnId: input.coordinationTurnId ?? input.actionId,
         actionFingerprint,
         targetSessionId,
         targetSessionName,
         disposition: input.proposal.disposition,
         userText: input.userText,
         ...(input.attachments ? { attachments: input.attachments } : {}),
+        ...(input.delegationText === undefined ? {} : { delegationText: input.delegationText }),
     };
     if (input.proposal.disposition === 'delegate_existing')
         return base;
@@ -671,6 +640,7 @@ function actionFingerprint(input) {
         userText: input.userText,
         ...(input.attachments ? { attachments: input.attachments } : {}),
         ...(input.newWorkDefaults ? { newWorkDefaults: input.newWorkDefaults } : {}),
+        ...(input.delegationText === undefined ? {} : { delegationText: input.delegationText }),
         disposition: input.proposal.disposition,
         ...(input.proposal.disposition === 'delegate_existing'
             ? { candidateRef: input.proposal.candidateRef }
@@ -681,9 +651,6 @@ function actionFingerprint(input) {
                 workspace: input.create?.workspace,
             }
             : {}),
-        ...(input.proposal.disposition === 'clarify'
-            ? { assistantText: input.proposal.assistantText }
-            : {}),
         ...(input.proposal.disposition === 'replace'
             ? {
                 replacesActionId: input.proposal.replacesActionId,
@@ -703,6 +670,7 @@ function replacementActionFingerprint(input, targetSessionId) {
         userText: input.userText,
         ...(input.attachments ? { attachments: input.attachments } : {}),
         ...(input.newWorkDefaults ? { newWorkDefaults: input.newWorkDefaults } : {}),
+        ...(input.delegationText === undefined ? {} : { delegationText: input.delegationText }),
         disposition: input.proposal.disposition,
         replacesActionId: input.proposal.replacesActionId,
         target: {
@@ -758,12 +726,16 @@ function stopResultFromRecord(resolution, request) {
 function assignmentInputFromRecord(assignment) {
     return {
         actionId: assignment.actionId,
+        coordinationTurnId: assignment.coordinationTurnId,
         actionFingerprint: assignment.actionFingerprint,
         targetSessionId: assignment.targetSessionId,
         targetSessionName: assignment.targetSessionName,
         disposition: assignment.disposition,
         userText: assignment.userText,
         ...(assignment.attachments ? { attachments: assignment.attachments } : {}),
+        ...(assignment.delegationText === undefined
+            ? {}
+            : { delegationText: assignment.delegationText }),
         ...(assignment.create ? { create: assignment.create } : {}),
         ...(assignment.replacesActionId && assignment.replacesDelegationId
             ? {
@@ -776,12 +748,16 @@ function assignmentInputFromRecord(assignment) {
 function assignmentInputFromReplacement(replacement) {
     return {
         actionId: replacement.actionId,
+        coordinationTurnId: replacement.coordinationTurnId,
         actionFingerprint: replacement.actionFingerprint,
         targetSessionId: replacement.targetSessionId,
         targetSessionName: replacement.targetSessionName,
         disposition: replacement.disposition,
         userText: replacement.userText,
         ...(replacement.attachments ? { attachments: replacement.attachments } : {}),
+        ...(replacement.delegationText === undefined
+            ? {}
+            : { delegationText: replacement.delegationText }),
         ...(replacement.create ? { create: replacement.create } : {}),
         replacesActionId: replacement.replacesActionId,
         replacesDelegationId: replacement.replacesDelegationId,
@@ -790,20 +766,3 @@ function assignmentInputFromReplacement(replacement) {
 function hash(value) {
     return createHash('sha256').update(value, 'utf8').digest('hex');
 }
-/**
- * Destructive replacement needs evidence in the user-originated text itself;
- * a strategy-provided replacement proposal and confirmation marker are not
- * sufficient authority. Keep this deliberately narrower than route inference.
- */
-export function isExplicitWorkHubCorrectionText(value, targetDisposition, targetSessionName) {
-    const intent = readWorkHubRequestIntent(value);
-    if (targetDisposition === 'create_new') {
-        return Boolean(intent.correction.cue &&
-            intent.creation.explicit &&
-            targetSessionName &&
-            workHubCreationAuthorizesTitle(intent, targetSessionName));
-    }
-    return Boolean(targetSessionName &&
-        intent.correction.cue &&
-        workHubCorrectionTargetsSession(intent, targetSessionName));
-}