@elizaos/plugin-agent-orchestrator 2.0.0-alpha.9 → 2.0.0-beta.1

package/dist/node/src/services/spawn-trajectory.d.ts

@@ -0,0 +1,23 @@
+import { type IAgentRuntime, type SpawnTrajectoryHandle } from "@elizaos/core";
+export declare const TRAJECTORY_PARENT_STEP_METADATA_KEY = "parentTrajectoryStepId";
+export declare const TRAJECTORY_CHILD_STEP_METADATA_KEY = "trajectoryChildStepId";
+export declare const TRAJECTORY_LINK_SOURCE_METADATA_KEY = "trajectoryLinkSource";
+export declare const TRAJECTORY_PARENT_STEP_ENV_KEY = "MILADY_PARENT_TRAJECTORY_STEP_ID";
+export declare const TRAJECTORY_CHILD_STEP_ENV_KEY = "MILADY_TRAJECTORY_CHILD_STEP_ID";
+export interface LinkedSpawnContext {
+    parentStepId?: string;
+    metadata: Record<string, unknown>;
+    env: Record<string, string> | undefined;
+    linkChild: SpawnTrajectoryHandle["linkChild"];
+}
+interface WithLinkedSpawnOptions<T> {
+    source: string;
+    metadata?: Record<string, unknown>;
+    env?: Record<string, string>;
+    childId?: (result: T) => string | undefined;
+}
+export declare function buildLinkedSpawnMetadata(metadata: Record<string, unknown> | undefined, handle: SpawnTrajectoryHandle, source: string): Record<string, unknown>;
+export declare function buildLinkedSpawnEnv(env: Record<string, string> | undefined, handle: SpawnTrajectoryHandle): Record<string, string> | undefined;
+export declare function withLinkedSpawn<T>(runtime: IAgentRuntime | null | undefined, options: WithLinkedSpawnOptions<T>, spawn: (context: LinkedSpawnContext) => Promise<T> | T): Promise<T>;
+export {};
+//# sourceMappingURL=spawn-trajectory.d.ts.map

