@epilot/sdk 2.8.9 → 2.8.10

package/dist/apis/workflow-definition.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-VMKT7UQS.js";
+} from "../chunk-H5BH4GQQ.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/workflow-definition.ts

package/dist/apis/workflow.cjs

@@ -6,25 +6,25 @@ var _chunkQNZPOA54cjs = require('../chunk-QNZPOA54.cjs');
 
 
 
-var _chunk4GI6KGKZcjs = require('../chunk-4GI6KGKZ.cjs');
+var _chunkOMZ2LWNRcjs = require('../chunk-OMZ2LWNR.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/workflow.ts
 var loadDefinition = () => {
   const mod = _chunkQNZPOA54cjs.require_workflow_runtime.call(void 0, );
-  return _chunk4GI6KGKZcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunkOMZ2LWNRcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunk4GI6KGKZcjs.createApiClient.call(void 0, { definition: def, apiName: "workflow" });
+    _instance = _chunkOMZ2LWNRcjs.createApiClient.call(void 0, { definition: def, apiName: "workflow" });
   }
   return _instance;
 };
-var _handle = _chunk4GI6KGKZcjs.createApiHandle.call(void 0, {
+var _handle = _chunkOMZ2LWNRcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunk4GI6KGKZcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "workflow" }),
+  createClient: () => _chunkOMZ2LWNRcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "workflow" }),
   apiName: "workflow"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var workflow = _handle;
 
 
 
-exports.authorize = _chunk4GI6KGKZcjs.authorize; exports.createClient = createClient; exports.getClient = getClient; exports.workflow = workflow;
+exports.authorize = _chunkOMZ2LWNRcjs.authorize; exports.createClient = createClient; exports.getClient = getClient; exports.workflow = workflow;

package/dist/apis/workflow.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-VMKT7UQS.js";
+} from "../chunk-H5BH4GQQ.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/workflow.ts

package/dist/{chunk-VMKT7UQS.js → chunk-H5BH4GQQ.js}

@@ -72,7 +72,7 @@ var globImport_docs = __glob({
   "./docs/query.json": () => import("./query-RJ4M25PA.js"),
   "./docs/sandbox.json": () => import("./sandbox-L2SOOGGR.js"),
   "./docs/sharing.json": () => import("./sharing-MNDABPL7.js"),
-  "./docs/snapshot.json": () => import("./snapshot-6CCO4NYL.js"),
+  "./docs/snapshot.json": () => import("./snapshot-Y6A7QUYS.js"),
   "./docs/submission.json": () => import("./submission-7BISSPO6.js"),
   "./docs/target.json": () => import("./target-5MKRXCHX.js"),
   "./docs/targeting.json": () => import("./targeting-X4Y2ODBT.js"),

package/dist/{chunk-4GI6KGKZ.cjs → chunk-OMZ2LWNR.cjs}

@@ -72,7 +72,7 @@ var globImport_docs = _chunkNJK5F5TFcjs.__glob.call(void 0, {
   "./docs/query.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./query-JSDB2F2U.cjs"))),
   "./docs/sandbox.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./sandbox-2KN4X66E.cjs"))),
   "./docs/sharing.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./sharing-MR7ANOST.cjs"))),
-  "./docs/snapshot.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./snapshot-GWB56VPP.cjs"))),
+  "./docs/snapshot.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./snapshot-HFVQTHYF.cjs"))),
   "./docs/submission.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./submission-Q24BU4GS.cjs"))),
   "./docs/target.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./target-3RS5BN2B.cjs"))),
   "./docs/targeting.json": () => Promise.resolve().then(() => _interopRequireWildcard(require("./targeting-WC62BBZN.cjs"))),

package/dist/index.cjs

@@ -158,7 +158,7 @@ var _chunkDVM27A7Ecjs = require('./chunk-DVM27A7E.cjs');
 
 
 
