@canhta/dsh-autopilot 0.1.0-alpha.1

package/lib/tracker/model.d.ts

@@ -0,0 +1,222 @@
+declare const trackerProviderIdBrand: unique symbol;
+declare const trackerBindingIdBrand: unique symbol;
+declare const trackerIssueIdBrand: unique symbol;
+declare const trackerCommentIdBrand: unique symbol;
+declare const readinessGenerationBrand: unique symbol;
+/** Validated stable identity of one tracker provider implementation. */
+export type TrackerProviderId = string & {
+    readonly [trackerProviderIdBrand]: true;
+};
+/** Validated identity of the configured project or workspace binding that supplied an issue. */
+export type TrackerBindingId = string & {
+    readonly [trackerBindingIdBrand]: true;
+};
+/** Validated provider-native issue identity, independent of its display key. */
+export type TrackerIssueId = string & {
+    readonly [trackerIssueIdBrand]: true;
+};
+/** Validated provider-native comment identity. */
+export type TrackerCommentId = string & {
+    readonly [trackerCommentIdBrand]: true;
+};
+/** Validated identity of the human readiness transition authorizing one run. */
+export type ReadinessGeneration = string & {
+    readonly [readinessGenerationBrand]: true;
+};
+/** Validate and brand a provider id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export declare const trackerProviderId: (value: string) => TrackerProviderId;
+/** Validate and brand a binding id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export declare const trackerBindingId: (value: string) => TrackerBindingId;
+/** Validate and brand an issue id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export declare const trackerIssueId: (value: string) => TrackerIssueId;
+/** Validate and brand a comment id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export declare const trackerCommentId: (value: string) => TrackerCommentId;
+/**
+ * Validate and brand a readiness-generation id; throws `TypeError` for an invalid external value and has no
+ * cancellation point.
+ */
+export declare const readinessGeneration: (value: string) => ReadinessGeneration;
+/** Exact provider contract version accepted by this build. */
+export declare const TRACKER_INTERFACE_VERSION: 2;
+/** Capabilities every provider generation must implement before registration succeeds. */
+export declare const trackerCapabilities: readonly ['candidates', 'comments', 'dependencies', 'readiness', 'ingress'];
+/** Capability name declared by a compatible provider generation. */
+export type TrackerCapability = (typeof trackerCapabilities)[number];
+export declare const trackerWriteCapabilities: readonly ['reports', 'projections'];
+export type TrackerWriteCapability = (typeof trackerWriteCapabilities)[number];
+/** Immutable comment data used to select and retain the Agent Brief. */
+export interface TrackerComment {
+    id: TrackerCommentId;
+    authorId: string;
+    body: string;
+    updatedAt: string;
+}
+/** Current completion observation for an issue that blocks a candidate. */
+export interface TrackerDependency {
+    issueId: TrackerIssueId;
+    displayKey: string;
+    state: 'completed' | 'not-completed' | 'unknown';
+}
+/** Human readiness evidence, or its explicit absence, at the time of the provider read. */
+export type TrackerReadiness = {
+    kind: 'absent';
+} | {
+    kind: 'transition';
+    generation: ReadinessGeneration;
+    actorId: string;
+    actorKind: 'human' | 'automation' | 'unknown';
+    occurredAt: string;
+};
+/** Complete, bounded issue projection consumed by admission policy. */
+export interface TrackerIssueSnapshot {
+    bindingId: TrackerBindingId;
+    issueId: TrackerIssueId;
+    displayKey: string;
+    summary: string;
+    priorityRank: number;
+    isReady: boolean;
+    labels: readonly string[];
+    comments: readonly TrackerComment[];
+    dependencies: readonly TrackerDependency[];
+    readiness: TrackerReadiness;
+}
+/** One validated provider page and its opaque continuation cursor. */
+export interface TrackerCandidatePage {
+    issues: readonly TrackerIssueSnapshot[];
+    nextCursor?: string;
+}
+/** Generation- and caller-cancellable input supplied to a provider candidate read. */
+export interface TrackerReadRequest {
+    /** Aborts when either the provider generation is withdrawn or the calling operation is cancelled. */
+    signal: AbortSignal;
+    cursor?: string;
+}
+/** One raw ingress header; repeated names remain separate entries. */
+export interface TrackerIngressHeader {
+    name: string;
+    value: string;
+}
+/** Detached, bounded HTTP input passed from the Host adapter to the selected provider. */
+export interface TrackerIngressRequest {
+    /** HTTP method received by the Host ingress adapter. */
+    method: string;
+    /** Raw headers with duplicates preserved so the provider can reject ambiguous authentication input. */
+    headers: readonly TrackerIngressHeader[];
+    /** Detached, bounded request bytes. */
+    body: Uint8Array;
+}
+/** Ingress input extended with the operation's combined cancellation signal. */
+export interface TrackerProviderIngressRequest extends TrackerIngressRequest {
+    /** Aborts when either the provider generation is withdrawn or the calling operation is cancelled. */
+    signal: AbortSignal;
+}
+/** Authentication result whose id is stable across retries and qualified by provider id. */
+export interface TrackerIngressDelivery {
+    /** Provider-qualified delivery id safe to retain in durable admission state. */
+    deliveryId: string;
+}
+export interface TrackerReportDelivery {
+    readonly kind: 'report';
+    readonly deliveryId: string;
+    readonly eventId: string;
+    readonly bindingId: TrackerBindingId;
+    readonly issueId: TrackerIssueId;
+    readonly displayKey: string;
+    readonly body: string;
+}
+export type TrackerProjectionState = 'queued' | 'implementing' | 'paused' | 'blocked' | 'failed' | 'completed';
+export interface TrackerProjectionDelivery {
+    readonly kind: 'projection';
+    readonly deliveryId: string;
+    readonly eventId: string;
+    readonly bindingId: TrackerBindingId;
+    readonly issueId: TrackerIssueId;
+    readonly displayKey: string;
+    readonly readinessGeneration: ReadinessGeneration;
+    readonly runRevision: number;
+    readonly desiredState: TrackerProjectionState;
+}
+export type TrackerOutboundDelivery = TrackerReportDelivery | TrackerProjectionDelivery;
+export interface TrackerOutboundReceipt {
+    readonly receiptId: string;
+    readonly receivedAt: string;
+}
+export type TrackerDeliveryObservation = {
+    readonly kind: 'missing';
+} | {
+    readonly kind: 'delivered';
+    readonly receipt: TrackerOutboundReceipt;
+} | {
+    readonly kind: 'conflict';
+    readonly reason: string;
+};
+export interface TrackerProviderWriteRequest {
+    readonly delivery: TrackerOutboundDelivery;
+    readonly signal: AbortSignal;
+}
+/** Non-replayed availability transition for one provider generation. */
+export interface TrackerProviderLifecycleEvent {
+    kind: 'available' | 'unavailable';
+    providerId: TrackerProviderId;
+}
+/** Bounded, secret-free metadata for one currently available tracker provider generation. */
+export interface TrackerProviderRegistration {
+    readonly id: TrackerProviderId;
+    readonly displayName: string;
+    readonly configurationNamespace: string;
+    readonly capabilities: readonly (TrackerCapability | TrackerWriteCapability)[];
+}
+/** Versioned read-only tracker adapter registered as one lifecycle-owned generation. */
+export interface TrackerProvider {
+    id: TrackerProviderId;
+    interfaceVersion: typeof TRACKER_INTERFACE_VERSION;
+    displayName: string;
+    configurationNamespace: string;
+    capabilities: readonly (TrackerCapability | TrackerWriteCapability)[];
+    /**
+     * Read one provider page without external writes. The cursor, when present, must come from the preceding page.
+     * Resolve with provider data or reject with `TrackerProviderError`; reject with the signal reason when cancelled.
+     */
+    readCandidates(request: TrackerReadRequest): Promise<TrackerCandidatePage>;
+    /**
+     * Authenticate a bounded raw ingress request without retaining a receipt or making external writes. Resolve with a
+     * provider-qualified, retry-stable delivery id; reject with `TrackerProviderError` for authentication or malformed
+     * input and reject with the signal reason when cancelled.
+     */
+    verifyIngress(request: TrackerProviderIngressRequest): Promise<TrackerIngressDelivery>;
+    /** Reconcile a stable outbound identity before any retry. Required when reports/projections are declared. */
+    reconcileDelivery?(request: TrackerProviderWriteRequest): Promise<TrackerDeliveryObservation>;
+    /** Apply one report or mutable projection. Required when reports/projections are declared. */
+    deliver?(request: TrackerProviderWriteRequest): Promise<TrackerOutboundReceipt>;
+}
+/** A generation-scoped, normalized provider view valid only during its `Tracker.withProvider` callback. */
+export interface TrackerReader {
+    /**
+     * Read and validate one candidate page. A supplied caller signal is combined with provider-withdrawal cancellation;
+     * caller cancellation rejects with its original reason, while withdrawal and provider failures are normalized as
+     * `TrackerProviderError`. This operation has no durable or external-write effect.
+     */
+    readCandidates(cursor?: string, signal?: AbortSignal): Promise<TrackerCandidatePage>;
+    /**
+     * Authenticate and validate detached ingress bytes. A supplied caller signal is combined with provider-withdrawal
+     * cancellation; caller cancellation rejects with its original reason, while withdrawal and provider failures are
+     * normalized as `TrackerProviderError`. Successful verification does not retain a receipt.
+     */
+    verifyIngress(request: TrackerIngressRequest, signal?: AbortSignal): Promise<TrackerIngressDelivery>;
+}
+export interface TrackerWriter {
+    reconcileDelivery(delivery: TrackerOutboundDelivery, signal?: AbortSignal): Promise<TrackerDeliveryObservation>;
+    deliver(delivery: TrackerOutboundDelivery, signal?: AbortSignal): Promise<TrackerOutboundReceipt>;
+}
+/** Stable failure classification safe for scheduling, diagnostics, and HTTP mapping. */
+export type TrackerProviderErrorCode = 'authentication' | 'permission' | 'invalid-configuration' | 'not-found' | 'conflict' | 'rate-limit' | 'timeout' | 'transient' | 'unsupported-capability' | 'ambiguous-acknowledgement' | 'invalid-response' | 'provider-unavailable';
+/** Normalized operational failure at the tracker-provider boundary. */
+export declare class TrackerProviderError extends Error {
+    readonly code: TrackerProviderErrorCode;
+    readonly retryAfterMs?: number | undefined;
+    /** Construct a provider-safe failure; retry delay is meaningful only for retryable codes and cannot be cancelled. */
+    constructor(code: TrackerProviderErrorCode, message: string, retryAfterMs?: number | undefined);
+}
+/** Map a provider failure code to stable operator-facing text without retaining provider-authored details. */
+export declare function publicTrackerFailureMessage(code: TrackerProviderErrorCode): string;
+export {};

