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

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

@@ -0,0 +1,104 @@
+/**
+ * PTY session spawning logic — extracted from PTYService for maintainability.
+ *
+ * Contains the deferred task delivery, retry logic, per-agent settle delays,
+ * and session buffer setup that runs during spawnSession().
+ *
+ * @module services/pty-spawn
+ */
+import type { AdapterType, BaseCodingAdapter } from "coding-agent-adapters";
+import type { BunCompatiblePTYManager, PTYManager, SessionHandle, SpawnConfig, WorkerSessionHandle } from "pty-manager";
+import type { PTYServiceConfig, SessionInfo, SpawnSessionOptions } from "./pty-types.js";
+/**
+ * Inspect a chunk of session output for auth-related failure signatures.
+ * Returns the kind of failure detected (or null) so the caller can mark
+ * the supplied `accountId` via the pool. Pattern matching is best-effort
+ * and intentionally narrow: we only flag accounts when we're confident
+ * the subprocess saw a real auth error.
+ */
+export declare function detectAuthFailureKind(data: string): "rate-limited" | "invalid" | "needs-reauth" | null;
+/**
+ * Build a sanitized base environment from process.env, keeping only
+ * safe system variables. Agent-specific credentials are injected
+ * separately by the adapter's getEnv().
+ *
+ * On Windows, the sanitized env may have lost the per-package-manager bin
+ * directories that hold `claude.cmd` / `codex.cmd` (npm global, Codex
+ * managed install, scoop shims, chocolatey bin). Route through
+ * `appendWindowsPathFallbacks` to add those back after the allowlist copy.
+ */
+export declare function buildSanitizedBaseEnv(): Record<string, string>;
+/**
+ * Directories that Windows package managers drop `claude.cmd` / `codex.cmd`
+ * / `codex.exe` into. We append these to the sanitized PATH so `cmd.exe`
+ * (via the `shell: true` flag on execFile/spawn for win32) can resolve the
+ * CLI binaries even when the user's PATH has been stripped down by the
+ * ENV_ALLOWLIST-then-systemd-unit chain or otherwise missing the install
+ * location. Each entry is a no-op on non-Windows and a no-op when the
+ * parent env var the path depends on is unset.
+ *
+ * Coverage, in order of popularity for claude/codex installs:
+ *   - npm global (%APPDATA%\npm) — the official CLAUDE_CODE install path
+ *   - Codex managed install (%LOCALAPPDATA%\OpenAI\Codex\bin)
+ *   - Scoop (%USERPROFILE%\scoop\shims)
+ *   - Chocolatey (%ProgramData%\chocolatey\bin)
+ *   - Bun global (%USERPROFILE%\.bun\bin)
+ */
+export declare function getWindowsPathFallbacks(): string[];
+/**
+ * Append each fallback path to `currentPath` if it isn't already present.
+ * Windows PATH matching is case-insensitive, so dedupe on the lowercased
+ * form but preserve the original casing in the output. Returns `undefined`
+ * when the resulting PATH would be empty (neither argument had content), so
+ * callers can skip assigning an empty string.
+ */
+export declare function appendWindowsPathFallbacks(currentPath: string | undefined): string | undefined;
+/**
+ * Pure PATH-merge helper: dedupe existing + extras, preserve insertion
+ * order and casing. Exported for unit tests so we can exercise the merge
+ * logic without stubbing `process.platform`.
+ */
+export declare function mergePathEntries(currentPath: string | undefined, extras: readonly string[], opts: {
+    delimiter: string;
+    caseInsensitive: boolean;
+}): string | undefined;
+export interface SpawnContext {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+    serviceConfig: PTYServiceConfig;
+    sessionMetadata: Map<string, Record<string, unknown>>;
+    sessionWorkdirs: Map<string, string>;
+    sessionOutputBuffers: Map<string, string[]>;
+    outputUnsubscribers: Map<string, () => void>;
+    taskResponseMarkers: Map<string, number>;
+    getAdapter: (agentType: AdapterType) => BaseCodingAdapter;
+    sendToSession: (sessionId: string, input: string) => Promise<unknown>;
+    sendKeysToSession: (sessionId: string, keys: string | string[]) => Promise<void>;
+    writeRawToSession: (sessionId: string, data: string) => Promise<void>;
+    pushDefaultRules: (sessionId: string, agentType: string) => Promise<void>;
+    toSessionInfo: (session: SessionHandle | WorkerSessionHandle, workdir?: string) => SessionInfo;
+    log: (msg: string) => void;
+    /** Mark a session's task as delivered in the coordinator. */
+    markTaskDelivered: (sessionId: string) => void;
+}
+export declare function shouldUseCodexExecMode(options: {
+    agentType: string;
+    initialTask?: string;
+}): boolean;
+/**
+ * Set up session output buffering for Bun worker path.
+ */
+export declare function setupOutputBuffer(ctx: SpawnContext, sessionId: string): void;
+/**
+ * Set up deferred task delivery with retry logic.
+ * IMPORTANT: Must be called BEFORE pushDefaultRules (which has a 1500ms sleep),
+ * otherwise session_ready fires during pushDefaultRules and the listener misses it.
+ */
+export declare function setupDeferredTaskDelivery(ctx: SpawnContext, session: SessionHandle | WorkerSessionHandle, task: string, agentType: string): void;
+/**
+ * Build the SpawnConfig and env vars from SpawnSessionOptions.
+ */
+export declare function buildSpawnConfig(sessionId: string, options: SpawnSessionOptions, workdir: string): SpawnConfig & {
+    id: string;
+};
+//# sourceMappingURL=pty-spawn.d.ts.map

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

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

