/**
 * Real worker manifest production from an engine's canonical workflow
 * registry (WFT-29).
 *
 * `RemoteWorkerOptions` and the internal Worker realm both fall back to
 * `declared-shape:` placeholders when no real build tooling supplies a
 * manifest — see {@link declaredShapeDigest}. This module is that build
 * tooling: it derives `WorkerWorkflowContract`/`WorkerActivityContract`
 * values from the *same* normalized representation `buildRegistrySnapshot`
 * produces for `GET /v1/registry` and `weft codegen`, hashed via
 * `core/contract`'s canonical `contractHash()`/`activityContractHash()`/
 * `deriveWorkflowRevision()` (WFT-5) — the same normalized-contract vocabulary
 * `weft codegen` and `WorkflowRevisionManifest` use, rather than this
 * module's own ad hoc hashing (as it did before WFT-5).
 *
 * **WFT-5 digest-value change.** `contractHash`/`workflowRevision` here now
 * fold in a `contractVersion` domain separator (`WORKFLOW_CONTRACT_VERSION`)
 * that the pre-WFT-5 formula never had, so digest *strings* for an
 * otherwise-unchanged registration differ from 0.23.x output — see
 * `CHANGELOG.md`. `workflowRevision` also now derives from a `WorkflowContract`
 * that omits `queue`/`retry`/`timeout` (registry-only activity metadata with
 * no contract-identity meaning), which the pre-WFT-5 formula's
 * `{ ...entry, version }` spread incidentally included; this is a narrowing,
 * not a behavior a caller could rely on. `contractHash` also now folds in
 * whichever activities `options.workflows[type]` names (previously
 * independent of that list, since only the activity's *own* schema was
 * hashed) — declaring a different activity subset for the same workflow type
 * now changes `contractHash`, which is the intended effect of a contract
 * identity that is supposed to answer "what can a caller do with this
 * workflow", not just "what does the workflow's own input/output look like".
 *
 * Intended use is a build script: construct an `Engine` with every workflow
 * the artifact bundles registered (never started), call
 * {@link buildWorkerManifestFromRegistry}, and pass the result as
 * `RemoteWorkerOptions.manifest`.
 *
 * @module worker/manifest/registry-contract-builder
 */
import type { Engine } from '../../core/engine.ts';
import { WeftError } from '../../core/weft-error.ts';
import type { WorkerDeploymentIdentity, WorkerManifest, WorkerRuntimeIdentity } from './types.ts';
/**
 * Thrown when {@link buildWorkerManifestFromRegistry} is asked to advertise a
 * workflow or activity name that the source `Engine` has not registered.
 *
 * This is a build-time tooling error, thrown before any manifest reaches the
 * wire — analogous to the engine's own `RegistrySchemaConversionError`.
 *
 * @example
 * ```ts
 * import { WorkerManifestBuildError } from '@lostgradient/weft';
 *
 * try {
 *   throw new WorkerManifestBuildError('workflow "checkout" is not registered');
 * } catch (error) {
 *   console.log(error instanceof WorkerManifestBuildError); // true
 * }
 * ```
 */
export declare class WorkerManifestBuildError extends WeftError<'WorkerManifestBuildError'> {
    constructor(message: string);
}
/**
 * Options accepted by {@link buildWorkerManifestFromRegistry}.
 *
 * @example
 * ```ts
 * import type { WorkerManifestFromRegistryOptions } from '@lostgradient/weft';
 *
 * const options: WorkerManifestFromRegistryOptions = {
 *   workflows: { checkout: ['charge'] },
 *   deployment: { name: 'billing', buildId: '2026.08.18-3', artifactDigest: 'sha256:41d0e2' },
 *   runtime: { name: 'bun', version: '1.3.14' },
 * };
 * console.log(options.workflows['checkout']);
 * ```
 */
export interface WorkerManifestFromRegistryOptions {
    /**
     * Workflow types this worker instance can execute, each mapped to the
     * activity names it invokes. Every key must name a workflow the source
     * `Engine` has registered, and every activity name must be one the same
     * `Engine` has registered — the engine's activity registry is a flat
     * namespace, not partitioned per workflow, so this association is the one
     * thing the registry genuinely cannot supply on its own.
     */
    workflows: Readonly<Record<string, readonly string[]>>;
    /** Immutable deployment artifact identity. Required — never derived. */
    deployment: WorkerDeploymentIdentity;
    /**
     * Runtime that will execute the deployed artifact. Required rather than
     * defaulted: a build script's own process (often a CI runner) is not
     * necessarily the runtime the artifact deploys to, so live detection here
     * would silently assert the wrong identity.
     */
    runtime: WorkerRuntimeIdentity;
    /** Weft worker SDK release the deployed artifact bundles. Defaults to this package's `VERSION`. */
    sdkVersion?: string;
    /** RemoteWorker wire protocol version. Defaults to `REMOTE_WORKER_PROTOCOL_VERSION`. */
    protocolVersion?: number;
    /** Bounded descriptive capability data. Defaults to `{}`. */
    capabilities?: WorkerManifest['capabilities'];
}
/**
 * Build a real worker manifest from an engine's canonical workflow and
 * activity registrations.
 *
 * `implementationRevision` on every activity contract is set to
 * `options.deployment.buildId`: a schema identifies the *contract*, not the
 * code behind it, so there is no honest schema-derived source for "which
 * implementation" — the build that produced this artifact is the closest
 * available honest answer.
 *
 * Throws {@link WorkerManifestBuildError} if `options.workflows` names a
 * workflow or activity the source `Engine` has not registered, and a
 * (non-public) schema-conversion error if a registered schema cannot be
 * converted to JSON Schema.
 *
 * @example
 * ```ts
 * import { buildWorkerManifestFromRegistry, Engine, workflow } from '@lostgradient/weft';
 *
 * const engine = new Engine();
 * engine.register(
 *   workflow({ name: 'checkout', version: '2.1.0' }).execute(async function* () {}),
 * );
 *
 * const manifest = await buildWorkerManifestFromRegistry(engine, {
 *   workflows: { checkout: [] },
 *   deployment: { name: 'billing', buildId: '2026.08.18-3', artifactDigest: 'sha256:41d0e2' },
 *   runtime: { name: 'bun', version: '1.3.14' },
 * });
 *
 * console.log(manifest.workflows['checkout']?.workflowVersion); // '2.1.0'
 * engine[Symbol.dispose]();
 * ```
 */
export declare function buildWorkerManifestFromRegistry(engine: Engine, options: WorkerManifestFromRegistryOptions): Promise<WorkerManifest>;