@elizaos/plugin-agent-orchestrator 0.3.6 → 0.3.7

package/dist/providers/action-examples.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider that injects structured action call examples into the prompt context.
+ *
+ * ElizaOS core only shows exampleCalls from its static action-docs registry,
+ * which doesn't include custom plugin actions. This provider bridges the gap
+ * by formatting our coding agent action examples in the same structured format
+ * the model sees for core actions.
+ *
+ * @module providers/action-examples
+ */
+import type { Provider } from "@elizaos/core";
+export declare const codingAgentExamplesProvider: Provider;
+//# sourceMappingURL=action-examples.d.ts.map

package/dist/providers/action-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-examples.d.ts","sourceRoot":"","sources":["../../src/providers/action-examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAyB,QAAQ,EAAS,MAAM,eAAe,CAAC;AAyG5E,eAAO,MAAM,2BAA2B,EAAE,QAsCzC,CAAC"}

package/dist/providers/active-workspace-context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider that injects active workspace and session context into every prompt.
+ *
+ * Mima needs to know what workspaces exist, which agents are running, and their
+ * current status — without having to call LIST_AGENTS every message. This provider
+ * reads from both the workspace service and PTY service to build a live context
+ * summary that's always available in the prompt.
+ *
+ * @module providers/active-workspace-context
+ */
+import type { Provider } from "@elizaos/core";
+export declare const activeWorkspaceContextProvider: Provider;
+//# sourceMappingURL=active-workspace-context.d.ts.map

package/dist/providers/active-workspace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-workspace-context.d.ts","sourceRoot":"","sources":["../../src/providers/active-workspace-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAyB,QAAQ,EAAS,MAAM,eAAe,CAAC;AA2C5E,eAAO,MAAM,8BAA8B,EAAE,QA+H5C,CAAC"}

package/dist/services/agent-metrics.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Lightweight per-agent-type metrics for observability.
+ *
+ * Self-contained tracker — no dependencies on PTYService state.
+ *
+ * @module services/agent-metrics
+ */
+export interface AgentMetrics {
+    spawned: number;
+    completed: number;
+    completedViaFastPath: number;
+    completedViaClassifier: number;
+    stallCount: number;
+    avgCompletionMs: number;
+    totalCompletionMs: number;
+}
+export declare class AgentMetricsTracker {
+    private metrics;
+    /** Get (or lazily initialize) metrics for a given agent type. */
+    get(agentType: string): AgentMetrics;
+    /** Record a task completion and update rolling average duration. */
+    recordCompletion(agentType: string, method: "fast-path" | "classifier", durationMs: number): void;
+    /** Increment the stall counter for an agent type. */
+    incrementStalls(agentType: string): void;
+    /** Return a serializable copy of all metrics (for API endpoints). */
+    getAll(): Record<string, Omit<AgentMetrics, "totalCompletionMs">>;
+}
+//# sourceMappingURL=agent-metrics.d.ts.map

package/dist/services/agent-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-metrics.d.ts","sourceRoot":"","sources":["../../src/services/agent-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAwC;IAEvD,iEAAiE;IACjE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAiBpC,oEAAoE;IACpE,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAAG,YAAY,EAClC,UAAU,EAAE,MAAM,GACjB,IAAI;IASP,qDAAqD;IACrD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIxC,qEAAqE;IACrE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;CAQlE"}

package/dist/services/agent-selection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Dynamic agent selection strategy.
+ *
+ * Chooses which coding-agent CLI to spawn when the caller does not
+ * specify an explicit `agentType`.
+ *
+ *   - **fixed**  — always returns `config.fixedAgentType`
+ *   - **ranked** — scores each installed agent on success rate,
+ *                  stall frequency, and completion speed, then
+ *                  returns the highest-scoring one
+ *
+ * @module services/agent-selection
+ */
+import type { AdapterType, PreflightResult } from "coding-agent-adapters";
+export type AgentSelectionStrategy = "fixed" | "ranked";
+/** Subset of AgentMetrics fields used for scoring. */
+export interface AgentScoreInput {
+    spawned: number;
+    completed: number;
+    stallCount: number;
+    avgCompletionMs: number;
+}
+export interface AgentSelectionConfig {
+    strategy: AgentSelectionStrategy;
+    fixedAgentType: AdapterType;
+}
+export interface AgentSelectionContext {
+    config: AgentSelectionConfig;
+    /** Per-agent-type metrics snapshot (may be empty). */
+    metrics: Record<string, AgentScoreInput>;
+    /** Preflight results — only the `installed` ones are candidates. */
+    installedAgents: PreflightResult[];
+}
+/**
+ * Compute a 0–1 score for a single agent based on its metrics.
+ *
+ * - `successRate`  = completed / spawned  (0.5 neutral prior when no data)
+ * - `volumeWeight` = min(1, spawned / 5)  — blends toward neutral at low N
+ * - `stallPenalty`  = (stallCount / spawned) * 0.3
+ * - `speedPenalty`  = min(avgCompletionMs / 300_000, 1) * 0.1  — weak tiebreaker
+ *
+ * Cold-start (no spawns): returns 0.5 so all agents are equal.
+ */
+export declare function computeAgentScore(metrics: AgentScoreInput | undefined): number;
+/**
+ * Select the best agent type given the current strategy, metrics, and
+ * installed agents.
+ *
+ * Explicit user choice (`params.agentType`) should be resolved by the
+ * caller *before* reaching this function.
+ */
+export declare function selectAgentType(ctx: AgentSelectionContext): AdapterType;
+//# sourceMappingURL=agent-selection.d.ts.map

