@recursiv/sdk 0.7.14 → 0.7.15

package/README.md

@@ -8,7 +8,7 @@
 npm install @recursiv/sdk
 ```
 
-Node.js >= 18. ESM only. Zero runtime dependencies.
+Node.js >= 18. ESM only (`import` works on 18+; `require()` needs Node >= 22, which can require ES modules). Zero runtime dependencies; realtime and the Next.js helpers each declare one optional peer, installed only if you use them.
 
 ## 60-second quickstart
 
@@ -109,10 +109,27 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | `r.admin` | User management, stats, content reports (`listReports`, `resolveReport`, `dismissReport`) |
 | `r.dispatcher` | Task queue, claims, signals, outcomes, webhooks |
 | `r.goals` | Org goals with task rollups (group dispatcher tasks) |
-| `r.protocols` | `list` returns bounded adapter `maturity`, `limitations`, and exhaustive `supported`/`planned`/`unsupported` implementation capabilities (not provider health or enablement); settings, candidate refresh/status, and search |
+| `r.protocols` | `list` returns bounded adapter `maturity`, `limitations`, and exhaustive `supported`/`planned`/`unsupported` implementation capabilities (not provider health or enablement); settings, candidate refresh/status, search, and read-only quarantined candidate review via `listCandidates` / `getCandidate` |
 
 Full reference: see [llm.md](./llm.md) (ships with this package) or the type definitions in `dist/`.
 
+### Quarantined protocol candidates
+
+`r.protocols.listCandidates({ protocol?, limit?, cursor? })` and
+`r.protocols.getCandidate(id)` read unpublished candidates, not feed posts.
+Both require an `admin`-scoped, project-bound key, a live admin role, and
+existing project-admin access. App/network scope is not a caller parameter.
+These GET methods do not collect content, update settings, or publish anything.
+
+Lists return `{ data, meta: { limit, has_more, next_cursor } }` with no offset;
+the API defaults to 20 rows and permits at most 50. Details return `{ data }`.
+Render candidate `content` as plain text and respect
+`content_truncated`. Safe source IDs are preserved byte-exact. A null
+`external_id` means unsafe or malformed provenance was withheld; an author's
+`native_id` may likewise be absent or withheld. Do not invent replacement IDs.
+API failures, including routes absent from an older
+deployment, throw the normal SDK errors; do not present them as an empty queue.
+
 ## Configuration
 
 ```typescript
@@ -281,6 +298,8 @@ with the returned API key; omit it for flows that still need the cookie session.
 
 Cookie-session helpers for the App Router (Next 14 and 15). Each user signs in once, gets a **project-scoped per-user API key** in an httpOnly cookie, and every request acts as that user — no platform key on the server.
 
