@jaggerxtrm/specialists 3.9.0 → 3.12.0

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

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

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

@@ -0,0 +1,90 @@
+import { type ChildProcess } from 'node:child_process';
+import { SpecialistLoader } from './loader.js';
+import type { Specialist } from './schema.js';
+export type ScriptSpecialistErrorType = 'specialist_not_found' | 'specialist_load_error' | 'template_variable_missing' | 'auth' | 'quota' | 'timeout' | 'network' | 'invalid_json' | 'output_too_large' | 'internal';
+export interface ScriptGenerateRequest {
+    specialist: string;
+    requested_specialist?: string;
+    variables?: Record<string, string>;
+    template?: string;
+    model_override?: string;
+    thinking_level?: string;
+    timeout_ms?: number;
+    trace?: boolean;
+}
+export interface ScriptGenerateSuccess {
+    success: true;
+    output: string;
+    parsed_json?: unknown;
+    meta: {
+        specialist: string;
+        requested_specialist?: string;
+        resolved_specialist?: string;
+        model: string;
+        duration_ms: number;
+        trace_id: string;
+    };
+}
+export interface ScriptGenerateFailure {
+    success: false;
+    error: string;
+    error_type: ScriptSpecialistErrorType;
+    meta?: {
+        specialist?: string;
+        requested_specialist?: string;
+        resolved_specialist?: string;
+        model?: string;
+        duration_ms?: number;
+        trace_id?: string;
+    };
+}
+export type ScriptGenerateResult = ScriptGenerateSuccess | ScriptGenerateFailure;
+export interface TrustOptions {
+    allowSkills?: boolean;
+    allowSkillsRoots?: string[];
+    allowLocalScripts?: boolean;
+}
+export declare class CompatGuardError extends Error {
+    readonly field: 'execution.interactive' | 'execution.requires_worktree' | 'execution.permission_required' | 'skills.scripts' | 'skills.paths' | 'prompt.skill_inherit';
+    constructor(field: 'execution.interactive' | 'execution.requires_worktree' | 'execution.permission_required' | 'skills.scripts' | 'skills.paths' | 'prompt.skill_inherit', message: string);
+}
+export interface SkillSource {
+    path: string;
+    sha256: string;
+}
+export interface ScriptRunnerOptions {
+    loader: SpecialistLoader;
+    projectDir?: string;
+    fallbackModel?: string;
+    observabilityDbPath?: string;
+    onChild?: (child: ChildProcess) => void;
+    onAuditFailure?: (error: unknown) => void;
+    trust?: TrustOptions;
+}
+export declare function compatGuard(spec: Specialist, trust?: TrustOptions): void;
+export declare function computeSkillSources(spec: Specialist): SkillSource[];
+export declare function renderTaskTemplate(template: string, variables: Record<string, string>): string;
+export declare const DEFAULT_PENDING_LINE_LIMIT_BYTES: number;
+export declare const DEFAULT_ASSISTANT_TEXT_LIMIT_BYTES: number;
+export declare const DEFAULT_STDERR_LIMIT_BYTES: number;
+export declare function resolveAssistantTextLimitBytes(spec: Specialist): number;
+export declare function runScriptSpecialist(input: ScriptGenerateRequest, options: ScriptRunnerOptions): Promise<ScriptGenerateResult>;
+export declare function collectModelCandidates(input: ScriptGenerateRequest, spec: Specialist, options: ScriptRunnerOptions): string[];
+type AttemptFailureReason = 'assistant_text_too_large' | 'stderr_too_large' | 'malformed_line_too_large';
+export declare function classifyAttempt(attempt: {
+    text: string;
+    stderr: string;
+    exitCode: number;
+    timedOut: boolean;
+    outputTooLarge: boolean;
+    outputTooLargeReason?: AttemptFailureReason;
+}): {
+    retryable: boolean;
+    kind: 'success' | 'failure';
+    error: string;
+    errorType: ScriptSpecialistErrorType;
+    text: string;
+};
+export declare function isRetryableModelFailure(stderr: string, text: string): boolean;
+export {};
+//# sourceMappingURL=script-runner.d.ts.map

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

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

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