package/dist/services/agent-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-selection.d.ts","sourceRoot":"","sources":["../../src/services/agent-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG1E,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,cAAc,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,oEAAoE;IACpE,eAAe,EAAE,eAAe,EAAE,CAAC;CACpC;AAID;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,GAAG,SAAS,GACnC,MAAM,CAaR;AAOD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,WAAW,CA8BvE"}

package/dist/services/ansi-utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ANSI/terminal utility functions for processing PTY output.
+ *
+ * Pure functions — no state, no dependencies beyond the standard library.
+ *
+ * @module services/ansi-utils
+ */
+/**
+ * Strip ANSI escape sequences from raw terminal output for readable text.
+ * Replaces cursor-forward codes with spaces (TUI uses these instead of actual spaces).
+ */
+export declare function stripAnsi(raw: string): string;
+/**
+ * Clean terminal output for display in chat messages.
+ *
+ * Goes beyond {@link stripAnsi} by also removing:
+ * - Unicode spinner/box-drawing/decorative characters from CLI TUIs
+ * - Lines that are only loading/thinking status text
+ * - Spinner status bar metadata (token counts, timing)
+ * - Consecutive blank lines (collapsed to one)
+ */
+export declare function cleanForChat(raw: string): string;
+/**
+ * Extract meaningful artifacts (PR URLs, commit hashes, key results) from raw
+ * terminal output.  Returns a compact summary suitable for chat messages,
+ * without dumping raw TUI output.
+ */
+export declare function extractCompletionSummary(raw: string): string;
+/**
+ * Extract a dev server URL from recent terminal output, if present.
+ *
+ * Looks for common patterns like:
+ *   - http://localhost:3000
+ *   - http://127.0.0.1:8080
+ *   - http://0.0.0.0:5173
+ *   - https://localhost:4200
+ *
+ * Returns the first match, or null if no dev server URL is found.
+ */
+export declare function extractDevServerUrl(raw: string): string | null;
+/**
+ * Capture the agent's output since the last task was sent, cleaned for chat display.
+ * Returns readable text with TUI noise removed, or empty string if no marker exists.
+ *
+ * Mutates `markers` by deleting the entry for `sessionId` after capture.
+ */
+export declare function captureTaskResponse(sessionId: string, buffers: Map<string, string[]>, markers: Map<string, number>): string;
+//# sourceMappingURL=ansi-utils.d.ts.map

package/dist/services/ansi-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi-utils.d.ts","sourceRoot":"","sources":["../../src/services/ansi-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwCH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBhD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmC5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CASR"}

package/dist/services/pty-auto-response.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Auto-response rule management for PTY sessions.
+ *
+ * Contains logic for pushing default auto-response rules per agent type
+ * and handling Gemini authentication flow.
+ *
+ * @module services/pty-auto-response
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import type { BunCompatiblePTYManager, PTYManager } from "pty-manager";
+export interface AutoResponseContext {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+    runtime: IAgentRuntime;
+    log: (msg: string) => void;
+}
+/**
+ * Push session-specific auto-response rules that depend on runtime config.
+ * Trust prompts, update notices, and other static rules are handled by
+ * adapter built-in rules (coding-agent-adapters). This only pushes rules
+ * that need runtime values (e.g. API keys).
+ */
+export declare function pushDefaultRules(ctx: AutoResponseContext, sessionId: string, agentType: string): Promise<void>;
+/**
+ * Handle Gemini authentication when login_required fires.
+ * Sends /auth to start the auth flow — auto-response rules
+ * then handle menu selection and API key input.
+ */
+export declare function handleGeminiAuth(ctx: AutoResponseContext, sessionId: string, sendKeysToSession: (sessionId: string, keys: string | string[]) => Promise<void>): Promise<void>;
+//# sourceMappingURL=pty-auto-response.d.ts.map