+This subpath uses the optional `server-only` peer to keep its exports out of Client Components. Install it alongside the SDK in Next.js apps: `npm install server-only`.
+
 ```typescript
 // src/lib/recursiv.ts (server-only module)
 import 'server-only';
@@ -359,9 +378,9 @@ if (page1.meta.has_more) {
 
 | Environment | Status | Notes |
 |-------------|--------|-------|
-| Node.js >= 18 | Full support | ESM only. Uses native fetch. |
+| Node.js >= 18 | Full support | ESM only (`require()` needs Node >= 22). Uses native fetch. |
 | Next.js | Full support | Server components, server actions, and route handlers. Use `@recursiv/sdk/next` for cookie-session auth (Next 14 and 15). |
-| React (Vite, CRA) | Full support | Bundle-friendly, zero dependencies |
+| React (Vite, CRA) | Full support | Bundle-friendly, zero dependencies. Realtime needs the optional `socket.io-client` peer. |
 | React Native / Expo | Supported with caveats | `chatStream()` requires manual SSE handling. See [React Native guide](./docs/guide-react-native.md). |
 | Deno | Full support | ESM native, fetch native |
 | Bun | Full support | ESM native, fetch native |

package/dist/client.d.ts

@@ -36,4 +36,3 @@ export declare class HttpClient {
     delete<T>(path: string): Promise<T>;
     fetchRaw(path: string, options: RequestInit): Promise<Response>;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/client.js

@@ -220,4 +220,3 @@ export class HttpClient {
         });
     }
 }
-//# sourceMappingURL=client.js.map

package/dist/errors.d.ts

@@ -33,4 +33,3 @@ export declare class RateLimitError extends RecursivError {
 export declare class ConflictError extends RecursivError {
     constructor(body: ApiErrorBody['error']);
 }
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.js

@@ -86,4 +86,3 @@ export class ConflictError extends RecursivError {
         this.name = 'ConflictError';
     }
 }
-//# sourceMappingURL=errors.js.map

package/dist/index.d.ts

@@ -186,7 +186,7 @@ export type { UploadMediaInput, UploadUrlInput, UploadUrlResult } from './resour
 export { WalletResource } from './resources/wallet.js';
 export { ProtocolsResource } from './resources/protocols.js';
 export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, } from './resources/protocols.js';
-export type { ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
+export type { ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
 export { InboxResource } from './resources/inbox.js';
 export { NetworkResource } from './resources/network.js';
 export { SimulatorResource } from './resources/simulator.js';
@@ -213,4 +213,3 @@ export { RecursivError, AuthenticationError, AuthorizationError, NotFoundError,
 export { parseSSE } from './lib/sse.js';
 export * from './lib/webhooks.js';
 export type * from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -252,4 +252,3 @@ export { MediaResource } from './resources/media.js';
 export { RecursivError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, InsufficientCreditsError, RateLimitError, ConflictError, } from './errors.js';
 export { parseSSE } from './lib/sse.js';
 export * from './lib/webhooks.js';
-//# sourceMappingURL=index.js.map

package/dist/lib/sse.d.ts

@@ -3,4 +3,3 @@ import type { StreamChunk } from '../types.js';
  * Parse a Server-Sent Events stream into StreamChunk objects.
  */
 export declare function parseSSE(body: ReadableStream<Uint8Array> | null): AsyncGenerator<StreamChunk>;
-//# sourceMappingURL=sse.d.ts.map

package/dist/lib/sse.js

@@ -49,4 +49,3 @@ export async function* parseSSE(body) {
         reader.releaseLock();
     }
 }
-//# sourceMappingURL=sse.js.map

package/dist/lib/webhooks.d.ts

@@ -38,4 +38,3 @@ export declare function constructWebhookEvent<T = any>(payload: string | Uint8Ar
     event: RecursivWebhookEvent<T>;
     idempotencyKey: string;
 }>;
-//# sourceMappingURL=webhooks.d.ts.map

package/dist/lib/webhooks.js

@@ -88,4 +88,3 @@ function hexToBytes(hex) {
     }
     return bytes;
 }
-//# sourceMappingURL=webhooks.js.map

package/dist/next/index.d.ts

@@ -8,4 +8,3 @@ import 'server-only';
 export { createRecursivAuth, RecursivNextAuth } from './server-auth.js';
 export { DEFAULT_USER_KEY_SCOPES } from './scopes.js';
 export type { RecursivNextAuthConfig, SessionUser, AuthResult, WriteOptions, SessionCookieOptions, SessionCookieDescriptor, CookieWriter, RequestCookiesLike, } from './server-auth.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/next/index.js

@@ -7,4 +7,3 @@
 import 'server-only';
 export { createRecursivAuth, RecursivNextAuth } from './server-auth.js';
 export { DEFAULT_USER_KEY_SCOPES } from './scopes.js';
-//# sourceMappingURL=index.js.map

package/dist/next/scopes.d.ts

@@ -32,4 +32,3 @@
  * re-authenticate.
  */
 export declare const DEFAULT_USER_KEY_SCOPES: string[];
-//# sourceMappingURL=scopes.d.ts.map

package/dist/next/scopes.js

@@ -45,4 +45,3 @@ export const DEFAULT_USER_KEY_SCOPES = [
     'databases:read', 'databases:write',
     'storage:read', 'storage:write',
 ];
-//# sourceMappingURL=scopes.js.map

package/dist/next/server-auth.d.ts

@@ -184,4 +184,3 @@ export declare class RecursivNextAuth {
  * ```
  */
 export declare function createRecursivAuth(config?: RecursivNextAuthConfig): RecursivNextAuth;
