@labelbox/horizon-cli 0.0.0-stage → 0.0.1

package/dist/manifest.d.ts

@@ -0,0 +1,531 @@
+import { z } from 'zod';
+export { DEFAULT_BASE_URL } from './default-base-url.generated.js';
+export { hasJsonRequestRepresentation, isJsonOperationCallable, isMultipartRequestOperation, JSON_REQUEST_MEDIA_TYPE, MULTIPART_REQUEST_MEDIA_TYPE, } from './json-operation-callability.js';
+/**
+ * Join a hand-written support-endpoint path onto the base URL, under the API
+ * version segment. `path` is version-relative and must start with `/`.
+ */
+export declare function supportUrl(baseUrl: string, path: string): string;
+/**
+ * The manifest format the engine understands. Bumped only on a *breaking* schema
+ * change (a renamed/removed required field, a changed enum) — additive fields are
+ * backward-compatible because the schema strips unknown keys rather than rejecting
+ * them, so a newer server never breaks an older CLI by adding data. A mismatch is
+ * surfaced with an actionable upgrade message at the validation boundary.
+ */
+export declare const MANIFEST_FORMAT_VERSION = 2;
+export declare const JsonSchemaTypeSchema: z.ZodEnum<{
+    array: "array";
+    boolean: "boolean";
+    integer: "integer";
+    null: "null";
+    number: "number";
+    object: "object";
+    string: "string";
+}>;
+export type JsonSchemaType = z.infer<typeof JsonSchemaTypeSchema>;
+export interface ShapeNode {
+    name?: string | undefined;
+    type: string;
+    jsonTypes?: JsonSchemaType[] | undefined;
+    required?: boolean | undefined;
+    description?: string | undefined;
+    enum?: string[] | undefined;
+    itemEnum?: string[] | undefined;
+    default?: string | number | boolean | undefined;
+    format?: string | undefined;
+    example?: string | number | boolean | undefined;
+    nullable?: boolean | undefined;
+    minimum?: number | undefined;
+    maximum?: number | undefined;
+    exclusiveMinimum?: number | undefined;
+    exclusiveMaximum?: number | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+    minItems?: number | undefined;
+    maxItems?: number | undefined;
+    maxProperties?: number | undefined;
+    uniqueItems?: boolean | undefined;
+    pattern?: string | undefined;
+    fields?: ShapeNode[] | undefined;
+    items?: ShapeNode | undefined;
+    additionalProperties?: boolean | ShapeNode | undefined;
+    variants?: ShapeNode[] | undefined;
+}
+export declare const ShapeNodeSchema: z.ZodType<ShapeNode>;
+/** The metadata / constraint keys a `ShapeNode` carries beyond its structure. */
+export type ShapeMetaKey = Exclude<keyof ShapeNode, 'name' | 'type' | 'jsonTypes' | 'required' | 'description' | 'fields' | 'items' | 'additionalProperties' | 'variants'>;
+/** A node's present metadata as ordered `[key, value]` pairs (drives the CLI tags). */
+export declare function shapeMetaEntries(node: ShapeNode): Array<readonly [ShapeMetaKey, string | number | boolean | readonly string[]]>;
+/** A request param: a named shape node plus its HTTP location (for generic dispatch). */
+export declare const ManifestParamSchema: z.ZodObject<{
+    type: z.ZodString;
+    jsonTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        array: "array";
+        boolean: "boolean";
+        integer: "integer";
+        null: "null";
+        number: "number";
+        object: "object";
+        string: "string";
+    }>>>;
+    description: z.ZodOptional<z.ZodString>;
+    enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    itemEnum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    format: z.ZodOptional<z.ZodString>;
+    example: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    nullable: z.ZodOptional<z.ZodBoolean>;
+    minimum: z.ZodOptional<z.ZodNumber>;
+    maximum: z.ZodOptional<z.ZodNumber>;
+    exclusiveMinimum: z.ZodOptional<z.ZodNumber>;
+    exclusiveMaximum: z.ZodOptional<z.ZodNumber>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    minItems: z.ZodOptional<z.ZodNumber>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+    maxProperties: z.ZodOptional<z.ZodNumber>;
+    uniqueItems: z.ZodOptional<z.ZodBoolean>;
+    pattern: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>>;
+    items: z.ZodOptional<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>;
+    additionalProperties: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>]>>;
+    variants: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>>;
+    name: z.ZodString;
+    required: z.ZodBoolean;
+    in: z.ZodEnum<{
+        body: "body";
+        header: "header";
+        path: "path";
+        query: "query";
+    }>;
+}, z.core.$strip>;
+export type ManifestParam = z.infer<typeof ManifestParamSchema>;
+export declare const RequestBodyProjectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"fields">;
+    shape: z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"whole">;
+    shape: z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>;
+}, z.core.$strip>], "kind">;
+export type RequestBodyProjection = z.infer<typeof RequestBodyProjectionSchema>;
+export declare const SuccessResponseSchema: z.ZodObject<{
+    status: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<304>]>;
+    mediaTypes: z.ZodArray<z.ZodString>;
+    headers: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type SuccessResponse = z.infer<typeof SuccessResponseSchema>;
+export declare const InvocationExamplesSchema: z.ZodObject<{
+    typescript: z.ZodString;
+    cli: z.ZodString;
+    curl: z.ZodString;
+}, z.core.$strip>;
+export type InvocationExamples = z.infer<typeof InvocationExamplesSchema>;
+/**
+ * One operation, carrying everything the CLI needs to build its command and
+ * dispatch generically: the `callPath` (command tree), the `httpMethod` + `path`
+ * template + `params[].in` + `bodyKey` (dispatch), and the recursive request/response
+ * shapes (`--help`). Mirrors the relevant subset of horizon-sdk's `SdkReferenceEntry`.
+ */
+export declare const ManifestOperationSchema: z.ZodObject<{
+    operationId: z.ZodString;
+    callPath: z.ZodArray<z.ZodString>;
+    summary: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    httpMethod: z.ZodEnum<{
+        delete: "delete";
+        get: "get";
+        patch: "patch";
+        post: "post";
+        put: "put";
+    }>;
+    path: z.ZodString;
+    bodyKey: z.ZodOptional<z.ZodString>;
+    requestBodyRequired: z.ZodOptional<z.ZodBoolean>;
+    requestMediaTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requestBody: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"fields">;
+        shape: z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"whole">;
+        shape: z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>;
+    }, z.core.$strip>], "kind">>;
+    examples: z.ZodOptional<z.ZodObject<{
+        typescript: z.ZodString;
+        cli: z.ZodString;
+        curl: z.ZodString;
+    }, z.core.$strip>>;
+    requiredPermissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cliOutputField: z.ZodOptional<z.ZodString>;
+    successResponses: z.ZodArray<z.ZodObject<{
+        status: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<304>]>;
+        mediaTypes: z.ZodArray<z.ZodString>;
+        headers: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    params: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        jsonTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            array: "array";
+            boolean: "boolean";
+            integer: "integer";
+            null: "null";
+            number: "number";
+            object: "object";
+            string: "string";
+        }>>>;
+        description: z.ZodOptional<z.ZodString>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        itemEnum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        format: z.ZodOptional<z.ZodString>;
+        example: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        nullable: z.ZodOptional<z.ZodBoolean>;
+        minimum: z.ZodOptional<z.ZodNumber>;
+        maximum: z.ZodOptional<z.ZodNumber>;
+        exclusiveMinimum: z.ZodOptional<z.ZodNumber>;
+        exclusiveMaximum: z.ZodOptional<z.ZodNumber>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        minItems: z.ZodOptional<z.ZodNumber>;
+        maxItems: z.ZodOptional<z.ZodNumber>;
+        maxProperties: z.ZodOptional<z.ZodNumber>;
+        uniqueItems: z.ZodOptional<z.ZodBoolean>;
+        pattern: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>>;
+        items: z.ZodOptional<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>;
+        additionalProperties: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>]>>;
+        variants: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>>;
+        name: z.ZodString;
+        required: z.ZodBoolean;
+        in: z.ZodEnum<{
+            body: "body";
+            header: "header";
+            path: "path";
+            query: "query";
+        }>;
+    }, z.core.$strip>>;
+    response: z.ZodOptional<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>;
+}, z.core.$strip>;
+export type ManifestOperation = z.infer<typeof ManifestOperationSchema>;
+export declare const ManifestResourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    parent: z.ZodOptional<z.ZodString>;
+    order: z.ZodNumber;
+    domain: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    object: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        fields: z.ZodArray<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>;
+    }, z.core.$strip>>;
+    operationIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ManifestResource = z.infer<typeof ManifestResourceSchema>;
+export declare const ManifestRelatedSchema: z.ZodObject<{
+    requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"recipe">;
+        id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"state">;
+        explanation: z.ZodString;
+        predicate: z.ZodOptional<z.ZodString>;
+        via: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                concept: "concept";
+                recipe: "recipe";
+                resource: "resource";
+                tutorial: "tutorial";
+            }>;
+            id: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>>;
+    variationOf: z.ZodOptional<z.ZodString>;
+    learnMore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            concept: "concept";
+            recipe: "recipe";
+            resource: "resource";
+            tutorial: "tutorial";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ManifestRelated = z.infer<typeof ManifestRelatedSchema>;
+export declare const ManifestRecipeSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    goal: z.ZodString;
+    category: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        operationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    sdk: z.ZodObject<{
+        setup: z.ZodString;
+        main: z.ZodString;
+    }, z.core.$strip>;
+    cli: z.ZodObject<{
+        setup: z.ZodString;
+        main: z.ZodString;
+    }, z.core.$strip>;
+    curl: z.ZodObject<{
+        setup: z.ZodString;
+        main: z.ZodString;
+    }, z.core.$strip>;
+    related: z.ZodOptional<z.ZodObject<{
+        requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"recipe">;
+            id: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"state">;
+            explanation: z.ZodString;
+            predicate: z.ZodOptional<z.ZodString>;
+            via: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<{
+                    concept: "concept";
+                    recipe: "recipe";
+                    resource: "resource";
+                    tutorial: "tutorial";
+                }>;
+                id: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>>;
+        variationOf: z.ZodOptional<z.ZodString>;
+        learnMore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                concept: "concept";
+                recipe: "recipe";
+                resource: "resource";
+                tutorial: "tutorial";
+            }>;
+            id: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ManifestRecipe = z.infer<typeof ManifestRecipeSchema>;
+export declare const ManifestConceptSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    domain: z.ZodString;
+    related: z.ZodArray<z.ZodString>;
+    body: z.ZodString;
+}, z.core.$strip>;
+export type ManifestConcept = z.infer<typeof ManifestConceptSchema>;
+export declare const ManifestTutorialSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ManifestTutorial = z.infer<typeof ManifestTutorialSchema>;
+export declare const ManifestGuideSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    path: z.ZodString;
+    body: z.ZodString;
+}, z.core.$strip>;
+export type ManifestGuide = z.infer<typeof ManifestGuideSchema>;
+export declare const ManifestDomainSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    order: z.ZodNumber;
+}, z.core.$strip>;
+export type ManifestDomain = z.infer<typeof ManifestDomainSchema>;
+export declare const ManifestSchema: z.ZodObject<{
+    formatVersion: z.ZodNumber;
+    hash: z.ZodString;
+    operations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        operationId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        summary: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        httpMethod: z.ZodEnum<{
+            delete: "delete";
+            get: "get";
+            patch: "patch";
+            post: "post";
+            put: "put";
+        }>;
+        path: z.ZodString;
+        bodyKey: z.ZodOptional<z.ZodString>;
+        requestBodyRequired: z.ZodOptional<z.ZodBoolean>;
+        requestMediaTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requestBody: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"fields">;
+            shape: z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"whole">;
+            shape: z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>;
+        }, z.core.$strip>], "kind">>;
+        examples: z.ZodOptional<z.ZodObject<{
+            typescript: z.ZodString;
+            cli: z.ZodString;
+            curl: z.ZodString;
+        }, z.core.$strip>>;
+        requiredPermissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        cliOutputField: z.ZodOptional<z.ZodString>;
+        successResponses: z.ZodArray<z.ZodObject<{
+            status: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<304>]>;
+            mediaTypes: z.ZodArray<z.ZodString>;
+            headers: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        params: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            jsonTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                array: "array";
+                boolean: "boolean";
+                integer: "integer";
+                null: "null";
+                number: "number";
+                object: "object";
+                string: "string";
+            }>>>;
+            description: z.ZodOptional<z.ZodString>;
+            enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            itemEnum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            format: z.ZodOptional<z.ZodString>;
+            example: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            nullable: z.ZodOptional<z.ZodBoolean>;
+            minimum: z.ZodOptional<z.ZodNumber>;
+            maximum: z.ZodOptional<z.ZodNumber>;
+            exclusiveMinimum: z.ZodOptional<z.ZodNumber>;
+            exclusiveMaximum: z.ZodOptional<z.ZodNumber>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            minItems: z.ZodOptional<z.ZodNumber>;
+            maxItems: z.ZodOptional<z.ZodNumber>;
+            maxProperties: z.ZodOptional<z.ZodNumber>;
+            uniqueItems: z.ZodOptional<z.ZodBoolean>;
+            pattern: z.ZodOptional<z.ZodString>;
+            fields: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>>;
+            items: z.ZodOptional<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>;
+            additionalProperties: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>]>>;
+            variants: z.ZodOptional<z.ZodArray<z.ZodLazy<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>>>;
+            name: z.ZodString;
+            required: z.ZodBoolean;
+            in: z.ZodEnum<{
+                body: "body";
+                header: "header";
+                path: "path";
+                query: "query";
+            }>;
+        }, z.core.$strip>>;
+        response: z.ZodOptional<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>;
+    }, z.core.$strip>>;
+    resources: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        parent: z.ZodOptional<z.ZodString>;
+        order: z.ZodNumber;
+        domain: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        object: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            fields: z.ZodArray<z.ZodType<ShapeNode, unknown, z.core.$ZodTypeInternals<ShapeNode, unknown>>>;
+        }, z.core.$strip>>;
+        operationIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    recipes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        goal: z.ZodString;
+        category: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            operationId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sdk: z.ZodObject<{
+            setup: z.ZodString;
+            main: z.ZodString;
+        }, z.core.$strip>;
+        cli: z.ZodObject<{
+            setup: z.ZodString;
+            main: z.ZodString;
+        }, z.core.$strip>;
+        curl: z.ZodObject<{
+            setup: z.ZodString;
+            main: z.ZodString;
+        }, z.core.$strip>;
+        related: z.ZodOptional<z.ZodObject<{
+            requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                type: z.ZodLiteral<"recipe">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"state">;
+                explanation: z.ZodString;
+                predicate: z.ZodOptional<z.ZodString>;
+                via: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodEnum<{
+                        concept: "concept";
+                        recipe: "recipe";
+                        resource: "resource";
+                        tutorial: "tutorial";
+                    }>;
+                    id: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>>;
+            variationOf: z.ZodOptional<z.ZodString>;
+            learnMore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    concept: "concept";
+                    recipe: "recipe";
+                    resource: "resource";
+                    tutorial: "tutorial";
+                }>;
+                id: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    concepts: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        domain: z.ZodString;
+        related: z.ZodArray<z.ZodString>;
+        body: z.ZodString;
+    }, z.core.$strip>>;
+    tutorials: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        body: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    guides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        path: z.ZodString;
+        body: z.ZodString;
+    }, z.core.$strip>>>;
+    domains: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        order: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Manifest = z.infer<typeof ManifestSchema>;
+/**
+ * Validate a fetched/cached manifest at the I/O boundary and check engine↔manifest
+ * format compatibility. A version mismatch is the one case worth an actionable
+ * message: the schema itself stays lenient (so additive server changes are safe),
+ * and only a deliberate format bump trips this.
+ */
+export declare function parseManifest(value: unknown, source: string): Manifest;
+/**
+ * A filesystem-safe, collision-free slug for a base URL, so each server caches
+ * independently. The readable part is the sanitized URL (handy when eyeballing the
+ * cache dir); a short hash of the *full* URL is appended so two URLs that sanitize
+ * to the same string (e.g. `https://x.com:8080` vs `https://x-com-8080`) still get
+ * distinct cache files rather than silently sharing — and poisoning — one.
+ */
+export declare function hostSlug(baseUrl: string): string;
+/**
+ * Fetch the command manifest, revalidating the cache on every run:
+ *   - send `If-None-Match` with the cached ETag → `304` means the cache is provably
+ *     current (use it); `200` means the surface changed (validate + replace cache).
+ *   - a network error (incl. a timeout) falls back to the cached copy with a warning;
+ *     with no cache it errors clearly.
+ * When the server is reachable, the cache is revalidated and a backend redeploy is
+ * picked up automatically. Offline, the last locally validated copy may be older
+ * than the server but keeps the CLI usable.
+ */
+export declare function fetchManifest(baseUrl: string, apiKey: string): Promise<Manifest>;