Type Alias: PackImports
type PackImports = object;Defined in: packages/sdk/src/index.ts:900
Namespaced verbs for the shared pack-import runner (SK-SDK-014). See the
type comment above for the auth model: preflight is public, the mutating
legs are bearer-drivable so experts can embed the journey headlessly.
Methods
Section titled “Methods”advance()
Section titled “advance()”advance(id, opts?): Promise<{ import: PackImport;}>;Defined in: packages/sdk/src/index.ts:928
POST /v1/packs/imports/:id/advance — claim, provision the isolated
agent_memory_v1 DB, write, and verify, resolving with the settled
import. Account-scoped: an sk_live_/sk_mcp_ key or a session;
anon/pk_live reject with account_required (SK-PIVOT-010). A
concurrent advance returns import_busy (409) with the live draft.
Mutating: auto-keyed (SK-SDK-006).
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
id |
string |
opts? |
{ idempotencyKey?: string; signal?: AbortSignal; } |
opts.idempotencyKey? |
string |
opts.signal? |
AbortSignal |
Returns
Section titled “Returns”Promise<{
import: PackImport;
}>
create()
Section titled “create()”create(req, opts?): Promise<{ import: PackImport;}>;Defined in: packages/sdk/src/index.ts:910
POST /v1/packs/imports — create a draft and run the public preflight
(inspecting → saving) in one call, returning the previewed import.
No account required (GLOBAL-007): pass an account key or a session and
the draft is claimed immediately; otherwise it is claimed by the first
authenticated advance. Errors: unknown_pack (400, with
body.allowed), source_required (400), rate_limited (429),
source_unavailable (422). Mutating: auto-keyed (SK-SDK-006).
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
req |
CreatePackImportRequest |
opts? |
{ idempotencyKey?: string; signal?: AbortSignal; } |
opts.idempotencyKey? |
string |
opts.signal? |
AbortSignal |
Returns
Section titled “Returns”Promise<{
import: PackImport;
}>
delete()
Section titled “delete()”delete(id, opts?): Promise<void>;Defined in: packages/sdk/src/index.ts:946
DELETE /v1/packs/imports/:id — destroy the derived memory DB and the
draft (SK-HDC-016); the source is never touched. Account-scoped,
same boundary as advance. Idempotent: a re-DELETE of an
already-removed draft is import_not_found (404). Mutating: auto-keyed.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
id |
string |
opts? |
{ idempotencyKey?: string; signal?: AbortSignal; } |
opts.idempotencyKey? |
string |
opts.signal? |
AbortSignal |
Returns
Section titled “Returns”Promise<void>
get(id, opts?): Promise<{ import: PackImport;}>;Defined in: packages/sdk/src/index.ts:919
GET /v1/packs/imports/:id — the resume read: reopen the same phase. No
account required for an unclaimed draft (the id is the capability); a
claimed draft is readable only by its owner (import_not_found otherwise).
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
id |
string |
opts? |
{ signal?: AbortSignal; } |
opts.signal? |
AbortSignal |
Returns
Section titled “Returns”Promise<{
import: PackImport;
}>
retry()
Section titled “retry()”retry(id, opts?): Promise<{ import: PackImport;}>;Defined in: packages/sdk/src/index.ts:936
POST /v1/packs/imports/:id/retry — clear a stamped failure and resume
from the last checkpoint. Same auth + shape as advance.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
id |
string |
opts? |
{ idempotencyKey?: string; signal?: AbortSignal; } |
opts.idempotencyKey? |
string |
opts.signal? |
AbortSignal |
Returns
Section titled “Returns”Promise<{
import: PackImport;
}>