@@ -0,0 +1,146 @@
+import type { SpecialistRunner, RunOptions } from './runner.js';
+import type { BeadsClient } from './beads.js';
+import type { SessionRunMetrics } from '../pi/session.js';
+import type { StallDetectionConfig } from './loader.js';
+export declare const STALL_DETECTION_DEFAULTS: Required<StallDetectionConfig>;
+export type SupervisorJobStatus = 'starting' | 'running' | 'waiting' | 'done' | 'error' | 'cancelled';
+export interface SupervisorStatus {
+    id: string;
+    specialist: string;
+    status: SupervisorJobStatus;
+    current_event?: string;
+    current_tool?: string;
+    model?: string;
+    backend?: string;
+    output_type?: string;
+    pid?: number;
+    started_at_ms: number;
+    elapsed_s?: number;
+    last_event_at_ms?: number;
+    bead_id?: string;
+    node_id?: string;
+    session_file?: string;
+    fifo_path?: string;
+    tmux_session?: string;
+    worktree_path?: string;
+    reused_from_job_id?: string;
+    worktree_owner_job_id?: string;
+    chain_kind?: 'chain' | 'prep';
+    chain_id?: string;
+    chain_root_job_id?: string;
+    chain_root_bead_id?: string;
+    epic_id?: string;
+    branch?: string;
+    startup_payload_json?: string;
+    startup_context?: {
+        job_id?: string;
+        specialist_name?: string;
+        bead_id?: string;
+        reused_from_job_id?: string;
+        worktree_owner_job_id?: string;
+        chain_id?: string;
+        chain_root_job_id?: string;
+        chain_root_bead_id?: string;
+        worktree_path?: string;
+        branch?: string;
+        variables_keys?: string[];
+        reviewed_job_id_present?: boolean;
+        reused_worktree_awareness_present?: boolean;
+        bead_context_present?: boolean;
+        memory_injection?: {
+            static_tokens: number;
+            memory_tokens: number;
+            gitnexus_tokens: number;
+            total_tokens: number;
+        };
+        mandatory_rules_injection?: {
+            sets_loaded: string[];
+            rules_count: number;
+            inline_rules_count: number;
+            globals_disabled: boolean;
+            token_estimate: number;
+        };
+        skills?: {
+            count: number;
+            activated: string[];
+        };
+    };
+    metrics?: SessionRunMetrics;
+    context_pct?: number;
+    context_health?: ContextHealth;
+    error?: string;
+    auto_commit_count?: number;
+    last_auto_commit_sha?: string;
+    last_auto_commit_at_ms?: number;
+}
+export type SupervisorStatusView = SupervisorStatus & {
+    is_dead: boolean;
+};
+export interface SupervisorOptions {
+    runner: SpecialistRunner;
+    runOptions: RunOptions;
+    /** Absolute path to .specialists/jobs/. Defaults to the git-common-root-anchored path. */
+    jobsDir?: string;
+    beadsClient?: BeadsClient;
+    /** Optional callback to stream progress deltas to stdout/elsewhere */
+    onProgress?: (delta: string) => void;
+    /** Optional callback for meta events (backend/model) */
+    onMeta?: (meta: {
+        backend: string;
+        model: string;
+    }) => void;
+    /** Optional callback fired as soon as a job id is allocated and persisted */
+    onJobStarted?: (job: {
+        id: string;
+    }) => void;
+    /** Stall detection thresholds — merged with STALL_DETECTION_DEFAULTS */
+    stallDetection?: StallDetectionConfig;
+}
+type ContextHealth = 'OK' | 'MONITOR' | 'WARN' | 'CRITICAL';
+export declare function isPidAlive(pid: number | undefined): boolean;
+export declare function isJobDead(status: Pick<SupervisorStatus, 'status' | 'pid' | 'tmux_session'>): boolean;
+export declare class Supervisor {
+    private opts;
+    private readonly sqliteClient;
+    private readonly resolvedJobsDir;
+    private isDisposed;
+    private disposePromise;
+    private pendingSqliteOperations;
+    private readonly pendingSqliteDrainResolvers;
+    private readonly isJobFileOutputEnabled;
+    constructor(opts: SupervisorOptions);
+    private createDisposedSqliteError;
+    private withSqliteOperation;
+    private waitForPendingSqliteOperations;
+    dispose(): Promise<void>;
+    private jobDir;
+    private statusPath;
+    private resultPath;
+    private observabilityDbPath;
+    private shouldWriteJobFiles;
+    private eventsPath;
+    private readyDir;
+    private writeReadyMarker;
+    private withComputedLiveness;
+    readStatus(id: string): SupervisorStatusView | null;
+    listLiveJobsForBead(beadId: string): string[];
+    emitMetaEvent(jobId: string, model: string, backend: string): void;
+    updateJobStatus(id: string, status: Extract<SupervisorJobStatus, 'done' | 'cancelled' | 'error' | 'waiting' | 'running' | 'starting'>, error?: string): SupervisorStatusView | null;
+    aggregateJobMetricsBestEffort(jobId: string): void;
+    /** List all jobs sorted newest-first. */
+    listJobs(): SupervisorStatusView[];
+    private withStatusLineageDefaults;
+    private writeStatusFileOnly;
+    private writeStatusFile;
+    /** GC: remove job dirs older than JOB_TTL_DAYS. */
+    private gc;
+    /** Crash recovery: mark running jobs with dead PID as error, and emit stale warnings. */
+    private crashRecovery;
+    /**
+     * Run the specialist under supervision. Writes job state to disk.
+     * Returns the job ID when complete (or throws on error).
+     */
+    run(): Promise<string>;
+}
+export {};
+//# sourceMappingURL=supervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../../src/specialist/supervisor.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAiB9C,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAWxD,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,oBAAoB,CAKnE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEtG,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,iCAAiC,CAAC,EAAE,OAAO,CAAC;QAC5C,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,gBAAgB,CAAC,EAAE;YACjB,aAAa,EAAE,MAAM,CAAC;YACtB,aAAa,EAAE,MAAM,CAAC;YACtB,eAAe,EAAE,MAAM,CAAC;YACxB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,yBAAyB,CAAC,EAAE;YAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;YACpB,kBAAkB,EAAE,MAAM,CAAC;YAC3B,gBAAgB,EAAE,OAAO,CAAC;YAC1B,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC;QACF,MAAM,CAAC,EAAE;YACP,KAAK,EAAE,MAAM,CAAC;YACd,SAAS,EAAE,MAAM,EAAE,CAAC;SACrB,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5D,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7C,wEAAwE;IACxE,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAqCD,KAAK,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAoV5D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAU3D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,KAAK,GAAG,cAAc,CAAC,GAAG,OAAO,CAKpG;AAED,qBAAa,UAAU;IAST,OAAO,CAAC,IAAI;IARxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAyB;IACrE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAU;gBAE7B,IAAI,EAAE,iBAAiB;IAS3C,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,mBAAmB;YAmBb,8BAA8B;IAQtC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,oBAAoB;IAO5B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAuBnD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAY7C,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAalE,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAgBnL,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD,yCAAyC;IACzC,QAAQ,IAAI,oBAAoB,EAAE;IA8BlC,OAAO,CAAC,yBAAyB;IA4BjC,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,eAAe;IA4CvB,mDAAmD;IACnD,OAAO,CAAC,EAAE;IAaV,yFAAyF;IACzF,OAAO,CAAC,aAAa;IA0FrB;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;CAwqC7B"}

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

@@ -0,0 +1,2 @@
+export declare function renderTemplate(template: string, variables: Record<string, string>): string;
+//# sourceMappingURL=templateEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templateEngine.d.ts","sourceRoot":"","sources":["../../../src/specialist/templateEngine.ts"],"names":[],"mappings":"AACA,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI1F"}