-//# sourceMappingURL=server-auth.d.ts.map

package/dist/next/server-auth.js

@@ -246,4 +246,3 @@ export class RecursivNextAuth {
 export function createRecursivAuth(config = {}) {
     return new RecursivNextAuth(config);
 }
-//# sourceMappingURL=server-auth.js.map

package/dist/react/index.d.ts

@@ -1,2 +1 @@
 export * from './useChat.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/react/index.js

@@ -1,2 +1 @@
 export * from './useChat.js';
-//# sourceMappingURL=index.js.map

package/dist/react/useChat.d.ts

@@ -23,4 +23,3 @@ export declare function useChat(recursiv: Recursiv, options?: UseChatOptions): {
     fetchHistory: (limit?: number, cursor?: string) => Promise<import("../types.js").PaginatedResponse<import("../types.js").Message>>;
     sendMessage: (content: string, replyToId?: string) => Promise<import("../types.js").SingleResponse<import("../types.js").SentMessage>>;
 };
-//# sourceMappingURL=useChat.d.ts.map

package/dist/react/useChat.js

@@ -108,4 +108,3 @@ export function useChat(recursiv, options = {}) {
         }
     };
 }
-//# sourceMappingURL=useChat.js.map

package/dist/realtime.d.ts

@@ -1,4 +1,4 @@
-import { Socket } from 'socket.io-client';
+import type { Socket } from 'socket.io-client';
 import { HttpClient } from './client.js';
 export interface ChatMessageEvent {
     id: string;
@@ -88,4 +88,3 @@ export declare class RealtimeClient {
     onTyping(callback: (event: TypingEvent) => void): (() => void) | undefined;
     onAgentThinking(callback: (event: AgentThinkingEvent) => void): (() => void) | undefined;
 }
-//# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.js

@@ -1,4 +1,21 @@
-import { io } from 'socket.io-client';
+// socket.io-client is an optional peer: only realtime needs it, so importing
+// the SDK must not require it. The type-only import above erases at build;
+// the factory loads here, on first connect, with an actionable error when
+// the peer is absent.
+let cachedIo;
+async function loadIo() {
+    if (cachedIo)
+        return cachedIo;
+    try {
+        const mod = await import('socket.io-client');
+        cachedIo = mod.io;
+    }
+    catch {
+        throw new Error("Realtime requires the optional peer dependency 'socket.io-client'. " +
+            'Install it alongside the SDK: npm install socket.io-client');
+    }
+    return cachedIo;
+}
 export class RealtimeClient {
     socket = null;
     client;
@@ -8,17 +25,12 @@ export class RealtimeClient {
         this.client = client;
     }
     async fetchTokenWithClientKey() {
+        // Only the REST route can mint a token. The old fallback asked for a tRPC
+        // procedure under the REST base URL, which no API host serves, so every
+        // failed token fetch also logged a 404 in the browser console.
         try {
             const response = await this.client.get('/realtime/ws-token');
-            if (response.data?.token)
-                return response.data.token;
-        }
-        catch {
-            // Fall through to the tRPC endpoint for session-based auth.
-        }
-        try {
-            const response = await this.client.get('/trpc/sessionManagement.getWebSocketToken');
-            return response.result?.data?.token;
+            return response.data?.token || undefined;
         }
         catch {
             return undefined;
@@ -54,6 +66,7 @@ export class RealtimeClient {
             return this.connectionPromise;
         }
         this.connectionPromise = (async () => {
+            const io = await loadIo();
             const provider = this.tokenProvider ?? (() => this.fetchTokenWithClientKey());
             const token = await provider();
             if (!token) {
@@ -150,4 +163,3 @@ export class RealtimeClient {
         return () => this.socket?.off('agent_thinking', callback);
     }
 }
-//# sourceMappingURL=realtime.js.map

package/dist/resources/accounts.d.ts

@@ -41,4 +41,3 @@ export declare class AccountsResource {
     /** Mint a replacement key for a sibling account in the caller's project. */
     switchAccount(targetUserId: string): Promise<SingleResponse<SwitchAccountResult>>;
 }
-//# sourceMappingURL=accounts.d.ts.map

package/dist/resources/accounts.js

@@ -20,4 +20,3 @@ export class AccountsResource {
         return this.client.post('/accounts/switch', { target_user_id: targetUserId });
     }
 }
-//# sourceMappingURL=accounts.js.map

package/dist/resources/admin.d.ts

@@ -320,4 +320,3 @@ export declare class AdminResource {
     }): Promise<PaginatedResponse<WaitlistEntry>>;
 }
 export {};
-//# sourceMappingURL=admin.d.ts.map

package/dist/resources/admin.js

@@ -124,4 +124,3 @@ export class AdminResource {
         return this.client.get('/invite-codes-admin/waitlist', params);
     }
 }
-//# sourceMappingURL=admin.js.map

package/dist/resources/agents.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { PaginatedResponse, SingleResponse, DeleteResponse, Agent, AgentDetail, CreateAgentInput, CreatedAgent, UpdateAgentInput, UpdatedAgent, AgentChatInput, AgentChatResult, AgentConversation, PaginationParams, StreamChunk } from '../types.js';
+import type { PaginatedResponse, SingleResponse, DeleteResponse, Agent, AgentDetail, CreateAgentInput, CreatedAgent, UpdateAgentInput, UpdatedAgent, AgentChatInput, AgentChatResult, AgentConversation, AgentConversationMessage, PaginationParams, StreamChunk } from '../types.js';
 export interface AgentMessage {
     id: string;
     networkId: string;
@@ -127,6 +127,16 @@ export declare class AgentsResource {
     chat(id: string, input: AgentChatInput): Promise<SingleResponse<AgentChatResult>>;
     /** List an agent's conversations */
     conversations(id: string, params?: PaginationParams): Promise<PaginatedResponse<AgentConversation>>;
+    /**
+     * Read the messages in one of an agent's conversations, oldest first.
+     *
+     * `chat` returns as soon as the message is accepted and the agent works
+     * asynchronously, so this is how a caller finds out what happened — including
+     * the exact error text when a step failed. Without it the only observable
+     * signals are task status and claims, which say that an agent ran and that
+     * nothing landed, but never why.
+     */
+    conversationMessages(id: string, conversationId: string, params?: PaginationParams): Promise<PaginatedResponse<AgentConversationMessage>>;
     /** List discoverable agents (public + same-org) */
     listDiscoverable(params?: PaginationParams & {
         organization_id?: string;
@@ -278,4 +288,3 @@ export declare class AgentsResource {
         chunks: StreamChunk[];
     }>;
 }
-//# sourceMappingURL=agents.d.ts.map

package/dist/resources/agents.js

@@ -80,6 +80,18 @@ export class AgentsResource {
     conversations(id, params) {
         return this.client.get(`/agents/${id}/conversations`, params);
     }
+    /**
+     * Read the messages in one of an agent's conversations, oldest first.
+     *
+     * `chat` returns as soon as the message is accepted and the agent works
+     * asynchronously, so this is how a caller finds out what happened — including
+     * the exact error text when a step failed. Without it the only observable
+     * signals are task status and claims, which say that an agent ran and that
+     * nothing landed, but never why.
+     */
+    conversationMessages(id, conversationId, params) {
+        return this.client.get(`/agents/${id}/conversations/${conversationId}/messages`, params);
+    }
     /** List discoverable agents (public + same-org) */
     listDiscoverable(params) {
         return this.client.get('/agents/discoverable', params);
@@ -275,4 +287,3 @@ export class AgentsResource {
         return { content: fullText, conversationId, chunks };
     }
 }
-//# sourceMappingURL=agents.js.map

package/dist/resources/app-subscriptions.d.ts

@@ -38,4 +38,3 @@ export declare class AppSubscriptionsResource {
         data: AppSubscriptionStatusResult;
     }>;
 }
-//# sourceMappingURL=app-subscriptions.d.ts.map

package/dist/resources/app-subscriptions.js

@@ -20,4 +20,3 @@ export class AppSubscriptionsResource {
         return this.client.get('/app-subscriptions/status');
     }
 }
-//# sourceMappingURL=app-subscriptions.js.map

package/dist/resources/auth.d.ts

@@ -242,6 +242,22 @@ export declare class AuthResource {
         user: AuthSession['user'];
         session: AuthSession;
     }>;
+    /**
+     * Exchange a legacy Minds session (the OAuth access token or minds_sess JWT
+     * the legacy mobile app stored) for a session on this stack. Only answers
+     * during the cutover window; every failure means "show the OTP screen".
+     */
+    legacyHandoff(legacyToken: string, appContext?: {
+        projectId?: string;
+        organizationId?: string;
+    }): Promise<AuthSession>;
+    /** legacyHandoff, then the app API key, exactly like verifyOtpAndCreateKey. */
+    legacyHandoffAndCreateKey(legacyToken: string, keyInput: CreateApiKeyInput): Promise<{
+        apiKey: string;
+        apiKeyId: string;
+        user: AuthSession['user'];
+        session: AuthSession;
+    }>;
     /**
      * Complete mobile OTP auth flow: verify OTP → create API key → return key.
      * Combines verifyOtp + createApiKey for passwordless mobile auth.
@@ -259,10 +275,18 @@ export declare class AuthResource {
         user: AuthSession['user'];
         session: AuthSession;
     }>;
+    /**
+     * The key-mint leg of the `*AndCreateKey` flows. When the mint fails, the
+     * caller receives only the thrown error — the session created one step
+     * earlier is not in it, so no caller can revoke that session no matter how
+     * carefully they handle the failure. Retire it here (best-effort) instead
+     * of stranding a live server-side credential; the mint's own error is what
+     * surfaces either way.
+     */
+    private createApiKeyOrRetireSession;
     /**
      * Extract session token from response.
      * Better Auth returns it in Set-Cookie header and/or response body.
      */
     private extractToken;
 }
-//# sourceMappingURL=auth.d.ts.map

package/dist/resources/auth.js

@@ -574,7 +574,7 @@ export class AuthResource {
             projectId: keyInput.projectId,
             organizationId: keyInput.organizationId,
         });
-        const key = await this.createApiKey(keyInput, session.token);
+        const key = await this.createApiKeyOrRetireSession(keyInput, session);
         return { apiKey: key.key, apiKeyId: key.id, user: session.user, session };
     }
     /**
@@ -590,7 +590,55 @@ export class AuthResource {
             projectId: keyInput.projectId,
             organizationId: keyInput.organizationId,
         });
-        const key = await this.createApiKey(keyInput, session.token);
+        const key = await this.createApiKeyOrRetireSession(keyInput, session);
+        return { apiKey: key.key, apiKeyId: key.id, user: session.user, session };
+    }
+    /**
+     * Exchange a legacy Minds session (the OAuth access token or minds_sess JWT
+     * the legacy mobile app stored) for a session on this stack. Only answers
+     * during the cutover window; every failure means "show the OTP screen".
+     */
+    async legacyHandoff(legacyToken, appContext) {
+        const res = await this.fetchWithTimeout(`${this.baseOrigin}/api/auth/legacy-handoff`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...originHeader(this.baseOrigin),
+                ...(appContext?.projectId ? { 'x-recursiv-app-project': appContext.projectId } : {}),
+                ...(appContext?.organizationId
+                    ? { 'x-recursiv-app-organization': appContext.organizationId }
+                    : {}),
+            },
+            body: JSON.stringify({ legacy_token: legacyToken }),
+        });
+        let data = null;
+        try {
+            data = await res.json();
+        }
+        catch {
+            data = null;
+        }
+        if (!res.ok) {
+            const { code, message } = serverErrorInfo(data);
+            throw new AuthenticationError({
+                type: 'auth_error',
+                message: message || `Legacy handoff failed: HTTP ${res.status}`,
+                code: code || 'legacy_handoff_failed',
+            });
+        }
+        const token = this.extractToken(res, data);
+        if (!token) {
+            throw new AuthenticationError({ type: 'auth_error', message: 'Legacy handoff returned no session', code: 'legacy_handoff_failed' });
+        }
+        return { token, user: data.user };
+    }
+    /** legacyHandoff, then the app API key, exactly like verifyOtpAndCreateKey. */
+    async legacyHandoffAndCreateKey(legacyToken, keyInput) {
+        const session = await this.legacyHandoff(legacyToken, {
+            projectId: keyInput.projectId,
+            organizationId: keyInput.organizationId,
+        });
+        const key = await this.createApiKeyOrRetireSession(keyInput, session);
         return { apiKey: key.key, apiKeyId: key.id, user: session.user, session };
     }
     /**
@@ -609,9 +657,33 @@ export class AuthResource {
             projectId: keyInput.projectId,
             organizationId: keyInput.organizationId,
         });
-        const key = await this.createApiKey(keyInput, session.token);
+        const key = await this.createApiKeyOrRetireSession(keyInput, session);
         return { apiKey: key.key, apiKeyId: key.id, user: session.user, session };
     }
+    /**
+     * The key-mint leg of the `*AndCreateKey` flows. When the mint fails, the
+     * caller receives only the thrown error — the session created one step
+     * earlier is not in it, so no caller can revoke that session no matter how
+     * carefully they handle the failure. Retire it here (best-effort) instead
+     * of stranding a live server-side credential; the mint's own error is what
+     * surfaces either way.
+     */
+    async createApiKeyOrRetireSession(keyInput, session) {
+        try {
+            return await this.createApiKey(keyInput, session.token);
+        }
+        catch (err) {
+            if (session.token) {
+                try {
+                    await this.signOut(session.token);
+                }
+                catch {
+                    // Nothing more can be done from here; the session expires on its own.
+                }
+            }
+            throw err;
+        }
+    }
     /**
      * Extract session token from response.
      * Better Auth returns it in Set-Cookie header and/or response body.
@@ -636,4 +708,3 @@ export class AuthResource {
         return null;
     }
 }
-//# sourceMappingURL=auth.js.map

package/dist/resources/billing.d.ts

@@ -139,4 +139,3 @@ export declare class BillingResource {
         success: true;
     }>>;
 }
-//# sourceMappingURL=billing.d.ts.map

package/dist/resources/billing.js

@@ -52,4 +52,3 @@ export class BillingResource {
         return this.client.post('/billing/record-ai-usage', input);
     }
 }
-//# sourceMappingURL=billing.js.map

package/dist/resources/brain.d.ts

@@ -23,4 +23,3 @@ export declare class BrainResource {
     sendMessage(input: SendMessageInput): Promise<SingleResponse<SendMessageResult>>;
 }
 export {};
-//# sourceMappingURL=brain.d.ts.map

package/dist/resources/brain.js

@@ -8,4 +8,3 @@ export class BrainResource {
         return this.client.post('/brain/message', input);
     }
 }
-//# sourceMappingURL=brain.js.map

package/dist/resources/brief.d.ts

@@ -159,4 +159,3 @@ export declare class BriefResource {
     /** The brief for one organization. */
     forOrg(organizationId: string, params?: BriefParams): Promise<SingleResponse<Brief>>;
 }
