@butterbase/sdk 2.11.0 → 2.12.0

package/dist/office/office-client.js

@@ -0,0 +1,123 @@
+import { OfficeTransport, officeError } from './transport.js';
+import { OfficeClientError, OfficeStreamError } from './types.js';
+import { readOfficeEvents } from './stream.js';
+/** Organization-scoped Office API. Uses platform credentials, with no app/session state. */
+export class OfficeClient {
+    transport;
+    organizationId;
+    constructor(options) {
+        this.organizationId = options.organizationId;
+        this.transport = new OfficeTransport({ ...options });
+    }
+    call(action, fields = {}, options) {
+        return this.transport.request({ ...fields, action, org_id: this.organizationId }, options?.signal);
+    }
+    async write(action, fields, options) {
+        try {
+            const key = options?.idempotencyKey ?? globalThis.crypto.randomUUID();
+            const result = await this.call(action, { ...fields, idempotency_key: key }, options);
+            return result.error ? { ...result, error: new OfficeClientError(result.error.detail, result.error.status, key) } : result;
+        }
+        catch {
+            return { data: null, error: officeError('invalid_request', 'A unique idempotency key is required for this write.') };
+        }
+    }
+    getStatus(options) { return this.call('status', {}, options); }
+    enable(options) { return this.write('enable', {}, options); }
+    pause(options) { return this.write('pause', {}, options); }
+    resume(options) { return this.write('resume', {}, options); }
+    getConfirmation(id, options) { return this.call('status', { confirmation_id: id }, options); }
+    decisions = {
+        list: (options) => this.call('list_decisions', { cursor: options?.cursor, limit: options?.limit, status: options?.status }, options),
+        get: (ref, options) => this.call('get_decision', { decision_id: ref.id, decision_source: ref.source }, options),
+        getContext: (ref, options) => this.call('get_decision_context', { decision_id: ref.id, decision_source: ref.source, limit: options?.limit }, options),
+        approve: (ref, options) => this.write('approve', { decision_id: ref.id, decision_source: ref.source }, options),
+        deny: (ref, options) => this.call('deny', { decision_id: ref.id, decision_source: ref.source, reason: options.reason }, options),
+    };
+    conversations = {
+        create: (options) => this.write('create_conversation', { title: options?.title }, options),
+        list: (options) => this.call('list_conversations', { cursor: options?.cursor, limit: options?.limit }, options),
+        get: (id, options) => this.call('get_conversation', { conversation_id: id, turn_id: options?.turnId, after_sequence: options?.afterSequence, limit: options?.limit }, options),
+    };
+    ask(message, options) { return this.write('ask', { message, conversation_id: options?.conversationId, wait_ms: options?.waitMs }, options); }
+    memory = {
+        list: (options) => this.call('list_memory', { cursor: options?.cursor, limit: options?.limit, kind: options?.kind }, options),
+        search: (query, options) => this.call('search_memory', { query, limit: options?.limit }, options),
+        getSourceArtifact: (id, options) => this.call('get_source_artifact', { source_artifact_id: id }, options),
+        recordDecision: (payload, options) => this.write('record_decision', { payload }, options),
+        recordCommitment: (payload, options) => this.write('record_commitment', { payload }, options),
+        recordLearning: (payload, options) => this.write('record_learning', { payload }, options),
+    };
+    principles = {
+        list: (options) => this.call('list_principles', { cursor: options?.cursor, limit: options?.limit }, options),
+        get: (id, options) => this.call('get_principle', { principle_id: id }, options),
+        record: (payload, options) => this.write('record_principle', { payload }, options),
+    };
+    /** Timeout/abort ends only observation. On timeout data retains the last receipt. */
+    async waitForConfirmation(id, options = {}) {
+        const timeout = options.timeoutMs ?? 120000, interval = options.pollIntervalMs ?? 1000;
+        if (!Number.isFinite(timeout) || timeout < 0 || !Number.isFinite(interval) || interval <= 0)
+            return { data: null, error: officeError('invalid_request', 'Use a nonnegative timeout and a positive polling interval.') };
+        const observer = new AbortController();
+        let timedOut = false, last = null;
+        const abort = () => observer.abort();
+        options.signal?.addEventListener('abort', abort, { once: true });
+        if (options.signal?.aborted)
+            abort();
+        const timer = setTimeout(() => { timedOut = true; observer.abort(); }, timeout);
+        try {
+            while (!observer.signal.aborted) {
+                const result = await this.getConfirmation(id, { signal: observer.signal });
+                if (result.error) {
+                    if (observer.signal.aborted)
+                        break;
+                    return { data: last, error: result.error };
+                }
+                last = result.data;
+                if (last && last.state !== 'awaiting_confirmation' && last.state !== 'executing')
+                    return { data: last, error: null };
+                await new Promise(resolve => {
+                    const done = () => { clearTimeout(poll); observer.signal.removeEventListener('abort', done); resolve(); };
+                    const poll = setTimeout(done, interval);
+                    observer.signal.addEventListener('abort', done, { once: true });
+                    if (observer.signal.aborted)
+                        done();
+                });
+            }
+            return { data: last, error: officeError(timedOut ? 'observation_timeout' : 'aborted', timedOut ? 'Stopped waiting. Inspect this confirmation before taking further action.' : 'Observation was cancelled.') };
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', abort);
+        }
+    }
+    /** Supply conversationId+turnId to observe an existing Ask without submitting. */
+    async *askStream(message, options = {}) {
+        let conversationId = options.conversationId, turnId = options.turnId;
+        const after = options.afterSequence ?? 0;
+        if (!Number.isSafeInteger(after) || after < 0 || (turnId && !conversationId) || (!turnId && after > 0))
+            throw officeError('invalid_request', 'Replay requires exact conversation and turn IDs and a nonnegative sequence.');
+        if (!turnId) {
+            const admitted = await this.ask(message, { ...options, waitMs: 0 });
+            if (admitted.error)
+                throw admitted.error;
+            if (!admitted.data)
+                throw officeError('protocol_error', 'Office did not return an admitted turn.');
+            conversationId = admitted.data.conversation_id;
+            turnId = admitted.data.turn_id;
+        }
+        if (!conversationId)
+            throw officeError('invalid_request', 'conversationId is required.');
+        try {
+            const response = await this.transport.open({ organizationId: this.organizationId, method: 'GET',
+                path: `/v1/me/office/conversations/${encodeURIComponent(conversationId)}/turns/${encodeURIComponent(turnId)}/events?after_sequence=${after}` }, options.signal, true);
+            yield* readOfficeEvents(response, conversationId, turnId, after, options.signal);
+        }
+        catch (error) {
+            if (error instanceof OfficeStreamError)
+                throw error;
+            throw new OfficeStreamError(error instanceof OfficeClientError ? error : officeError('connection_error', 'Office event observation ended.'), conversationId, turnId, after);
+        }
+    }
+}
+//# sourceMappingURL=office-client.js.map

