@beeable/sdk 0.6.3 → 0.7.1

package/dist/generated/schemas/publishEventDto.d.ts

@@ -86,7 +86,7 @@ import type { PublishEventDtoPayload } from './publishEventDtoPayload';
 export interface PublishEventDto {
     /** Event type identifier */
     event: string;
-    /** Event payload data */
+    /** Event payload (free-form JSON). Shape is defined by the event producer; consumers read from it via the flow's translator functions. */
     payload: PublishEventDtoPayload;
 }
 //# sourceMappingURL=publishEventDto.d.ts.map

package/dist/generated/schemas/publishEventDto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishEventDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/publishEventDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,OAAO,EAAE,sBAAsB,CAAC;CACjC"}
+{"version":3,"file":"publishEventDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/publishEventDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,0IAA0I;IAC1I,OAAO,EAAE,sBAAsB,CAAC;CACjC"}

package/dist/generated/schemas/publishEventDtoPayload.d.ts

@@ -83,7 +83,7 @@ Context profiles are optional — a conversation can be created without one. Whe
  * OpenAPI spec version: 2.0
  */
 /**
- * Event payload data
+ * Event payload (free-form JSON). Shape is defined by the event producer; consumers read from it via the flow's translator functions.
  */
 export type PublishEventDtoPayload = {
     [key: string]: unknown;

package/dist/generated/schemas/recordUsageDto.d.ts

@@ -100,7 +100,7 @@ export interface RecordUsageDto {
     provider?: string;
     /** Model identifier (e.g. claude-sonnet-4-6) */
     model?: string;
-    /** Arbitrary metadata for audit trail */
+    /** Arbitrary metadata stored alongside the usage record for audit/debugging purposes. */
     metadata?: RecordUsageDtoMetadata;
 }
 //# sourceMappingURL=recordUsageDto.d.ts.map

package/dist/generated/schemas/recordUsageDto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recordUsageDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/recordUsageDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,YAAY,EAAE,YAAY,CAAC;IAC3B,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC"}
+{"version":3,"file":"recordUsageDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/recordUsageDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,YAAY,EAAE,YAAY,CAAC;IAC3B,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC"}

package/dist/generated/schemas/recordUsageDtoMetadata.d.ts

@@ -83,7 +83,7 @@ Context profiles are optional — a conversation can be created without one. Whe
  * OpenAPI spec version: 2.0
  */
 /**
- * Arbitrary metadata for audit trail
+ * Arbitrary metadata stored alongside the usage record for audit/debugging purposes.
  */
 export type RecordUsageDtoMetadata = {
     [key: string]: unknown;

package/dist/generated/schemas/reportWidgetErrorDto.d.ts

@@ -88,7 +88,10 @@ export interface ReportWidgetErrorDto {
     method: string;
     /** API path of the failed call */
     path: string;
-    /** Request body sent with the failed call */
+    /**
+     * Request body sent with the failed call (free-form JSON).
+     * @nullable
+     */
     body?: ReportWidgetErrorDtoBody;
     /** HTTP status code returned */
     statusCode: number;

package/dist/generated/schemas/reportWidgetErrorDto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reportWidgetErrorDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/reportWidgetErrorDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"reportWidgetErrorDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/reportWidgetErrorDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/generated/schemas/reportWidgetErrorDtoBody.d.ts

@@ -83,9 +83,10 @@ Context profiles are optional — a conversation can be created without one. Whe
  * OpenAPI spec version: 2.0
  */
 /**
- * Request body sent with the failed call
+ * Request body sent with the failed call (free-form JSON).
+ * @nullable
  */
 export type ReportWidgetErrorDtoBody = {
     [key: string]: unknown;
-};
+} | null;
 //# sourceMappingURL=reportWidgetErrorDtoBody.d.ts.map

package/dist/generated/schemas/reportWidgetErrorDtoBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reportWidgetErrorDtoBody.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/reportWidgetErrorDtoBody.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}
+{"version":3,"file":"reportWidgetErrorDtoBody.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/reportWidgetErrorDtoBody.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC"}

package/dist/generated/schemas/submitClarificationDto.d.ts

@@ -84,7 +84,7 @@ Context profiles are optional — a conversation can be created without one. Whe
  */
 import type { SubmitClarificationDtoValues } from './submitClarificationDtoValues';
 export interface SubmitClarificationDto {
-    /** Form field values keyed by field name */
+    /** Form field values keyed by the field name defined in the pending clarification. */
     values?: SubmitClarificationDtoValues;
     /** Set to true if the user dismissed the form */
     cancelled?: boolean;

package/dist/generated/schemas/submitClarificationDto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submitClarificationDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/submitClarificationDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,4BAA4B,CAAC;IACtC,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"submitClarificationDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/submitClarificationDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF,MAAM,WAAW,sBAAsB;IACrC,sFAAsF;IACtF,MAAM,CAAC,EAAE,4BAA4B,CAAC;IACtC,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/generated/schemas/submitClarificationDtoValues.d.ts

@@ -83,9 +83,9 @@ Context profiles are optional — a conversation can be created without one. Whe
  * OpenAPI spec version: 2.0
  */
 /**
- * Form field values keyed by field name
+ * Form field values keyed by the field name defined in the pending clarification.
  */
 export type SubmitClarificationDtoValues = {
-    [key: string]: unknown;
+    [key: string]: string | number | boolean;
 };
 //# sourceMappingURL=submitClarificationDtoValues.d.ts.map

package/dist/generated/schemas/submitClarificationDtoValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submitClarificationDtoValues.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/submitClarificationDtoValues.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}
+{"version":3,"file":"submitClarificationDtoValues.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/submitClarificationDtoValues.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAC,CAAC"}

package/dist/generated/schemas/toolHistoryEntryDto.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Beeable API
+ * Orchestrator-first business agent platform — a multi-tenant platform where users talk to digital colleagues powered by AI.
+
+## Authentication flow
+
+1. **Register or login** — returns JWT with { sub } only (no org context).
+2. **List organizations** — GET /auth/organizations to see which orgs the user belongs to.
+3. **Select organization** — POST /auth/select-organization with an organizationId — returns new JWT with { sub, org }. Use GET /auth/me to resolve org-admin status.
+4. **Use org-scoped endpoints** — all resource endpoints require the org-scoped token.
+5. **Switch orgs** — call POST /auth/select-organization again with a different org.
+6. **Token refresh** — POST /auth/refresh preserves org context.
+
+## Architecture
+
+Users create conversations with digital colleagues. Each colleague resolves its available tools and context from namespace bindings — tool availability is determined by which skills exist in the colleague's namespaces. Complex work is delegated to subagents via background tasks. Context profiles optionally pre-load condensed file/web page content into the system prompt.
+
+## Namespaces & access control
+
+All resources (databases, skills, apps, files, context profiles, widgets, memories) live in namespaces. Namespaces serve triple duty: group resources, define member visibility, and control permissions via role bindings. See the `namespaces` tag for the full RBAC model.
+
+## Digital colleagues
+
+Persistent AI team members with defined personas, optional model overrides, and namespace-scoped access. All conversations go through a colleague (the system colleague "Buzz" is the default). Colleagues can be invited into meetings for multi-party conversations.
+
+## Skills
+
+Org-scoped capability packages that bundle markdown instructions with tool access. Skills live in namespaces — a colleague gets a skill's tools if it has `skill:use` permission in that namespace. Tool execution is guarded: the streaming loop rejects any tool call not in the resolved set.
+
+## Memories
+
+Two-tier memory system: **org memories** (business facts about the org) and **user memories** (facts about individual users). Created via contemplation (post-conversation synthesis), explicit `remember_this` during conversation, or `manage_user_memory` tool. Injected into system prompts as background knowledge.
+
+## Billing
+
+Credit-based billing. Usage (AI tokens) is tracked and converted to credits via exchange rates. When credits run out, expensive operations return 402.
+
+## File upload flow
+
+POST /files as multipart/form-data with the file in the `file` field. The API stores the file, creates the record, and triggers condensation in a single request.
+
+## Dynamic databases
+
+Each organization can have multiple databases, each backed by its own isolated PostgreSQL schema. Databases are fully SQL-driven — no abstraction layer. Use POST /databases/:id/sql for DDL and DML. Supports migrations, forking, and promoting.
+
+## Conversation SSE protocol
+
+POST /conversations/:id/messages returns an SSE stream (Content-Type: text/event-stream). Events:
+
+| Event | Data | Description |
+|---|---|---|
+| `text` | Raw text delta | Append to displayed message |
+| `tool_use` | `{ "tool": "<name>", "status": "executing" }` | Orchestrator is calling a tool (show spinner) |
+| `done` | `{ "content": "...", "retrievedUnits": [...], "usage": {...} }` | Stream complete |
+| `error` | `{ "error": "..." }` | Error during streaming |
+
+Parse SSE with `event:` and `data:` fields per the SSE spec. On `done`, stop listening and close the connection.
+
+## Inline widgets
+
+Lightweight React components rendered inside conversation messages. Created by the orchestrator during streaming via the `create_widget` tool. Widgets can be saved to a library for reuse.
+
+## Apps
+
+Per-org managed containers running Express. Each org gets its own container with apps served as Express routes. All app traffic is proxied through the API. Install pre-built templates or build custom apps.
+
+## Member management
+
+Org admins manage their team through invitations and namespace bindings:
+
+1. **Invite** — POST /organizations/me/invitations with email → sends an invitation email with a link.
+2. **View invitation** — GET /invitations/:token (public, no auth) → shows org name and whether the invitee has an account.
+3. **Accept** — POST /invitations/:token/accept (auth required, email must match) → creates namespace binding. Then call POST /auth/select-organization to enter the org.
+4. **Decline** — DELETE /invitations/:token (auth required) → permanently deletes the invitation.
+5. **List members** — GET /organizations/me/members → all members with userId, email, displayName, joinedAt.
+6. **Manage access** — use namespace bindings and system roles to control permissions (see `namespaces` tag).
+
+## Context profiles
+
+Context profiles are optional — a conversation can be created without one. When a profile is assigned to a namespace, colleagues with access to that namespace will have its tag and website sources loaded as condensed context into the system prompt.
+ * OpenAPI spec version: 2.0
+ */
+import type { ToolHistoryEntryDtoType } from './toolHistoryEntryDtoType';
+import type { ToolHistoryEntryDtoInput } from './toolHistoryEntryDtoInput';
+import type { ToolHistoryEntryDtoResult } from './toolHistoryEntryDtoResult';
+export interface ToolHistoryEntryDto {
+    /** Kind of this history entry. */
+    type: ToolHistoryEntryDtoType;
+    /** Tool name (set on tool_use entries). */
+    name?: string;
+    /** Id linking a tool_use to its matching tool_result. */
+    toolUseId?: string;
+    /** Input the LLM passed to the tool (set on tool_use entries). */
+    input?: ToolHistoryEntryDtoInput;
+    /** Result the tool returned (set on tool_result entries). */
+    result?: ToolHistoryEntryDtoResult;
+    /** True when the tool_result represents a failure. */
+    isError?: boolean;
+}
+//# sourceMappingURL=toolHistoryEntryDto.d.ts.map

package/dist/generated/schemas/toolHistoryEntryDto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHistoryEntryDto.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/toolHistoryEntryDto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/generated/schemas/toolHistoryEntryDto.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toolHistoryEntryDto.js.map

package/dist/generated/schemas/toolHistoryEntryDto.js.map

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

package/dist/generated/schemas/toolHistoryEntryDtoInput.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Beeable API
+ * Orchestrator-first business agent platform — a multi-tenant platform where users talk to digital colleagues powered by AI.
+
+## Authentication flow
+
+1. **Register or login** — returns JWT with { sub } only (no org context).
+2. **List organizations** — GET /auth/organizations to see which orgs the user belongs to.
+3. **Select organization** — POST /auth/select-organization with an organizationId — returns new JWT with { sub, org }. Use GET /auth/me to resolve org-admin status.
+4. **Use org-scoped endpoints** — all resource endpoints require the org-scoped token.
+5. **Switch orgs** — call POST /auth/select-organization again with a different org.
+6. **Token refresh** — POST /auth/refresh preserves org context.
+
+## Architecture
+
+Users create conversations with digital colleagues. Each colleague resolves its available tools and context from namespace bindings — tool availability is determined by which skills exist in the colleague's namespaces. Complex work is delegated to subagents via background tasks. Context profiles optionally pre-load condensed file/web page content into the system prompt.
+
+## Namespaces & access control
+
+All resources (databases, skills, apps, files, context profiles, widgets, memories) live in namespaces. Namespaces serve triple duty: group resources, define member visibility, and control permissions via role bindings. See the `namespaces` tag for the full RBAC model.
+
+## Digital colleagues
+
+Persistent AI team members with defined personas, optional model overrides, and namespace-scoped access. All conversations go through a colleague (the system colleague "Buzz" is the default). Colleagues can be invited into meetings for multi-party conversations.
+
+## Skills
+
+Org-scoped capability packages that bundle markdown instructions with tool access. Skills live in namespaces — a colleague gets a skill's tools if it has `skill:use` permission in that namespace. Tool execution is guarded: the streaming loop rejects any tool call not in the resolved set.
+
+## Memories
+
+Two-tier memory system: **org memories** (business facts about the org) and **user memories** (facts about individual users). Created via contemplation (post-conversation synthesis), explicit `remember_this` during conversation, or `manage_user_memory` tool. Injected into system prompts as background knowledge.
+
+## Billing
+
+Credit-based billing. Usage (AI tokens) is tracked and converted to credits via exchange rates. When credits run out, expensive operations return 402.
+
+## File upload flow
+
+POST /files as multipart/form-data with the file in the `file` field. The API stores the file, creates the record, and triggers condensation in a single request.
+
+## Dynamic databases
+
+Each organization can have multiple databases, each backed by its own isolated PostgreSQL schema. Databases are fully SQL-driven — no abstraction layer. Use POST /databases/:id/sql for DDL and DML. Supports migrations, forking, and promoting.
+
+## Conversation SSE protocol
+
+POST /conversations/:id/messages returns an SSE stream (Content-Type: text/event-stream). Events:
+
+| Event | Data | Description |
+|---|---|---|
+| `text` | Raw text delta | Append to displayed message |
+| `tool_use` | `{ "tool": "<name>", "status": "executing" }` | Orchestrator is calling a tool (show spinner) |
+| `done` | `{ "content": "...", "retrievedUnits": [...], "usage": {...} }` | Stream complete |
+| `error` | `{ "error": "..." }` | Error during streaming |
+
+Parse SSE with `event:` and `data:` fields per the SSE spec. On `done`, stop listening and close the connection.
+
+## Inline widgets
+
+Lightweight React components rendered inside conversation messages. Created by the orchestrator during streaming via the `create_widget` tool. Widgets can be saved to a library for reuse.
+
+## Apps
+
+Per-org managed containers running Express. Each org gets its own container with apps served as Express routes. All app traffic is proxied through the API. Install pre-built templates or build custom apps.
+
+## Member management
+
+Org admins manage their team through invitations and namespace bindings:
+
+1. **Invite** — POST /organizations/me/invitations with email → sends an invitation email with a link.
+2. **View invitation** — GET /invitations/:token (public, no auth) → shows org name and whether the invitee has an account.
+3. **Accept** — POST /invitations/:token/accept (auth required, email must match) → creates namespace binding. Then call POST /auth/select-organization to enter the org.
+4. **Decline** — DELETE /invitations/:token (auth required) → permanently deletes the invitation.
+5. **List members** — GET /organizations/me/members → all members with userId, email, displayName, joinedAt.
+6. **Manage access** — use namespace bindings and system roles to control permissions (see `namespaces` tag).
+
+## Context profiles
+
+Context profiles are optional — a conversation can be created without one. When a profile is assigned to a namespace, colleagues with access to that namespace will have its tag and website sources loaded as condensed context into the system prompt.
+ * OpenAPI spec version: 2.0
+ */
+/**
+ * Input the LLM passed to the tool (set on tool_use entries).
+ */
+export type ToolHistoryEntryDtoInput = {
+    [key: string]: unknown;
+};
+//# sourceMappingURL=toolHistoryEntryDtoInput.d.ts.map

package/dist/generated/schemas/toolHistoryEntryDtoInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHistoryEntryDtoInput.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/toolHistoryEntryDtoInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}

