@diskd-ai/sdk 5.1.2

package/dist/messagesStore/messagesStoreTypes.d.ts

@@ -0,0 +1,327 @@
+/** Optional S3 flush control for mailbox SQLite mutations. */
+export type AutoCommitParams = {
+    readonly autoCommit?: boolean | null;
+};
+/** Caller-supplied parameters for creating a workspace mailbox. */
+export type CreateMailboxParams = {
+    readonly mailboxId: string;
+    readonly displayName: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly recreate?: boolean;
+};
+/** Result of create_mailbox; carries the persisted Drive location. */
+export type CreateMailboxResult = {
+    readonly mailboxId: string;
+    readonly dbInode: string;
+    readonly drivePath: string;
+};
+/** Compact mailbox row returned by listMailboxes. */
+export type MailboxSummary = {
+    readonly mailboxId: string;
+    readonly displayName: string;
+    readonly dbInode: string;
+    readonly recordCount: number;
+    readonly sizeBytes: number;
+    readonly updatedAt: string;
+};
+/** Idempotent mailbox-schema bootstrap result. */
+export type InitMailboxResult = {
+    readonly mailboxId: string;
+    readonly schemaVersion: number;
+};
+/** Reports whether a mailbox existed prior to the delete. */
+export type DeleteMailboxResult = {
+    readonly mailboxId: string;
+    readonly deleted: boolean;
+};
+/** Idempotent folder upsert parameters; metadata holds protocol-specific sync state. */
+export type UpsertFolderParams = {
+    readonly folderId: string;
+    readonly displayName: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly autoCommit?: boolean | null;
+};
+/** Reports whether the folder was created (true) or updated (false). */
+export type UpsertFolderResult = {
+    readonly folderId: string;
+    readonly created: boolean;
+};
+/** Compact folder row returned by list/get. */
+export type FolderSummary = {
+    readonly folderId: string;
+    readonly displayName: string;
+    readonly metadata: Readonly<Record<string, unknown>>;
+    readonly messageCount: number;
+    readonly updatedAt: string;
+};
+/** Reports cascade size for caller telemetry. */
+export type DeleteFolderResult = {
+    readonly folderId: string;
+    readonly deleted: boolean;
+    readonly deletedMessageCount: number;
+};
+/** Caller-supplied message; payload is opaque JSON the store never inspects. */
+export type IncomingMessage = {
+    readonly externalId: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+};
+/** Bulk-upsert parameters; folder is implied by the scoping client. */
+export type UpsertBatchParams = {
+    readonly items: readonly IncomingMessage[];
+    readonly autoCommit?: boolean | null;
+};
+/** Counts split between insertions and updates; commit is implicit. */
+export type UpsertBatchResult = {
+    readonly inserted: number;
+    readonly updated: number;
+};
+/** Bulk-delete parameters; folder is implied by the scoping client. */
+export type DeleteBatchParams = {
+    readonly externalIds: readonly string[];
+    readonly autoCommit?: boolean | null;
+};
+/** Reports the count actually deleted (missing ids skipped). */
+export type DeleteBatchResult = {
+    readonly deleted: number;
+};
+/** Cursor-paginated message-list parameters. */
+export type ListMessagesParams = {
+    readonly limit?: number;
+    readonly cursor?: string;
+};
+/** One stored message row, payload opaque. */
+export type StoredMessage = {
+    readonly externalId: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+/** One page of messages plus the next cursor (null at end). */
+export type ListMessagesResult = {
+    readonly items: readonly StoredMessage[];
+    readonly nextCursor: string | null;
+};
+/** Begin per-attachment upload; mirrors drive/upload/start. */
+export type AttachmentUploadStartParams = {
+    readonly attachmentId: string;
+    readonly filename: string;
+    readonly contentType: string;
+    readonly sizeBytes: number;
+    readonly autoCommit?: boolean | null;
+};
+/** Intent envelope; passes through Drive's upload-intent contract. */
+export type AttachmentUploadStartResult = {
+    readonly intentId: string;
+    readonly uploadUrl: string;
+};
+/** Finalize an upload and register the attachment row. */
+export type AttachmentUploadCommitParams = {
+    readonly attachmentId: string;
+    readonly intentId: string;
+    readonly etag: string;
+    readonly autoCommit?: boolean | null;
+};
+/** Reports the inode of the persisted file plus its size. */
+export type AttachmentUploadCommitResult = {
+    readonly attachmentId: string;
+    readonly driveInode: string;
+    readonly sizeBytes: number;
+};
+/** Compact attachment row returned by attachments.list. */
+export type AttachmentSummary = {
+    readonly attachmentId: string;
+    readonly filename: string;
+    readonly contentType: string;
+    readonly sizeBytes: number;
+    readonly driveInode: string;
+    readonly createdAt: string;
+};
+/** Single-attachment lookup parameters. */
+export type AttachmentDownloadUrlParams = {
+    readonly attachmentId: string;
+};
+/** Presigned URL with explicit expiry. */
+export type AttachmentDownloadUrlResult = {
+    readonly url: string;
+    readonly expiresAt: string;
+};
+/** Identifier-only attachment delete; cascades the Drive file. */
+export type AttachmentDeleteParams = {
+    readonly attachmentId: string;
+    readonly autoCommit?: boolean | null;
+};
+/** Reports whether the attachment existed prior to the call. */
+export type AttachmentDeleteResult = {
+    readonly deleted: boolean;
+};
+/**
+ * Scoped to a single message identified by `(mailboxId, folderId,
+ * externalId)`. Returned by {@link FolderScopedClient.message}.
+ *
+ * Carries the five attachment methods so callers don't repeat the
+ * triple on every call. Attachments live in Drive under
+ * `/Mailboxes/<mailboxId>/<per-message-folder>/`; the per-message
+ * folder is created lazily on the first
+ * {@link MessageScopedClient.attachments.uploadStart} call.
+ */
+export type MessageScopedClient = {
+    readonly attachments: {
+        /**
+         * Begin a per-attachment upload. Returns an upload intent
+         * (`intentId` + `uploadUrl`). PUT the bytes to the upload URL
+         * with header `X-Upload-Intent-Id: <intentId>`, then call
+         * {@link MessageScopedClient.attachments.uploadCommit}.
+         */
+        readonly uploadStart: (params: AttachmentUploadStartParams) => Promise<AttachmentUploadStartResult>;
+        /**
+         * Finalize a previously-started upload. Registers the
+         * attachment row in the mailbox SQLite and returns the
+         * persisted Drive inode + size.
+         */
+        readonly uploadCommit: (params: AttachmentUploadCommitParams) => Promise<AttachmentUploadCommitResult>;
+        /** Enumerate all attachments owned by this message. */
+        readonly list: () => Promise<readonly AttachmentSummary[]>;
+        /**
+         * Return a presigned URL for one attachment with explicit
+         * `expiresAt`. Use this for client-side downloads without
+         * exposing storage credentials.
+         */
+        readonly downloadUrl: (params: AttachmentDownloadUrlParams) => Promise<AttachmentDownloadUrlResult>;
+        /** Remove the attachment row and cascade-delete the Drive file. */
+        readonly delete: (params: AttachmentDeleteParams) => Promise<AttachmentDeleteResult>;
+    };
+};
+/**
+ * Scoped to a single folder identified by `(mailboxId, folderId)`.
+ * Returned by {@link MailboxScopedClient.folder}.
+ *
+ * Carries CRUD for the folder itself plus the four message
+ * methods, and a {@link FolderScopedClient.message} factory that
+ * drills into per-message attachment operations.
+ */
+export type FolderScopedClient = {
+    /**
+     * Idempotent folder upsert; mirrors
+     * {@link MailboxScopedClient.upsertFolder} but the `folderId`
+     * is implicit. Use this to update folder display name or
+     * metadata (e.g. IMAP `UIDVALIDITY`/`UIDNEXT`).
+     */
+    readonly upsert: (params: Omit<UpsertFolderParams, 'folderId'>) => Promise<UpsertFolderResult>;
+    /** Fetch the {@link FolderSummary} for this folder. */
+    readonly get: () => Promise<FolderSummary>;
+    /**
+     * Cascade-delete the folder, all messages it owns, and any
+     * per-message attachment Drive subtrees. Returns the count of
+     * deleted messages so callers can report telemetry.
+     */
+    readonly delete: (params?: AutoCommitParams) => Promise<DeleteFolderResult>;
+    /**
+     * Bulk insert-or-update messages keyed by `externalId`. The
+     * batch is committed before this method returns by default; pass
+     * `autoCommit: false` to defer the S3 flush.
+     */
+    readonly upsertBatch: (params: UpsertBatchParams) => Promise<UpsertBatchResult>;
+    /**
+     * Bulk-delete messages by `externalId` list. Missing ids are
+     * silently skipped; the response reports the count actually
+     * deleted. Cascades attachment Drive files.
+     */
+    readonly deleteBatch: (params: DeleteBatchParams) => Promise<DeleteBatchResult>;
+    /**
+     * Cursor-paginated message listing. Pass the previous response's
+     * `nextCursor` to continue; `null` means end of stream. Default
+     * page size is server-defined (currently 100, max 1000).
+     */
+    readonly listMessages: (params?: ListMessagesParams) => Promise<ListMessagesResult>;
+    /**
+     * Read one message by `externalId`. Throws when the message
+     * does not exist (server returns a `MESSAGE_NOT_FOUND` failure).
+     */
+    readonly getMessage: (params: {
+        readonly externalId: string;
+    }) => Promise<StoredMessage>;
+    /**
+     * Bind a message-scoped client over `(mailboxId, folderId,
+     * externalId)`. The returned client exposes attachment operations
+     * for that message.
+     */
+    readonly message: (params: {
+        readonly externalId: string;
+    }) => MessageScopedClient;
+};
+/**
+ * Scoped to a single mailbox identified by `mailboxId`. Returned
+ * by {@link MessagesStoreClient.mailbox}.
+ *
+ * Carries CRUD for the mailbox itself plus folder-level helpers
+ * and a {@link MailboxScopedClient.folder} factory.
+ */
+export type MailboxScopedClient = {
+    /**
+     * Idempotent SQLite-schema bootstrap. Creates `mailbox_meta`,
+     * `folders`, `messages`, and `attachments` tables on first call
+     * and is safe to re-run. Required before any folder/message ops.
+     */
+    readonly init: (params?: AutoCommitParams) => Promise<InitMailboxResult>;
+    /**
+     * Delete the mailbox file and the per-mailbox attachment Drive
+     * subtree (`/Mailboxes/<mailboxId>/`). Reports whether the
+     * mailbox existed prior to the call.
+     */
+    readonly delete: () => Promise<DeleteMailboxResult>;
+    /**
+     * Idempotent folder upsert. `folderId` is opaque (caller-chosen,
+     * e.g. the IMAP folder name). `metadata` is opaque JSON the
+     * store never inspects -- ideal for protocol-specific sync state.
+     */
+    readonly upsertFolder: (params: UpsertFolderParams) => Promise<UpsertFolderResult>;
+    /** Enumerate all folders in this mailbox. */
+    readonly listFolders: () => Promise<readonly FolderSummary[]>;
+    /**
+     * Bind a folder-scoped client over `(mailboxId, folderId)`. The
+     * returned client exposes folder CRUD plus message operations.
+     */
+    readonly folder: (params: {
+        readonly folderId: string;
+    }) => FolderScopedClient;
+};
+/**
+ * Workspace-scoped messages-store client. Returned by
+ * `diskd.os.messagesStore({ auth })`.
+ *
+ * Workspace identity is auth-derived (X-Workspace-Id from API key
+ * or `ext.workspace_id` from OAuth JWT); callers never pass
+ * `workspaceId` on the wire.
+ *
+ * Functional scoping pattern -- drill into a single mailbox,
+ * folder, or message to skip repeating identifiers:
+ *
+ * ```ts
+ * const messagesStore = diskd.os.messagesStore({ auth });
+ * const mailbox = messagesStore.mailbox({ mailboxId: 'gmail-acme' });
+ * const folder  = mailbox.folder({ folderId: 'INBOX' });
+ * const message = folder.message({ externalId: 'imap-uid-1001' });
+ * ```
+ */
+export type MessagesStoreClient = {
+    /**
+     * Allocate a new mailbox SQLite file at
+     * `/Mailboxes/<mailboxId>.mailbox`. `mailboxId` is a workspace-
+     * unique slug (`[a-z0-9-]{1,64}`). `metadata` is opaque JSON
+     * stashed on the underlying drive_databases record.
+     *
+     * The mailbox SQLite schema is bootstrapped lazily by
+     * {@link MailboxScopedClient.init}, not by this call.
+     */
+    readonly createMailbox: (params: CreateMailboxParams) => Promise<CreateMailboxResult>;
+    /** Workspace-scoped mailbox enumeration. Read-only. */
+    readonly listMailboxes: () => Promise<readonly MailboxSummary[]>;
+    /**
+     * Bind a mailbox-scoped client over `mailboxId`. The returned
+     * client exposes mailbox CRUD plus folder/message operations.
+     */
+    readonly mailbox: (params: {
+        readonly mailboxId: string;
+    }) => MailboxScopedClient;
+};
+//# sourceMappingURL=messagesStoreTypes.d.ts.map

package/dist/messagesStore/messagesStoreTypes.d.ts.map

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

package/dist/messagesStore/messagesStoreTypes.js

@@ -0,0 +1,11 @@
+// ---------------------------------------------------------------------------
+// Drive Messages Store API -- pure types (no classes, no I/O)
+//
+// Concept: opaque, protocol-agnostic message store served by drive's
+// `messages_store/*` JSON-RPC namespace. Four boundaries (mailboxes,
+// folders, messages, attachments) exposed as functionally-scoped
+// clients so callers don't repeat (mailboxId, folderId, externalId)
+// on every call.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=messagesStoreTypes.js.map

package/dist/messagesStore/messagesStoreTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messagesStoreTypes.js","sourceRoot":"","sources":["../../src/messagesStore/messagesStoreTypes.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8DAA8D;AAC9D,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AACrE,iEAAiE;AACjE,oEAAoE;AACpE,iBAAiB;AACjB,8EAA8E"}

package/dist/node/fastDns.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fastDns.d.ts.map

package/dist/node/fastDns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastDns.d.ts","sourceRoot":"","sources":["../../src/node/fastDns.ts"],"names":[],"mappings":""}

package/dist/node/fastDns.js

@@ -0,0 +1,119 @@
+import dns from 'node:dns';
+import fs from 'node:fs';
+import { Agent, setGlobalDispatcher } from 'undici';
+import { resolveDiskdBaseUrl } from '../env/baseUrl.js';
+const parseHostsFile = (raw) => {
+    const map = new Map();
+    for (const lineRaw of raw.split(/\r?\n/u)) {
+        const line = lineRaw.trim();
+        if (line.length === 0 || line.startsWith('#'))
+            continue;
+        const parts = line.split(/\s+/u).filter((part) => part.length > 0);
+        const ip = parts[0];
+        if (!ip)
+            continue;
+        for (const host of parts.slice(1)) {
+            const normalized = host.trim().toLowerCase();
+            if (normalized.length === 0)
+                continue;
+            if (!map.has(normalized)) {
+                map.set(normalized, ip);
+            }
+        }
+    }
+    return map;
+};
+const readHostsMap = () => {
+    const content = fs.readFileSync('/etc/hosts', 'utf8');
+    return parseHostsFile(content);
+};
+const hasAll = (options) => typeof options === 'object' &&
+    options !== null &&
+    options.all === true;
+const readFamily = (options) => {
+    if (typeof options === 'number')
+        return options;
+    if (typeof options !== 'object' || options === null)
+        return undefined;
+    const family = options.family;
+    return typeof family === 'number' ? family : undefined;
+};
+const callFallbackLookup = (hostname, options, callback) => {
+    if (typeof options === 'function') {
+        dns.lookup(hostname, options);
+        return;
+    }
+    if (typeof callback !== 'function')
+        return;
+    if (options === undefined) {
+        dns.lookup(hostname, callback);
+        return;
+    }
+    if (typeof options === 'number') {
+        dns.lookup(hostname, options, callback);
+        return;
+    }
+    if (hasAll(options)) {
+        dns.lookup(hostname, options, callback);
+        return;
+    }
+    dns.lookup(hostname, options, callback);
+};
+const createHostsLookup = (map) => {
+    const lookupImpl = (...args) => {
+        const hostnameRaw = args[0];
+        if (typeof hostnameRaw !== 'string')
+            return;
+        const hostname = hostnameRaw.toLowerCase();
+        const options = args[1];
+        const callback = args[2] ?? args[1];
+        const mapped = map.get(hostname);
+        if (!mapped) {
+            callFallbackLookup(hostnameRaw, options, callback);
+            return;
+        }
+        const family = mapped.includes(':') ? 6 : 4;
+        const requestedFamily = readFamily(options);
+        if (requestedFamily && requestedFamily !== 0 && requestedFamily !== family) {
+            callFallbackLookup(hostnameRaw, options, callback);
+            return;
+        }
+        if (hasAll(options)) {
+            callback(null, [{ address: mapped, family }]);
+            return;
+        }
+        callback(null, mapped, family);
+    };
+    return lookupImpl;
+};
+const shouldEnableFastDns = () => {
+    const toggle = process.env.DISKD_SDK_FAST_DNS;
+    if (toggle === '0' || toggle === 'false')
+        return false;
+    if (toggle === '1' || toggle === 'true')
+        return true;
+    const baseUrl = resolveDiskdBaseUrl();
+    return baseUrl.includes('.local');
+};
+const safeReadHostname = (rawUrl) => {
+    try {
+        return new URL(rawUrl).hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+};
+const configureFastDns = () => {
+    if (!shouldEnableFastDns())
+        return;
+    const baseUrlHostname = safeReadHostname(resolveDiskdBaseUrl());
+    if (!baseUrlHostname)
+        return;
+    const map = readHostsMap();
+    if (!map.has(baseUrlHostname))
+        return;
+    const lookup = createHostsLookup(map);
+    setGlobalDispatcher(new Agent({ connect: { lookup } }));
+};
+configureFastDns();
+//# sourceMappingURL=fastDns.js.map

package/dist/node/fastDns.js.map

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

package/dist/operatives/operatives.d.ts

@@ -0,0 +1,22 @@
+import type { AuthModule } from '../auth/types.js';
+import type { OperativesClient } from './operativesTypes.js';
+/**
+ * Creates an Operatives REST client bound to a given auth module.
+ *
+ * The URL defaults to the centralized `APIS_BASE_URL` gateway with the
+ * `/v1/platform/operatives` path prefix.
+ *
+ * Example:
+ * ```ts
+ * const ops = createOperativesClient({ auth });
+ * const list = await ops.list({ projectId: 'proj-1' });
+ * await ops.files.add('op-01', { paths: ['/docs/notes'] });
+ * await ops.skills.add('op-01', { refIds: ['web-search'] });
+ * await ops.tools.add('op-01', { selectors: ['github/search_repos'] });
+ * ```
+ */
+export declare const createOperativesClient: (params: {
+    readonly auth: AuthModule;
+    readonly url?: string;
+}) => OperativesClient;
+//# sourceMappingURL=operatives.d.ts.map

package/dist/operatives/operatives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatives.d.ts","sourceRoot":"","sources":["../../src/operatives/operatives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAUV,gBAAgB,EAGjB,MAAM,sBAAsB,CAAC;AAwI9B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB,KAAG,gBAiLH,CAAC"}