package/dist/office/office-client.js.map

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

package/dist/office/stream.d.ts

@@ -0,0 +1,3 @@
+import { type OfficePublicEvent } from '@butterbase/shared';
+export declare function readOfficeEvents(response: Response, conversationId: string, turnId: string, afterSequence: number, signal?: AbortSignal): AsyncGenerator<OfficePublicEvent>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/office/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/office/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIxG,wBAAuB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,iBAAiB,CAAC,CA8DlL"}

package/dist/office/stream.js

@@ -0,0 +1,102 @@
+import { officeErrorSchema, officePublicEventSchema } from '@butterbase/shared';
+import { OfficeClientError, OfficeStreamError } from './types.js';
+import { officeError } from './transport.js';
+export async function* readOfficeEvents(response, conversationId, turnId, afterSequence, signal) {
+    if (!response.headers.get('content-type')?.toLowerCase().startsWith('text/event-stream') || !response.body)
+        throw officeError('protocol_error', 'Expected an Office event stream.');
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder('utf-8', { fatal: true });
+    let buffer = '', event = '', id = '', data = [], size = 0, lastSequence = afterSequence, suspended = false;
+    const abort = () => { void reader.cancel().catch(() => { }); };
+    signal?.addEventListener('abort', abort, { once: true });
+    try {
+        if (signal?.aborted)
+            throw officeError('aborted', 'Observation was cancelled.');
+        while (true) {
+            const chunk = await reader.read();
+            if (signal?.aborted)
+                throw officeError('aborted', 'Observation was cancelled.');
+            try {
+                buffer += chunk.done ? decoder.decode() : decoder.decode(chunk.value, { stream: true });
+            }
+            catch {
+                throw officeError('protocol_error', 'Invalid UTF-8 in the Office event stream.');
+            }
+            let boundary;
+            while ((boundary = buffer.search(/[\r\n]/)) >= 0) {
+                if (buffer[boundary] === '\r' && boundary === buffer.length - 1 && !chunk.done)
+                    break;
+                const line = buffer.slice(0, boundary);
+                const separator = buffer[boundary] === '\r' && buffer[boundary + 1] === '\n' ? 2 : 1;
+                buffer = buffer.slice(boundary + separator);
+                if (line !== '') {
+                    if (line.startsWith(':'))
+                        continue;
+                    size += line.length;
+                    if (size > 131072)
+                        throw officeError('protocol_error', 'Office event exceeds the public frame limit.');
+                    const colon = line.indexOf(':');
+                    const field = colon < 0 ? line : line.slice(0, colon);
+                    const value = colon < 0 ? '' : line.slice(colon + 1).replace(/^ /, '');
+                    if (field === 'event')
+                        event = value;
+                    else if (field === 'id')
+                        id = value;
+                    else if (field === 'data')
+                        data.push(value);
+                    continue;
+                }
+                const kind = event, sequence = id, text = data.join('\n');
+                event = '';
+                id = '';
+                data = [];
+                size = 0;
+                if (!text)
+                    continue;
+                let value;
+                try {
+                    value = JSON.parse(text);
+                }
+                catch {
+                    throw officeError('protocol_error', 'Malformed Office event data.');
+                }
+                if (kind === 'error') {
+                    const parsed = officeErrorSchema.safeParse(value?.error);
+                    throw parsed.success ? new OfficeClientError(parsed.data) : officeError('protocol_error', 'Invalid Office stream error.');
+                }
+                const parsed = officePublicEventSchema.safeParse(value);
+                if (!parsed.success || (kind && kind !== parsed.data.type) || (sequence && (!/^\d+$/.test(sequence) || Number(sequence) !== parsed.data.sequence)))
+                    throw officeError('protocol_error', 'Invalid Office public event.');
+                const publicEvent = parsed.data;
+                if ((publicEvent.type === 'started' || publicEvent.type === 'completed') &&
+                    (publicEvent.conversation_id !== conversationId || publicEvent.turn_id !== turnId))
+                    throw officeError('protocol_error', 'Office event belongs to a different turn.');
+                if (publicEvent.sequence <= lastSequence)
+                    continue;
+                if (publicEvent.sequence !== lastSequence + 1)
+                    throw officeError('protocol_error', 'Office event sequence has a gap.');
+                lastSequence = publicEvent.sequence;
+                suspended = publicEvent.type === 'approval_required';
+                yield publicEvent;
+                if (['completed', 'blocked', 'failed', 'interrupted', 'decision_resolved'].includes(publicEvent.type))
+                    return;
+            }
+            if (buffer.length + size > 131072)
+                throw officeError('protocol_error', 'Office event exceeds the public frame limit.');
+            if (chunk.done) {
+                if (suspended && !buffer && !data.length)
+                    return;
+                throw officeError('connection_error', 'Office stream ended before a terminal event. Resume using the exact turn and last sequence.');
+            }
+        }
+    }
+    catch (error) {
+        throw new OfficeStreamError(error instanceof OfficeClientError ? error : officeError(signal?.aborted ? 'aborted' : 'connection_error', 'Office event observation ended.'), conversationId, turnId, lastSequence);
+    }
+    finally {
+        signal?.removeEventListener('abort', abort);
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/office/stream.js.map

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

package/dist/office/transport.d.ts

@@ -0,0 +1,20 @@
+import type { OfficeClientOptions } from '@butterbase/shared';
+import { OfficeClientError, type OfficeResponse } from './types.js';
+export interface OfficeHttpRequest {
+    organizationId: string;
+    method: 'GET' | 'POST';
+    path: string;
+    body?: Record<string, unknown>;
+}
+/** Public facade descriptor, kept in parity with the cloud MCP adapter. */
+export declare function officeHttpRequest(input: unknown): OfficeHttpRequest;
+export declare function officeError(code: ConstructorParameters<typeof OfficeClientError>[0]['code'], message: string): OfficeClientError;
+export declare class OfficeTransport {
+    private readonly options;
+    private readonly fetch;
+    private readonly base;
+    constructor(options: OfficeClientOptions);
+    open(request: OfficeHttpRequest, signal?: AbortSignal, stream?: boolean): Promise<Response>;
+    request<T>(input: unknown, signal?: AbortSignal): Promise<OfficeResponse<T>>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/office/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/office/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAAG,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAAE;AAEpI,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA4BnE;AACD,wBAAgB,WAAW,CAAC,IAAI,EAAE,qBAAqB,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAEhI;AAYD,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBACD,OAAO,EAAE,mBAAmB;IAOnD,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IA2BzF,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAmBnF"}

package/dist/office/transport.js

@@ -0,0 +1,141 @@
+import { officeActionSchema, officeErrorSchema, officeStatusSchema, officeTurnSchema, confirmationReceiptSchema } from '@butterbase/shared';
+import { OfficeClientError } from './types.js';
+const BASE = '/v1/me/office';
+/** Public facade descriptor, kept in parity with the cloud MCP adapter. */
+export function officeHttpRequest(input) {
+    const r = officeActionSchema.parse(input);
+    const result = { organizationId: r.org_id, method: 'GET', path: BASE };
+    function get(path, query = {}) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined)
+                params.set(key, String(value));
+        result.path = `${BASE}${path}${params.size ? `?${params}` : ''}`;
+        return result;
+    }
+    function post(path, body) { return { ...result, method: 'POST', path: `${BASE}${path}`, body }; }
+    switch (r.action) {
+        case 'status': return get(r.confirmation_id ? `/confirmations/${encodeURIComponent(r.confirmation_id)}` : '');
+        case 'enable':
+        case 'pause':
+        case 'resume': return post('/confirmations', { action: r.action, idempotency_key: r.idempotency_key });
+        case 'approve': return post('/confirmations', { action: r.action, decision: { source: r.decision_source, id: r.decision_id }, idempotency_key: r.idempotency_key });
+        case 'list_decisions': return get('/decisions', { cursor: r.cursor, limit: r.limit, status: r.status });
+        case 'get_decision': return get(`/decisions/${r.decision_source}/${encodeURIComponent(r.decision_id)}`);
+        case 'get_decision_context': return get(`/decisions/${r.decision_source}/${encodeURIComponent(r.decision_id)}/context`, { limit: r.limit });
+        case 'deny': return post(`/decisions/${r.decision_source}/${encodeURIComponent(r.decision_id)}/deny`, { reason: r.reason });
+        case 'create_conversation': return post('/conversations', { ...(r.title ? { title: r.title } : {}), idempotency_key: r.idempotency_key });
+        case 'list_conversations': return get('/conversations', { cursor: r.cursor, limit: r.limit });
+        case 'get_conversation': return get(`/conversations/${encodeURIComponent(r.conversation_id)}`, { turn_id: r.turn_id, after_sequence: r.after_sequence, limit: r.limit });
+        case 'ask': return post('/ask', { message: r.message, ...(r.conversation_id ? { conversation_id: r.conversation_id } : {}), idempotency_key: r.idempotency_key, wait_ms: r.wait_ms });
+        case 'list_memory': return get('/memory', { cursor: r.cursor, limit: r.limit, kind: r.kind });
+        case 'search_memory': return get('/memory/search', { query: r.query, limit: r.limit });
+        case 'get_source_artifact': return get(`/memory/sources/${encodeURIComponent(r.source_artifact_id)}`);
+        case 'record_decision':
+        case 'record_commitment':
+        case 'record_learning':
+        case 'record_principle': return post(`/memory/${r.action}`, { payload: r.payload, idempotency_key: r.idempotency_key });
+        case 'list_principles': return get('/principles', { cursor: r.cursor, limit: r.limit });
+        case 'get_principle': return get(`/principles/${encodeURIComponent(r.principle_id)}`);
+    }
+}
+export function officeError(code, message) {
+    return new OfficeClientError({ code, message });
+}
+/** Bounds observation even if an injected transport/token refresh ignores abort. */
+function observe(work, signal) {
+    if (!signal)
+        return work;
+    return new Promise((resolve, reject) => {
+        const cleanup = () => signal.removeEventListener('abort', abort);
+        const abort = () => { cleanup(); reject(officeError('aborted', 'Observation was cancelled.')); };
+        signal.addEventListener('abort', abort, { once: true });
+        work.then(value => { cleanup(); resolve(value); }, error => { cleanup(); reject(error); });
+        if (signal.aborted)
+            abort();
+    });
+}
+export class OfficeTransport {
+    options;
+    fetch;
+    base;
+    constructor(options) {
+        this.options = options;
+        let url;
+        try {
+            url = new URL(options.apiUrl);
+        }
+        catch {
+            throw officeError('invalid_request', 'apiUrl must be an HTTP or HTTPS API URL.');
+        }
+        if (!['https:', 'http:'].includes(url.protocol) || url.username || url.password || url.search || url.hash ||
+            !officeActionSchema.safeParse({ action: 'status', org_id: options.organizationId }).success)
+            throw officeError('invalid_request', 'Supply an API URL and an explicit organization UUID.');
+        this.base = options.apiUrl.replace(/\/$/, '');
+        this.fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async open(request, signal, stream = false) {
+        const body = request.body ? JSON.stringify(request.body) : undefined;
+        const retrySafe = request.method === 'GET' || typeof request.body?.idempotency_key === 'string';
+        for (let attempt = 0;; attempt++) {
+            if (signal?.aborted)
+                throw officeError('aborted', 'Observation was cancelled.');
+            let token;
+            try {
+                token = await observe(Promise.resolve().then(() => this.options.getToken()), signal);
+            }
+            catch {
+                throw officeError(signal?.aborted ? 'aborted' : 'unauthenticated', signal?.aborted ? 'Observation was cancelled.' : 'A platform credential is required.');
+            }
+            if (!token)
+                throw officeError('unauthenticated', 'A platform credential is required.');
+            let response;
+            try {
+                response = await observe(this.fetch(`${this.base}${request.path}`, { method: request.method, body, signal,
+                    headers: { Authorization: `Bearer ${token}`, 'x-organization-id': request.organizationId,
+                        ...(body ? { 'Content-Type': 'application/json' } : {}), ...(stream ? { Accept: 'text/event-stream' } : {}) } }), signal);
+            }
+            catch {
+                if (signal?.aborted)
+                    throw officeError('aborted', 'Observation was cancelled.');
+                if (attempt === 0 && retrySafe)
+                    continue;
+                throw officeError('connection_error', 'The connection ended. Inspect the exact request or retry with its original idempotency key.');
+            }
+            if (response.ok)
+                return response;
+            if (attempt === 0 && retrySafe && [502, 503, 504].includes(response.status)) {
+                await response.body?.cancel().catch(() => { });
+                continue;
+            }
+            const payload = await observe(response.json().catch(() => null), signal);
+            const parsed = officeErrorSchema.safeParse(payload?.error);
+            throw parsed.success ? new OfficeClientError(parsed.data, response.status)
+                : new OfficeClientError({ code: response.status === 401 ? 'unauthenticated' : response.status === 403 ? 'forbidden' : 'service_unavailable', message: 'Office request failed.' }, response.status);
+        }
+    }
+    async request(input, signal) {
+        const parsed = officeActionSchema.safeParse(input);
+        if (!parsed.success)
+            return { data: null, error: officeError('invalid_request', 'Invalid Office action or fields.') };
+        try {
+            const response = await this.open(officeHttpRequest(parsed.data), signal);
+            let data = await observe(response.json(), signal);
+            const action = parsed.data.action;
+            // Preserve the dashboard's existing REST envelope while exposing the
+            // standalone client's agreed OfficeStatus value.
+            if (action === 'status' && !parsed.data.confirmation_id)
+                data = data?.status ?? data;
+            const schema = action === 'ask' ? officeTurnSchema : ['enable', 'pause', 'resume', 'approve'].includes(action)
+                || (action === 'status' && parsed.data.confirmation_id) ? confirmationReceiptSchema : action === 'status' ? officeStatusSchema : undefined;
+            if (!data || typeof data !== 'object' || (schema && !schema.safeParse(data).success))
+                throw officeError('protocol_error', 'Office returned an invalid response.');
+            return { data: data, error: null };
+        }
+        catch (error) {
+            return { data: null, error: error instanceof OfficeClientError ? error
+                    : officeError(signal?.aborted ? 'aborted' : error instanceof SyntaxError ? 'protocol_error' : 'connection_error', 'Office response could not be read.') };
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/office/transport.js.map

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

package/dist/office/types.d.ts

@@ -0,0 +1,48 @@
+import type { OfficeError, OfficeErrorCode, OfficeRequestOptions, OfficeWriteOptions, OfficePageOptions } from '@butterbase/shared';
+export type { OfficeClientOptions, OfficeRequestOptions, OfficeWriteOptions, OfficePageOptions, OfficePage, OfficeStatus, ConfirmationReceipt, OfficeCommandReview, DecisionRef, OfficeDecision, OfficeDecisionContext, OfficeConversation, OfficeConversationDetail, OfficeTurn, OfficePublicEvent, OfficeError, OfficeErrorCode, OfficeMemoryResult, OfficeMemoryRecord, OfficeSourceArtifact, OfficePrinciple, OfficeRecordDecisionInput, OfficeRecordCommitmentInput, OfficeRecordLearningInput, OfficeRecordPrincipleInput, } from '@butterbase/shared';
+export declare class OfficeClientError extends Error {
+    readonly detail: OfficeError;
+    readonly status?: number | undefined;
+    readonly idempotencyKey?: string | undefined;
+    readonly code: OfficeErrorCode;
+    readonly decision?: OfficeError['decision'];
+    readonly history?: OfficeError['history'];
+    constructor(detail: OfficeError, status?: number | undefined, idempotencyKey?: string | undefined);
+}
+export declare class OfficeStreamError extends OfficeClientError {
+    readonly conversationId: string;
+    readonly turnId: string;
+    readonly lastSequence: number;
+    constructor(error: OfficeClientError, conversationId: string, turnId: string, lastSequence: number);
+}
+export interface OfficeResponse<T> {
+    data: T | null;
+    error: OfficeClientError | null;
+}
+export interface OfficeAskOptions extends OfficeWriteOptions {
+    conversationId?: string;
+    waitMs?: number;
+}
+export interface OfficeAskStreamOptions extends OfficeAskOptions {
+    turnId?: string;
+    afterSequence?: number;
+}
+export interface OfficeConfirmationWaitOptions extends OfficeRequestOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+export interface OfficeDecisionListOptions extends OfficePageOptions {
+    status?: 'pending' | 'resolved' | 'all';
+}
+export interface OfficeConversationCreateOptions extends OfficeWriteOptions {
+    title?: string;
+}
+export interface OfficeConversationGetOptions extends OfficeRequestOptions {
+    turnId?: string;
+    afterSequence?: number;
+    limit?: number;
+}
+export interface OfficeMemoryListOptions extends OfficePageOptions {
+    kind?: 'decision' | 'commitment' | 'learning';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/office/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/office/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACpI,YAAY,EACV,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAC5F,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAC1G,kBAAkB,EAAE,wBAAwB,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EACzG,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,EAC7E,yBAAyB,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,0BAA0B,GAC9G,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,iBAAkB,SAAQ,KAAK;IAI9B,QAAQ,CAAC,MAAM,EAAE,WAAW;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM;IAHpG,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;gBACrB,MAAM,EAAE,WAAW,EAAW,MAAM,CAAC,EAAE,MAAM,YAAA,EAAW,cAAc,CAAC,EAAE,MAAM,YAAA;CAIrG;AACD,qBAAa,iBAAkB,SAAQ,iBAAiB;IAChB,QAAQ,CAAC,cAAc,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM;gBAAjH,KAAK,EAAE,iBAAiB,EAAW,cAAc,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM,EAAW,YAAY,EAAE,MAAM;CAG9H;AACD,MAAM,WAAW,cAAc,CAAC,CAAC;IAAI,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAAE;AACvF,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAAG,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAAE;AAC1G,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CAAE;AAC7G,MAAM,WAAW,6BAA8B,SAAQ,oBAAoB;IAAG,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAAE;AAC5H,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAAG,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;CAAE;AACjH,MAAM,WAAW,+BAAgC,SAAQ,kBAAkB;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE;AAC/F,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE;AACvI,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAAG,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;CAAE"}

package/dist/office/types.js

@@ -0,0 +1,31 @@
+export class OfficeClientError extends Error {
+    detail;
+    status;
+    idempotencyKey;
+    code;
+    decision;
+    history;
+    constructor(detail, status, idempotencyKey) {
+        super(detail.message);
+        this.detail = detail;
+        this.status = status;
+        this.idempotencyKey = idempotencyKey;
+        this.name = 'OfficeClientError';
+        this.code = detail.code;
+        this.decision = detail.decision;
+        this.history = detail.history;
+    }
+}
+export class OfficeStreamError extends OfficeClientError {
+    conversationId;
+    turnId;
+    lastSequence;
+    constructor(error, conversationId, turnId, lastSequence) {
+        super(error.detail, error.status, error.idempotencyKey);
+        this.conversationId = conversationId;
+        this.turnId = turnId;
+        this.lastSequence = lastSequence;
+        this.name = 'OfficeStreamError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/office/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/office/types.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAIrB;IAA8B;IAA0B;IAHpE,IAAI,CAAkB;IACtB,QAAQ,CAA2B;IACnC,OAAO,CAA0B;IAC1C,YAAqB,MAAmB,EAAW,MAAe,EAAW,cAAuB;QAClG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QADH,WAAM,GAAN,MAAM,CAAa;QAAW,WAAM,GAAN,MAAM,CAAS;QAAW,mBAAc,GAAd,cAAc,CAAS;QAC3E,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAChF,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACjE,CAAC;CACF;AACD,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACP;IAAiC;IAAyB;IAAzG,YAAY,KAAwB,EAAW,cAAsB,EAAW,MAAc,EAAW,YAAoB;QAC3H,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QADX,mBAAc,GAAd,cAAc,CAAQ;QAAW,WAAM,GAAN,MAAM,CAAQ;QAAW,iBAAY,GAAZ,YAAY,CAAQ;QAClE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAC3F,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@butterbase/sdk",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Universal TypeScript SDK for Butterbase",
   "license": "Apache-2.0",
   "homepage": "https://butterbase.ai",
@@ -38,7 +38,7 @@
     "storage"
   ],
   "dependencies": {
-    "@butterbase/shared": "^0.4.0"
+    "@butterbase/shared": "^0.4.2"
   },
   "devDependencies": {
     "typescript": "^5.7.0",