@action-llama/action-llama 0.27.5 → 0.29.0

package/dist/agents/transport-runner.d.ts

@@ -0,0 +1,123 @@
+/**
+ * TransportAgentRunner — runs Pi sessions in the scheduler process,
+ * driving a remote runtime via a Transport.
+ *
+ * Replaces ContainerAgentRunner for the centralized architecture where:
+ *  - The scheduler is the "brain" (LLM session, tool orchestration)
+ *  - The runtime is the "body" (filesystem, shell, credentials)
+ *  - The transport connects them (DockerExecTransport, SshTransport, etc.)
+ *
+ * Key differences from ContainerAgentRunner:
+ *  - Pi session runs in-process (not inside the container)
+ *  - Events are captured directly (no JSON log parsing)
+ *  - Credentials staged via transport (no volume mounts needed)
+ *  - No gateway registration (direct access to scheduler services)
+ *  - No signal files (scheduler tools handle reruns, returns, etc.)
+ */
+import type { AgentConfig, GlobalConfig } from "../shared/config.js";
+import type { Logger } from "../shared/logger.js";
+import type { StatusTracker } from "../tui/status-tracker.js";
+import type { RunOutcome } from "./types.js";
+import type { PoolRunner } from "../execution/runner-pool.js";
+import { ModelCircuitBreaker } from "./model-fallback.js";
+import type { SchedulerToolsOpts } from "./scheduler-tools.js";
+import type { WaitingRegistry } from "../execution/waiting-registry.js";
+export interface TransportAgentRunnerOpts {
+    globalConfig: GlobalConfig;
+    agentConfig: AgentConfig;
+    logger: Logger;
+    circuitBreaker: ModelCircuitBreaker;
+    statusTracker?: StatusTracker;
+    /** Base Docker image to use for provisioning containers. */
+    baseImage: string;
+    /** Project path on the host, for reading SKILL.md and config. */
+    projectPath: string;
+    /** Provider API keys (provider name → key). */
+    providerKeys?: Map<string, string>;
+    /** Scheduler tools dependencies. When provided, agents get lock/call/status tools. */
+    schedulerToolsDeps?: Omit<SchedulerToolsOpts, "agentName" | "instanceId" | "depth" | "onReturnValue">;
+    /** Waiting registry for suspend/resume support. */
+    waitingRegistry?: WaitingRegistry;
+    /** Callback when instance transitions to/from waiting state. */
+    onWaitStateChange?: (instanceId: string, state: "waiting" | "resumed") => void;
+}
+export declare class TransportAgentRunner implements PoolRunner {
+    private _running;
+    private _suspended;
+    private _aborting;
+    private _transport;
+    private _containerName;
+    private _session;
+    private _turnTextBuffer;
+    private _turnThinkingBuffer;
+    instanceId: string;
+    /** Trigger depth for subagent call tracking. Set by the scheduler before run(). */
+    depth: number;
+    private globalConfig;
+    private agentConfig;
+    private baseLogger;
+    private logger;
+    private circuitBreaker;
+    private statusTracker?;
+    private baseImage;
+    private projectPath;
+    private providerKeys;
+    private schedulerToolsDeps?;
+    private waitingRegistry?;
+    private onWaitStateChange?;
+    constructor(opts: TransportAgentRunnerOpts);
+    get isRunning(): boolean;
+    setAgentConfig(config: AgentConfig): void;
+    get isSuspended(): boolean;
+    abort(): void;
+    run(prompt: string, triggerInfo?: {
+        type: 'schedule' | 'manual' | 'webhook' | 'agent';
+        source?: string;
+    }, instanceId?: string): Promise<RunOutcome>;
+    private runInternal;
+    /**
+     * Handle a wait_for_trigger call from the agent.
+     * Suspends the container, registers in the waiting registry, and returns
+     * a promise that resolves when a matching trigger arrives.
+     */
+    private _handleWait;
+    /**
+     * Resume from a suspended wait state: unpause container and reconnect transport.
+     */
+    private _resumeFromWait;
+    /**
+     * Create and connect the appropriate transport based on the agent's runtime config.
+     */
+    private createTransport;
+    /**
+     * Provision a Docker container that stays alive for the transport to connect to.
+     * Returns the container name.
+     */
+    private provisionContainer;
+    /**
+     * Ensure a Docker image is available locally. If not, attempt to pull it.
+     */
+    private ensureImageAvailable;
+    /**
+     * Stage credentials onto the runtime via the transport.
+     * Returns a map of provider → API key for Pi session auth.
+     */
+    private stageCredentials;
+    /**
+     * Run the Pi session in-process with transport-backed tools.
+     */
+    private runPiSession;
+    /**
+     * Subscribe to Pi session events and forward them to the logger and status tracker.
+     * Since the session runs in-process, we get direct access to events.
+     */
+    private subscribeToEvents;
+    /**
+     * Extract human-readable text from a tool result, unwrapping the Pi SDK content array format.
+     * Returns empty string for empty/trivial results.
+     */
+    private extractToolResultText;
+    /** Flush accumulated text/thinking buffers to the logger. */
+    private flushTurnBuffers;
+}
+//# sourceMappingURL=transport-runner.d.ts.map

package/dist/agents/transport-runner.d.ts.map

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