@jaggerxtrm/specialists 3.9.0 → 3.10.0

package/dist/types/specialist/epic-reconciler.d.ts

@@ -0,0 +1,35 @@
+import { type EpicState } from './epic-lifecycle.js';
+import { type EpicReadinessSummary } from './epic-readiness.js';
+import type { ObservabilitySqliteClient } from './observability-sqlite.js';
+interface DriftReport {
+    stale_chain_refs: string[];
+    dead_jobs_blocking_readiness: string[];
+    integrity_flags: string[];
+    stale_redirect_markers: string[];
+}
+export interface EpicSyncResult {
+    epic_id: string;
+    apply: boolean;
+    drift: DriftReport;
+    repairs: {
+        dead_jobs_marked_error: string[];
+        stale_chain_refs_pruned: string[];
+        readiness_resynced: boolean;
+        redirect_markers_cleared: boolean;
+    };
+    readiness_before: EpicReadinessSummary;
+    readiness_after: EpicReadinessSummary;
+}
+export interface EpicAbandonResult {
+    epic_id: string;
+    from_state: EpicState;
+    to_state: 'abandoned';
+    forced: boolean;
+    reason: string;
+    live_member_job_ids: string[];
+}
+export declare function withEpicAdvisoryLock<T>(epicId: string, action: () => T): T;
+export declare function syncEpicState(sqlite: ObservabilitySqliteClient, epicId: string, apply: boolean): EpicSyncResult;
+export declare function abandonEpic(sqlite: ObservabilitySqliteClient, epicId: string, reason: string, force: boolean): EpicAbandonResult;
+export {};
+//# sourceMappingURL=epic-reconciler.d.ts.map

package/dist/types/specialist/epic-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-reconciler.d.ts","sourceRoot":"","sources":["../../../src/specialist/epic-reconciler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAwD,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEtH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAK3E,UAAU,WAAW;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE;QACP,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,uBAAuB,EAAE,MAAM,EAAE,CAAC;QAClC,kBAAkB,EAAE,OAAO,CAAC;QAC5B,wBAAwB,EAAE,OAAO,CAAC;KACnC,CAAC;IACF,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,eAAe,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AASD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CA4B1E;AAkFD,wBAAgB,aAAa,CAAC,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAyD/G;AAgCD,wBAAgB,WAAW,CAAC,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAiChI"}

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

@@ -0,0 +1,44 @@
+type HookType = 'pre_render' | 'post_render' | 'pre_execute' | 'post_execute';
+type CBState = 'CLOSED' | 'HALF_OPEN' | 'OPEN';
+interface HookPayloads {
+    pre_render: {
+        variables_keys: string[];
+        backend_resolved: string;
+        fallback_used: boolean;
+        circuit_breaker_state: CBState;
+        scope: string;
+    };
+    post_render: {
+        prompt_hash: string;
+        prompt_length_chars: number;
+        estimated_tokens: number;
+        system_prompt_present: boolean;
+    };
+    pre_execute: {
+        backend: string;
+        model: string;
+        timeout_ms: number;
+        permission_level: string;
+    };
+    post_execute: {
+        status: 'COMPLETE' | 'IN_PROGRESS' | 'BLOCKED' | 'ERROR' | 'CANCELLED';
+        duration_ms: number;
+        output_valid: boolean;
+        error?: {
+            type: string;
+            message: string;
+        };
+    };
+}
+export declare class HookEmitter {
+    private tracePath;
+    private customHandlers;
+    private ready;
+    constructor(options: {
+        tracePath: string;
+    });
+    emit<T extends HookType>(hook: T, invocationId: string, specialistName: string, specialistVersion: string, payload: HookPayloads[T]): Promise<void>;
+    onHook(hook: HookType, handler: (event: unknown) => void): void;
+}
+export {};
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/specialist/hooks.ts"],"names":[],"mappings":"AAIA,KAAK,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;AAC9E,KAAK,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAE/C,UAAU,YAAY;IACpB,UAAU,EAAE;QACV,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;QACvB,qBAAqB,EAAE,OAAO,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,OAAO,CAAC;KAChC,CAAC;IACF,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;QACvE,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC;QACtB,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,CAAC;CACH;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAwD;IAC9E,OAAO,CAAC,KAAK,CAAgB;gBAEjB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE;IAKpC,IAAI,CAAC,CAAC,SAAS,QAAQ,EAC3B,IAAI,EAAE,CAAC,EACP,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,IAAI,CAAC;IAgBhB,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;CAIhE"}