-//# sourceMappingURL=brief.d.ts.map

package/dist/resources/brief.js

@@ -21,4 +21,3 @@ export class BriefResource {
         return this.client.get(`/organizations/${encodeURIComponent(organizationId)}/brief`, params);
     }
 }
-//# sourceMappingURL=brief.js.map

package/dist/resources/chat.d.ts

@@ -64,4 +64,3 @@ export declare class ChatResource {
         unread_count: number;
     }>>;
 }
-//# sourceMappingURL=chat.d.ts.map

package/dist/resources/chat.js

@@ -66,4 +66,3 @@ export class ChatResource {
         return this.client.get('/chat/unread-count', { conversation_id: conversationId });
     }
 }
-//# sourceMappingURL=chat.js.map

package/dist/resources/commands.d.ts

@@ -38,4 +38,3 @@ export declare class CommandsResource {
     execute(input: ExecutePromptInput): Promise<SingleResponse<ExecutePromptResult>>;
 }
 export {};
-//# sourceMappingURL=commands.d.ts.map

package/dist/resources/commands.js

@@ -12,4 +12,3 @@ export class CommandsResource {
         return this.client.post('/commands/execute', input);
     }
 }
-//# sourceMappingURL=commands.js.map

package/dist/resources/communities.d.ts

@@ -1,10 +1,10 @@
 import type { HttpClient } from '../client.js';
