@bosun-sh/logbook 1.0.0 → 2.0.0

package/dist/sync/linear/transport.js

@@ -0,0 +1,249 @@
+import { Effect } from "effect";
+const LINEAR_PROVIDER_ID = "linear";
+const DEFAULT_ENDPOINT = "https://api.linear.app/graphql";
+const DEFAULT_TIMEOUT_MS = 10_000;
+const DEFAULT_RETRY_ATTEMPTS = 3;
+const DEFAULT_BACKOFF_MS = 250;
+const MAX_BODY_BYTES = 1_048_576;
+const MAX_GRAPHQL_ERRORS = 20;
+const textEncoder = new TextEncoder();
+export const LinearTransport = {
+    make: (options) => makeLinearGraphQLClient(options),
+    fixture: (fixtures) => makeLinearGraphQLClient({
+        apiToken: "fixture-token",
+        fetch: fixtureFetch(fixtures),
+        backoffMs: 0,
+    }),
+};
+const makeLinearGraphQLClient = (options) => ({
+    request: (request) => Effect.gen(function* () {
+        const apiToken = options.apiToken.trim();
+        if (apiToken.length === 0) {
+            return yield* Effect.fail(providerError("auth_failed", false, "Linear API token is required.", {
+                provider: LINEAR_PROVIDER_ID,
+                reason: "missing_token",
+            }));
+        }
+        return yield* requestWithRetry(request, apiToken, options);
+    }),
+});
+const requestWithRetry = (request, apiToken, options) => Effect.gen(function* () {
+    const retryAttempts = options.retryAttempts ?? DEFAULT_RETRY_ATTEMPTS;
+    const backoffMs = options.backoffMs ?? DEFAULT_BACKOFF_MS;
+    let attempt = 1;
+    while (attempt <= retryAttempts) {
+        const result = yield* Effect.either(executeRequest(request, apiToken, options, attempt));
+        if (result._tag === "Right") {
+            return result.right;
+        }
+        if (!shouldRetry(result.left) || attempt >= retryAttempts) {
+            return yield* Effect.fail(result.left);
+        }
+        if (backoffMs > 0) {
+            yield* Effect.sleep(backoffMs * 2 ** (attempt - 1));
+        }
+        attempt += 1;
+    }
+    return yield* Effect.fail(providerError("unknown", false, "Linear request failed without a final attempt.", {
+        provider: LINEAR_PROVIDER_ID,
+        reason: "unknown",
+    }));
+});
+const executeRequest = (request, apiToken, options, attempt) => Effect.tryPromise({
+    try: async () => {
+        const response = await fetchWithTimeout(request, apiToken, options);
+        return await parseResponse(response, attempt);
+    },
+    catch: (error) => mapThrownError(error, options.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+});
+const fetchWithTimeout = async (request, apiToken, options) => {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    const fetchImpl = options.fetch ?? fetch;
+    try {
+        return await fetchImpl(options.endpoint ?? DEFAULT_ENDPOINT, {
+            method: "POST",
+            headers: {
+                authorization: apiToken,
+                "content-type": "application/json",
+            },
+            body: JSON.stringify({
+                query: request.query,
+                operationName: request.operationName,
+                variables: request.variables ?? {},
+            }),
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+};
+const parseResponse = async (response, attempt) => {
+    if (response.status === 401 || response.status === 403) {
+        throw providerError("auth_failed", false, "Linear authentication failed.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "auth",
+            status: response.status,
+        });
+    }
+    if (response.status === 429) {
+        throw providerError("rate_limited", true, "Linear rate limit was reached.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "rate_limited",
+            retryAfterMs: retryAfterMs(response.headers.get("retry-after")),
+        });
+    }
+    if (response.status >= 500) {
+        throw providerError("network_error", true, "Linear returned a retryable HTTP failure.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "retryable_http",
+            status: response.status,
+            attempts: attempt,
+        });
+    }
+    if (response.status < 200 || response.status >= 300) {
+        throw providerError("unknown", false, "Linear returned an HTTP failure.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "http",
+            status: response.status,
+        });
+    }
+    const text = await response.text();
+    if (byteLength(text) > MAX_BODY_BYTES) {
+        throw providerError("unknown", false, "Linear response exceeded the GraphQL body byte limit.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "malformed_response",
+            maxBytes: MAX_BODY_BYTES,
+        });
+    }
+    const parsed = parseJsonObject(text);
+    const errors = Array.isArray(parsed.errors) ? parsed.errors : undefined;
+    if (errors !== undefined && errors.length > 0) {
+        throw providerError("validation_failed", false, "Linear returned GraphQL errors.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "graphql",
+            errors: summarizeGraphqlErrors(errors),
+            ...(errors.length > MAX_GRAPHQL_ERRORS ? { truncated: true } : {}),
+        });
+    }
+    if (!isRecord(parsed.data)) {
+        throw providerError("unknown", false, "Linear returned a malformed GraphQL response.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "malformed_response",
+        });
+    }
+    return parsed.data;
+};
+const fixtureFetch = (fixtures) => async (_input, init) => {
+    const request = parseFixtureRequest(init.body);
+    const fixture = fixtures.find((candidate) => fixtureMatches(candidate, request));
+    if (fixture === undefined) {
+        return new Response(JSON.stringify({
+            errors: [{ message: `No Linear fixture matched operation ${request.operationName}` }],
+        }), { status: 200 });
+    }
+    if ("networkError" in fixture.response) {
+        if (fixture.response.networkError === "timeout") {
+            throw providerError("timeout", true, "Linear request timed out.", {
+                provider: LINEAR_PROVIDER_ID,
+                reason: "timeout",
+                timeoutMs: DEFAULT_TIMEOUT_MS,
+            });
+        }
+        throw providerError("network_error", true, "Linear network connection reset.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "connection_reset",
+        });
+    }
+    return new Response(JSON.stringify(fixture.response.body), fixture.response.headers === undefined
+        ? { status: fixture.response.status }
+        : { status: fixture.response.status, headers: fixture.response.headers });
+};
+const parseFixtureRequest = (body) => {
+    if (typeof body !== "string") {
+        return { operationName: "", query: "" };
+    }
+    const parsed = JSON.parse(body);
+    return {
+        operationName: typeof parsed.operationName === "string" ? parsed.operationName : "",
+        query: typeof parsed.query === "string" ? parsed.query : "",
+        variables: isRecord(parsed.variables) ? parsed.variables : {},
+    };
+};
+const fixtureMatches = (fixture, request) => {
+    if (fixture.request.operationName !== request.operationName) {
+        return false;
+    }
+    const requiredVariables = fixture.request.variables ?? {};
+    const actualVariables = request.variables ?? {};
+    return Object.entries(requiredVariables).every(([key, value]) => deepEqual(actualVariables[key], value));
+};
+const mapThrownError = (error, timeoutMs) => {
+    if (isProviderError(error)) {
+        return error;
+    }
+    if (error instanceof Error && error.name === "AbortError") {
+        return providerError("timeout", true, "Linear request timed out.", {
+            provider: LINEAR_PROVIDER_ID,
+            reason: "timeout",
+            timeoutMs,
+        });
+    }
+    return providerError("network_error", true, "Linear network request failed.", {
+        provider: LINEAR_PROVIDER_ID,
+        reason: "network_error",
+    });
+};
+const shouldRetry = (error) => error.retryable && (error.code === "network_error" || error.code === "timeout");
+const providerError = (code, retryable, message, details) => ({
+    providerId: LINEAR_PROVIDER_ID,
+    code,
+    retryable,
+    message,
+    details,
+});
+const isProviderError = (value) => isRecord(value) &&
+    value.providerId === LINEAR_PROVIDER_ID &&
+    typeof value.code === "string" &&
+    typeof value.retryable === "boolean" &&
+    typeof value.message === "string";
+const retryAfterMs = (value) => {
+    if (value === null) {
+        return undefined;
+    }
+    const seconds = Number(value);
+    return Number.isFinite(seconds) && seconds >= 0 ? seconds * 1000 : undefined;
+};
+const summarizeGraphqlErrors = (errors) => errors.slice(0, MAX_GRAPHQL_ERRORS).map((error) => {
+    if (!isRecord(error)) {
+        return { message: "Unknown GraphQL error" };
+    }
+    const extensions = isRecord(error.extensions) ? error.extensions : undefined;
+    const code = typeof extensions?.code === "string" ? extensions.code : undefined;
+    return {
+        message: typeof error.message === "string" ? error.message : "Unknown GraphQL error",
+        ...(Array.isArray(error.path) ? { path: error.path } : {}),
+        ...(code === undefined ? {} : { extensions: { code } }),
+    };
+});
+const parseJsonObject = (text) => {
+    try {
+        const parsed = JSON.parse(text);
+        if (isRecord(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // Fall through to the bounded malformed response error below.
+    }
+    throw providerError("unknown", false, "Linear returned malformed JSON.", {
+        provider: LINEAR_PROVIDER_ID,
+        reason: "malformed_response",
+    });
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const byteLength = (value) => textEncoder.encode(value).length;
+const deepEqual = (left, right) => left === right || JSON.stringify(left) === JSON.stringify(right);
+//# sourceMappingURL=transport.js.map

package/dist/sync/linear/transport.js.map

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

package/dist/sync/provider-port.d.ts

@@ -0,0 +1,81 @@
+import type { SyncEvent } from "../sync/schema.js";
+import type { Effect } from "effect";
+export declare const DEFAULT_PROVIDER_RETRY_ATTEMPTS = 3;
+export type SyncProviderId = "linear" | string;
+export type SyncCursor = {
+    readonly providerId: SyncProviderId;
+    readonly cursor: string;
+    readonly pageSize: number;
+};
+export type SyncProviderError = {
+    readonly providerId: SyncProviderId;
+    readonly code: "auth_failed" | "rate_limited" | "network_error" | "timeout" | "not_found" | "validation_failed" | "remote_conflict" | "unknown";
+    readonly retryable: boolean;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+};
+export type SyncRetryClassification = {
+    readonly retryable: true;
+    readonly retryAfterMs?: number;
+    readonly maxAttempts: number;
+} | {
+    readonly retryable: false;
+};
+export type SyncPullInput = {
+    readonly since?: string;
+    readonly teamId?: string;
+    readonly projectId?: string;
+    readonly limit?: number;
+    readonly cursor?: SyncCursor;
+    readonly dryRun: boolean;
+};
+export type SyncPushInput = {
+    readonly taskIds?: readonly string[];
+    readonly epicIds?: readonly string[];
+    readonly storyIds?: readonly string[];
+    readonly teamId?: string;
+    readonly projectId?: string;
+    readonly dryRun: boolean;
+};
+export type SyncStatusInput = {
+    readonly checkProvider: boolean;
+};
+export type SyncPullResult = {
+    readonly imported: number;
+    readonly updated: number;
+    readonly skipped: number;
+    readonly conflicts: number;
+    readonly events: readonly SyncEvent[];
+    readonly nextCursor?: SyncCursor;
+};
+export type SyncPushResult = {
+    readonly created: number;
+    readonly updated: number;
+    readonly skipped: number;
+    readonly conflicts: number;
+    readonly events: readonly SyncEvent[];
+};
+type ToolWarning = {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+};
+export type SyncProviderStatus = {
+    readonly providerId: SyncProviderId;
+    readonly configured: boolean;
+    readonly reachable?: boolean;
+    readonly authenticated?: boolean;
+    readonly pendingConflicts: number;
+    readonly lastSyncAt?: string;
+    readonly warnings?: readonly ToolWarning[];
+};
+export interface SyncProviderPort {
+    readonly providerId: SyncProviderId;
+    pull(input: SyncPullInput): Effect.Effect<SyncPullResult, SyncProviderError>;
+    push(input: SyncPushInput): Effect.Effect<SyncPushResult, SyncProviderError>;
+    status(input: SyncStatusInput): Effect.Effect<SyncProviderStatus, SyncProviderError>;
+    classifyRetry(error: SyncProviderError): SyncRetryClassification;
+}
+export declare const classifySyncRetry: (error: SyncProviderError) => SyncRetryClassification;
+export {};
+//# sourceMappingURL=provider-port.d.ts.map

package/dist/sync/provider-port.d.ts.map

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

package/dist/sync/provider-port.js

@@ -0,0 +1,16 @@
+export const DEFAULT_PROVIDER_RETRY_ATTEMPTS = 3;
+export const classifySyncRetry = (error) => {
+    if (!error.retryable || !isRetryableTransportCode(error.code)) {
+        return { retryable: false };
+    }
+    const retryAfterMs = readRetryAfterMs(error.details);
+    return retryAfterMs === undefined
+        ? { retryable: true, maxAttempts: DEFAULT_PROVIDER_RETRY_ATTEMPTS }
+        : { retryable: true, retryAfterMs, maxAttempts: DEFAULT_PROVIDER_RETRY_ATTEMPTS };
+};
+const isRetryableTransportCode = (code) => code === "rate_limited" || code === "network_error" || code === "timeout" || code === "unknown";
+const readRetryAfterMs = (details) => {
+    const value = details?.retryAfterMs;
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
+};
+//# sourceMappingURL=provider-port.js.map

package/dist/sync/provider-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-port.js","sourceRoot":"","sources":["../../src/sync/provider-port.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAA;AA6FhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAwB,EAA2B,EAAE;IACrF,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IAC7B,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpD,OAAO,YAAY,KAAK,SAAS;QAC/B,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,+BAA+B,EAAE;QACnE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAA;AACrF,CAAC,CAAA;AAED,MAAM,wBAAwB,GAAG,CAAC,IAA+B,EAAW,EAAE,CAC5E,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,CAAA;AAEjG,MAAM,gBAAgB,GAAG,CAAC,OAA4C,EAAsB,EAAE;IAC5F,MAAM,KAAK,GAAG,OAAO,EAAE,YAAY,CAAA;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9F,CAAC,CAAA"}

package/dist/sync/provider-registry.d.ts

@@ -0,0 +1,38 @@
+type ProviderRegistration = {
+    readonly provider: string;
+    readonly config: Record<string, unknown>;
+    readonly healthTimeoutMs: number;
+};
+export type SyncProviderRegistrySnapshot = {
+    readonly config: Record<string, Record<string, unknown>>;
+    readonly providers: readonly ProviderRegistration[];
+};
+export declare class SyncProviderRegistry {
+    #private;
+    constructor(providers?: readonly ProviderRegistration[]);
+    list(): readonly ProviderRegistration[];
+    snapshot(): SyncProviderRegistrySnapshot;
+    healthTimeoutWarning(provider: string, elapsedMs: number): {
+        readonly code: "provider_warning";
+        readonly message: string;
+        readonly details: {
+            readonly provider: string;
+            readonly elapsedMs: number;
+            readonly timeoutMs: number;
+        };
+    } | undefined;
+    withProvider(provider: ProviderRegistration): SyncProviderRegistry;
+    static readonly bounds: {
+        readonly maxProviderRegistrations: 10;
+        readonly providerConfigJsonBytes: 65536;
+        readonly providerHealthTimeoutMs: 5000;
+    };
+}
+type RegisterSyncProviderInput = {
+    readonly provider: string;
+    readonly config: Record<string, unknown>;
+    readonly healthTimeoutMs?: number | undefined;
+};
+export declare const registerSyncProvider: (registry: SyncProviderRegistry, input: RegisterSyncProviderInput) => SyncProviderRegistry;
+export {};
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/sync/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/sync/provider-registry.ts"],"names":[],"mappings":"AAKA,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACpD,CAAA;AAED,qBAAa,oBAAoB;;gBAGnB,SAAS,GAAE,SAAS,oBAAoB,EAAO;IAI3D,IAAI,IAAI,SAAS,oBAAoB,EAAE;IAIvC,QAAQ,IAAI,4BAA4B;IASxC,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAEf;QACE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;QACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,OAAO,EAAE;YAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;YACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;YAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;SAC3B,CAAA;KACF,GACD,SAAS;IAiBb,YAAY,CAAC,QAAQ,EAAE,oBAAoB,GAAG,oBAAoB;IAIlE,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;MAIZ;CACX;AAED,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,UAAU,oBAAoB,EAC9B,OAAO,yBAAyB,KAC/B,oBAyCF,CAAA"}

package/dist/sync/provider-registry.js

@@ -0,0 +1,115 @@
+const MAX_PROVIDER_REGISTRATIONS = 10;
+const MAX_PROVIDER_CONFIG_JSON_BYTES = 65_536;
+const DEFAULT_PROVIDER_HEALTH_TIMEOUT_MS = 5_000;
+const textEncoder = new TextEncoder();
+export class SyncProviderRegistry {
+    #providers;
+    constructor(providers = []) {
+        this.#providers = [...providers];
+    }
+    list() {
+        return this.#providers.map(cloneProviderRegistration);
+    }
+    snapshot() {
+        return {
+            config: Object.fromEntries(this.#providers.map((provider) => [provider.provider, cloneConfig(provider.config)])),
+            providers: this.list(),
+        };
+    }
+    healthTimeoutWarning(provider, elapsedMs) {
+        const registration = this.#providers.find((entry) => entry.provider === provider);
+        if (registration === undefined || elapsedMs < registration.healthTimeoutMs) {
+            return undefined;
+        }
+        return {
+            code: "provider_warning",
+            message: "Provider health check exceeded the timeout.",
+            details: {
+                provider,
+                elapsedMs,
+                timeoutMs: registration.healthTimeoutMs,
+            },
+        };
+    }
+    withProvider(provider) {
+        return new SyncProviderRegistry([...this.#providers, cloneProviderRegistration(provider)]);
+    }
+    static bounds = {
+        maxProviderRegistrations: MAX_PROVIDER_REGISTRATIONS,
+        providerConfigJsonBytes: MAX_PROVIDER_CONFIG_JSON_BYTES,
+        providerHealthTimeoutMs: DEFAULT_PROVIDER_HEALTH_TIMEOUT_MS,
+    };
+}
+export const registerSyncProvider = (registry, input) => {
+    validateProviderRegistrationInput(input);
+    const existing = registry.snapshot().config[input.provider];
+    if (existing !== undefined) {
+        throw registrationError(`duplicate provider registered: ${input.provider}`, {
+            provider: input.provider,
+        });
+    }
+    const providerCount = registry.list().length;
+    if (providerCount >= MAX_PROVIDER_REGISTRATIONS) {
+        throw registrationError(`registered providers exceed ${MAX_PROVIDER_REGISTRATIONS}`, {
+            provider: input.provider,
+            maxProviders: MAX_PROVIDER_REGISTRATIONS,
+            registeredProviders: providerCount,
+        });
+    }
+    const healthTimeoutMs = input.healthTimeoutMs ?? DEFAULT_PROVIDER_HEALTH_TIMEOUT_MS;
+    if (!Number.isInteger(healthTimeoutMs) || healthTimeoutMs <= 0) {
+        throw validationFailure("provider health timeout must be a positive integer", {
+            provider: input.provider,
+            healthTimeoutMs,
+        });
+    }
+    const configBytes = textEncoder.encode(JSON.stringify(input.config)).length;
+    if (configBytes > MAX_PROVIDER_CONFIG_JSON_BYTES) {
+        throw validationFailure(`provider config exceeds ${MAX_PROVIDER_CONFIG_JSON_BYTES} bytes`, {
+            provider: input.provider,
+            actualBytes: configBytes,
+            maxBytes: MAX_PROVIDER_CONFIG_JSON_BYTES,
+        });
+    }
+    return registry.withProvider({
+        provider: input.provider,
+        config: cloneConfig(input.config),
+        healthTimeoutMs,
+    });
+};
+const validateProviderRegistrationInput = (input) => {
+    if (typeof input.provider !== "string" || input.provider.length === 0) {
+        throw validationFailure("provider is required", {
+            field: "provider",
+        });
+    }
+    if (!isRecord(input.config)) {
+        throw validationFailure("provider config must be an object", {
+            provider: input.provider,
+        });
+    }
+};
+const cloneProviderRegistration = (provider) => ({
+    provider: provider.provider,
+    config: cloneConfig(provider.config),
+    healthTimeoutMs: provider.healthTimeoutMs,
+});
+const cloneConfig = (config) => JSON.parse(JSON.stringify(config));
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const validationFailure = (message, details) => {
+    const error = new Error(message);
+    error.code = "validation_error";
+    if (details !== undefined) {
+        error.details = details;
+    }
+    return error;
+};
+const registrationError = (message, details) => {
+    const error = new Error(message);
+    error.code = "tool_registration_error";
+    if (details !== undefined) {
+        error.details = details;
+    }
+    return error;
+};
+//# sourceMappingURL=provider-registry.js.map

package/dist/sync/provider-registry.js.map

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