package/lib/tracker/model.js

@@ -0,0 +1,66 @@
+const ID_PATTERN = /^[a-z0-9][a-z0-9._:-]{0,255}$/;
+function opaqueId(kind, value) {
+    if (!ID_PATTERN.test(value))
+        throw new TypeError(`${kind} must match ${String(ID_PATTERN)}`);
+    return value;
+}
+/** Validate and brand a provider id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export const trackerProviderId = (value) => opaqueId('tracker provider id', value);
+/** Validate and brand a binding id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export const trackerBindingId = (value) => opaqueId('tracker binding id', value);
+/** Validate and brand an issue id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export const trackerIssueId = (value) => opaqueId('tracker issue id', value);
+/** Validate and brand a comment id; throws `TypeError` for an invalid external value and has no cancellation point. */
+export const trackerCommentId = (value) => opaqueId('tracker comment id', value);
+/**
+ * Validate and brand a readiness-generation id; throws `TypeError` for an invalid external value and has no
+ * cancellation point.
+ */
+export const readinessGeneration = (value) => opaqueId('readiness generation', value);
+/** Exact provider contract version accepted by this build. */
+export const TRACKER_INTERFACE_VERSION = 2;
+/** Capabilities every provider generation must implement before registration succeeds. */
+export const trackerCapabilities = ['candidates', 'comments', 'dependencies', 'readiness', 'ingress'];
+export const trackerWriteCapabilities = ['reports', 'projections'];
+/** Normalized operational failure at the tracker-provider boundary. */
+export class TrackerProviderError extends Error {
+    code;
+    retryAfterMs;
+    /** Construct a provider-safe failure; retry delay is meaningful only for retryable codes and cannot be cancelled. */
+    constructor(code, message, retryAfterMs) {
+        super(message);
+        this.code = code;
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'TrackerProviderError';
+    }
+}
+/** Map a provider failure code to stable operator-facing text without retaining provider-authored details. */
+export function publicTrackerFailureMessage(code) {
+    switch (code) {
+        case 'authentication':
+            return 'Tracker authentication failed.';
+        case 'permission':
+            return 'Tracker access was denied.';
+        case 'invalid-configuration':
+            return 'Tracker configuration is invalid or incomplete.';
+        case 'not-found':
+            return 'A configured tracker resource was not found.';
+        case 'conflict':
+            return 'Tracker state could not be reconciled safely.';
+        case 'rate-limit':
+            return 'Tracker rate limiting deferred reconciliation.';
+        case 'timeout':
+            return 'The tracker request timed out.';
+        case 'transient':
+            return 'The tracker was temporarily unavailable.';
+        case 'unsupported-capability':
+            return 'The selected tracker does not support this operation.';
+        case 'ambiguous-acknowledgement':
+            return 'Tracker acknowledgement could not be confirmed.';
+        case 'invalid-response':
+            return 'The tracker returned an invalid or unsafe response.';
+        case 'provider-unavailable':
+            return 'The selected tracker provider is unavailable.';
+    }
+}
+//# sourceMappingURL=model.js.map

