@getpaseo/server 0.1.2

package/dist/server/server/agent/agent-manager.d.ts

@@ -0,0 +1,182 @@
+import { AGENT_LIFECYCLE_STATUSES, type AgentLifecycleStatus } from "../../shared/agent-lifecycle.js";
+import type { Logger } from "pino";
+import type { AgentCapabilityFlags, AgentClient, AgentMode, AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, AgentPromptInput, AgentProvider, AgentRunOptions, AgentRunResult, AgentSession, AgentSessionConfig, AgentStreamEvent, AgentTimelineItem, AgentUsage, AgentRuntimeInfo, ListPersistedAgentsOptions, PersistedAgentDescriptor } from "./agent-sdk-types.js";
+import type { AgentStorage } from "./agent-storage.js";
+export { AGENT_LIFECYCLE_STATUSES, type AgentLifecycleStatus };
+export type AgentManagerEvent = {
+    type: "agent_state";
+    agent: ManagedAgent;
+} | {
+    type: "agent_stream";
+    agentId: string;
+    event: AgentStreamEvent;
+};
+export type AgentSubscriber = (event: AgentManagerEvent) => void;
+export type SubscribeOptions = {
+    agentId?: string;
+    replayState?: boolean;
+};
+export type PersistedAgentQueryOptions = ListPersistedAgentsOptions & {
+    provider?: AgentProvider;
+};
+export type AgentAttentionCallback = (params: {
+    agentId: string;
+    provider: AgentProvider;
+    reason: "finished" | "error" | "permission";
+}) => void;
+export type AgentManagerOptions = {
+    clients?: Partial<Record<AgentProvider, AgentClient>>;
+    maxTimelineItems?: number;
+    idFactory?: () => string;
+    registry?: AgentStorage;
+    onAgentAttention?: AgentAttentionCallback;
+    logger: Logger;
+};
+export type WaitForAgentOptions = {
+    signal?: AbortSignal;
+    waitForActive?: boolean;
+};
+export type WaitForAgentResult = {
+    status: AgentLifecycleStatus;
+    permission: AgentPermissionRequest | null;
+    lastMessage: string | null;
+};
+export type WaitForAgentStartOptions = {
+    signal?: AbortSignal;
+};
+type AttentionState = {
+    requiresAttention: false;
+} | {
+    requiresAttention: true;
+    attentionReason: "finished" | "error" | "permission";
+    attentionTimestamp: Date;
+};
+type ManagedAgentBase = {
+    id: string;
+    provider: AgentProvider;
+    cwd: string;
+    capabilities: AgentCapabilityFlags;
+    config: AgentSessionConfig;
+    runtimeInfo?: AgentRuntimeInfo;
+    createdAt: Date;
+    updatedAt: Date;
+    availableModes: AgentMode[];
+    currentModeId: string | null;
+    pendingPermissions: Map<string, AgentPermissionRequest>;
+    timeline: AgentTimelineItem[];
+    persistence: AgentPersistenceHandle | null;
+    historyPrimed: boolean;
+    lastUserMessageAt: Date | null;
+    lastUsage?: AgentUsage;
+    lastError?: string;
+    attention: AttentionState;
+    /**
+     * Internal agents are hidden from listings and don't trigger notifications.
+     */
+    internal?: boolean;
+    /**
+     * User-defined labels for categorizing agents (e.g., { ui: "true" }).
+     */
+    labels: Record<string, string>;
+};
+type ManagedAgentWithSession = ManagedAgentBase & {
+    session: AgentSession;
+};
+type ManagedAgentInitializing = ManagedAgentWithSession & {
+    lifecycle: "initializing";
+    pendingRun: null;
+};
+type ManagedAgentIdle = ManagedAgentWithSession & {
+    lifecycle: "idle";
+    pendingRun: null;
+};
+type ManagedAgentRunning = ManagedAgentWithSession & {
+    lifecycle: "running";
+    pendingRun: AsyncGenerator<AgentStreamEvent>;
+};
+type ManagedAgentError = ManagedAgentWithSession & {
+    lifecycle: "error";
+    pendingRun: null;
+    lastError: string;
+};
+type ManagedAgentClosed = ManagedAgentBase & {
+    lifecycle: "closed";
+    session: null;
+    pendingRun: null;
+};
+export type ManagedAgent = ManagedAgentInitializing | ManagedAgentIdle | ManagedAgentRunning | ManagedAgentError | ManagedAgentClosed;
+export declare class AgentManager {
+    private readonly clients;
+    private readonly agents;
+    private readonly subscribers;
+    private readonly maxTimelineItems;
+    private readonly idFactory;
+    private readonly registry?;
+    private readonly previousStatuses;
+    private readonly backgroundTasks;
+    private onAgentAttention?;
+    private logger;
+    constructor(options: AgentManagerOptions);
+    registerClient(provider: AgentProvider, client: AgentClient): void;
+    setAgentAttentionCallback(callback: AgentAttentionCallback): void;
+    subscribe(callback: AgentSubscriber, options?: SubscribeOptions): () => void;
+    listAgents(): ManagedAgent[];
+    listPersistedAgents(options?: PersistedAgentQueryOptions): Promise<PersistedAgentDescriptor[]>;
+    getAgent(id: string): ManagedAgent | null;
+    getTimeline(id: string): AgentTimelineItem[];
+    createAgent(config: AgentSessionConfig, agentId?: string, options?: {
+        labels?: Record<string, string>;
+    }): Promise<ManagedAgent>;
+    resumeAgentFromPersistence(handle: AgentPersistenceHandle, overrides?: Partial<AgentSessionConfig>, agentId?: string, options?: {
+        createdAt?: Date;
+        updatedAt?: Date;
+        lastUserMessageAt?: Date | null;
+        labels?: Record<string, string>;
+    }): Promise<ManagedAgent>;
+    reloadAgentSession(agentId: string, overrides?: Partial<AgentSessionConfig>): Promise<ManagedAgent>;
+    closeAgent(agentId: string): Promise<void>;
+    setAgentMode(agentId: string, modeId: string): Promise<void>;
+    setAgentModel(agentId: string, modelId: string | null): Promise<void>;
+    setAgentThinkingOption(agentId: string, thinkingOptionId: string | null): Promise<void>;
+    setTitle(agentId: string, title: string): Promise<void>;
+    notifyAgentState(agentId: string): void;
+    clearAgentAttention(agentId: string): Promise<void>;
+    runAgent(agentId: string, prompt: AgentPromptInput, options?: AgentRunOptions): Promise<AgentRunResult>;
+    recordUserMessage(agentId: string, text: string, options?: {
+        messageId?: string;
+    }): void;
+    appendTimelineItem(agentId: string, item: AgentTimelineItem): Promise<void>;
+    streamAgent(agentId: string, prompt: AgentPromptInput, options?: AgentRunOptions): AsyncGenerator<AgentStreamEvent>;
+    waitForAgentRunStart(agentId: string, options?: WaitForAgentStartOptions): Promise<void>;
+    respondToPermission(agentId: string, requestId: string, response: AgentPermissionResponse): Promise<void>;
+    cancelAgentRun(agentId: string): Promise<boolean>;
+    getPendingPermissions(agentId: string): AgentPermissionRequest[];
+    private peekPendingPermission;
+    hydrateTimelineFromProvider(agentId: string): Promise<void>;
+    private getLastAssistantMessage;
+    private getLastAssistantMessageFromTimeline;
+    waitForAgentEvent(agentId: string, options?: WaitForAgentOptions): Promise<WaitForAgentResult>;
+    private registerSession;
+    private persistSnapshot;
+    private refreshSessionState;
+    private refreshRuntimeInfo;
+    private hydrateTimeline;
+    private handleStreamEvent;
+    private recordTimeline;
+    private emitState;
+    private checkAndSetAttention;
+    private enqueueBackgroundPersist;
+    private trackBackgroundTask;
+    /**
+     * Flush any background persistence work (best-effort).
+     * Used by daemon shutdown paths to avoid unhandled rejections after cleanup.
+     */
+    flush(): Promise<void>;
+    private broadcastAgentAttention;
+    private dispatchStream;
+    private dispatch;
+    private normalizeConfig;
+    private requireClient;
+    private requireAgent;
+}
+//# sourceMappingURL=agent-manager.d.ts.map

package/dist/server/server/agent/agent-manager.d.ts.map

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