@operla-ai/sdk 0.2.1 → 0.3.3

package/dist/generated/index.d.ts

@@ -1,3 +1,3 @@
-export { Conversations, Entities, type Options, Organizations } from './sdk.gen.js';
-export type { AppendMessageData, AppendMessageError, AppendMessageErrors, AppendMessageResponse, AppendMessageResponses, ClientOptions, Create2Data, Create2Error, Create2Errors, Create2Response, Create2Responses, CreateData, CreateError, CreateErrors, CreateResponse, CreateResponses, Delete2Data, Delete2Error, Delete2Errors, Delete2Response, Delete2Responses, DeleteData, DeleteError, DeleteErrors, DeleteResponse, DeleteResponses, Get2Data, Get2Error, Get2Errors, Get2Response, Get2Responses, Get3Data, Get3Error, Get3Errors, Get3Response, Get3Responses, GetData, GetError, GetErrors, GetResponse, GetResponses, List2Data, List2Error, List2Errors, List2Response, List2Responses, List3Data, List3Error, List3Errors, List3Response, List3Responses, ListData, ListError, ListErrors, ListResponse, ListResponses, SendMessageData, SendMessageError, SendMessageErrors, SendMessageResponse, SendMessageResponses, Update2Data, Update2Error, Update2Errors, Update2Response, Update2Responses, UpdateData, UpdateError, UpdateErrors, UpdateResponse, UpdateResponses, ValidateResponseData, ValidateResponseError, ValidateResponseErrors, ValidateResponseResponse, ValidateResponseResponses } from './types.gen.js';
+export { Agents, Conversations, Entities, Kb, type Options, Organizations } from './sdk.gen.js';
+export type { AppendMessageData, AppendMessageError, AppendMessageErrors, AppendMessageResponse, AppendMessageResponses, ClientOptions, Create2Data, Create2Error, Create2Errors, Create2Response, Create2Responses, Create3Data, Create3Error, Create3Errors, Create3Response, Create3Responses, Create4Data, Create4Error, Create4Errors, Create4Response, Create4Responses, CreateData, CreateError, CreateErrors, CreateResponse, CreateResponses, Delete2Data, Delete2Error, Delete2Errors, Delete2Response, Delete2Responses, Delete3Data, Delete3Error, Delete3Errors, Delete3Response, Delete3Responses, Delete4Data, Delete4Error, Delete4Errors, Delete4Response, Delete4Responses, DeleteData, DeleteError, DeleteErrors, DeleteOverrideData, DeleteOverrideError, DeleteOverrideErrors, DeleteOverrideResponse, DeleteOverrideResponses, DeleteResponse, DeleteResponses, Get2Data, Get2Error, Get2Errors, Get2Response, Get2Responses, Get3Data, Get3Error, Get3Errors, Get3Response, Get3Responses, Get4Data, Get4Error, Get4Errors, Get4Response, Get4Responses, Get5Data, Get5Error, Get5Errors, Get5Response, Get5Responses, GetData, GetError, GetErrors, GetResponse, GetResponses, List2Data, List2Error, List2Errors, List2Response, List2Responses, List3Data, List3Error, List3Errors, List3Response, List3Responses, List4Data, List4Error, List4Errors, List4Response, List4Responses, List5Data, List5Error, List5Errors, List5Response, List5Responses, ListData, ListError, ListErrors, ListResponse, ListResponses, Publish2Data, Publish2Error, Publish2Errors, Publish2Response, Publish2Responses, PublishData, PublishError, PublishErrors, PublishResponse, PublishResponses, Rollback2Data, Rollback2Error, Rollback2Errors, Rollback2Response, Rollback2Responses, RollbackData, RollbackError, RollbackErrors, RollbackResponse, RollbackResponses, SendMessageData, SendMessageError, SendMessageErrors, SendMessageResponse, SendMessageResponses, Update2Data, Update2Error, Update2Errors, Update2Response, Update2Responses, Update3Data, Update3Error, Update3Errors, Update3Response, Update3Responses, Update4Data, Update4Error, Update4Errors, Update4Response, Update4Responses, UpdateData, UpdateError, UpdateErrors, UpdateResponse, UpdateResponses, ValidateResponseData, ValidateResponseError, ValidateResponseErrors, ValidateResponseResponse, ValidateResponseResponses } from './types.gen.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChG,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/generated/index.js

