@hasna/instructions 0.6.1 → 0.7.1

package/dist/server/openapi.d.ts

@@ -82,6 +82,104 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     };
                 };
             };
+            ConfigSummary: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "name", "slug", "kind", "category", "agent", "target_path", "format", "output_count", "description", "tags", "is_template", "version", "updated_at"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                    };
+                    readonly category: {
+                        readonly type: "string";
+                    };
+                    readonly agent: {
+                        readonly type: "string";
+                    };
+                    readonly target_path: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly format: {
+                        readonly type: "string";
+                    };
+                    readonly output_count: {
+                        readonly type: "number";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly tags: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly is_template: {
+                        readonly type: "boolean";
+                    };
+                    readonly version: {
+                        readonly type: "number";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            ConfigIdentity: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "name", "slug", "kind", "category", "agent", "format", "is_template", "version", "created_at", "updated_at", "synced_at"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                    };
+                    readonly category: {
+                        readonly type: "string";
+                    };
+                    readonly agent: {
+                        readonly type: "string";
+                    };
+                    readonly format: {
+                        readonly type: "string";
+                    };
+                    readonly is_template: {
+                        readonly type: "boolean";
+                    };
+                    readonly version: {
+                        readonly type: "number";
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                    readonly synced_at: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                };
+            };
             Profile: {
                 readonly type: "object";
                 readonly properties: {
@@ -112,6 +210,75 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     };
                 };
             };
+            ProfileIdentity: {
+                readonly type: "object";
+                readonly required: readonly ["id", "name", "slug", "created_at", "updated_at"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            Machine: {
+                readonly type: "object";
+                readonly required: readonly ["id", "hostname", "os", "arch", "last_applied_at", "created_at"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly hostname: {
+                        readonly type: "string";
+                    };
+                    readonly os: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly arch: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly last_applied_at: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            ConfigSnapshot: {
+                readonly type: "object";
+                readonly required: readonly ["id", "config_id", "content", "version", "created_at"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly config_id: {
+                        readonly type: "string";
+                    };
+                    readonly content: {
+                        readonly type: "string";
+                    };
+                    readonly version: {
+                        readonly type: "number";
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
             CreateConfigInput: {
                 type: string;
                 required: string[];
@@ -157,17 +324,34 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     name: {
                         type: string;
                     };
+                    kind: {
+                        type: string;
+                    };
                     category: {
                         type: string;
                     };
                     agent: {
                         type: string;
                     };
+                    target_path: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    outputs: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    format: {
+                        type: string;
+                    };
                     content: {
                         type: string;
                     };
                     description: {
                         type: string;
+                        nullable: boolean;
                     };
                     tags: {
                         type: string;
@@ -178,6 +362,10 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     is_template: {
                         type: string;
                     };
+                    synced_at: {
+                        type: string;
+                        nullable: boolean;
+                    };
                 };
             };
             CreateProfileInput: {
@@ -198,6 +386,61 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     };
                 };
             };
+            UpdateProfileInput: {
+                type: string;
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    selectors: {
+                        type: string;
+                    };
+                    variables: {
+                        type: string;
+                    };
+                };
+            };
+            PruneSnapshotsInput: {
+                type: string;
+                properties: {
+                    keep: {
+                        type: string;
+                        minimum: number;
+                        default: number;
+                    };
+                };
+            };
+            MachineAppliedInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    hostname: {
+                        type: string;
+                    };
+                };
+            };
+            FeedbackInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    message: {
+                        type: string;
+                    };
+                    email: {
+                        type: string;
+                    };
+                    category: {
+                        type: string;
+                    };
+                    version: {
+                        type: string;
+                    };
+                };
+            };
             AddProfileConfigInput: {
                 type: string;
                 required: string[];
@@ -498,12 +741,21 @@ export declare function buildV1OpenApiDocument(version?: string): {
                 type: string;
                 required: string[];
                 properties: {
+                    configs: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
                     items: {
                         type: string;
                         items: {
                             $ref: string;
                         };
                     };
+                    count: {
+                        type: string;
+                    };
                     total: {
                         type: string;
                     };
@@ -532,44 +784,373 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     };
                 };
             };
