@jaggerxtrm/specialists 3.9.0 → 3.10.0

package/dist/types/specialist/observability-sqlite.d.ts

@@ -0,0 +1,218 @@
+type BunDb = any;
+import type { TimelineEvent, TimelineEventTool } from './timeline-events.js';
+import type { SupervisorStatus } from './supervisor.js';
+import type { EpicChainRecord, EpicRunRecord } from './epic-lifecycle.js';
+import type { PersistedChainIdentity } from './chain-identity.js';
+export declare function parseJournalMode(mode: string | null | undefined): string | null;
+export declare function enforceWalMode(db: BunDb): void;
+export declare function verifyWalMode(db: BunDb): void;
+export declare function initSchema(db: BunDb): void;
+export type NodeRunStatus = 'created' | 'starting' | 'running' | 'waiting' | 'degraded' | 'awaiting_merge' | 'fixing_after_review' | 'failed' | 'error' | 'done' | 'stopped';
+export type NodeEventType = 'node_created' | 'node_started' | 'node_state_changed' | 'member_started' | 'member_state_changed' | 'member_output_received' | 'member_failed' | 'member_recovered' | 'member_respawned' | 'member_job_rebound' | 'member_disabled' | 'coordinator_resumed' | 'coordinator_resume_state' | 'coordinator_resume_skipped' | 'coordinator_first_turn_context_built' | 'coordinator_output_received' | 'coordinator_output_invalid' | 'coordinator_repair_requested' | 'memory_updated' | 'memory_patch_rejected' | 'memory_patch_deduplicated' | 'action_queued' | 'action_written' | 'action_observed' | 'action_superseded' | 'action_completed' | 'action_failed' | 'action_dropped' | 'node_recovered' | 'node_waiting' | 'node_done' | 'node_error' | 'node_stopped' | 'phase_started' | 'phase_completed' | 'bead_created' | 'worktree_provisioned' | 'member_spawned_dynamic' | 'member_replaced' | 'coordinator_restarted' | 'pr_created' | 'pr_updated' | 'node_completed';
+export interface NodeRunRow {
+    id: string;
+    node_name: string;
+    status: NodeRunStatus;
+    coordinator_job_id?: string;
+    started_at_ms?: number;
+    updated_at_ms: number;
+    waiting_on?: string;
+    error?: string;
+    memory_namespace?: string;
+    status_json: string;
+    pr_number?: number;
+    pr_url?: string;
+    pr_head_sha?: string;
+    gate_results?: string;
+    completion_strategy?: string;
+}
+export interface NodeMemberRow {
+    node_run_id: string;
+    member_id: string;
+    job_id?: string;
+    specialist: string;
+    model?: string;
+    role?: string;
+    status: string;
+    enabled?: boolean;
+    generation?: number;
+    worktree_path?: string;
+    parent_member_id?: string;
+    replaced_member_id?: string;
+    phase_id?: string;
+}
+export interface NodeMemoryRow {
+    node_run_id: string;
+    namespace?: string;
+    entry_type?: 'fact' | 'question' | 'decision';
+    entry_id?: string;
+    summary?: string;
+    source_member_id?: string;
+    confidence?: number;
+    provenance_json?: string;
+    created_at_ms?: number;
+    updated_at_ms?: number;
+}
+export interface ChainEpicLinkRecord {
+    chain_id: string;
+    epic_id?: string;
+    chain_root_job_id?: string;
+    chain_root_bead_id?: string;
+}
+export interface MemoryCacheState {
+    lastSyncAtMs: number;
+    memoryCount: number;
+}
+export interface MemoryCacheInputRecord {
+    key: string;
+    value: string;
+}
+export interface RelevantMemoryRecord {
+    key: string;
+    value: string;
+    bm25: number;
+    recency: number;
+    accessFrequency: number;
+    score: number;
+}
+export interface EpicChainLatestJobRecord {
+    chain_id: string;
+    epic_id: string;
+    chain_root_bead_id?: string;
+    chain_root_job_id?: string;
+    job_id: string;
+    status?: string;
+    branch?: string;
+    updated_at_ms: number;
+}
+export interface PruneObservabilityOptions {
+    beforeMs: number;
+    includeEpics: boolean;
+    apply: boolean;
+    nowMs?: number;
+    eventsRetentionMs?: number;
+    skipExtract?: boolean;
+}
+export interface JobMetricsRecord {
+    job_id: string;
+    specialist: string;
+    model: string | null;
+    status: string;
+    chain_kind: string | null;
+    chain_id: string | null;
+    bead_id: string | null;
+    node_id: string | null;
+    epic_id: string | null;
+    started_at_ms: number | null;
+    completed_at_ms: number | null;
+    elapsed_ms: number | null;
+    total_turns: number;
+    total_tools: number;
+    tool_call_counts_json: string;
+    token_trajectory_json: string;
+    context_trajectory_json: string;
+    stall_gaps_json: string;
+    run_complete_json: string | null;
+    updated_at_ms: number;
+}
+export interface PruneObservabilityReport {
+    dryRun: boolean;
+    beforeMs: number;
+    eventsCutoffMs: number;
+    includeEpics: boolean;
+    deletedEvents: number;
+    deletedResults: number;
+    deletedJobs: number;
+    deletedEpicRuns: number;
+    skippedActiveChainJobs: number;
+    extractedJobs: number;
+}
+export interface OrphanScanFinding {
+    kind: 'orphan' | 'stale-pointer' | 'integrity-violation';
+    code: 'chain_membership_without_jobs' | 'epic_without_chains' | 'job_epic_without_membership' | 'worktree_missing_on_disk';
+    message: string;
+    details: Record<string, string | number | boolean | null>;
+}
+export interface ObservabilitySqliteClient {
+    upsertStatus(status: SupervisorStatus): void;
+    upsertEpicRun(epic: EpicRunRecord): void;
+    upsertEpicChainMembership(chain: EpicChainRecord): void;
+    upsertStatusWithEvent(status: SupervisorStatus, event: TimelineEvent): void;
+    upsertStatusWithEventAndResult(status: SupervisorStatus, event: TimelineEvent, output: string): void;
+    appendEvent(jobId: string, specialist: string, beadId: string | undefined, event: TimelineEvent): void;
+    upsertResult(jobId: string, output: string): void;
+    bootstrapNode(nodeRunId: string, nodeName: string, memoryNamespace?: string): void;
+    upsertNodeRun(nodeRun: NodeRunRow): void;
+    upsertNodeMember(member: NodeMemberRow): void;
+    appendNodeEvent(nodeRunId: string, t: number, type: NodeEventType, eventJson: unknown): void;
+    upsertNodeMemory(entry: NodeMemoryRow): void;
+    upsertNodeRunWithEvent(nodeRun: NodeRunRow, t: number, type: NodeEventType, eventJson: unknown): void;
+    upsertNodeMemberWithEvent(member: NodeMemberRow, nodeRunId: string, t: number, type: NodeEventType, eventJson: unknown): void;
+    upsertNodeMemoryWithEvent(entry: NodeMemoryRow, nodeRunId: string, t: number, type: NodeEventType, eventJson: unknown): void;
+    readNodeRun(nodeRunId: string): NodeRunRow | null;
+    listNodeRuns(filter?: {
+        status?: NodeRunStatus;
+    }): NodeRunRow[];
+    listNodeRunsByRef(partialRef: string, statuses: readonly NodeRunStatus[]): NodeRunRow[];
+    listNodeRunsByStatuses(statuses: readonly NodeRunStatus[]): NodeRunRow[];
+    readNodeMembers(nodeRunId: string): NodeMemberRow[];
+    readNodeEvents(nodeRunId: string, opts?: {
+        type?: NodeEventType;
+        limit?: number;
+    }): Array<{
+        id: number;
+        seq: number;
+        t: number;
+        type: string;
+        event_json: string;
+    }>;
+    readNodeMemory(nodeRunId: string, opts?: {
+        namespace?: string;
+        entry_type?: 'fact' | 'question' | 'decision';
+    }): NodeMemoryRow[];
+    queryMemberContextHealth(jobId: string): number | null;
+    readStatus(jobId: string): SupervisorStatus | null;
+    listStatuses(): SupervisorStatus[];
+    readEpicRun(epicId: string): EpicRunRecord | null;
+    listEpicRuns(): EpicRunRecord[];
+    resolveEpicByChainId(chainId: string): EpicChainRecord | null;
+    resolveEpicByChainRootBeadId(chainRootBeadId: string): EpicChainRecord | null;
+    listEpicChains(epicId: string): EpicChainRecord[];
+    deleteEpicChainMembership(epicId: string, chainIds: readonly string[]): string[];
+    listEpicChainsWithLatestJob(epicId: string): EpicChainLatestJobRecord[];
+    readChainIdentity(jobId: string): PersistedChainIdentity | null;
+    listChainJobIds(chainId: string): string[];
+    resolveChainEpicLinkByJobId(jobId: string): ChainEpicLinkRecord | null;
+    readEvents(jobId: string): TimelineEvent[];
+    readEventsAfterSeq(jobId: string, afterSeq: number): TimelineEvent[];
+    readLatestToolEvent(jobId: string): TimelineEventTool | null;
+    aggregateJobMetrics(jobId: string): JobMetricsRecord | null;
+    listJobMetrics(filters?: {
+        spec?: string;
+        model?: string;
+        sinceMs?: number;
+    }): JobMetricsRecord[];
+    readResult(jobId: string): string | null;
+    syncMemoriesCache(memories: readonly MemoryCacheInputRecord[], syncedAtMs?: number): void;
+    getMemoriesCacheState(): MemoryCacheState | null;
+    queryRelevantMemories(keywords: readonly string[], limit?: number, nowMs?: number): RelevantMemoryRecord[];
+    invalidateMemoriesCache(): void;
+    hasActiveJobs(statuses?: readonly string[]): boolean;
+    listActiveJobs(statuses?: readonly string[]): Array<{
+        job_id: string;
+        specialist: string;
+        status: string;
+    }>;
+    getDatabaseSizeBytes(): number;
+    vacuumDatabase(): {
+        beforeBytes: number;
+        afterBytes: number;
+    };
+    pruneObservabilityData(options: PruneObservabilityOptions): PruneObservabilityReport;
+    scanOrphans(): OrphanScanFinding[];
+    close(): void;
+}
+export declare function hasRunCompleteEvent(jobId: string, cwd?: string): boolean;
+export declare function createObservabilitySqliteClient(cwd?: string): ObservabilitySqliteClient | null;
+export {};
+//# sourceMappingURL=observability-sqlite.d.ts.map