@@ -1,9 +1,11 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Organizations = exports.Entities = exports.Conversations = void 0;
+exports.Organizations = exports.Kb = exports.Entities = exports.Conversations = exports.Agents = void 0;
 var sdk_gen_js_1 = require("./sdk.gen.js");
+Object.defineProperty(exports, "Agents", { enumerable: true, get: function () { return sdk_gen_js_1.Agents; } });
 Object.defineProperty(exports, "Conversations", { enumerable: true, get: function () { return sdk_gen_js_1.Conversations; } });
 Object.defineProperty(exports, "Entities", { enumerable: true, get: function () { return sdk_gen_js_1.Entities; } });
+Object.defineProperty(exports, "Kb", { enumerable: true, get: function () { return sdk_gen_js_1.Kb; } });
 Object.defineProperty(exports, "Organizations", { enumerable: true, get: function () { return sdk_gen_js_1.Organizations; } });
 //# sourceMappingURL=index.js.map

package/dist/generated/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAErD,2CAAoF;AAA3E,2GAAA,aAAa,OAAA;AAAE,sGAAA,QAAQ,OAAA;AAAgB,2GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":";AAAA,qDAAqD;;;AAErD,2CAAgG;AAAvF,oGAAA,MAAM,OAAA;AAAE,2GAAA,aAAa,OAAA;AAAE,sGAAA,QAAQ,OAAA;AAAE,gGAAA,EAAE,OAAA;AAAgB,2GAAA,aAAa,OAAA"}

package/dist/generated/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import type { Client, Options as Options2, TDataShape } from './client/index.js';
-import type { AppendMessageData, AppendMessageErrors, AppendMessageResponses, Create2Data, Create2Errors, Create2Responses, CreateData, CreateErrors, CreateResponses, Delete2Data, Delete2Errors, Delete2Responses, DeleteData, DeleteErrors, DeleteResponses, Get2Data, Get2Errors, Get2Responses, Get3Data, Get3Errors, Get3Responses, GetData, GetErrors, GetResponses, List2Data, List2Errors, List2Responses, List3Data, List3Errors, List3Responses, ListData, ListErrors, ListResponses, SendMessageData, SendMessageErrors, SendMessageResponses, Update2Data, Update2Errors, Update2Responses, UpdateData, UpdateErrors, UpdateResponses, ValidateResponseData, ValidateResponseErrors, ValidateResponseResponses } from './types.gen.js';
+import type { AppendMessageData, AppendMessageErrors, AppendMessageResponses, Create2Data, Create2Errors, Create2Responses, Create3Data, Create3Errors, Create3Responses, Create4Data, Create4Errors, Create4Responses, CreateData, CreateErrors, CreateResponses, Delete2Data, Delete2Errors, Delete2Responses, Delete3Data, Delete3Errors, Delete3Responses, Delete4Data, Delete4Errors, Delete4Responses, DeleteData, DeleteErrors, DeleteOverrideData, DeleteOverrideErrors, DeleteOverrideResponses, DeleteResponses, Get2Data, Get2Errors, Get2Responses, Get3Data, Get3Errors, Get3Responses, Get4Data, Get4Errors, Get4Responses, Get5Data, Get5Errors, Get5Responses, GetData, GetErrors, GetResponses, List2Data, List2Errors, List2Responses, List3Data, List3Errors, List3Responses, List4Data, List4Errors, List4Responses, List5Data, List5Errors, List5Responses, ListData, ListErrors, ListResponses, Publish2Data, Publish2Errors, Publish2Responses, PublishData, PublishErrors, PublishResponses, Rollback2Data, Rollback2Errors, Rollback2Responses, RollbackData, RollbackErrors, RollbackResponses, SendMessageData, SendMessageErrors, SendMessageResponses, Update2Data, Update2Errors, Update2Responses, Update3Data, Update3Errors, Update3Responses, Update4Data, Update4Errors, Update4Responses, UpdateData, UpdateErrors, UpdateResponses, ValidateResponseData, ValidateResponseErrors, ValidateResponseResponses } from './types.gen.js';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -13,35 +13,85 @@ export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends
      */
     meta?: Record<string, unknown>;
 };