-            ProfileShowResponse: {
+            BoundedConfigSummaryPage: {
                 type: string;
                 required: string[];
                 properties: {
-                    profile: {
-                        $ref: string;
-                    };
                     configs: {
-                        $ref: string;
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
                     };
-                };
-            };
-            ProfileResolutionRead: {
-                type: string;
-                required: string[];
-                properties: {
-                    profile: {
-                        oneOf: ({
+                    items: {
+                        type: string;
+                        items: {
                             $ref: string;
-                            type?: undefined;
-                        } | {
-                            type: string;
-                            $ref?: undefined;
-                        })[];
+                        };
                     };
-                    scanned: {
+                    count: {
                         type: string;
-                        nullable: boolean;
                     };
                     total: {
                         type: string;
-                        nullable: boolean;
                     };
-                    batch_limit: {
+                    limit: {
                         type: string;
-                        nullable: boolean;
                     };
-                    source_bounded: {
+                    cursor: {
+                        type: string;
+                    };
+                    next_cursor: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    has_more: {
+                        type: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    truncated: {
+                        type: string;
+                        const: boolean;
+                    };
+                    source_bounded: {
+                        type: string;
+                    };
+                };
+            };
+            BoundedConfigIdentityPage: {
+                type: string;
+                required: string[];
+                properties: {
+                    configs: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    items: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    count: {
+                        type: string;
+                    };
+                    total: {
+                        type: string;
+                    };
+                    limit: {
+                        type: string;
+                    };
+                    cursor: {
+                        type: string;
+                    };
+                    next_cursor: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    has_more: {
+                        type: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    truncated: {
+                        type: string;
+                        const: boolean;
+                    };
+                    source_bounded: {
+                        type: string;
+                    };
+                };
+            };
+            BoundedProfileIdentityPage: {
+                type: string;
+                required: string[];
+                properties: {
+                    profiles: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    items: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    count: {
+                        type: string;
+                    };
+                    total: {
+                        type: string;
+                    };
+                    limit: {
+                        type: string;
+                    };
+                    cursor: {
+                        type: string;
+                    };
+                    next_cursor: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    has_more: {
+                        type: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    truncated: {
+                        type: string;
+                        const: boolean;
+                    };
+                    source_bounded: {
+                        type: string;
+                    };
+                };
+            };
+            BoundedSnapshotPage: {
+                type: string;
+                required: string[];
+                properties: {
+                    snapshots: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    items: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    count: {
+                        type: string;
+                    };
+                    total: {
+                        type: string;
+                    };
+                    limit: {
+                        type: string;
+                    };
+                    cursor: {
+                        type: string;
+                    };
+                    next_cursor: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    has_more: {
+                        type: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    truncated: {
+                        type: string;
+                        const: boolean;
+                    };
+                    source_bounded: {
+                        type: string;
+                    };
+                };
+            };
+            BoundedMachinePage: {
+                type: string;
+                required: string[];
+                properties: {
+                    machines: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    items: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    count: {
+                        type: string;
+                    };
+                    total: {
+                        type: string;
+                    };
+                    limit: {
+                        type: string;
+                    };
+                    cursor: {
+                        type: string;
+                    };
+                    next_cursor: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    has_more: {
+                        type: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    truncated: {
+                        type: string;
+                        const: boolean;
+                    };
+                    source_bounded: {
+                        type: string;
+                    };
+                };
+            };
+            BoundedProfileConfigBindingPage: {
+                type: string;
+                required: string[];
+                properties: {
+                    bindings: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    items: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    count: {
+                        type: string;
+                    };
+                    total: {
+                        type: string;
+                    };
+                    limit: {
+                        type: string;
+                    };
+                    cursor: {
+                        type: string;
+                    };
+                    next_cursor: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    has_more: {
+                        type: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    truncated: {
+                        type: string;
+                        const: boolean;
+                    };
+                    source_bounded: {
+                        type: string;
+                    };
+                };
+            };
+            BoundedProfileAssetBindingPage: {
+                type: string;
+                required: string[];
+                properties: {
+                    assets: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    items: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    count: {
+                        type: string;
+                    };
+                    total: {
+                        type: string;
+                    };
+                    limit: {
+                        type: string;
+                    };
+                    cursor: {
+                        type: string;
+                    };
+                    next_cursor: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    has_more: {
+                        type: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    truncated: {
+                        type: string;
+                        const: boolean;
+                    };
+                    source_bounded: {
+                        type: string;
+                    };
+                };
+            };
+            ProfileShowResponse: {
+                type: string;
+                required: string[];
+                properties: {
+                    profile: {
+                        $ref: string;
+                    };
+                    configs: {
+                        $ref: string;
+                    };
+                };
+            };
+            ProfileResolutionRead: {
+                type: string;
+                required: string[];
+                properties: {
+                    profile: {
+                        oneOf: ({
+                            $ref: string;
+                            type?: undefined;
+                        } | {
+                            type: string;
+                            $ref?: undefined;
+                        })[];
+                    };
+                    scanned: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    total: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    batch_limit: {
+                        type: string;
+                        nullable: boolean;
+                    };
+                    source_bounded: {
                         type: string;
                     };
                     complete: {
@@ -592,30 +1173,65 @@ export declare function buildV1OpenApiDocument(version?: string): {
             get: {
                 operationId: string;
                 summary: string;
-                parameters: {
+                parameters: ({
+                    readonly name: "limit";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 100;
+                    };
+                } | {
+                    readonly name: "cursor";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 100000;
+                    };
+                } | {
+                    readonly name: "view";
+                    readonly in: "query";
+                    readonly description: "Use summary for a content-free list projection, or identity for the smallest metadata-only projection.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly enum: readonly ["summary", "identity"];
+                    };
+                } | {
+                    name: string;
+                    in: string;
+                    schema: {
+                        type: string;
+                        maxLength?: undefined;
+                        items?: undefined;
+                    };
+                } | {
                     name: string;
                     in: string;
                     schema: {
                         type: string;
+                        maxLength: number;
+                        items?: undefined;
+                    };
+                } | {
+                    name: string;
+                    in: string;
+                    schema: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        maxLength?: undefined;
                     };
-                }[];
+                })[];
                 responses: {
                     "200": {
                         content: {
                             "application/json": {
                                 schema: {
-                                    type: string;
-                                    properties: {
-                                        configs: {
-                                            type: string;
-                                            items: {
-                                                $ref: string;
-                                            };
-                                        };
-                                        count: {
-                                            type: string;
-                                        };
-                                    };
+                                    anyOf: {
+                                        $ref: string;
+                                    }[];
                                 };
                             };
                         };
@@ -625,6 +1241,18 @@ export declare function buildV1OpenApiDocument(version?: string): {
             post: {
                 operationId: string;
                 summary: string;
+                parameters: {
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                }[];
                 requestBody: {
                     required: boolean;
                     content: {
@@ -650,6 +1278,26 @@ export declare function buildV1OpenApiDocument(version?: string): {
                             };
                         };
                     };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
                 };
             };
         };
@@ -720,6 +1368,44 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     };
                 };
             };
+            put: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        config: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
             delete: {
                 operationId: string;
                 summary: string;
@@ -756,29 +1442,111 @@ export declare function buildV1OpenApiDocument(version?: string): {
             get: {
                 operationId: string;
                 summary: string;
-                parameters: {
+                parameters: ({
+                    readonly name: "limit";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 100;
+                    };
+                } | {
+                    readonly name: "cursor";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 100000;
+                    };
+                } | {
                     name: string;
                     in: string;
                     required: boolean;
                     schema: {
                         type: string;
                     };
-                }[];
+                })[];
                 responses: {
                     "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    $ref: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                parameters: ({
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                } | {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                })[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                type: string;
+                                properties: {
+                                    content: {
+                                        type: string;
+                                    };
+                                    version: {
+                                        type: string;
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
                         content: {
                             "application/json": {
                                 schema: {
                                     type: string;
                                     properties: {
-                                        snapshots: {
-                                            type: string;
-                                            items: {
-                                                type: string;
-                                            };
+                                        snapshot: {
+                                            $ref: string;
                                         };
-                                        count: {
-                                            type: string;
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
                                         };
                                     };
                                 };
@@ -787,6 +1555,8 @@ export declare function buildV1OpenApiDocument(version?: string): {
                     };
                 };
             };
+        };
+        "/v1/configs/{id}/snapshots/prune": {
             post: {
                 operationId: string;
                 summary: string;
@@ -798,14 +1568,25 @@ export declare function buildV1OpenApiDocument(version?: string): {
                         type: string;
                     };
                 }[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
                 responses: {
-                    "201": {
+                    "200": {
                         content: {
                             "application/json": {
                                 schema: {
                                     type: string;
+                                    required: string[];
                                     properties: {
-                                        snapshot: {
+                                        pruned: {
                                             type: string;
                                         };
                                     };
@@ -816,25 +1597,63 @@ export declare function buildV1OpenApiDocument(version?: string): {
                 };
             };
         };
-        "/v1/profiles": {
+        "/v1/configs/{id}/snapshots/{version}": {
             get: {
                 operationId: string;
                 summary: string;
-                parameters: ({
+                parameters: {
                     name: string;
                     in: string;
+                    required: boolean;
                     schema: {
                         type: string;
-                        minimum: number;
-                        maximum: number;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        snapshot: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/profiles": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: ({
+                    readonly name: "limit";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 100;
                     };
                 } | {
-                    name: string;
-                    in: string;
-                    schema: {
-                        type: string;
-                        minimum: number;
-                        maximum?: undefined;
+                    readonly name: "cursor";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 100000;
+                    };
+                } | {
+                    readonly name: "view";
+                    readonly in: "query";
+                    readonly description: "Use identity for a metadata-only projection that omits instruction content, paths, outputs, and private profile fields.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly enum: readonly ["identity"];
                     };
                 })[];
                 responses: {
@@ -842,7 +1661,9 @@ export declare function buildV1OpenApiDocument(version?: string): {
                         content: {
                             "application/json": {
                                 schema: {
-                                    $ref: string;
+                                    oneOf: {
+                                        $ref: string;
+                                    }[];
                                 };
                             };
                         };
@@ -852,6 +1673,18 @@ export declare function buildV1OpenApiDocument(version?: string): {
             post: {
                 operationId: string;
                 summary: string;
+                parameters: {
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                }[];
                 requestBody: {
                     required: boolean;
                     content: {
@@ -877,6 +1710,26 @@ export declare function buildV1OpenApiDocument(version?: string): {
                             };
                         };
                     };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
                 };
             };
         };
@@ -944,14 +1797,91 @@ export declare function buildV1OpenApiDocument(version?: string): {
                         minimum: number;
                         maximum?: undefined;
                     };
-                    required?: undefined;
-                })[];
+                    required?: undefined;
+                })[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    $ref: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            patch: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        profile: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            put: {
+                operationId: string;
+                summary: string;
+                description: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
                 responses: {
                     "200": {
                         content: {
                             "application/json": {
                                 schema: {
-                                    $ref: string;
+                                    type: string;
+                                    properties: {
+                                        profile: {
+                                            $ref: string;
+                                        };
+                                    };
                                 };
                             };
                         };
@@ -998,14 +1928,25 @@ export declare function buildV1OpenApiDocument(version?: string): {
                 security: {
                     apiKey: never[];
                 }[];
-                parameters: {
+                parameters: ({
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                } | {
                     name: string;
                     in: string;
                     required: boolean;
                     schema: {
                         type: string;
                     };
-                }[];
+                })[];
                 requestBody: {
                     required: boolean;
                     content: {
@@ -1026,6 +1967,26 @@ export declare function buildV1OpenApiDocument(version?: string): {
                             };
                         };
                     };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
                 };
             };
         };
@@ -1036,14 +1997,25 @@ export declare function buildV1OpenApiDocument(version?: string): {
                 security: {
                     apiKey: never[];
                 }[];
-                parameters: {
+                parameters: ({
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                } | {
                     name: string;
                     in: string;
                     required: boolean;
                     schema: {
                         type: string;
                     };
-                }[];
+                })[];
                 requestBody: {
                     required: boolean;
                     content: {
@@ -1075,6 +2047,26 @@ export declare function buildV1OpenApiDocument(version?: string): {
                             };
                         };
                     };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
                 };
             };
             delete: {
@@ -1109,28 +2101,36 @@ export declare function buildV1OpenApiDocument(version?: string): {
             get: {
                 operationId: string;
                 summary: string;
-                parameters: {
+                parameters: ({
+                    readonly name: "limit";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 100;
+                    };
+                } | {
+                    readonly name: "cursor";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 100000;
+                    };
+                } | {
                     name: string;
                     in: string;
                     required: boolean;
                     schema: {
                         type: string;
                     };
-                }[];
+                })[];
                 responses: {
                     "200": {
                         content: {
                             "application/json": {
                                 schema: {
-                                    type: string;
-                                    properties: {
-                                        bindings: {
-                                            type: string;
-                                            items: {
-                                                $ref: string;
-                                            };
-                                        };
-                                    };
+                                    $ref: string;
                                 };
                             };
                         };
@@ -1142,28 +2142,36 @@ export declare function buildV1OpenApiDocument(version?: string): {
             get: {
                 operationId: string;
                 summary: string;
-                parameters: {
+                parameters: ({
+                    readonly name: "limit";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 100;
+                    };
+                } | {
+                    readonly name: "cursor";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 100000;
+                    };
+                } | {
                     name: string;
                     in: string;
                     required: boolean;
                     schema: {
                         type: string;
                     };
-                }[];
+                })[];
                 responses: {
                     "200": {
                         content: {
                             "application/json": {
                                 schema: {
-                                    type: string;
-                                    properties: {
-                                        assets: {
-                                            type: string;
-                                            items: {
-                                                $ref: string;
-                                            };
-                                        };
-                                    };
+                                    $ref: string;
                                 };
                             };
                         };
@@ -1176,14 +2184,25 @@ export declare function buildV1OpenApiDocument(version?: string): {
                 security: {
                     apiKey: never[];
                 }[];
-                parameters: {
+                parameters: ({
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                } | {
                     name: string;
                     in: string;
                     required: boolean;
                     schema: {
                         type: string;
                     };
-                }[];
+                })[];
                 requestBody: {
                     required: boolean;
                     content: {
@@ -1209,6 +2228,26 @@ export declare function buildV1OpenApiDocument(version?: string): {
                             };
                         };
                     };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
                 };
             };
         };
@@ -1219,14 +2258,25 @@ export declare function buildV1OpenApiDocument(version?: string): {
                 security: {
                     apiKey: never[];
                 }[];
-                parameters: {
+                parameters: ({
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                } | {
                     name: string;
                     in: string;
                     required: boolean;
                     schema: {
                         type: string;
                     };
-                }[];
+                })[];
                 requestBody: {
                     required: boolean;
                     content: {
@@ -1258,6 +2308,26 @@ export declare function buildV1OpenApiDocument(version?: string): {
                             };
                         };
                     };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
                 };
             };
             delete: {
@@ -1293,6 +2363,222 @@ export declare function buildV1OpenApiDocument(version?: string): {
                 };
             };
         };
+        "/v1/snapshots/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        snapshot: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/machines/applied": {
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    required: string[];
+                                    properties: {
+                                        updated: {
+                                            type: string;
+                                            const: boolean;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/machines": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: ({
+                    readonly name: "limit";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 100;
+                    };
+                } | {
+                    readonly name: "cursor";
+                    readonly in: "query";
+                    readonly schema: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 100000;
+                    };
+                } | {
+                    readonly name: "view";
+                    readonly in: "query";
+                    readonly description: "Use identity for a metadata-only projection that omits instruction content, paths, outputs, and private profile fields.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly enum: readonly ["identity"];
+                    };
+                })[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    $ref: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    readonly name: "Idempotency-Key";
+                    readonly in: "header";
+                    readonly required: false;
+                    readonly description: "Optional visible-ASCII request key (1-255 characters). Replays the first committed response for the same authenticated principal, operation, and canonical JSON body; reuse with a different body returns 409.";
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 255;
+                        readonly pattern: "^[!-~]+$";
+                    };
+                }[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                type: string;
+                                required: string[];
+                                properties: {
+                                    hostname: {
+                                        type: string;
+                                    };
+                                    os: {
+                                        type: string;
+                                        nullable: boolean;
+                                    };
+                                    arch: {
+                                        type: string;
+                                        nullable: boolean;
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        machine: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    "409": {
+                        readonly description: "The Idempotency-Key was already used for a different request body.";
+                        readonly content: {
+                            readonly "application/json": {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["error", "code"];
+                                    readonly properties: {
+                                        readonly error: {
+                                            readonly type: "string";
+                                        };
+                                        readonly code: {
+                                            readonly type: "string";
+                                            readonly const: "IDEMPOTENCY_KEY_REUSED";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/feedback": {
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    required: string[];
+                                    properties: {
+                                        ok: {
+                                            type: string;
+                                            const: boolean;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
         "/v1/stats": {
             get: {
                 operationId: string;