memax-sdk 0.7.0 → 0.8.0-alpha.212

package/README.md

@@ -43,25 +43,22 @@ const memax = new Memax({
 });
 
 // Push a memory
-await memax.push({
-  content: "Our staging DB is pooled through PgBouncer in transaction mode.",
-  tags: ["ops", "db"],
-});
+await memax.push(
+  "Our staging DB is pooled through PgBouncer in transaction mode.",
+  { tags: ["ops", "db"] },
+);
 
 // Recall with natural language
-const { memories } = await memax.recall({
-  query: "pooling strategy",
-  limit: 10,
-});
+const { memories } = await memax.recall("pooling strategy", { limit: 10 });
 
 // Ask — grounded answer with citations
-const { answer, citations } = await memax.ask({
-  query: "What mode does PgBouncer run in for staging?",
-});
+const { answer, citations } = await memax.ask(
+  "What mode does PgBouncer run in for staging?",
+);
 
 console.log(answer);
 for (const c of citations) {
-  console.log(`  ↳ ${c.memoryId} — ${c.snippet}`);
+  console.log(`  ↳ [${c.index}] ${c.memory_id} — ${c.title}`);
 }
 ```
 
@@ -70,21 +67,75 @@ for (const c of citations) {
 - **`push`** — save content, files, URLs, structured data; idempotent on content hash
 - **`recall`** — vector + lexical hybrid search with optional reranking
 - **`ask`** — AI-synthesized answer from your memory, with citations
-- **`memories.*`** — list, get, update, delete; filter by hub, tags, date, source
-- **`hubs.*`** — create, list, transfer, update members, manage roles
-- **`invites.*`** — create hub invites, list outstanding, revoke
+- **`memories.*`** — list, get, update, delete; filter by hub, kind, topic, date
+- **`hubs.*`** — create, list, transfer, update members, manage roles and invites
+- **`invites.*`** — look up and accept a hub invite
 - **`topics.*`** — inspect auto-generated topic clusters over your memory base
 - **`events.subscribe()`** — live server-sent events: new memories, hub changes, dream completion
-- **`capture.*`** — start and append to a capture session for streaming ingest
-- **Typed errors** — `MemaxError` with `code`, `status`, `retryable` for clean client handling
+- **`v2.*`** — the `/v2` API: the V2 record, Review, receipts, compiled files, Ask, export (below)
+- **Typed errors** — `MemaxError` with `code`, `status` and getters such as `isRateLimited` for clean client handling
 - **Runtime-portable** — works wherever `fetch` works
 
+## V2 API
+
+`memax.v2` talks to the `/v2` API, the V2 record: every change is a
+command with a receipt, agents propose and people keep. Its types are
+generated from the API contract and live under the `V2` namespace.
+
+```ts
+import { Memax, refusalOf, type V2 } from "memax-sdk";
+
+const memax = new Memax({ apiKey: process.env.MEMAX_API_KEY });
+
+// Commands need an Idempotency-Key: choose one per intent, reuse it on retry.
+const res: V2.CommandResult = await memax.v2.memories.remember(
+  "memax-v2", // space id or slug
+  { statement: "River is our queue, not Kafka.", section: "decisions" },
+  { idempotencyKey: crypto.randomUUID() },
+);
+res.outcome; // "applied" for a member or owner, "proposed" for an API key
+
+// Display IDs repeat across tenants, so they travel with their space.
+const { memory, versions, receipts } = await memax.v2.memories.get("M-0219", {
+  space: "memax-v2",
+});
+
+// Edits send the version they started from; a newer one is 412 edit_clash.
+await memax.v2.memories.edit(
+  memory.id,
+  { statement: "River is our only queue." },
+  { idempotencyKey: crypto.randomUUID(), ifMatch: memory.version },
+);
+
+try {
+  await memax.v2.memories.keep(
+    "M-0220",
+    {},
+    { space: "memax-v2", idempotencyKey: crypto.randomUUID() },
+  );
+} catch (err) {
+  refusalOf(err)?.code; // "person_must_review": API keys never keep
+}
+
+const queue = await memax.v2.review.list("memax-v2"); // queue.total waiting
+const activity = await memax.v2.receipts.list("memax-v2", { limit: 50 });
+```
+
+`memax.v2.ask` streams a cited answer as server-sent events, and
+`verifyExport` and `verifyReceiptChain` check an export and a space's
+receipt chain against its signed checkpoints, with no dependencies.
+
+The types are regenerated from `packages/server/openapi/v2.yaml` with
+`pnpm --filter memax-sdk gen:v2`; `pnpm lint` fails when they are stale.
+
 ## Authentication
 
-Get an API key at [memax.app → Settings → API Keys](https://memax.app/settings/api-keys). For browser / user-session auth (OAuth flow), pass a bearer token instead:
+Create an API key in Settings on [memax.app](https://memax.app). For browser / user-session auth (OAuth flow), pass the session's token through `auth` instead:
 
 ```ts