package/dist/generated/schemas/toolHistoryEntryDtoInput.js

@@ -0,0 +1,86 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Beeable API
+ * Orchestrator-first business agent platform — a multi-tenant platform where users talk to digital colleagues powered by AI.
+
+## Authentication flow
+
+1. **Register or login** — returns JWT with { sub } only (no org context).
+2. **List organizations** — GET /auth/organizations to see which orgs the user belongs to.
+3. **Select organization** — POST /auth/select-organization with an organizationId — returns new JWT with { sub, org }. Use GET /auth/me to resolve org-admin status.
+4. **Use org-scoped endpoints** — all resource endpoints require the org-scoped token.
+5. **Switch orgs** — call POST /auth/select-organization again with a different org.
+6. **Token refresh** — POST /auth/refresh preserves org context.
+
+## Architecture
+
+Users create conversations with digital colleagues. Each colleague resolves its available tools and context from namespace bindings — tool availability is determined by which skills exist in the colleague's namespaces. Complex work is delegated to subagents via background tasks. Context profiles optionally pre-load condensed file/web page content into the system prompt.
+
+## Namespaces & access control
+
+All resources (databases, skills, apps, files, context profiles, widgets, memories) live in namespaces. Namespaces serve triple duty: group resources, define member visibility, and control permissions via role bindings. See the `namespaces` tag for the full RBAC model.
+
+## Digital colleagues
+
+Persistent AI team members with defined personas, optional model overrides, and namespace-scoped access. All conversations go through a colleague (the system colleague "Buzz" is the default). Colleagues can be invited into meetings for multi-party conversations.
+
+## Skills
+
+Org-scoped capability packages that bundle markdown instructions with tool access. Skills live in namespaces — a colleague gets a skill's tools if it has `skill:use` permission in that namespace. Tool execution is guarded: the streaming loop rejects any tool call not in the resolved set.
+
+## Memories
+
+Two-tier memory system: **org memories** (business facts about the org) and **user memories** (facts about individual users). Created via contemplation (post-conversation synthesis), explicit `remember_this` during conversation, or `manage_user_memory` tool. Injected into system prompts as background knowledge.
+
+## Billing
+
+Credit-based billing. Usage (AI tokens) is tracked and converted to credits via exchange rates. When credits run out, expensive operations return 402.
+
+## File upload flow
+
+POST /files as multipart/form-data with the file in the `file` field. The API stores the file, creates the record, and triggers condensation in a single request.
+
+## Dynamic databases
+
+Each organization can have multiple databases, each backed by its own isolated PostgreSQL schema. Databases are fully SQL-driven — no abstraction layer. Use POST /databases/:id/sql for DDL and DML. Supports migrations, forking, and promoting.
+
+## Conversation SSE protocol
+
+POST /conversations/:id/messages returns an SSE stream (Content-Type: text/event-stream). Events:
+
+| Event | Data | Description |
+|---|---|---|
+| `text` | Raw text delta | Append to displayed message |
+| `tool_use` | `{ "tool": "<name>", "status": "executing" }` | Orchestrator is calling a tool (show spinner) |
+| `done` | `{ "content": "...", "retrievedUnits": [...], "usage": {...} }` | Stream complete |
+| `error` | `{ "error": "..." }` | Error during streaming |
+
+Parse SSE with `event:` and `data:` fields per the SSE spec. On `done`, stop listening and close the connection.
+
+## Inline widgets
+
+Lightweight React components rendered inside conversation messages. Created by the orchestrator during streaming via the `create_widget` tool. Widgets can be saved to a library for reuse.
+
+## Apps
+
+Per-org managed containers running Express. Each org gets its own container with apps served as Express routes. All app traffic is proxied through the API. Install pre-built templates or build custom apps.
+
+## Member management
+
+Org admins manage their team through invitations and namespace bindings:
+
+1. **Invite** — POST /organizations/me/invitations with email → sends an invitation email with a link.
+2. **View invitation** — GET /invitations/:token (public, no auth) → shows org name and whether the invitee has an account.
+3. **Accept** — POST /invitations/:token/accept (auth required, email must match) → creates namespace binding. Then call POST /auth/select-organization to enter the org.
+4. **Decline** — DELETE /invitations/:token (auth required) → permanently deletes the invitation.
+5. **List members** — GET /organizations/me/members → all members with userId, email, displayName, joinedAt.
+6. **Manage access** — use namespace bindings and system roles to control permissions (see `namespaces` tag).
+
+## Context profiles
+
+Context profiles are optional — a conversation can be created without one. When a profile is assigned to a namespace, colleagues with access to that namespace will have its tag and website sources loaded as condensed context into the system prompt.
+ * OpenAPI spec version: 2.0
+ */
+export {};
+//# sourceMappingURL=toolHistoryEntryDtoInput.js.map

