@elizaos/plugin-agent-orchestrator 2.0.0-alpha.4 → 2.0.0-alpha.537

package/dist/services/skill-essentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-essentials.d.ts","sourceRoot":"","sources":["../../src/services/skill-essentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,46EAqCmF,CAAC"}

package/dist/services/skill-lifeops-context-broker.d.ts

@@ -0,0 +1,20 @@
+import type { ActionResult, IAgentRuntime } from "@elizaos/core";
+import type { SessionInfo } from "./pty-types.js";
+import type { RecommendedSkill } from "./skill-recommender.js";
+export declare const LIFEOPS_CONTEXT_BROKER_SLUG = "lifeops-context";
+export declare const LIFEOPS_CONTEXT_BROKER_MANIFEST_ENTRY: {
+    readonly slug: "lifeops-context";
+    readonly name: "LifeOps Context Broker";
+    readonly description: "Task-scoped parent broker for owner LifeOps context. Supports email, calendar, inbox/priority, contacts, scratchpad when available, and generic cross-channel search/context.";
+    readonly guidance: "Use only when task-relevant personal context is needed. Example: `USE_SKILL lifeops-context {\"category\":\"email\",\"query\":\"contract from Alex\",\"limit\":5}`. Categories: email, calendar, inbox, priority, contacts, scratchpad, search, context.";
+};
+export interface LifeOpsContextBrokerRequest {
+    runtime: IAgentRuntime;
+    sessionId: string;
+    session?: SessionInfo;
+    args: unknown;
+}
+export declare function runLifeOpsContextBroker(request: LifeOpsContextBrokerRequest): Promise<ActionResult>;
+export declare function shouldRecommendLifeOpsContextBroker(taskText: string): boolean;
+export declare function withLifeOpsContextBrokerRecommendation(taskText: string, recommendations: readonly RecommendedSkill[]): RecommendedSkill[];
+//# sourceMappingURL=skill-lifeops-context-broker.d.ts.map

package/dist/services/skill-lifeops-context-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-lifeops-context-broker.d.ts","sourceRoot":"","sources":["../../src/services/skill-lifeops-context-broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,YAAY,EAGZ,aAAa,EAId,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAE7D,eAAO,MAAM,qCAAqC;;;;;CAOxC,CAAC;AAuBX,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;CACf;AAuVD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,YAAY,CAAC,CAyHvB;AAWD,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAc7E;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,SAAS,gBAAgB,EAAE,GAC3C,gBAAgB,EAAE,CAmBpB"}

package/dist/services/skill-manifest.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Skill manifest builder.
+ *
+ * Renders a Markdown SKILLS.md document for spawned task agents so they have
+ * full visibility into the skills installed in the parent runtime. The parent
+ * agent owns skill execution; spawned agents request skill invocation by
+ * calling back to the parent (see skill callback bridge in send-to-agent.ts
+ * when ELIZA_ENABLE_CHILD_SKILL_CALLBACK is enabled).
+ *
+ * Source of truth is the AGENT_SKILLS_SERVICE (`@elizaos/plugin-agent-skills`).
+ *
+ * @module services/skill-manifest
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+export interface ManifestSkillEntry {
+    slug: string;
+    name: string;
+    description: string;
+    /** Task-scoped invocation guidance for virtual broker skills. */
+    guidance?: string;
+}
+export interface BuildSkillsManifestOptions {
+    /** Restrict the "All available skills" section to eligible-and-enabled skills. */
+    onlyEligible?: boolean;
+    /**
+     * Slugs to highlight in a dedicated "Recommended for this task" section.
+     * Slugs not present in the eligible/enabled set are silently dropped — the
+     * recommender does not guarantee installed status.
+     */
+    recommendedSlugs?: string[];
+    /** Additional task-scoped skills handled by the orchestrator bridge. */
+    virtualSkills?: ManifestSkillEntry[];
+}
+export interface SkillsManifestResult {
+    /** Markdown document suitable for writing to SKILLS.md inside a workspace. */
+    markdown: string;
+    /** Slugs that the spawned agent can actually request via USE_SKILL. */
+    slugs: string[];
+}
+/**
+ * Build a SKILLS.md markdown document plus the canonical slug list.
+ *
+ * The slug list is the deduplicated union of recommended + available slugs,
+ * so callers can persist it for trajectory annotation or programmatic checks
+ * without re-resolving against the service.
+ */
+export declare function buildSkillsManifest(runtime: IAgentRuntime, opts?: BuildSkillsManifestOptions): Promise<SkillsManifestResult>;
+//# sourceMappingURL=skill-manifest.d.ts.map