package/dist/services/pty-auto-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-auto-response.d.ts","sourceRoot":"","sources":["../../src/services/pty-auto-response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAEV,uBAAuB,EACvB,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAwFf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,GACjB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/services/pty-init.d.ts

@@ -0,0 +1,47 @@
+/**
+ * PTY manager initialization — extracted from PTYService.initialize().
+ *
+ * Creates either a BunCompatiblePTYManager (for Bun runtime) or PTYManager
+ * (for Node), wires up event handlers, and returns the configured manager.
+ *
+ * @module services/pty-init
+ */
+import { BunCompatiblePTYManager, PTYManager, type StallClassification } from "pty-manager";
+import type { PTYServiceConfig } from "./pty-types.js";
+/**
+ * All callbacks and state that the initialization logic needs
+ * from the surrounding PTYService instance.
+ */
+export interface InitContext {
+    serviceConfig: PTYServiceConfig;
+    classifyStall: (sessionId: string, recentOutput: string) => Promise<StallClassification | null>;
+    emitEvent: (sessionId: string, event: string, data: unknown) => void;
+    handleGeminiAuth: (sessionId: string) => void;
+    sessionOutputBuffers: Map<string, string[]>;
+    taskResponseMarkers: Map<string, number>;
+    metricsTracker: {
+        recordCompletion(type: string, method: string, durationMs: number): void;
+    };
+    traceEntries: Array<string | Record<string, unknown>>;
+    maxTraceEntries: number;
+    log: (msg: string) => void;
+    /** Check if a session has an active task in the coordinator. */
+    hasActiveTask?: (sessionId: string) => boolean;
+    /** Check if a session's task has had any coordinator activity (decisions > 0). */
+    hasTaskActivity?: (sessionId: string) => boolean;
+}
+/** Value returned by {@link initializePTYManager}. */
+export interface InitResult {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+}
+/**
+ * Create and configure a PTY manager for the current runtime.
+ *
+ * - **Bun**: instantiates a {@link BunCompatiblePTYManager} that spawns a
+ *   Node worker process and communicates via JSON-RPC over stdio.
+ * - **Node**: instantiates a {@link PTYManager} directly and registers
+ *   all built-in adapters in-process.
+ */
+export declare function initializePTYManager(ctx: InitContext): Promise<InitResult>;
+//# sourceMappingURL=pty-init.d.ts.map

package/dist/services/pty-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-init.d.ts","sourceRoot":"","sources":["../../src/services/pty-init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,uBAAuB,EAEvB,UAAU,EAKV,KAAK,mBAAmB,EAGzB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAcvD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,gBAAgB,CAAC;IAChC,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACrE,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,cAAc,EAAE;QACd,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1E,CAAC;IACF,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,gEAAgE;IAChE,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,kFAAkF;IAClF,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAClD;AA6BD,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CAsPrB"}

package/dist/services/pty-service.d.ts