package/dist/generated/schemas/toolHistoryEntryDtoInput.js.map

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

package/dist/generated/schemas/toolHistoryEntryDtoResult.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Beeable API
+ * Orchestrator-first business agent platform — a multi-tenant platform where users talk to digital colleagues powered by AI.
+
+## Authentication flow
+
+1. **Register or login** — returns JWT with { sub } only (no org context).
+2. **List organizations** — GET /auth/organizations to see which orgs the user belongs to.
+3. **Select organization** — POST /auth/select-organization with an organizationId — returns new JWT with { sub, org }. Use GET /auth/me to resolve org-admin status.
+4. **Use org-scoped endpoints** — all resource endpoints require the org-scoped token.
+5. **Switch orgs** — call POST /auth/select-organization again with a different org.
+6. **Token refresh** — POST /auth/refresh preserves org context.
+
+## Architecture
+
+Users create conversations with digital colleagues. Each colleague resolves its available tools and context from namespace bindings — tool availability is determined by which skills exist in the colleague's namespaces. Complex work is delegated to subagents via background tasks. Context profiles optionally pre-load condensed file/web page content into the system prompt.
+
+## Namespaces & access control
+
+All resources (databases, skills, apps, files, context profiles, widgets, memories) live in namespaces. Namespaces serve triple duty: group resources, define member visibility, and control permissions via role bindings. See the `namespaces` tag for the full RBAC model.
+
+## Digital colleagues
+
+Persistent AI team members with defined personas, optional model overrides, and namespace-scoped access. All conversations go through a colleague (the system colleague "Buzz" is the default). Colleagues can be invited into meetings for multi-party conversations.
+
+## Skills
+
+Org-scoped capability packages that bundle markdown instructions with tool access. Skills live in namespaces — a colleague gets a skill's tools if it has `skill:use` permission in that namespace. Tool execution is guarded: the streaming loop rejects any tool call not in the resolved set.
+
+## Memories
+
+Two-tier memory system: **org memories** (business facts about the org) and **user memories** (facts about individual users). Created via contemplation (post-conversation synthesis), explicit `remember_this` during conversation, or `manage_user_memory` tool. Injected into system prompts as background knowledge.
+
+## Billing
+
+Credit-based billing. Usage (AI tokens) is tracked and converted to credits via exchange rates. When credits run out, expensive operations return 402.
+
+## File upload flow
+
+POST /files as multipart/form-data with the file in the `file` field. The API stores the file, creates the record, and triggers condensation in a single request.
+
+## Dynamic databases
+
+Each organization can have multiple databases, each backed by its own isolated PostgreSQL schema. Databases are fully SQL-driven — no abstraction layer. Use POST /databases/:id/sql for DDL and DML. Supports migrations, forking, and promoting.
+
+## Conversation SSE protocol
+
+POST /conversations/:id/messages returns an SSE stream (Content-Type: text/event-stream). Events:
+
+| Event | Data | Description |
+|---|---|---|
+| `text` | Raw text delta | Append to displayed message |
+| `tool_use` | `{ "tool": "<name>", "status": "executing" }` | Orchestrator is calling a tool (show spinner) |
+| `done` | `{ "content": "...", "retrievedUnits": [...], "usage": {...} }` | Stream complete |
+| `error` | `{ "error": "..." }` | Error during streaming |
+
+Parse SSE with `event:` and `data:` fields per the SSE spec. On `done`, stop listening and close the connection.
+
+## Inline widgets
+
+Lightweight React components rendered inside conversation messages. Created by the orchestrator during streaming via the `create_widget` tool. Widgets can be saved to a library for reuse.
+
+## Apps
+
+Per-org managed containers running Express. Each org gets its own container with apps served as Express routes. All app traffic is proxied through the API. Install pre-built templates or build custom apps.
+
+## Member management
+
+Org admins manage their team through invitations and namespace bindings:
+
+1. **Invite** — POST /organizations/me/invitations with email → sends an invitation email with a link.
+2. **View invitation** — GET /invitations/:token (public, no auth) → shows org name and whether the invitee has an account.
+3. **Accept** — POST /invitations/:token/accept (auth required, email must match) → creates namespace binding. Then call POST /auth/select-organization to enter the org.
+4. **Decline** — DELETE /invitations/:token (auth required) → permanently deletes the invitation.
+5. **List members** — GET /organizations/me/members → all members with userId, email, displayName, joinedAt.
+6. **Manage access** — use namespace bindings and system roles to control permissions (see `namespaces` tag).
+
+## Context profiles
+
+Context profiles are optional — a conversation can be created without one. When a profile is assigned to a namespace, colleagues with access to that namespace will have its tag and website sources loaded as condensed context into the system prompt.
+ * OpenAPI spec version: 2.0
+ */
+/**
+ * Result the tool returned (set on tool_result entries).
+ */
+export type ToolHistoryEntryDtoResult = {
+    [key: string]: unknown;
+};
+//# sourceMappingURL=toolHistoryEntryDtoResult.d.ts.map