package/dist/types/specialist/observability-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-sqlite.d.ts","sourceRoot":"","sources":["../../../src/specialist/observability-sqlite.ts"],"names":[],"mappings":"AAKA,KAAK,KAAK,GAAG,GAAG,CAAC;AAiBjB,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAwDlE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG/E;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,CAM9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,CAM7C;AA+ND,wBAAgB,UAAU,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,CA4I1C;AA6QD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,gBAAgB,GAAG,qBAAqB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7K,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,cAAc,GACd,oBAAoB,GACpB,gBAAgB,GAChB,sBAAsB,GACtB,wBAAwB,GACxB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GACjB,qBAAqB,GACrB,0BAA0B,GAC1B,4BAA4B,GAC5B,sCAAsC,GACtC,6BAA6B,GAC7B,4BAA4B,GAC5B,8BAA8B,GAC9B,gBAAgB,GAChB,uBAAuB,GACvB,2BAA2B,GAE3B,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,YAAY,GACZ,cAAc,GACd,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,sBAAsB,GACtB,wBAAwB,GACxB,iBAAiB,GACjB,uBAAuB,GACvB,YAAY,GACZ,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,qBAAqB,CAAC;IACzD,IAAI,EAAE,+BAA+B,GAAG,qBAAqB,GAAG,6BAA6B,GAAG,0BAA0B,CAAC;IAC3H,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7C,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACzC,yBAAyB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IACxD,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5E,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACrG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACvG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnF,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACzC,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7F,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACtG,yBAAyB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9H,yBAAyB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7H,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAClD,YAAY,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG,UAAU,EAAE,CAAC;IAChE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,UAAU,EAAE,CAAC;IACxF,sBAAsB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,UAAU,EAAE,CAAC;IACzE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IACpD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,aAAa,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpK,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAA;KAAE,GAAG,aAAa,EAAE,CAAC;IACjI,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACnD,YAAY,IAAI,gBAAgB,EAAE,CAAC;IACnC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IAClD,YAAY,IAAI,aAAa,EAAE,CAAC;IAChC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;IAC9D,4BAA4B,CAAC,eAAe,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;IAC9E,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IAClD,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACjF,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,EAAE,CAAC;IACxE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAAC;IAChE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3C,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAAC;IACvE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAC3C,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IACrE,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAC7D,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC5D,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB,EAAE,CAAC;IAClG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,iBAAiB,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1F,qBAAqB,IAAI,gBAAgB,GAAG,IAAI,CAAC;IACjD,qBAAqB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;IAC3G,uBAAuB,IAAI,IAAI,CAAC;IAChC,aAAa,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IACrD,cAAc,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5G,oBAAoB,IAAI,MAAM,CAAC;IAC/B,cAAc,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,sBAAsB,CAAC,OAAO,EAAE,yBAAyB,GAAG,wBAAwB,CAAC;IACrF,WAAW,IAAI,iBAAiB,EAAE,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AA04CD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CA8BvF;AAED,wBAAgB,+BAA+B,CAAC,GAAG,GAAE,MAAsB,GAAG,yBAAyB,GAAG,IAAI,CAkB7G"}

