ace-swarm 1.1.4 → 2.0.1

package/README.md

@@ -4,6 +4,8 @@ ACE Swarm packages the ACE framework (agents, skills, schemas, prompts, tasks, h
 
 Swarm agents (`orchestrator`, `vos`, `ui`, `coders`) and composable agents (`skeptic`, `ops`, `research`, `spec`, `builder`, `qa`, `docs`) are treated as one unified agent system, with composable agents available as subagents for every swarm workflow.
 
+Suggestions and collaborations: `voybio.fundr@gmail.com`.
+
 ## Install
 
 ```bash
@@ -122,23 +124,30 @@ ace paths                               # show resolved package/workspace paths
 
 ### Interactive TUI
 
-Launch a full-screen terminal dashboard with Ollama model chat, agent tabs, telemetry, and task tracking:
+Launch a full-screen terminal dashboard with provider-aware model chat, agent tabs, telemetry, and task tracking:
 
 ```bash
 ace tui
 ace tui --model llama3.1:8b --ollama-url http://127.0.0.1:11434
 ```
 
-The TUI starts regardless of whether Ollama is running. Use `/ollama` inside the TUI to check status, or `/pull <model>` to download models.
+The TUI starts regardless of whether Ollama is running. Use `/ollama` inside the TUI to check status, or `/pull <model>` to download Ollama models.
+
+For non-ollama providers, configure an OpenAI-compatible endpoint before chatting:
+
+- `OPENAI_API_KEY` (required) and optional `OPENAI_BASE_URL`
+- or provider-specific vars `${PROVIDER}_API_KEY` and `${PROVIDER}_BASE_URL` (example: `CODEX_API_KEY`, `CODEX_BASE_URL`)
 
 Key commands inside TUI:
 
 | Command | Description |
 |---------|-------------|
-| `/models` | List available Ollama models |
+| `/provider [name]` | Show or switch active provider |
+| `/providers` | List discovered providers |
+| `/models` | List available models for active provider |
 | `/model <name>` | Switch active model |
-| `/pull <name>` | Download a model |
-| `/ollama` | Check Ollama connection status |
+| `/pull <name>` | Download an Ollama model |
+| `/ollama` | Check Ollama connection status and hints |
 | `/agent <role>` | Start a subagent in a new tab |
 | `/agents` | List all agent roles and status |
 | `/status` | Show orchestrator status |
@@ -206,6 +215,25 @@ Resources:
 - `ace://kanban` (JSON)
 - `ace://kanban/html` (HTML)
 
+## Scheduler Queue (Runtime)
+
+ACE Swarm now supports a lease-owned, rolling-horizon scheduler for handoff/job execution:
+
+- `agent-state/job-queue.json`
+- `agent-state/job-reservations.json`
+- `agent-state/scheduler-lease.json`
+
+Priority and planning model:
+
+- Priority-aware (`P0 > P1 > P2 > P3`) with FIFO ordering inside each band.
+- Collision-free reservations over shared resources/time slices.
+- Rolling-horizon replanning on each scheduler tick.
+
+Handoff integration:
+
+- `create_handoff` and `ack_handoff` automatically sync lifecycle updates into scheduler jobs.
+- Scheduler replanning is triggered automatically during these handoff transitions.
+
 ## New Runtime State Stores
 
 ACE Swarm now persists additional orchestration stores:
@@ -214,6 +242,9 @@ ACE Swarm now persists additional orchestration stores:
 - `agent-state/todo-state.json` (explicit TODO statuses, dependencies, transition gates)
 - `agent-state/index.json` (workspace delta scan index)
 - `agent-state/handoff-registry.json` (handoff lifecycle: `open|accepted|blocked|completed`)
+- `agent-state/job-queue.json` (scheduler jobs with dependency/priority metadata)
+- `agent-state/job-reservations.json` (resource/time reservation table)
+- `agent-state/scheduler-lease.json` (active scheduler owner/heartbeat)
 
 New/extended tools:
 
@@ -221,12 +252,16 @@ New/extended tools:
 - `scan_workspace_delta` writes indexed changed/unchanged/deleted diffs
 - `ack_handoff` updates handoff lifecycle status
 - `get_run_ledger`, `get_todo_state`, `get_handoff_status` expose persisted store state
+- Scheduler: `enqueue_job`, `list_jobs`, `ack_job`, `run_scheduler_tick`, `start_reserved_job`, `complete_job`, `get_reservation_table`, `get_scheduler_lease`
 
 New resources:
 
 - `ace://run-ledger`
 - `ace://index`
 - `ace://handoffs/status`
+- `ace://scheduler/queue`
+- `ace://scheduler/reservations`
+- `ace://scheduler/lease`
 - `ace://kernel/directive_kernel`
 - `ace://kernel/agent_registry`
 

package/assets/instructions/ACE.instructions.md

@@ -37,6 +37,16 @@ applyTo: 'ACE_Orchestrator'
 
 **SYNCHRONIZE:** Update `MASTER_PLAN.md` with the new reality.
 
+### 0.5 Directive: SCHEDULER-AWARE ORCHESTRATION
+
+**COMMAND:** Treat handoffs as schedulable jobs, not only static payloads.
+
+**SCHEDULE:** When work is deferred, gated, or waiting on release windows, rely on ACE scheduler state (`job-queue`, `job-reservations`, `scheduler-lease`) to track dispatch readiness.
+
+**VERIFY:** After `create_handoff` and `ack_handoff`, verify scheduler sync (`list_jobs`, `get_scheduler_lease`) and ensure rolling-horizon replanning is active.
+
+**ESCALATE:** If scheduler lease ownership blocks dispatch, record the blocker and reroute through ACE-Ops instead of bypassing scheduler contracts.
+
 ### 0.4 Directive: THE CLARITY PROTOCOL (The Manager's Mind)
 
 **COMMAND:** You must think before you route. Execute this Socratic loop for every request.

package/assets/tasks/README.md

@@ -10,6 +10,9 @@ This directory contains shared execution artifacts consumed by ACE prompts, tool
 - `cli_work_split.md`: Codex CLI vs Gemini CLI routing contract.
 - `SWARM_HANDOFF.template.json`: canonical inter-agent handoff schema.
 - `SWARM_HANDOFF.example*.json`: concrete routing examples.
+- `agent-state/job-queue.json`: scheduler job queue for deferred/gated dispatch.
+- `agent-state/job-reservations.json`: collision-free scheduler reservations.
+- `agent-state/scheduler-lease.json`: active scheduler lease ownership.
 
 ## Operating Rules
 

package/assets/tasks/role_tasks.md

@@ -64,12 +64,14 @@
 - Maintain dependency order and blocker/circuit-breaker state.
 - Publish truthful `STATUS.md` and schema-valid handoffs.
 - Route work to the next role with bounded scope.
+- Keep scheduler flow healthy for deferred/gated work (`enqueue_job`, `run_scheduler_tick`, lease ownership checks).
 
 **Required evidence**
 
 - Updated `STATUS.md` with active phase, blockers, and next action.
 - Updated `HANDOFF.json` (or SWARM handoff payload) with evidence anchors.
 - Blocker transitions captured in `EVIDENCE_LOG.md`.
+- Scheduler evidence when applicable (`agent-state/job-queue.json`, `agent-state/job-reservations.json`, `agent-state/scheduler-lease.json`).
 
 ## ACE-Research Task Pack
 

package/dist/agent-runtime/role-adapters.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared role adapter engine for worker implementations.
+ *
+ * This module is transport-agnostic so both TUI and non-TUI workers can reuse
+ * the same role-intent planning behavior.
+ */
+export type AdapterDomain = "venture" | "ux" | "engineering" | "mixed" | "research";
+export interface ToolIntent {
+    tool: string;
+    args: Record<string, unknown>;
+}
+export interface HandoffIntent {
+    from: string;
+    to: string;
+    payload: Record<string, unknown>;
+}
+export interface AdapterDecision {
+    toolCalls: ToolIntent[];
+    handoffs: HandoffIntent[];
+    notes: string[];
+    domain: AdapterDomain;
+    confidence: number;
+    confidenceLevel: "low" | "medium" | "high";
+}
+export declare function inferDomain(input: string): AdapterDomain;
+export declare function parseManualHandoffCommand(input: string): HandoffIntent | undefined;
+export declare function parseManualToolCommand(input: string): ToolIntent | undefined;
+export declare function planRoleExecution(roleValue: string, input: string): AdapterDecision;
+//# sourceMappingURL=role-adapters.d.ts.map

package/dist/agent-runtime/role-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-adapters.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/role-adapters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC;AAIpF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC5C;AA0FD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAGxD;AA2GD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAclF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAiB5E;AA2DD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAwRnF"}