package/dist/generated/schemas/toolHistoryEntryDtoResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolHistoryEntryDtoResult.d.ts","sourceRoot":"","sources":["../../../src/generated/schemas/toolHistoryEntryDtoResult.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}

package/dist/generated/schemas/toolHistoryEntryDtoResult.js

@@ -0,0 +1,86 @@
+/**
+ * Generated by orval v7.21.0 🍺
+ * Do not edit manually.
+ * Beeable API
+ * Orchestrator-first business agent platform — a multi-tenant platform where users talk to digital colleagues powered by AI.
+
+## Authentication flow
+
+1. **Register or login** — returns JWT with { sub } only (no org context).
+2. **List organizations** — GET /auth/organizations to see which orgs the user belongs to.
+3. **Select organization** — POST /auth/select-organization with an organizationId — returns new JWT with { sub, org }. Use GET /auth/me to resolve org-admin status.
+4. **Use org-scoped endpoints** — all resource endpoints require the org-scoped token.
+5. **Switch orgs** — call POST /auth/select-organization again with a different org.
+6. **Token refresh** — POST /auth/refresh preserves org context.
+
+## Architecture
+
+Users create conversations with digital colleagues. Each colleague resolves its available tools and context from namespace bindings — tool availability is determined by which skills exist in the colleague's namespaces. Complex work is delegated to subagents via background tasks. Context profiles optionally pre-load condensed file/web page content into the system prompt.
+
+## Namespaces & access control
+
+All resources (databases, skills, apps, files, context profiles, widgets, memories) live in namespaces. Namespaces serve triple duty: group resources, define member visibility, and control permissions via role bindings. See the `namespaces` tag for the full RBAC model.
+
+## Digital colleagues
+
+Persistent AI team members with defined personas, optional model overrides, and namespace-scoped access. All conversations go through a colleague (the system colleague "Buzz" is the default). Colleagues can be invited into meetings for multi-party conversations.
+
+## Skills
+
+Org-scoped capability packages that bundle markdown instructions with tool access. Skills live in namespaces — a colleague gets a skill's tools if it has `skill:use` permission in that namespace. Tool execution is guarded: the streaming loop rejects any tool call not in the resolved set.
+
+## Memories
+
+Two-tier memory system: **org memories** (business facts about the org) and **user memories** (facts about individual users). Created via contemplation (post-conversation synthesis), explicit `remember_this` during conversation, or `manage_user_memory` tool. Injected into system prompts as background knowledge.
+
+## Billing
+
+Credit-based billing. Usage (AI tokens) is tracked and converted to credits via exchange rates. When credits run out, expensive operations return 402.
+
+## File upload flow
+
+POST /files as multipart/form-data with the file in the `file` field. The API stores the file, creates the record, and triggers condensation in a single request.
+
+## Dynamic databases
+
+Each organization can have multiple databases, each backed by its own isolated PostgreSQL schema. Databases are fully SQL-driven — no abstraction layer. Use POST /databases/:id/sql for DDL and DML. Supports migrations, forking, and promoting.
+
+## Conversation SSE protocol
+
+POST /conversations/:id/messages returns an SSE stream (Content-Type: text/event-stream). Events:
+
+| Event | Data | Description |
+|---|---|---|
+| `text` | Raw text delta | Append to displayed message |
+| `tool_use` | `{ "tool": "<name>", "status": "executing" }` | Orchestrator is calling a tool (show spinner) |
+| `done` | `{ "content": "...", "retrievedUnits": [...], "usage": {...} }` | Stream complete |
+| `error` | `{ "error": "..." }` | Error during streaming |
+
+Parse SSE with `event:` and `data:` fields per the SSE spec. On `done`, stop listening and close the connection.
+
+## Inline widgets
+
+Lightweight React components rendered inside conversation messages. Created by the orchestrator during streaming via the `create_widget` tool. Widgets can be saved to a library for reuse.
+
+## Apps
+
+Per-org managed containers running Express. Each org gets its own container with apps served as Express routes. All app traffic is proxied through the API. Install pre-built templates or build custom apps.
+
+## Member management
+
+Org admins manage their team through invitations and namespace bindings:
+
+1. **Invite** — POST /organizations/me/invitations with email → sends an invitation email with a link.
+2. **View invitation** — GET /invitations/:token (public, no auth) → shows org name and whether the invitee has an account.
+3. **Accept** — POST /invitations/:token/accept (auth required, email must match) → creates namespace binding. Then call POST /auth/select-organization to enter the org.
+4. **Decline** — DELETE /invitations/:token (auth required) → permanently deletes the invitation.
+5. **List members** — GET /organizations/me/members → all members with userId, email, displayName, joinedAt.
+6. **Manage access** — use namespace bindings and system roles to control permissions (see `namespaces` tag).
+
+## Context profiles
+
+Context profiles are optional — a conversation can be created without one. When a profile is assigned to a namespace, colleagues with access to that namespace will have its tag and website sources loaded as condensed context into the system prompt.
+ * OpenAPI spec version: 2.0
+ */
+export {};
+//# sourceMappingURL=toolHistoryEntryDtoResult.js.map

package/dist/generated/schemas/toolHistoryEntryDtoResult.js.map

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