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

package/assets/claude-code-skills/eliza-runtime/scripts/eliza-context.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# Print the orchestration context for the current Eliza sub-agent session.
+#
+# Usage: bash scripts/eliza-context.sh
+#
+# Output is `key=value` lines, grep/sed-friendly, parseable from prose.
+#
+# Detection covers all three Eliza spawn variants:
+#   - swarm     (multi-agent CREATE_TASK; CLAUDE.md present, hooks installed)
+#   - repo      (single-agent CREATE_TASK in a real repo; CLAUDE.md absent, hooks installed)
+#   - scratch   (SPAWN_AGENT in a scratch workspace; CLAUDE.md absent, hooks NOT installed)
+#
+# The variant matters because hook-dependent features (e.g. structured DECISION
+# events via the parent's HTTP endpoint) only work in `swarm` and `repo`.
+# In `scratch`, your durable channel is stdout — emit `DECISION: ...` lines
+# there and the orchestrator captures them from the PTY tail.
+
+set -u
+
+session_id="${PARALLAX_SESSION_ID:-}"
+hook_port="${ELIZA_HOOK_PORT:-2138}"
+workdir="$PWD"
+agent_user="$USER"
+model="${ANTHROPIC_MODEL:-unset}"
+small_model="${ANTHROPIC_SMALL_FAST_MODEL:-unset}"
+github_token_set="$([ -n "${GITHUB_TOKEN:-}" ] && echo yes || echo no)"
+
+# Detect Eliza-injected files in this workspace.
+claude_md_present="no"
+claude_settings_present="no"
+hook_url_in_settings="no"
+allowed_dirs_in_settings="no"
+[ -f "$workdir/CLAUDE.md" ] && claude_md_present="yes"
+if [ -f "$workdir/.claude/settings.json" ]; then
+    claude_settings_present="yes"
+    grep -q "coding-agents/hooks" "$workdir/.claude/settings.json" 2>/dev/null && hook_url_in_settings="yes"
+    grep -q "allowedDirectories" "$workdir/.claude/settings.json" 2>/dev/null && allowed_dirs_in_settings="yes"
+fi
+
+# Best-effort: extract task label from CLAUDE.md when present.
+agent_label="unknown"
+if [ "$claude_md_present" = "yes" ]; then
+    label=$(grep -oE 'You are agent "[^"]+"' "$workdir/CLAUDE.md" 2>/dev/null | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
+    [ -n "$label" ] && agent_label="$label"
+fi
+
+# Variant detection from observed signals.
+# Source-of-truth signals:
+#   CLAUDE.md present + hooks in settings  → swarm
+#   CLAUDE.md absent  + hooks in settings  → repo
+#   CLAUDE.md absent  + no  hooks          → scratch
+#   anything else                          → unknown
+variant="unknown"
+if [ "$claude_md_present" = "yes" ] && [ "$hook_url_in_settings" = "yes" ]; then
+    variant="swarm"
+elif [ "$claude_md_present" = "no" ] && [ "$hook_url_in_settings" = "yes" ]; then
+    variant="repo"
+elif [ "$claude_md_present" = "no" ] && [ "$hook_url_in_settings" = "no" ] && [ -n "$session_id" ]; then
+    variant="scratch"
+fi
+
+# What features are available in this variant?
+#   stdout DECISION pickup       → ALWAYS works (orchestrator tails PTY)
+#   HTTP hook events             → works in swarm + repo
+#   CLAUDE.md task brief         → exists only in swarm
+hooks_available="no"
+[ "$hook_url_in_settings" = "yes" ] && hooks_available="yes"
+
+claude_md_brief="no"
+[ "$claude_md_present" = "yes" ] && claude_md_brief="yes"
+
+cat <<KV
+session_id=$session_id
+agent_user=$agent_user
+agent_label=$agent_label
+workdir=$workdir
+variant=$variant
+parent_hook_url=http://localhost:$hook_port/api/coding-agents/hooks
+hooks_available=$hooks_available
+claude_md_brief=$claude_md_brief
+claude_settings_present=$claude_settings_present
+allowed_dirs_in_settings=$allowed_dirs_in_settings
+hook_url_in_settings=$hook_url_in_settings
+model=$model
+small_model=$small_model
+github_token_set=$github_token_set
+KV
+
+if [ -z "$session_id" ]; then
+    echo "advice=PARALLAX_SESSION_ID is unset — eliza-runtime skill does not apply to this session." >&2
+    exit 1
+fi
+
+if [ "$variant" = "scratch" ]; then
+    cat >&2 <<'ADVICE'
+advice=variant=scratch — HTTP hooks are NOT installed for scratch tasks.
+       Your durable channel back to the parent is stdout.
+       Use plain `DECISION: ...` lines in your output (the orchestrator
+       tails PTY output and captures them via grep). The
+       `scripts/eliza-decision.sh` helper still works (echoes to stdout
+       AND best-efforts the HTTP POST), but only the stdout half lands.
+ADVICE
+fi

package/assets/claude-code-skills/eliza-runtime/scripts/eliza-decision.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# Emit an explicit DECISION event to the Eliza orchestrator's hook channel.
+#
+# Usage: bash scripts/eliza-decision.sh "your decision text"
+#
+# Writes the same structured shape Eliza's swarm-decision-loop captures
+# from your stdout. Use this when you want the decision recorded by the
+# orchestrator regardless of whether the orchestrator is currently
+# scanning your stdout (e.g. you've moved to a new turn but want the
+# decision attributed to the prior step).
+#
+# Best-effort. Failures are logged to stderr but never fatal — the
+# orchestrator's primary capture path is your stdout, and this is just
+# a complementary out-of-band channel.
+
+set -u
+
+if [ -z "${1:-}" ]; then
+    echo "usage: eliza-decision.sh \"your decision text\"" >&2
+    exit 1
+fi
+
+decision_text="$1"
+session_id="${PARALLAX_SESSION_ID:-}"
+hook_port="${ELIZA_HOOK_PORT:-2138}"
+
+if [ -z "$session_id" ]; then
+    echo "eliza-decision: PARALLAX_SESSION_ID unset — not a Eliza session, skipping." >&2
+    exit 1
+fi
+
+# Echo it to stdout so the primary capture path also picks it up.
+# Eliza's swarm-decision-loop greps for "DECISION:" prefix in raw output.
+printf 'DECISION: %s\n' "$decision_text"
+
+# Best-effort hook POST — if curl is missing or the parent is unreachable,
+# the stdout echo above is the durable record.
+if command -v curl >/dev/null 2>&1; then
+    curl --silent --max-time 3 \
+        -X POST "http://localhost:$hook_port/api/coding-agents/hooks" \
+        -H "content-type: application/json" \
+        -d "$(printf '{"event":"decision","sessionId":"%s","data":{"text":%s}}' \
+            "$session_id" \
+            "$(printf '%s' "$decision_text" | python3 -c 'import sys,json;print(json.dumps(sys.stdin.read()))' 2>/dev/null \
+               || printf '"%s"' "$decision_text")")" \
+        >/dev/null 2>&1 \
+        || echo "eliza-decision: hook POST failed (stdout echo above is the record)" >&2
+fi

package/assets/claude-code-skills/eliza-runtime/scripts/eliza-parent.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+# Read parent Eliza runtime state via the bridge endpoints.
+#
+# Usage:
+#   bash scripts/eliza-parent.sh context          # GET parent-context
+#   bash scripts/eliza-parent.sh memory [query]   # GET memory?q=<query>
+#   bash scripts/eliza-parent.sh peers            # GET active-workspaces
+#
+# All endpoints are read-only. The sub-agent cannot mutate parent state
+# through this helper — only inspect.
+#
+# Endpoints come from the @elizaos/plugin-agent-orchestrator bridge routes
+# (see references/hooks.md for the API contract). They require:
+#   - PARALLAX_SESSION_ID set (this script's session is registered with the parent)
+#   - The parent's API server reachable at localhost:$ELIZA_HOOK_PORT (default 2138)
+#   - The session in non-terminal state (active or tool_running) — terminated
+#     sessions return 410.
+#
+# Best-effort. If the bridge isn't available (older orchestrator without bridge
+# routes, or network issue), the script reports the failure on stderr and
+# exits non-zero so the caller can fall back to "no parent context".
+
+set -u
+
+CMD="${1:-help}"
+ARG="${2:-}"
+
+session_id="${PARALLAX_SESSION_ID:-}"
+hook_port="${ELIZA_HOOK_PORT:-2138}"
+base="http://localhost:$hook_port/api/coding-agents/$session_id"
+
+# Help is always free; everything else needs an active session + curl.
+if [ "$CMD" != "help" ] && [ "$CMD" != "--help" ] && [ "$CMD" != "-h" ]; then
+    if [ -z "$session_id" ]; then
+        echo "eliza-parent: PARALLAX_SESSION_ID is not set — not a Eliza session." >&2
+        exit 1
+    fi
+    if ! command -v curl >/dev/null 2>&1; then
+        echo "eliza-parent: curl not found in PATH — bridge endpoints unreachable." >&2
+        exit 1
+    fi
+fi
+
+call() {
+    # call <path> — GET against $base/<path>, fail loudly on non-2xx.
+    local path="$1"
+    local url="$base/$path"
+    local response status
+    response=$(curl -s -w "%{http_code}" --max-time 5 "$url")
+    status="${response: -3}"
+    response="${response%???}"
+    if [ "$status" = "200" ]; then
+        printf '%s' "$response"
+        return 0
+    fi
+    case "$status" in
+        404) echo "eliza-parent: session $session_id is unknown to the parent (404). Is the bridge installed?" >&2 ;;
+        410) echo "eliza-parent: session $session_id is in terminal state (410). Parent context no longer available." >&2 ;;
+        000) echo "eliza-parent: parent unreachable at $url. Bridge may not be exposed on port $hook_port." >&2 ;;
+        *)   echo "eliza-parent: unexpected HTTP $status from $url. Body: $response" >&2 ;;
+    esac
+    return 1
+}
+
+case "$CMD" in
+    context|parent-context)
+        # Pretty-print the parent context as key=value lines for easy parsing.
+        body=$(call "parent-context") || exit 1
+        printf '%s' "$body" | python3 -c "
+import sys, json
+d = json.load(sys.stdin)
+character = d.get('character', {}) or {}
+room = d.get('room')
+print(f\"agent_label={d.get('agent_label')}\")
+print(f\"workdir={d.get('workdir')}\")
+print(f\"agent_type={d.get('agent_type')}\")
+print(f\"repo={d.get('repo') or 'none'}\")
+print(f\"character_name={character.get('name')}\")
+bio = character.get('bio') or []
+if isinstance(bio, list):
+    print(f\"character_bio={' | '.join(bio[:3])[:300]}\" if bio else 'character_bio=')
+else:
+    print(f'character_bio={str(bio)[:300]}')
+topics = character.get('topics') or []
+print(f\"character_topics={','.join(topics[:8])}\" if topics else 'character_topics=')
+if room:
+    print(f\"room_id={room.get('id')}\")
+    print(f\"thread_id={room.get('thread_id')}\")
+else:
+    print('room_id=')
+    print('thread_id=')
+print(f\"original_task={(d.get('original_task') or '')[:300]}\")
+" 2>/dev/null || printf '%s\n' "$body"
+        ;;
+    memory)
+        # Search memory in the originating room. Optional query string narrows results.
+        if [ -n "$ARG" ]; then
+            body=$(call "memory?q=$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1]))" "$ARG")&limit=10") || exit 1
+        else
+            body=$(call "memory?limit=10") || exit 1
+        fi
+        printf '%s' "$body" | python3 -c "
+import sys, json
+d = json.load(sys.stdin)
+print(f\"room_id={d.get('room_id')}\")
+print(f\"count={d.get('count')}\")
+print(f\"query={d.get('query') or '(none)'}\")
+print('---')
+for m in d.get('messages', []):
+    print(f\"[{m.get('speaker','?')}] {m.get('text','')}\")
+" 2>/dev/null || printf '%s\n' "$body"
+        ;;
+    peers|active-workspaces)
+        body=$(call "active-workspaces") || exit 1
+        printf '%s' "$body" | python3 -c "
+import sys, json
+d = json.load(sys.stdin)
+print(f\"peer_count={d.get('count')}\")
+for w in d.get('workspaces', []):
+    print(f\"- {w.get('label')} ({w.get('agent_type')}) workdir={w.get('workdir')} repo={w.get('repo') or 'none'}\")
+" 2>/dev/null || printf '%s\n' "$body"
+        ;;
+    help|--help|-h|"")
+        cat <<'HELP'
+eliza-parent — read parent Eliza runtime state via bridge endpoints
+
+  context     dump the agent's character, current room, workdir, original task
+  memory [q]  read recent messages from the originating room (optional substring filter)
+  peers       list active sibling sub-agents (sessions other than this one)
+
+Notes:
+  - Read-only. There is no write API.
+  - Returns key=value lines on success; non-zero exit + stderr on failure.
+  - Requires the parent's bridge routes (in @elizaos/plugin-agent-orchestrator).
+    On older orchestrators without the bridge, calls return 404 — fall back
+    to no-parent-context mode.
+HELP
+        ;;
+    *)
+        echo "eliza-parent: unknown command '$CMD' (try: context | memory | peers | help)" >&2
+        exit 1
+        ;;
+esac

package/dist/actions/coding-task-handlers.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Handler logic for the START_CODING_TASK action.
+ *
+ * handleMultiAgent() handles both multi-agent and single-agent modes.
+ * A single-agent call is just a length-1 agent spec.
+ *
+ * @module actions/coding-task-handlers
+ */
+import { type ActionResult, type HandlerCallback, type IAgentRuntime, type Memory, type State } from "@elizaos/core";
+import type { AgentCredentials } from "coding-agent-adapters";
+import type { AgentSelectionStrategy } from "../services/agent-selection.js";
+import type { PTYService } from "../services/pty-service.js";
+import { type CodingAgentType } from "../services/pty-types.js";
+import { type SkillSessionAllowList } from "../services/skill-callback-bridge.js";
+import type { CodingWorkspaceService } from "../services/workspace-service.js";
+export declare function getSkillSessionAllowList(): SkillSessionAllowList;
+/** Shared context passed to both multi-agent and single-agent handlers */
+export interface CodingTaskContext {
+    runtime: IAgentRuntime;
+    ptyService: PTYService;
+    wsService: CodingWorkspaceService | undefined;
+    credentials: AgentCredentials;
+    customCredentials: Record<string, string> | undefined;
+    callback: HandlerCallback | undefined;
+    message: Memory;
+    state: State | undefined;
+    repo: string | undefined;
+    defaultAgentType: CodingAgentType;
+    rawAgentType: string;
+    agentTypeExplicit: boolean;
+    agentSelectionStrategy: AgentSelectionStrategy;
+    memoryContent: string | undefined;
+    approvalPreset: string | undefined;
+    explicitLabel: string | undefined;
+    /**
+     * Optional caller-supplied custom validator spec. Forwarded verbatim into
+     * the task's session metadata so the swarm decision loop can resolve and
+     * invoke it after the child claims `done`. Shape matches
+     * `CustomValidatorSpec` in `services/custom-validator-runner.ts`.
+     */
+    validator?: {
+        service: string;
+        method: string;
+        params: Record<string, unknown>;
+    };
+    /** Optional override for ELIZA_APP_VERIFICATION_MAX_RETRIES. */
+    maxRetries?: number;
+    /** Optional verdict-fail behavior. Defaults to "retry". */
+    onVerificationFail?: "retry" | "escalate";
+    /**
+     * Optional originating roomId — when set, persisted onto session metadata
+     * so the verification-room-bridge can post the verdict back to the right
+     * chat room. Set by APP.create / PLUGIN.create dispatchers.
+     */
+    originRoomId?: string;
+}
+/**
+ * Multi-agent mode handler.
+ *
+ * Parses pipe-delimited agent specs and spawns each agent in its own
+ * workspace clone (or scratch directory).
+ */
+export declare function handleMultiAgent(ctx: CodingTaskContext, agentsParam: string): Promise<ActionResult | undefined>;
+//# sourceMappingURL=coding-task-handlers.d.ts.map

package/dist/actions/coding-task-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-task-handlers.d.ts","sourceRoot":"","sources":["../../src/actions/coding-task-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,KAAK,MAAM,EAEX,KAAK,KAAK,EAEX,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EACL,KAAK,eAAe,EAOrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAmB9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AA8C/E,wBAAgB,wBAAwB,IAAI,qBAAqB,CAEhE;AAgfD,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC9C,WAAW,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACtD,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,gBAAgB,EAAE,eAAe,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC;;;;;OAKG;IACH,SAAS,CAAC,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC1C;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,iBAAiB,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAogBnC"}

package/dist/actions/coding-task-helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Helper functions for the START_CODING_TASK action.
+ *
+ * - createScratchDir()      -- Creates a scratch sandbox directory for non-repo tasks
+ * - generateLabel()         -- Generate a short semantic label from repo URL and/or task description
+ * - registerSessionEvents() -- Register lifecycle event handlers for a spawned session
+ *
+ * @module actions/coding-task-helpers
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type HandlerCallback } from "@elizaos/core";
+import type { PTYService } from "../services/pty-service.js";
+import type { SkillSessionAllowList } from "../services/skill-callback-bridge.js";
+/**
+ * Create a scratch sandbox directory for non-repo tasks.
+ *
+ * When `PARALLAX_CODING_DIRECTORY` is set (e.g. `~/Projects`), creates a
+ * named subdir like `~/Projects/todo-app/` derived from the task label.
+ * Otherwise falls back to `~/.eliza/workspaces/{uuid}`.
+ */
+export declare function createScratchDir(runtime?: IAgentRuntime, label?: string): string;
+/**
+ * Generate a short semantic label from repo URL and/or task description.
+ * e.g. "git-workspace-service-testbed/hello-mima" or "scratch/react-research"
+ */
+export declare function generateLabel(repo: string | undefined, task: string | undefined): string;
+/**
+ * Register lifecycle event handlers for a spawned session.
+ *
+ * When `coordinatorActive` is true the SwarmCoordinator owns chat messaging
+ * and session lifecycle for blocked / task_complete / error events.
+ * This listener still handles scratch-dir cleanup regardless.
+ */
+export declare function registerSessionEvents(ptyService: PTYService, runtime: IAgentRuntime, sessionId: string, label: string, scratchDir: string | null, callback?: HandlerCallback, coordinatorActive?: boolean, skillSessionAllowList?: SkillSessionAllowList): void;
+//# sourceMappingURL=coding-task-helpers.d.ts.map

package/dist/actions/coding-task-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coding-task-helpers.d.ts","sourceRoot":"","sources":["../../src/actions/coding-task-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,KAAK,eAAe,EAAU,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAgClF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CA4BR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CA4BR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,eAAe,EAC1B,iBAAiB,UAAQ,EACzB,qBAAqB,CAAC,EAAE,qBAAqB,GAC5C,IAAI,CAuEN"}

package/dist/actions/eval-metadata.d.ts

@@ -0,0 +1,11 @@
+import type { Memory } from "@elizaos/core";
+export declare function extractEvalRunMetadata(value: Memory | Record<string, unknown> | null | undefined): {
+    scenarioId?: string;
+    batchId?: string;
+};
+export declare function mergeTaskThreadEvalMetadata(message: Memory | null | undefined, metadata: Record<string, unknown> | undefined): {
+    scenarioId?: string;
+    batchId?: string;
+    metadata: Record<string, unknown>;
+};
+//# sourceMappingURL=eval-metadata.d.ts.map

package/dist/actions/eval-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval-metadata.d.ts","sourceRoot":"","sources":["../../src/actions/eval-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAsB5C,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACzD;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CA0BA;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAkBA"}

package/dist/actions/finalize-workspace.d.ts

@@ -0,0 +1,11 @@
+/**
+ * FINALIZE_WORKSPACE action - Commit, push, and create PR for workspace changes
+ *
+ * Completes a coding task by committing changes, pushing to remote,
+ * and optionally creating a pull request.
+ *
+ * @module actions/finalize-workspace
+ */
+import type { Action } from "@elizaos/core";
+export declare const finalizeWorkspaceAction: Action;
+//# sourceMappingURL=finalize-workspace.d.ts.map

package/dist/actions/finalize-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-workspace.d.ts","sourceRoot":"","sources":["../../src/actions/finalize-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,uBAAuB,EAAE,MA4PrC,CAAC"}

package/dist/actions/list-agents.d.ts

@@ -0,0 +1,13 @@
+/**
+ * LIST_AGENTS action - List active task-agent sessions and task progress.
+ *
+ * Returns information about running PTY sessions together with the current
+ * coordinator task state so the main agent can keep the user updated while
+ * background work continues.
+ *
+ * @module actions/list-agents
+ */
+import type { Action } from "@elizaos/core";
+export declare const listAgentsAction: Action;
+export declare const listTaskAgentsAction: Action;
+//# sourceMappingURL=list-agents.d.ts.map

package/dist/actions/list-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agents.d.ts","sourceRoot":"","sources":["../../src/actions/list-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAiCvB,eAAO,MAAM,gBAAgB,EAAE,MAsM9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAmB,CAAC"}

package/dist/actions/manage-issues.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MANAGE_ISSUES action - Create, list, update, and close GitHub issues
+ *
+ * Provides full issue lifecycle management through the CodingWorkspaceService.
+ * Supports creating issues, listing issues, adding comments, closing, and reopening.
+ *
+ * @module actions/manage-issues
+ */
+import type { Action } from "@elizaos/core";
+export declare const manageIssuesAction: Action;
+//# sourceMappingURL=manage-issues.d.ts.map

package/dist/actions/manage-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-issues.d.ts","sourceRoot":"","sources":["../../src/actions/manage-issues.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAmBvB,eAAO,MAAM,kBAAkB,EAAE,MA+MhC,CAAC"}

package/dist/actions/provision-workspace.d.ts

@@ -0,0 +1,11 @@
+/**
+ * PROVISION_WORKSPACE action - Create a git workspace for coding tasks
+ *
+ * Clones a repository or creates a worktree for isolated development.
+ * Useful for setting up a clean environment before spawning a coding agent.
+ *
+ * @module actions/provision-workspace
+ */
+import type { Action } from "@elizaos/core";
+export declare const provisionWorkspaceAction: Action;
+//# sourceMappingURL=provision-workspace.d.ts.map

package/dist/actions/provision-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision-workspace.d.ts","sourceRoot":"","sources":["../../src/actions/provision-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAOvB,eAAO,MAAM,wBAAwB,EAAE,MA4NtC,CAAC"}

package/dist/actions/send-to-agent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SEND_TO_AGENT action - Send input to a running task agent.
+ *
+ * Allows sending text or commands to an active PTY session.
+ * Useful for responding to prompts, providing feedback, or giving new instructions.
+ *
+ * @module actions/send-to-agent
+ */
+import type { Action } from "@elizaos/core";
+export declare const sendToAgentAction: Action;
+export declare const sendToTaskAgentAction: Action;
+//# sourceMappingURL=send-to-agent.d.ts.map

package/dist/actions/send-to-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-to-agent.d.ts","sourceRoot":"","sources":["../../src/actions/send-to-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAMvB,eAAO,MAAM,iBAAiB,EAAE,MAgS/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAoB,CAAC"}

package/dist/actions/spawn-agent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SPAWN_AGENT action - Spawns a CLI task agent.
+ *
+ * Creates a new PTY session for a task agent (Claude Code, Codex, etc.)
+ * and returns a session ID for subsequent interactions.
+ *
+ * @module actions/spawn-agent
+ */
+import { type Action } from "@elizaos/core";
+export declare const spawnAgentAction: Action;
+export declare const spawnTaskAgentAction: Action;
+//# sourceMappingURL=spawn-agent.d.ts.map

package/dist/actions/spawn-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-agent.d.ts","sourceRoot":"","sources":["../../src/actions/spawn-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,KAAK,MAAM,EAQZ,MAAM,eAAe,CAAC;AAgGvB,eAAO,MAAM,gBAAgB,EAAE,MA4nB9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAmB,CAAC"}

package/dist/actions/start-coding-task.d.ts

@@ -0,0 +1,69 @@
+/**
+ * CREATE_TASK action to set up and launch task agents.
+ *
+ * Combines workspace provisioning and agent spawning into a single atomic action.
+ * - If a repo URL is provided, clones it into a fresh workspace
+ * - If no repo, creates a scratch sandbox directory
+ * - Spawns the specified task agent(s) in that workspace with the given task
+ * - Supports multi-agent mode via pipe-delimited `agents` param
+ *
+ * This eliminates the need for multi-action chaining (PROVISION_WORKSPACE -> SPAWN_AGENT)
+ * and ensures agents always run in an isolated directory.
+ *
+ * @module actions/start-coding-task
+ */
+import { type Action } from "@elizaos/core";
+/**
+ * Caller-supplied retry policy for the custom validator path. Stored on
+ * the task's session metadata under `validator` / `maxRetries` /
+ * `onVerificationFail` so the decision loop can read it after completion.
+ */
+export type OnVerificationFail = "retry" | "escalate";
+/**
+ * When the action-selector LLM trims a multi-clause user prompt down to a
+ * single imperative `task`, the rest of the user text is dropped — e.g.
+ * "read /etc/timezone, then also tell me X" gets reduced to "read
+ * /etc/timezone" and the secondary clause never reaches the subagent.
+ * Reconstruct a brief that preserves the full user intent while still
+ * letting the planner-extracted task lead.
+ *
+ * Returns `extractedTask` unchanged when:
+ *   - userText is empty (programmatic spawn, no user message)
+ *   - userText is shorter or equal to extractedTask (the planner just
+ *     cleaned up casing/grammar — no information is lost)
+ *   - extractedTask is a substring of userText (the "extraction" was a
+ *     noop and userText alone carries everything)
+ *
+ * Otherwise returns a two-section brief: the planner-extracted task as the
+ * imperative header, and the full user message preserved for context the
+ * planner trimmed.
+ */
+export declare function preserveUserPromptInTask(extractedTask: string, userText: string): string;
+/**
+ * Split a multi-intent task description into one segment per distinct ask.
+ * Matches numbered lists (`1. ...`, `2) ...`) and bullets (`- ...`, `* ...`).
+ * Returns the original text as a single-element array when no multi-intent
+ * structure is detected, so the call site can always pipe-join unconditionally.
+ *
+ * Rationale: the action-selector LLM consistently puts multi-ask user prompts
+ * into the `task` field instead of `agents`. The result is a subagent that
+ * cherry-picks one item and silently drops the rest. Auto-splitting here
+ * guarantees every distinct ask gets its own subagent regardless of which
+ * field the LLM populated.
+ */
+export declare function splitMultiIntentTask(text: string): string[];
+/**
+ * Reject a shell/pi/bash agentType hint when the task text is prose, so both
+ * CREATE_TASK and SPAWN_AGENT upgrade to a reasoning framework via
+ * `resolveAgentType`. Returns the sanitized hint (original value or `undefined`
+ * if it was rejected). `callerTag` is the [PREFIX] string used when warning
+ * so the log line points at the actual callsite.
+ */
+export declare function coerceShellAgentTypeForProse(explicitRawType: string | undefined, taskText: string | undefined | null, callerTag: string): string | undefined;
+type BackgroundAction = Action & {
+    suppressPostActionContinuation?: boolean;
+};
+export declare const startCodingTaskAction: BackgroundAction;
+export declare const createTaskAction: BackgroundAction;
+export {};
+//# sourceMappingURL=start-coding-task.d.ts.map

package/dist/actions/start-coding-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-coding-task.d.ts","sourceRoot":"","sources":["../../src/actions/start-coding-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,KAAK,MAAM,EAQZ,MAAM,eAAe,CAAC;AAoBvB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,UAAU,CAAC;AAkItD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB3D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACnC,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAYpB;AAED,KAAK,gBAAgB,GAAG,MAAM,GAAG;IAC/B,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBA4enC,CAAC;AAEF,eAAO,MAAM,gBAAgB,kBAAwB,CAAC"}

package/dist/actions/stop-agent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * STOP_AGENT action - Stop a running task-agent session.
+ *
+ * Terminates an active PTY session. Use when the agent is done,
+ * stuck, or needs to be cancelled.
+ *
+ * @module actions/stop-agent
+ */
+import { type Action } from "@elizaos/core";
+export declare const stopAgentAction: Action;
+export declare const stopTaskAgentAction: Action;
+//# sourceMappingURL=stop-agent.d.ts.map

package/dist/actions/stop-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-agent.d.ts","sourceRoot":"","sources":["../../src/actions/stop-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,MAAM,EAQZ,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,eAAe,EAAE,MA2N7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAkB,CAAC"}

package/dist/actions/task-control.d.ts

@@ -0,0 +1,3 @@
+import type { Action } from "@elizaos/core";
+export declare const taskControlAction: Action;
+//# sourceMappingURL=task-control.d.ts.map

package/dist/actions/task-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-control.d.ts","sourceRoot":"","sources":["../../src/actions/task-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AA6CvB,eAAO,MAAM,iBAAiB,EAAE,MAmN/B,CAAC"}

package/dist/actions/task-history.d.ts

@@ -0,0 +1,3 @@
+import type { Action } from "@elizaos/core";
+export declare const taskHistoryAction: Action;
+//# sourceMappingURL=task-history.d.ts.map

package/dist/actions/task-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-history.d.ts","sourceRoot":"","sources":["../../src/actions/task-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,eAAe,CAAC;AAkLvB,eAAO,MAAM,iBAAiB,EAAE,MA6N/B,CAAC"}

package/dist/actions/task-share.d.ts

@@ -0,0 +1,3 @@
+import type { Action } from "@elizaos/core";
+export declare const taskShareAction: Action;
+//# sourceMappingURL=task-share.d.ts.map

package/dist/actions/task-share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-share.d.ts","sourceRoot":"","sources":["../../src/actions/task-share.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAOP,MAAM,eAAe,CAAC;AAYvB,eAAO,MAAM,eAAe,EAAE,MAmL7B,CAAC"}