package/dist/node/src/services/spawn-trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-trajectory.d.ts","sourceRoot":"","sources":["../../../../src/services/spawn-trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAE3B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,mCAAmC,2BAA2B,CAAC;AAC5E,eAAO,MAAM,kCAAkC,0BAA0B,CAAC;AAC1E,eAAO,MAAM,mCAAmC,yBAAyB,CAAC;AAC1E,eAAO,MAAM,8BAA8B,qCACP,CAAC;AACrC,eAAO,MAAM,6BAA6B,oCAAoC,CAAC;AAE/E,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACxC,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;CAC/C;AAED,UAAU,sBAAsB,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CAC7C;AAOD,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAOpC;AAED,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/node/src/services/stall-classifier.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Stall classification subsystem — determines what a "stalled" task agent
+ * session is doing (finished, waiting for input, still working, or errored).
+ *
+ * Extracted as standalone functions that receive dependencies as parameters,
+ * making them easy to test without coupling to PTYService.
+ *
+ * @module services/stall-classifier
+ */
+import { type IAgentRuntime } from "@elizaos/core";
+import { type StallClassification } from "pty-manager";
+import type { AgentMetricsTracker } from "./agent-metrics.js";
+import type { DecisionHistoryEntry, TaskContextSummary } from "./swarm-coordinator-prompts.js";
+/** Everything the classifier needs, passed in from PTYService. */
+export interface StallClassifierContext {
+    sessionId: string;
+    recentOutput: string;
+    agentType: string;
+    buffers: Map<string, string[]>;
+    traceEntries: Array<string | Record<string, unknown>>;
+    runtime: IAgentRuntime;
+    manager: {
+        get(id: string): {
+            startedAt?: string | Date;
+        } | null | undefined;
+    } | null;
+    metricsTracker: AgentMetricsTracker;
+    /** Write debug snapshots to ~/.eliza/debug/ on stall (default: false) */
+    debugSnapshots?: boolean;
+    /** Most recent text input sent into the session, used to ignore echoed prompts. */
+    lastSentInput?: string;
+    log: (msg: string) => void;
+}
+/**
+ * Build the LLM system prompt used to classify stalled output.
+ */
+export declare function buildStallClassificationPrompt(agentType: string, sessionId: string, output: string): string;
+/**
+ * Write a debug snapshot to ~/.eliza/debug/ for offline stall analysis.
+ */
+export declare function writeStallSnapshot(sessionId: string, agentType: string, recentOutput: string, effectiveOutput: string, buffers: Map<string, string[]>, traceEntries: Array<string | Record<string, unknown>>, log: (msg: string) => void): Promise<void>;
+/**
+ * Main stall classification logic. Determines what a stalled session is doing
+ * by checking the buffer, building a prompt, and asking the LLM.
+ */
+export declare function classifyStallOutput(ctx: StallClassifierContext): Promise<StallClassification | null>;
+/** Context for the combined classify-and-decide call. */
+export interface CoordinatorClassifyContext extends StallClassifierContext {
+    taskContext: TaskContextSummary;
+    decisionHistory?: DecisionHistoryEntry[];
+}
+/**
+ * Build a combined prompt that classifies the stall AND decides how to respond,
+ * merging stall classification with coordinator decision guidelines.
+ *
+ * Used for coordinator-managed sessions in autonomous mode to eliminate the
+ * redundant second LLM call in the coordinator's handleBlocked path.
+ */
+export declare function buildCombinedClassifyDecidePrompt(agentType: string, sessionId: string, output: string, taskContext: TaskContextSummary, decisionHistory: DecisionHistoryEntry[]): string;
+/**
+ * Combined classify-and-decide for coordinator-managed autonomous sessions.
+ *
+ * Performs classification AND coordinator-quality response decision in a single
+ * LLM call. The suggestedResponse is kept intact (not stripped), so pty-manager
+ * auto-responds and the coordinator receives autoResponded: true — skipping
+ * the second LLM call in handleBlocked().
+ */
+export declare function classifyAndDecideForCoordinator(ctx: CoordinatorClassifyContext): Promise<StallClassification | null>;
+//# sourceMappingURL=stall-classifier.d.ts.map

package/dist/node/src/services/stall-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-classifier.d.ts","sourceRoot":"","sources":["../../../../src/services/stall-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,eAAe,CAAC;AAC9D,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAGxC,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG;YAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,GAAG,SAAS,CAAC;KACnE,GAAG,IAAI,CAAC;IACT,cAAc,EAAE,mBAAmB,CAAC;IACpC,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAiGD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAqCR;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACrD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Cf;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAoIrC;AAID,yDAAyD;AACzD,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,WAAW,EAAE,kBAAkB,CAAC;IAChC,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C;AAgCD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,kBAAkB,EAC/B,eAAe,EAAE,oBAAoB,EAAE,GACtC,MAAM,CAgDR;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAiKrC"}

