@mcoda/core 0.1.4

package/dist/services/jobs/JobInsightsService.d.ts

@@ -0,0 +1,97 @@
+import { WorkspaceResolution } from "../../workspace/WorkspaceManager.js";
+import { JobRecord, JobService, JobState } from "./JobService.js";
+export interface JobListFilters {
+    status?: string;
+    type?: string;
+    projectKey?: string;
+    since?: string;
+    limit?: number;
+}
+export interface JobSummary extends JobRecord {
+    progressPct?: number | null;
+    lastCheckpointStage?: string;
+    lastCheckpointAt?: string;
+    stateDetail?: string;
+    jobState?: JobState;
+    jobStateDetail?: string;
+    totalUnits?: number;
+    completedUnits?: number;
+}
+export interface CheckpointSummary {
+    stage?: string;
+    timestamp?: string;
+    details?: Record<string, unknown>;
+    path?: string;
+}
+export interface JobLogEntry {
+    timestamp: string;
+    sequence?: number | null;
+    level?: string | null;
+    source?: string | null;
+    message?: string | null;
+    taskId?: string | null;
+    taskKey?: string | null;
+    phase?: string | null;
+    details?: Record<string, unknown> | null;
+}
+export interface JobLogsResult {
+    entries: JobLogEntry[];
+    cursor?: {
+        timestamp: string;
+        sequence?: number | null;
+    };
+}
+export interface TaskRunSnapshot {
+    taskId?: string | null;
+    taskKey?: string | null;
+    status?: string | null;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+    command?: string | null;
+}
+export interface TaskRunSummary {
+    totals: Record<string, number>;
+    tasks: TaskRunSnapshot[];
+}
+export interface TokenUsageSummary {
+    agentId?: string | null;
+    modelName?: string | null;
+    commandName?: string | null;
+    commandRunId?: string | null;
+    taskId?: string | null;
+    tokensPrompt?: number | null;
+    tokensCompletion?: number | null;
+    tokensTotal?: number | null;
+    cost?: number | null;
+}
+export declare class JobInsightsService {
+    private workspace;
+    private jobService;
+    private apiClient?;
+    constructor(workspace: WorkspaceResolution, jobService: JobService, apiBaseUrl?: string);
+    static create(workspace: WorkspaceResolution): Promise<JobInsightsService>;
+    close(): Promise<void>;
+    listJobs(filters?: JobListFilters): Promise<JobSummary[]>;
+    getJob(jobId: string): Promise<JobSummary | undefined>;
+    latestCheckpoint(jobId: string): Promise<CheckpointSummary | undefined>;
+    getJobLogs(jobId: string, options?: {
+        since?: string;
+        after?: {
+            timestamp: string;
+            sequence?: number | null;
+        };
+    }): Promise<JobLogsResult>;
+    summarizeTasks(jobId: string): Promise<TaskRunSummary>;
+    summarizeTokenUsage(jobId: string): Promise<TokenUsageSummary[]>;
+    readJobLog(jobId: string): Promise<string>;
+    readJobLogTail(jobId: string, offset: number): Promise<{
+        content: string;
+        nextOffset: number;
+    }>;
+    updateJobState(jobId: string, state: JobState, meta?: Record<string, unknown>): Promise<void>;
+    cancelJob(jobId: string, options?: {
+        force?: boolean;
+        reason?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=JobInsightsService.d.ts.map

package/dist/services/jobs/JobInsightsService.d.ts.map

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

package/dist/services/jobs/JobInsightsService.js

@@ -0,0 +1,263 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { PathHelper } from "@mcoda/shared";
+import { JobService } from "./JobService.js";
+import { JobsApiClient } from "./JobsApiClient.js";
+import { TelemetryService } from "../telemetry/TelemetryService.js";
+const parseSinceInput = (input) => {
+    if (!input)
+        return undefined;
+    const trimmed = input.trim();
+    const durationMatch = trimmed.match(/^(\d+)([smhdw])$/i);
+    if (durationMatch) {
+        const amount = Number(durationMatch[1]);
+        const unit = durationMatch[2].toLowerCase();
+        const multipliers = {
+            s: 1000,
+            m: 60 * 1000,
+            h: 60 * 60 * 1000,
+            d: 24 * 60 * 60 * 1000,
+            w: 7 * 24 * 60 * 60 * 1000,
+        };
+        if (multipliers[unit]) {
+            return new Date(Date.now() - amount * multipliers[unit]).toISOString();
+        }
+    }
+    const parsed = Date.parse(trimmed);
+    if (!Number.isNaN(parsed)) {
+        return new Date(parsed).toISOString();
+    }
+    return undefined;
+};
+const computeProgress = (job) => {
+    const total = job.totalUnits ?? job.totalItems ?? null;
+    const completed = job.completedUnits ?? job.processedItems ?? 0;
+    if (!total || total <= 0)
+        return null;
+    return Math.round((completed / total) * 100);
+};
+const mapJobRow = (row) => {
+    const payload = row.payload_json ? JSON.parse(row.payload_json) : undefined;
+    const totalUnits = row.total_units ?? row.totalUnits ?? row.total_items ?? row.totalItems ?? undefined;
+    const completedUnits = row.completed_units ?? row.completedUnits ?? row.processed_items ?? row.processedItems ?? undefined;
+    const progressPct = computeProgress({ totalItems: totalUnits, processedItems: completedUnits });
+    return {
+        id: row.id,
+        type: row.type,
+        state: row.state ?? row.job_state,
+        jobState: row.job_state ?? row.state,
+        jobStateDetail: row.job_state_detail ?? row.state_detail ?? row.errorSummary,
+        stateDetail: row.job_state_detail ?? row.state_detail ?? row.errorSummary,
+        commandName: row.command_name ?? row.commandName,
+        commandRunId: row.command_run_id ?? row.commandRunId,
+        workspaceId: row.workspace_id ?? row.workspaceId,
+        projectKey: row.projectKey,
+        payload,
+        totalItems: totalUnits,
+        processedItems: completedUnits,
+        totalUnits,
+        completedUnits,
+        lastCheckpoint: row.last_checkpoint ?? row.lastCheckpoint,
+        createdAt: row.created_at ?? row.createdAt,
+        updatedAt: row.updated_at ?? row.updatedAt,
+        completedAt: row.completed_at ?? row.completedAt,
+        errorSummary: row.error_summary ?? row.errorSummary,
+        progressPct,
+    };
+};
+const matchesProject = (payload, projectKey) => {
+    if (!projectKey)
+        return true;
+    if (!payload)
+        return false;
+    const candidates = [
+        payload.projectKey,
+        payload.project_id,
+        payload.project,
+        payload.projectId,
+    ].filter(Boolean);
+    return candidates.includes(projectKey);
+};
+export class JobInsightsService {
+    constructor(workspace, jobService, apiBaseUrl) {
+        this.workspace = workspace;
+        this.jobService = jobService;
+        if (apiBaseUrl) {
+            this.apiClient = new JobsApiClient(workspace, apiBaseUrl);
+        }
+    }
+    static async create(workspace) {
+        const jobService = new JobService(workspace, undefined, { requireRepo: true });
+        const apiBaseUrl = workspace.config?.api?.baseUrl ??
+            process.env.MCODA_API_BASE_URL ??
+            process.env.MCODA_JOBS_API_URL ??
+            undefined;
+        return new JobInsightsService(workspace, jobService, apiBaseUrl);
+    }
+    async close() {
+        await this.jobService.close();
+    }
+    async listJobs(filters = {}) {
+        if (!this.apiClient) {
+            throw new Error("Jobs API is not configured; set MCODA_API_BASE_URL/MCODA_JOBS_API_URL or workspace api.baseUrl to query jobs.");
+        }
+        const remote = (await this.apiClient.listJobs({
+            status: filters.status,
+            type: filters.type,
+            project: filters.projectKey,
+            since: filters.since,
+            limit: filters.limit,
+        })) ?? [];
+        const rows = remote.map(mapJobRow);
+        const sinceIso = parseSinceInput(filters.since);
+        return rows
+            .filter((job) => {
+            const state = job.jobState ?? job.state;
+            return !filters.status || state === filters.status;
+        })
+            .filter((job) => (!filters.type || job.type === filters.type))
+            .filter((job) => matchesProject(job.payload, filters.projectKey))
+            .filter((job) => {
+            if (!sinceIso)
+                return true;
+            const updated = job.updatedAt ?? job.createdAt;
+            if (!updated)
+                return true;
+            return Date.parse(updated) >= Date.parse(sinceIso);
+        })
+            .slice(0, Number.isFinite(filters.limit) ? filters.limit : rows.length)
+            .map((job) => ({ ...job, progressPct: computeProgress(job) }));
+    }
+    async getJob(jobId) {
+        if (!this.apiClient) {
+            throw new Error("Jobs API is not configured; set MCODA_API_BASE_URL/MCODA_JOBS_API_URL or workspace api.baseUrl to read job status.");
+        }
+        const remote = await this.apiClient.getJob(jobId);
+        const job = remote ? mapJobRow(remote) : undefined;
+        if (!job)
+            return undefined;
+        const detail = job.job_state_detail ?? job.jobStateDetail ?? job.errorSummary;
+        const totalUnits = job.totalUnits ?? job.totalItems ?? job.total_units ?? undefined;
+        const completedUnits = job.completedUnits ?? job.processedItems ?? job.completed_units ?? undefined;
+        return {
+            ...job,
+            jobState: job.job_state ?? job.state,
+            jobStateDetail: detail,
+            stateDetail: detail,
+            totalUnits,
+            completedUnits,
+            progressPct: computeProgress({ totalItems: totalUnits, processedItems: completedUnits }),
+        };
+    }
+    async latestCheckpoint(jobId) {
+        if (!this.apiClient) {
+            throw new Error("Jobs API is not configured; set MCODA_API_BASE_URL/MCODA_JOBS_API_URL or workspace api.baseUrl to read checkpoints.");
+        }
+        const remote = await this.apiClient.getCheckpoint(jobId);
+        if (remote && (remote.stage || remote.status || remote.timestamp)) {
+            const data = remote;
+            return {
+                stage: data.stage ?? data.status,
+                timestamp: data.timestamp ?? data.created_at,
+                details: data.details ?? data.progress,
+            };
+        }
+        const checkpoints = await this.jobService.readCheckpoints(jobId);
+        if (!checkpoints.length)
+            return undefined;
+        const last = checkpoints[checkpoints.length - 1];
+        return {
+            stage: last.stage ?? last.status,
+            timestamp: last.timestamp ?? last.created_at,
+            details: last.details,
+        };
+    }
+    async getJobLogs(jobId, options = {}) {
+        if (!this.apiClient) {
+            throw new Error("Jobs API is not configured; set MCODA_API_BASE_URL/MCODA_JOBS_API_URL or workspace api.baseUrl to stream job logs.");
+        }
+        const remote = await this.apiClient.getLogs(jobId, options);
+        if (!remote)
+            return { entries: [], cursor: undefined };
+        return remote;
+    }
+    async summarizeTasks(jobId) {
+        if (!this.apiClient) {
+            throw new Error("Jobs API is not configured; set MCODA_API_BASE_URL/MCODA_JOBS_API_URL or workspace api.baseUrl to read task summaries.");
+        }
+        const remote = (await this.apiClient.getTasksSummary(jobId)) ?? { totals: {}, tasks: [] };
+        const runs = (remote.tasks ?? []).map((t) => {
+            const taskId = t.taskId ?? t.task_id ?? null;
+            const taskKey = t.taskKey ?? t.task_key ?? null;
+            const startedAt = t.startedAt ?? t.started_at ?? null;
+            const finishedAt = t.finishedAt ?? t.finished_at ?? null;
+            const command = t.command ?? null;
+            return { taskId, taskKey, status: t.status ?? null, startedAt, finishedAt, command };
+        });
+        const totalsRemote = remote.totals ?? {};
+        const totals = {};
+        for (const run of runs) {
+            const status = run.status ?? "unknown";
+            totals[status] = (totals[status] ?? 0) + 1;
+        }
+        Object.entries(totalsRemote ?? {}).forEach(([k, v]) => {
+            totals[k] = v;
+        });
+        const tasks = runs.map((run) => ({
+            taskId: run.taskId ?? undefined,
+            taskKey: run.taskKey ?? undefined,
+            status: run.status ?? undefined,
+            startedAt: run.startedAt ?? undefined,
+            finishedAt: run.finishedAt ?? undefined,
+            command: run.command ?? undefined,
+        }));
+        return { totals, tasks };
+    }
+    async summarizeTokenUsage(jobId) {
+        const telemetry = await TelemetryService.create(this.workspace, { allowMissingTelemetry: false, requireApi: true });
+        try {
+            const summary = await telemetry.getSummary({
+                jobId,
+                groupBy: ["command", "agent", "model"],
+                since: undefined,
+                until: undefined,
+            });
+            return summary.map((row) => ({
+                commandName: row.command_name ?? null,
+                agentId: row.agent_id ?? null,
+                modelName: row.model_name ?? null,
+                tokensPrompt: row.tokens_prompt ?? null,
+                tokensCompletion: row.tokens_completion ?? null,
+                tokensTotal: row.tokens_total ?? null,
+                cost: row.cost_estimate ?? null,
+            }));
+        }
+        finally {
+            await telemetry.close();
+        }
+    }
+    async readJobLog(jobId) {
+        return this.jobService.readLog(jobId);
+    }
+    async readJobLogTail(jobId, offset) {
+        const logPath = path.join(PathHelper.getWorkspaceDir(this.workspace.workspaceRoot), "jobs", jobId, "logs", "stream.log");
+        try {
+            const content = await fs.readFile(logPath, "utf8");
+            const slice = offset > 0 ? content.slice(offset) : content;
+            return { content: slice, nextOffset: content.length };
+        }
+        catch {
+            return { content: "", nextOffset: offset };
+        }
+    }
+    async updateJobState(jobId, state, meta) {
+        await this.jobService.updateJobStatus(jobId, state, meta);
+    }
+    async cancelJob(jobId, options = {}) {
+        if (this.apiClient) {
+            await this.apiClient.cancelJob(jobId, options);
+            return;
+        }
+        throw new Error("Cancel requires the jobs API; set MCODA_API_BASE_URL or workspace baseUrl so the cancel endpoint can enforce state transitions.");
+    }
+}

package/dist/services/jobs/JobResumeService.d.ts

@@ -0,0 +1,16 @@
+import { WorkspaceResolution } from "../../workspace/WorkspaceManager.js";
+import { JobService } from "./JobService.js";
+export interface ResumeOptions {
+    agentName?: string;
+    noTelemetry?: boolean;
+}
+export declare class JobResumeService {
+    private workspace;
+    private jobService;
+    constructor(workspace: WorkspaceResolution, jobService: JobService);
+    static create(workspace: WorkspaceResolution): Promise<JobResumeService>;
+    private readManifest;
+    private assertResumeAllowed;
+    resume(jobId: string, options?: ResumeOptions): Promise<void>;
+}
+//# sourceMappingURL=JobResumeService.d.ts.map

package/dist/services/jobs/JobResumeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobResumeService.d.ts","sourceRoot":"","sources":["../../../src/services/jobs/JobResumeService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,SAAS;IAAuB,OAAO,CAAC,UAAU;gBAAlD,SAAS,EAAE,mBAAmB,EAAU,UAAU,EAAE,UAAU;WAErE,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAKhE,YAAY;IAU1B,OAAO,CAAC,mBAAmB;IA8BrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAyDxE"}

package/dist/services/jobs/JobResumeService.js

@@ -0,0 +1,113 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { JobService } from "./JobService.js";
+import { CodeReviewService } from "../review/CodeReviewService.js";
+import { QaTasksService } from "../execution/QaTasksService.js";
+import { DocsService } from "../docs/DocsService.js";
+export class JobResumeService {
+    constructor(workspace, jobService) {
+        this.workspace = workspace;
+        this.jobService = jobService;
+    }
+    static async create(workspace) {
+        const jobService = new JobService(workspace, undefined, { requireRepo: true });
+        return new JobResumeService(workspace, jobService);
+    }
+    async readManifest(jobId) {
+        const manifestPath = path.join(this.workspace.workspaceRoot, ".mcoda", "jobs", jobId, "manifest.json");
+        try {
+            const raw = await fs.readFile(manifestPath, "utf8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    assertResumeAllowed(job, manifest) {
+        const state = job.jobState ?? job.state ?? "unknown";
+        if (["completed", "cancelled"].includes(state)) {
+            throw new Error(`Job ${job.id} is ${state}; cannot resume.`);
+        }
+        if (["running", "queued", "checkpointing"].includes(state)) {
+            throw new Error(`Job ${job.id} is ${state}; wait for it to finish or cancel before resuming.`);
+        }
+        const supported = job.resumeSupported ?? job.resume_supported ?? job.payload?.resumeSupported ?? job.payload?.resume_supported;
+        if (supported === 0 || supported === false) {
+            throw new Error(`Job ${job.id} does not support resume.`);
+        }
+        if (!manifest) {
+            throw new Error(`Missing manifest for job ${job.id}; cannot resume safely.`);
+        }
+        const manifestJobId = manifest.job_id ?? manifest.id;
+        if (manifestJobId && manifestJobId !== job.id) {
+            throw new Error(`Checkpoint manifest for ${job.id} does not match job id (${manifestJobId}); aborting resume.`);
+        }
+        const manifestType = manifest.type ?? manifest.job_type;
+        if (manifestType && manifestType !== job.type) {
+            throw new Error(`Checkpoint manifest type (${manifestType}) does not match job type (${job.type}); cannot resume.`);
+        }
+        const manifestCommand = manifest.command ?? manifest.command_name ?? manifest.commandName;
+        if (manifestCommand && job.commandName && manifestCommand !== job.commandName) {
+            throw new Error(`Checkpoint manifest command (${manifestCommand}) does not match job command (${job.commandName}); cannot resume.`);
+        }
+    }
+    async resume(jobId, options = {}) {
+        const job = await this.jobService.getJob(jobId);
+        if (!job)
+            throw new Error(`Job not found: ${jobId}`);
+        const checkpoints = await this.jobService.readCheckpoints(jobId);
+        if (!checkpoints.length)
+            throw new Error(`No checkpoints found for job ${jobId}; cannot resume.`);
+        const manifest = await this.readManifest(jobId);
+        this.assertResumeAllowed(job, manifest);
+        await this.jobService.updateJobStatus(jobId, "running", { job_state_detail: "resuming" });
+        const command = (job.commandName ?? job.type ?? "").toLowerCase();
+        if (command === "code-review" || job.type === "review") {
+            const service = await CodeReviewService.create(this.workspace);
+            try {
+                await service.reviewTasks({
+                    workspace: this.workspace,
+                    resumeJobId: jobId,
+                    agentName: options.agentName,
+                    agentStream: true,
+                });
+            }
+            finally {
+                await service.close();
+            }
+            return;
+        }
+        if (command === "qa-tasks" || job.type === "qa") {
+            const qaService = await QaTasksService.create(this.workspace, { noTelemetry: options.noTelemetry });
+            try {
+                await qaService.run({
+                    workspace: this.workspace,
+                    resumeJobId: jobId,
+                    projectKey: job.projectKey ?? job.payload?.projectKey,
+                    agentName: options.agentName,
+                    agentStream: true,
+                });
+            }
+            finally {
+                await qaService.close();
+            }
+            return;
+        }
+        if (command.includes("sds") || job.type === "sds_generate" || command.includes("pdr") || job.type === "pdr_generate") {
+            const docs = await DocsService.create(this.workspace);
+            try {
+                if (command.includes("sds") || job.type === "sds_generate") {
+                    await docs.generateSds({ workspace: this.workspace, resumeJobId: jobId, agentName: options.agentName });
+                }
+                else {
+                    await docs.generatePdr({ workspace: this.workspace, resumeJobId: jobId, agentName: options.agentName });
+                }
+            }
+            finally {
+                await docs.close();
+            }
+            return;
+        }
+        throw new Error(`Resume is not implemented for job type ${job.type ?? job.commandName ?? "unknown"}.`);
+    }
+}

package/dist/services/jobs/JobService.d.ts

@@ -0,0 +1,149 @@
+import { WorkspaceRepository, CommandStatus, JobStatus, TokenUsageInsert } from "@mcoda/db";
+export type JobState = JobStatus;
+export type CommandRunStatus = CommandStatus;
+export interface CommandRunRecord {
+    id: string;
+    commandName: string;
+    workspaceId: string;
+    projectKey?: string;
+    jobId?: string;
+    taskIds?: string[];
+    gitBranch?: string;
+    gitBaseBranch?: string;
+    startedAt: string;
+    completedAt?: string;
+    status: CommandRunStatus;
+    errorSummary?: string;
+    durationSeconds?: number;
+    spProcessed?: number | null;
+}
+export interface JobRecord {
+    id: string;
+    type: string;
+    state: JobState;
+    jobState?: JobState;
+    jobStateDetail?: string;
+    commandRunId?: string;
+    commandName?: string;
+    workspaceId: string;
+    projectKey?: string;
+    payload?: Record<string, unknown>;
+    totalItems?: number;
+    processedItems?: number;
+    totalUnits?: number;
+    completedUnits?: number;
+    lastCheckpoint?: string;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    errorSummary?: string;
+    durationSeconds?: number;
+}
+export interface TokenUsageRecord extends TokenUsageInsert {
+    commandName?: string;
+    action?: string;
+    promptTokens?: number;
+    completionTokens?: number;
+    costUsd?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface JobCheckpoint {
+    stage: string;
+    timestamp: string;
+    details?: Record<string, unknown>;
+}
+export interface JobLogRow {
+    timestamp: string;
+    sequence?: number | null;
+    level?: string | null;
+    source?: string | null;
+    message?: string | null;
+    taskId?: string | null;
+    taskKey?: string | null;
+    phase?: string | null;
+    details?: Record<string, unknown> | null;
+}
+export interface TaskRunSnapshotRow {
+    taskId?: string | null;
+    taskKey?: string | null;
+    status?: string | null;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+    command?: string | null;
+}
+export declare class JobService {
+    private workspaceRepo?;
+    private checkpointCounters;
+    private workspaceRepoInit;
+    private telemetryConfig?;
+    private telemetryWarningShown;
+    private telemetryRemoteWarningShown;
+    private perRunTelemetryDisabled;
+    private envTelemetryDisabled;
+    private requireRepo;
+    private workspaceRoot;
+    private workspaceId;
+    constructor(workspace: string | {
+        workspaceRoot: string;
+        workspaceId?: string;
+    }, workspaceRepo?: WorkspaceRepository | undefined, options?: {
+        noTelemetry?: boolean;
+        requireRepo?: boolean;
+    });
+    private get mcodaDir();
+    private get commandRunsPath();
+    private get jobsStorePath();
+    private get tokenUsagePath();
+    private jobDir;
+    private manifestPath;
+    private checkpointDir;
+    private logsDir;
+    private ensureMcoda;
+    private readJsonArray;
+    private writeJsonArray;
+    private appendJsonArray;
+    listJobs(): Promise<JobRecord[]>;
+    getJob(jobId: string): Promise<JobRecord | undefined>;
+    readCheckpoints(jobId: string): Promise<JobCheckpoint[]>;
+    readLog(jobId: string): Promise<string>;
+    listJobLogs(jobId: string, options?: {
+        since?: string;
+        after?: {
+            timestamp: string;
+            sequence?: number | null;
+        };
+    }): Promise<JobLogRow[]>;
+    summarizeTaskRuns(jobId: string): Promise<TaskRunSnapshotRow[]>;
+    startCommandRun(commandName: string, projectKey?: string, options?: {
+        gitBranch?: string;
+        gitBaseBranch?: string;
+        taskIds?: string[];
+        jobId?: string;
+    }): Promise<CommandRunRecord>;
+    finishCommandRun(runId: string, status: CommandRunStatus, errorSummary?: string, spProcessed?: number): Promise<void>;
+    startJob(type: string, commandRunId?: string, projectKey?: string, options?: {
+        payload?: Record<string, unknown>;
+        commandName?: string;
+        totalItems?: number;
+        processedItems?: number;
+    }): Promise<JobRecord>;
+    private attachCommandRunToJob;
+    updateJobStatus(jobId: string, state: JobState, metadata?: {
+        payload?: Record<string, unknown>;
+        totalItems?: number;
+        processedItems?: number;
+        totalUnits?: number;
+        completedUnits?: number;
+        lastCheckpoint?: string;
+        errorSummary?: string;
+        [key: string]: unknown;
+    }): Promise<void>;
+    writeCheckpoint(jobId: string, checkpoint: JobCheckpoint): Promise<void>;
+    appendLog(jobId: string, content: string): Promise<void>;
+    private readTelemetryConfig;
+    private shouldRecordTokenUsage;
+    recordTokenUsage(entry: TokenUsageRecord): Promise<void>;
+    writeManifest(job: JobRecord, extras?: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=JobService.d.ts.map

package/dist/services/jobs/JobService.d.ts.map

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