package/dist/node/src/services/pty-types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared types and helpers for the PTY service layer.
+ *
+ * Extracted from pty-service.ts to keep that module lean and allow
+ * other modules (pty-spawn, pty-init, actions) to import lightweight
+ * type-only dependencies without pulling in the full PTYService class.
+ *
+ * @module services/pty-types
+ */
+import type { AdapterType, AgentCredentials, ApprovalPreset } from "coding-agent-adapters";
+import type { SessionHandle } from "pty-manager";
+export interface PTYServiceConfig {
+    /** Maximum output lines to keep per session (default: 1000) */
+    maxLogLines?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Auto-register task-agent adapters (default: true) */
+    registerCodingAdapters?: boolean;
+    /** Maximum concurrent PTY sessions (default: 8) */
+    maxConcurrentSessions?: number;
+    /**
+     * Default approval preset for task agents when not specified per-spawn.
+     * Controls what tools the agent can use without asking for permission.
+     *   - "readonly"   — Read-only tools only
+     *   - "standard"   — Read + write, asks for shell/network
+     *   - "permissive" — Most tools auto-approved, asks for destructive ops
+     *   - "autonomous" — All tools auto-approved (yolo mode)
+     * Default: "autonomous"
+     */
+    defaultApprovalPreset?: ApprovalPreset;
+}
+/** Available task-agent types */
+export type CodingAgentType = "shell" | "pi" | "opencode" | AdapterType;
+/** True when the user requested the Pi coding agent. */
+export declare const isPiAgentType: (input: string | undefined | null) => boolean;
+/** True when the user requested the OpenCode agent. */
+export declare const isOpencodeAgentType: (input: string | undefined | null) => boolean;
+/** Normalize user-provided agent type string to a valid CodingAgentType */
+export declare const normalizeAgentType: (input: string) => CodingAgentType;
+/** Build the initial shell command for Pi agent sessions. */
+export declare const toPiCommand: (task: string | undefined) => string;
+/**
+ * Build the initial shell command for OpenCode agent sessions.
+ *
+ * `--dangerously-skip-permissions` is a flag of the `run` subcommand
+ * (NOT the top-level opencode command), so it must come AFTER `run` —
+ * verified live with opencode 1.14.33 + an OpenAI-compatible Eliza-1 endpoint.
+ *
+ * Model + provider selection comes from the OPENCODE_CONFIG_CONTENT env
+ * var that the spawn pipeline injects — see buildOpencodeSpawnConfig in
+ * `agent-credentials.ts`.
+ */
+export declare const toOpencodeCommand: (task: string | undefined) => string;
+export interface SpawnSessionOptions {
+    /** Human-readable session name */
+    name: string;
+    /** Adapter type: "shell" | "pi" | "opencode" | "claude" | "gemini" | "codex" | "aider" */
+    agentType: CodingAgentType;
+    /** Working directory for the session */
+    workdir?: string;
+    /** Initial command/task to send */
+    initialTask?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Session metadata for tracking */
+    metadata?: Record<string, unknown>;
+    /** Credentials for coding agents (API keys, tokens) */
+    credentials?: AgentCredentials;
+    /** Memory/instructions content to write to the agent's memory file before spawning */
+    memoryContent?: string;
+    /** Approval preset controlling tool permissions (readonly, standard, permissive, autonomous) */
+    approvalPreset?: ApprovalPreset;
+    /** Custom credentials for MCP servers or other integrations */
+    customCredentials?: Record<string, string>;
+    /** When true, adapter-level blocking prompts (tool permissions, file access)
+     *  are emitted with autoResponded=false instead of being auto-handled.
+     *  Used by the swarm coordinator to route decisions through its LLM loop. */
+    skipAdapterAutoResponse?: boolean;
+}
+export interface SessionInfo {
+    id: string;
+    name: string;
+    agentType: string;
+    workdir: string;
+    status: SessionHandle["status"];
+    createdAt: Date;
+    lastActivityAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/** Known event names emitted by the PTY layer. */
+export type SessionEventName = "ready" | "blocked" | "login_required" | "task_complete" | "tool_running" | "stopped" | "error" | "message";
+type SessionEventCallback = (sessionId: string, event: string, data: unknown) => void;
+export type { SessionEventCallback };
+//# sourceMappingURL=pty-types.d.ts.map

package/dist/node/src/services/pty-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-types.d.ts","sourceRoot":"","sources":["../../../../src/services/pty-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAC;CACxC;AAED,iCAAiC;AACjC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC;AASxE,wDAAwD;AACxD,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAGhE,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAC/B,OAGF,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,eAwBlD,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAKtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAK5D,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,SAAS,EAAE,eAAe,CAAC;IAC3B,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uDAAuD;IACvD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gGAAgG;IAChG,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C;;iFAE6E;IAC7E,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,SAAS,GACT,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,SAAS,GACT,OAAO,GACP,SAAS,CAAC;AAEd,KAAK,oBAAoB,GAAG,CAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,KACV,IAAI,CAAC;AAEV,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/node/src/services/repo-input.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Repository input normalization for coding task workspaces.
+ *
+ * Accepts canonical clone URLs plus common shorthand forms such as:
+ * - owner/repo
+ * - github.com/owner/repo
+ * - https://github.com/owner/repo
+ *
+ * Bare owner/repo inputs default to GitHub because the coding workspace
+ * flows in this plugin are GitHub-centric.
+ *
+ * @module services/repo-input
+ */
+export declare function normalizeRepositoryInput(repo: string): string;
+export declare function diagnoseWorkspaceBootstrapFailure(repo: string, errorMessage: string): string;
+//# sourceMappingURL=repo-input.d.ts.map

package/dist/node/src/services/repo-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-input.d.ts","sourceRoot":"","sources":["../../../../src/services/repo-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqD7D;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,MAAM,CAmDR"}

package/dist/node/src/services/session-event-queue.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Per-session async serialization queue.
+ * Ensures only one event is processed at a time per session.
+ */
+export interface QueuedEvent {
+    sessionId: string;
+    type: "blocked" | "turn_complete";
+    data: unknown;
+    enqueuedAt: number;
+}
+export declare class SessionEventQueue {
+    private queues;
+    private processing;
+    private handler;
+    private logger;
+    constructor(handler: (event: QueuedEvent) => Promise<void>, logger?: {
+        warn: (msg: string) => void;
+    });
+    enqueue(event: QueuedEvent): void;
+    isProcessing(sessionId: string): boolean;
+    clear(sessionId?: string): void;
+    pendingCount(sessionId: string): number;
+    private processLoop;
+}
+//# sourceMappingURL=session-event-queue.d.ts.map

package/dist/node/src/services/session-event-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-event-queue.d.ts","sourceRoot":"","sources":["../../../../src/services/session-event-queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,eAAe,CAAC;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,MAAM,CAAkC;gBAG9C,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,EAC9C,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE;IAM1C,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAajC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ/B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;YAIzB,WAAW;CA8B1B"}

package/dist/node/src/services/session-store.d.ts

@@ -0,0 +1,107 @@
+import type { SessionFilter, SessionInfo, SessionStatus, SessionStore, SessionStoreRuntime } from "./types.js";
+export type SessionStoreBackend = "runtime-db" | "file" | "memory";
+type Logger = NonNullable<SessionStoreRuntime["logger"]>;
+type SqlDatabaseAdapter = {
+    query?: (sql: string, params?: unknown[]) => Promise<unknown> | unknown;
+    execute?: (sql: string, params?: unknown[]) => Promise<unknown> | unknown;
+    run?: (sql: string, params?: unknown[]) => Promise<unknown> | unknown;
+    all?: (sql: string, params?: unknown[]) => Promise<unknown[]> | unknown[];
+    get?: (sql: string, params?: unknown[]) => Promise<unknown> | unknown;
+    select?: (sql: string, params?: unknown[]) => Promise<unknown[]> | unknown[];
+};
+declare class WriteQueue {
+    private tail;
+    enqueue<T>(operation: () => Promise<T>): Promise<T>;
+}
+export declare class InMemorySessionStore implements SessionStore {
+    protected readonly sessions: Map<string, SessionInfo>;
+    protected readonly writes: WriteQueue;
+    create(session: SessionInfo): Promise<void>;
+    get(id: string): Promise<SessionInfo | null>;
+    getSync(id: string): SessionInfo | null;
+    getByAcpxRecordId(recordId: string): Promise<SessionInfo | null>;
+    findByScope(opts: {
+        workdir: string;
+        agentType: string;
+        name?: string;
+    }): Promise<SessionInfo | null>;
+    list(filter?: SessionFilter): Promise<SessionInfo[]>;
+    listSync(filter?: SessionFilter): SessionInfo[];
+    update(id: string, patch: Partial<SessionInfo>): Promise<void>;
+    updateStatus(id: string, status: SessionStatus, error?: string): Promise<void>;
+    delete(id: string): Promise<void>;
+    sweepStale(maxAgeMs: number): Promise<string[]>;
+    protected afterWrite(): Promise<void>;
+}
+export declare class FileSessionStore extends InMemorySessionStore {
+    private readonly filePath;
+    private readonly logger?;
+    private readonly lockFile;
+    private loaded;
+    constructor(filePath?: string, logger?: Logger | undefined);
+    create(session: SessionInfo): Promise<void>;
+    get(id: string): Promise<SessionInfo | null>;
+    getByAcpxRecordId(recordId: string): Promise<SessionInfo | null>;
+    findByScope(opts: {
+        workdir: string;
+        agentType: string;
+        name?: string;
+    }): Promise<SessionInfo | null>;
+    list(filter?: SessionFilter): Promise<SessionInfo[]>;
+    update(id: string, patch: Partial<SessionInfo>): Promise<void>;
+    delete(id: string): Promise<void>;
+    sweepStale(maxAgeMs: number): Promise<string[]>;
+    protected afterWrite(): Promise<void>;
+    private load;
+    private withLock;
+}
+export declare class RuntimeDbSessionStore implements SessionStore {
+    private readonly adapter;
+    private readonly logger?;
+    private readonly writes;
+    private initPromise;
+    constructor(adapter: SqlDatabaseAdapter, logger?: Logger | undefined);
+    create(session: SessionInfo): Promise<void>;
+    get(id: string): Promise<SessionInfo | null>;
+    getByAcpxRecordId(recordId: string): Promise<SessionInfo | null>;
+    findByScope(opts: {
+        workdir: string;
+        agentType: string;
+        name?: string;
+    }): Promise<SessionInfo | null>;
+    list(filter?: SessionFilter): Promise<SessionInfo[]>;
+    update(id: string, patch: Partial<SessionInfo>): Promise<void>;
+    updateStatus(id: string, status: SessionStatus, error?: string): Promise<void>;
+    delete(id: string): Promise<void>;
+    sweepStale(maxAgeMs: number): Promise<string[]>;
+    private ensureInitialized;
+    private upsert;
+    private execute;
+    private getMany;
+    private getOne;
+}
+export interface AcpSessionStoreOptions {
+    runtime?: SessionStoreRuntime;
+    stateFile?: string;
+    backend?: SessionStoreBackend;
+}
+export declare class AcpSessionStore implements SessionStore {
+    readonly backend: SessionStoreBackend;
+    private readonly delegate;
+    constructor(options?: AcpSessionStoreOptions);
+    create(session: SessionInfo): Promise<void>;
+    get(id: string): Promise<SessionInfo | null>;
+    getByAcpxRecordId(recordId: string): Promise<SessionInfo | null>;
+    findByScope(opts: {
+        workdir: string;
+        agentType: string;
+        name?: string;
+    }): Promise<SessionInfo | null>;
+    list(filter?: SessionFilter): Promise<SessionInfo[]>;
+    update(id: string, patch: Partial<SessionInfo>): Promise<void>;
+    updateStatus(id: string, status: SessionStatus, error?: string): Promise<void>;
+    delete(id: string): Promise<void>;
+    sweepStale(maxAgeMs: number): Promise<string[]>;
+}
+export type { SessionFilter, SessionInfo, SessionStatus, SessionStore, } from "./types.js";
+//# sourceMappingURL=session-store.d.ts.map

package/dist/node/src/services/session-store.d.ts.map

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

package/dist/node/src/services/skill-callback-bridge.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Skill callback bridge — child→parent USE_SKILL routing.
+ *
+ * Spawned task agents (Claude Code, Codex, Gemini CLI, etc.) cannot directly
+ * invoke parent skills. The bridge listens to PTY session output and, when
+ * the child emits a directive of the form
+ *
+ *   USE_SKILL <slug> <json_args>
+ *
+ * dispatches to the parent's USE_SKILL action and pipes the result back into
+ * the same session via `ptyService.sendToSession`.
+ *
+ * Default-on per the Hermes-style project direction. Disable by setting
+ * `ELIZA_ENABLE_CHILD_SKILL_CALLBACK=0`.
+ *
+ * @module services/skill-callback-bridge
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { PTYService } from "./pty-service.js";
+interface SkillCallbackInvocation {
+    slug: string;
+    args: unknown;
+}
+/**
+ * Parse the first USE_SKILL directive in a chunk of agent output, if any.
+ * The directive must be on its own line (after optional whitespace).
+ */
+export declare function parseUseSkillDirective(text: string): SkillCallbackInvocation | null;
+interface BridgeDeps {
+    runtime: IAgentRuntime;
+    ptyService: PTYService;
+    /**
+     * Optional: per-session allow-list of skill slugs. The bridge consults the
+     * registry below when dispatching a child USE_SKILL directive. A directive
+     * whose slug is not on the session's allow-list is rejected back into the
+     * child with an error message listing the slugs that were rendered into that
+     * session's SKILLS.md.
+     *
+     * If omitted (or no entry is registered for the session), the bridge falls
+     * back to permissive behavior — any enabled skill may be invoked. This
+     * preserves backwards-compatible behavior for callers that do not yet wire
+     * per-spawn manifests.
+     */
+    sessionAllowList?: SkillSessionAllowList;
+}
+/**
+ * Session-scoped allow-list registry. Callers register a session's allow-list
+ * at spawn time from the generated SKILLS.md manifest. The bridge reads the
+ * entry when a USE_SKILL directive arrives.
+ *
+ * Using a plain Map instead of a WeakMap — the key is the PTY sessionId
+ * string assigned at spawn time, which we must explicitly clear on session
+ * teardown to avoid leaks.
+ */
+export interface SkillSessionAllowList {
+    register: (sessionId: string, slugs: readonly string[]) => void;
+    clear: (sessionId: string) => void;
+    get: (sessionId: string) => readonly string[] | undefined;
+}
+export declare function createSkillSessionAllowList(): SkillSessionAllowList;
+/**
+ * Ensure the bridge is installed exactly once for this runtime+PTY pair.
+ * Safe to call from every task spawn — subsequent calls are no-ops. The
+ * session allow-list registry, when supplied, is attached on the first
+ * install and reused thereafter; callers can look up the registry they
+ * passed in to register per-session slugs.
+ */
+export declare function ensureSkillCallbackBridge(deps: BridgeDeps): void;
+/**
+ * Install the child→parent USE_SKILL bridge for the given PTY service. Safe
+ * to call multiple times — duplicate listeners are idempotent because the
+ * unsubscribe handle is returned to the caller.
+ *
+ * Returns a teardown function. Call it on shutdown to remove the listener.
+ */
+export declare function installSkillCallbackBridge(deps: BridgeDeps): () => void;
+export {};
+//# sourceMappingURL=skill-callback-bridge.d.ts.map

package/dist/node/src/services/skill-callback-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-callback-bridge.d.ts","sourceRoot":"","sources":["../../../../src/services/skill-callback-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAU,aAAa,EAAU,MAAM,eAAe,CAAC;AAKnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqBnD,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAsBD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX,uBAAuB,GAAG,IAAI,CAmBhC;AAkCD,UAAU,UAAU;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC3D;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAWnE;AASD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAKhE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI,CA+KvE"}

package/dist/node/src/services/skill-essentials.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Auto-injected subset of `assets/claude-code-skills/eliza-runtime/SKILL.md`
+ * that ships verbatim in the workspace-lock brief for claude sub-agents.
+ *
+ * Why a separate constant (and not just a Read of SKILL.md at runtime):
+ * sub-agents on the Claude.ai consumer-tier OAuth do not have the `Skill`
+ * tool, so the skill auto-load mechanism is unavailable to them. Inlining
+ * the must-have sections into the spawn brief gives them the operating
+ * manual upfront with zero file I/O.
+ *
+ * Keep this in sync with SKILL.md: when you edit one, edit both. SKILL.md
+ * remains the canonical / extended manual (spawn-variants table, helper
+ * scripts, references). This constant is the always-injected minimum.
+ */
+export declare const CLAUDE_SKILL_ESSENTIALS = "Tool availability varies by Claude Code build and account tier \u2014 enumerate your actual tools (read `.claude/settings.json`'s `permissions.allow`, or use `ToolSearch` if present) before deciding you can't do a thing.\n\n# DECISION protocol\n\nThe orchestrator greps your stdout for lines starting with `DECISION:`. Use them when you make an architectural choice not covered by the brief, or when reporting a hard limitation. Examples:\n\n```\nDECISION: chose /api/v1/messages/ over /messages/ to match existing eliza-cloud route prefix.\nDECISION: cannot run shell commands \u2014 this session has Read/Grep/Glob but no Bash, Monitor, or run_shell_command. Reported what I could find statically.\n```\n\nALWAYS-on, no shell tool required \u2014 just print the line.\n\n# What you should NEVER do\n\n- Refuse a task as \"no shell available\" without first enumerating your actual tool list (settings.json + ToolSearch). Different tiers ship different shell tools \u2014 `Bash`, `Monitor`, `run_shell_command` \u2014 at least one is usually present.\n- Say \"use the `!` prefix\" or \"run this in your terminal\" \u2014 there is no terminal in your face.\n- Ask the human to clarify or provide input \u2014 there is no human in your session.\n- Push to remotes, write outside workdir, print env tokens.\n- Treat partial information as a blocker \u2014 produce the best output you can with what you have.\n\n# Bridge endpoints (parent state, read-only)\n\nWhen HTTP hooks are wired (variants `swarm` and `repo`), GET these to query parent state:\n- `http://localhost:${ELIZA_HOOK_PORT:-2138}/api/coding-agents/$PARALLAX_SESSION_ID/parent-context` \u2014 agent character, originating room, original task\n- `.../memory?q=<query>&limit=<N>` \u2014 recent messages from the originating room\n- `.../active-workspaces` \u2014 sibling sub-agents (swarm only)\n\nAuth is the path-embedded session id. Loopback-only, GET-only, read-only.\n\n# Constraints\n\n- Sealed env: only an allowlist of vars is forwarded (PATH, HOME, USER, SHELL, ANTHROPIC_MODEL, GITHUB_TOKEN, PARALLAX_SESSION_ID, ELIZA_HOOK_PORT, etc.).\n- Workspace-only writes: write only inside your workdir.\n- Don't push to git remotes \u2014 Eliza handles git push, PR creation, cross-repo coordination.\n- Don't print secrets \u2014 PTY output is captured. Reference secrets by env-var name.\n\nFor deeper context (spawn-variants table, helper scripts, references) see `~/.claude/skills/eliza-runtime/SKILL.md`.";
+//# sourceMappingURL=skill-essentials.d.ts.map

package/dist/node/src/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/node/src/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, documents, 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, documents, 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/node/src/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;AA8WD,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/node/src/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/node/src/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,EAAmB,MAAM,eAAe,CAAC;AAKpE,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/node/src/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 scores array. 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/node/src/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,EACL,KAAK,aAAa,EAInB,MAAM,eAAe,CAAC;AAwDvB,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;AA6RD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyK7B"}