package/lib/tracker/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/tracker/model.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,GAAG,+BAA+B,CAAA;AAElD,SAAS,QAAQ,CAAmB,IAAY,EAAE,KAAa;IAC7D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,eAAe,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IAC5F,OAAO,KAAU,CAAA;AACnB,CAAC;AAED,wHAAwH;AACxH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAqB,EAAE,CACpE,QAAQ,CAAoB,qBAAqB,EAAE,KAAK,CAAC,CAAA;AAC3D,uHAAuH;AACvH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAoB,EAAE,CAClE,QAAQ,CAAmB,oBAAoB,EAAE,KAAK,CAAC,CAAA;AACzD,sHAAsH;AACtH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAkB,EAAE,CAAC,QAAQ,CAAiB,kBAAkB,EAAE,KAAK,CAAC,CAAA;AACpH,uHAAuH;AACvH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAoB,EAAE,CAClE,QAAQ,CAAmB,oBAAoB,EAAE,KAAK,CAAC,CAAA;AACzD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAuB,EAAE,CACxE,QAAQ,CAAsB,sBAAsB,EAAE,KAAK,CAAC,CAAA;AAE9D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAA;AACnD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,CAAU,CAAA;AAG9G,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,aAAa,CAAU,CAAA;AAuM3E,uEAAuE;AACvE,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAGlC,IAAI;IAEJ,YAAY;IAJvB,qHAAqH;IACrH,YACW,IAA8B,EACvC,OAAe,EACN,YAAqB;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAA;oBAJL,IAAI;4BAEJ,YAAY;QAGrB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED,8GAA8G;AAC9G,MAAM,UAAU,2BAA2B,CAAC,IAA8B;IACxE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB;YACnB,OAAO,gCAAgC,CAAA;QACzC,KAAK,YAAY;YACf,OAAO,4BAA4B,CAAA;QACrC,KAAK,uBAAuB;YAC1B,OAAO,iDAAiD,CAAA;QAC1D,KAAK,WAAW;YACd,OAAO,8CAA8C,CAAA;QACvD,KAAK,UAAU;YACb,OAAO,+CAA+C,CAAA;QACxD,KAAK,YAAY;YACf,OAAO,gDAAgD,CAAA;QACzD,KAAK,SAAS;YACZ,OAAO,gCAAgC,CAAA;QACzC,KAAK,WAAW;YACd,OAAO,0CAA0C,CAAA;QACnD,KAAK,wBAAwB;YAC3B,OAAO,uDAAuD,CAAA;QAChE,KAAK,2BAA2B;YAC9B,OAAO,iDAAiD,CAAA;QAC1D,KAAK,kBAAkB;YACrB,OAAO,qDAAqD,CAAA;QAC9D,KAAK,sBAAsB;YACzB,OAAO,+CAA+C,CAAA;IAC1D,CAAC;AACH,CAAC"}

