@accomplish_ai/agent-core-cli 0.1.7 → 0.1.9

package/README.md

@@ -156,6 +156,66 @@ data: {"type":"done","content":"Task completed"}
 
 WebSocket endpoint. Same message format as SSE. Replays history on connect, streams live updates, closes automatically when the job completes.
 
+## TaskManagerAPI Surface
+
+The CLI wraps `@accomplish_ai/agent-core`'s `TaskManagerAPI`. Currently only `startTask` and `dispose` are used by the HTTP server. The full API surface is documented below for consumers and contributors.
+
+### Task Lifecycle
+
+| Method | Description | Used by CLI |
+|--------|-------------|:-----------:|
+| `startTask(taskId, config, callbacks)` | Start a task with prompt, config, and event callbacks | Yes |
+| `interruptTask(taskId)` | Soft stop — sends Ctrl+C to the agent process for graceful shutdown | No |
+| `cancelTask(taskId)` | Hard stop — kills the agent process immediately | No |
+| `cancelQueuedTask(taskId)` | Cancel a task waiting in the queue (before it starts running) | No |
+| `cancelAllTasks()` | Cancel all running and queued tasks | No |
+| `sendResponse(taskId, response)` | Send a response to a task waiting for input (e.g. permission prompt) | No |
+| `dispose()` | Dispose resources and clean up all processes | Yes |
+
+### Task State Queries
+
+| Method | Description | Used by CLI |
+|--------|-------------|:-----------:|
+| `isTaskRunning(taskId)` | Check if a specific task is currently running | No |
+| `hasActiveTask(taskId)` | Check if a task is active (running or queued) | No |
+| `hasRunningTask()` | Check if any task is currently running | No |
+| `isTaskQueued(taskId)` | Check if a task is waiting in the queue | No |
+| `getQueueLength()` | Get number of queued tasks | No |
+| `getActiveTaskIds()` | Get IDs of all active tasks | No |
+| `getActiveTaskId()` | Get ID of the currently running task | No |
+| `getActiveTaskCount()` | Get count of active tasks (running + queued) | No |
+| `getIsFirstTask()` | Check if this is the first task in the session | No |
+| `getSessionId(taskId)` | Get the session ID for a task | No |
+
+### Task Callbacks
+
+Callbacks passed to `startTask()` for receiving lifecycle events.
+
+| Callback | Required | Description | Used by CLI |
+|----------|:--------:|-------------|:-----------:|
+| `onMessage(message)` | No | Raw message from the agent (streamed as-is) | Yes |
+| `onBatchedMessages(messages)` | No | Batched/processed messages (50ms batches) | No |
+| `onProgress(progress)` | Yes | Task progress updates | Yes |
+| `onPermissionRequest(request)` | Yes | Agent needs permission to proceed | Yes |
+| `onComplete(result)` | Yes | Task finished (success or failure) | Yes |
+| `onError(error)` | Yes | Unrecoverable error during execution | Yes |
+| `onStatusChange(status)` | No | Task status transitions | No |
+| `onDebug(info)` | No | Debug/diagnostic information | No |
+| `onTodoUpdate(todos)` | No | Agent's internal todo list changes | No |
+| `onAuthError(error)` | No | Authentication/API key errors | No |
+
+### Configuration
+
+Factory options passed to `createTaskManager()`.
+
+| Option | Required | Description |
+|--------|:--------:|-------------|
+| `adapterOptions` | Yes | Platform, CLI command, environment builder, CLI args builder |
+| `defaultWorkingDirectory` | Yes | Default working directory for tasks |
+| `maxConcurrentTasks` | No | Max parallel tasks (CLI sets `1`) |
+| `isCliAvailable` | Yes | Async check that the OpenCode CLI is installed |
+| `onBeforeTaskStart` | No | Hook called before each task starts |
+
 ## Development
 
 ```bash

package/dist/core/init.js

@@ -84,13 +84,21 @@ function resolveMcpToolsPath() {
         if (fs.existsSync(candidate))
             return candidate;
     }
-    // Fallback: use import.meta.resolve
+    // Fallback: resolve the package entry and walk up to find mcp-tools.
+    // import.meta.resolve returns the main entry file (e.g. .../agent-core/dist/index.js),
+    // so path.dirname alone gives dist/, not the package root. Walk up until
+    // we find the mcp-tools sibling directory.
     try {
-        const agentCorePath = path.dirname(new URL(import.meta.resolve('@accomplish_ai/agent-core')).pathname);
-        return path.join(agentCorePath, 'mcp-tools');
+        const entryFile = new URL(import.meta.resolve('@accomplish_ai/agent-core')).pathname;
+        for (let dir = path.dirname(entryFile); dir !== path.dirname(dir); dir = path.dirname(dir)) {
+            const mcpTools = path.join(dir, 'mcp-tools');
+            if (fs.existsSync(mcpTools))
+                return mcpTools;
+        }
     }
     catch {
-        return path.join(process.cwd(), 'mcp-tools');
+        // import.meta.resolve failed (package not resolvable from here)
     }
+    return path.join(process.cwd(), 'mcp-tools');
 }
 //# sourceMappingURL=init.js.map

package/dist/core/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@accomplish_ai/agent-core-cli",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Headless CLI wrapping @accomplish_ai/agent-core",
   "license": "MIT",
   "type": "module",