@@ -0,0 +1,92 @@
+/** @module services/pty-service */
+import { type IAgentRuntime } from "@elizaos/core";
+import { type AdapterType, type AgentFileDescriptor, type ApprovalConfig, type ApprovalPreset, type PreflightResult, type WriteMemoryOptions } from "coding-agent-adapters";
+import { PTYConsoleBridge } from "pty-console";
+import type { SessionFilter, SessionMessage } from "pty-manager";
+import { type AgentSelectionStrategy } from "./agent-selection.js";
+import type { CodingAgentType, PTYServiceConfig, SessionEventCallback, SessionInfo, SpawnSessionOptions } from "./pty-types.js";
+import { SwarmCoordinator } from "./swarm-coordinator.js";
+export type { CodingAgentType, PTYServiceConfig, SessionEventName, SessionInfo, SpawnSessionOptions, } from "./pty-types.js";
+export { normalizeAgentType } from "./pty-types.js";
+/**
+ * Retrieve the SwarmCoordinator from the PTYService registered on the runtime.
+ * Returns undefined if PTYService or coordinator is not available.
+ */
+export declare function getCoordinator(runtime: IAgentRuntime): SwarmCoordinator | undefined;
+export declare class PTYService {
+    static serviceType: string;
+    capabilityDescription: string;
+    private runtime;
+    private manager;
+    private usingBunWorker;
+    private serviceConfig;
+    private sessionMetadata;
+    private sessionWorkdirs;
+    private eventCallbacks;
+    private outputUnsubscribers;
+    private sessionOutputBuffers;
+    private adapterCache;
+    /** Tracks the buffer index when a task was sent, so we can capture the response on completion */
+    private taskResponseMarkers;
+    /** Captures "Task completion trace" log entries from worker stderr (rolling, capped at 200) */
+    private traceEntries;
+    private static readonly MAX_TRACE_ENTRIES;
+    /** Lightweight per-agent-type metrics for observability */
+    private metricsTracker;
+    /** Console bridge for terminal output streaming and buffered hydration */
+    consoleBridge: PTYConsoleBridge | null;
+    /** Swarm coordinator instance (if active). Accessed via getCoordinator(runtime). */
+    coordinator: SwarmCoordinator | null;
+    constructor(runtime: IAgentRuntime, config?: PTYServiceConfig);
+    static start(runtime: IAgentRuntime): Promise<PTYService>;
+    static stopRuntime(runtime: IAgentRuntime): Promise<void>;
+    private initialize;
+    stop(): Promise<void>;
+    private generateSessionId;
+    /** Build a SessionIOContext from current instance state. */
+    private ioContext;
+    /**
+     * Spawn a new PTY session for a coding agent
+     */
+    spawnSession(options: SpawnSessionOptions): Promise<SessionInfo>;
+    private autoResponseContext;
+    private pushDefaultRules;
+    private handleGeminiAuth;
+    sendToSession(sessionId: string, input: string): Promise<SessionMessage | undefined>;
+    sendKeysToSession(sessionId: string, keys: string | string[]): Promise<void>;
+    stopSession(sessionId: string, force?: boolean): Promise<void>;
+    /** Default approval preset — runtime env var takes precedence over config. */
+    get defaultApprovalPreset(): ApprovalPreset;
+    /** Agent selection strategy — env var takes precedence. */
+    get agentSelectionStrategy(): AgentSelectionStrategy;
+    /** Default agent type when strategy is "fixed" — env var takes precedence. */
+    get defaultAgentType(): AdapterType;
+    /**
+     * Resolve which agent type to use when the caller didn't specify one.
+     *
+     * - **fixed**: returns `defaultAgentType` immediately
+     * - **ranked**: fetches preflight data, scores installed agents via
+     *   metrics, and returns the highest scorer
+     */
+    resolveAgentType(): Promise<string>;
+    getSession(sessionId: string): SessionInfo | undefined;
+    listSessions(filter?: SessionFilter): Promise<SessionInfo[]>;
+    subscribeToOutput(sessionId: string, callback: (data: string) => void): () => void;
+    getSessionOutput(sessionId: string, lines?: number): Promise<string>;
+    isSessionBlocked(sessionId: string): boolean;
+    checkAvailableAgents(types?: AdapterType[]): Promise<PreflightResult[]>;
+    getSupportedAgentTypes(): CodingAgentType[];
+    private classifyStall;
+    private getAdapter;
+    getWorkspaceFiles(agentType: AdapterType): AgentFileDescriptor[];
+    getMemoryFilePath(agentType: AdapterType): string;
+    getApprovalConfig(agentType: AdapterType, preset: ApprovalPreset): ApprovalConfig;
+    writeMemoryFile(agentType: AdapterType, workspacePath: string, content: string, options?: WriteMemoryOptions): Promise<string>;
+    onSessionEvent(callback: SessionEventCallback): () => void;
+    registerAdapter(adapter: unknown): void;
+    private toSessionInfo;
+    private emitEvent;
+    getAgentMetrics(): Record<string, Omit<import("./agent-metrics.js").AgentMetrics, "totalCompletionMs">>;
+    private log;
+}
+//# sourceMappingURL=pty-service.d.ts.map

package/dist/services/pty-service.d.ts.map

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

