@a5c-ai/tasks-adapter 5.1.1-staging.52898ebfc24f

package/dist/backend.js

@@ -0,0 +1,40 @@
+export class UnsupportedBreakpointFeatureError extends Error {
+    backendName;
+    feature;
+    constructor(backendName, feature) {
+        super(`Backend "${backendName}" does not support ${feature}`);
+        this.name = "UnsupportedBreakpointFeatureError";
+        this.backendName = backendName;
+        this.feature = feature;
+    }
+}
+export const unsupportedBreakpointBackendCapabilities = {
+    search: false,
+    bulkOperations: false,
+    assignment: false,
+    comments: false,
+    history: false,
+    metrics: false,
+    export: false,
+    forms: false,
+    notifications: false,
+    escalation: false,
+};
+export function unsupportedBreakpointFeature(backendName, feature) {
+    throw new UnsupportedBreakpointFeatureError(backendName, feature);
+}
+export function selectBreakpointAnswer(breakpoint) {
+    if (breakpoint.answers.length === 0) {
+        return undefined;
+    }
+    if (breakpoint.selectedAnswer) {
+        return breakpoint.answers.find((answer) => answer.id === breakpoint.selectedAnswer);
+    }
+    return breakpoint.answers[0];
+}
+export function supportsProvenAnswers(backendName) {
+    return backendName === "git-native";
+}
+export function unsupportedBackendFeatureMessage(backendName, feature) {
+    return `Backend "${backendName}" does not support ${feature}. Proven signing is currently supported only by "git-native".`;
+}

package/dist/backends/adapters.d.ts