-var _chunk4GI6KGKZcjs = require('./chunk-4GI6KGKZ.cjs');
+var _chunkOMZ2LWNRcjs = require('./chunk-OMZ2LWNR.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -225,7 +225,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunk4GI6KGKZcjs.createApiClient.call(void 0, {
+    entry.instance = _chunkOMZ2LWNRcjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -258,7 +258,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunk4GI6KGKZcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkOMZ2LWNRcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -601,9 +601,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunk4GI6KGKZcjs.createApiHandle.call(void 0, {
+    return _chunkOMZ2LWNRcjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunk4GI6KGKZcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkOMZ2LWNRcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -651,9 +651,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunk4GI6KGKZcjs.help.call(void 0, apiName);
+          return (apiName) => _chunkOMZ2LWNRcjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunk4GI6KGKZcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkOMZ2LWNRcjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -683,4 +683,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunk4GI6KGKZcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunk4GI6KGKZcjs.help; exports.openapi = _chunk4GI6KGKZcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkOMZ2LWNRcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkOMZ2LWNRcjs.help; exports.openapi = _chunkOMZ2LWNRcjs.openapi;

package/dist/index.d.cts

@@ -45,7 +45,7 @@ import { C as Client$C } from './purpose.d-CbIYfTua.cjs';
 import { C as Client$D } from './query.d-Cmp78IhZ.cjs';
 import { C as Client$E } from './sandbox.d-BdbOFzDu.cjs';
 import { C as Client$F } from './sharing.d-sOXq-gtz.cjs';
-import { C as Client$G } from './snapshot.d-D5z6-hzE.cjs';
+import { C as Client$G } from './snapshot.d-CPTXg4xN.cjs';
 import { C as Client$H } from './submission.d-BamwfhXw.cjs';
 import { C as Client$I } from './targeting.d-0rNF7ErD.cjs';
 import { C as Client$J } from './template-variables.d-Ble9TSBa.cjs';

package/dist/index.d.ts

@@ -45,7 +45,7 @@ import { C as Client$C } from './purpose.d-CbIYfTua.js';
 import { C as Client$D } from './query.d-Cmp78IhZ.js';
 import { C as Client$E } from './sandbox.d-BdbOFzDu.js';
 import { C as Client$F } from './sharing.d-sOXq-gtz.js';
-import { C as Client$G } from './snapshot.d-D5z6-hzE.js';
+import { C as Client$G } from './snapshot.d-CPTXg4xN.js';
 import { C as Client$H } from './submission.d-BamwfhXw.js';
 import { C as Client$I } from './targeting.d-0rNF7ErD.js';
 import { C as Client$J } from './template-variables.d-Ble9TSBa.js';

package/dist/index.js

@@ -158,7 +158,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-VMKT7UQS.js";
+} from "./chunk-H5BH4GQQ.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";

package/dist/snapshot-HFVQTHYF.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
+
+// src/docs/snapshot.json
+var snapshot_default = '# Snapshot API\n\n- **Base URL:** `https://snapshot.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/snapshot](https://docs.epilot.io/api/snapshot)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.snapshot.createSnapshot(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/snapshot\'\n\nconst snapshotClient = getClient()\nauthorize(snapshotClient, () => \'<token>\')\nconst { data } = await snapshotClient.createSnapshot(...)\n```\n\n## Operations\n\n**Snapshots**\n- [`createSnapshot`](#createsnapshot)\n- [`listSnapshots`](#listsnapshots)\n- [`captureOrgSnapshot`](#captureorgsnapshot)\n- [`getSnapshot`](#getsnapshot)\n- [`deleteSnapshot`](#deletesnapshot)\n- [`restoreSnapshot`](#restoresnapshot)\n- [`listSnapshotResources`](#listsnapshotresources)\n- [`getSnapshotResource`](#getsnapshotresource)\n- [`listDependencies`](#listdependencies)\n\n**Schemas**\n- [`Error`](#error)\n- [`EmptyInventoryError`](#emptyinventoryerror)\n- [`ResourceRef`](#resourceref)\n- [`SnapshotResourceSummary`](#snapshotresourcesummary)\n- [`SnapshotResourceList`](#snapshotresourcelist)\n- [`SnapshotResourceDetail`](#snapshotresourcedetail)\n- [`CreateSnapshotRequest`](#createsnapshotrequest)\n- [`CreateOrgSnapshotRequest`](#createorgsnapshotrequest)\n- [`CreateSnapshotResponse`](#createsnapshotresponse)\n- [`RestoreSnapshotRequest`](#restoresnapshotrequest)\n- [`RestoreSnapshotResponse`](#restoresnapshotresponse)\n- [`Snapshot`](#snapshot)\n- [`Operation`](#operation)\n- [`SkippedResource`](#skippedresource)\n- [`CallerIdentity`](#calleridentity)\n\n### `createSnapshot`\n\nCreate a new snapshot of the given resources. Async \u2014 returns immediately\nwith a snapshot ID; client polls `getSnapshot` until `create.status`\nmoves from `in_progress` to `completed` or `failed`.\n\n`POST /v1/snapshots`\n\n```ts\nconst { data } = await client.createSnapshot(\n  null,\n  {\n    name: \'string\',\n    description: \'string\',\n    trigger: \'manual\',\n    blueprint_instance_id: \'string\',\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n---\n\n### `listSnapshots`\n\nList snapshots for the caller\'s organization, newest first.\n\n`GET /v1/snapshots`\n\n```ts\nconst { data } = await client.listSnapshots({\n  cursor: \'example\',\n  size: 1,\n  resource: [\'...\'],\n  trigger: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "page_size": 0,\n  "cursor": "string",\n  "results": [\n    {\n      "id": "string",\n      "org_id": "string",\n      "name": "string",\n      "description": "string",\n      "trigger": "manual",\n      "blueprint_instance_id": "string",\n      "resource_counts": {},\n      "create": {\n        "type": "create",\n        "started_at": "1970-01-01T00:00:00.000Z",\n        "completed_at": "1970-01-01T00:00:00.000Z",\n        "status": "in_progress",\n        "error": "string",\n        "triggered_by": {\n          "name": "string",\n          "user_id": "string",\n          "token_id": "string"\n        },\n        "skipped": [\n          {\n            "target_id": "string",\n            "reason": "modified"\n          }\n        ]\n      },\n      "restores": [\n        {\n          "type": "create",\n          "started_at": "1970-01-01T00:00:00.000Z",\n          "completed_at": "1970-01-01T00:00:00.000Z",\n          "status": "in_progress",\n          "error": "string",\n          "triggered_by": {\n            "name": "string",\n            "user_id": "string",\n            "token_id": "string"\n          },\n          "skipped": [\n            {\n              "target_id": "string",\n              "reason": "modified"\n            }\n          ]\n        }\n      ],\n      "matched_count": 0,\n      "scope": "selection",\n      "expires_at": "1970-01-01T00:00:00.000Z",\n      "capture_summary": {\n        "total": 0,\n        "captured": 0,\n        "skipped": 0,\n        "failed": 0\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `captureOrgSnapshot`\n\nSnapshot the caller\'s whole organization now. Fetches a fresh inventory\nof the org\'s configuration resources from configuration-hub-api, persists\nit as an inventory artifact, and starts a `scope: "org\n\n`POST /v1/snapshots:capture-org`\n\n```ts\nconst { data } = await client.captureOrgSnapshot(\n  null,\n  {\n    name: \'string\',\n    retention: {\n      value: 1,\n      unit: \'days\'\n    },\n    excluded_types: [\'string\']\n  },\n)\n```\n\n---\n\n### `getSnapshot`\n\nFetch a snapshot\'s metadata. Poll this endpoint to track create/restore progress.\n\n`GET /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.getSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "trigger": "manual",\n  "blueprint_instance_id": "string",\n  "resource_counts": {},\n  "create": {\n    "type": "create",\n    "started_at": "1970-01-01T00:00:00.000Z",\n    "completed_at": "1970-01-01T00:00:00.000Z",\n    "status": "in_progress",\n    "error": "string",\n    "triggered_by": {\n      "name": "string",\n      "user_id": "string",\n      "token_id": "string"\n    },\n    "skipped": [\n      {\n        "target_id": "string",\n        "reason": "modified"\n      }\n    ]\n  },\n  "restores": [\n    {\n      "type": "create",\n      "started_at": "1970-01-01T00:00:00.000Z",\n      "completed_at": "1970-01-01T00:00:00.000Z",\n      "status": "in_progress",\n      "error": "string",\n      "triggered_by": {\n        "name": "string",\n        "user_id": "string",\n        "token_id": "string"\n      },\n      "skipped": [\n        {\n          "target_id": "string",\n          "reason": "modified"\n        }\n      ]\n    }\n  ],\n  "matched_count": 0,\n  "scope": "selection",\n  "expires_at": "1970-01-01T00:00:00.000Z",\n  "capture_summary": {\n    "total": 0,\n    "captured": 0,\n    "skipped": 0,\n    "failed": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteSnapshot`\n\nDelete a snapshot\'s metadata and S3 manifest.\n\n`DELETE /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.deleteSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n---\n\n### `restoreSnapshot`\n\nRestore a snapshot to the org. Async \u2014 returns immediately; client polls\n`getSnapshot` until the latest entry in `restores` moves from\n`in_progress` to one of `completed | partial | failed`.\n\n`POST /v1/snapshots/{id}:restore`\n\n```ts\nconst { data } = await client.restoreSnapshot(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    preserve_modified: false,\n    exclude_target_ids: [\'string\']\n  },\n)\n```\n\n---\n\n### `listSnapshotResources`\n\nList the resources captured in this snapshot. Returns lightweight\nidentity fields per resource \u2014 payloads are fetched via the\nsingle-resource endpoint when needed.\n\n`GET /v1/snapshots/{id}/resources`\n\n```ts\nconst { data } = await client.listSnapshotResources({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "resources": [\n    {\n      "lineage_id": "string",\n      "target_id": "string",\n      "type": "string",\n      "name": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getSnapshotResource`\n\nFetch one captured resource with its full payload. For UI views\nthat diff the captured state against the current destination.\n\n`GET /v1/snapshots/{id}/resources/{lineage_id}`\n\n```ts\nconst { data } = await client.getSnapshotResource({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n  lineage_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "lineage_id": "string",\n  "target_id": "string",\n  "type": "string",\n  "name": "string",\n  "captured": {}\n}\n```\n\n</details>\n\n---\n\n### `listDependencies`\n\nWalk the dependency tree for a set of resources and return the full\ntransitive closure, topologically sorted.\n\n`POST /v1/snapshots:list-dependencies`\n\n```ts\nconst { data } = await client.listDependencies(\n  null,\n  {\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "dependencies": [\n    {\n      "type": "string",\n      "id": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `Error`\n\n```ts\ntype Error = {\n  status: number\n  error: string\n}\n```\n\n### `EmptyInventoryError`\n\nReturned (422) when the org inventory contains no capturable resources\nafter filtering out sensitive, unsupported, and excluded types. The\n`skipped_types` array explains why every type was dropped.\n\n\n```ts\ntype EmptyInventoryError = {\n  message: string\n  skipped_types: Array<{\n    type: string\n    reason: string\n  }>\n}\n```\n\n### `ResourceRef`\n\n```ts\ntype ResourceRef = {\n  type: string\n  id: string\n}\n```\n\n### `SnapshotResourceSummary`\n\nLightweight identity for a captured resource. Returned by\n`listSnapshotResources`; the full payload is fetched separately via\n`getSnapshotResource` when needed.\n\n\n```ts\ntype SnapshotResourceSummary = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n}\n```\n\n### `SnapshotResourceList`\n\n```ts\ntype SnapshotResourceList = {\n  resources: Array<{\n    lineage_id: string\n    target_id: string\n    type: string\n    name?: string\n  }>\n}\n```\n\n### `SnapshotResourceDetail`\n\nA single captured resource with its full payload. The identity fields\nmatch `SnapshotResourceSummary`; the `captured` payload is the\npre-install state at snapshot time.\n\n\n```ts\ntype SnapshotResourceDetail = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n  captured: Record<string, unknown>\n}\n```\n\n### `CreateSnapshotRequest`\n\n```ts\ntype CreateSnapshotRequest = {\n  name: string\n  description?: string\n  trigger?: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resources: Array<{\n    type: string\n    id: string\n  }>\n}\n```\n\n### `CreateOrgSnapshotRequest`\n\nRequest body for `captureOrgSnapshot`. All fields optional \u2014 an empty body\nsnapshots the whole org with a default name and the 90-day default TTL.\n\n\n```ts\ntype CreateOrgSnapshotRequest = {\n  name?: string\n  retention?: {\n    value: number\n    unit: "days" | "weeks" | "months"\n  }\n  excluded_types?: string[]\n}\n```\n\n### `CreateSnapshotResponse`\n\n```ts\ntype CreateSnapshotResponse = {\n  id: string\n  name: string\n  status: "creating"\n  created_at: string // date-time\n}\n```\n\n### `RestoreSnapshotRequest`\n\nApply a captured snapshot to its source org. All filters default to the\nopen setting (apply everything), which keeps Config Hub\'s manual-restore\nsemantics unchanged.\n\n\n```ts\ntype RestoreSnapshotRequest = {\n  preserve_modified?: boolean\n  exclude_target_ids?: string[]\n}\n```\n\n### `RestoreSnapshotResponse`\n\n```ts\ntype RestoreSnapshotResponse = {\n  id: string\n  status: "restoring"\n}\n```\n\n### `Snapshot`\n\n```ts\ntype Snapshot = {\n  id: string\n  org_id: string\n  name: string\n  description?: string\n  trigger: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resource_counts: Record<string, number>\n  create: {\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      target_id: { ... }\n      reason: { ... }\n    }>\n  }\n  restores: Array<{\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      target_id: { ... }\n      reason: { ... }\n    }>\n  }>\n  matched_count?: number\n  scope?: "selection" | "org"\n  expires_at?: string // date-time\n  capture_summary?: {\n    total: number\n    captured: number\n    skipped: number\n    failed: number\n  }\n}\n```\n\n### `Operation`\n\n```ts\ntype Operation = {\n  type: "create" | "restore"\n  started_at: string // date-time\n  completed_at?: string // date-time\n  status: "in_progress" | "completed" | "partial" | "failed"\n  error?: string\n  triggered_by: {\n    name: string\n    user_id?: string\n    token_id?: string\n  }\n  skipped?: Array<{\n    target_id: string\n    reason: "modified"\n  }>\n}\n```\n\n### `SkippedResource`\n\n```ts\ntype SkippedResource = {\n  target_id: string\n  reason: "modified"\n}\n```\n\n### `CallerIdentity`\n\n```ts\ntype CallerIdentity = {\n  name: string\n  user_id?: string\n  token_id?: string\n}\n```\n';
+
+
+exports.default = snapshot_default;

package/dist/snapshot-Y6A7QUYS.js

@@ -0,0 +1,7 @@
+import "./chunk-YPSWSI3M.js";
+
+// src/docs/snapshot.json
+var snapshot_default = '# Snapshot API\n\n- **Base URL:** `https://snapshot.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/snapshot](https://docs.epilot.io/api/snapshot)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.snapshot.createSnapshot(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/snapshot\'\n\nconst snapshotClient = getClient()\nauthorize(snapshotClient, () => \'<token>\')\nconst { data } = await snapshotClient.createSnapshot(...)\n```\n\n## Operations\n\n**Snapshots**\n- [`createSnapshot`](#createsnapshot)\n- [`listSnapshots`](#listsnapshots)\n- [`captureOrgSnapshot`](#captureorgsnapshot)\n- [`getSnapshot`](#getsnapshot)\n- [`deleteSnapshot`](#deletesnapshot)\n- [`restoreSnapshot`](#restoresnapshot)\n- [`listSnapshotResources`](#listsnapshotresources)\n- [`getSnapshotResource`](#getsnapshotresource)\n- [`listDependencies`](#listdependencies)\n\n**Schemas**\n- [`Error`](#error)\n- [`EmptyInventoryError`](#emptyinventoryerror)\n- [`ResourceRef`](#resourceref)\n- [`SnapshotResourceSummary`](#snapshotresourcesummary)\n- [`SnapshotResourceList`](#snapshotresourcelist)\n- [`SnapshotResourceDetail`](#snapshotresourcedetail)\n- [`CreateSnapshotRequest`](#createsnapshotrequest)\n- [`CreateOrgSnapshotRequest`](#createorgsnapshotrequest)\n- [`CreateSnapshotResponse`](#createsnapshotresponse)\n- [`RestoreSnapshotRequest`](#restoresnapshotrequest)\n- [`RestoreSnapshotResponse`](#restoresnapshotresponse)\n- [`Snapshot`](#snapshot)\n- [`Operation`](#operation)\n- [`SkippedResource`](#skippedresource)\n- [`CallerIdentity`](#calleridentity)\n\n### `createSnapshot`\n\nCreate a new snapshot of the given resources. Async \u2014 returns immediately\nwith a snapshot ID; client polls `getSnapshot` until `create.status`\nmoves from `in_progress` to `completed` or `failed`.\n\n`POST /v1/snapshots`\n\n```ts\nconst { data } = await client.createSnapshot(\n  null,\n  {\n    name: \'string\',\n    description: \'string\',\n    trigger: \'manual\',\n    blueprint_instance_id: \'string\',\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n---\n\n### `listSnapshots`\n\nList snapshots for the caller\'s organization, newest first.\n\n`GET /v1/snapshots`\n\n```ts\nconst { data } = await client.listSnapshots({\n  cursor: \'example\',\n  size: 1,\n  resource: [\'...\'],\n  trigger: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "page_size": 0,\n  "cursor": "string",\n  "results": [\n    {\n      "id": "string",\n      "org_id": "string",\n      "name": "string",\n      "description": "string",\n      "trigger": "manual",\n      "blueprint_instance_id": "string",\n      "resource_counts": {},\n      "create": {\n        "type": "create",\n        "started_at": "1970-01-01T00:00:00.000Z",\n        "completed_at": "1970-01-01T00:00:00.000Z",\n        "status": "in_progress",\n        "error": "string",\n        "triggered_by": {\n          "name": "string",\n          "user_id": "string",\n          "token_id": "string"\n        },\n        "skipped": [\n          {\n            "target_id": "string",\n            "reason": "modified"\n          }\n        ]\n      },\n      "restores": [\n        {\n          "type": "create",\n          "started_at": "1970-01-01T00:00:00.000Z",\n          "completed_at": "1970-01-01T00:00:00.000Z",\n          "status": "in_progress",\n          "error": "string",\n          "triggered_by": {\n            "name": "string",\n            "user_id": "string",\n            "token_id": "string"\n          },\n          "skipped": [\n            {\n              "target_id": "string",\n              "reason": "modified"\n            }\n          ]\n        }\n      ],\n      "matched_count": 0,\n      "scope": "selection",\n      "expires_at": "1970-01-01T00:00:00.000Z",\n      "capture_summary": {\n        "total": 0,\n        "captured": 0,\n        "skipped": 0,\n        "failed": 0\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `captureOrgSnapshot`\n\nSnapshot the caller\'s whole organization now. Fetches a fresh inventory\nof the org\'s configuration resources from configuration-hub-api, persists\nit as an inventory artifact, and starts a `scope: "org\n\n`POST /v1/snapshots:capture-org`\n\n```ts\nconst { data } = await client.captureOrgSnapshot(\n  null,\n  {\n    name: \'string\',\n    retention: {\n      value: 1,\n      unit: \'days\'\n    },\n    excluded_types: [\'string\']\n  },\n)\n```\n\n---\n\n### `getSnapshot`\n\nFetch a snapshot\'s metadata. Poll this endpoint to track create/restore progress.\n\n`GET /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.getSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "trigger": "manual",\n  "blueprint_instance_id": "string",\n  "resource_counts": {},\n  "create": {\n    "type": "create",\n    "started_at": "1970-01-01T00:00:00.000Z",\n    "completed_at": "1970-01-01T00:00:00.000Z",\n    "status": "in_progress",\n    "error": "string",\n    "triggered_by": {\n      "name": "string",\n      "user_id": "string",\n      "token_id": "string"\n    },\n    "skipped": [\n      {\n        "target_id": "string",\n        "reason": "modified"\n      }\n    ]\n  },\n  "restores": [\n    {\n      "type": "create",\n      "started_at": "1970-01-01T00:00:00.000Z",\n      "completed_at": "1970-01-01T00:00:00.000Z",\n      "status": "in_progress",\n      "error": "string",\n      "triggered_by": {\n        "name": "string",\n        "user_id": "string",\n        "token_id": "string"\n      },\n      "skipped": [\n        {\n          "target_id": "string",\n          "reason": "modified"\n        }\n      ]\n    }\n  ],\n  "matched_count": 0,\n  "scope": "selection",\n  "expires_at": "1970-01-01T00:00:00.000Z",\n  "capture_summary": {\n    "total": 0,\n    "captured": 0,\n    "skipped": 0,\n    "failed": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteSnapshot`\n\nDelete a snapshot\'s metadata and S3 manifest.\n\n`DELETE /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.deleteSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n---\n\n### `restoreSnapshot`\n\nRestore a snapshot to the org. Async \u2014 returns immediately; client polls\n`getSnapshot` until the latest entry in `restores` moves from\n`in_progress` to one of `completed | partial | failed`.\n\n`POST /v1/snapshots/{id}:restore`\n\n```ts\nconst { data } = await client.restoreSnapshot(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    preserve_modified: false,\n    exclude_target_ids: [\'string\']\n  },\n)\n```\n\n---\n\n### `listSnapshotResources`\n\nList the resources captured in this snapshot. Returns lightweight\nidentity fields per resource \u2014 payloads are fetched via the\nsingle-resource endpoint when needed.\n\n`GET /v1/snapshots/{id}/resources`\n\n```ts\nconst { data } = await client.listSnapshotResources({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "resources": [\n    {\n      "lineage_id": "string",\n      "target_id": "string",\n      "type": "string",\n      "name": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getSnapshotResource`\n\nFetch one captured resource with its full payload. For UI views\nthat diff the captured state against the current destination.\n\n`GET /v1/snapshots/{id}/resources/{lineage_id}`\n\n```ts\nconst { data } = await client.getSnapshotResource({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n  lineage_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "lineage_id": "string",\n  "target_id": "string",\n  "type": "string",\n  "name": "string",\n  "captured": {}\n}\n```\n\n</details>\n\n---\n\n### `listDependencies`\n\nWalk the dependency tree for a set of resources and return the full\ntransitive closure, topologically sorted.\n\n`POST /v1/snapshots:list-dependencies`\n\n```ts\nconst { data } = await client.listDependencies(\n  null,\n  {\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "dependencies": [\n    {\n      "type": "string",\n      "id": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `Error`\n\n```ts\ntype Error = {\n  status: number\n  error: string\n}\n```\n\n### `EmptyInventoryError`\n\nReturned (422) when the org inventory contains no capturable resources\nafter filtering out sensitive, unsupported, and excluded types. The\n`skipped_types` array explains why every type was dropped.\n\n\n```ts\ntype EmptyInventoryError = {\n  message: string\n  skipped_types: Array<{\n    type: string\n    reason: string\n  }>\n}\n```\n\n### `ResourceRef`\n\n```ts\ntype ResourceRef = {\n  type: string\n  id: string\n}\n```\n\n### `SnapshotResourceSummary`\n\nLightweight identity for a captured resource. Returned by\n`listSnapshotResources`; the full payload is fetched separately via\n`getSnapshotResource` when needed.\n\n\n```ts\ntype SnapshotResourceSummary = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n}\n```\n\n### `SnapshotResourceList`\n\n```ts\ntype SnapshotResourceList = {\n  resources: Array<{\n    lineage_id: string\n    target_id: string\n    type: string\n    name?: string\n  }>\n}\n```\n\n### `SnapshotResourceDetail`\n\nA single captured resource with its full payload. The identity fields\nmatch `SnapshotResourceSummary`; the `captured` payload is the\npre-install state at snapshot time.\n\n\n```ts\ntype SnapshotResourceDetail = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n  captured: Record<string, unknown>\n}\n```\n\n### `CreateSnapshotRequest`\n\n```ts\ntype CreateSnapshotRequest = {\n  name: string\n  description?: string\n  trigger?: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resources: Array<{\n    type: string\n    id: string\n  }>\n}\n```\n\n### `CreateOrgSnapshotRequest`\n\nRequest body for `captureOrgSnapshot`. All fields optional \u2014 an empty body\nsnapshots the whole org with a default name and the 90-day default TTL.\n\n\n```ts\ntype CreateOrgSnapshotRequest = {\n  name?: string\n  retention?: {\n    value: number\n    unit: "days" | "weeks" | "months"\n  }\n  excluded_types?: string[]\n}\n```\n\n### `CreateSnapshotResponse`\n\n```ts\ntype CreateSnapshotResponse = {\n  id: string\n  name: string\n  status: "creating"\n  created_at: string // date-time\n}\n```\n\n### `RestoreSnapshotRequest`\n\nApply a captured snapshot to its source org. All filters default to the\nopen setting (apply everything), which keeps Config Hub\'s manual-restore\nsemantics unchanged.\n\n\n```ts\ntype RestoreSnapshotRequest = {\n  preserve_modified?: boolean\n  exclude_target_ids?: string[]\n}\n```\n\n### `RestoreSnapshotResponse`\n\n```ts\ntype RestoreSnapshotResponse = {\n  id: string\n  status: "restoring"\n}\n```\n\n### `Snapshot`\n\n```ts\ntype Snapshot = {\n  id: string\n  org_id: string\n  name: string\n  description?: string\n  trigger: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resource_counts: Record<string, number>\n  create: {\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      target_id: { ... }\n      reason: { ... }\n    }>\n  }\n  restores: Array<{\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      target_id: { ... }\n      reason: { ... }\n    }>\n  }>\n  matched_count?: number\n  scope?: "selection" | "org"\n  expires_at?: string // date-time\n  capture_summary?: {\n    total: number\n    captured: number\n    skipped: number\n    failed: number\n  }\n}\n```\n\n### `Operation`\n\n```ts\ntype Operation = {\n  type: "create" | "restore"\n  started_at: string // date-time\n  completed_at?: string // date-time\n  status: "in_progress" | "completed" | "partial" | "failed"\n  error?: string\n  triggered_by: {\n    name: string\n    user_id?: string\n    token_id?: string\n  }\n  skipped?: Array<{\n    target_id: string\n    reason: "modified"\n  }>\n}\n```\n\n### `SkippedResource`\n\n```ts\ntype SkippedResource = {\n  target_id: string\n  reason: "modified"\n}\n```\n\n### `CallerIdentity`\n\n```ts\ntype CallerIdentity = {\n  name: string\n  user_id?: string\n  token_id?: string\n}\n```\n';
+export {
+  snapshot_default as default
+};

package/dist/{snapshot.d-D5z6-hzE.d.cts → snapshot.d-CPTXg4xN.d.cts}

@@ -109,18 +109,19 @@ declare namespace Components {
             started_at: string; // date-time
             completed_at?: string; // date-time
             /**
-             * `partial` indicates the operation completed but skipped at least
-             * one resource — see `skipped`. Only populated by restores triggered
-             * with `mode: 'preserve_edits'`.
+             * `partial` indicates the operation completed but snapshot-api
+             * skipped at least one captured resource via its own drift check
+             * (see `skipped`).
              *
              */
             status: "in_progress" | "completed" | "partial" | "failed";
             error?: string;
             triggered_by: CallerIdentity;
             /**
-             * Per-resource skips, populated only for restores triggered with
-             * `mode: 'preserve_edits'`. Empty / absent for Config Hub's
-             * default overwrite-mode restores.
+             * Captured resources snapshot-api elected to skip — currently
+             * only drift detections (`preserve_modified: true`). Caller-
+             * supplied `exclude_target_ids` skips are NOT echoed here; the
+             * caller built the list, the caller knows.
              *
              */
             skipped?: SkippedResource[];
@@ -133,37 +134,27 @@ declare namespace Components {
             id: string;
         }
         /**
-         * Skipped resources surface under `Operation.skipped`. All filters default
-         * to the open setting (apply everything), which keeps Config Hub's manual-
-         * restore semantics unchanged.
+         * Apply a captured snapshot to its source org. All filters default to the
+         * open setting (apply everything), which keeps Config Hub's manual-restore
+         * semantics unchanged.
          *
          */
         export interface RestoreSnapshotRequest {
             /**
              * When `true`, skip captured resources whose live payload's content
              * fingerprint diverges from the capture-time fingerprint stored on
-             * the manifest entry. Self-contained: snapshot-api fetches and hashes
-             * the live payload itself; no cross-service lookup. Surfaces under
+             * the manifest entry. snapshot-api fetches the live payload and
+             * hashes it itself; no cross-service lookup. Surfaces under
              * `Operation.skipped` with `reason: 'modified'`. Legacy snapshots
              * captured before fingerprints were stored fail open (applied).
              *
              */
             preserve_modified?: boolean;
-            /**
-             * Deprecated. Accepted for back-compat but treated as a no-op.
-             * Co-ownership is now expressed via `exclude_target_ids` — the caller
-             * (typically blueprint-manifest-api) computes which targets to skip
-             * from its own data and passes the list. snapshot-api no longer
-             * reaches into BMA's lineage table.
-             *
-             */
-            preserve_co_owned?: boolean;
             /**
              * Target ids the caller has decided not to restore. snapshot-api
-             * applies the manifest minus these ids and reports them under
-             * `Operation.skipped` with `reason: 'co_owned'` (the only current
-             * producer of exclude lists is BMA's revert flow, which uses this to
-             * honor multi-blueprint ownership).
+             * applies the manifest minus these ids. Drops are silent — not
+             * echoed in `Operation.skipped` — because the caller supplied the
+             * list and already knows.
              *
              */
             exclude_target_ids?: string[];
@@ -173,16 +164,15 @@ declare namespace Components {
             status: "restoring";
         }
         export interface SkippedResource {
-            lineage_id: string;
+            target_id: string;
             /**
-             * - `modified` — current destination payload's fingerprint differs
-             *   from the install-time fingerprint on the lineage row.
-             * - `co_owned` — lineage row has ≥2 distinct
-             *   `blueprint_instance_ids`; restoring would unilaterally affect
-             *   another blueprint instance's contribution.
+             * - `modified` — live destination payload's content fingerprint
+             *   differs from the capture-time fingerprint stored on the
+             *   manifest entry. Only set when the restore was requested with
+             *   `preserve_modified: true`.
              *
              */
-            reason: "modified" | "co_owned";
+            reason: "modified";
         }
         export interface Snapshot {
             id: string;
@@ -410,9 +400,9 @@ declare namespace Paths {
     }
     namespace RestoreSnapshot {
         export type RequestBody = /**
-         * Skipped resources surface under `Operation.skipped`. All filters default
-         * to the open setting (apply everything), which keeps Config Hub's manual-
-         * restore semantics unchanged.
+         * Apply a captured snapshot to its source org. All filters default to the
+         * open setting (apply everything), which keeps Config Hub's manual-restore
+         * semantics unchanged.
          *
          */
         Components.Schemas.RestoreSnapshotRequest;

package/dist/{snapshot.d-D5z6-hzE.d.ts → snapshot.d-CPTXg4xN.d.ts}

@@ -109,18 +109,19 @@ declare namespace Components {
             started_at: string; // date-time
             completed_at?: string; // date-time
             /**
-             * `partial` indicates the operation completed but skipped at least
-             * one resource — see `skipped`. Only populated by restores triggered
-             * with `mode: 'preserve_edits'`.
+             * `partial` indicates the operation completed but snapshot-api
+             * skipped at least one captured resource via its own drift check
+             * (see `skipped`).
              *
              */
             status: "in_progress" | "completed" | "partial" | "failed";
             error?: string;
             triggered_by: CallerIdentity;
             /**
-             * Per-resource skips, populated only for restores triggered with
-             * `mode: 'preserve_edits'`. Empty / absent for Config Hub's
-             * default overwrite-mode restores.
+             * Captured resources snapshot-api elected to skip — currently
+             * only drift detections (`preserve_modified: true`). Caller-
+             * supplied `exclude_target_ids` skips are NOT echoed here; the
+             * caller built the list, the caller knows.
              *
              */
             skipped?: SkippedResource[];
@@ -133,37 +134,27 @@ declare namespace Components {
             id: string;
         }
         /**
-         * Skipped resources surface under `Operation.skipped`. All filters default
-         * to the open setting (apply everything), which keeps Config Hub's manual-
-         * restore semantics unchanged.
+         * Apply a captured snapshot to its source org. All filters default to the
+         * open setting (apply everything), which keeps Config Hub's manual-restore
+         * semantics unchanged.
          *
          */
         export interface RestoreSnapshotRequest {
             /**
              * When `true`, skip captured resources whose live payload's content
              * fingerprint diverges from the capture-time fingerprint stored on
-             * the manifest entry. Self-contained: snapshot-api fetches and hashes
-             * the live payload itself; no cross-service lookup. Surfaces under
+             * the manifest entry. snapshot-api fetches the live payload and
+             * hashes it itself; no cross-service lookup. Surfaces under
              * `Operation.skipped` with `reason: 'modified'`. Legacy snapshots
              * captured before fingerprints were stored fail open (applied).
              *
              */
             preserve_modified?: boolean;
-            /**
-             * Deprecated. Accepted for back-compat but treated as a no-op.
-             * Co-ownership is now expressed via `exclude_target_ids` — the caller
-             * (typically blueprint-manifest-api) computes which targets to skip
-             * from its own data and passes the list. snapshot-api no longer
-             * reaches into BMA's lineage table.
-             *
-             */
-            preserve_co_owned?: boolean;
             /**
              * Target ids the caller has decided not to restore. snapshot-api
-             * applies the manifest minus these ids and reports them under
-             * `Operation.skipped` with `reason: 'co_owned'` (the only current
-             * producer of exclude lists is BMA's revert flow, which uses this to
-             * honor multi-blueprint ownership).
+             * applies the manifest minus these ids. Drops are silent — not
+             * echoed in `Operation.skipped` — because the caller supplied the
+             * list and already knows.
              *
              */
             exclude_target_ids?: string[];
@@ -173,16 +164,15 @@ declare namespace Components {
             status: "restoring";
         }
         export interface SkippedResource {
-            lineage_id: string;
+            target_id: string;
             /**
-             * - `modified` — current destination payload's fingerprint differs
-             *   from the install-time fingerprint on the lineage row.
-             * - `co_owned` — lineage row has ≥2 distinct
-             *   `blueprint_instance_ids`; restoring would unilaterally affect
-             *   another blueprint instance's contribution.
+             * - `modified` — live destination payload's content fingerprint
+             *   differs from the capture-time fingerprint stored on the
+             *   manifest entry. Only set when the restore was requested with
+             *   `preserve_modified: true`.
              *
              */
-            reason: "modified" | "co_owned";
+            reason: "modified";
         }
         export interface Snapshot {
             id: string;
@@ -410,9 +400,9 @@ declare namespace Paths {
     }
     namespace RestoreSnapshot {
         export type RequestBody = /**
-         * Skipped resources surface under `Operation.skipped`. All filters default
-         * to the open setting (apply everything), which keeps Config Hub's manual-
-         * restore semantics unchanged.
+         * Apply a captured snapshot to its source org. All filters default to the
+         * open setting (apply everything), which keeps Config Hub's manual-restore
+         * semantics unchanged.
          *
          */
         Components.Schemas.RestoreSnapshotRequest;

package/docs/snapshot.md

@@ -124,7 +124,7 @@ const { data } = await client.listSnapshots({
         },
         "skipped": [
           {
-            "lineage_id": "string",
+            "target_id": "string",
             "reason": "modified"
           }
         ]
@@ -143,7 +143,7 @@ const { data } = await client.listSnapshots({
           },
           "skipped": [
             {
-              "lineage_id": "string",
+              "target_id": "string",
               "reason": "modified"
             }
           ]
@@ -228,7 +228,7 @@ const { data } = await client.getSnapshot({
     },
     "skipped": [
       {
-        "lineage_id": "string",
+        "target_id": "string",
         "reason": "modified"
       }
     ]
@@ -247,7 +247,7 @@ const { data } = await client.getSnapshot({
       },
       "skipped": [
         {
-          "lineage_id": "string",
+          "target_id": "string",
           "reason": "modified"
         }
       ]
@@ -298,7 +298,6 @@ const { data } = await client.restoreSnapshot(
   },
   {
     preserve_modified: false,
-    preserve_co_owned: false,
     exclude_target_ids: ['string']
   },
 )
@@ -538,15 +537,14 @@ type CreateSnapshotResponse = {
 
 ### `RestoreSnapshotRequest`
 
-Skipped resources surface under `Operation.skipped`. All filters default
-to the open setting (apply everything), which keeps Config Hub's manual-
-restore semantics unchanged.
+Apply a captured snapshot to its source org. All filters default to the
+open setting (apply everything), which keeps Config Hub's manual-restore
+semantics unchanged.
 
 
 ```ts
 type RestoreSnapshotRequest = {
   preserve_modified?: boolean
-  preserve_co_owned?: boolean
   exclude_target_ids?: string[]
 }
 ```
@@ -583,7 +581,7 @@ type Snapshot = {
       token_id?: { ... }
     }
     skipped?: Array<{
-      lineage_id: { ... }
+      target_id: { ... }
       reason: { ... }
     }>
   }
@@ -599,7 +597,7 @@ type Snapshot = {
       token_id?: { ... }
     }
     skipped?: Array<{
-      lineage_id: { ... }
+      target_id: { ... }
       reason: { ... }
     }>
   }>
@@ -630,8 +628,8 @@ type Operation = {
     token_id?: string
   }
   skipped?: Array<{
-    lineage_id: string
-    reason: "modified" | "co_owned"
+    target_id: string
+    reason: "modified"
   }>
 }
 ```
@@ -640,8 +638,8 @@ type Operation = {
 
 ```ts
 type SkippedResource = {
-  lineage_id: string
-  reason: "modified" | "co_owned"
+  target_id: string
+  reason: "modified"
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.8.9",
+  "version": "2.8.10",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/snapshot-6CCO4NYL.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/snapshot.json
-var snapshot_default = '# Snapshot API\n\n- **Base URL:** `https://snapshot.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/snapshot](https://docs.epilot.io/api/snapshot)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.snapshot.createSnapshot(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/snapshot\'\n\nconst snapshotClient = getClient()\nauthorize(snapshotClient, () => \'<token>\')\nconst { data } = await snapshotClient.createSnapshot(...)\n```\n\n## Operations\n\n**Snapshots**\n- [`createSnapshot`](#createsnapshot)\n- [`listSnapshots`](#listsnapshots)\n- [`captureOrgSnapshot`](#captureorgsnapshot)\n- [`getSnapshot`](#getsnapshot)\n- [`deleteSnapshot`](#deletesnapshot)\n- [`restoreSnapshot`](#restoresnapshot)\n- [`listSnapshotResources`](#listsnapshotresources)\n- [`getSnapshotResource`](#getsnapshotresource)\n- [`listDependencies`](#listdependencies)\n\n**Schemas**\n- [`Error`](#error)\n- [`EmptyInventoryError`](#emptyinventoryerror)\n- [`ResourceRef`](#resourceref)\n- [`SnapshotResourceSummary`](#snapshotresourcesummary)\n- [`SnapshotResourceList`](#snapshotresourcelist)\n- [`SnapshotResourceDetail`](#snapshotresourcedetail)\n- [`CreateSnapshotRequest`](#createsnapshotrequest)\n- [`CreateOrgSnapshotRequest`](#createorgsnapshotrequest)\n- [`CreateSnapshotResponse`](#createsnapshotresponse)\n- [`RestoreSnapshotRequest`](#restoresnapshotrequest)\n- [`RestoreSnapshotResponse`](#restoresnapshotresponse)\n- [`Snapshot`](#snapshot)\n- [`Operation`](#operation)\n- [`SkippedResource`](#skippedresource)\n- [`CallerIdentity`](#calleridentity)\n\n### `createSnapshot`\n\nCreate a new snapshot of the given resources. Async \u2014 returns immediately\nwith a snapshot ID; client polls `getSnapshot` until `create.status`\nmoves from `in_progress` to `completed` or `failed`.\n\n`POST /v1/snapshots`\n\n```ts\nconst { data } = await client.createSnapshot(\n  null,\n  {\n    name: \'string\',\n    description: \'string\',\n    trigger: \'manual\',\n    blueprint_instance_id: \'string\',\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n---\n\n### `listSnapshots`\n\nList snapshots for the caller\'s organization, newest first.\n\n`GET /v1/snapshots`\n\n```ts\nconst { data } = await client.listSnapshots({\n  cursor: \'example\',\n  size: 1,\n  resource: [\'...\'],\n  trigger: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "page_size": 0,\n  "cursor": "string",\n  "results": [\n    {\n      "id": "string",\n      "org_id": "string",\n      "name": "string",\n      "description": "string",\n      "trigger": "manual",\n      "blueprint_instance_id": "string",\n      "resource_counts": {},\n      "create": {\n        "type": "create",\n        "started_at": "1970-01-01T00:00:00.000Z",\n        "completed_at": "1970-01-01T00:00:00.000Z",\n        "status": "in_progress",\n        "error": "string",\n        "triggered_by": {\n          "name": "string",\n          "user_id": "string",\n          "token_id": "string"\n        },\n        "skipped": [\n          {\n            "lineage_id": "string",\n            "reason": "modified"\n          }\n        ]\n      },\n      "restores": [\n        {\n          "type": "create",\n          "started_at": "1970-01-01T00:00:00.000Z",\n          "completed_at": "1970-01-01T00:00:00.000Z",\n          "status": "in_progress",\n          "error": "string",\n          "triggered_by": {\n            "name": "string",\n            "user_id": "string",\n            "token_id": "string"\n          },\n          "skipped": [\n            {\n              "lineage_id": "string",\n              "reason": "modified"\n            }\n          ]\n        }\n      ],\n      "matched_count": 0,\n      "scope": "selection",\n      "expires_at": "1970-01-01T00:00:00.000Z",\n      "capture_summary": {\n        "total": 0,\n        "captured": 0,\n        "skipped": 0,\n        "failed": 0\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `captureOrgSnapshot`\n\nSnapshot the caller\'s whole organization now. Fetches a fresh inventory\nof the org\'s configuration resources from configuration-hub-api, persists\nit as an inventory artifact, and starts a `scope: "org\n\n`POST /v1/snapshots:capture-org`\n\n```ts\nconst { data } = await client.captureOrgSnapshot(\n  null,\n  {\n    name: \'string\',\n    retention: {\n      value: 1,\n      unit: \'days\'\n    },\n    excluded_types: [\'string\']\n  },\n)\n```\n\n---\n\n### `getSnapshot`\n\nFetch a snapshot\'s metadata. Poll this endpoint to track create/restore progress.\n\n`GET /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.getSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "org_id": "string",\n  "name": "string",\n  "description": "string",\n  "trigger": "manual",\n  "blueprint_instance_id": "string",\n  "resource_counts": {},\n  "create": {\n    "type": "create",\n    "started_at": "1970-01-01T00:00:00.000Z",\n    "completed_at": "1970-01-01T00:00:00.000Z",\n    "status": "in_progress",\n    "error": "string",\n    "triggered_by": {\n      "name": "string",\n      "user_id": "string",\n      "token_id": "string"\n    },\n    "skipped": [\n      {\n        "lineage_id": "string",\n        "reason": "modified"\n      }\n    ]\n  },\n  "restores": [\n    {\n      "type": "create",\n      "started_at": "1970-01-01T00:00:00.000Z",\n      "completed_at": "1970-01-01T00:00:00.000Z",\n      "status": "in_progress",\n      "error": "string",\n      "triggered_by": {\n        "name": "string",\n        "user_id": "string",\n        "token_id": "string"\n      },\n      "skipped": [\n        {\n          "lineage_id": "string",\n          "reason": "modified"\n        }\n      ]\n    }\n  ],\n  "matched_count": 0,\n  "scope": "selection",\n  "expires_at": "1970-01-01T00:00:00.000Z",\n  "capture_summary": {\n    "total": 0,\n    "captured": 0,\n    "skipped": 0,\n    "failed": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteSnapshot`\n\nDelete a snapshot\'s metadata and S3 manifest.\n\n`DELETE /v1/snapshots/{id}`\n\n```ts\nconst { data } = await client.deleteSnapshot({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n---\n\n### `restoreSnapshot`\n\nRestore a snapshot to the org. Async \u2014 returns immediately; client polls\n`getSnapshot` until the latest entry in `restores` moves from\n`in_progress` to one of `completed | partial | failed`.\n\n`POST /v1/snapshots/{id}:restore`\n\n```ts\nconst { data } = await client.restoreSnapshot(\n  {\n    id: \'123e4567-e89b-12d3-a456-426614174000\',\n  },\n  {\n    preserve_modified: false,\n    preserve_co_owned: false,\n    exclude_target_ids: [\'string\']\n  },\n)\n```\n\n---\n\n### `listSnapshotResources`\n\nList the resources captured in this snapshot. Returns lightweight\nidentity fields per resource \u2014 payloads are fetched via the\nsingle-resource endpoint when needed.\n\n`GET /v1/snapshots/{id}/resources`\n\n```ts\nconst { data } = await client.listSnapshotResources({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "resources": [\n    {\n      "lineage_id": "string",\n      "target_id": "string",\n      "type": "string",\n      "name": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getSnapshotResource`\n\nFetch one captured resource with its full payload. For UI views\nthat diff the captured state against the current destination.\n\n`GET /v1/snapshots/{id}/resources/{lineage_id}`\n\n```ts\nconst { data } = await client.getSnapshotResource({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n  lineage_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "lineage_id": "string",\n  "target_id": "string",\n  "type": "string",\n  "name": "string",\n  "captured": {}\n}\n```\n\n</details>\n\n---\n\n### `listDependencies`\n\nWalk the dependency tree for a set of resources and return the full\ntransitive closure, topologically sorted.\n\n`POST /v1/snapshots:list-dependencies`\n\n```ts\nconst { data } = await client.listDependencies(\n  null,\n  {\n    resources: [\n      {\n        type: \'string\',\n        id: \'string\'\n      }\n    ]\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "dependencies": [\n    {\n      "type": "string",\n      "id": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `Error`\n\n```ts\ntype Error = {\n  status: number\n  error: string\n}\n```\n\n### `EmptyInventoryError`\n\nReturned (422) when the org inventory contains no capturable resources\nafter filtering out sensitive, unsupported, and excluded types. The\n`skipped_types` array explains why every type was dropped.\n\n\n```ts\ntype EmptyInventoryError = {\n  message: string\n  skipped_types: Array<{\n    type: string\n    reason: string\n  }>\n}\n```\n\n### `ResourceRef`\n\n```ts\ntype ResourceRef = {\n  type: string\n  id: string\n}\n```\n\n### `SnapshotResourceSummary`\n\nLightweight identity for a captured resource. Returned by\n`listSnapshotResources`; the full payload is fetched separately via\n`getSnapshotResource` when needed.\n\n\n```ts\ntype SnapshotResourceSummary = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n}\n```\n\n### `SnapshotResourceList`\n\n```ts\ntype SnapshotResourceList = {\n  resources: Array<{\n    lineage_id: string\n    target_id: string\n    type: string\n    name?: string\n  }>\n}\n```\n\n### `SnapshotResourceDetail`\n\nA single captured resource with its full payload. The identity fields\nmatch `SnapshotResourceSummary`; the `captured` payload is the\npre-install state at snapshot time.\n\n\n```ts\ntype SnapshotResourceDetail = {\n  lineage_id: string\n  target_id: string\n  type: string\n  name?: string\n  captured: Record<string, unknown>\n}\n```\n\n### `CreateSnapshotRequest`\n\n```ts\ntype CreateSnapshotRequest = {\n  name: string\n  description?: string\n  trigger?: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resources: Array<{\n    type: string\n    id: string\n  }>\n}\n```\n\n### `CreateOrgSnapshotRequest`\n\nRequest body for `captureOrgSnapshot`. All fields optional \u2014 an empty body\nsnapshots the whole org with a default name and the 90-day default TTL.\n\n\n```ts\ntype CreateOrgSnapshotRequest = {\n  name?: string\n  retention?: {\n    value: number\n    unit: "days" | "weeks" | "months"\n  }\n  excluded_types?: string[]\n}\n```\n\n### `CreateSnapshotResponse`\n\n```ts\ntype CreateSnapshotResponse = {\n  id: string\n  name: string\n  status: "creating"\n  created_at: string // date-time\n}\n```\n\n### `RestoreSnapshotRequest`\n\nSkipped resources surface under `Operation.skipped`. All filters default\nto the open setting (apply everything), which keeps Config Hub\'s manual-\nrestore semantics unchanged.\n\n\n```ts\ntype RestoreSnapshotRequest = {\n  preserve_modified?: boolean\n  preserve_co_owned?: boolean\n  exclude_target_ids?: string[]\n}\n```\n\n### `RestoreSnapshotResponse`\n\n```ts\ntype RestoreSnapshotResponse = {\n  id: string\n  status: "restoring"\n}\n```\n\n### `Snapshot`\n\n```ts\ntype Snapshot = {\n  id: string\n  org_id: string\n  name: string\n  description?: string\n  trigger: "manual" | "sync" | "blueprint_install" | "scheduled"\n  blueprint_instance_id?: string\n  resource_counts: Record<string, number>\n  create: {\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      lineage_id: { ... }\n      reason: { ... }\n    }>\n  }\n  restores: Array<{\n    type: "create" | "restore"\n    started_at: string // date-time\n    completed_at?: string // date-time\n    status: "in_progress" | "completed" | "partial" | "failed"\n    error?: string\n    triggered_by: {\n      name: { ... }\n      user_id?: { ... }\n      token_id?: { ... }\n    }\n    skipped?: Array<{\n      lineage_id: { ... }\n      reason: { ... }\n    }>\n  }>\n  matched_count?: number\n  scope?: "selection" | "org"\n  expires_at?: string // date-time\n  capture_summary?: {\n    total: number\n    captured: number\n    skipped: number\n    failed: number\n  }\n}\n```\n\n### `Operation`\n\n```ts\ntype Operation = {\n  type: "create" | "restore"\n  started_at: string // date-time\n  completed_at?: string // date-time\n  status: "in_progress" | "completed" | "partial" | "failed"\n  error?: string\n  triggered_by: {\n    name: string\n    user_id?: string\n    token_id?: string\n  }\n  skipped?: Array<{\n    lineage_id: string\n    reason: "modified" | "co_owned"\n  }>\n}\n```\n\n### `SkippedResource`\n\n```ts\ntype SkippedResource = {\n  lineage_id: string\n  reason: "modified" | "co_owned"\n}\n```\n\n### `CallerIdentity`\n\n```ts\ntype CallerIdentity = {\n  name: string\n  user_id?: string\n  token_id?: string\n}\n```\n';
-export {
-  snapshot_default as default
-};