@myagentroam/node 0.9.116 → 0.9.117

package/dist/service/goal-runtime.js

@@ -0,0 +1,250 @@
+import { randomUUID } from 'node:crypto';
+export function goalUnrestrictedAccess(runner) {
+    if (runner === 'codex' || runner === 'mar-agent')
+        return 'full-access';
+    if (runner === 'claude-code')
+        return 'bypass';
+    return 'auto';
+}
+const START_OPEN = '<mar_goal_start>';
+const START_CLOSE = '</mar_goal_start>';
+const CONTINUE_OPEN = '<mar_goal_continue>';
+const CONTINUE_CLOSE = '</mar_goal_continue>';
+const LEGACY_START_OPEN = '<mar_mission_start>';
+const LEGACY_START_CLOSE = '</mar_mission_start>';
+const LEGACY_CONTINUE_OPEN = '<mar_mission_continue>';
+const LEGACY_CONTINUE_CLOSE = '</mar_mission_continue>';
+function goalPromptTags(text) {
+    if (text.startsWith(START_OPEN))
+        return { open: START_OPEN, close: START_CLOSE, legacy: false, continuation: false };
+    if (text.startsWith(CONTINUE_OPEN))
+        return { open: CONTINUE_OPEN, close: CONTINUE_CLOSE, legacy: false, continuation: true };
+    if (text.startsWith(LEGACY_START_OPEN))
+        return {
+            open: LEGACY_START_OPEN,
+            close: LEGACY_START_CLOSE,
+            legacy: true,
+            continuation: false
+        };
+    if (text.startsWith(LEGACY_CONTINUE_OPEN))
+        return {
+            open: LEGACY_CONTINUE_OPEN,
+            close: LEGACY_CONTINUE_CLOSE,
+            legacy: true,
+            continuation: true
+        };
+    return undefined;
+}
+export function publicGoalStartText(objective) {
+    const normalized = objective.trim();
+    return normalized.length === 0 ? 'Goal Start' : `Goal Start\n${normalized}`;
+}
+export function stripGoalStartPrompt(text) {
+    const tags = goalPromptTags(text);
+    if (tags === undefined)
+        return text;
+    const close = text.lastIndexOf(tags.close);
+    return close === -1 ? '' : text.slice(close + tags.close.length).trimStart();
+}
+export function publicGoalHistoryText(text) {
+    const tags = goalPromptTags(text);
+    if (tags === undefined)
+        return text;
+    const stripped = stripGoalStartPrompt(text);
+    if (stripped.length > 0)
+        return stripped;
+    if (tags.continuation)
+        return tags.legacy ? 'Mission Continue' : 'Goal Continue';
+    const close = text.lastIndexOf(tags.close);
+    const prompt = close === -1 ? text : text.slice(0, close);
+    const objectiveStart = prompt.indexOf('\nOriginal objective:\n');
+    const objectiveEnd = prompt.lastIndexOf(tags.legacy
+        ? '\n\nContinue executing this Mission across turns:'
+        : '\n\nContinue executing this Goal across turns:');
+    const objective = objectiveStart === -1 || objectiveEnd === -1
+        ? ''
+        : prompt.slice(objectiveStart + '\nOriginal objective:\n'.length, objectiveEnd);
+    return tags.legacy
+        ? objective.trim().length === 0
+            ? 'Mission Start'
+            : `Mission Start\n${objective.trim()}`
+        : publicGoalStartText(objective);
+}
+export class GoalRuntime {
+    changed;
+    goals = new Map();
+    executionFailures = new Map();
+    constructor(changed) {
+        this.changed = changed;
+    }
+    get(sessionId) {
+        return this.goals.get(sessionId);
+    }
+    migrateSession(previousId, nextId) {
+        if (previousId === nextId)
+            return;
+        const goal = this.goals.get(previousId);
+        if (goal !== undefined) {
+            this.goals.delete(previousId);
+            this.goals.set(nextId, { ...goal, sessionId: nextId });
+        }
+        const failures = this.executionFailures.get(previousId);
+        if (failures !== undefined) {
+            this.executionFailures.delete(previousId);
+            this.executionFailures.set(nextId, failures);
+        }
+    }
+    start(sessionId, objective) {
+        const normalized = objective.trim();
+        if (normalized.length === 0 || normalized.length > 20_000)
+            throw new Error('GOAL_OBJECTIVE_INVALID');
+        const current = this.goals.get(sessionId);
+        const continuing = current?.status === 'active';
+        const goal = {
+            id: continuing ? current.id : randomUUID(),
+            sessionId,
+            objective: normalized,
+            revision: continuing ? current.revision + 1 : 1,
+            status: 'active',
+            turns: 0,
+            retryRequired: false,
+            retryStartedAtTurn: null,
+            consecutiveNoProgressTurns: 0,
+            continuationPaused: false
+        };
+        this.goals.set(sessionId, goal);
+        this.executionFailures.delete(sessionId);
+        this.changed(goal);
+        return goal;
+    }
+    recordTurn(sessionId) {
+        const current = this.goals.get(sessionId);
+        if (current?.status !== 'active')
+            return current;
+        const goal = { ...current, turns: current.turns + 1 };
+        this.goals.set(sessionId, goal);
+        return goal;
+    }
+    recordExecutionResult(sessionId, input) {
+        const current = this.goals.get(sessionId);
+        if (current?.status !== 'active')
+            return 'continue';
+        if (!input.failed && !input.progressed) {
+            this.executionFailures.delete(sessionId);
+            const consecutiveNoProgressTurns = current.consecutiveNoProgressTurns + 1;
+            const paused = consecutiveNoProgressTurns >= 3;
+            const goal = {
+                ...current,
+                consecutiveNoProgressTurns,
+                continuationPaused: paused
+            };
+            this.goals.set(sessionId, goal);
+            this.changed(goal);
+            return paused ? 'paused' : 'continue';
+        }
+        if (!input.failed) {
+            this.executionFailures.delete(sessionId);
+            if (current.consecutiveNoProgressTurns > 0 || current.continuationPaused) {
+                const goal = {
+                    ...current,
+                    consecutiveNoProgressTurns: 0,
+                    continuationPaused: false
+                };
+                this.goals.set(sessionId, goal);
+                this.changed(goal);
+            }
+            return 'continue';
+        }
+        if (current.consecutiveNoProgressTurns > 0 || current.continuationPaused) {
+            const goal = {
+                ...current,
+                consecutiveNoProgressTurns: 0,
+                continuationPaused: false
+            };
+            this.goals.set(sessionId, goal);
+        }
+        const failures = (this.executionFailures.get(sessionId) ?? 0) + 1;
+        this.executionFailures.set(sessionId, failures);
+        if (failures <= 3)
+            return 'continue';
+        const blocked = {
+            ...(this.goals.get(sessionId) ?? current),
+            status: 'blocked'
+        };
+        this.goals.set(sessionId, blocked);
+        this.changed(blocked);
+        return 'blocked';
+    }
+    resume(sessionId) {
+        const current = this.goals.get(sessionId);
+        if (current?.status !== 'active')
+            return current;
+        if (!current.continuationPaused && current.consecutiveNoProgressTurns === 0)
+            return current;
+        const goal = {
+            ...current,
+            consecutiveNoProgressTurns: 0,
+            continuationPaused: false
+        };
+        this.goals.set(sessionId, goal);
+        this.changed(goal);
+        return goal;
+    }
+    blockAfterRuntimeFailure(sessionId, goalId, revision) {
+        const current = this.requireCurrent(sessionId, goalId, revision);
+        const blocked = { ...current, status: 'blocked' };
+        this.goals.set(sessionId, blocked);
+        this.executionFailures.delete(sessionId);
+        this.changed(blocked);
+        return blocked;
+    }
+    update(sessionId, goalId, revision, status) {
+        const current = this.requireCurrent(sessionId, goalId, revision);
+        if (status === 'blocked') {
+            if (current.turns < 3)
+                throw new Error('GOAL_BLOCKED_TOO_EARLY');
+            if (!current.retryRequired) {
+                const retry = {
+                    ...current,
+                    retryRequired: true,
+                    retryStartedAtTurn: current.turns
+                };
+                this.goals.set(sessionId, retry);
+                this.changed(retry);
+                return retry;
+            }
+            if (current.retryStartedAtTurn === null || current.turns <= current.retryStartedAtTurn)
+                throw new Error('GOAL_BLOCKED_RETRY_REQUIRED');
+        }
+        const goal = { ...current, status };
+        this.goals.set(sessionId, goal);
+        this.changed(goal);
+        return goal;
+    }
+    clear(sessionId) {
+        const removed = this.goals.delete(sessionId);
+        this.executionFailures.delete(sessionId);
+        if (removed)
+            this.changed(undefined);
+        return removed;
+    }
+    prompt(sessionId, kind) {
+        const goal = this.goals.get(sessionId);
+        if (goal?.status !== 'active')
+            throw new Error('GOAL_NOT_ACTIVE');
+        const heading = kind === 'start' ? 'A Goal has started or changed.' : 'Continue the active Goal.';
+        const open = kind === 'start' ? START_OPEN : CONTINUE_OPEN;
+        const close = kind === 'start' ? START_CLOSE : CONTINUE_CLOSE;
+        return `${open}\n${heading}\n\nOriginal objective:\n${goal.objective}\n\nContinue executing this Goal across turns:\n- Work on the objective now. If it is incomplete, use tools to finish a coherent unit or obtain decisive evidence; do not stop at an acknowledgement, status, plan, or promise.\n- Preserve the original scope. Before completion, review the full objective and verify it with real evidence, then call mar_update_goal with status=completed.\n- Adapt and retry after individual failures. Request blocked only after the same blocker persists for three turns and the required additional retry.\n- Use mar_get_goal only when you need to reread the authoritative objective or status.\n${close}`;
+    }
+    requireCurrent(sessionId, goalId, revision) {
+        const current = this.goals.get(sessionId);
+        if (current === undefined || current.id !== goalId)
+            throw new Error('GOAL_NOT_FOUND');
+        if (current.revision !== revision)
+            throw new Error('GOAL_REVISION_STALE');
+        if (current.status !== 'active')
+            throw new Error('GOAL_NOT_ACTIVE');
+        return current;
+    }
+}