package/dist/services/skill-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../src/services/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAU,MAAM,eAAe,CAAC;AAK3D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD,MAAM,WAAW,0BAA0B;IACzC,kFAAkF;IAClF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,wEAAwE;IACxE,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAuED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,0BAA+B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAsE/B"}

package/dist/services/skill-recommender.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Skill recommender — suggests relevant skills for a task description.
+ *
+ * Two-pass strategy:
+ *  1. Cheap keyword/category match against installed skill metadata. Returns
+ *     up to 10 candidate slugs sorted by overlap score.
+ *  2. Optional LLM scoring pass over the surviving candidates that returns a
+ *     small JSON array of {slug, score, reason}. Skipped when any keyword
+ *     match already scores ≥ 0.9 (no need to spend a model call) or when the
+ *     runtime model is unavailable.
+ *
+ * The output is task-aware ranking: the orchestrator can then write the top
+ * N into SKILLS.md and reference them in the spawned agent's initial prompt.
+ *
+ * @module services/skill-recommender
+ */
+import { type IAgentRuntime } from "@elizaos/core";
+export interface RecommendedSkill {
+    slug: string;
+    name: string;
+    /** Score in [0, 1]. 0 = irrelevant, 1 = perfect fit. */
+    score: number;
+    /** Short, human-readable justification (≤ 1 line). */
+    reason: string;
+}
+export interface RecommendSkillsOptions {
+    /** Optional task kind classification (coding | research | planning | ops | mixed). */
+    taskKind?: string;
+    /** Free-form task description provided by the user or planner. */
+    taskText: string;
+    /** Optional repo/language context — used to bias toward language-specific skills. */
+    repoContext?: {
+        language?: string;
+        framework?: string;
+    };
+    /** Maximum number of recommendations to return. Defaults to 5. */
+    max?: number;
+    /**
+     * Force-disable the LLM scoring pass. Defaults to false; when omitted the
+     * recommender runs the LLM pass unless a keyword match already scores ≥ 0.9.
+     */
+    disableLlmPass?: boolean;
+}
+/**
+ * Recommend skills relevant to a task.
+ *
+ * Always returns the top `max` (default 5) candidates ranked by score.
+ * Returns an empty array if no skills are eligible/enabled.
+ */
+export declare function recommendSkillsForTask(runtime: IAgentRuntime, opts: RecommendSkillsOptions): Promise<RecommendedSkill[]>;
+//# sourceMappingURL=skill-recommender.d.ts.map

package/dist/services/skill-recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-recommender.d.ts","sourceRoot":"","sources":["../../src/services/skill-recommender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,eAAe,CAAC;AAmD3E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAwMD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoJ7B"}

package/dist/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/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;AAE9D,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,CAkJrC;AAID,yDAAyD;AACzD,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,WAAW,EAAE,kBAAkB,CAAC;IAChC,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C;AAED;;;;;;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,CA8KrC"}

package/dist/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/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;AAkHtE;;;;;;;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/services/swarm-coordinator-prompts.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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 fenced JSON action block 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;
+/**
+ * Parse the LLM's coordination response from raw text output.
+ * Returns null if the response is invalid or unparseable.
+ */
+export declare function parseCoordinationResponse(llmOutput: string): CoordinationLLMResponse | null;
+//# sourceMappingURL=swarm-coordinator-prompts.d.ts.map

package/dist/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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"}