package/lib/tracker/registry.d.ts

@@ -0,0 +1,49 @@
+import { type Context, Service } from '@deepseek-ai/cordis';
+import { type TrackerCandidatePage, type TrackerProvider, type TrackerProviderId, type TrackerProviderLifecycleEvent, type TrackerProviderRegistration, type TrackerReader, type TrackerWriter } from './model.js';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        tracker: Tracker;
+    }
+}
+/** Provider registry and normalized read seam consumed by admission. */
+export declare class Tracker extends Service {
+    private readonly lifecycleObservers;
+    private readonly providers;
+    constructor(ctx: Context);
+    /**
+     * Register one complete provider generation and synchronously publish its availability. The provider must use the
+     * current interface version, declare every required capability, and have a unique id; violations throw without
+     * changing the registry. The returned idempotent disposer stops admission to the generation, aborts and drains its
+     * active operations, removes it, then publishes unavailability. Disposer cancellation is not supported.
+     */
+    register(provider: TrackerProvider): () => Promise<void>;
+    /**
+     * Observe future provider availability changes synchronously. Registration has no replay and no cancellation point;
+     * observer failures are logged and do not block other observers. The returned idempotent function unsubscribes.
+     */
+    watchProviders(observer: (event: TrackerProviderLifecycleEvent) => void): () => void;
+    /** Return stable, secret-free metadata for every currently accepting provider generation. */
+    providerRegistrations(): readonly TrackerProviderRegistration[];
+    /**
+     * Read one validated page through the currently registered provider generation. The optional cursor must have been
+     * returned by that provider. Provider failures and withdrawal reject with `TrackerProviderError`; caller cancellation
+     * rejects with its original reason. This operation has no durable or external-write effect.
+     */
+    readCandidates(id: TrackerProviderId, cursor?: string, signal?: AbortSignal): Promise<TrackerCandidatePage>;
+    /**
+     * Retain the selected provider generation while an operation uses its reader. The provider must be available when
+     * called. Provider withdrawal aborts its reads, waits for the callback to settle, and fences late results; consumer
+     * failures are preserved. Effects performed by the callback are caller-owned and must occur only after awaited reader
+     * operations succeed. `withProvider` itself has no independent caller-cancellation input.
+     */
+    withProvider<T>(id: TrackerProviderId, operation: (reader: TrackerReader) => Promise<T>): Promise<T>;
+    /** Retain one write-capable provider generation while a durable delivery owner reconciles and applies its intent. */
+    withWriter<T>(id: TrackerProviderId, operation: (writer: TrackerWriter) => Promise<T>): Promise<T>;
+    private readProviderCandidates;
+    private verifyProviderIngress;
+    private reconcileProviderDelivery;
+    private deliverProviderIntent;
+    private invokeWrite;
+    private notifyProviderLifecycle;
+}
+export default Tracker;

package/lib/tracker/registry.js