package/dist/types/specialist/job-control.d.ts

@@ -0,0 +1,29 @@
+import type { RunOptions, SpecialistRunner } from './runner.js';
+import { type SupervisorStatus } from './supervisor.js';
+export interface JobControlOptions {
+    runner: SpecialistRunner;
+    runOptions: RunOptions;
+    jobsDir?: string;
+}
+export declare class JobControl {
+    private supervisor;
+    private jobId;
+    private readonly runner;
+    private readonly baseRunOptions;
+    private readonly jobsDir;
+    private readonly sqliteClient;
+    constructor(opts: JobControlOptions);
+    startJob(opts: {
+        nodeId: string;
+        memberId: string;
+    }): Promise<string>;
+    resumeJob(jobId: string, prompt: string): Promise<void>;
+    steerJob(jobId: string, message: string): Promise<void>;
+    stopJob(jobId: string): Promise<void>;
+    readStatus(jobId: string): SupervisorStatus | null;
+    readResult(jobId: string): string | null;
+    waitForTerminal(jobId: string, timeoutMs?: number): Promise<SupervisorStatus>;
+    private writeFifoMessage;
+    private resultPath;
+}
+//# sourceMappingURL=job-control.d.ts.map

package/dist/types/specialist/job-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-control.d.ts","sourceRoot":"","sources":["../../../src/specialist/job-control.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMpE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAa;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;gBAEpD,IAAI,EAAE,iBAAiB;IAY7B,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCrE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIlD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBlC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBnF,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/types/specialist/job-file-output.d.ts