package/dist/node/src/services/structured-proof-bridge.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Structured proof bridge — captures `APP_CREATE_DONE` / `PLUGIN_CREATE_DONE`
+ * sentinels emitted by spawned task agents and persists the structured claim
+ * onto the owning task's session metadata so the custom validator can
+ * cross-check the claim against actual disk state.
+ *
+ * Sibling to `skill-callback-bridge.ts`. Unlike the skill bridge, this bridge
+ * never dispatches anything back into the runtime — it only records the
+ * proof and echoes a brief acknowledgement to the PTY so the agent knows
+ * the orchestrator saw it.
+ *
+ * Sentinel grammar (one per session, on its own line):
+ *
+ *   APP_CREATE_DONE     {"appName":"foo","files":[...],"tests":{"passed":N,"failed":0},"lint":"ok","typecheck":"ok"}
+ *   PLUGIN_CREATE_DONE  {"pluginName":"plugin-bar","files":[...],"tests":{"passed":N,"failed":0},"lint":"ok","typecheck":"ok"}
+ *
+ * @module services/structured-proof-bridge
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { PTYService } from "./pty-service.js";
+import type { TaskRegistry } from "./task-registry.js";
+export type StructuredProofKind = "APP_CREATE_DONE" | "PLUGIN_CREATE_DONE";
+export type StructuredProofStatus = "ok";
+export interface StructuredProofTests {
+    passed: number;
+    failed: number;
+}
+interface BaseStructuredProofClaim {
+    /** Kind of completion sentinel emitted by the child. */
+    kind: StructuredProofKind;
+    /** Relative paths the child claims to have created/modified. Required. */
+    files: string[];
+    /** Test result summary from the child verification run. */
+    tests: StructuredProofTests;
+    /** Lint status. Completion proofs only accept "ok". */
+    lint: StructuredProofStatus;
+    /** Typecheck status. Completion proofs only accept "ok". */
+    typecheck: StructuredProofStatus;
+    /** Wall-clock timestamp when this proof was recorded. */
+    recordedAt: number;
+    /** Any other JSON fields the child included. */
+    extra?: Record<string, unknown>;
+}
+export interface AppStructuredProofClaim extends BaseStructuredProofClaim {
+    kind: "APP_CREATE_DONE";
+    appName: string;
+}
+export interface PluginStructuredProofClaim extends BaseStructuredProofClaim {
+    kind: "PLUGIN_CREATE_DONE";
+    pluginName: string;
+}
+export type StructuredProofClaim = AppStructuredProofClaim | PluginStructuredProofClaim;
+type ParsedStructuredProof = {
+    kind: "APP_CREATE_DONE";
+    claim: AppStructuredProofClaim;
+} | {
+    kind: "PLUGIN_CREATE_DONE";
+    claim: PluginStructuredProofClaim;
+};
+/**
+ * Parse the first APP_CREATE_DONE / PLUGIN_CREATE_DONE directive in a chunk
+ * of agent output, if any. The directive must be on its own line (after
+ * optional whitespace) and the JSON must include all required fields:
+ * `appName`/`pluginName`, `files`, `tests`, `lint`, and `typecheck`.
+ * Anything missing returns a structured "invalid" result so the bridge can
+ * log without persisting.
+ */
+export declare function parseStructuredProofDirective(text: string): {
+    ok: true;
+    parsed: ParsedStructuredProof;
+} | {
+    ok: false;
+    reason: string;
+} | null;
+interface BridgeDeps {
+    runtime: IAgentRuntime;
+    ptyService: PTYService;
+    /** Optional override for tests / non-default registries. */
+    taskRegistry?: TaskRegistry;
+}
+/**
+ * Reset per-session state. Tests use this to assert idempotency cleanly.
+ * Production callers can call this when a session is recycled, but the
+ * bridge is robust either way — duplicates are just logged.
+ */
+export declare function _resetStructuredProofBridge(): void;
+/**
+ * Ensure the bridge is installed exactly once for this runtime+PTY pair.
+ * Safe to call from PTYService.start() and from every task spawn.
+ */
+export declare function ensureStructuredProofBridge(runtime: IAgentRuntime, ptyService: PTYService): void;
+/**
+ * Install the structured-proof bridge. Returns a teardown function. Safe to
+ * call multiple times — the caller is responsible for deduplication via
+ * `ensureStructuredProofBridge` (or by tracking the returned teardown).
+ */
+export declare function installStructuredProofBridge(deps: BridgeDeps): () => void;
+export {};
+//# sourceMappingURL=structured-proof-bridge.d.ts.map