package/dist/service/mar-agent-model-transport-test-service.js

@@ -1,13 +1,11 @@
-import { AnthropicMessagesAdapter, OpenAiResponsesAdapter } from '@myagentroam/agent';
+import { testMarAgentModelTransport } from '@myagentroam/agent';
 import { marAgentModelTransportTestInputSchema, marAgentModelTransportTestResultSchema } from '@myagentroam/protocol';
 import { runnerErrorProjection } from '../util/runner-error.js';
 export class MarAgentModelTransportTestService {
     options;
-    #adapterFactory;
     #timeoutMs;
     constructor(options) {
         this.options = options;
-        this.#adapterFactory = options.adapterFactory ?? defaultAdapter;
         this.#timeoutMs = options.timeoutMs ?? 30_000;
     }
     operations() {
@@ -26,17 +24,7 @@ export class MarAgentModelTransportTestService {
         if (configuration === undefined)
             throw new Error('MAR_AGENT_MODEL_TEST_INPUT_INVALID');
         try {
-            const adapter = this.#adapterFactory(configuration);
-            let completed = false;
-            for await (const event of adapter.start({
-                system: 'You are performing a model transport connectivity test.',
-                messages: [{ role: 'user', content: 'Reply with OK.' }],
-                tools: [],
-                allowTools: false
-            }, AbortSignal.timeout(this.#timeoutMs))) {
-                if (event.type === 'completed')
-                    completed = true;
-            }
+            const completed = await (this.options.testTransport ?? testMarAgentModelTransport)(configuration, AbortSignal.timeout(this.#timeoutMs));
             return marAgentModelTransportTestResultSchema.parse(completed
                 ? { success: true, code: null, message: null, httpStatus: null }
                 : {
@@ -66,11 +54,6 @@ function withoutNodeRequestMetadata(raw) {
     delete payload.__workspaceWatchSessionHash;
     return payload;
 }
-function defaultAdapter(configuration) {
-    return configuration.protocol === 'OPENAI_RESPONSES'
-        ? new OpenAiResponsesAdapter(configuration)
-        : new AnthropicMessagesAdapter(configuration);
-}
 function modelTestErrorProjection(error) {
     if (error === null || typeof error !== 'object')
         return runnerErrorProjection(error, 'MAR_AGENT_MODEL_CONNECTION_FAILED');

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

@@ -58,12 +58,12 @@ export class SessionCommandService {
             throw new Error('RUNNER_COMMAND_UNAVAILABLE');
         const invocation = parseCommandInvocation({ descriptor: command }, input.input);
         const secretEnvironment = parseSecretEnvironment(input.secretEnvironment);
-        if (command.id === 'mission') {
+        if (command.id === 'goal') {
             if (invocation.argument === '--clear')
-                return this.options.clearMission(session);
+                return this.options.clearGoal(session);
             if (invocation.argument.length === 0)
-                return this.options.beginMission(session);
-            return this.options.mission({
+                return this.options.beginGoal(session);
+            return this.options.goal({
                 session,
                 objective: invocation.argument,
                 ...(Number.isSafeInteger(input.__requestUserId)

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

@@ -13,7 +13,7 @@ export class SessionIdentityService {
         this.options.runtime.promoteSessionIdentity(sessionId, nativeSessionId);
         if (current !== undefined)
             this.options.persist(current, nativeSessionId);
-        this.options.migrateMission(sessionId, nativeSessionId);
+        this.options.migrateGoal(sessionId, nativeSessionId);
         this.options.migrateCommands(sessionId, nativeSessionId);
         this.options.migrateQueue(sessionId, nativeSessionId);
         this.options.migrateRunnerState(sessionId, nativeSessionId);

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

@@ -3,8 +3,8 @@ import { isImageAttachment, isRunnerImageAttachment, parseComposerAttachmentIds,
 import { parseSecretEnvironment } from '../util/secret-environment.js';
 import { personalInstructionsForRunner } from '../util/personal-instructions.js';
 import { safeErrorCode } from '../util/safe-error.js';
-import { publicMissionStartText } from './mission-runtime.js';
-const INTERNAL_MISSION = Symbol('internalMission');
+import { publicGoalStartText } from './goal-runtime.js';
+const INTERNAL_GOAL = Symbol('internalGoal');
 export class SessionMessageService {
     options;
     pendingMessages = new Map();
@@ -18,14 +18,14 @@ export class SessionMessageService {
             'session.channel.token': (data) => this.channelToken(record(data))
         };
     }
-    submitMission(input) {
+    submitGoal(input) {
         return this.message({
-            [INTERNAL_MISSION]: true,
+            [INTERNAL_GOAL]: true,
             sessionId: input.sessionId,
-            clientMessageId: `mission:${randomUUID()}`,
-            content: input.kind === 'start' ? publicMissionStartText(input.objective ?? '') : 'Mission Continue',
+            clientMessageId: `goal:${randomUUID()}`,
+            content: input.kind === 'start' ? publicGoalStartText(input.objective ?? '') : 'Goal Continue',
             __runnerContent: input.content,
-            __missionRef: input.mission,
+            __goalRef: input.goal,
             ...(input.initiatedByUserId === undefined
                 ? {}
                 : { __requestUserId: input.initiatedByUserId }),
@@ -46,10 +46,8 @@ export class SessionMessageService {
             throw new Error('MESSAGE_INVALID');
         const clientMessageId = input.clientMessageId;
         const content = input.content;
-        const internalMission = input[INTERNAL_MISSION] === true;
-        const internalRunnerContent = internalMission && typeof input.__runnerContent === 'string'
-            ? input.__runnerContent
-            : content;
+        const internalGoal = input[INTERNAL_GOAL] === true;
+        const internalRunnerContent = internalGoal && typeof input.__runnerContent === 'string' ? input.__runnerContent : content;
         const inlineAttachments = parseMessageAttachments(input.attachments);
         const secretEnvironment = parseSecretEnvironment(input.secretEnvironment);
         const attachmentIds = parseComposerAttachmentIds(input.attachmentIds);
@@ -57,7 +55,7 @@ export class SessionMessageService {
             throw new Error('MESSAGE_ATTACHMENTS_INVALID');
         const accepted = await this.options.resolve(input.sessionId);
         const session = accepted.session;
-        const personalInstructions = internalMission && typeof input.personalInstructions === 'string'
+        const personalInstructions = internalGoal && typeof input.personalInstructions === 'string'
             ? input.personalInstructions
             : personalInstructionsForRunner(input.personalInstructions, session.runner);
         const requestedIntent = input.deliveryIntent ?? 'SEND';
@@ -82,12 +80,10 @@ export class SessionMessageService {
                 idempotent: true,
                 auditReceipt: auditReceipt(session, existing.kind === 'queue' ? 'QUEUE' : 'SEND', existing.run.id, existing.kind === 'queue' ? existing.item.id : undefined)
             };
-        const missionMessage = internalMission
-            ? undefined
-            : this.options.missionMessage(session, content);
-        const runnerContent = missionMessage?.runnerContent ?? internalRunnerContent;
-        const publicContent = missionMessage?.activated === true ? publicMissionStartText(content) : content;
-        const intent = missionMessage === undefined ? requestedIntent : 'REPLACE_CURRENT';
+        const goalMessage = internalGoal ? undefined : this.options.goalMessage(session, content);
+        const runnerContent = goalMessage?.runnerContent ?? internalRunnerContent;
+        const publicContent = goalMessage?.activated === true ? publicGoalStartText(content) : content;
+        const intent = goalMessage === undefined ? requestedIntent : 'REPLACE_CURRENT';
         const operation = (async () => {
             const acceptedSession = accepted.session;
             const session = this.options.runtime.getAgentSession(acceptedSession.id) ?? acceptedSession;
@@ -106,7 +102,7 @@ export class SessionMessageService {
                 ...(inlineAttachments.length === 0 ? {} : { attachments: inlineAttachments })
             }, secretEnvironment);
             const submissionId = created.queueItem?.id ?? created.run.id;
-            const sessionForPresentation = input.__mission === true
+            const sessionForPresentation = input.__goal === true
                 ? session
                 : this.options.runtime.setTemporaryTitleIfMissing(session.id, sessionTitleFromFirstMessage(content));
             this.options.emitSession(sessionForPresentation);
@@ -158,17 +154,17 @@ export class SessionMessageService {
                             ? {}
                             : { marAgentRuntimeScopeId: input.marAgentRuntimeScopeId }),
                         ...(input.computerUse === undefined ? {} : { computerUse: input.computerUse }),
-                        ...(missionMessage !== undefined
-                            ? { mission: missionMessage.mission }
-                            : isMissionRef(input.__missionRef)
-                                ? { mission: input.__missionRef }
+                        ...(goalMessage !== undefined
+                            ? { goal: goalMessage.goal }
+                            : isGoalRef(input.__goalRef)
+                                ? { goal: input.__goalRef }
                                 : {}),
                         ...(runner.serviceTier() === 'fast' ? { serviceTier: 'fast' } : {})
                     });
                     this.options.attachments.cache(submissionId, imageAttachments);
-                    if (missionMessage !== undefined &&
-                        !this.options.prepareMissionInsertion(session.id, submissionId, missionMessage.mission))
-                        throw new Error('MISSION_REVISION_STALE');
+                    if (goalMessage !== undefined &&
+                        !this.options.prepareGoalInsertion(session.id, submissionId, goalMessage.goal))
+                        throw new Error('GOAL_REVISION_STALE');
                     const delivery = this.options.coordinator.settle({
                         submissionId,
                         intent,
@@ -179,8 +175,8 @@ export class SessionMessageService {
                     return delivery;
                 }
                 catch (error) {
-                    if (missionMessage !== undefined)
-                        this.options.missionPreparationFailed(session, missionMessage.mission, missionMessage.activated);
+                    if (goalMessage !== undefined)
+                        this.options.goalPreparationFailed(session, goalMessage.goal, goalMessage.activated);
                     this.options.coordinator.failPreparation(submissionId, safeErrorCode(error, 'MESSAGE_PREPARATION_FAILED'));
                     this.options.attachments.clear(submissionId);
                     this.options.attachments.cleanup(submissionId);
@@ -252,7 +248,7 @@ function record(value) {
         return {};
     return value;
 }
-function isMissionRef(value) {
+function isGoalRef(value) {
     return (value !== null &&
         typeof value === 'object' &&
         typeof value.id === 'string' &&

package/dist/service/workspace-queue-workbench-service.js

@@ -45,7 +45,7 @@ export class WorkspaceQueueWorkbenchService {
             paused: queue.paused,
             items: queue.itemIds.flatMap((itemId) => {
                 const item = this.options.runtime.getQueueItem(itemId);
-                if (item === undefined || item.clientMessageId.startsWith('mission:'))
+                if (item === undefined || item.clientMessageId.startsWith('goal:'))
                     return [];
                 const session = this.options.runtime.getAgentSession(item.sessionId);
                 return [

package/dist/util/runner-native-session-parsers.js

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 import { stripClaudePlanTag } from '../runner-command-engine.js';
-import { stripMissionStartPrompt } from '../service/mission-runtime.js';
+import { stripGoalStartPrompt } from '../service/goal-runtime.js';
 import { parseCodexComposerImageMarkers } from '../runner/codex/composer-image-markers.js';
 import { normalizeCodexTool } from '../runner/codex/tool-normalizer.js';
 import { normalizeClaudeTool } from '../runner/claude/tool-normalizer.js';
@@ -435,8 +435,8 @@ function runtimeUserMessagePayload(clientMessageId, runtimeTurns) {
     return undefined;
 }
 function nativeUserMessageText(runner, text) {
-    const missionFiltered = stripMissionStartPrompt(text);
-    const normalized = runner === 'claude-code' ? stripClaudePlanTag(missionFiltered) : missionFiltered;
+    const goalFiltered = stripGoalStartPrompt(text);
+    const normalized = runner === 'claude-code' ? stripClaudePlanTag(goalFiltered) : goalFiltered;
     if (runner !== 'codex')
         return normalized;
     return parseCodexComposerImageMarkers(normalized).text;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.9.116",
+  "version": "0.9.117",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -30,9 +30,9 @@
     "npm": "11.12.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/protocol": "0.9.116",
-    "@myagentroam/agent": "0.9.116",
-    "@myagentroam/code-navigation": "0.9.116"
+    "@myagentroam/agent": "0.9.117",
+    "@myagentroam/code-navigation": "0.9.117",
+    "@myagentroam/protocol": "0.9.117"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"