agent-orchestrator-mcp-server 0.4.2 → 0.4.4

package/package.json

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

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

@@ -16,6 +16,7 @@ export interface RawAgentRoot {
     default_stop_condition?: string;
     default?: boolean;
     default_mcp_servers?: string[];
+    default_skills?: string[];
 }
 /**
  * Maps a raw API agent root to the normalized AgentRootInfo interface.

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

@@ -415,6 +415,7 @@ export function createIntegrationMockOrchestratorClient(initialMockData) {
                         git_root: 'https://github.com/pulsemcp/mcp-servers.git',
                         default_branch: 'main',
                         default_mcp_servers: ['github-development'],
+                        default_skills: ['discovery-classify', 'discovery-validate'],
                     },
                 ],
                 stop_conditions: [

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

@@ -18,6 +18,7 @@ export function mapAgentRoot(raw) {
         default_subdirectory: raw.subdirectory,
         default_stop_condition: raw.default_stop_condition,
         default_mcp_servers: raw.default_mcp_servers,
+        default_skills: raw.default_skills,
     };
 }
 /** Default timeout for API requests in milliseconds */

package/shared/tools/action-session.js

@@ -35,11 +35,11 @@ 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 paused session (requires "prompt" parameter)
-- **pause**: Pause a running session, transitioning it to "needs_input" status
-- **restart**: Restart a paused or failed session without providing new input
+- **follow_up**: Send a follow-up prompt to an idle session (requires "prompt" parameter)
+- **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)
-- **unarchive**: Restore an archived session to "needs_input" status
+- **unarchive**: Restore an archived session to idle "needs_input" status
 - **change_mcp_servers**: Update the MCP servers for a session (requires "mcp_servers" parameter)
 - **fork**: Fork a session from a specific transcript message (requires "message_index")
 - **refresh**: Refresh a single session's status from the execution provider

package/shared/tools/get-configs.js

@@ -11,7 +11,7 @@ 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, stop_condition)
+- **Agent roots**: Preconfigured repository settings with defaults (git_root, branch, mcp_servers, skills, stop_condition)
 - **Stop conditions**: Available session completion criteria (id, name, description)
 
 **Use this tool** to get all configuration options before calling start_session.
@@ -156,6 +156,9 @@ function formatAgentRoot(lines, root) {
     if (root.default_stop_condition) {
         lines.push(`- **Default Stop Condition:** \`${root.default_stop_condition}\``);
     }
+    if (root.default_skills && root.default_skills.length > 0) {
+        lines.push(`- **Default Skills:** ${root.default_skills.map((s) => `\`${s}\``).join(', ')}`);
+    }
     lines.push('');
 }
 function formatStopCondition(lines, condition) {

package/shared/tools/get-session.js

@@ -41,7 +41,7 @@ const TOOL_DESCRIPTION = `Get detailed information about a specific agent sessio
 
 **Use cases:**
 - View detailed session information
-- Check session status and progress
+- Check session status and progress (use transcript to determine if a "needs_input" session has completed its task or needs follow-up)
 - Retrieve session transcript for review
 - Review logs for debugging
 - Inspect subagent transcripts`;

package/shared/tools/search-sessions.js

@@ -28,14 +28,14 @@ const TOOL_DESCRIPTION = `Quick title-based search for agent sessions in the Age
 - Find a specific session by ID (set id parameter)
 - Search sessions by title keyword (set query parameter)
 - List all sessions with optional status filter
-- Monitor sessions requiring attention (status: "needs_input")
+- Monitor sessions that have completed or need attention (status: "needs_input")
 
 **Returns:** A list of matching sessions with their status, configuration, and metadata.
 
 **Session statuses:**
 - waiting: Session created, waiting to start
 - running: Agent is actively executing
-- needs_input: Agent paused, waiting for user input
+- needs_input: Agent has completed its current work and is idle. May indicate the task is done (most common) or that the agent needs additional input to continue. Check the session transcript to determine which case applies.
 - failed: Session encountered an error
 - archived: Session completed and archived`;
 /** Maximum characters to display for prompt preview */

package/shared/types.d.ts

@@ -114,6 +114,7 @@ export interface AgentRootInfo {
     default_subdirectory?: string;
     default_stop_condition?: string;
     default_mcp_servers?: string[];
+    default_skills?: string[];
 }
 export interface StopConditionInfo {
     id: string;