@@ -0,0 +1,99 @@
+import type { BreakpointBackend, BreakpointBackendCapabilities, SubmitAnswerParams, SubmitBreakpointParams, WaitForAnswerOptions } from "../backend.js";
+import type { Breakpoint, BreakpointPublicAnswer, ResponderProfile } from "../types.js";
+export interface AgentMuxRunOptions {
+    agent: string;
+    prompt: string | string[];
+    model?: string;
+    cwd?: string;
+    timeout?: number;
+    collectEvents?: boolean;
+    tags?: string[];
+    approvalMode?: "yolo" | "prompt" | "deny";
+    nonInteractive?: boolean;
+}
+export interface AgentMuxRunError {
+    readonly code: string;
+    readonly message: string;
+    readonly stderr: string;
+    readonly recoverable: boolean;
+}
+export interface AgentMuxRunResult {
+    readonly runId: string;
+    readonly agent: string;
+    readonly model: string | undefined;
+    readonly sessionId: string | undefined;
+    readonly text: string;
+    readonly cost: unknown;
+    readonly durationMs: number;
+    readonly exitCode: number | null;
+    readonly signal: string | null;
+    readonly exitReason: "completed" | "aborted" | "interrupted" | "timeout" | "inactivity" | "turn_limit" | "crashed" | "killed";
+    readonly tokenUsage: unknown;
+    readonly turnCount: number;
+    readonly error: AgentMuxRunError | null;
+    readonly events: Array<Record<string, unknown>>;
+    readonly tags: string[];
+}
+export interface AgentMuxRunHandleLike extends PromiseLike<AgentMuxRunResult> {
+    readonly runId: string;
+    readonly agent: string;
+    readonly model: string | undefined;
+    catch: Promise<AgentMuxRunResult>["catch"];
+    finally: Promise<AgentMuxRunResult>["finally"];
+    result(): Promise<AgentMuxRunResult>;
+    abort(): Promise<void> | void;
+}
+export interface AgentMuxClientLike {
+    run(options: AgentMuxRunOptions): AgentMuxRunHandleLike;
+}
+export interface AgentMuxResponderBackendConfig {
+    type?: "adapters";
+    agent?: string;
+    adapter?: string;
+    model?: string;
+    cwd?: string;
+    timeoutMs?: number;
+    collectEvents?: boolean;
+    tags?: string[];
+    approvalMode?: "yolo" | "prompt" | "deny";
+    nonInteractive?: boolean;
+    client?: AgentMuxClientLike;
+    clientFactory?: () => AgentMuxClientLike | Promise<AgentMuxClientLike>;
+}
+export declare class AgentMuxResponderBackendError extends Error {
+    readonly code: string;
+    readonly cause?: unknown;
+    constructor(code: string, message: string, cause?: unknown);
+}
+export declare class AgentMuxResponderBackend implements BreakpointBackend {
+    private readonly config;
+    readonly name = "adapters";
+    private readonly breakpoints;
+    private readonly client?;
+    private readonly clientFactory?;
+    constructor(config: AgentMuxResponderBackendConfig);
+    capabilities(): BreakpointBackendCapabilities;
+    submitBreakpoint(params: SubmitBreakpointParams): Promise<Breakpoint>;
+    getBreakpoint(id: string): Promise<Breakpoint>;
+    waitForAnswer(id: string, options?: WaitForAnswerOptions): Promise<{
+        answered: boolean;
+        breakpoint: Breakpoint;
+        answer?: BreakpointPublicAnswer;
+        allAnswers: BreakpointPublicAnswer[];
+        resolution?: string;
+        elapsedMs: number;
+    }>;
+    listPendingBreakpoints(responderId?: string): Promise<Breakpoint[]>;
+    answerBreakpoint(id: string, answerParams: SubmitAnswerParams): Promise<BreakpointPublicAnswer>;
+    cancelBreakpoint(id: string): Promise<void>;
+    listResponders(): Promise<ResponderProfile[]>;
+    private getClient;
+    private awaitRunResult;
+    private assertSuccessfulRun;
+    private mapRunStartError;
+    private createAnswer;
+    private buildPrompt;
+    private extractReferences;
+    private createRunMetadata;
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/backends/adapters.d.ts.map

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

package/dist/backends/adapters.js

@@ -0,0 +1,308 @@
+import { unsupportedBreakpointBackendCapabilities } from "../backend.js";
+import { BreakpointSchema, generateBreakpointId } from "../types.js";
+export class AgentMuxResponderBackendError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.name = "AgentMuxResponderBackendError";
+        this.code = code;
+        this.cause = cause;
+    }
+}
+export class AgentMuxResponderBackend {
+    config;
+    name = "adapters";
+    breakpoints = new Map();
+    client;
+    clientFactory;
+    constructor(config) {
+        this.config = config;
+        if (!config.agent && !config.adapter) {
+            throw new AgentMuxResponderBackendError("CONFIG_ERROR", 'AgentMuxResponderBackend requires an "agent" or "adapter" config value.');
+        }
+        this.client = config.client;
+        this.clientFactory = config.clientFactory;
+    }
+    capabilities() {
+        return {
+            ...unsupportedBreakpointBackendCapabilities,
+            assignment: true,
+            metrics: true,
+        };
+    }
+    async submitBreakpoint(params) {
+        const breakpointId = params.routing.breakpointId ?? generateBreakpointId();
+        const createdAt = new Date().toISOString();
+        const timeoutMs = params.routing.timeoutMs ?? this.config.timeoutMs ?? 30_000;
+        const expiresAt = new Date(Date.now() + timeoutMs).toISOString();
+        const agent = params.routing.adapter
+            ?? params.routing.targetResponders[0]
+            ?? this.config.adapter
+            ?? this.config.agent
+            ?? "adapters";
+        const runOptions = {
+            agent,
+            prompt: this.buildPrompt(params),
+            model: params.routing.model ?? this.config.model,
+            cwd: this.config.cwd,
+            timeout: timeoutMs,
+            collectEvents: this.config.collectEvents ?? true,
+            tags: [...new Set([...(this.config.tags ?? []), "tasks-adapter", "breakpoint", breakpointId])],
+            approvalMode: this.config.approvalMode,
+            nonInteractive: this.config.nonInteractive ?? true,
+        };
+        let handle;
+        try {
+            handle = (await this.getClient()).run(runOptions);
+        }
+        catch (err) {
+            throw this.mapRunStartError(err, agent);
+        }
+        const result = await this.awaitRunResult(handle, timeoutMs);
+        this.assertSuccessfulRun(result);
+        const answer = this.createAnswer({
+            breakpointId,
+            responderId: result.agent || agent,
+            responderName: result.agent || agent,
+            text: result.text,
+            confidence: 100,
+            references: this.extractReferences(result),
+            now: new Date().toISOString(),
+        });
+        const breakpoint = BreakpointSchema.parse({
+            id: breakpointId,
+            text: params.text,
+            context: {
+                ...params.context,
+                metadata: {
+                    ...(params.context.metadata ?? {}),
+                    agentMux: this.createRunMetadata(result),
+                },
+            },
+            status: "answered",
+            routing: params.routing,
+            answers: [answer],
+            selectedAnswer: answer.id,
+            projectId: params.projectId,
+            repoId: params.repoId,
+            createdAt,
+            updatedAt: answer.answeredAt,
+            expiresAt,
+        });
+        this.breakpoints.set(breakpoint.id, breakpoint);
+        return breakpoint;
+    }
+    async getBreakpoint(id) {
+        const breakpoint = this.breakpoints.get(id);
+        if (!breakpoint) {
+            throw new AgentMuxResponderBackendError("NOT_FOUND", `Breakpoint "${id}" was not found.`);
+        }
+        return breakpoint;
+    }
+    async waitForAnswer(id, options = {}) {
+        const started = Date.now();
+        if (options.signal?.aborted) {
+            throw new AgentMuxResponderBackendError("ABORTED", "Waiting for adapters answer was aborted.");
+        }
+        const breakpoint = await this.getBreakpoint(id);
+        const answer = breakpoint.selectedAnswer
+            ? breakpoint.answers.find((candidate) => candidate.id === breakpoint.selectedAnswer)
+            : breakpoint.answers[0];
+        return {
+            answered: Boolean(answer),
+            breakpoint,
+            answer,
+            allAnswers: breakpoint.answers,
+            resolution: answer ? "answered" : breakpoint.status,
+            elapsedMs: Date.now() - started,
+        };
+    }
+    async listPendingBreakpoints(responderId) {
+        return [...this.breakpoints.values()].filter((breakpoint) => {
+            const pending = breakpoint.status === "pending" || breakpoint.status === "routed" || breakpoint.status === "claimed";
+            if (!pending)
+                return false;
+            if (!responderId)
+                return true;
+            return breakpoint.routing.targetResponders.includes(responderId);
+        });
+    }
+    async answerBreakpoint(id, answerParams) {
+        const breakpoint = await this.getBreakpoint(id);
+        const answer = this.createAnswer({
+            breakpointId: id,
+            responderId: answerParams.responderId,
+            responderName: answerParams.responderName,
+            text: answerParams.text,
+            approved: answerParams.approved,
+            confidence: answerParams.confidence ?? 100,
+            references: answerParams.references ?? [],
+            followUpQuestions: answerParams.followUpQuestions ?? [],
+            decisionMemory: answerParams.decisionMemory
+                ? {
+                    ...answerParams.decisionMemory,
+                    savedAt: new Date().toISOString(),
+                }
+                : undefined,
+            now: new Date().toISOString(),
+        });
+        breakpoint.answers.push(answer);
+        breakpoint.selectedAnswer = answer.id;
+        breakpoint.status = "answered";
+        breakpoint.updatedAt = answer.answeredAt;
+        return answer;
+    }
+    async cancelBreakpoint(id) {
+        const breakpoint = this.breakpoints.get(id);
+        if (!breakpoint) {
+            throw new AgentMuxResponderBackendError("NOT_FOUND", `Breakpoint "${id}" was not found.`);
+        }
+        if (breakpoint.status === "answered" || breakpoint.status === "completed") {
+            throw new AgentMuxResponderBackendError("INVALID_STATE", `Breakpoint "${id}" has already been answered and cannot be cancelled.`);
+        }
+        breakpoint.status = "cancelled";
+        breakpoint.updatedAt = new Date().toISOString();
+    }
+    async listResponders() {
+        const agent = this.config.agent ?? this.config.adapter ?? "adapters";
+        return [
+            {
+                id: agent,
+                type: "agent",
+                name: agent,
+                title: "Agent adapter responder",
+                capabilities: ["text", "code", "automation", agent],
+                domains: [],
+                tags: ["adapters", agent],
+                availability: true,
+                responseTimeSla: (this.config.timeoutMs ?? 30_000) / 1000,
+                adapter: this.config.adapter,
+                model: this.config.model,
+            },
+        ];
+    }
+    async getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        if (this.clientFactory) {
+            return await this.clientFactory();
+        }
+        const importModule = new Function("specifier", "return import(specifier)");
+        const mod = await importModule("@a5c-ai/adapters");
+        return mod.createClient({
+            defaultAgent: this.config.agent ?? this.config.adapter,
+            defaultModel: this.config.model,
+            approvalMode: this.config.approvalMode,
+            timeout: this.config.timeoutMs,
+        });
+    }
+    async awaitRunResult(handle, timeoutMs) {
+        let timer;
+        try {
+            return await Promise.race([
+                handle.result(),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => {
+                        void handle.abort();
+                        reject(new AgentMuxResponderBackendError("TIMEOUT", `Adapters run timed out after ${timeoutMs}ms.`));
+                    }, timeoutMs);
+                }),
+            ]);
+        }
+        finally {
+            if (timer) {
+                clearTimeout(timer);
+            }
+        }
+    }
+    assertSuccessfulRun(result) {
+        if (result.exitReason === "completed" && !result.error) {
+            return;
+        }
+        if (result.exitReason === "timeout" || result.exitReason === "inactivity") {
+            throw new AgentMuxResponderBackendError("TIMEOUT", `Adapters run timed out for agent "${result.agent}".`);
+        }
+        if (result.exitReason === "aborted") {
+            throw new AgentMuxResponderBackendError("ABORTED", `Adapters run was aborted for agent "${result.agent}".`);
+        }
+        const reason = result.error?.message ?? result.exitReason;
+        throw new AgentMuxResponderBackendError(result.error?.code ?? "RUN_FAILED", `Adapters run failed for agent "${result.agent}": ${reason}`, result.error);
+    }
+    mapRunStartError(err, agent) {
+        const code = typeof err === "object" && err && "code" in err
+            ? String(err.code)
+            : "RUN_START_FAILED";
+        const message = err instanceof Error ? err.message : String(err);
+        if (code === "UNKNOWN_AGENT" || code === "AGENT_NOT_FOUND" || code === "AGENT_NOT_INSTALLED") {
+            return new AgentMuxResponderBackendError(code, `Adapters adapter is not installed or unknown for agent "${agent}": ${message}`, err);
+        }
+        if (code === "AUTH_ERROR") {
+            return new AgentMuxResponderBackendError(code, `Adapters authentication failed for agent "${agent}": ${message}`, err);
+        }
+        if (code === "TIMEOUT" || code === "INACTIVITY_TIMEOUT") {
+            return new AgentMuxResponderBackendError("TIMEOUT", `Adapters run timed out for agent "${agent}": ${message}`, err);
+        }
+        return new AgentMuxResponderBackendError(code, `Adapters run could not start for agent "${agent}": ${message}`, err);
+    }
+    createAnswer(args) {
+        return {
+            id: `${args.breakpointId}-answer-${generateBreakpointId()}`,
+            breakpointId: args.breakpointId,
+            responderId: args.responderId,
+            responderName: args.responderName,
+            text: args.text,
+            approved: args.approved,
+            confidence: args.confidence,
+            references: args.references,
+            followUpQuestions: args.followUpQuestions ?? [],
+            decisionMemory: args.decisionMemory,
+            answeredAt: args.now,
+        };
+    }
+    buildPrompt(params) {
+        const sections = [
+            params.text,
+            "",
+            "Context:",
+            params.context.markdown ?? params.context.description,
+        ];
+        if (params.context.fileReferences.length > 0) {
+            sections.push("", "Files:", ...params.context.fileReferences.map((file) => `- ${file}`));
+        }
+        if (params.context.codeSnippets.length > 0) {
+            sections.push("", "Code snippets:", JSON.stringify(params.context.codeSnippets, null, 2));
+        }
+        return sections.join("\n");
+    }
+    extractReferences(result) {
+        const references = new Set();
+        for (const event of result.events ?? []) {
+            const value = event.reference ?? event.url ?? event.file;
+            if (typeof value === "string" && value.length > 0) {
+                references.add(value);
+            }
+        }
+        return [...references];
+    }
+    createRunMetadata(result) {
+        return {
+            runId: result.runId,
+            agent: result.agent,
+            model: result.model,
+            sessionId: result.sessionId,
+            exitReason: result.exitReason,
+            durationMs: result.durationMs,
+            exitCode: result.exitCode,
+            signal: result.signal,
+            cost: result.cost,
+            tokenUsage: result.tokenUsage,
+            turnCount: result.turnCount,
+            tags: result.tags,
+            costEvents: (result.events ?? [])
+                .filter((event) => event.type === "cost" && "cost" in event)
+                .map((event) => event.cost),
+        };
+    }
+}