@@ -0,0 +1,213 @@
+import { Service } from '@deepseek-ai/cordis';
+import { GenerationRegistry } from '../providers/generation-registry.js';
+import { TRACKER_INTERFACE_VERSION, TrackerProviderError, trackerCapabilities, trackerWriteCapabilities, } from './model.js';
+import { candidatePageSchema, deliveryObservationSchema, ingressDeliverySchema, outboundReceiptSchema, } from './validation.js';
+/** Provider registry and normalized read seam consumed by admission. */
+export class Tracker extends Service {
+    lifecycleObservers = new Set();
+    providers = new GenerationRegistry((providerId) => this.notifyProviderLifecycle({ kind: 'available', providerId }), (providerId) => this.notifyProviderLifecycle({ kind: 'unavailable', providerId }));
+    constructor(ctx) {
+        super(ctx, 'tracker');
+    }
+    /**
+     * Register one complete provider generation and synchronously publish its availability. The provider must use the
+     * current interface version, declare every required capability, and have a unique id; violations throw without
+     * changing the registry. The returned idempotent disposer stops admission to the generation, aborts and drains its
+     * active operations, removes it, then publishes unavailability. Disposer cancellation is not supported.
+     */
+    register(provider) {
+        if (provider.interfaceVersion !== TRACKER_INTERFACE_VERSION) {
+            throw new TypeError(`tracker provider "${provider.id}" uses interface version ${String(provider.interfaceVersion)}; expected ${String(TRACKER_INTERFACE_VERSION)}`);
+        }
+        if (this.providers.has(provider.id))
+            throw new Error(`tracker provider "${provider.id}" is already registered`);
+        const missing = trackerCapabilities.filter((capability) => !provider.capabilities.includes(capability));
+        if (missing.length > 0) {
+            throw new TypeError(`tracker provider "${provider.id}" is missing capabilities: ${missing.join(', ')}`);
+        }
+        const writes = trackerWriteCapabilities.filter((capability) => provider.capabilities.includes(capability));
+        if (writes.length > 0 &&
+            (writes.length !== trackerWriteCapabilities.length ||
+                provider.reconcileDelivery === undefined ||
+                provider.deliver === undefined)) {
+            throw new TypeError(`tracker provider "${provider.id}" must implement reports and projections together`);
+        }
+        return this.providers.register(provider.id, provider);
+    }
+    /**
+     * Observe future provider availability changes synchronously. Registration has no replay and no cancellation point;
+     * observer failures are logged and do not block other observers. The returned idempotent function unsubscribes.
+     */
+    watchProviders(observer) {
+        this.lifecycleObservers.add(observer);
+        return () => {
+            this.lifecycleObservers.delete(observer);
+        };
+    }
+    /** Return stable, secret-free metadata for every currently accepting provider generation. */
+    providerRegistrations() {
+        return [...this.providers.values()]
+            .filter((registered) => registered.accepting)
+            .map(({ provider }) => ({
+            id: provider.id,
+            displayName: provider.displayName,
+            configurationNamespace: provider.configurationNamespace,
+            capabilities: [...provider.capabilities],
+        }))
+            .sort((left, right) => left.displayName.localeCompare(right.displayName) || left.id.localeCompare(right.id));
+    }
+    /**
+     * Read one validated page through the currently registered provider generation. The optional cursor must have been
+     * returned by that provider. Provider failures and withdrawal reject with `TrackerProviderError`; caller cancellation
+     * rejects with its original reason. This operation has no durable or external-write effect.
+     */
+    async readCandidates(id, cursor, signal) {
+        return this.withProvider(id, (reader) => reader.readCandidates(cursor, signal));
+    }
+    /**
+     * Retain the selected provider generation while an operation uses its reader. The provider must be available when
+     * called. Provider withdrawal aborts its reads, waits for the callback to settle, and fences late results; consumer
+     * failures are preserved. Effects performed by the callback are caller-owned and must occur only after awaited reader
+     * operations succeed. `withProvider` itself has no independent caller-cancellation input.
+     */
+    async withProvider(id, operation) {
+        const registered = this.providers.require(id, () => new TrackerProviderError('provider-unavailable', `tracker provider "${id}" is unavailable`));
+        const reader = {
+            readCandidates: (cursor, signal) => this.readProviderCandidates(registered, cursor, signal),
+            verifyIngress: (request, signal) => this.verifyProviderIngress(registered, request, signal),
+        };
+        return await this.providers.retain(registered, () => operation(reader));
+    }
+    /** Retain one write-capable provider generation while a durable delivery owner reconciles and applies its intent. */
+    async withWriter(id, operation) {
+        const registered = this.providers.require(id, () => new TrackerProviderError('provider-unavailable', `tracker provider "${id}" is unavailable`));
+        if (!registered.accepting ||
+            registered.provider.reconcileDelivery === undefined ||
+            registered.provider.deliver === undefined ||
+            !trackerWriteCapabilities.every((capability) => registered.provider.capabilities.includes(capability))) {
+            throw new TrackerProviderError('unsupported-capability', `tracker provider "${id}" has no outbound delivery seam`);
+        }
+        const writer = {
+            reconcileDelivery: (delivery, signal) => this.reconcileProviderDelivery(registered, delivery, signal),
+            deliver: (delivery, signal) => this.deliverProviderIntent(registered, delivery, signal),
+        };
+        return await this.providers.retain(registered, () => operation(writer));
+    }
+    async readProviderCandidates(registered, cursor, callerSignal) {
+        callerSignal?.throwIfAborted();
+        const request = {
+            signal: this.providers.signal(registered, callerSignal),
+            ...(cursor === undefined ? {} : { cursor }),
+        };
+        let page;
+        try {
+            page = await registered.provider.readCandidates(request);
+        }
+        catch (error) {
+            if (!registered.accepting) {
+                throw new TrackerProviderError('provider-unavailable', `tracker provider "${registered.provider.id}" was withdrawn`);
+            }
+            callerSignal?.throwIfAborted();
+            if (error instanceof TrackerProviderError)
+                throw error;
+            throw new TrackerProviderError('transient', `tracker provider "${registered.provider.id}" failed to read candidates`);
+        }
+        if (!registered.accepting) {
+            throw new TrackerProviderError('provider-unavailable', `tracker provider "${registered.provider.id}" was withdrawn`);
+        }
+        callerSignal?.throwIfAborted();
+        const parsed = candidatePageSchema.safeParse(page);
+        if (!parsed.success) {
+            throw new TrackerProviderError('invalid-response', `tracker provider "${registered.provider.id}" returned an invalid candidate page`);
+        }
+        return {
+            issues: parsed.data.issues,
+            ...(parsed.data.nextCursor === undefined ? {} : { nextCursor: parsed.data.nextCursor }),
+        };
+    }
+    async verifyProviderIngress(registered, request, callerSignal) {
+        callerSignal?.throwIfAborted();
+        let delivery;
+        try {
+            delivery = await registered.provider.verifyIngress({
+                method: request.method,
+                headers: request.headers.map((header) => ({ ...header })),
+                body: request.body.slice(),
+                signal: this.providers.signal(registered, callerSignal),
+            });
+        }
+        catch (error) {
+            if (!registered.accepting) {
+                throw new TrackerProviderError('provider-unavailable', `tracker provider "${registered.provider.id}" was withdrawn`);
+            }
+            callerSignal?.throwIfAborted();
+            if (error instanceof TrackerProviderError)
+                throw error;
+            throw new TrackerProviderError('transient', `tracker provider "${registered.provider.id}" failed to verify ingress`);
+        }
+        if (!registered.accepting) {
+            throw new TrackerProviderError('provider-unavailable', `tracker provider "${registered.provider.id}" was withdrawn`);
+        }
+        callerSignal?.throwIfAborted();
+        const parsed = ingressDeliverySchema.safeParse(delivery);
+        if (!parsed.success || !parsed.data.deliveryId.startsWith(`${registered.provider.id}:`)) {
+            throw new TrackerProviderError('invalid-response', `tracker provider "${registered.provider.id}" returned an invalid ingress delivery`);
+        }
+        return parsed.data;
+    }
+    async reconcileProviderDelivery(registered, delivery, callerSignal) {
+        const value = await this.invokeWrite(registered, 'reconcileDelivery', delivery, callerSignal);
+        const parsed = deliveryObservationSchema.safeParse(value);
+        if (!parsed.success) {
+            throw new TrackerProviderError('invalid-response', 'tracker provider returned an invalid delivery observation');
+        }
+        return parsed.data;
+    }
+    async deliverProviderIntent(registered, delivery, callerSignal) {
+        const value = await this.invokeWrite(registered, 'deliver', delivery, callerSignal);
+        const parsed = outboundReceiptSchema.safeParse(value);
+        if (!parsed.success)
+            throw new TrackerProviderError('invalid-response', 'tracker provider returned an invalid receipt');
+        return parsed.data;
+    }
+    async invokeWrite(registered, operation, delivery, callerSignal) {
+        callerSignal?.throwIfAborted();
+        try {
+            const request = {
+                delivery: structuredClone(delivery),
+                signal: this.providers.signal(registered, callerSignal),
+            };
+            const value = operation === 'reconcileDelivery'
+                ? await registered.provider.reconcileDelivery?.(request)
+                : await registered.provider.deliver?.(request);
+            if (value === undefined)
+                throw new TrackerProviderError('unsupported-capability', 'tracker write is unavailable');
+            if (!registered.accepting) {
+                throw new TrackerProviderError(operation === 'deliver' ? 'ambiguous-acknowledgement' : 'provider-unavailable', `tracker provider "${registered.provider.id}" was withdrawn`);
+            }
+            callerSignal?.throwIfAborted();
+            return value;
+        }
+        catch (error) {
+            if (!registered.accepting) {
+                throw new TrackerProviderError(operation === 'deliver' ? 'ambiguous-acknowledgement' : 'provider-unavailable', `tracker provider "${registered.provider.id}" was withdrawn`);
+            }
+            callerSignal?.throwIfAborted();
+            if (error instanceof TrackerProviderError)
+                throw error;
+            throw new TrackerProviderError('transient', `tracker provider "${registered.provider.id}" failed outbound delivery`);
+        }
+    }
+    notifyProviderLifecycle(event) {
+        for (const observer of [...this.lifecycleObservers]) {
+            try {
+                observer(event);
+            }
+            catch {
+                this.ctx.logger.warn('autopilot tracker provider lifecycle observer failed');
+            }
+        }
+    }
+}
+export default Tracker;
+//# sourceMappingURL=registry.js.map