@@ -0,0 +1,4 @@
+export type JobFileOutputMode = 'on' | 'off';
+export declare function detectJobFileOutputMode(env?: NodeJS.ProcessEnv): JobFileOutputMode;
+export declare function isJobFileOutputEnabled(env?: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=job-file-output.d.ts.map

package/dist/types/specialist/job-file-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-file-output.d.ts","sourceRoot":"","sources":["../../../src/specialist/job-file-output.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,KAAK,CAAC;AAM7C,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAK/F;AAED,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEpF"}

package/dist/types/specialist/job-root.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Returns the git common root — the directory that contains the shared `.git/` dir.
+ * In a regular checkout this is the repo root. In a worktree it is still the main
+ * repo root, not the worktree directory, so all worktrees converge on the same root.
+ *
+ * `git rev-parse --git-common-dir` emits the path to the shared object store
+ * (e.g. `/repo/.git` from a worktree vs. `.git` from the main checkout). Taking
+ * `dirname` of its resolved form gives us the common project root in both cases.
+ */
+export declare function resolveCommonGitRoot(cwd: string): string | undefined;
+/**
+ * Returns the absolute path to `.specialists/jobs/` rooted at the git common root.
+ * Falls back to `cwd/.specialists/jobs/` when git is unavailable (e.g. non-git dirs).
+ */
+export declare function resolveJobsDir(cwd?: string): string;
+/**
+ * Returns the current branch name from `cwd`, or `undefined` when git is unavailable
+ * or HEAD is detached.
+ */
+export declare function resolveCurrentBranch(cwd?: string): string | undefined;
+//# sourceMappingURL=job-root.d.ts.map

package/dist/types/specialist/job-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-root.d.ts","sourceRoot":"","sources":["../../../src/specialist/job-root.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAgB,GAAG,MAAM,CAG1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,SAAgB,GAAG,MAAM,GAAG,SAAS,CAU5E"}

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

@@ -0,0 +1,69 @@
+import type { RunResult } from './runner.js';
+export interface JobSnapshot {
+    job_id: string;
+    status: 'running' | 'done' | 'error' | 'cancelled' | 'waiting';
+    /** Full output — populated only when status === 'done'. Empty string while running or on error/cancel. */
+    output: string;
+    /** New content since the provided cursor (for incremental mid-run polling). */
+    delta: string;
+    /** Pass as cursor on next poll to receive only new content. */
+    next_cursor: number;
+    /** Last pi event type seen: starting | thinking | toolcall | tool_execution | text | done | error | cancelled */
+    current_event: string;
+    backend: string;
+    model: string;
+    specialist_version: string;
+    duration_ms: number;
+    error?: string;
+    /** Beads issue ID linked to this job, if beads tracking is enabled. */
+    beadId?: string;
+}
+export declare class JobRegistry {
+    private jobs;
+    register(id: string, meta: {
+        backend: string;
+        model: string;
+        specialistVersion?: string;
+    }): void;
+    appendOutput(id: string, text: string): void;
+    setCurrentEvent(id: string, eventType: string): void;
+    /** Update backend/model from the first assistant message_start event. */
+    setMeta(id: string, meta: {
+        backend: string;
+        model: string;
+    }): void;
+    /** Store the beads issue ID for this job. */
+    setBeadId(id: string, beadId: string): void;
+    /** Register the kill function for this job. If job was already cancelled, invokes immediately. */
+    setKillFn(id: string, killFn: () => void): void;
+    /** Register the steer function for this job. */
+    setSteerFn(id: string, steerFn: (msg: string) => Promise<void>): void;
+    /** Register resume/close functions for a keep-alive job. Sets status to 'waiting'. */
+    setResumeFn(id: string, resumeFn: (msg: string) => Promise<string>, closeFn: () => Promise<void>): void;
+    /** Send a follow-up prompt to a waiting keep-alive job. */
+    followUp(id: string, message: string): Promise<{
+        ok: boolean;
+        output?: string;
+        error?: string;
+    }>;
+    /** Close a keep-alive session and mark the job done. */
+    closeSession(id: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** Send a mid-run steering message to the Pi agent for this job. */
+    steer(id: string, message: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    complete(id: string, result: RunResult): void;
+    fail(id: string, err: Error): void;
+    /** Kill the pi process and mark the job as cancelled. */
+    cancel(id: string): {
+        status: 'cancelled';
+        duration_ms: number;
+    } | undefined;
+    snapshot(id: string, cursor?: number): JobSnapshot | undefined;
+    delete(id: string): void;
+}
+//# sourceMappingURL=jobRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobRegistry.d.ts","sourceRoot":"","sources":["../../../src/specialist/jobRegistry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC/D,0GAA0G;IAC1G,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,iHAAiH;IACjH,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoBD,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAA+B;IAE3C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAahG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5C,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpD,yEAAyE;IACzE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAOnE,6CAA6C;IAC7C,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3C,kGAAkG;IAClG,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAU/C,gDAAgD;IAChD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMrE,sFAAsF;IACtF,WAAW,CACT,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC1C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC3B,IAAI;IASP,2DAA2D;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBtG,wDAAwD;IAClD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAexE,oEAAoE;IAC9D,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAalF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI;IAa7C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI;IASlC,yDAAyD;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAU5E,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,WAAW,GAAG,SAAS;IAoBzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGzB"}

package/dist/types/specialist/json-output.d.ts

@@ -0,0 +1,2 @@
+export declare function stripJsonFences(text: string): string;
+//# sourceMappingURL=json-output.d.ts.map

package/dist/types/specialist/json-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../../src/specialist/json-output.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}

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

@@ -0,0 +1,48 @@
+import { type ScriptEntry, type Specialist } from './schema.js';
+export interface StallDetectionConfig {
+    running_silence_warn_ms?: number;
+    running_silence_error_ms?: number;
+    waiting_stale_ms?: number;
+    tool_duration_warn_ms?: number;
+}
+export interface SpecialistSummary {
+    name: string;
+    description: string;
+    category: string;
+    version: string;
+    model: string;
+    permission_required: 'READ_ONLY' | 'LOW' | 'MEDIUM' | 'HIGH';
+    interactive: boolean;
+    thinking_level?: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    skills: string[];
+    scripts: ScriptEntry[];
+    scope: 'user' | 'default' | 'package';
+    /**
+     * Scope says where override came from.
+     * user = repo authoring layer, default = repo-managed mirror, package = upstream fallback.
+     */
+    source: 'user' | 'default-mirror' | 'package-fallback' | 'legacy';
+    filePath: string;
+    updated?: string;
+    filestoWatch?: string[];
+    staleThresholdDays?: number;
+    stallDetection?: StallDetectionConfig;
+}
+/** Returns STALE, AGED, or OK based on file mtimes vs metadata.updated */
+export declare function checkStaleness(summary: SpecialistSummary): Promise<'OK' | 'STALE' | 'AGED'>;
+interface LoaderOptions {
+    projectDir?: string;
+}
+export declare class SpecialistLoader {
+    private cache;
+    private projectDir;
+    constructor(options?: LoaderOptions);
+    private getScanDirs;
+    private toJson;
+    private resolveSpecialistPath;
+    list(category?: string): Promise<SpecialistSummary[]>;
+    get(name: string): Promise<Specialist>;
+    invalidateCache(name?: string): void;
+}
+export {};
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/specialist/loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACzE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,0EAA0E;AAC1E,wBAAsB,cAAc,CAClC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC,CAiBlC;AAED,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE,aAAkB;IAIvC,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,qBAAqB;IAcvB,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAmDrD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgC5C,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;CAIrC"}

package/dist/types/specialist/mandatory-rules.d.ts

@@ -0,0 +1,41 @@
+export interface MandatoryRule {
+    id: string;
+    level: string;
+    text: string;
+    when?: string;
+}
+export interface MandatoryRuleSet {
+    id: string;
+    rules: MandatoryRule[];
+}
+export interface SpecialistMandatoryRulesConfig {
+    template_sets?: string[];
+    disable_default_globals?: boolean;
+    inline_rules?: MandatoryRule[];
+}
+interface MandatoryRulesIndex {
+    required_template_sets?: string[];
+    default_template_sets?: string[];
+}
+export interface MandatoryRulesInjection {
+    block: string;
+    setsLoaded: string[];
+    ruleCount: number;
+    inlineRulesCount: number;
+    globalsDisabled: boolean;
+}
+export declare function loadMandatoryRulesIndex(cwd: string): MandatoryRulesIndex | null;
+export declare function buildMandatoryRulesInjection(specialistConfig: {
+    cwd?: string;
+    specialist?: {
+        mandatory_rules?: SpecialistMandatoryRulesConfig;
+    };
+}): MandatoryRulesInjection;
+export declare function buildMandatoryRulesBlock(specialistConfig: {
+    cwd?: string;
+    specialist?: {
+        mandatory_rules?: SpecialistMandatoryRulesConfig;
+    };
+}): string;
+export {};
+//# sourceMappingURL=mandatory-rules.d.ts.map

package/dist/types/specialist/mandatory-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mandatory-rules.d.ts","sourceRoot":"","sources":["../../../src/specialist/mandatory-rules.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,UAAU,mBAAmB;IAC3B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAgB/E;AA8JD,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GACpG,uBAAuB,CA4BzB;AAED,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAEtJ"}

package/dist/types/specialist/memory-retrieval.d.ts

@@ -0,0 +1,34 @@
+import { type MemoryCacheInputRecord } from './observability-sqlite.js';
+export declare const STATIC_WORKFLOW_RULES_BLOCK: string;
+export interface MemoryRecord {
+    key: string;
+    value: string;
+}
+export interface MemoryInjectionResult {
+    block: string;
+    memories: MemoryRecord[];
+    estimatedTokens: number;
+}
+export declare function extractMemoryKeywords(title: string, description?: string): string[];
+export declare function parseMemoriesPayload(jsonText: string): MemoryCacheInputRecord[];
+export declare function shouldRefreshCache(args: {
+    nowMs: number;
+    cacheCount: number | null;
+    cacheLastSyncAtMs: number | null;
+    sourceCount: number;
+}): boolean;
+export declare function syncMemoriesCacheFromBd(cwd: string, nowMs?: number, forceFullSync?: boolean): {
+    synced: boolean;
+    memoryCount: number;
+};
+export declare function invalidateAndRefreshMemoriesCache(cwd: string, nowMs?: number): {
+    synced: boolean;
+    memoryCount: number;
+};
+export declare function buildFilteredMemoryInjection(args: {
+    cwd: string;
+    beadTitle: string;
+    beadDescription?: string;
+}): MemoryInjectionResult;
+export declare function estimateInjectedTokens(text: string): number;
+//# sourceMappingURL=memory-retrieval.d.ts.map

package/dist/types/specialist/memory-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retrieval.d.ts","sourceRoot":"","sources":["../../../src/specialist/memory-retrieval.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,2BAA2B,CAAC;AAanC,eAAO,MAAM,2BAA2B,QAWhC,CAAC;AAET,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAiBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBnF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAyB/E;AAuBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAIV;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,EAAE,aAAa,GAAE,OAAe,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAyBzJ;AAED,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAanI;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,qBAAqB,CAwDxB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/types/specialist/model-display.d.ts

@@ -0,0 +1,4 @@
+export declare function extractModelId(model?: string): string | undefined;
+export declare function toModelAlias(model?: string): string | undefined;
+export declare function formatSpecialistModel(specialist: string, model?: string): string;
+//# sourceMappingURL=model-display.d.ts.map

package/dist/types/specialist/model-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-display.d.ts","sourceRoot":"","sources":["../../../src/specialist/model-display.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjE;AAED,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS/D;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhF"}