-import type { PaginatedResponse, SingleResponse, Community, CommunityDetail, CommunityMember, CreateCommunityInput, CreatedCommunity, JoinResult, LeaveResult, PaginationParams } from '../types.js';
+import type { Community, CommunityBannedMember, CommunityDetail, CommunityMember, CreateCommunityInput, CreatedCommunity, JoinResult, LeaveResult, ListCommunitiesParams, PaginatedResponse, PaginationParams, SingleResponse } from '../types.js';
 export declare class CommunitiesResource {
     private client;
     constructor(client: HttpClient);
-    /** List public communities */
-    list(params?: PaginationParams): Promise<PaginatedResponse<Community>>;
+    /** List public communities, or only the authenticated caller's memberships. */
+    list(params?: ListCommunitiesParams): Promise<PaginatedResponse<Community>>;
     /** Get a community by ID */
     get(id: string): Promise<SingleResponse<CommunityDetail>>;
     /** List members of a community */
@@ -15,5 +15,67 @@ export declare class CommunitiesResource {
     join(id: string): Promise<SingleResponse<JoinResult>>;
     /** Leave a community */
     leave(id: string): Promise<SingleResponse<LeaveResult>>;
+    /** Update name, description, image, banner or privacy. Owner or admin. */
+    update(id: string, input: Partial<Pick<CreateCommunityInput, 'name' | 'description' | 'privacy'>> & {
+        image?: string | null;
+        banner?: string | null;
+    }): Promise<SingleResponse<CommunityDetail>>;
+    /** Delete a community. Owner only. */
+    delete(id: string): Promise<SingleResponse<{
+        deleted: boolean;
+    }>>;
+    /** People waiting to join a private group. Moderator or higher. */
+    requests(id: string, params?: PaginationParams): Promise<PaginatedResponse<CommunityMember>>;
+    /** Active bans an admin can review and lift. Admin or higher. */
+    bans(id: string, params?: PaginationParams): Promise<PaginatedResponse<CommunityBannedMember>>;
+    /** Let a pending member in. Admin or higher. */
+    approveMember(id: string, userId: string): Promise<SingleResponse<{
+        status: string;
+    }>>;
+    /** Turn a pending member away. Admin or higher. */
+    declineMember(id: string, userId: string): Promise<SingleResponse<{
+        declined: boolean;
+    }>>;
+    /** Remove a member. Moderator or higher, and only members below your role. */
+    removeMember(id: string, userId: string): Promise<SingleResponse<{
+        removed: boolean;
+    }>>;
+    /** Ban a member, with an optional reason. Moderator or higher. */
+    banMember(id: string, userId: string, reason?: string): Promise<SingleResponse<{
+        banned: boolean;
+    }>>;
+    /** Lift a ban. Admin or higher. */
+    unbanMember(id: string, userId: string): Promise<SingleResponse<{
+        banned: boolean;
+    }>>;
+    /** Change a member's role. Admin or higher; only the owner makes admins. */
+    setMemberRole(id: string, userId: string, role: 'admin' | 'moderator' | 'member'): Promise<SingleResponse<{
+        role: string;
+    }>>;
+    /** Pin a post to the top of the group. Moderator or higher. */
+    pinPost(id: string, postId: string): Promise<SingleResponse<{
+        pinned: boolean;
+    }>>;
+    /** Unpin a post. Moderator or higher. */
+    unpinPost(id: string, postId: string): Promise<SingleResponse<{
+        pinned: boolean;
+    }>>;
+    /** Remove a post from the group. Moderator or higher. */
+    removePost(id: string, postId: string): Promise<SingleResponse<{
+        removed: boolean;
+    }>>;
+    /**
+     * Mint an invite code that joins the redeemer to this group. Any member of
+     * a public group; moderator or higher for a private one. Admins can mint a
+     * code that joins people as moderators.
+     */
+    createInvite(id: string, input?: {
+        role?: 'member' | 'moderator';
+        expires_days?: number;
+    }): Promise<SingleResponse<{
+        code: string;
+        community_id: string;
+        role: string;
+        expires_at: string | null;
+    }>>;
 }
-//# sourceMappingURL=communities.d.ts.map