package/dist/types/specialist/pipeline.d.ts

@@ -0,0 +1,23 @@
+import type { SpecialistRunner } from './runner.js';
+export interface PipelineStep {
+    name: string;
+    prompt: string;
+    variables?: Record<string, string>;
+    backend_override?: string;
+}
+export interface PipelineResult {
+    steps: Array<{
+        specialist: string;
+        status: 'fulfilled' | 'rejected';
+        output: string | null;
+        durationMs: number | null;
+        error: string | null;
+    }>;
+    final_output: string | null;
+}
+/**
+ * Run specialists sequentially, passing each output as $previous_result
+ * to the next step.
+ */
+export declare function runPipeline(steps: PipelineStep[], runner: SpecialistRunner, onProgress?: (msg: string) => void): Promise<PipelineResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/types/specialist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/specialist/pipeline.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;QACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EAAE,EACrB,MAAM,EAAE,gBAAgB,EACxB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,cAAc,CAAC,CAuCzB"}

package/dist/types/specialist/process-liveness.d.ts

@@ -0,0 +1,2 @@
+export declare function isProcessAlive(pid: number, startTimeMs?: number): boolean;
+//# sourceMappingURL=process-liveness.d.ts.map

package/dist/types/specialist/process-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-liveness.d.ts","sourceRoot":"","sources":["../../../src/specialist/process-liveness.ts"],"names":[],"mappings":"AA2DA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CASzE"}