package/lib/tracker/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tracker/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAA2B,MAAM,qCAAqC,CAAA;AACjG,OAAO,EACL,yBAAyB,EAQzB,oBAAoB,EAOpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AAQxB,wEAAwE;AACxE,MAAM,OAAO,OAAQ,SAAQ,OAAO;IACjB,kBAAkB,GAAG,IAAI,GAAG,EAAkD,CAAA;IAC9E,SAAS,GAAG,IAAI,kBAAkB,CACjD,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,EAC/E,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAClF,CAAA;IAED,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IACvB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAyB;QAChC,IAAI,QAAQ,CAAC,gBAAgB,KAAK,yBAAyB,EAAE,CAAC;YAC5D,MAAM,IAAI,SAAS,CACjB,qBAAqB,QAAQ,CAAC,EAAE,4BAA4B,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,cAAc,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAC/I,CAAA;QACH,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,EAAE,yBAAyB,CAAC,CAAA;QAC/G,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QACvG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,SAAS,CAAC,qBAAqB,QAAQ,CAAC,EAAE,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzG,CAAC;QACD,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QAC1G,IACE,MAAM,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,MAAM,CAAC,MAAM,KAAK,wBAAwB,CAAC,MAAM;gBAChD,QAAQ,CAAC,iBAAiB,KAAK,SAAS;gBACxC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,EACjC,CAAC;YACD,MAAM,IAAI,SAAS,CAAC,qBAAqB,QAAQ,CAAC,EAAE,mDAAmD,CAAC,CAAA;QAC1G,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IACvD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,QAAwD;QACrE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACrC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC1C,CAAC,CAAA;IACH,CAAC;IAED,6FAA6F;IAC7F,qBAAqB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aAChC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;aAC5C,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACtB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;YACvD,YAAY,EAAE,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC;SACzC,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IAChH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,EAAqB,EAAE,MAAe,EAAE,MAAoB;QAC/E,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAI,EAAqB,EAAE,SAAgD;QAC3F,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC,sBAAsB,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,CAClG,CAAA;QACD,MAAM,MAAM,GAAkB;YAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC;YAC3F,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;SAC5F,CAAA;QACD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IACzE,CAAC;IAED,qHAAqH;IACrH,KAAK,CAAC,UAAU,CAAI,EAAqB,EAAE,SAAgD;QACzF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC,sBAAsB,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,CAClG,CAAA;QACD,IACE,CAAC,UAAU,CAAC,SAAS;YACrB,UAAU,CAAC,QAAQ,CAAC,iBAAiB,KAAK,SAAS;YACnD,UAAU,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS;YACzC,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EACtG,CAAC;YACD,MAAM,IAAI,oBAAoB,CAAC,wBAAwB,EAAE,qBAAqB,EAAE,iCAAiC,CAAC,CAAA;QACpH,CAAC;QACD,MAAM,MAAM,GAAkB;YAC5B,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC;YACrG,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC;SACxF,CAAA;QACD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IACzE,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,UAA+C,EAC/C,MAAe,EACf,YAA0B;QAE1B,YAAY,EAAE,cAAc,EAAE,CAAA;QAC9B,MAAM,OAAO,GAAuB;YAClC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC;YACvD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;SAC5C,CAAA;QACD,IAAI,IAA0B,CAAA;QAC9B,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAC7D,CAAA;YACH,CAAC;YACD,YAAY,EAAE,cAAc,EAAE,CAAA;YAC9B,IAAI,KAAK,YAAY,oBAAoB;gBAAE,MAAM,KAAK,CAAA;YACtD,MAAM,IAAI,oBAAoB,CAC5B,WAAW,EACX,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CACzE,CAAA;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAC7D,CAAA;QACH,CAAC;QACD,YAAY,EAAE,cAAc,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAC5B,kBAAkB,EAClB,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,sCAAsC,CAClF,CAAA;QACH,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YAC1B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;SACxF,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,UAA+C,EAC/C,OAA8B,EAC9B,YAA0B;QAE1B,YAAY,EAAE,cAAc,EAAE,CAAA;QAC9B,IAAI,QAAgC,CAAA;QACpC,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACjD,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;gBACzD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE;gBAC1B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC;aACxD,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAC7D,CAAA;YACH,CAAC;YACD,YAAY,EAAE,cAAc,EAAE,CAAA;YAC9B,IAAI,KAAK,YAAY,oBAAoB;gBAAE,MAAM,KAAK,CAAA;YACtD,MAAM,IAAI,oBAAoB,CAC5B,WAAW,EACX,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,4BAA4B,CACxE,CAAA;QACH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,oBAAoB,CAC5B,sBAAsB,EACtB,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAC7D,CAAA;QACH,CAAC;QACD,YAAY,EAAE,cAAc,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACxD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,oBAAoB,CAC5B,kBAAkB,EAClB,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,wCAAwC,CACpF,CAAA;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC;IAEO,KAAK,CAAC,yBAAyB,CACrC,UAA+C,EAC/C,QAAiC,EACjC,YAA0B;QAE1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAA;QAC7F,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAAC,kBAAkB,EAAE,2DAA2D,CAAC,CAAA;QACjH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,UAA+C,EAC/C,QAAiC,EACjC,YAA0B;QAE1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAA;QACnF,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACrD,IAAI,CAAC,MAAM,CAAC,OAAO;YACjB,MAAM,IAAI,oBAAoB,CAAC,kBAAkB,EAAE,8CAA8C,CAAC,CAAA;QACpG,OAAO,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,UAA+C,EAC/C,SAA0C,EAC1C,QAAiC,EACjC,YAA0B;QAE1B,YAAY,EAAE,cAAc,EAAE,CAAA;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG;gBACd,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC;gBACnC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC;aACxD,CAAA;YACD,MAAM,KAAK,GACT,SAAS,KAAK,mBAAmB;gBAC/B,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC;gBACxD,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAA;YAClD,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,IAAI,oBAAoB,CAAC,wBAAwB,EAAE,8BAA8B,CAAC,CAAA;YACjH,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,oBAAoB,CAC5B,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,sBAAsB,EAC9E,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAC7D,CAAA;YACH,CAAC;YACD,YAAY,EAAE,cAAc,EAAE,CAAA;YAC9B,OAAO,KAAK,CAAA;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,oBAAoB,CAC5B,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,sBAAsB,EAC9E,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAC7D,CAAA;YACH,CAAC;YACD,YAAY,EAAE,cAAc,EAAE,CAAA;YAC9B,IAAI,KAAK,YAAY,oBAAoB;gBAAE,MAAM,KAAK,CAAA;YACtD,MAAM,IAAI,oBAAoB,CAC5B,WAAW,EACX,qBAAqB,UAAU,CAAC,QAAQ,CAAC,EAAE,4BAA4B,CACxE,CAAA;QACH,CAAC;IACH,CAAC;IAEO,uBAAuB,CAAC,KAAoC;QAClE,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAA;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAA;YAC9E,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,eAAe,OAAO,CAAA"}