package/dist/backends/external-tracker.d.ts

@@ -0,0 +1,133 @@
+import type { BreakpointBackend, BreakpointBackendCapabilities, ListRespondersParams, SubmitAnswerParams, SubmitBreakpointParams, WaitForAnswerOptions } from "../backend.js";
+import type { Breakpoint, BreakpointPublicAnswer, BreakpointWaitResult, ExternalTrackerBackendConfig, ExternalTrackerProvider, ExternalTrackerStatus, ResponderProfile } from "../types.js";
+export interface ExternalTrackerReference {
+    provider: ExternalTrackerProvider;
+    id: string;
+    key?: string;
+    url?: string;
+}
+export interface ExternalTrackerIssue {
+    ref: ExternalTrackerReference;
+    title: string;
+    description?: string;
+    status: ExternalTrackerStatus;
+    labels: string[];
+    assignees: string[];
+    createdAt: string;
+    updatedAt: string;
+    comments: ExternalTrackerComment[];
+    metadata?: Record<string, unknown>;
+}
+export interface ExternalTrackerComment {
+    id: string;
+    authorId: string;
+    authorName: string;
+    body: string;
+    createdAt: string;
+}
+export interface ExternalTrackerWebhookEvent {
+    provider: ExternalTrackerProvider;
+    eventId: string;
+    action: "issue.created" | "issue.updated" | "comment.created" | "issue.deleted";
+    issue: ExternalTrackerIssue;
+    comment?: ExternalTrackerComment;
+    receivedAt: string;
+}
+export interface ExternalTrackerWebhookResult {
+    accepted: boolean;
+    duplicate: boolean;
+    event?: ExternalTrackerWebhookEvent;
+    breakpoint?: Breakpoint;
+    answer?: BreakpointPublicAnswer;
+}
+export interface ExternalTrackerCreateIssueInput {
+    title: string;
+    description: string;
+    labels: string[];
+    assignees: string[];
+    fields: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+}
+export interface ExternalTrackerAdapter {
+    readonly provider: ExternalTrackerProvider;
+    createIssue(input: ExternalTrackerCreateIssueInput): Promise<ExternalTrackerIssue>;
+    getIssue(ref: ExternalTrackerReference): Promise<ExternalTrackerIssue>;
+    listIssues(): Promise<ExternalTrackerIssue[]>;
+    addComment(ref: ExternalTrackerReference, answer: SubmitAnswerParams): Promise<ExternalTrackerComment>;
+    transitionIssue(ref: ExternalTrackerReference, status: ExternalTrackerStatus): Promise<void>;
+    claimIssue?(ref: ExternalTrackerReference, responderId: string): Promise<void>;
+    normalizeWebhook?(payload: unknown, headers?: Record<string, string>): ExternalTrackerWebhookEvent | null;
+}
+export declare function redactExternalTrackerSecrets<T>(value: T): T;
+declare abstract class HttpTrackerAdapter implements ExternalTrackerAdapter {
+    protected readonly config: ExternalTrackerBackendConfig;
+    abstract readonly provider: ExternalTrackerProvider;
+    constructor(config: ExternalTrackerBackendConfig);
+    abstract createIssue(input: ExternalTrackerCreateIssueInput): Promise<ExternalTrackerIssue>;
+    abstract getIssue(ref: ExternalTrackerReference): Promise<ExternalTrackerIssue>;
+    abstract listIssues(): Promise<ExternalTrackerIssue[]>;
+    abstract addComment(ref: ExternalTrackerReference, answer: SubmitAnswerParams): Promise<ExternalTrackerComment>;
+    abstract transitionIssue(ref: ExternalTrackerReference, status: ExternalTrackerStatus): Promise<void>;
+    protected requestJson(pathOrUrl: string, init?: RequestInit): Promise<unknown>;
+    protected applyAuth(headers: Record<string, string>): void;
+    protected mapIssue(raw: unknown, fallbackId?: string): ExternalTrackerIssue;
+    protected mapComments(raw: unknown): ExternalTrackerComment[];
+    normalizeWebhook(payload: unknown): ExternalTrackerWebhookEvent | null;
+}
+export declare class JiraTrackerAdapter extends HttpTrackerAdapter {
+    readonly provider: "jira";
+    createIssue(input: ExternalTrackerCreateIssueInput): Promise<ExternalTrackerIssue>;
+    getIssue(ref: ExternalTrackerReference): Promise<ExternalTrackerIssue>;
+    listIssues(): Promise<ExternalTrackerIssue[]>;
+    addComment(ref: ExternalTrackerReference, answer: SubmitAnswerParams): Promise<ExternalTrackerComment>;
+    transitionIssue(ref: ExternalTrackerReference, status: ExternalTrackerStatus): Promise<void>;
+}
+export declare class LinearTrackerAdapter extends HttpTrackerAdapter {
+    readonly provider: "linear";
+    protected applyAuth(headers: Record<string, string>): void;
+    private graphql;
+    createIssue(input: ExternalTrackerCreateIssueInput): Promise<ExternalTrackerIssue>;
+    getIssue(ref: ExternalTrackerReference): Promise<ExternalTrackerIssue>;
+    listIssues(): Promise<ExternalTrackerIssue[]>;
+    addComment(ref: ExternalTrackerReference, answer: SubmitAnswerParams): Promise<ExternalTrackerComment>;
+    transitionIssue(ref: ExternalTrackerReference, status: ExternalTrackerStatus): Promise<void>;
+    protected mapIssue(raw: unknown, fallbackId?: string): ExternalTrackerIssue;
+}
+export declare class GenericRestTrackerAdapter extends HttpTrackerAdapter {
+    readonly provider: "generic-rest";
+    createIssue(input: ExternalTrackerCreateIssueInput): Promise<ExternalTrackerIssue>;
+    getIssue(ref: ExternalTrackerReference): Promise<ExternalTrackerIssue>;
+    listIssues(): Promise<ExternalTrackerIssue[]>;
+    addComment(ref: ExternalTrackerReference, answer: SubmitAnswerParams): Promise<ExternalTrackerComment>;
+    transitionIssue(ref: ExternalTrackerReference, status: ExternalTrackerStatus): Promise<void>;
+    claimIssue(ref: ExternalTrackerReference, responderId: string): Promise<void>;
+}
+export declare class ExternalTrackerBackend implements BreakpointBackend {
+    private readonly config;
+    readonly name = "external-tracker";
+    private readonly adapter?;
+    private readonly delegatedGitHub?;
+    private readonly refsByBreakpointId;
+    private readonly seenWebhookEvents;
+    private readonly defaultPollIntervalMs;
+    private readonly defaultTimeoutMs;
+    constructor(config: ExternalTrackerBackendConfig);
+    capabilities(): BreakpointBackendCapabilities;
+    submitBreakpoint(params: SubmitBreakpointParams): Promise<Breakpoint>;
+    getBreakpoint(id: string): Promise<Breakpoint>;
+    waitForAnswer(id: string, options?: WaitForAnswerOptions): Promise<BreakpointWaitResult>;
+    listPendingBreakpoints(responderId?: string): Promise<Breakpoint[]>;
+    answerBreakpoint(id: string, answer: SubmitAnswerParams): Promise<BreakpointPublicAnswer>;
+    cancelBreakpoint(id: string): Promise<void>;
+    listResponders(_params?: ListRespondersParams): Promise<ResponderProfile[]>;
+    claimBreakpoint(id: string, responderId: string): Promise<Breakpoint>;
+    handleWebhook(payload: unknown, headers?: Record<string, string>): ExternalTrackerWebhookResult;
+    private requireAdapter;
+    private resolveRef;
+    private issueToBreakpoint;
+    private mapStatusToBreakpoint;
+    private buildMappedFields;
+}
+export declare function createExternalTrackerAdapter(config: ExternalTrackerBackendConfig): ExternalTrackerAdapter;
+export {};
+//# sourceMappingURL=external-tracker.d.ts.map

package/dist/backends/external-tracker.d.ts.map

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