package/dist/types/specialist/runner.d.ts

@@ -0,0 +1,98 @@
+import { PiAgentSession, type PiSessionOptions, type SessionMetricEvent, type SessionRunMetrics } from '../pi/session.js';
+import type { SpecialistLoader } from './loader.js';
+import type { HookEmitter } from './hooks.js';
+import { type CircuitBreaker } from '../utils/circuitBreaker.js';
+export interface RunOptions {
+    name: string;
+    prompt: string;
+    variables?: Record<string, string>;
+    backendOverride?: string;
+    autonomyLevel?: string;
+    /** Working directory for local scripts and the pi session. */
+    workingDirectory?: string;
+    /** Absolute write-boundary for write-side tools inside pi session. */
+    worktreeBoundary?: string;
+    /** Existing bead whose content should be used as the task prompt. */
+    inputBeadId?: string;
+    /** Owning epic id for wave-bound chains, when bead belongs to an epic. */
+    epicId?: string;
+    /** Lineage: set when --job <id> is used to reuse another job's worktree. */
+    reusedFromJobId?: string;
+    /** Bead dependency context depth (0 disables completed blocker injection). */
+    contextDepth?: number;
+    /** Lineage: root job id that originally created the reused worktree. */
+    worktreeOwnerJobId?: string;
+    /** Path to an existing pi session file for continuation (Phase 2+) */
+    sessionPath?: string;
+    /**
+     * Keep the Pi session alive after agent_end.
+     * Enables multi-turn: callers receive resumeFn/closeFn via onResumeReady callback.
+     */
+    keepAlive?: boolean;
+    /** Explicitly disable keepAlive even when specialist.execution.interactive=true. */
+    noKeepAlive?: boolean;
+    /** Additional retries after the initial attempt (default: 0). */
+    maxRetries?: number;
+    /** Whether external (input) bead notes should be written by Supervisor. */
+    beadsWriteNotes?: boolean;
+}
+export interface RunResult {
+    output: string;
+    backend: string;
+    model: string;
+    durationMs: number;
+    specialistVersion: string;
+    promptHash: string;
+    beadId?: string;
+    metrics?: SessionRunMetrics;
+    permissionRequired?: 'READ_ONLY' | 'LOW' | 'MEDIUM' | 'HIGH';
+    autoCommit?: 'never' | 'checkpoint_on_waiting' | 'checkpoint_on_terminal';
+    outputType?: string;
+}
+type SessionLike = Pick<PiAgentSession, 'start' | 'prompt' | 'waitForDone' | 'getLastOutput' | 'getState' | 'close' | 'kill' | 'meta' | 'steer' | 'resume'> & {
+    getMetrics?: () => SessionRunMetrics;
+};
+export type SessionFactory = (opts: PiSessionOptions) => Promise<SessionLike>;
+import { type BeadsClient as BeadsClientType } from './beads.js';
+interface RunnerDeps {
+    loader: SpecialistLoader;
+    hooks: HookEmitter;
+    circuitBreaker: CircuitBreaker;
+    /** Overridable for testing; defaults to PiAgentSession.create */
+    sessionFactory?: SessionFactory;
+    /** Optional beads client for specialist run tracking */
+    beadsClient?: BeadsClientType;
+}
+export declare class SpecialistRunner {
+    private deps;
+    private sessionFactory;
+    constructor(deps: RunnerDeps);
+    private resolvePromptWithBeadContext;
+    run(options: RunOptions, onProgress?: (msg: string) => void, onEvent?: (type: string, details?: {
+        charCount?: number;
+        toolCallId?: string;
+        model?: string;
+        previousModel?: string;
+        action?: 'set_model' | 'cycle_model';
+        extension?: string;
+        errorMessage?: string;
+        tokensBefore?: number;
+        summary?: string;
+        source?: string;
+        data?: Record<string, unknown>;
+        firstKeptEntryId?: string;
+        attempt?: number;
+        maxAttempts?: number;
+        delayMs?: number;
+    }) => void, onMetric?: (event: SessionMetricEvent) => void, onMeta?: (meta: {
+        backend: string;
+        model: string;
+    }) => void, onKillRegistered?: (killFn: () => void) => void, onBeadCreated?: (beadId: string) => void, onSteerRegistered?: (steerFn: (msg: string) => Promise<void>) => void, onResumeReady?: (resumeFn: (msg: string) => Promise<string>, closeFn: () => Promise<void>) => void, onToolStartCallback?: (tool: string, args?: Record<string, unknown>, toolCallId?: string) => void, onToolEndCallback?: (tool: string, isError: boolean, toolCallId?: string, resultContent?: string, resultRaw?: Record<string, unknown>) => void): Promise<RunResult>;
+    /**
+     * @deprecated Legacy in-memory async path.
+     * Now uses Supervisor-backed jobs under .specialists/jobs.
+     */
+    startAsync(options: RunOptions, registry: import('./jobRegistry.js').JobRegistry): Promise<string>;
+}
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/types/specialist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/specialist/runner.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,EAEd,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIhG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oFAAoF;IACpF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,kBAAkB,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7D,UAAU,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,GACvJ;IAAE,UAAU,CAAC,EAAE,MAAM,iBAAiB,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE9E,OAAO,EAAe,KAAK,WAAW,IAAI,eAAe,EAAsC,MAAM,YAAY,CAAC;AAYlH,UAAU,UAAU;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,iEAAiE;IACjE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,wDAAwD;IACxD,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAqsBD,qBAAa,gBAAgB;IAGf,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,cAAc,CAAiB;gBAEnB,IAAI,EAAE,UAAU;IAIpC,OAAO,CAAC,4BAA4B;IAoB9B,GAAG,CACP,OAAO,EAAE,UAAU,EACnB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAClC,OAAO,CAAC,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;QACrC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,KACE,IAAI,EACT,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,EAC9C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EAC3D,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,IAAI,EAC/C,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EACxC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EACrE,aAAa,CAAC,EAAE,CACd,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC1C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACzB,IAAI,EACT,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,EACjG,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAC7I,OAAO,CAAC,SAAS,CAAC;IA2erB;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,kBAAkB,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CA4BzG"}