package/lib/tracker/validation.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+export declare const candidatePageSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodPipe<z.ZodString, z.ZodTransform<import("./model.js").TrackerBindingId, string>>;
+        issueId: z.ZodPipe<z.ZodString, z.ZodTransform<import("./model.js").TrackerIssueId, string>>;
+        displayKey: z.ZodString;
+        summary: z.ZodString;
+        priorityRank: z.ZodNumber;
+        isReady: z.ZodBoolean;
+        labels: z.ZodArray<z.ZodString>;
+        comments: z.ZodArray<z.ZodObject<{
+            id: z.ZodPipe<z.ZodString, z.ZodTransform<import("./model.js").TrackerCommentId, string>>;
+            authorId: z.ZodString;
+            body: z.ZodString;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        dependencies: z.ZodArray<z.ZodObject<{
+            issueId: z.ZodPipe<z.ZodString, z.ZodTransform<import("./model.js").TrackerIssueId, string>>;
+            displayKey: z.ZodString;
+            state: z.ZodEnum<{
+                completed: "completed";
+                "not-completed": "not-completed";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strip>>;
+        readiness: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"absent">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"transition">;
+            generation: z.ZodPipe<z.ZodString, z.ZodTransform<import("./model.js").ReadinessGeneration, string>>;
+            actorId: z.ZodString;
+            actorKind: z.ZodEnum<{
+                automation: "automation";
+                human: "human";
+                unknown: "unknown";
+            }>;
+            occurredAt: z.ZodISODateTime;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ingressDeliverySchema: z.ZodObject<{
+    deliveryId: z.ZodString;
+}, z.core.$strip>;
+export declare const outboundReceiptSchema: z.ZodObject<{
+    receiptId: z.ZodString;
+    receivedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export declare const deliveryObservationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"missing">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"delivered">;
+    receipt: z.ZodObject<{
+        receiptId: z.ZodString;
+        receivedAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"conflict">;
+    reason: z.ZodString;
+}, z.core.$strip>], "kind">;