package/dist/node/src/services/structured-proof-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-proof-bridge.d.ts","sourceRoot":"","sources":["../../../../src/services/structured-proof-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAU,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQvD,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAC3E,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEzC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,wDAAwD;IACxD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2DAA2D;IAC3D,KAAK,EAAE,oBAAoB,CAAC;IAC5B,uDAAuD;IACvD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,4DAA4D;IAC5D,SAAS,EAAE,qBAAqB,CAAC;IACjC,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA2B,SAAQ,wBAAwB;IAC1E,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAC5B,uBAAuB,GACvB,0BAA0B,CAAC;AAE/B,KAAK,qBAAqB,GACtB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAiHtE;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,GAEV;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7B,IAAI,CAyEP;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAgBD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAQD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,UAAU,GACrB,IAAI,CAKN;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI,CAqFzE"}

package/dist/node/src/services/sub-agent-router.d.ts

@@ -0,0 +1,38 @@
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * SubAgentRouter takes terminal-significant ACPX session events
+ * (`task_complete`, `error`, `blocked`) and posts them as synthetic inbound
+ * messages into the runtime so the main agent's normal action layer can
+ * decide whether to:
+ *   - REPLY to the user,
+ *   - SEND_TO_AGENT to push the sub-agent further,
+ *   - or both.
+ *
+ * Routing keys are read from `session.metadata` populated by TASKS op=create
+ * at spawn time: `roomId`, `worldId`, `userId`, `messageId`, `source`, `label`.
+ *
+ * Streaming chunks (`agent_message_chunk`, `tool_running`) are intentionally
+ * NOT injected — they would refire the planner constantly and burn cache.
+ * The provider is the channel for live status; this router is the channel for
+ * boundary events that warrant a decision.
+ */
+export declare class SubAgentRouter {
+    static serviceType: string;
+    static dependencies: string[];
+    capabilityDescription: string;
+    private readonly runtime;
+    private acp;
+    private unsubscribe;
+    private readonly delivered;
+    private readonly roundTripCounts;
+    private readonly capExceededSessions;
+    private started;
+    private roundTripCap;
+    constructor(runtime: IAgentRuntime);
+    static start(runtime: IAgentRuntime): Promise<SubAgentRouter>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleEvent;
+    private log;
+}
+//# sourceMappingURL=sub-agent-router.d.ts.map

package/dist/node/src/services/sub-agent-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-router.d.ts","sourceRoot":"","sources":["../../../../src/services/sub-agent-router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,eAAe,CAAC;AAQjE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,MAAM,CAAC,WAAW,SAA2B;IAC7C,MAAM,CAAC,YAAY,WAA8B;IAEjD,qBAAqB,SACkI;IAEvJ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAA0B;gBAElC,OAAO,EAAE,aAAa;WAIrB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAM7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUb,WAAW;IAoIzB,OAAO,CAAC,GAAG;CAeZ"}

