agent-orchestrator-mcp-server 0.7.17 → 0.8.0

package/README.md

@@ -25,7 +25,7 @@ MCP server for PulseMCP's agent-orchestrator: a Claude Code + MCP-powered agent-
 | -------------------------- | ------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `quick_search_sessions`    | sessions      | read       | Quick title-based search/list sessions with optional ID lookup, title query, and status filter                                                                                          |
 | `get_session`              | sessions      | read       | Get detailed session info with optional logs, transcripts, and transcript format (text/json)                                                                                            |
-| `get_configs`              | sessions      | read       | Fetch all static configuration (MCP servers, agent roots, stop conditions)                                                                                                              |
+| `get_configs`              | sessions      | read       | Fetch all static configuration (MCP servers, agent roots, goals)                                                                                                                        |
 | `get_transcript_archive`   | sessions      | read       | Get download URL and metadata for the transcript archive zip file                                                                                                                       |
 | `start_session`            | sessions      | write      | Create and start a new agent session                                                                                                                                                    |
 | `action_session`           | sessions      | write      | Perform actions: follow_up, pause, restart, archive, unarchive, change_mcp_servers, change_model, fork, refresh, refresh_all, update_notes, update_title, toggle_favorite, bulk_archive |
@@ -40,12 +40,12 @@ MCP server for PulseMCP's agent-orchestrator: a Claude Code + MCP-powered agent-
 
 ### Resources
 
-| Resource                                       | Description                                     |
-| ---------------------------------------------- | ----------------------------------------------- |
-| `agent-orchestrator://config`                  | Server configuration and status (for debugging) |
-| `agent-orchestrator://configs/mcp-servers`     | List of available MCP servers for sessions      |
-| `agent-orchestrator://configs/agent-roots`     | Preconfigured repository settings with defaults |
-| `agent-orchestrator://configs/stop-conditions` | Session completion criteria definitions         |
+| Resource                                   | Description                                     |
+| ------------------------------------------ | ----------------------------------------------- |
+| `agent-orchestrator://config`              | Server configuration and status (for debugging) |
+| `agent-orchestrator://configs/mcp-servers` | List of available MCP servers for sessions      |
+| `agent-orchestrator://configs/agent-roots` | Preconfigured repository settings with defaults |
+| `agent-orchestrator://configs/goals`       | Session completion criteria definitions         |
 
 ### Tool Groups
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-orchestrator-mcp-server",
-  "version": "0.7.17",
+  "version": "0.8.0",
   "description": "Local implementation of agent-orchestrator MCP server",
   "main": "build/index.js",
   "type": "module",

package/shared/orchestrator-client/orchestrator-client.d.ts