-const memax = new Memax({ bearerToken: session.accessToken });
+const memax = new Memax({
+  auth: async () => ({ Authorization: `Bearer ${session.accessToken}` }),
+});
 ```
 
 To target a non-default Memax API endpoint:
@@ -92,7 +143,7 @@ To target a non-default Memax API endpoint:
 ```ts
 const memax = new Memax({
   apiKey: "...",
-  baseUrl: "https://api.memax.app",
+  apiUrl: "https://api.memax.app",
 });
 ```
 
@@ -104,12 +155,12 @@ All failures throw `MemaxError`. The instance carries enough to drive retry and
 import { Memax, MemaxError } from "memax-sdk";
 
 try {
-  await memax.recall({ query: "..." });
+  await memax.recall("...");
 } catch (err) {
   if (err instanceof MemaxError) {
-    if (err.retryable) {
-      // transient — back off and retry
-    } else if (err.status === 401) {
+    if (err.isRateLimited || err.isServerError || err.isNetwork) {
+      // transient — back off (err.retryAfterSeconds when the server says) and retry
+    } else if (err.isUnauthorized) {
       // auth issue — prompt re-login
     }
     console.error(err.code, err.message);
@@ -121,15 +172,14 @@ try {
 ## Live events
 
 ```ts
-const unsubscribe = memax.events.subscribe(
-  { types: ["memory.created", "hub.updated"] },
-  (event) => {
-    console.log(event.type, event.data);
+const stream = memax.events.subscribe({
+  onEvent: (event, data) => {
+    console.log(event, data);
   },
-);
+});
 
 // later
-unsubscribe();
+stream.abort();
 ```
 
 ## Links

package/dist/client.d.ts

@@ -17,6 +17,7 @@ import { AccountResource } from "./resources/account.js";
 import { EventsResource } from "./resources/events.js";
 import { BarResource } from "./resources/bar.js";
 import { ChatsResource } from "./resources/chats.js";
+import { V2Resource } from "./v2/resources.js";
 export declare class Memax {
     readonly memories: MemoriesResource;
     readonly configs: ConfigsResource;
@@ -36,6 +37,11 @@ export declare class Memax {
     readonly events: EventsResource;
     readonly bar: BarResource;
     readonly chats: ChatsResource;
+    /**
+     * The /v2 API: the V2 record (spaces, memories, Review, receipts).
+     * Types are under the `V2` namespace export.
+     */
+    readonly v2: V2Resource;
     constructor(config: MemaxConfig);
     push(...args: Parameters<MemoriesResource["push"]>): Promise<import("./types.js").Memory>;
     recall(...args: Parameters<MemoriesResource["recall"]>): Promise<import("./types.js").RecallResult>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,qBAAa,KAAK;IAChB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;gBAElB,MAAM,EAAE,WAAW;IA+BzB,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAIlD,MAAM,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAItD,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;CAGvD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,qBAAa,KAAK;IAChB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;gBAEZ,MAAM,EAAE,WAAW;IAgCzB,IAAI,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAIlD,MAAM,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAItD,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;CAGvD"}

package/dist/client.js

@@ -17,6 +17,7 @@ import { AccountResource } from "./resources/account.js";
 import { EventsResource } from "./resources/events.js";
 import { BarResource } from "./resources/bar.js";
 import { ChatsResource } from "./resources/chats.js";
+import { V2Resource } from "./v2/resources.js";
 export class Memax {
     memories;
     configs;
@@ -36,6 +37,11 @@ export class Memax {
     events;
     bar;
     chats;
+    /**
+     * The /v2 API: the V2 record (spaces, memories, Review, receipts).
+     * Types are under the `V2` namespace export.
+     */
+    v2;
     constructor(config) {
         const transport = new ApiTransport(config);
         const req = transport.request.bind(transport);
@@ -49,7 +55,7 @@ export class Memax {
         this.memories = new MemoriesResource(req, stream, download);
         this.configs = new ConfigsResource(req);
         this.uploads = new UploadsResource(req);
-        this.auth = new AuthResource(req, apiUrl);
+        this.auth = new AuthResource(req, apiUrl, transport.form.bind(transport));
         this.account = new AccountResource(req);
         this.hubs = new HubsResource(req);
         this.invites = new InvitesResource(req);
@@ -64,6 +70,7 @@ export class Memax {
         this.events = new EventsResource(stream);
         this.bar = new BarResource(req);
         this.chats = new ChatsResource(req, stream);
+        this.v2 = new V2Resource(req, transport.open.bind(transport));
     }
     async push(...args) {
         return this.memories.push(...args);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,5 +6,15 @@ export type { Item, ChecklistItem, DigestItem, ItemProgress, PinContext, Checkli
 export { SUPER_NOTIF_KINDS } from "./notifications/items.js";
 export { actionToResolution, resolveFromAction, } from "./notifications/action-to-resolution.js";
 export { MemaxError } from "./errors.js";
-export type { MemaxConfig, AuthProvider, PushOptions, RecallOptions, AskOptions, ListMemoriesOptions, HubUpdateParams, MemoryKind, MemoryStability, Memory, MemoryAttachment, AttachmentViewURL, MemoryLifecycle, MemoryUpdateInput, DreamActionRef, DreamTopicRef, ShareMemoryResult, BatchMoveResult, BatchMoveSkippedMemory, BatchMoveSkipReason, BatchDeleteResult, BatchDeleteSkippedMemory, BatchDeleteSkipReason, AgentConfigBatchDeleteResult, AgentConfigDeleteSkippedItem, AgentConfigDeleteSkipReason, RelatedMemory, RecalledMemory, RecallResult, SearchResult, BarSearchResult, BarTopicMatch, BarHubMatch, AskResult, ListMemoriesResult, Scope, AgentConfigClass, AgentConfig, Persona, PersonaRevision, PersonaRestoreResult, BoardKind, BoardStatus, BoardSlotState, BoardSlotAction, BoardFeedbackVerdict, Board, BoardSlotResolution, BoardSlot, BoardWithSlots, AgentConfigListResult, DeletedAgentConfig, SyncAction, SyncPlanAction, SyncManifestEntry, ConfigSyncRequest, AgentConfigSyncAck, ConfigSyncAckRequest, ConfigLocalDeleteRequest, RestoreDeletedConfigRequest, ConfigUpsertRequest, ConfigMergeRequest, UploadIntent, AuthProviderName, User, MeResponse, AuthTokenPair, ImpersonationResult, AuthIdentity, UnlinkProviderResult, RequestEmailOtpOptions, RequestEmailOtpResponse, VerifyEmailOtpOptions, VerifyEmailOtpResponse, ApiKeyCreateOptions, ApiKey, ApiKeyListItem, UpdateApiKeyPayload, UpdateApiKeyResult, OAuthConsentHub, OAuthConsentPermission, OAuthConsentRequest, UpdateProfileResult, DeleteAllDataResult, Hub, HubSettings, HubSettingsInput, HubWithRole, HubMember, HubInvite, HubInviteeInput, HubOwnershipTransfer, HubDetailResult, HubSummary, HubSummaryStats, HubSummaryHeader, HubSummaryMember, HubAccent, HubRole, HubType, HubHeaderState, HubHeaderAuroraMode, HubTimeBucket, HubGreetingKey, ContributorDeletePolicy, InviteDetails, InviteAcceptResult, DevFlagsSettings, Settings, SettingsUpdateInput, Usage, UsageWithLimits, PlanScope, PlanDefinition, UserLimits, Topic, TopicLifecycle, TopicDeltaSummary, TopicTree, TopicListResponse, TopicArchivedListResponse, TopicArchiveResult, TopicCreateParams, TopicUpdateParams, TopicUpdateErrorCode, TopicReorderOperation, TopicMemoriesResponse, DreamRun, DreamAction, DreamLatestRunSummary, DreamPendingReviewSummary, DreamIntelligenceSummary, DreamReport, DreamRunListOptions, DreamRunListResponse, DreamUsage, DreamUsageOptions, ReviewTopicMergePayload, ReviewTopicRestructurePayload, ReviewTopicRef, Notification, NotificationAudience, NotificationStatus, NotificationResolution, NotificationKind, NeedsActionNotificationKind, UpdateNotificationKind, NotificationKindCount, NotificationSummary, NotificationListQuery, NotificationListResponse, NotificationBulkQuery, NotificationBulkResult, NotificationResolveAction, NotificationResolveResult, ReviewContradictionPayload, ReviewMemoryRef, DreamRunCompletedPayload, DreamRunCounts, HubInvitePayload, HubInviteHubRef, HubInviteInviterRef, HubMemberJoinedPayload, HubMemberRef, HubInviteAcceptedPayload, HubInviteDeclinedPayload, HubInviteDeclinedByYouPayload, HubOwnershipTransferPayload, HubOwnershipTransferredPayload, SystemNoticePayload, GiftInviteLinkPayload, ConnectedAgent, ConnectedAgentWithStats, ConnectedAgentUpdate, DisconnectAgentResult, AgentDisconnectSkipReason, AgentDisconnectSkippedItem, ApiKeyRevokeResult, ApiKeyRevokeSkipReason, ApiKeyRevokeSkippedItem, ChatScopeType, ChatSessionStatus, ChatMessageRole, ChatMessageStatus, ChatSession, ChatMessage, ChatToolDescriptor, CreateChatSessionInput, PatchChatSessionInput, ListChatSessionsOptions, ListChatSessionsResult, ListChatMessagesOptions, ListChatMessagesResult, ChatTurnOutcome, SendChatMessageInput, SendChatMessageResult, CancelChatMessageResult, RegenerateChatMessageResult, DecideApprovalResult, ChatStreamOptions, ChatStreamEventName, } from "./types.js";
+export * as V2 from "./v2/types.js";
+export { V2Resource, V2SpacesResource, V2MemoriesResource, V2ReviewResource, V2ReceiptsResource, V2ReadsResource, V2AgentsResource, V2BriefsResource, V2TargetsResource, V2GatesResource, V2NoticesResource, V2SessionsResource, V2DreamResource, V2SettingsResource, V2AccountResource, V2PasskeysResource, undoableAction, refusalOf, forgetCarriesOf, askEventOf, } from "./v2/resources.js";
+export { EventStreamParser, readEventStream } from "./v2/sse.js";
+export type { ServerSentEvent } from "./v2/sse.js";
+export { verifyReceiptChain, canonicalReceipt, checkpointStatement, receiptLeaf, genesisHash, merkleRoot, } from "./v2/verify.js";
+export type { ChainReceipt, ChainReport, ChainProblem, ChainProblemKind, ChainCrypto, VerifyChainInput, } from "./v2/verify.js";
+export { EXPORT_FORMAT, ExportFormatError, parseExport, parseFrontmatter, parseReceipts, splitDocument, verifyExport, } from "./v2/export.js";
+export type { ExportFiles, ExportManifest, ExportManifestFile, ExportCheckpoints, ExportReceiptStamp, ExportedMemory, ExportedTombstone, ExportedBrief, ParsedExport, ExportProblem, ExportProblemKind, ExportReport, VerifyExportInput, } from "./v2/export.js";
+export type { CommandOptions as V2CommandOptions, MemoryRefOptions as V2MemoryRefOptions, ReviewOptions as V2ReviewOptions, EditOptions as V2EditOptions, PageOptions as V2PageOptions, VersionedCommandOptions as V2VersionedCommandOptions, ListMemoriesOptions as V2ListMemoriesOptions, ListReceiptsOptions as V2ListReceiptsOptions, GetMemoryOptions as V2GetMemoryOptions, ListGatesOptions as V2ListGatesOptions, GateRefOptions as V2GateRefOptions, GateCommandOptions as V2GateCommandOptions, AskOptions as V2AskOptions, SpaceExport as V2SpaceExport, SettingsEditOptions as V2SettingsEditOptions, SessionCommandOptions as V2SessionCommandOptions, AccountCommandOptions as V2AccountCommandOptions, } from "./v2/resources.js";
+export { passkeyCheckOf, encodePasskeyAnswer } from "./transport.js";
+export type { MemaxConfig, AuthProvider, PasskeyCheck, PasskeyCheckHandler, PushOptions, RecallOptions, AskOptions, ListMemoriesOptions, HubUpdateParams, MemoryKind, MemoryStability, Memory, MemoryAttachment, AttachmentViewURL, MemoryLifecycle, MemoryUpdateInput, DreamActionRef, DreamTopicRef, ShareMemoryResult, BatchMoveResult, BatchAttributeResult, BatchMoveSkippedMemory, BatchMoveSkipReason, BatchDeleteResult, BatchDeleteSkippedMemory, BatchDeleteSkipReason, AgentConfigBatchDeleteResult, AgentConfigDeleteSkippedItem, AgentConfigDeleteSkipReason, RelatedMemory, RecalledMemory, RecallResult, SearchResult, BarSearchResult, BarTopicMatch, BarHubMatch, AskResult, ListMemoriesResult, Scope, AgentConfigClass, AgentConfig, Persona, PersonaRevision, PersonaRestoreResult, BoardKind, BoardStatus, BoardSlotState, BoardSlotAction, BoardFeedbackVerdict, Board, BoardSlotResolution, BoardSlot, BoardSlotVersion, BoardWithSlots, AgentConfigListResult, DeletedAgentConfig, SyncAction, SyncPlanAction, SyncManifestEntry, ConfigSyncRequest, AgentConfigSyncAck, ConfigSyncAckRequest, ConfigLocalDeleteRequest, RestoreDeletedConfigRequest, ConfigUpsertRequest, ConfigMergeRequest, UploadIntent, AuthProviderName, User, MeResponse, WebUi, AuthTokenPair, ExchangedTokens, DeviceSignIn, DeviceSignInOptions, DeviceSignInPoll, ImpersonationResult, AuthIdentity, UnlinkProviderResult, RequestEmailOtpOptions, RequestEmailOtpResponse, VerifyEmailOtpOptions, VerifyEmailOtpResponse, ApiKeyCreateOptions, ApiKey, ApiKeyListItem, UpdateApiKeyPayload, UpdateApiKeyResult, OAuthAutonomy, OAuthDecision, OAuthDecisionInput, OAuthRequest, OAuthRequestSpace, OAuthConsentTarget, UpdateProfileResult, DeleteAllDataResult, Hub, HubSettings, HubSettingsInput, HubWithRole, HubMember, HubInvite, HubInviteeInput, HubOwnershipTransfer, HubDetailResult, HubSummary, HubSummaryStats, HubSummaryHeader, HubSummaryMember, HubAccent, HubRole, HubType, HubHeaderState, HubHeaderAuroraMode, HubTimeBucket, HubGreetingKey, ContributorDeletePolicy, InviteDetails, InviteAcceptResult, DevFlagsSettings, Settings, SettingsUpdateInput, Usage, UsageWithLimits, PlanScope, PlanDefinition, UserLimits, Topic, TopicLifecycle, TopicDeltaSummary, TopicTree, TopicListResponse, TopicArchivedListResponse, TopicArchiveResult, TopicCreateParams, TopicUpdateParams, TopicUpdateErrorCode, TopicReorderOperation, TopicMemoriesResponse, DreamRun, DreamAction, DreamLatestRunSummary, DreamPendingReviewSummary, DreamIntelligenceSummary, DreamReport, DreamRunListOptions, DreamRunListResponse, DreamUsage, DreamUsageOptions, ReviewTopicMergePayload, ReviewTopicRestructurePayload, ReviewTopicRef, Notification, NotificationAudience, NotificationStatus, NotificationResolution, NotificationKind, NeedsActionNotificationKind, UpdateNotificationKind, NotificationKindCount, NotificationSummary, NotificationListQuery, NotificationListResponse, NotificationBulkQuery, NotificationBulkResult, NotificationResolveAction, NotificationResolveResult, ReviewContradictionPayload, ReviewMemoryRef, DreamRunCompletedPayload, DreamRunCounts, HubInvitePayload, HubInviteHubRef, HubInviteInviterRef, HubMemberJoinedPayload, HubMemberRef, HubInviteAcceptedPayload, HubInviteDeclinedPayload, HubInviteDeclinedByYouPayload, HubOwnershipTransferPayload, HubOwnershipTransferredPayload, SystemNoticePayload, GiftInviteLinkPayload, ConnectedAgent, ConnectedAgentWithStats, ConnectedAgentUpdate, DisconnectAgentResult, AgentDisconnectSkipReason, AgentDisconnectSkippedItem, ApiKeyRevokeResult, ApiKeyRevokeSkipReason, ApiKeyRevokeSkippedItem, ChatScopeType, ChatSessionStatus, ChatMessageRole, ChatMessageStatus, ChatSession, ChatMessage, ChatToolDescriptor, CreateChatSessionInput, PatchChatSessionInput, ListChatSessionsOptions, ListChatSessionsResult, ListChatMessagesOptions, ListChatMessagesResult, ChatTurnOutcome, SendChatMessageInput, SendChatMessageResult, CancelChatMessageResult, RegenerateChatMessageResult, DecideApprovalResult, ChatStreamOptions, ChatStreamEventName, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -9,4 +9,14 @@ export { actionToResolution, resolveFromAction, } from "./notifications/action-t
 // Admin APIs are an internal, web-only surface and are intentionally not
 // exported by this public SDK.
 export { MemaxError } from "./errors.js";
+// /v2 — the V2 record. Types are generated from
+// packages/server/openapi/v2.yaml; use them as `V2.Memory`, `V2.PolicyCode`…
+// (`export * as`, not `export type * as`, so the .d.ts parses on
+// TypeScript before 5.0; the module holds only types.)
+export * as V2 from "./v2/types.js";
+export { V2Resource, V2SpacesResource, V2MemoriesResource, V2ReviewResource, V2ReceiptsResource, V2ReadsResource, V2AgentsResource, V2BriefsResource, V2TargetsResource, V2GatesResource, V2NoticesResource, V2SessionsResource, V2DreamResource, V2SettingsResource, V2AccountResource, V2PasskeysResource, undoableAction, refusalOf, forgetCarriesOf, askEventOf, } from "./v2/resources.js";
+export { EventStreamParser, readEventStream } from "./v2/sse.js";
+export { verifyReceiptChain, canonicalReceipt, checkpointStatement, receiptLeaf, genesisHash, merkleRoot, } from "./v2/verify.js";
+export { EXPORT_FORMAT, ExportFormatError, parseExport, parseFrontmatter, parseReceipts, splitDocument, verifyExport, } from "./v2/export.js";
+export { passkeyCheckOf, encodePasskeyAnswer } from "./transport.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,mEAAmE;AACnE,gFAAgF;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAiBpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,yEAAyE;AACzE,+BAA+B;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,mEAAmE;AACnE,gFAAgF;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAiBpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,yEAAyE;AACzE,+BAA+B;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,gDAAgD;AAChD,6EAA6E;AAC7E,iEAAiE;AACjE,uDAAuD;AACvD,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,eAAe,EACf,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AASxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AAmCxB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/notifications/items.d.ts

@@ -84,6 +84,12 @@ export interface ChecklistPayload {
     description?: string;
     items: ChecklistItem[];
     required_ids?: string[];
+    /**
+     * Stamped when every required item is complete. The row stays
+     * pending so the card can show its finished state, and retires a day
+     * later. Render as "all done" while this is set.
+     */
+    all_done_at?: string;
     /** Compact-mode strip label. */
     collapse_hint?: string;
     pin_context?: PinContext;

package/dist/notifications/items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/notifications/items.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;gDAC4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,EAAE,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,EAAE,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,kBAAkB,CAAC,EAAE,eAAe,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,kBAAkB,CAAC,EAAE,eAAe,CAAC;CACtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAGhD,CAAC"}
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/notifications/items.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;gDAC4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,EAAE,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,EAAE,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,kBAAkB,CAAC,EAAE,eAAe,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,kBAAkB,CAAC,EAAE,eAAe,CAAC;CACtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAGhD,CAAC"}

package/dist/notifications/items.js.map

@@ -1 +1 @@
-{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/notifications/items.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wDAAwD;AACxD,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,8DAA8D;AAC9D,uEAAuE;AACvE,2CAA2C;AAC3C,EAAE;AACF,6CAA6C;AAC7C,uEAAuE;AACvE,2DAA2D;AAgH3D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAS;IACpE,WAAW;IACX,QAAQ;CACT,CAAC,CAAC"}
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/notifications/items.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wDAAwD;AACxD,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,8DAA8D;AAC9D,uEAAuE;AACvE,2CAA2C;AAC3C,EAAE;AACF,6CAA6C;AAC7C,uEAAuE;AACvE,2DAA2D;AAsH3D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAS;IACpE,WAAW;IACX,QAAQ;CACT,CAAC,CAAC"}

package/dist/resources/auth.d.ts

@@ -1,9 +1,40 @@
-import type { ApiKey, ApiKeyCreateOptions, ApiKeyListItem, ApiKeyRevokeResult, AuthIdentity, AuthProviderName, AuthTokenPair, ImpersonationResult, MeResponse, OAuthConsentRequest, RequestEmailOtpOptions, RequestEmailOtpResponse, UnlinkProviderResult, UpdateApiKeyPayload, UpdateApiKeyResult, UpdateProfileResult, VerifyEmailOtpOptions, VerifyEmailOtpResponse } from "../types.js";
-import type { RequestFn } from "../transport.js";
+import type { ApiKey, ApiKeyCreateOptions, ApiKeyListItem, ApiKeyRevokeResult, AuthIdentity, AuthProviderName, AuthTokenPair, DeviceSignIn, DeviceSignInOptions, DeviceSignInPoll, ExchangedTokens, ImpersonationResult, MeResponse, OAuthDecision, OAuthDecisionInput, OAuthRequest, RequestEmailOtpOptions, RequestEmailOtpResponse, UnlinkProviderResult, UpdateApiKeyPayload, UpdateApiKeyResult, UpdateProfileResult, VerifyEmailOtpOptions, VerifyEmailOtpResponse } from "../types.js";
+import type { FormFn, RequestFn } from "../transport.js";
 export declare class AuthResource {
     private readonly req;
     private readonly apiUrl;
-    constructor(req: RequestFn, apiUrl: string);
+    private readonly form?;
+    constructor(req: RequestFn, apiUrl: string, form?: FormFn | undefined);
+    /**
+     * Ask for a device code (RFC 8628 §3.1), for signing the memax CLI in
+     * where no browser can open. Show the person `userCode` and
+     * `verificationUri` (or open `verificationUriComplete`), then poll with
+     * {@link pollDeviceSignIn} every `interval` seconds until it ends.
+     * Throws MemaxError `rate_limited` (too many codes from this address),
+     * `invalid_client`, or the network's errors.
+     */
+    startDeviceSignIn(options?: DeviceSignInOptions): Promise<DeviceSignIn>;
+    /**
+     * Poll once for a device code's session (RFC 8628 §3.4). `pending` and
+     * `slow_down` mean keep polling (`slow_down`: 5 seconds longer between
+     * polls from now on); `signed_in` carries the person's CLI session, which
+     * the server issues once; `denied`, `expired` and `invalid` end it.
+     */
+    pollDeviceSignIn(deviceCode: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<DeviceSignInPoll>;
+    /**
+     * Sign a session out (RFC 7009, `POST /oauth/revoke`): pass its refresh
+     * token, which ends the session even if that token was just replaced, or
+     * one of its access tokens. Its refresh token stops working at once, and
+     * the access tokens it minted within the hour. A token that names nothing
+     * succeeds too, so signing out twice is fine. Throws on a network error
+     * or a refusal (`invalid_request`, `rate_limited`).
+     */
+    revoke(token: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    private oauthForm;
     me(): Promise<MeResponse>;
     createKey(options: ApiKeyCreateOptions): Promise<ApiKey>;
     listKeys(): Promise<ApiKeyListItem[]>;
@@ -28,8 +59,27 @@ export declare class AuthResource {
     updateKey(id: string, payload: UpdateApiKeyPayload): Promise<UpdateApiKeyResult>;
     updateProfile(displayName: string): Promise<UpdateProfileResult>;
     refresh(refreshToken: string): Promise<AuthTokenPair>;
-    exchangeCode(code: string): Promise<AuthTokenPair>;
-    getOAuthConsentRequest(requestId: string, consentToken: string): Promise<OAuthConsentRequest>;
+    /**
+     * Trades a sign-in's one-time code for its session. A session issued to
+     * the web app also says which web UI the person sees (`ui`).
+     */
+    exchangeCode(code: string): Promise<ExchangedTokens>;
+    /**
+     * An MCP client's pending authorization request (OAuthConsent), for the
+     * person signed in on the web: the first person to open it is bound to
+     * it, and anyone else gets 404. Needs a session the web app was issued.
+     */
+    openOAuthRequest(requestId: string): Promise<OAuthRequest>;
+    /**
+     * The bound person's answer: approve (one space) or deny. Answers where
+     * to send the browser: the client's registered redirect_uri with a code,
+     * or with access_denied.
+     */
+    decideOAuthRequest(requestId: string, decision: OAuthDecisionInput): Promise<OAuthDecision>;
+    /** "Not you?": the bound person lets go of the request. */
+    releaseOAuthRequest(requestId: string): Promise<{
+        released: boolean;
+    }>;
     githubLoginURL(redirectURI: string): string;
     googleLoginURL(redirectURI: string): string;
     providerLoginURL(provider: AuthProviderName, redirectURI: string): string;

package/dist/resources/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/resources/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM;IAG3B,EAAE,IAAI,OAAO,CAAC,UAAU,CAAC;IAIzB,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAexD,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3C;;;;;;;;;OASG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWxD;;;;;;OAMG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAMxB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMhE,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMrD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMlD,sBAAsB,CAC1B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAS/B,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI3C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI3C,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAezE;;;;;;;;;OASG;IACG,eAAe,CACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IAUnC;;;;;;;;;OASG;IACG,cAAc,CAClB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;IASlC,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAIlE,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIzC,cAAc,CAClB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,oBAAoB,CAAC;IAIhC,+FAA+F;IACzF,WAAW,CAAC,MAAM,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAKjC"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/resources/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,MAAM,EAAc,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA0BrE,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAFL,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;IAGhC;;;;;;;OAOG;IACG,iBAAiB,CACrB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;IA4BxB;;;;;OAKG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,gBAAgB,CAAC;IAmC5B;;;;;;;OAOG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC;YAWF,SAAS;IAejB,EAAE,IAAI,OAAO,CAAC,UAAU,CAAC;IAIzB,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxD,QAAQ,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3C;;;;;;;;;OASG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWxD;;;;;;OAMG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAMxB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMhE,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAM3D;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAM1D;;;;OAIG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOhE;;;;OAIG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAQzB,2DAA2D;IACrD,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAO5E,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI3C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI3C,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAezE;;;;;;;;;OASG;IACG,eAAe,CACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IAUnC;;;;;;;;;OASG;IACG,cAAc,CAClB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;IASlC,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAIlE,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIzC,cAAc,CAClB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,oBAAoB,CAAC;IAIhC,+FAA+F;IACzF,WAAW,CAAC,MAAM,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAKjC"}

package/dist/resources/auth.js

@@ -1,9 +1,113 @@
+import { MemaxError } from "../errors.js";
+/** An OAuth error answer as a MemaxError (`code` is OAuth's `error`). */
+function oauthFailure(status, body, retryAfter) {
+    const code = status === 429
+        ? "rate_limited"
+        : typeof body.error === "string"
+            ? body.error
+            : "invalid_response";
+    const message = typeof body.error_description === "string"
+        ? body.error_description
+        : `The sign-in server answered ${status}.`;
+    return new MemaxError(message, code, status, undefined, retryAfter);
+}
+/** The memax CLI's OAuth client id; only it signs in with a device code. */
+const DEVICE_CLIENT_ID = "memax-cli";
+const DEVICE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
 export class AuthResource {
     req;
     apiUrl;
-    constructor(req, apiUrl) {
+    form;
+    constructor(req, apiUrl, form) {
         this.req = req;
         this.apiUrl = apiUrl;
+        this.form = form;
+    }
+    /**
+     * Ask for a device code (RFC 8628 §3.1), for signing the memax CLI in
+     * where no browser can open. Show the person `userCode` and
+     * `verificationUri` (or open `verificationUriComplete`), then poll with
+     * {@link pollDeviceSignIn} every `interval` seconds until it ends.
+     * Throws MemaxError `rate_limited` (too many codes from this address),
+     * `invalid_client`, or the network's errors.
+     */
+    async startDeviceSignIn(options = {}) {
+        const { status, body, retryAfter } = await this.oauthForm("/oauth/device_authorization", {
+            client_id: DEVICE_CLIENT_ID,
+            client_version: options.clientVersion,
+            device_name: options.deviceName,
+            device_os: options.deviceOs,
+            space: options.space,
+        }, options.signal);
+        if (status !== 200 || typeof body.device_code !== "string") {
+            throw oauthFailure(status, body, retryAfter);
+        }
+        return {
+            deviceCode: body.device_code,
+            userCode: String(body.user_code ?? ""),
+            verificationUri: String(body.verification_uri ?? ""),
+            verificationUriComplete: typeof body.verification_uri_complete === "string"
+                ? body.verification_uri_complete
+                : undefined,
+            expiresIn: Number(body.expires_in ?? 600),
+            interval: Math.max(1, Number(body.interval ?? 5)),
+        };
+    }
+    /**
+     * Poll once for a device code's session (RFC 8628 §3.4). `pending` and
+     * `slow_down` mean keep polling (`slow_down`: 5 seconds longer between
+     * polls from now on); `signed_in` carries the person's CLI session, which
+     * the server issues once; `denied`, `expired` and `invalid` end it.
+     */
+    async pollDeviceSignIn(deviceCode, options = {}) {
+        const { status, body, retryAfter } = await this.oauthForm("/oauth/token", {
+            grant_type: DEVICE_GRANT,
+            client_id: DEVICE_CLIENT_ID,
+            device_code: deviceCode,
+        }, options.signal);
+        if (status === 200 && typeof body.access_token === "string") {
+            return {
+                status: "signed_in",
+                tokens: {
+                    access_token: body.access_token,
+                    refresh_token: String(body.refresh_token ?? ""),
+                    expires_in: Number(body.expires_in ?? 3600),
+                },
+            };
+        }
+        switch (body.error) {
+            case "authorization_pending":
+                return { status: "pending" };
+            case "slow_down":
+                return { status: "slow_down" };
+            case "access_denied":
+                return { status: "denied" };
+            case "expired_token":
+                return { status: "expired" };
+            case "invalid_grant":
+                return { status: "invalid" };
+        }
+        throw oauthFailure(status, body, retryAfter);
+    }
+    /**
+     * Sign a session out (RFC 7009, `POST /oauth/revoke`): pass its refresh
+     * token, which ends the session even if that token was just replaced, or
+     * one of its access tokens. Its refresh token stops working at once, and
+     * the access tokens it minted within the hour. A token that names nothing
+     * succeeds too, so signing out twice is fine. Throws on a network error
+     * or a refusal (`invalid_request`, `rate_limited`).
+     */
+    async revoke(token, options = {}) {
+        const { status, body, retryAfter } = await this.oauthForm("/oauth/revoke", { token }, options.signal);
+        if (status !== 200) {
+            throw oauthFailure(status, body, retryAfter);
+        }
+    }
+    async oauthForm(path, fields, signal) {
+        if (!this.form) {
+            throw new MemaxError("This client can't send OAuth forms.", "invalid_request", 0);
+        }
+        return this.form(path, fields, signal);
     }
     async me() {
         return this.req("GET", "/v1/auth/me");
@@ -15,6 +119,7 @@ export class AuthResource {
                 hub_id: options.hubId,
                 hub_ids: options.hubIds,
                 agent_name: options.agentName,
+                standalone: options.standalone,
                 expires_in_days: options.expiresInDays,
                 scopes: options.scopes,
                 permissions: options.permissions,
@@ -64,18 +169,34 @@ export class AuthResource {
             body: { refresh_token: refreshToken },
         });
     }
+    /**
+     * Trades a sign-in's one-time code for its session. A session issued to
+     * the web app also says which web UI the person sees (`ui`).
+     */
     async exchangeCode(code) {
         return this.req("POST", "/v1/auth/exchange", {
             body: { code },
         });
     }
-    async getOAuthConsentRequest(requestId, consentToken) {
-        return this.req("GET", "/oauth/authorize/consent-request", {
-            query: {
-                request_id: requestId,
-                consent_token: consentToken,
-            },
-        });
+    /**
+     * An MCP client's pending authorization request (OAuthConsent), for the
+     * person signed in on the web: the first person to open it is bound to
+     * it, and anyone else gets 404. Needs a session the web app was issued.
+     */
+    async openOAuthRequest(requestId) {
+        return this.req("GET", `/oauth/authorize/requests/${encodeURIComponent(requestId)}`);
+    }
+    /**
+     * The bound person's answer: approve (one space) or deny. Answers where
+     * to send the browser: the client's registered redirect_uri with a code,
+     * or with access_denied.
+     */
+    async decideOAuthRequest(requestId, decision) {
+        return this.req("POST", `/oauth/authorize/requests/${encodeURIComponent(requestId)}/decision`, { body: { ...decision } });
+    }
+    /** "Not you?": the bound person lets go of the request. */
+    async releaseOAuthRequest(requestId) {
+        return this.req("POST", `/oauth/authorize/requests/${encodeURIComponent(requestId)}/release`);
     }
     githubLoginURL(redirectURI) {
         return `${this.apiUrl}/v1/auth/github?redirect_uri=${encodeURIComponent(redirectURI)}`;