@possibl/rcrt-sdk 0.1.1 → 0.1.3

package/dist/cards.js

@@ -0,0 +1,106 @@
+/**
+ * Cards module — resolve an `interpret:pending-action` breadcrumb.
+ *
+ * The card's footer action ids correspond to values the SDK writes
+ * to `content.status`. See
+ * `packages/docs/guides/06-rendering-cards.md`.
+ */
+import { request } from './internal/fetch.js';
+import { ApiError } from './errors.js';
+export class CardsModule {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * PATCH the card breadcrumb with a resolution. Handles optimistic
+     * locking transparently — refetches + retries on 409.
+     */
+    async resolve(breadcrumbId, resolution) {
+        const current = await request(this.ctx, `/v1/breadcrumbs/${breadcrumbId}`);
+        const nextContent = {
+            ...(current.content ?? {}),
+            status: resolution.status,
+            user_response: resolution.user_response,
+            resolved_at: new Date().toISOString(),
+        };
+        const nextTags = ensureStatusTag(current.tags, resolution.status);
+        return request(this.ctx, `/v1/breadcrumbs/${breadcrumbId}`, {
+            method: 'PATCH',
+            body: {
+                version: current.version,
+                content: nextContent,
+                tags: nextTags,
+            },
+            maxConflictRetries: 2,
+            refetchBeforeRetry: async () => {
+                const fresh = await request(this.ctx, `/v1/breadcrumbs/${breadcrumbId}`);
+                return {
+                    body: {
+                        version: fresh.version,
+                        content: {
+                            ...(fresh.content ?? {}),
+                            status: resolution.status,
+                            user_response: resolution.user_response,
+                            resolved_at: new Date().toISOString(),
+                        },
+                        tags: ensureStatusTag(fresh.tags, resolution.status),
+                    },
+                };
+            },
+        });
+    }
+    /** Pending cards for the current user's current workspace. */
+    async listPending(limit = 50) {
+        const list = await request(this.ctx, '/v1/breadcrumbs', {
+            query: { tags: 'interpret:pending-action,status:pending', limit },
+        });
+        return Array.isArray(list) ? list : (list.breadcrumbs ?? []);
+    }
+    /**
+     * Extract the Card object from a breadcrumb's content, normalising
+     * over legacy shapes (old breadcrumbs stored `card.type` + flat
+     * fields instead of `card.layout` + structured body).
+     */
+    static extractCard(bc) {
+        const content = (bc.content ?? {});
+        const raw = content.card ?? undefined;
+        if (!raw)
+            return undefined;
+        if (typeof raw.layout === 'string')
+            return raw;
+        // Legacy — fall back to a minimal info card.
+        if (typeof raw.type === 'string') {
+            const card = {
+                layout: legacyTypeToLayout(raw.type),
+                header: { title: typeof content.title === 'string' ? content.title : bc.title },
+            };
+            if (typeof content.summary === 'string') {
+                card.body = { text: content.summary };
+            }
+            return card;
+        }
+        return undefined;
+    }
+}
+function ensureStatusTag(existing, status) {
+    const withoutStatus = existing.filter((t) => !t.startsWith('status:'));
+    withoutStatus.push(`status:${status}`);
+    return withoutStatus;
+}
+function legacyTypeToLayout(type) {
+    switch (type) {
+        case 'connect':
+            return 'connect';
+        case 'confirm':
+        case 'choice':
+        case 'multi-choice':
+        case 'approval':
+            return 'decision';
+        case 'text-input':
+            return 'input';
+        default:
+            return 'info';
+    }
+}
+//# sourceMappingURL=cards.js.map