@@ -13,7 +13,7 @@ export interface RawAgentRoot {
     default_branch?: string;
     subdirectory?: string;
     custom?: boolean;
-    default_stop_condition?: string;
+    default_goal?: string;
     default?: boolean;
     default_mcp_servers?: string[];
     default_skills?: string[];
@@ -52,7 +52,7 @@ export interface IAgentOrchestratorClient {
     unarchiveSession(id: string | number): Promise<Session>;
     followUp(id: string | number, prompt: string, options?: {
         force_immediate?: boolean;
-        stop_condition?: string;
+        goal?: string;
     }): Promise<SessionActionResponse>;
     pauseSession(id: string | number): Promise<SessionActionResponse>;
     sleepSession(id: string | number): Promise<Session>;
@@ -98,11 +98,11 @@ export interface IAgentOrchestratorClient {
     getEnqueuedMessage(sessionId: string | number, messageId: number): Promise<EnqueuedMessage>;
     createEnqueuedMessage(sessionId: string | number, data: {
         content: string;
-        stop_condition?: string;
+        goal?: string;
     }): Promise<EnqueuedMessage>;
     updateEnqueuedMessage(sessionId: string | number, messageId: number, data: {
         content?: string;
-        stop_condition?: string;
+        goal?: string;
     }): Promise<EnqueuedMessage>;
     deleteEnqueuedMessage(sessionId: string | number, messageId: number): Promise<void>;
     reorderEnqueuedMessage(sessionId: string | number, messageId: number, position: number): Promise<EnqueuedMessage>;
@@ -179,7 +179,7 @@ export declare class AgentOrchestratorClient implements IAgentOrchestratorClient
     unarchiveSession(id: string | number): Promise<Session>;
     followUp(id: string | number, prompt: string, options?: {
         force_immediate?: boolean;
-        stop_condition?: string;
+        goal?: string;
     }): Promise<SessionActionResponse>;
     pauseSession(id: string | number): Promise<SessionActionResponse>;
     sleepSession(id: string | number): Promise<Session>;
@@ -225,11 +225,11 @@ export declare class AgentOrchestratorClient implements IAgentOrchestratorClient
     getEnqueuedMessage(sessionId: string | number, messageId: number): Promise<EnqueuedMessage>;
     createEnqueuedMessage(sessionId: string | number, data: {
         content: string;
-        stop_condition?: string;
+        goal?: string;
     }): Promise<EnqueuedMessage>;
     updateEnqueuedMessage(sessionId: string | number, messageId: number, data: {
         content?: string;
-        stop_condition?: string;
+        goal?: string;
     }): Promise<EnqueuedMessage>;
     deleteEnqueuedMessage(sessionId: string | number, messageId: number): Promise<void>;
     reorderEnqueuedMessage(sessionId: string | number, messageId: number, position: number): Promise<EnqueuedMessage>;

package/shared/orchestrator-client/orchestrator-client.integration-mock.js

@@ -20,7 +20,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 branch: 'main',
                 subdirectory: null,
                 execution_provider: 'local_filesystem',
-                stop_condition: null,
+                goal: null,
                 mcp_servers: ['github-development'],
                 config: {},
                 metadata: { clone_path: 'repo-main-123' },
@@ -144,7 +144,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 branch: data.branch || 'main',
                 subdirectory: data.subdirectory || null,
                 execution_provider: data.execution_provider || 'local_filesystem',
-                stop_condition: data.stop_condition || null,
+                goal: data.goal || null,
                 mcp_servers: data.mcp_servers || [],
                 config: data.config || {},
                 metadata: {},
@@ -168,8 +168,8 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 session.title = data.title;
             if (data.slug !== undefined)
                 session.slug = data.slug;
-            if (data.stop_condition !== undefined)
-                session.stop_condition = data.stop_condition;
+            if (data.goal !== undefined)
+                session.goal = data.goal;
             if (data.mcp_servers !== undefined)
                 session.mcp_servers = data.mcp_servers;
             if (data.custom_metadata !== undefined)
@@ -447,7 +447,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                         default_skills: ['discovery-classify', 'discovery-validate'],
                     },
                 ],
-                stop_conditions: [
+                goals: [
                     {
                         id: 'pr_merged',
                         name: 'PR Merged',
@@ -546,7 +546,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 id: messageId,
                 session_id: 1,
                 content: 'Test message',
-                stop_condition: null,
+                goal: null,
                 position: 1,
                 status: 'pending',
                 created_at: new Date().toISOString(),
@@ -558,7 +558,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 id: 1,
                 session_id: Number(sessionId),
                 content: data.content,
-                stop_condition: data.stop_condition || null,
+                goal: data.goal || null,
                 position: 1,
                 status: 'pending',
                 created_at: new Date().toISOString(),
@@ -570,7 +570,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 id: messageId,
                 session_id: 1,
                 content: data.content || 'Updated message',
-                stop_condition: data.stop_condition || null,
+                goal: data.goal || null,
                 position: 1,
                 status: 'pending',
                 created_at: new Date().toISOString(),
@@ -585,7 +585,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 id: messageId,
                 session_id: 1,
                 content: 'Test message',
-                stop_condition: null,
+                goal: null,
                 position,
                 status: 'pending',
                 created_at: new Date().toISOString(),
@@ -614,7 +614,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 status: 'enabled',
                 agent_root_name: 'mcp-servers',
                 prompt_template: 'Test prompt',
-                stop_condition: null,
+                goal: null,
                 reuse_session: false,
                 mcp_servers: [],
                 conditions: [
@@ -650,7 +650,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 status: data.status || 'enabled',
                 agent_root_name: data.agent_root_name,
                 prompt_template: data.prompt_template,
-                stop_condition: data.stop_condition || null,
+                goal: data.goal || null,
                 reuse_session: data.reuse_session || false,
                 mcp_servers: data.mcp_servers || [],
                 conditions,
@@ -676,7 +676,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 status: data.status || 'enabled',
                 agent_root_name: data.agent_root_name || 'mcp-servers',
                 prompt_template: data.prompt_template || 'Test prompt',
-                stop_condition: data.stop_condition || null,
+                goal: data.goal || null,
                 reuse_session: data.reuse_session || false,
                 mcp_servers: data.mcp_servers || [],
                 conditions,
@@ -697,7 +697,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                 status: 'disabled',
                 agent_root_name: 'mcp-servers',
                 prompt_template: 'Test prompt',
-                stop_condition: null,
+                goal: null,
                 reuse_session: false,
                 mcp_servers: [],
                 conditions: [],

package/shared/orchestrator-client/orchestrator-client.js

@@ -16,7 +16,7 @@ export function mapAgentRoot(raw) {
         git_root: raw.url,
         default_branch: raw.default_branch,
         default_subdirectory: raw.subdirectory,
-        default_stop_condition: raw.default_stop_condition,
+        default_goal: raw.default_goal,
         default_mcp_servers: raw.default_mcp_servers,
         default_skills: raw.default_skills,
         default_model: raw.default_model,
@@ -208,7 +208,7 @@ export class AgentOrchestratorClient {
         return this.request('POST', `/sessions/${id}/follow_up`, {
             prompt,
             ...(options?.force_immediate && { force_immediate: true }),
-            ...(options?.stop_condition && { stop_condition: options.stop_condition }),
+            ...(options?.goal && { goal: options.goal }),
         });
     }
     async pauseSession(id) {
@@ -282,7 +282,7 @@ export class AgentOrchestratorClient {
         return {
             mcp_servers: raw.mcp_servers,
             agent_roots: raw.agent_roots.map(mapAgentRoot),
-            stop_conditions: raw.stop_conditions,
+            goals: raw.goals,
         };
     }
     // Notifications

package/shared/resources.js

@@ -26,12 +26,12 @@ export function createRegisterResources(clientFactory) {
                     {
                         uri: 'agent-orchestrator://configs/agent-roots',
                         name: 'Agent Roots',
-                        description: 'Preconfigured repository settings with default branch, MCP servers, and stop conditions.',
+                        description: 'Preconfigured repository settings with default branch, MCP servers, and goals.',
                         mimeType: 'application/json',
                     },
                     {
-                        uri: 'agent-orchestrator://configs/stop-conditions',
-                        name: 'Stop Conditions',
+                        uri: 'agent-orchestrator://configs/goals',
+                        name: 'Goals',
                         description: 'Available session completion criteria for use with start_session.',
                         mimeType: 'application/json',
                     },
@@ -121,15 +121,15 @@ export function createRegisterResources(clientFactory) {
                         ],
                     };
                 }
-                if (uri === 'agent-orchestrator://configs/stop-conditions') {
+                if (uri === 'agent-orchestrator://configs/goals') {
                     return {
                         contents: [
                             {
                                 uri,
                                 mimeType: 'application/json',
                                 text: JSON.stringify({
-                                    stop_conditions: configs.stop_conditions,
-                                    _usage: 'Use the "id" field when specifying stop_condition in start_session',
+                                    goals: configs.goals,
+                                    _usage: 'Use the "id" field when specifying goal in start_session',
                                 }, null, 2),
                             },
                         ],

package/shared/tools/action-session.js

@@ -43,7 +43,7 @@ export const ActionSessionSchema = z.object({
 const TOOL_DESCRIPTION = `Perform an action on an agent session.
 
 **Actions:**
-- **follow_up**: Send a follow-up prompt to a session (requires "prompt"; optional "force_immediate" to interrupt a running session). Without "force_immediate", uses smart routing: sends immediately if idle, auto-queues if running. Alternative: use manage_enqueued_messages "send_now" for one-step immediate delivery with stop_condition support.
+- **follow_up**: Send a follow-up prompt to a session (requires "prompt"; optional "force_immediate" to interrupt a running session). Without "force_immediate", uses smart routing: sends immediately if idle, auto-queues if running. Alternative: use manage_enqueued_messages "send_now" for one-step immediate delivery with goal support.
 - **pause**: Pause a running session, transitioning it to idle "needs_input" status
 - **restart**: Restart an idle or failed session without providing new input
 - **archive**: Archive a session (marks as completed)
@@ -527,7 +527,7 @@ const SELF_SESSION_TOOL_DESCRIPTION = `Perform a self-management action on a ses
 - Archive the session when work is complete
 
 **Archive guidelines:**
-- Only self-archive when explicitly instructed to (e.g., a stop condition says "archive yourself")
+- Only self-archive when explicitly instructed to (e.g., a goal says "archive yourself")
 - Subagents that report results back to a parent agent via a tool call may self-archive, since no human needs to read the session output directly
 - Do NOT self-archive if a human user needs to read your output. Sessions in \`needs_input\` appear on the user's homepage — archiving removes them before the user can see your work. If your work product is a message the user should read, let the session stay in \`needs_input\``;
 export function selfSessionActionSessionTool(_server, clientFactory) {

package/shared/tools/action-trigger.d.ts

@@ -9,14 +9,14 @@ export declare const ActionTriggerSchema: z.ZodObject<{
     agent_root_name: z.ZodOptional<z.ZodString>;
     prompt_template: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
-    stop_condition: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
     reuse_session: z.ZodOptional<z.ZodBoolean>;
     mcp_servers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     configuration: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     action: "create" | "update" | "delete" | "toggle";
     status?: "enabled" | "disabled" | undefined;
-    stop_condition?: string | undefined;
+    goal?: string | undefined;
     mcp_servers?: string[] | undefined;
     trigger_type?: "slack" | "schedule" | undefined;
     id?: number | undefined;
@@ -28,7 +28,7 @@ export declare const ActionTriggerSchema: z.ZodObject<{
 }, {
     action: "create" | "update" | "delete" | "toggle";
     status?: "enabled" | "disabled" | undefined;
-    stop_condition?: string | undefined;
+    goal?: string | undefined;
     mcp_servers?: string[] | undefined;
     trigger_type?: "slack" | "schedule" | undefined;
     id?: number | undefined;
@@ -75,7 +75,7 @@ export declare function actionTriggerTool(_server: Server, clientFactory: () =>
                 enum: string[];
                 description: string;
             };
-            stop_condition: {
+            goal: {
                 type: string;
                 description: string;
             };

package/shared/tools/action-trigger.js

@@ -9,7 +9,7 @@ export const ActionTriggerSchema = z.object({
     agent_root_name: z.string().optional(),
     prompt_template: z.string().optional(),
     status: z.enum(['enabled', 'disabled']).optional(),
-    stop_condition: z.string().optional(),
+    goal: z.string().optional(),
     reuse_session: z.boolean().optional(),
     mcp_servers: z.array(z.string()).optional(),
     configuration: z.record(z.unknown()).optional(),
@@ -49,7 +49,7 @@ export function actionTriggerTool(_server, clientFactory) {
                 agent_root_name: { type: 'string', description: 'Agent root name. Required for create.' },
                 prompt_template: { type: 'string', description: 'Prompt template. Required for create.' },
                 status: { type: 'string', enum: ['enabled', 'disabled'], description: 'Trigger status.' },
-                stop_condition: { type: 'string', description: 'Stop condition for triggered sessions.' },
+                goal: { type: 'string', description: 'Goal for triggered sessions.' },
                 reuse_session: { type: 'boolean', description: 'Whether to reuse existing sessions.' },
                 mcp_servers: {
                     type: 'array',
@@ -103,7 +103,7 @@ export function actionTriggerTool(_server, clientFactory) {
                             agent_root_name: validated.agent_root_name,
                             prompt_template: validated.prompt_template,
                             status: validated.status,
-                            stop_condition: validated.stop_condition,
+                            goal: validated.goal,
                             reuse_session: validated.reuse_session,
                             mcp_servers: validated.mcp_servers,
                             configuration: validated.configuration,
@@ -136,7 +136,7 @@ export function actionTriggerTool(_server, clientFactory) {
                             agent_root_name: validated.agent_root_name,
                             prompt_template: validated.prompt_template,
                             status: validated.status,
-                            stop_condition: validated.stop_condition,
+                            goal: validated.goal,
                             reuse_session: validated.reuse_session,
                             mcp_servers: validated.mcp_servers,
                             configuration: validated.configuration,

package/shared/tools/get-configs.js

@@ -11,8 +11,8 @@ const TOOL_DESCRIPTION = `Fetches all static configuration data in a single call
 
 Returns:
 - **MCP servers**: Available servers for use with start_session (name, title, description)
-- **Agent roots**: Preconfigured repository settings with defaults (git_root, branch, mcp_servers, skills, stop_condition)
-- **Stop conditions**: Available session completion criteria (id, name, description)
+- **Agent roots**: Preconfigured repository settings with defaults (git_root, branch, mcp_servers, skills, goal)
+- **Goals**: Available session completion criteria (id, name, description)
 
 **Use this tool** to get all configuration options before calling start_session.
 
@@ -101,19 +101,19 @@ function formatResponse(configs, fromCache) {
             formatAgentRoot(lines, root);
         }
     }
-    // Stop Conditions section
+    // Goals section
     lines.push('---');
     lines.push('');
-    lines.push('## Stop Conditions');
+    lines.push('## Goals');
     lines.push('');
-    if (configs.stop_conditions.length === 0) {
-        lines.push('*No stop conditions defined.*');
+    if (configs.goals.length === 0) {
+        lines.push('*No goals defined.*');
     }
     else {
-        lines.push(`Found ${configs.stop_conditions.length} stop condition${configs.stop_conditions.length === 1 ? '' : 's'}:`);
+        lines.push(`Found ${configs.goals.length} goal${configs.goals.length === 1 ? '' : 's'}:`);
         lines.push('');
-        for (const condition of configs.stop_conditions) {
-            formatStopCondition(lines, condition);
+        for (const goal of configs.goals) {
+            formatGoal(lines, goal);
         }
     }
     // Usage hints
@@ -125,7 +125,7 @@ function formatResponse(configs, fromCache) {
     lines.push('- Use `git_root` from **Agent Roots** to start sessions with preconfigured defaults');
     lines.push('- If an **Agent Root** has a `default_subdirectory`, pass it as `subdirectory` in `start_session` — do not set `subdirectory` to arbitrary internal paths');
     lines.push("- Pass `default_skills` from **Agent Roots** in the `skills` parameter of `start_session` — sessions won't have skills loaded unless you explicitly pass them");
-    lines.push('- Use `id` values from **Stop Conditions** in `start_session` `stop_condition` parameter');
+    lines.push('- Use `id` values from **Goals** in `start_session` `goal` parameter');
     if (fromCache) {
         lines.push('');
         lines.push('*(Returned from cache. Use `force_refresh: true` to fetch fresh data.)*');
@@ -154,8 +154,8 @@ function formatAgentRoot(lines, root) {
     if (root.default_mcp_servers && root.default_mcp_servers.length > 0) {
         lines.push(`- **Default MCP Servers:** ${root.default_mcp_servers.map((s) => `\`${s}\``).join(', ')}`);
     }
-    if (root.default_stop_condition) {
-        lines.push(`- **Default Stop Condition:** \`${root.default_stop_condition}\``);
+    if (root.default_goal) {
+        lines.push(`- **Default Goal:** \`${root.default_goal}\``);
     }
     if (root.default_skills && root.default_skills.length > 0) {
         lines.push(`- **Default Skills:** ${root.default_skills.map((s) => `\`${s}\``).join(', ')}`);
@@ -165,9 +165,9 @@ function formatAgentRoot(lines, root) {
     }
     lines.push('');
 }
-function formatStopCondition(lines, condition) {
-    lines.push(`### ${condition.name}`);
-    lines.push(`- **ID:** \`${condition.id}\``);
-    lines.push(`- **Description:** ${condition.description}`);
+function formatGoal(lines, goal) {
+    lines.push(`### ${goal.name}`);
+    lines.push(`- **ID:** \`${goal.id}\``);
+    lines.push(`- **Description:** ${goal.description}`);
     lines.push('');
 }

package/shared/tools/get-session.js

@@ -69,8 +69,8 @@ function formatSessionDetails(session, includeTranscript) {
     lines.push('');
     lines.push('### Execution');
     lines.push(`- **Execution Provider:** ${session.execution_provider}`);
-    if (session.stop_condition)
-        lines.push(`- **Stop Condition:** ${session.stop_condition}`);
+    if (session.goal)
+        lines.push(`- **Goal:** ${session.goal}`);
     if (session.mcp_servers && session.mcp_servers.length > 0) {
         lines.push(`- **MCP Servers:** ${session.mcp_servers.join(', ')}`);
     }

package/shared/tools/manage-enqueued-messages.d.ts

@@ -6,7 +6,7 @@ export declare const ManageEnqueuedMessagesSchema: z.ZodObject<{
     action: z.ZodEnum<["list", "get", "create", "update", "delete", "reorder", "interrupt", "send_now"]>;
     message_id: z.ZodOptional<z.ZodNumber>;
     content: z.ZodOptional<z.ZodString>;
-    stop_condition: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
     position: z.ZodOptional<z.ZodNumber>;
     page: z.ZodOptional<z.ZodNumber>;
     per_page: z.ZodOptional<z.ZodNumber>;
@@ -15,7 +15,7 @@ export declare const ManageEnqueuedMessagesSchema: z.ZodObject<{
     action: "list" | "get" | "create" | "update" | "delete" | "reorder" | "interrupt" | "send_now";
     per_page?: number | undefined;
     page?: number | undefined;
-    stop_condition?: string | undefined;
+    goal?: string | undefined;
     content?: string | undefined;
     message_id?: number | undefined;
     position?: number | undefined;
@@ -24,7 +24,7 @@ export declare const ManageEnqueuedMessagesSchema: z.ZodObject<{
     action: "list" | "get" | "create" | "update" | "delete" | "reorder" | "interrupt" | "send_now";
     per_page?: number | undefined;
     page?: number | undefined;
-    stop_condition?: string | undefined;
+    goal?: string | undefined;
     content?: string | undefined;
     message_id?: number | undefined;
     position?: number | undefined;
@@ -54,7 +54,7 @@ export declare function manageEnqueuedMessagesTool(_server: Server, clientFactor
                 type: string;
                 description: string;
             };
-            stop_condition: {
+            goal: {
                 type: string;
                 description: string;
             };

package/shared/tools/manage-enqueued-messages.js

@@ -14,7 +14,7 @@ export const ManageEnqueuedMessagesSchema = z.object({
     action: z.enum(ACTION_ENUM),
     message_id: z.number().optional(),
     content: z.string().optional(),
-    stop_condition: z.string().optional(),
+    goal: z.string().optional(),
     position: z.number().min(1).optional(),
     page: z.number().min(1).optional(),
     per_page: z.number().min(1).max(100).optional(),
@@ -32,7 +32,7 @@ Use "send_now" when you need the agent to act on something urgently. Use "create
 - **create**: Add a new message to the end of the queue for later delivery (requires "content"). The message waits until the session becomes idle.
 - **list**: List all enqueued messages for a session (supports pagination with "page" and "per_page")
 - **get**: Get a specific enqueued message by ID (requires "message_id")
-- **update**: Update an existing queued message's content or stop condition (requires "message_id")
+- **update**: Update an existing queued message's content or goal (requires "message_id")
 - **delete**: Remove a message from the queue (requires "message_id")
 - **reorder**: Change a message's position in the queue (requires "message_id" and "position")
 - **interrupt**: Pause the session and send an existing queued message immediately (requires "message_id"). Prefer "send_now" for new messages — "interrupt" is for promoting an already-queued message.`;
@@ -60,9 +60,9 @@ export function manageEnqueuedMessagesTool(_server, clientFactory) {
                     type: 'string',
                     description: 'Message content. Required for create and send_now. Optional for update.',
                 },
-                stop_condition: {
+                goal: {
                     type: 'string',
-                    description: 'Stop condition for this message. Optional for create, send_now, and update.',
+                    description: 'Goal for this message. Optional for create, send_now, and update.',
                 },
                 position: {
                     type: 'number',
@@ -83,7 +83,7 @@ export function manageEnqueuedMessagesTool(_server, clientFactory) {
             try {
                 const validated = ManageEnqueuedMessagesSchema.parse(args);
                 const client = clientFactory();
-                const { session_id, action, message_id, content, stop_condition, position, page, per_page, } = validated;
+                const { session_id, action, message_id, content, goal, position, page, per_page } = validated;
                 let result;
                 switch (action) {
                     case 'list': {
@@ -100,8 +100,8 @@ export function manageEnqueuedMessagesTool(_server, clientFactory) {
                                 lines.push(`### Position ${msg.position} (ID: ${msg.id})`);
                                 lines.push(`- **Status:** ${msg.status}`);
                                 lines.push(`- **Content:** ${msg.content.substring(0, 200)}${msg.content.length > 200 ? '...' : ''}`);
-                                if (msg.stop_condition)
-                                    lines.push(`- **Stop Condition:** ${msg.stop_condition}`);
+                                if (msg.goal)
+                                    lines.push(`- **Goal:** ${msg.goal}`);
                                 lines.push('');
                             });
                             result = lines.join('\n');
@@ -125,7 +125,7 @@ export function manageEnqueuedMessagesTool(_server, clientFactory) {
                             `- **Position:** ${msg.position}`,
                             `- **Status:** ${msg.status}`,
                             `- **Content:** ${msg.content}`,
-                            msg.stop_condition ? `- **Stop Condition:** ${msg.stop_condition}` : '',
+                            msg.goal ? `- **Goal:** ${msg.goal}` : '',
                             `- **Created:** ${msg.created_at}`,
                         ]
                             .filter(Boolean)
@@ -143,7 +143,7 @@ export function manageEnqueuedMessagesTool(_server, clientFactory) {
                         }
                         const msg = await client.createEnqueuedMessage(session_id, {
                             content,
-                            stop_condition: stop_condition || undefined,
+                            goal: goal || undefined,
                         });
                         result = [
                             '## Message Queued',
@@ -171,7 +171,7 @@ export function manageEnqueuedMessagesTool(_server, clientFactory) {
                         }
                         const msg = await client.updateEnqueuedMessage(session_id, message_id, {
                             content: content || undefined,
-                            stop_condition: stop_condition || undefined,
+                            goal: goal || undefined,
                         });
                         result = [
                             '## Message Updated',
@@ -263,7 +263,7 @@ export function manageEnqueuedMessagesTool(_server, clientFactory) {
                         }
                         const response = await client.followUp(session_id, content, {
                             force_immediate: true,
-                            stop_condition: stop_condition || undefined,
+                            goal: goal || undefined,
                         });
                         result = [
                             '## Message Sent Immediately',

package/shared/tools/search-triggers.js

@@ -92,8 +92,8 @@ export function searchTriggersTool(_server, clientFactory) {
                         `- **Reuse Session:** ${t.reuse_session ? 'Yes' : 'No'}`,
                         `- **MCP Servers:** ${t.mcp_servers && t.mcp_servers.length > 0 ? t.mcp_servers.join(', ') : '(none)'}`,
                     ];
-                    if (t.stop_condition)
-                        lines.push(`- **Stop Condition:** ${t.stop_condition}`);
+                    if (t.goal)
+                        lines.push(`- **Goal:** ${t.goal}`);
                     lines.push(`- **Sessions Created:** ${t.sessions_created_count}`);
                     if (t.last_triggered_at)
                         lines.push(`- **Last Triggered:** ${t.last_triggered_at}`);

package/shared/tools/start-session.d.ts

@@ -7,7 +7,7 @@ export declare const StartSessionSchema: z.ZodObject<{
     agent_root: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     slug: z.ZodOptional<z.ZodString>;
-    stop_condition: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
     execution_provider: z.ZodOptional<z.ZodEnum<["local_filesystem", "remote_sandbox"]>>;
     mcp_servers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -22,7 +22,7 @@ export declare const StartSessionSchema: z.ZodObject<{
     prompt?: string | undefined;
     title?: string | undefined;
     slug?: string | undefined;
-    stop_condition?: string | undefined;
+    goal?: string | undefined;
     execution_provider?: "local_filesystem" | "remote_sandbox" | undefined;
     mcp_servers?: string[] | undefined;
     agent_root?: string | undefined;
@@ -36,7 +36,7 @@ export declare const StartSessionSchema: z.ZodObject<{
     prompt?: string | undefined;
     title?: string | undefined;
     slug?: string | undefined;
-    stop_condition?: string | undefined;
+    goal?: string | undefined;
     execution_provider?: "local_filesystem" | "remote_sandbox" | undefined;
     mcp_servers?: string[] | undefined;
     agent_root?: string | undefined;
@@ -70,9 +70,9 @@ export declare function startSessionTool(_server: Server, clientFactory: () => I
                 type: string;
                 description: "URL-friendly identifier for the session. Must be unique.";
             };
-            stop_condition: {
+            goal: {
                 type: string;
-                description: "Stop condition ID from get_configs (e.g. \"pr_merged\"). The description is automatically resolved and passed to the agent as context.";
+                description: "Goal ID from get_configs (e.g. \"pr_merged\"). The description is automatically resolved and passed to the agent as context.";
             };
             execution_provider: {
                 type: string;

package/shared/tools/start-session.js

@@ -11,7 +11,7 @@ const PARAM_DESCRIPTIONS = {
         '(e.g. "Fix login redirect loop on mobile Safari", "Add dark mode toggle to settings page"). ' +
         'Only omit if you truly have zero context about the session purpose, which should be extremely rare.',
     slug: 'URL-friendly identifier for the session. Must be unique.',
-    stop_condition: 'Stop condition ID from get_configs (e.g. "pr_merged"). The description is automatically resolved and passed to the agent as context.',
+    goal: 'Goal ID from get_configs (e.g. "pr_merged"). The description is automatically resolved and passed to the agent as context.',
     execution_provider: 'Execution environment. Options: "local_filesystem" (runs locally), "remote_sandbox" (runs in isolated sandbox). Default: "local_filesystem"',
     mcp_servers: 'List of MCP server names to enable for this session. Example: ["github-development", "slack"]',
     skills: 'List of skill names to enable for this session. Always include the agent root\'s default_skills from get_configs as the starting point — omitting skills means the session gets none. Add extras as needed; removing a default should be rare and intentional. Example: ["discovery-classify", "publish-and-pr"]',
@@ -30,7 +30,7 @@ export const StartSessionSchema = z.object({
     agent_root: z.string().optional().describe(PARAM_DESCRIPTIONS.agent_root),
     title: z.string().optional().describe(PARAM_DESCRIPTIONS.title),
     slug: z.string().optional().describe(PARAM_DESCRIPTIONS.slug),
-    stop_condition: z.string().optional().describe(PARAM_DESCRIPTIONS.stop_condition),
+    goal: z.string().optional().describe(PARAM_DESCRIPTIONS.goal),
     execution_provider: z
         .enum(['local_filesystem', 'remote_sandbox'])
         .optional()
@@ -44,7 +44,7 @@ export const StartSessionSchema = z.object({
 });
 const TOOL_DESCRIPTION = `Start a new agent session in the Agent Orchestrator.
 
-**IMPORTANT:** Before starting a session, call get_configs to discover available agent roots, MCP servers, stop conditions, and their defaults.
+**IMPORTANT:** Before starting a session, call get_configs to discover available agent roots, MCP servers, goals, and their defaults.
 
 **Returns:** The created session with its ID, status, and configuration.
 
@@ -54,7 +54,7 @@ const TOOL_DESCRIPTION = `Start a new agent session in the Agent Orchestrator.
 
 **Agent Roots:** Use \`agent_root\` to specify which preconfigured agent root to use. The API resolves git_root, branch, subdirectory, default_model, and other defaults from the agent root configuration.
 
-**Defaults from Agent Roots:** The agent root defines \`default_mcp_servers\`, \`default_skills\`, and optionally a \`default_stop_condition\`. Omitting \`mcp_servers\` or \`skills\` means the session gets NONE — there is no automatic fallback to defaults.
+**Defaults from Agent Roots:** The agent root defines \`default_mcp_servers\`, \`default_skills\`, and optionally a \`default_goal\`. Omitting \`mcp_servers\` or \`skills\` means the session gets NONE — there is no automatic fallback to defaults.
 
 - **MCP servers:** Start with \`default_mcp_servers\`. Drop servers the task doesn't need (least-privilege). Add extras when the task requires tools beyond the defaults. When \`ALLOWED_AGENT_ROOTS\` is active, you cannot add servers beyond the defaults.
 - **Skills:** Start with \`default_skills\`. You can freely add skills beyond the defaults. Removing a default skill should be rare and intentional — only when you have a specific reason, like replacing a skill with a more capable variant that covers the same ground. Skills are lightweight text files with no blast radius, so keeping all defaults costs nothing.
@@ -91,9 +91,9 @@ export function startSessionTool(_server, clientFactory) {
                     type: 'string',
                     description: PARAM_DESCRIPTIONS.slug,
                 },
-                stop_condition: {
+                goal: {
                     type: 'string',
-                    description: PARAM_DESCRIPTIONS.stop_condition,
+                    description: PARAM_DESCRIPTIONS.goal,
                 },
                 execution_provider: {
                     type: 'string',
@@ -151,18 +151,18 @@ export function startSessionTool(_server, clientFactory) {
                         };
                     }
                 }
-                // Resolve stop_condition ID to its description so the agent receives
+                // Resolve goal ID to its description so the agent receives
                 // meaningful context about when to stop, not just an opaque identifier.
                 let createArgs = validatedArgs;
-                if (validatedArgs.stop_condition) {
+                if (validatedArgs.goal) {
                     let configs = getConfigsCache();
                     if (!configs) {
                         configs = await client.getConfigs();
                         setConfigsCache(configs);
                     }
-                    const match = configs.stop_conditions.find((sc) => sc.id === validatedArgs.stop_condition);
+                    const match = configs.goals.find((sc) => sc.id === validatedArgs.goal);
                     if (match) {
-                        createArgs = { ...validatedArgs, stop_condition: match.description };
+                        createArgs = { ...validatedArgs, goal: match.description };
                     }
                 }
                 const session = await client.createSession(createArgs);

package/shared/types.d.ts

@@ -21,7 +21,7 @@ export interface Session {
     branch: string | null;
     subdirectory: string | null;
     execution_provider: string;
-    stop_condition: string | null;
+    goal: string | null;
     mcp_servers: string[];
     catalog_skills?: string[];
     catalog_plugins?: string[];
@@ -114,12 +114,12 @@ export interface AgentRootInfo {
     git_root: string;
     default_branch?: string;
     default_subdirectory?: string;
-    default_stop_condition?: string;
+    default_goal?: string;
     default_mcp_servers?: string[];
     default_skills?: string[];
     default_model?: string;
 }
-export interface StopConditionInfo {
+export interface GoalInfo {
     id: string;
     name: string;
     description: string;
@@ -127,7 +127,7 @@ export interface StopConditionInfo {
 export interface ConfigsResponse {
     mcp_servers: MCPServerInfo[];
     agent_roots: AgentRootInfo[];
-    stop_conditions: StopConditionInfo[];
+    goals: GoalInfo[];
 }
 export interface SendPushNotificationResponse {
     success: boolean;
@@ -142,7 +142,7 @@ export interface CreateSessionRequest {
     subdirectory?: string;
     title?: string;
     slug?: string;
-    stop_condition?: string;
+    goal?: string;
     execution_provider?: string;
     mcp_servers?: string[];
     skills?: string[];
@@ -155,7 +155,7 @@ export interface CreateSessionRequest {
 export interface UpdateSessionRequest {
     title?: string;
     slug?: string;
-    stop_condition?: string;
+    goal?: string;
     mcp_servers?: string[];
     custom_metadata?: Record<string, unknown>;
 }
@@ -198,7 +198,7 @@ export interface EnqueuedMessage {
     id: number;
     session_id: number;
     content: string;
-    stop_condition: string | null;
+    goal: string | null;
     position: number;
     status: EnqueuedMessageStatus;
     created_at: string;
@@ -232,7 +232,7 @@ export interface Trigger {
     status: TriggerStatus;
     agent_root_name: string;
     prompt_template: string;
-    stop_condition: string | null;
+    goal: string | null;
     reuse_session: boolean;
     enqueue_messages?: boolean;
     resuscitate_archived?: boolean;
@@ -269,7 +269,7 @@ export interface CreateTriggerRequest {
     agent_root_name: string;
     prompt_template: string;
     status?: TriggerStatus;
-    stop_condition?: string;
+    goal?: string;
     reuse_session?: boolean;
     mcp_servers?: string[];
     last_session_id?: number;
@@ -282,7 +282,7 @@ export interface UpdateTriggerRequest {
     agent_root_name?: string;
     prompt_template?: string;
     status?: TriggerStatus;
-    stop_condition?: string;
+    goal?: string;
     reuse_session?: boolean;
     mcp_servers?: string[];
     trigger_conditions_attributes?: TriggerConditionAttributes[];