package/dist/node/src/services/swarm-coordinator-prompts.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Prompt construction and response parsing for the Swarm Coordinator's
+ * LLM-driven coordination decisions.
+ *
+ * Pure functions — no side effects, easy to test.
+ * Pattern follows stall-classifier.ts:buildStallClassificationPrompt().
+ *
+ * @module services/swarm-coordinator-prompts
+ */
+/** Per-session task context provided to the LLM for decision-making. */
+export interface TaskContextSummary {
+    sessionId: string;
+    agentType: string;
+    label: string;
+    originalTask: string;
+    workdir: string;
+    repo?: string;
+}
+/** A previous coordination decision, included for context continuity. */
+export interface DecisionHistoryEntry {
+    event: string;
+    promptText: string;
+    action: string;
+    response?: string;
+    reasoning: string;
+}
+/** Summary of a sibling task in the same swarm — for cross-task context. */
+export interface SiblingTaskSummary {
+    label: string;
+    agentType: string;
+    originalTask: string;
+    status: string;
+    /** Last significant decision or action taken by this sibling. */
+    lastKeyDecision?: string;
+    /** Summary of what the sibling accomplished (populated on completion). */
+    completionSummary?: string;
+}
+/** A significant creative or architectural decision made by an agent in the swarm. */
+export interface SharedDecision {
+    /** Which agent made this decision. */
+    agentLabel: string;
+    /** Brief description of the decision. */
+    summary: string;
+    /** When it was recorded. */
+    timestamp: number;
+}
+/** Parsed LLM response for a coordination decision. */
+export interface CoordinationLLMResponse {
+    action: "respond" | "escalate" | "ignore" | "complete";
+    /** Text to send (for action=respond with plain text input). */
+    response?: string;
+    /** Whether to use sendKeysToSession instead of sendToSession. */
+    useKeys?: boolean;
+    /** Key sequence to send (for TUI interactions). e.g. ["enter"] or ["down","enter"]. */
+    keys?: string[];
+    /** LLM's reasoning for the decision. */
+    reasoning: string;
+    /** Brief summary of a significant creative/architectural decision the agent made, if any. */
+    keyDecision?: string;
+}
+/**
+ * Build the LLM prompt for making a coordination decision about a blocked agent.
+ */
+export declare function buildCoordinationPrompt(taskCtx: TaskContextSummary, promptText: string, recentOutput: string, decisionHistory: DecisionHistoryEntry[], siblingTasks?: SiblingTaskSummary[], sharedDecisions?: SharedDecision[], swarmContext?: string): string;
+/**
+ * Build the LLM prompt for checking on an idle session that hasn't
+ * produced any events for a while.
+ */
+export declare function buildIdleCheckPrompt(taskCtx: TaskContextSummary, recentOutput: string, idleMinutes: number, idleCheckNumber: number, maxIdleChecks: number, decisionHistory: DecisionHistoryEntry[], siblingTasks?: SiblingTaskSummary[], sharedDecisions?: SharedDecision[], swarmContext?: string): string;
+/**
+ * Build the LLM prompt for assessing whether a completed turn means the
+ * overall task is done, or if the agent needs more turns.
+ *
+ * Called when the adapter detects "task_complete" (agent finished a turn and
+ * returned to the idle prompt). The LLM decides whether to stop the session
+ * or send a follow-up instruction.
+ */
+export declare function buildTurnCompletePrompt(taskCtx: TaskContextSummary, turnOutput: string, decisionHistory: DecisionHistoryEntry[], siblingTasks?: SiblingTaskSummary[], sharedDecisions?: SharedDecision[], swarmContext?: string): string;
+/**
+ * Build a natural language event message describing a blocked agent, intended
+ * to be processed by Eliza's full ElizaOS pipeline (with conversation memory,
+ * personality, and actions). Unlike buildCoordinationPrompt(), this omits the
+ * "You are Eliza" preamble (she already IS Eliza in the pipeline) and asks
+ * for a JSON action object at the end of her response.
+ */
+export declare function buildBlockedEventMessage(taskCtx: TaskContextSummary, promptText: string, recentOutput: string, decisionHistory: DecisionHistoryEntry[], siblingTasks?: SiblingTaskSummary[], sharedDecisions?: SharedDecision[], swarmContext?: string): string;
+/**
+ * Build a natural language event message describing a turn completion, intended
+ * to be processed by Eliza's full ElizaOS pipeline.
+ */
+export declare function buildTurnCompleteEventMessage(taskCtx: TaskContextSummary, turnOutput: string, decisionHistory: DecisionHistoryEntry[], siblingTasks?: SiblingTaskSummary[], sharedDecisions?: SharedDecision[], swarmContext?: string): string;
+export declare function parseCoordinationResponse(llmOutput: string): CoordinationLLMResponse | null;
+//# sourceMappingURL=swarm-coordinator-prompts.d.ts.map

package/dist/node/src/services/swarm-coordinator-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-coordinator-prompts.d.ts","sourceRoot":"","sources":["../../../../src/services/swarm-coordinator-prompts.ts"],"names":[],"mappings":"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"}