package/dist/cards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.js","sourceRoot":"","sources":["../src/cards.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,GAAiB;QAAjB,QAAG,GAAH,GAAG,CAAc;IAAG,CAAC;IAElD;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,YAAoB,EAAE,UAA0B;QAC5D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAa,IAAI,CAAC,GAAG,EAAE,mBAAmB,YAAY,EAAE,CAAC,CAAC;QACvF,MAAM,WAAW,GAAG;YAClB,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QACF,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAClE,OAAO,OAAO,CAAa,IAAI,CAAC,GAAG,EAAE,mBAAmB,YAAY,EAAE,EAAE;YACtE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE;gBACJ,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,WAAW;gBACpB,IAAI,EAAE,QAAQ;aACf;YACD,kBAAkB,EAAE,CAAC;YACrB,kBAAkB,EAAE,KAAK,IAAI,EAAE;gBAC7B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAa,IAAI,CAAC,GAAG,EAAE,mBAAmB,YAAY,EAAE,CAAC,CAAC;gBACrF,OAAO;oBACL,IAAI,EAAE;wBACJ,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,OAAO,EAAE;4BACP,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;4BACxB,MAAM,EAAE,UAAU,CAAC,MAAM;4BACzB,aAAa,EAAE,UAAU,CAAC,aAAa;4BACvC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;yBACtC;wBACD,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;qBACrD;iBACF,CAAC;YACJ,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,WAAW,CAAC,KAAK,GAAG,EAAE;QAC1B,MAAM,IAAI,GAAG,MAAM,OAAO,CAA+C,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE;YACpG,KAAK,EAAE,EAAE,IAAI,EAAE,yCAAyC,EAAE,KAAK,EAAE;SAClE,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,EAAc;QAC/B,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;QAC9D,MAAM,GAAG,GAAI,OAAO,CAAC,IAA4C,IAAI,SAAS,CAAC;QAC/E,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,GAAsB,CAAC;QAClE,6CAA6C;QAC7C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,GAAS;gBACjB,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,IAAc,CAAC;gBAC9C,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE;aAChF,CAAC;YACF,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACxC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,SAAS,eAAe,CAAC,QAAkB,EAAE,MAAc;IACzD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACvE,aAAa,CAAC,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IACvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,cAAc,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,YAAY;YACf,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/chat.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Chat module — `POST /v1/chat` + per-session / global SSE streams.
+ *
+ * See `packages/docs/guides/03-chat-and-sse.md`.
+ */
+import type { FetchContext } from './internal/fetch.js';
+import type { SseConnection, SseConnectConfig, SseHandlers } from './internal/sse.js';
+export interface SendChatRequest {
+    message: string;
+    /** The agent to route this turn to. `life-coordinator` by default in the Ritual bundle. */
+    target_agent: string;
+    /** Resume an existing session; omit to start a new one. */
+    session_id?: string;
+    /** Extra tags stamped on the user's message breadcrumb. */
+    extra_tags?: string[];
+}
+export interface SendChatResponse {
+    id: string;
+    session_id: string;
+}
+export interface SseStreamOptions {
+    /** Override the EventSource constructor (required in React Native). */
+    eventSource?: SseConnectConfig['eventSource'];
+    useHeaderAuth?: boolean;
+    maxBackoffMs?: number;
+    /** Supply a Last-Event-ID-style resume token if your server supports it. */
+    last_event_id?: string;
+}
+export declare class ChatModule {
+    private readonly ctx;
+    constructor(ctx: FetchContext);
+    /**
+     * Send a user message to an agent. Returns immediately with the
+     * breadcrumb id + session id. The agent reply arrives via the SSE
+     * stream — call `stream(session_id)` before posting, not after.
+     */
+    send(req: SendChatRequest): Promise<SendChatResponse>;
+    /** Per-session SSE — just this session's events. Recommended for chat views. */
+    sessionStream(sessionId: string, handlers: SseHandlers, options?: SseStreamOptions): SseConnection;
+    /** Global SSE — everything the user can see. Useful for home feeds / awaiting-you. */
+    globalStream(handlers: SseHandlers, options?: SseStreamOptions): SseConnection;
+    private buildConfig;
+    /**
+     * Clear a session's suspend flag after the loop detector fired.
+     *
+     * @see `packages/docs/operations/loop-detector.md`
+     */
+    resumeSession(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGtF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,WAAW,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,YAAY;IAE9C;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO3D,gFAAgF;IAChF,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,aAAa;IAItG,sFAAsF;IACtF,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,aAAa;IAIlF,OAAO,CAAC,WAAW;IAcnB;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtD"}

package/dist/chat.js

@@ -0,0 +1,58 @@
+/**
+ * Chat module — `POST /v1/chat` + per-session / global SSE streams.
+ *
+ * See `packages/docs/guides/03-chat-and-sse.md`.
+ */
+import { request } from './internal/fetch.js';
+import { connect as sseConnect } from './internal/sse.js';
+export class ChatModule {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * Send a user message to an agent. Returns immediately with the
+     * breadcrumb id + session id. The agent reply arrives via the SSE
+     * stream — call `stream(session_id)` before posting, not after.
+     */
+    async send(req) {
+        return request(this.ctx, '/v1/chat', {
+            method: 'POST',
+            body: req,
+        });
+    }
+    /** Per-session SSE — just this session's events. Recommended for chat views. */
+    sessionStream(sessionId, handlers, options = {}) {
+        return sseConnect(this.buildConfig(`/v1/sessions/${sessionId}/stream`, options), handlers);
+    }
+    /** Global SSE — everything the user can see. Useful for home feeds / awaiting-you. */
+    globalStream(handlers, options = {}) {
+        return sseConnect(this.buildConfig('/v1/events', options), handlers);
+    }
+    buildConfig(path, options) {
+        const config = {
+            apiUrl: this.ctx.apiUrl,
+            path,
+            tenantId: this.ctx.tenantId,
+            getToken: () => this.ctx.tokenProvider.getIdToken(),
+        };
+        if (options.eventSource)
+            config.eventSource = options.eventSource;
+        if (options.useHeaderAuth !== undefined)
+            config.useHeaderAuth = options.useHeaderAuth;
+        if (options.maxBackoffMs !== undefined)
+            config.maxBackoffMs = options.maxBackoffMs;
+        if (options.last_event_id)
+            config.query = { last_event_id: options.last_event_id };
+        return config;
+    }
+    /**
+     * Clear a session's suspend flag after the loop detector fired.
+     *
+     * @see `packages/docs/operations/loop-detector.md`
+     */
+    async resumeSession(sessionId) {
+        await request(this.ctx, `/v1/sessions/${sessionId}/resume`, { method: 'POST' });
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA0B1D,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,GAAiB;QAAjB,QAAG,GAAH,GAAG,CAAc;IAAG,CAAC;IAElD;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,GAAoB;QAC7B,OAAO,OAAO,CAAmB,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;IACL,CAAC;IAED,gFAAgF;IAChF,aAAa,CAAC,SAAiB,EAAE,QAAqB,EAAE,UAA4B,EAAE;QACpF,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,gBAAgB,SAAS,SAAS,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7F,CAAC;IAED,sFAAsF;IACtF,YAAY,CAAC,QAAqB,EAAE,UAA4B,EAAE;QAChE,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IAEO,WAAW,CAAC,IAAY,EAAE,OAAyB;QACzD,MAAM,MAAM,GAAqB;YAC/B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM;YACvB,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ;YAC3B,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE;SACpD,CAAC;QACF,IAAI,OAAO,CAAC,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAClE,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;YAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QACtF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACnF,IAAI,OAAO,CAAC,aAAa;YAAE,MAAM,CAAC,KAAK,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACnF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,OAAO,CAAO,IAAI,CAAC,GAAG,EAAE,gBAAgB,SAAS,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * RcrtClient — the single entry-point to the SDK.
+ *
+ *     import { RcrtClient, staticTokenProvider } from '@possibl/rcrt-sdk';
+ *
+ *     const rcrt = new RcrtClient({
+ *       apiUrl: 'https://rcrt-api-gateway-<hash>.run.app',
+ *       tokenProvider: firebaseTokenProvider(auth),
+ *     });
+ *
+ *     rcrt.setTenantId(workspaceId);
+ *     const me = await rcrt.auth.me();
+ *     const stream = rcrt.chat.sessionStream(sessionId, { ...handlers });
+ *
+ * Every module on the client shares the same fetch context — one
+ * bearer refresh path, one tenant header, one error envelope.
+ */
+import type { TokenProvider } from './auth.js';
+import { BreadcrumbsModule } from './breadcrumbs.js';
+import { ChatModule } from './chat.js';
+import { CardsModule } from './cards.js';
+import { GrantsModule } from './grants.js';
+import { IdentityModule } from './authn.js';
+export interface RcrtClientConfig {
+    apiUrl: string;
+    tokenProvider: TokenProvider;
+    /** Optional workspace UUID. Can be set later via `setTenantId()`. */
+    tenantId?: string;
+    /** Optional fetch override (SSR, custom retry, mock). */
+    fetchImpl?: typeof fetch;
+}
+export declare class RcrtClient {
+    private readonly ctx;
+    readonly auth: IdentityModule;
+    readonly breadcrumbs: BreadcrumbsModule;
+    readonly chat: ChatModule;
+    readonly cards: CardsModule;
+    readonly grants: GrantsModule;
+    constructor(config: RcrtClientConfig);
+    /** Switch workspaces. Subsequent requests carry the new `X-Tenant-ID`. */
+    setTenantId(tenantId: string | null): void;
+    /** Read the workspace id this client is currently scoped to. */
+    getTenantId(): string | null;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,SAAgB,IAAI,EAAE,cAAc,CAAC;IACrC,SAAgB,WAAW,EAAE,iBAAiB,CAAC;IAC/C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,MAAM,EAAE,YAAY,CAAC;gBAEzB,MAAM,EAAE,gBAAgB;IAiCpC,0EAA0E;IAC1E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAI1C,gEAAgE;IAChE,WAAW,IAAI,MAAM,GAAG,IAAI;CAG7B"}

package/dist/client.js

@@ -0,0 +1,69 @@
+/**
+ * RcrtClient — the single entry-point to the SDK.
+ *
+ *     import { RcrtClient, staticTokenProvider } from '@possibl/rcrt-sdk';
+ *
+ *     const rcrt = new RcrtClient({
+ *       apiUrl: 'https://rcrt-api-gateway-<hash>.run.app',
+ *       tokenProvider: firebaseTokenProvider(auth),
+ *     });
+ *
+ *     rcrt.setTenantId(workspaceId);
+ *     const me = await rcrt.auth.me();
+ *     const stream = rcrt.chat.sessionStream(sessionId, { ...handlers });
+ *
+ * Every module on the client shares the same fetch context — one
+ * bearer refresh path, one tenant header, one error envelope.
+ */
+import { BreadcrumbsModule } from './breadcrumbs.js';
+import { ChatModule } from './chat.js';
+import { CardsModule } from './cards.js';
+import { GrantsModule } from './grants.js';
+import { IdentityModule } from './authn.js';
+import { SdkError } from './errors.js';
+export class RcrtClient {
+    ctx;
+    auth;
+    breadcrumbs;
+    chat;
+    cards;
+    grants;
+    constructor(config) {
+        if (!config.apiUrl) {
+            throw new SdkError('MISSING_API_URL', 'RcrtClient requires `apiUrl`');
+        }
+        if (!config.tokenProvider) {
+            throw new SdkError('MISSING_TOKEN_PROVIDER', 'RcrtClient requires a `tokenProvider`');
+        }
+        const ctxInternal = {
+            apiUrl: config.apiUrl,
+            tenantId: config.tenantId ?? null,
+            tokenProvider: config.tokenProvider,
+            fetchImpl: config.fetchImpl ?? undefined,
+        };
+        // Use a Proxy so module instances can read the current `tenantId`
+        // at request time without us having to rebuild them on every
+        // `setTenantId` call.
+        this.ctx = new Proxy({}, {
+            get: (_target, prop) => ctxInternal[prop],
+            set: (_target, prop, value) => {
+                ctxInternal[prop] = value;
+                return true;
+            },
+        });
+        this.auth = new IdentityModule(this.ctx);
+        this.breadcrumbs = new BreadcrumbsModule(this.ctx);
+        this.chat = new ChatModule(this.ctx);
+        this.cards = new CardsModule(this.ctx);
+        this.grants = new GrantsModule(this.ctx);
+    }
+    /** Switch workspaces. Subsequent requests carry the new `X-Tenant-ID`. */
+    setTenantId(tenantId) {
+        this.ctx.tenantId = tenantId;
+    }
+    /** Read the workspace id this client is currently scoped to. */
+    getTenantId() {
+        return this.ctx.tenantId;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAWvC,MAAM,OAAO,UAAU;IACJ,GAAG,CAAe;IAEnB,IAAI,CAAiB;IACrB,WAAW,CAAoB;IAC/B,IAAI,CAAa;IACjB,KAAK,CAAc;IACnB,MAAM,CAAe;IAErC,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,8BAA8B,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAE,uCAAuC,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,WAAW,GAAG;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;YACjC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;SACzC,CAAC;QAEF,kEAAkE;QAClE,6DAA6D;QAC7D,sBAAsB;QACtB,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,EAAkB,EAAE;YACvC,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAE,WAAkD,CAAC,IAAc,CAAC;YAC3F,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;gBAC3B,WAAkD,CAAC,IAAc,CAAC,GAAG,KAAK,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,0EAA0E;IAC1E,WAAW,CAAC,QAAuB;QAChC,IAAI,CAAC,GAA8C,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3E,CAAC;IAED,gEAAgE;IAChE,WAAW;QACT,OAAQ,IAAI,CAAC,GAA8C,CAAC,QAAQ,CAAC;IACvE,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Error taxonomy.
+ *
+ * The RCRT backend is mid-migration from a flat `{"error": "string"}`
+ * envelope to a typed `{"error": {"code", "message", "details"}}`
+ * shape. This module normalises both into one `ApiError` that app
+ * code can switch on.
+ *
+ * See `packages/docs/guides/07-error-handling.md`.
+ */
+/** Stable machine-readable error codes recognised by the SDK. */
+export type KnownErrorCode = 'UNAUTHORIZED' | 'FORBIDDEN' | 'NOT_FOUND' | 'CONFLICT' | 'INVALID_REQUEST' | 'TOO_MANY_REQUESTS' | 'INTERNAL' | 'SERVICE_UNAVAILABLE' | 'UNKNOWN';
+export interface ApiErrorDetail {
+    /** Machine-readable code if the server sent one. Otherwise derived from status. */
+    code: KnownErrorCode | string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly detail: ApiErrorDetail;
+    readonly rawBody: string | undefined;
+    constructor(status: number, detail: ApiErrorDetail, rawBody?: string);
+    static fromResponse(status: number, rawBody: string): ApiError;
+}
+/** Errors thrown by the SDK before we even reach the server. */
+export declare class SdkError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function parseErrorBody(status: number, rawBody: string): ApiErrorDetail;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iEAAiE;AACjE,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,WAAW,GACX,WAAW,GACX,UAAU,GACV,iBAAiB,GACjB,mBAAmB,GACnB,UAAU,GACV,qBAAqB,GACrB,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,MAAM,EAAE,cAAc,CAAC;IACvC,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEhC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM;IAQpE,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ;CAG/D;AAED,gEAAgE;AAChE,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAeD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CA4B9E"}

package/dist/errors.js

@@ -0,0 +1,76 @@
+/**
+ * Error taxonomy.
+ *
+ * The RCRT backend is mid-migration from a flat `{"error": "string"}`
+ * envelope to a typed `{"error": {"code", "message", "details"}}`
+ * shape. This module normalises both into one `ApiError` that app
+ * code can switch on.
+ *
+ * See `packages/docs/guides/07-error-handling.md`.
+ */
+export class ApiError extends Error {
+    status;
+    detail;
+    rawBody;
+    constructor(status, detail, rawBody) {
+        super(detail.message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.detail = detail;
+        this.rawBody = rawBody;
+    }
+    static fromResponse(status, rawBody) {
+        return new ApiError(status, parseErrorBody(status, rawBody), rawBody);
+    }
+}
+/** Errors thrown by the SDK before we even reach the server. */
+export class SdkError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'SdkError';
+        this.code = code;
+    }
+}
+// ── Internal helpers ─────────────────────────────────────────────
+const STATUS_TO_CODE = {
+    400: 'INVALID_REQUEST',
+    401: 'UNAUTHORIZED',
+    403: 'FORBIDDEN',
+    404: 'NOT_FOUND',
+    409: 'CONFLICT',
+    429: 'TOO_MANY_REQUESTS',
+    500: 'INTERNAL',
+    503: 'SERVICE_UNAVAILABLE',
+};
+export function parseErrorBody(status, rawBody) {
+    const fallbackCode = STATUS_TO_CODE[status] ?? 'UNKNOWN';
+    if (!rawBody.trim()) {
+        return { code: fallbackCode, message: `HTTP ${status}` };
+    }
+    try {
+        const parsed = JSON.parse(rawBody);
+        if (parsed && typeof parsed === 'object' && 'error' in parsed) {
+            const err = parsed.error;
+            if (typeof err === 'string') {
+                return { code: fallbackCode, message: err };
+            }
+            if (err && typeof err === 'object') {
+                const e = err;
+                const detail = {
+                    code: typeof e.code === 'string' ? e.code : fallbackCode,
+                    message: typeof e.message === 'string' ? e.message : `HTTP ${status}`,
+                };
+                if (typeof e.details === 'object' && e.details !== null) {
+                    detail.details = e.details;
+                }
+                return detail;
+            }
+        }
+        return { code: fallbackCode, message: rawBody.slice(0, 200) };
+    }
+    catch {
+        return { code: fallbackCode, message: rawBody.slice(0, 200) };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/generated/conformance.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Contract conformance guardrail.
+ *
+ * Asserts at compile time that the hand-written domain types in
+ * `@possibl/rcrt-sdk/types` are structurally compatible with the
+ * OpenAPI spec. If the spec drifts (new required field, renamed prop,
+ * changed enum) without a matching hand-written update, `tsc` fails
+ * here and the PR is blocked until the two are re-aligned.
+ *
+ * The asserts are one-directional. They check that our domain shape
+ * ⊇ the wire shape (we accept everything the server sends). We do
+ * NOT check the reverse — by design, hand-written types can be richer
+ * (flexible rows, normalised error envelope, etc.).
+ *
+ * If this file fails to compile:
+ * - Read the error message carefully — it points at the specific
+ *   property that diverged.
+ * - Either update the hand-written type to accept the new shape, or
+ *   update the OpenAPI spec if the code changed first (more common).
+ * - Re-run `pnpm run codegen` and commit the regenerated
+ *   `src/generated/openapi.ts` in the same PR.
+ */
+import type { components } from './openapi.js';
+import type { Card, Breadcrumb } from '../types/index.js';
+/**
+ * Compile-time assertion that `Got` extends `Expected`.
+ * Produces a type error at the `_check_*` declaration if not.
+ */
+type AssertExtends<Got, Expected> = Got extends Expected ? true : never;
+/**
+ * Our hand-written `Card` must accept every property required by the
+ * spec's `components.schemas.Card`. If you see an error here, the spec
+ * gained a required field that our type doesn't model. Update the type
+ * (preferred) or relax the spec.
+ *
+ * We use Pick<…, X> so the assertion only covers the fields we've
+ * explicitly opted into. Ignoring fields we don't surface (e.g. legacy
+ * spec-level extras) is intentional.
+ */
+type _check_card_layout = AssertExtends<Pick<Card, 'layout' | 'header'>, Pick<components['schemas']['Card'], 'layout' | 'header'>>;
+/**
+ * Breadcrumb.content is an open `Record<string, unknown>` — intentional.
+ * Only check the metadata fields that are load-bearing for the SDK.
+ */
+type _check_breadcrumb_core = AssertExtends<Pick<Breadcrumb, 'id' | 'tags' | 'content'>, Pick<components['schemas']['Breadcrumb'], 'id' | 'tags' | 'content'>>;
+export type __conformanceGuards = [_check_card_layout, _check_breadcrumb_core];
+export {};
+//# sourceMappingURL=conformance.d.ts.map

package/dist/generated/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/generated/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;;GAGG;AACH,KAAK,aAAa,CAAC,GAAG,EAAE,QAAQ,IAAI,GAAG,SAAS,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC;AAIxE;;;;;;;;;GASG;AACH,KAAK,kBAAkB,GAAG,aAAa,CACrC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC,EAC/B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,CACzD,CAAC;AAEF;;;GAGG;AACH,KAAK,sBAAsB,GAAG,aAAa,CACzC,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,EAC3C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC,CACrE,CAAC;AAGF,MAAM,MAAM,mBAAmB,GAAG,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC"}

package/dist/generated/conformance.js

@@ -0,0 +1,24 @@
+/**
+ * Contract conformance guardrail.
+ *
+ * Asserts at compile time that the hand-written domain types in
+ * `@possibl/rcrt-sdk/types` are structurally compatible with the
+ * OpenAPI spec. If the spec drifts (new required field, renamed prop,
+ * changed enum) without a matching hand-written update, `tsc` fails
+ * here and the PR is blocked until the two are re-aligned.
+ *
+ * The asserts are one-directional. They check that our domain shape
+ * ⊇ the wire shape (we accept everything the server sends). We do
+ * NOT check the reverse — by design, hand-written types can be richer
+ * (flexible rows, normalised error envelope, etc.).
+ *
+ * If this file fails to compile:
+ * - Read the error message carefully — it points at the specific
+ *   property that diverged.
+ * - Either update the hand-written type to accept the new shape, or
+ *   update the OpenAPI spec if the code changed first (more common).
+ * - Re-run `pnpm run codegen` and commit the regenerated
+ *   `src/generated/openapi.ts` in the same PR.
+ */
+export {};
+//# sourceMappingURL=conformance.js.map

package/dist/generated/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../src/generated/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/generated/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Generated OpenAPI types.
+ *
+ * This module is produced by `pnpm run codegen` against
+ * `packages/docs/openapi/v1.yaml` — the hand-maintained API contract.
+ * Do NOT edit the generated file by hand. Edit the spec, then regenerate.
+ *
+ * ## When to use these types
+ *
+ * - **Raw fetch-level type safety** — e.g. you're bypassing the `RcrtClient`
+ *   and calling the HTTP endpoints directly. Use `paths`, `operations`, or
+ *   `components` to type request bodies + response shapes.
+ * - **Contract conformance checks** — asserting at compile time that a
+ *   hand-written type is a structural subset of the wire shape.
+ *
+ * ## When NOT to use these types
+ *
+ * - **Domain modelling in app code.** Prefer the hand-written types in
+ *   `@possibl/rcrt-sdk/types` (`Card`, `Breadcrumb`, `Row`, `ChartSpec`).
+ *   They are richer: documented flexibly (e.g. `FlexibleTextRow`),
+ *   discriminated-union-friendly, and wear the `ApiErrorDetail` shape
+ *   normalised across both the canonical and legacy error envelopes.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import type { components, operations } from '@possibl/rcrt-sdk/generated';
+ *
+ * type RawCard = components['schemas']['Card'];
+ * type ChatRequest = operations['post_v1_chat']['requestBody']['content']['application/json'];
+ * ```
+ */
+export type { paths, components, operations, webhooks } from './openapi.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generated/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/generated/index.js

@@ -0,0 +1,34 @@
+/**
+ * Generated OpenAPI types.
+ *
+ * This module is produced by `pnpm run codegen` against
+ * `packages/docs/openapi/v1.yaml` — the hand-maintained API contract.
+ * Do NOT edit the generated file by hand. Edit the spec, then regenerate.
+ *
+ * ## When to use these types
+ *
+ * - **Raw fetch-level type safety** — e.g. you're bypassing the `RcrtClient`
+ *   and calling the HTTP endpoints directly. Use `paths`, `operations`, or
+ *   `components` to type request bodies + response shapes.
+ * - **Contract conformance checks** — asserting at compile time that a
+ *   hand-written type is a structural subset of the wire shape.
+ *
+ * ## When NOT to use these types
+ *
+ * - **Domain modelling in app code.** Prefer the hand-written types in
+ *   `@possibl/rcrt-sdk/types` (`Card`, `Breadcrumb`, `Row`, `ChartSpec`).
+ *   They are richer: documented flexibly (e.g. `FlexibleTextRow`),
+ *   discriminated-union-friendly, and wear the `ApiErrorDetail` shape
+ *   normalised across both the canonical and legacy error envelopes.
+ *
+ * ## Usage
+ *
+ * ```ts
+ * import type { components, operations } from '@possibl/rcrt-sdk/generated';
+ *
+ * type RawCard = components['schemas']['Card'];
+ * type ChatRequest = operations['post_v1_chat']['requestBody']['content']['application/json'];
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/generated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG"}