+export declare class Agents {
+    /**
+     * List agents
+     *
+     * Returns every agent in the catalog. The response omits the resolved config and draft — fetch a single agent to get them.
+     */
+    static list<ThrowOnError extends boolean = false>(options?: Options<ListData, ThrowOnError>): import("./client/types.gen.js").RequestResult<ListResponses, ListErrors, ThrowOnError, "fields">;
+    /**
+     * Create a specialist agent
+     *
+     * Creates a new specialist agent. The machine name is derived from the label (slugified, prefixed with `specialist_`). Core agents (orchestrator, response, …) are bootstrapped by the engine and cannot be created via the SDK.
+     */
+    static create<ThrowOnError extends boolean = false>(options?: Options<CreateData, ThrowOnError>): import("./client/types.gen.js").RequestResult<CreateResponses, CreateErrors, ThrowOnError, "fields">;
+    /**
+     * Delete a specialist agent
+     *
+     * Hard-delete and irreversible. Any intent currently routed to this agent is rebased to the response agent. Only `specialist_*` agents can be deleted — core agents are protected.
+     */
+    static delete<ThrowOnError extends boolean = false>(options: Options<DeleteData, ThrowOnError>): import("./client/types.gen.js").RequestResult<DeleteResponses, DeleteErrors, ThrowOnError, "fields">;
+    /**
+     * Get an agent
+     *
+     * Returns the agent's resolved config at the caller's scope, plus the local draft if any.
+     */
+    static get<ThrowOnError extends boolean = false>(options: Options<GetData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetResponses, GetErrors, ThrowOnError, "fields">;
+    /**
+     * Update an agent
+     *
+     * Applies the provided fields to the agent's draft at the caller's scope, creating the draft if none exists. At organization or entity scope, the override itself is auto-created on the first update — no separate creation step needed. Set `publish: true` to immediately promote the draft (a version snapshot is still archived so rollback remains possible).
+     */
+    static update<ThrowOnError extends boolean = false>(options: Options<UpdateData, ThrowOnError>): import("./client/types.gen.js").RequestResult<UpdateResponses, UpdateErrors, ThrowOnError, "fields">;
+    /**
+     * Delete an agent override
+     *
+     * Removes the agent's override at the caller's scope, along with its draft and version history.
+     */
+    static deleteOverride<ThrowOnError extends boolean = false>(options: Options<DeleteOverrideData, ThrowOnError>): import("./client/types.gen.js").RequestResult<DeleteOverrideResponses, DeleteOverrideErrors, ThrowOnError, "fields">;
+    /**
+     * Publish an agent draft
+     *
+     * Promotes the current draft at the caller's scope to published, archiving the previous version.
+     */
+    static publish<ThrowOnError extends boolean = false>(options: Options<PublishData, ThrowOnError>): import("./client/types.gen.js").RequestResult<PublishResponses, PublishErrors, ThrowOnError, "fields">;
+    /**
+     * Rollback an agent to a previous version
+     *
+     * Restores a previously archived version as the new published. The current published is archived first.
+     */
+    static rollback<ThrowOnError extends boolean = false>(options: Options<RollbackData, ThrowOnError>): import("./client/types.gen.js").RequestResult<RollbackResponses, RollbackErrors, ThrowOnError, "fields">;
+}
 export declare class Conversations {
     /**
      * List conversations
      *
-     * Returns a paginated list of conversations visible to the caller. Admin API keys see every conversation; organization-scoped keys only see their own organization's. The response omits the message thread — fetch a single conversation to get the full thread.
+     * Returns conversations visible to the caller. The response omits the message thread and the custom user `data` — fetch a single conversation to get the full payload.
      */
-    static list<ThrowOnError extends boolean = false>(options?: Options<ListData, ThrowOnError>): import("./client/types.gen.js").RequestResult<ListResponses, ListErrors, ThrowOnError, "fields">;
+    static list<ThrowOnError extends boolean = false>(options?: Options<List2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<List2Responses, List2Errors, ThrowOnError, "fields">;
     /**
      * Get a conversation by ID
      *
-     * Returns the full conversation, including the complete message thread. Returns 404 if the conversation doesn't exist or isn't visible to the caller.
+     * Returns the full conversation, including the complete message thread.
      */
-    static get<ThrowOnError extends boolean = false>(options: Options<GetData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetResponses, GetErrors, ThrowOnError, "fields">;
+    static get<ThrowOnError extends boolean = false>(options: Options<Get2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Get2Responses, Get2Errors, ThrowOnError, "fields">;
     /**
      * Send a conversation message
      *
-     * Processes a user message. On the first call (no `conversationId`), a new conversation is created and returned. On subsequent calls, pass the `conversationId` to continue the same conversation. The response includes the AI answer, the resolved entity, and the organization the conversation was attached to (derived from the API key or `X-Organization-Id` header for admin keys).
+     * Processes a user message through the AI pipeline. Omit `conversationId` on the first call — a new conversation is created and its ID is returned to pass back on subsequent messages.
      */
     static sendMessage<ThrowOnError extends boolean = false>(options?: Options<SendMessageData, ThrowOnError>): import("./client/types.gen.js").RequestResult<SendMessageResponses, SendMessageErrors, ThrowOnError, "fields">;
     /**
      * Validate a pending response
      *
-     * Approves an AI response that is awaiting human validation. Pending actions are executed and the response is recorded as validated. Pass `editedContent` to record an edited version of the response — the original AI content is preserved on the conversation for analytics.
+     * Approves an AI response awaiting human validation: pending actions run and the response is marked validated. Pass `editedContent` to record an edited version — the original AI content is preserved for analytics.
      */
     static validateResponse<ThrowOnError extends boolean = false>(options: Options<ValidateResponseData, ThrowOnError>): import("./client/types.gen.js").RequestResult<ValidateResponseResponses, ValidateResponseErrors, ThrowOnError, "fields">;
     /**
      * Append a message to a conversation
      *
-     * Appends a message to the conversation thread without triggering the AI. Use this for operator replies or out-of-band context. To send a user message that should be processed by the AI, use [`sendMessage`](#tag/conversations/POST/conversations/messages) instead.
+     * Appends a message to the thread without triggering the AI. Use this for operator replies or out-of-band context. For user messages that should be processed, use [`sendMessage`](#tag/conversations/POST/conversations/messages) instead.
      */
     static appendMessage<ThrowOnError extends boolean = false>(options: Options<AppendMessageData, ThrowOnError>): import("./client/types.gen.js").RequestResult<AppendMessageResponses, AppendMessageErrors, ThrowOnError, "fields">;
 }
@@ -49,64 +99,108 @@ export declare class Entities {
     /**
      * List entities
      *
-     * Returns every entity visible to the authenticated caller. If organizations are enabled, scoped API keys only see entities in their org. Admin keys and admin users can filter by `organizationId`.
+     * Returns entities visible to the caller. The response omits `metadata` — fetch a single entity to get it.
      */
-    static list<ThrowOnError extends boolean = false>(options?: Options<List2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<List2Responses, List2Errors, ThrowOnError, "fields">;
+    static list<ThrowOnError extends boolean = false>(options?: Options<List3Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<List3Responses, List3Errors, ThrowOnError, "fields">;
     /**
      * Create an entity
      *
-     * Creates a new entity within the caller's organization (or at the root if organizations are not enabled). `metadata` is free-form and must conform to the `entitySchema` you declared.
+     * Creates a new entity. `metadata` is free-form and must conform to the `entitySchema` you declared.
      */
-    static create<ThrowOnError extends boolean = false>(options?: Options<CreateData, ThrowOnError>): import("./client/types.gen.js").RequestResult<CreateResponses, CreateErrors, ThrowOnError, "fields">;
+    static create<ThrowOnError extends boolean = false>(options?: Options<Create2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Create2Responses, Create2Errors, ThrowOnError, "fields">;
     /**
      * Delete an entity
      *
-     * Hard delete and irreversible — conversations and entity-scoped configs (KB articles, prompts, rules) tied to this entity will be orphaned (not cascaded).
+     * Hard delete and irreversible — conversations and entity-scoped configurations attached to this entity will be orphaned (not cascaded).
      */
-    static delete<ThrowOnError extends boolean = false>(options: Options<DeleteData, ThrowOnError>): import("./client/types.gen.js").RequestResult<DeleteResponses, DeleteErrors, ThrowOnError, "fields">;
+    static delete<ThrowOnError extends boolean = false>(options: Options<Delete2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Delete2Responses, Delete2Errors, ThrowOnError, "fields">;
     /**
      * Get entity by ID
      *
-     * Fetch a single entity by ID. Returns 404 if the entity doesn't exist or isn't visible to the caller.
+     * Returns a single entity by ID.
      */
-    static get<ThrowOnError extends boolean = false>(options: Options<Get2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Get2Responses, Get2Errors, ThrowOnError, "fields">;
+    static get<ThrowOnError extends boolean = false>(options: Options<Get3Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Get3Responses, Get3Errors, ThrowOnError, "fields">;
     /**
      * Update an entity
      *
-     * Partial update. Only the fields present in the body are modified. Returns the updated entity.
+     * Applies the provided fields to the entity. Only the fields present in the body are modified.
      */
-    static update<ThrowOnError extends boolean = false>(options: Options<UpdateData, ThrowOnError>): import("./client/types.gen.js").RequestResult<UpdateResponses, UpdateErrors, ThrowOnError, "fields">;
+    static update<ThrowOnError extends boolean = false>(options: Options<Update2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Update2Responses, Update2Errors, ThrowOnError, "fields">;
+}
+export declare class Kb {
+    /**
+     * List KB articles
+     *
+     * Returns articles visible at the caller's scope. The response omits the article body — fetch a single article to get the full content.
+     */
+    static list<ThrowOnError extends boolean = false>(options?: Options<List4Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<List4Responses, List4Errors, ThrowOnError, "fields">;
+    /**
+     * Create a KB article
+     *
+     * Creates a new article at the caller's scope, published immediately as v1.
+     */
+    static create<ThrowOnError extends boolean = false>(options?: Options<Create3Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Create3Responses, Create3Errors, ThrowOnError, "fields">;
+    /**
+     * Delete a KB article
+     *
+     * Hard delete and irreversible — removes the article and its version history.
+     */
+    static delete<ThrowOnError extends boolean = false>(options: Options<Delete3Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Delete3Responses, Delete3Errors, ThrowOnError, "fields">;
+    /**
+     * Get a KB article
+     *
+     * Returns the full article (published + draft if any).
+     */
+    static get<ThrowOnError extends boolean = false>(options: Options<Get4Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Get4Responses, Get4Errors, ThrowOnError, "fields">;
+    /**
+     * Update a KB article
+     *
+     * Applies the provided fields to the article. Content edits (`title`, `content`) go through the draft workflow — set `publish: true` to promote the draft in the same call. Routing changes (`intents`) bypass the draft.
+     */
+    static update<ThrowOnError extends boolean = false>(options: Options<Update3Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Update3Responses, Update3Errors, ThrowOnError, "fields">;
+    /**
+     * Publish a KB article draft
+     *
+     * Promotes the article's current draft to published, archiving the previous version.
+     */
+    static publish<ThrowOnError extends boolean = false>(options: Options<Publish2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Publish2Responses, Publish2Errors, ThrowOnError, "fields">;
+    /**
+     * Rollback a KB article to a previous version
+     *
+     * Restores a previously archived version as the new published. The current published is archived first.
+     */
+    static rollback<ThrowOnError extends boolean = false>(options: Options<Rollback2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Rollback2Responses, Rollback2Errors, ThrowOnError, "fields">;
 }
 export declare class Organizations {
     /**
      * List organizations
      *
-     * Returns every organization in your deployment. Only admin API keys and admin users can list organizations — scoped keys always get a 403 here.
+     * Returns every organization in your deployment. Admin keys only. The response omits `metadata` — fetch a single organization to get it.
      */
-    static list<ThrowOnError extends boolean = false>(options?: Options<List3Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<List3Responses, List3Errors, ThrowOnError, "fields">;
+    static list<ThrowOnError extends boolean = false>(options?: Options<List5Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<List5Responses, List5Errors, ThrowOnError, "fields">;
     /**
      * Create an organization
      *
-     * Creates a new organization and returns a freshly-minted scoped API key for it. **The key is shown only once — store it immediately**, you won't be able to retrieve it again (only a non-sensitive prefix is persisted for identification).
+     * Creates a new organization and returns a freshly-minted scoped API key for it. **The key is shown only once — store it immediately**, you won't be able to retrieve it again.
      */
-    static create<ThrowOnError extends boolean = false>(options?: Options<Create2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Create2Responses, Create2Errors, ThrowOnError, "fields">;
+    static create<ThrowOnError extends boolean = false>(options?: Options<Create4Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Create4Responses, Create4Errors, ThrowOnError, "fields">;
     /**
      * Delete an organization
      *
-     * Hard delete and irreversible — linked users, entities, API keys and conversations become orphaned (not cascaded), and users scoped to this organization lose login access.
+     * Hard delete and irreversible. Linked users, entities, API keys and conversations are orphaned (not cascaded). Users scoped to this organization lose login access.
      */
-    static delete<ThrowOnError extends boolean = false>(options: Options<Delete2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Delete2Responses, Delete2Errors, ThrowOnError, "fields">;
+    static delete<ThrowOnError extends boolean = false>(options: Options<Delete4Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Delete4Responses, Delete4Errors, ThrowOnError, "fields">;
     /**
      * Get organization by ID
      *
-     * Fetch a single organization by ID.
+     * Returns a single organization by ID.
      */
-    static get<ThrowOnError extends boolean = false>(options: Options<Get3Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Get3Responses, Get3Errors, ThrowOnError, "fields">;
+    static get<ThrowOnError extends boolean = false>(options: Options<Get5Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Get5Responses, Get5Errors, ThrowOnError, "fields">;
     /**
      * Update an organization
      *
-     * Partial update — only the fields present in the body are modified.
+     * Applies the provided fields to the organization. Only the fields present in the body are modified.
      */
-    static update<ThrowOnError extends boolean = false>(options: Options<Update2Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Update2Responses, Update2Errors, ThrowOnError, "fields">;
+    static update<ThrowOnError extends boolean = false>(options: Options<Update4Data, ThrowOnError>): import("./client/types.gen.js").RequestResult<Update4Responses, Update4Errors, ThrowOnError, "fields">;
 }
 //# sourceMappingURL=sdk.gen.d.ts.map

package/dist/generated/sdk.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.gen.d.ts","sourceRoot":"","sources":["../../src/generated/sdk.gen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,IAAI,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEptB,MAAM,MAAM,OAAO,CAAC,KAAK,SAAS,UAAU,GAAG,UAAU,EAAE,YAAY,SAAS,OAAO,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,GAAG;IACjK;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,qBAAa,aAAa;IACtB;;;;OAIG;WACW,IAAI,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;IAQlG;;;;OAIG;WACW,GAAG,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC;IAQ/F;;;;OAIG;WACW,WAAW,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,EAAE,YAAY,CAAC;IAYhH;;;;OAIG;WACW,gBAAgB,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,oBAAoB,EAAE,YAAY,CAAC;IAYzH;;;;OAIG;WACW,aAAa,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,iBAAiB,EAAE,YAAY,CAAC;CAWtH;AAED,qBAAa,QAAQ;IACjB;;;;OAIG;WACW,IAAI,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;IAQnG;;;;OAIG;WACW,MAAM,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;IAYtG;;;;OAIG;WACW,MAAM,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;IAQrG;;;;OAIG;WACW,GAAG,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;IAQhG;;;;OAIG;WACW,MAAM,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;CAWxG;AAED,qBAAa,aAAa;IACtB;;;;OAIG;WACW,IAAI,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;IAQnG;;;;OAIG;WACW,MAAM,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;IAYvG;;;;OAIG;WACW,MAAM,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;IAQtG;;;;OAIG;WACW,GAAG,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC;IAQhG;;;;OAIG;WACW,MAAM,CAAC,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;CAWzG"}
+{"version":3,"file":"sdk.gen.d.ts","sourceRoot":"","sources":["../../src/generated/sdk.gen.ts"],"names":[],"mappings":"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"}