package/dist/services/pty-session-io.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Session I/O helpers — extracted from PTYService for maintainability.
+ *
+ * Standalone functions for sending input/keys to sessions and stopping
+ * sessions. Each function takes a {@link SessionIOContext} that provides
+ * the manager instance and shared state maps.
+ *
+ * @module services/pty-session-io
+ */
+import type { BunCompatiblePTYManager, PTYManager, SessionMessage } from "pty-manager";
+/**
+ * Shared context required by all session I/O functions.
+ * Built inline from PTYService instance fields.
+ */
+export interface SessionIOContext {
+    manager: PTYManager | BunCompatiblePTYManager;
+    usingBunWorker: boolean;
+    sessionOutputBuffers: Map<string, string[]>;
+    taskResponseMarkers: Map<string, number>;
+    outputUnsubscribers: Map<string, () => void>;
+}
+/**
+ * Send text input to a session.
+ *
+ * Marks the buffer position for task response capture, then writes the
+ * input via the appropriate manager API.
+ */
+export declare function sendToSession(ctx: SessionIOContext, sessionId: string, input: string): Promise<SessionMessage | undefined>;
+/**
+ * Send key sequences to a session (for special keys like arrows, enter, etc.).
+ */
+export declare function sendKeysToSession(ctx: SessionIOContext, sessionId: string, keys: string | string[]): Promise<void>;
+/**
+ * Stop a PTY session and clean up all associated state.
+ *
+ * @param force - When true, sends SIGKILL immediately instead of SIGTERM.
+ *   Use for sessions whose task is already complete — there's nothing to save.
+ */
+export declare function stopSession(ctx: SessionIOContext, sessionId: string, sessionMetadata: Map<string, Record<string, unknown>>, sessionWorkdirs: Map<string, string>, log: (msg: string) => void, force?: boolean): Promise<void>;
+/**
+ * Subscribe to live output from a session.
+ * Returns an unsubscribe function.
+ */
+export declare function subscribeToOutput(ctx: SessionIOContext, sessionId: string, callback: (data: string) => void): () => void;
+/**
+ * Get buffered or logged output from a session.
+ */
+export declare function getSessionOutput(ctx: SessionIOContext, sessionId: string, lines?: number): Promise<string>;
+//# sourceMappingURL=pty-session-io.d.ts.map

package/dist/services/pty-session-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-session-io.d.ts","sourceRoot":"","sources":["../../src/services/pty-session-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAoBrC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACrD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC1B,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/B,MAAM,IAAI,CAiBZ;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAejB"}

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

@@ -0,0 +1,50 @@
+/**
+ * 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";
+/**
+ * Build a sanitized base environment from process.env, keeping only
+ * safe system variables. Agent-specific credentials are injected
+ * separately by the adapter's getEnv().
+ */
+export declare function buildSanitizedBaseEnv(): Record<string, string>;
+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>;
+    pushDefaultRules: (sessionId: string, agentType: string) => Promise<void>;
+    toSessionInfo: (session: SessionHandle | WorkerSessionHandle, workdir?: string) => SessionInfo;
+    log: (msg: string) => void;
+}
+/**
+ * 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/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":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAsBxB;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO9D;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,gBAAgB,CAAC;IAChC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7C,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,iBAAiB,CAAC;IAC1D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,iBAAiB,EAAE,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,aAAa,EAAE,CACb,OAAO,EAAE,aAAa,GAAG,mBAAmB,EAC5C,OAAO,CAAC,EAAE,MAAM,KACb,WAAW,CAAC;IACjB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAc5E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,aAAa,GAAG,mBAAmB,EAC5C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,IAAI,CA6FN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CA2C9B"}

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

@@ -0,0 +1,80 @@
+/**
+ * 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 coding agent adapters (default: true) */
+    registerCodingAdapters?: boolean;
+    /** Maximum concurrent PTY sessions (default: 8) */
+    maxConcurrentSessions?: number;
+    /**
+     * Default approval preset for coding 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: "permissive"
+     */
+    defaultApprovalPreset?: ApprovalPreset;
+}
+/** Available coding agent types */
+export type CodingAgentType = "shell" | "pi" | AdapterType;
+/** True when the user requested the Pi coding agent. */
+export declare const isPiAgentType: (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;
+export interface SpawnSessionOptions {
+    /** Human-readable session name */
+    name: string;
+    /** Adapter type: "shell" | "pi" | "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/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,0DAA0D;IAC1D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAC;CACxC;AAED,mCAAmC;AACnC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,CAAC;AAU3D,wDAAwD;AACxD,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,OAGhE,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,eAoBlD,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAKtD,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,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/services/stall-classifier.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Stall classification subsystem — determines what a "stalled" coding 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 { TaskContextSummary, DecisionHistoryEntry } 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 ~/.milady/debug/ on stall (default: false) */
+    debugSnapshots?: boolean;
+    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 ~/.milady/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,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAExC,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,0EAA0E;IAC1E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAmCR;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,CAiGrC;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,CA8CR;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAqHrC"}