@rudderhq/server 0.1.0-canary.0

package/dist/services/runtime-kernel/heartbeat.d.ts

@@ -0,0 +1,882 @@
+import type { Db } from "@rudderhq/db";
+import type { AgentSkillAnalytics, ExecutionObservabilitySurface } from "@rudderhq/shared";
+import { agents } from "@rudderhq/db";
+import type { AgentRuntimeInvocationMeta, AgentRuntimeSessionCodec } from "../../agent-runtimes/index.js";
+import { type BudgetEnforcementScope } from "../budgets.js";
+import { type ResolvedWorkspaceForRun } from "../agent-run-context.js";
+import { type SessionCompactionPolicy } from "@rudderhq/agent-runtime-utils";
+export { prioritizeProjectWorkspaceCandidatesForRun, type ResolvedWorkspaceForRun } from "../agent-run-context.js";
+interface WakeupOptions {
+    source?: "timer" | "assignment" | "on_demand" | "automation";
+    triggerDetail?: "manual" | "ping" | "callback" | "system";
+    reason?: string | null;
+    payload?: Record<string, unknown> | null;
+    idempotencyKey?: string | null;
+    requestedByActorType?: "user" | "agent" | "system";
+    requestedByActorId?: string | null;
+    contextSnapshot?: Record<string, unknown>;
+    existingWakeupRequestId?: string | null;
+}
+export declare function resolveHeartbeatObservabilitySurface(contextSnapshot: Record<string, unknown> | null | undefined): ExecutionObservabilitySurface;
+export declare function buildIssueRunTraceName(input: {
+    issueTitle?: string | null;
+    issueId: string;
+}): string;
+export declare function buildHeartbeatRuntimeTraceMetadata(input: {
+    runtimeConfig: Record<string, unknown>;
+    runtimeSkills: Array<{
+        key: string;
+        runtimeName: string;
+        name: string | null;
+        description: string | null;
+    }>;
+    adapterMeta?: Pick<AgentRuntimeInvocationMeta, "agentRuntimeType" | "command" | "cwd" | "commandNotes" | "promptMetrics"> | null;
+}): {
+    runtimeAgentType?: string | undefined;
+    runtimeCommand?: string | undefined;
+    runtimeCwd?: string | null | undefined;
+    runtimeCommandNotes?: string[] | undefined;
+    runtimePromptMetrics?: Record<string, number> | null | undefined;
+    loadedSkillCount: number;
+    loadedSkillKeys: string[];
+    loadedSkills: {
+        key: string;
+        runtimeName: string | null;
+        name: string | null;
+        description: string | null;
+    }[];
+    instructionsConfigured: boolean;
+    instructionsFilePath: string | null;
+};
+type ResumeSessionRow = {
+    sessionParamsJson: Record<string, unknown> | null;
+    sessionDisplayId: string | null;
+    lastRunId: string | null;
+};
+export declare function buildExplicitResumeSessionOverride(input: {
+    resumeFromRunId: string;
+    resumeRunSessionIdBefore: string | null;
+    resumeRunSessionIdAfter: string | null;
+    taskSession: ResumeSessionRow | null;
+    sessionCodec: AgentRuntimeSessionCodec;
+}): {
+    sessionDisplayId: string | null;
+    sessionParams: Record<string, unknown> | null;
+} | null;
+export declare function parseSessionCompactionPolicy(agent: typeof agents.$inferSelect): SessionCompactionPolicy;
+export declare function resolveRuntimeSessionParamsForWorkspace(input: {
+    orgId: string;
+    agent: {
+        id: string;
+        name?: string | null;
+        workspaceKey?: string | null;
+    };
+    previousSessionParams: Record<string, unknown> | null;
+    resolvedWorkspace: ResolvedWorkspaceForRun;
+}): {
+    sessionParams: Record<string, unknown> | null;
+    warning: string | null;
+};
+export declare function shouldResetTaskSessionForWake(contextSnapshot: Record<string, unknown> | null | undefined): boolean;
+export declare function formatRuntimeWorkspaceWarningLog(warning: string): {
+    stream: "stdout";
+    chunk: string;
+};
+export declare function heartbeatService(db: Db): {
+    list: (orgId: string, agentId?: string, limit?: number) => Promise<{
+        resultJson: Record<string, unknown> | null;
+        id: string;
+        orgId: string;
+        agentId: string;
+        invocationSource: string;
+        triggerDetail: string | null;
+        status: string;
+        startedAt: Date | null;
+        finishedAt: Date | null;
+        error: string | null;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }[]>;
+    getAgentSkillAnalytics: (agentId: string, opts?: {
+        windowDays?: number;
+        now?: Date;
+        startDate?: string;
+        endDate?: string;
+    }) => Promise<AgentSkillAnalytics>;
+    getRun: (runId: string) => Promise<{
+        error: string | null;
+        id: string;
+        status: string;
+        updatedAt: Date;
+        orgId: string;
+        startedAt: Date | null;
+        createdAt: Date;
+        triggerDetail: string | null;
+        agentId: string;
+        finishedAt: Date | null;
+        invocationSource: string;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        resultJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+    }>;
+    getRuntimeState: (agentId: string) => Promise<{
+        sessionDisplayId: string | null;
+        sessionParamsJson: Record<string, unknown> | null;
+        updatedAt: Date;
+        orgId: string;
+        createdAt: Date;
+        agentRuntimeType: string;
+        agentId: string;
+        lastError: string | null;
+        sessionId: string | null;
+        stateJson: Record<string, unknown>;
+        lastRunId: string | null;
+        lastRunStatus: string | null;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        totalCachedInputTokens: number;
+        totalCostCents: number;
+    } | null>;
+    listTaskSessions: (agentId: string) => Promise<{
+        id: string;
+        updatedAt: Date;
+        orgId: string;
+        createdAt: Date;
+        agentRuntimeType: string;
+        taskKey: string;
+        agentId: string;
+        lastError: string | null;
+        lastRunId: string | null;
+        sessionParamsJson: Record<string, unknown> | null;
+        sessionDisplayId: string | null;
+    }[]>;
+    resetRuntimeSession: (agentId: string, opts?: {
+        taskKey?: string | null;
+    }) => Promise<{
+        sessionDisplayId: null;
+        sessionParamsJson: null;
+        clearedTaskSessions: number;
+        agentId: string;
+        orgId: string;
+        agentRuntimeType: string;
+        sessionId: string | null;
+        stateJson: Record<string, unknown>;
+        lastRunId: string | null;
+        lastRunStatus: string | null;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        totalCachedInputTokens: number;
+        totalCostCents: number;
+        lastError: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    listEvents: (runId: string, afterSeq?: number, limit?: number) => Omit<import("drizzle-orm/pg-core").PgSelectBase<"heartbeat_run_events", {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "heartbeat_run_events";
+            dataType: "number";
+            columnType: "PgBigSerial53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        orgId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "org_id";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        runId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "run_id";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        agentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "agent_id";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        seq: import("drizzle-orm/pg-core").PgColumn<{
+            name: "seq";
+            tableName: "heartbeat_run_events";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        eventType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "event_type";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        stream: import("drizzle-orm/pg-core").PgColumn<{
+            name: "stream";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        level: import("drizzle-orm/pg-core").PgColumn<{
+            name: "level";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        color: import("drizzle-orm/pg-core").PgColumn<{
+            name: "color";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        message: import("drizzle-orm/pg-core").PgColumn<{
+            name: "message";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: "heartbeat_run_events";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "heartbeat_run_events";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    }, "single", Record<"heartbeat_run_events", "not-null">, false, "where" | "orderBy" | "limit", {
+        message: string | null;
+        id: number;
+        orgId: string;
+        createdAt: Date;
+        color: string | null;
+        payload: Record<string, unknown> | null;
+        agentId: string;
+        level: string | null;
+        runId: string;
+        seq: number;
+        eventType: string;
+        stream: string | null;
+    }[], {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "heartbeat_run_events";
+            dataType: "number";
+            columnType: "PgBigSerial53";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        orgId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "org_id";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        runId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "run_id";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        agentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "agent_id";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        seq: import("drizzle-orm/pg-core").PgColumn<{
+            name: "seq";
+            tableName: "heartbeat_run_events";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        eventType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "event_type";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        stream: import("drizzle-orm/pg-core").PgColumn<{
+            name: "stream";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        level: import("drizzle-orm/pg-core").PgColumn<{
+            name: "level";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        color: import("drizzle-orm/pg-core").PgColumn<{
+            name: "color";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        message: import("drizzle-orm/pg-core").PgColumn<{
+            name: "message";
+            tableName: "heartbeat_run_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: "heartbeat_run_events";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "heartbeat_run_events";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    }>, "where" | "orderBy" | "limit">;
+    readLog: (runId: string, opts?: {
+        offset?: number;
+        limitBytes?: number;
+    }) => Promise<{
+        content: string;
+        endOffset: number;
+        eof: boolean;
+        nextOffset?: number;
+        runId: string;
+        store: string;
+        logRef: string;
+    }>;
+    invoke: (agentId: string, source?: "timer" | "assignment" | "on_demand" | "automation", contextSnapshot?: Record<string, unknown>, triggerDetail?: "manual" | "ping" | "callback" | "system", actor?: {
+        actorType?: "user" | "agent" | "system";
+        actorId?: string | null;
+    }) => Promise<{
+        error: string | null;
+        id: string;
+        status: string;
+        updatedAt: Date;
+        orgId: string;
+        startedAt: Date | null;
+        createdAt: Date;
+        triggerDetail: string | null;
+        agentId: string;
+        finishedAt: Date | null;
+        invocationSource: string;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        resultJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+    } | null>;
+    wakeup: (agentId: string, opts?: WakeupOptions) => Promise<{
+        error: string | null;
+        id: string;
+        status: string;
+        updatedAt: Date;
+        orgId: string;
+        startedAt: Date | null;
+        createdAt: Date;
+        triggerDetail: string | null;
+        agentId: string;
+        finishedAt: Date | null;
+        invocationSource: string;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        resultJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+    } | null>;
+    resumeDeferredWakeupsForAgent: (agentId: string) => Promise<{
+        replayed: number;
+        wakeupRequestIds: string[];
+    }>;
+    retryRun: (runId: string, opts?: {
+        requestedByActorType?: WakeupOptions["requestedByActorType"];
+        requestedByActorId?: string | null;
+        now?: Date;
+    }) => Promise<{
+        error: string | null;
+        id: string;
+        status: string;
+        updatedAt: Date;
+        orgId: string;
+        startedAt: Date | null;
+        createdAt: Date;
+        triggerDetail: string | null;
+        agentId: string;
+        finishedAt: Date | null;
+        invocationSource: string;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        resultJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+    }>;
+    reportRunActivity: (runId: string) => Promise<{
+        id: string;
+        orgId: string;
+        agentId: string;
+        invocationSource: string;
+        triggerDetail: string | null;
+        status: string;
+        startedAt: Date | null;
+        finishedAt: Date | null;
+        error: string | null;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        resultJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    reapOrphanedRuns: (opts?: {
+        staleThresholdMs?: number;
+    }) => Promise<{
+        reaped: number;
+        runIds: string[];
+    }>;
+    resumeQueuedRuns: () => Promise<void>;
+    tickTimers: (now?: Date) => Promise<{
+        checked: number;
+        enqueued: number;
+        skipped: number;
+    }>;
+    cancelRun: (runId: string) => Promise<{
+        error: string | null;
+        id: string;
+        status: string;
+        updatedAt: Date;
+        orgId: string;
+        startedAt: Date | null;
+        createdAt: Date;
+        triggerDetail: string | null;
+        agentId: string;
+        finishedAt: Date | null;
+        invocationSource: string;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        resultJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+    }>;
+    cancelActiveForAgent: (agentId: string) => Promise<number>;
+    cancelBudgetScopeWork: (scope: BudgetEnforcementScope) => Promise<void>;
+    getActiveRunForAgent: (agentId: string) => Promise<{
+        error: string | null;
+        id: string;
+        status: string;
+        updatedAt: Date;
+        orgId: string;
+        startedAt: Date | null;
+        createdAt: Date;
+        triggerDetail: string | null;
+        agentId: string;
+        finishedAt: Date | null;
+        invocationSource: string;
+        wakeupRequestId: string | null;
+        exitCode: number | null;
+        signal: string | null;
+        usageJson: Record<string, unknown> | null;
+        resultJson: Record<string, unknown> | null;
+        sessionIdBefore: string | null;
+        sessionIdAfter: string | null;
+        logStore: string | null;
+        logRef: string | null;
+        logBytes: number | null;
+        logSha256: string | null;
+        logCompressed: boolean;
+        stdoutExcerpt: string | null;
+        stderrExcerpt: string | null;
+        errorCode: string | null;
+        externalRunId: string | null;
+        processPid: number | null;
+        processStartedAt: Date | null;
+        retryOfRunId: string | null;
+        processLossRetryCount: number;
+        contextSnapshot: Record<string, unknown> | null;
+    }>;
+};
+//# sourceMappingURL=heartbeat.d.ts.map