@breign/client 1.0.163 → 1.0.164

package/dist/apis/AgentApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AddModuleRequestUio, AdvancedFlowEditorUio, AdvancedFlowEditorUpdateRequestUio, AgentDuplicateRequestUio, AgentFlowCreateUio, AgentFlowUio, AgentImportRequestUio, AgentImportResponseUio, AgentMetricsEventUio, AgentMetricsOverviewUio, AgentModuleUio, AgentPatchUio, AgentRequestUio, AgentSubscriptionUio, AgentToolAllowedMethodsRequestUio, AgentUio, AgentUsageMetricsUio, BodyWithIdUio, ChatUio, ConversationAttachmentDownloadUrlUio, ConversationMessageImagesUio, DeleteMessageAudio200ResponseUio, EphemeralInstancesMetricsResponseUio, FileCreationRequestUio, FileCreationResponseUio, FlowEditorUio, FlowEditorUpdateRequestUio, MessageAudioDownloadUrlUio, OrgUsageMetricsResponseUio, S3UploadBodyUio, STTResponseUio } from '../models/index';
+import type { AddModuleRequestUio, AdvancedFlowEditorUio, AdvancedFlowEditorUpdateRequestUio, AgentDuplicateRequestUio, AgentFlowCreateUio, AgentFlowUio, AgentImportRequestUio, AgentImportResponseUio, AgentMetricsEventUio, AgentMetricsOverviewUio, AgentModuleUio, AgentPatchUio, AgentPromptInitGenerationRequestUio, AgentPromptInitGenerationResponseUio, AgentRequestUio, AgentSubscriptionUio, AgentToolAllowedMethodsRequestUio, AgentUio, AgentUsageMetricsUio, BodyWithIdUio, ChatUio, ConversationAttachmentDownloadUrlUio, ConversationMessageImagesUio, DeleteMessageAudio200ResponseUio, EphemeralInstancesMetricsResponseUio, FileCreationRequestUio, FileCreationResponseUio, FlowEditorUio, FlowEditorUpdateRequestUio, MessageAudioDownloadUrlUio, OrgUsageMetricsResponseUio, S3UploadBodyUio, STTResponseUio } from '../models/index';
 export interface AddModuleRequest {
     agentId: string;
     addModuleRequestUio: AddModuleRequestUio;
@@ -52,6 +52,10 @@ export interface ExportAgentRequest {
     agentId: string;
     format?: ExportAgentFormatEnum;
 }
+export interface GenerateAgentPromptInitRequest {
+    agentId: string;
+    agentPromptInitGenerationRequestUio: AgentPromptInitGenerationRequestUio;
+}
 export interface GetAdvancedFlowEditorRequest {
     agentId: string;
 }
@@ -307,6 +311,16 @@ export declare class AgentApi extends runtime.BaseAPI {
      * Export an agent
      */
     exportAgent(agentId: string, format?: ExportAgentFormatEnum, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<string>;
+    /**
+     * Writes a ready-to-use initialization prompt from a short brief, using the AI model configured on the agent (or, failing that, on its organisation). The result is returned only — it is never persisted on the agent, which is updated through PATCH /agents/{agentId}.
+     * Generate initialization instructions for an agent
+     */
+    generateAgentPromptInitRaw(requestParameters: GenerateAgentPromptInitRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentPromptInitGenerationResponseUio>>;
+    /**
+     * Writes a ready-to-use initialization prompt from a short brief, using the AI model configured on the agent (or, failing that, on its organisation). The result is returned only — it is never persisted on the agent, which is updated through PATCH /agents/{agentId}.
+     * Generate initialization instructions for an agent
+     */
+    generateAgentPromptInit(agentId: string, agentPromptInitGenerationRequestUio: AgentPromptInitGenerationRequestUio, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentPromptInitGenerationResponseUio>;
     /**
      * Get the advanced flow editor state for an agent
      * Get advanced flow editor state

package/dist/apis/AgentApi.js

@@ -388,6 +388,40 @@ class AgentApi extends runtime.BaseAPI {
         const response = await this.exportAgentRaw({ agentId: agentId, format: format }, initOverrides);
         return await response.value();
     }
+    /**
+     * Writes a ready-to-use initialization prompt from a short brief, using the AI model configured on the agent (or, failing that, on its organisation). The result is returned only — it is never persisted on the agent, which is updated through PATCH /agents/{agentId}.
+     * Generate initialization instructions for an agent
+     */
+    async generateAgentPromptInitRaw(requestParameters, initOverrides) {
+        if (requestParameters['agentId'] == null) {
+            throw new runtime.RequiredError('agentId', 'Required parameter "agentId" was null or undefined when calling generateAgentPromptInit().');
+        }
+        if (requestParameters['agentPromptInitGenerationRequestUio'] == null) {
+            throw new runtime.RequiredError('agentPromptInitGenerationRequestUio', 'Required parameter "agentPromptInitGenerationRequestUio" was null or undefined when calling generateAgentPromptInit().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+        const response = await this.request({
+            path: `/agents/{agentId}/prompt-init/generate`.replace(`{${"agentId"}}`, encodeURIComponent(String(requestParameters['agentId']))),
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, index_1.AgentPromptInitGenerationRequestUioToJSON)(requestParameters['agentPromptInitGenerationRequestUio']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AgentPromptInitGenerationResponseUioFromJSON)(jsonValue));
+    }
+    /**
+     * Writes a ready-to-use initialization prompt from a short brief, using the AI model configured on the agent (or, failing that, on its organisation). The result is returned only — it is never persisted on the agent, which is updated through PATCH /agents/{agentId}.
+     * Generate initialization instructions for an agent
+     */
+    async generateAgentPromptInit(agentId, agentPromptInitGenerationRequestUio, initOverrides) {
+        const response = await this.generateAgentPromptInitRaw({ agentId: agentId, agentPromptInitGenerationRequestUio: agentPromptInitGenerationRequestUio }, initOverrides);
+        return await response.value();
+    }
     /**
      * Get the advanced flow editor state for an agent
      * Get advanced flow editor state

package/dist/models/AgentPromptInitGenerationRequestNotesUio.d.ts

@@ -0,0 +1,45 @@
+/**
+ * brain-client
+ * Api ands models for brain-app and brain-app
+ *
+ * The version of the OpenAPI document: 0.0.0-SNAPSHOT
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * What the user wrote themselves when no preset fitted, per question. A note REPLACES the presets of its own question rather than adding to them.
+ *
+ * @export
+ * @interface AgentPromptInitGenerationRequestNotesUio
+ */
+export interface AgentPromptInitGenerationRequestNotesUio {
+    /**
+     *
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestNotesUio
+     */
+    audience?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestNotesUio
+     */
+    answerStyle?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestNotesUio
+     */
+    sourcePolicy?: string;
+}
+/**
+ * Check if a given object implements the AgentPromptInitGenerationRequestNotesUio interface.
+ */
+export declare function instanceOfAgentPromptInitGenerationRequestNotesUio(value: object): value is AgentPromptInitGenerationRequestNotesUio;
+export declare function AgentPromptInitGenerationRequestNotesUioFromJSON(json: any): AgentPromptInitGenerationRequestNotesUio;
+export declare function AgentPromptInitGenerationRequestNotesUioFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentPromptInitGenerationRequestNotesUio;
+export declare function AgentPromptInitGenerationRequestNotesUioToJSON(json: any): AgentPromptInitGenerationRequestNotesUio;
+export declare function AgentPromptInitGenerationRequestNotesUioToJSONTyped(value?: AgentPromptInitGenerationRequestNotesUio | null, ignoreDiscriminator?: boolean): any;

package/dist/models/AgentPromptInitGenerationRequestNotesUio.js

@@ -0,0 +1,52 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * brain-client
+ * Api ands models for brain-app and brain-app
+ *
+ * The version of the OpenAPI document: 0.0.0-SNAPSHOT
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfAgentPromptInitGenerationRequestNotesUio = instanceOfAgentPromptInitGenerationRequestNotesUio;
+exports.AgentPromptInitGenerationRequestNotesUioFromJSON = AgentPromptInitGenerationRequestNotesUioFromJSON;
+exports.AgentPromptInitGenerationRequestNotesUioFromJSONTyped = AgentPromptInitGenerationRequestNotesUioFromJSONTyped;
+exports.AgentPromptInitGenerationRequestNotesUioToJSON = AgentPromptInitGenerationRequestNotesUioToJSON;
+exports.AgentPromptInitGenerationRequestNotesUioToJSONTyped = AgentPromptInitGenerationRequestNotesUioToJSONTyped;
+/**
+ * Check if a given object implements the AgentPromptInitGenerationRequestNotesUio interface.
+ */
+function instanceOfAgentPromptInitGenerationRequestNotesUio(value) {
+    return true;
+}
+function AgentPromptInitGenerationRequestNotesUioFromJSON(json) {
+    return AgentPromptInitGenerationRequestNotesUioFromJSONTyped(json, false);
+}
+function AgentPromptInitGenerationRequestNotesUioFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'audience': json['audience'] == null ? undefined : json['audience'],
+        'answerStyle': json['answerStyle'] == null ? undefined : json['answerStyle'],
+        'sourcePolicy': json['sourcePolicy'] == null ? undefined : json['sourcePolicy'],
+    };
+}
+function AgentPromptInitGenerationRequestNotesUioToJSON(json) {
+    return AgentPromptInitGenerationRequestNotesUioToJSONTyped(json, false);
+}
+function AgentPromptInitGenerationRequestNotesUioToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'audience': value['audience'],
+        'answerStyle': value['answerStyle'],
+        'sourcePolicy': value['sourcePolicy'],
+    };
+}

package/dist/models/AgentPromptInitGenerationRequestUio.d.ts

@@ -0,0 +1,110 @@
+/**
+ * brain-client
+ * Api ands models for brain-app and brain-app
+ *
+ * The version of the OpenAPI document: 0.0.0-SNAPSHOT
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { AgentPromptInitGenerationRequestNotesUio } from './AgentPromptInitGenerationRequestNotesUio';
+/**
+ *
+ * @export
+ * @interface AgentPromptInitGenerationRequestUio
+ */
+export interface AgentPromptInitGenerationRequestUio {
+    /**
+     * What the agent is for, in the user's own words.
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    mission: string;
+    /**
+     * Who the agent talks to. Several may apply at once; duplicates are rejected. Omit it when `notes.audience` is given — a free-text note replaces the presets. Defaults to `employees` when neither is given. Not declared as `uniqueItems` because the TypeScript generator would turn the field into a `Set`, which does not survive a server-action boundary — the server-side schema enforces uniqueness.
+     *
+     * @type {Array<string>}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    audiences?: Array<AgentPromptInitGenerationRequestUioAudiencesEnum>;
+    /**
+     * Omit it when `notes.answerStyle` is given. Defaults to `concise`.
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    answerStyle?: AgentPromptInitGenerationRequestUioAnswerStyleEnum;
+    /**
+     * Omit it when `notes.sourcePolicy` is given. Defaults to `provided_only`.
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    sourcePolicy?: AgentPromptInitGenerationRequestUioSourcePolicyEnum;
+    /**
+     *
+     * @type {AgentPromptInitGenerationRequestNotesUio}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    notes?: AgentPromptInitGenerationRequestNotesUio;
+    /**
+     * What the agent must never do.
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    constraints?: string;
+    /**
+     * Language the instructions are written in. Defaults to the agent's.
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    lang?: string;
+    /**
+     * Engine to write with, instead of the agent's. Must belong to the agent's organisation. Only honoured together with `model`.
+     *
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    providerId?: string;
+    /**
+     * Model id within `providerId`.
+     * @type {string}
+     * @memberof AgentPromptInitGenerationRequestUio
+     */
+    model?: string;
+}
+/**
+ * @export
+ */
+export declare const AgentPromptInitGenerationRequestUioAudiencesEnum: {
+    readonly GeneralPublic: "general_public";
+    readonly Customers: "customers";
+    readonly Employees: "employees";
+    readonly Experts: "experts";
+};
+export type AgentPromptInitGenerationRequestUioAudiencesEnum = typeof AgentPromptInitGenerationRequestUioAudiencesEnum[keyof typeof AgentPromptInitGenerationRequestUioAudiencesEnum];
+/**
+ * @export
+ */
+export declare const AgentPromptInitGenerationRequestUioAnswerStyleEnum: {
+    readonly Concise: "concise";
+    readonly Detailed: "detailed";
+    readonly StepByStep: "step_by_step";
+};
+export type AgentPromptInitGenerationRequestUioAnswerStyleEnum = typeof AgentPromptInitGenerationRequestUioAnswerStyleEnum[keyof typeof AgentPromptInitGenerationRequestUioAnswerStyleEnum];
+/**
+ * @export
+ */
+export declare const AgentPromptInitGenerationRequestUioSourcePolicyEnum: {
+    readonly ProvidedOnly: "provided_only";
+    readonly ProvidedAndGeneral: "provided_and_general";
+};
+export type AgentPromptInitGenerationRequestUioSourcePolicyEnum = typeof AgentPromptInitGenerationRequestUioSourcePolicyEnum[keyof typeof AgentPromptInitGenerationRequestUioSourcePolicyEnum];
+/**
+ * Check if a given object implements the AgentPromptInitGenerationRequestUio interface.
+ */
+export declare function instanceOfAgentPromptInitGenerationRequestUio(value: object): value is AgentPromptInitGenerationRequestUio;
+export declare function AgentPromptInitGenerationRequestUioFromJSON(json: any): AgentPromptInitGenerationRequestUio;
+export declare function AgentPromptInitGenerationRequestUioFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentPromptInitGenerationRequestUio;
+export declare function AgentPromptInitGenerationRequestUioToJSON(json: any): AgentPromptInitGenerationRequestUio;
+export declare function AgentPromptInitGenerationRequestUioToJSONTyped(value?: AgentPromptInitGenerationRequestUio | null, ignoreDiscriminator?: boolean): any;

package/dist/models/AgentPromptInitGenerationRequestUio.js

@@ -0,0 +1,92 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * brain-client
+ * Api ands models for brain-app and brain-app
+ *
+ * The version of the OpenAPI document: 0.0.0-SNAPSHOT
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentPromptInitGenerationRequestUioSourcePolicyEnum = exports.AgentPromptInitGenerationRequestUioAnswerStyleEnum = exports.AgentPromptInitGenerationRequestUioAudiencesEnum = void 0;
+exports.instanceOfAgentPromptInitGenerationRequestUio = instanceOfAgentPromptInitGenerationRequestUio;
+exports.AgentPromptInitGenerationRequestUioFromJSON = AgentPromptInitGenerationRequestUioFromJSON;
+exports.AgentPromptInitGenerationRequestUioFromJSONTyped = AgentPromptInitGenerationRequestUioFromJSONTyped;
+exports.AgentPromptInitGenerationRequestUioToJSON = AgentPromptInitGenerationRequestUioToJSON;
+exports.AgentPromptInitGenerationRequestUioToJSONTyped = AgentPromptInitGenerationRequestUioToJSONTyped;
+const AgentPromptInitGenerationRequestNotesUio_1 = require("./AgentPromptInitGenerationRequestNotesUio");
+/**
+ * @export
+ */
+exports.AgentPromptInitGenerationRequestUioAudiencesEnum = {
+    GeneralPublic: 'general_public',
+    Customers: 'customers',
+    Employees: 'employees',
+    Experts: 'experts'
+};
+/**
+ * @export
+ */
+exports.AgentPromptInitGenerationRequestUioAnswerStyleEnum = {
+    Concise: 'concise',
+    Detailed: 'detailed',
+    StepByStep: 'step_by_step'
+};
+/**
+ * @export
+ */
+exports.AgentPromptInitGenerationRequestUioSourcePolicyEnum = {
+    ProvidedOnly: 'provided_only',
+    ProvidedAndGeneral: 'provided_and_general'
+};
+/**
+ * Check if a given object implements the AgentPromptInitGenerationRequestUio interface.
+ */
+function instanceOfAgentPromptInitGenerationRequestUio(value) {
+    if (!('mission' in value) || value['mission'] === undefined)
+        return false;
+    return true;
+}
+function AgentPromptInitGenerationRequestUioFromJSON(json) {
+    return AgentPromptInitGenerationRequestUioFromJSONTyped(json, false);
+}
+function AgentPromptInitGenerationRequestUioFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'mission': json['mission'],
+        'audiences': json['audiences'] == null ? undefined : json['audiences'],
+        'answerStyle': json['answerStyle'] == null ? undefined : json['answerStyle'],
+        'sourcePolicy': json['sourcePolicy'] == null ? undefined : json['sourcePolicy'],
+        'notes': json['notes'] == null ? undefined : (0, AgentPromptInitGenerationRequestNotesUio_1.AgentPromptInitGenerationRequestNotesUioFromJSON)(json['notes']),
+        'constraints': json['constraints'] == null ? undefined : json['constraints'],
+        'lang': json['lang'] == null ? undefined : json['lang'],
+        'providerId': json['providerId'] == null ? undefined : json['providerId'],
+        'model': json['model'] == null ? undefined : json['model'],
+    };
+}
+function AgentPromptInitGenerationRequestUioToJSON(json) {
+    return AgentPromptInitGenerationRequestUioToJSONTyped(json, false);
+}
+function AgentPromptInitGenerationRequestUioToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'mission': value['mission'],
+        'audiences': value['audiences'],
+        'answerStyle': value['answerStyle'],
+        'sourcePolicy': value['sourcePolicy'],
+        'notes': (0, AgentPromptInitGenerationRequestNotesUio_1.AgentPromptInitGenerationRequestNotesUioToJSON)(value['notes']),
+        'constraints': value['constraints'],
+        'lang': value['lang'],
+        'providerId': value['providerId'],
+        'model': value['model'],
+    };
+}

package/dist/models/AgentPromptInitGenerationResponseUio.d.ts

@@ -0,0 +1,38 @@
+/**
+ * brain-client
+ * Api ands models for brain-app and brain-app
+ *
+ * The version of the OpenAPI document: 0.0.0-SNAPSHOT
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface AgentPromptInitGenerationResponseUio
+ */
+export interface AgentPromptInitGenerationResponseUio {
+    /**
+     *
+     * @type {string}
+     * @memberof AgentPromptInitGenerationResponseUio
+     */
+    promptInit: string;
+    /**
+     * Adjustments applied to the model's output, for information only.
+     * @type {Array<string>}
+     * @memberof AgentPromptInitGenerationResponseUio
+     */
+    warnings?: Array<string>;
+}
+/**
+ * Check if a given object implements the AgentPromptInitGenerationResponseUio interface.
+ */
+export declare function instanceOfAgentPromptInitGenerationResponseUio(value: object): value is AgentPromptInitGenerationResponseUio;
+export declare function AgentPromptInitGenerationResponseUioFromJSON(json: any): AgentPromptInitGenerationResponseUio;
+export declare function AgentPromptInitGenerationResponseUioFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentPromptInitGenerationResponseUio;
+export declare function AgentPromptInitGenerationResponseUioToJSON(json: any): AgentPromptInitGenerationResponseUio;
+export declare function AgentPromptInitGenerationResponseUioToJSONTyped(value?: AgentPromptInitGenerationResponseUio | null, ignoreDiscriminator?: boolean): any;

package/dist/models/AgentPromptInitGenerationResponseUio.js

@@ -0,0 +1,52 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * brain-client
+ * Api ands models for brain-app and brain-app
+ *
+ * The version of the OpenAPI document: 0.0.0-SNAPSHOT
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfAgentPromptInitGenerationResponseUio = instanceOfAgentPromptInitGenerationResponseUio;
+exports.AgentPromptInitGenerationResponseUioFromJSON = AgentPromptInitGenerationResponseUioFromJSON;
+exports.AgentPromptInitGenerationResponseUioFromJSONTyped = AgentPromptInitGenerationResponseUioFromJSONTyped;
+exports.AgentPromptInitGenerationResponseUioToJSON = AgentPromptInitGenerationResponseUioToJSON;
+exports.AgentPromptInitGenerationResponseUioToJSONTyped = AgentPromptInitGenerationResponseUioToJSONTyped;
+/**
+ * Check if a given object implements the AgentPromptInitGenerationResponseUio interface.
+ */
+function instanceOfAgentPromptInitGenerationResponseUio(value) {
+    if (!('promptInit' in value) || value['promptInit'] === undefined)
+        return false;
+    return true;
+}
+function AgentPromptInitGenerationResponseUioFromJSON(json) {
+    return AgentPromptInitGenerationResponseUioFromJSONTyped(json, false);
+}
+function AgentPromptInitGenerationResponseUioFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'promptInit': json['promptInit'],
+        'warnings': json['warnings'] == null ? undefined : json['warnings'],
+    };
+}
+function AgentPromptInitGenerationResponseUioToJSON(json) {
+    return AgentPromptInitGenerationResponseUioToJSONTyped(json, false);
+}
+function AgentPromptInitGenerationResponseUioToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'promptInit': value['promptInit'],
+        'warnings': value['warnings'],
+    };
+}

package/dist/models/index.d.ts

@@ -54,6 +54,9 @@ export * from './AgentModuleTypeUio';
 export * from './AgentModuleUio';
 export * from './AgentPatchEngineUio';
 export * from './AgentPatchUio';
+export * from './AgentPromptInitGenerationRequestNotesUio';
+export * from './AgentPromptInitGenerationRequestUio';
+export * from './AgentPromptInitGenerationResponseUio';
 export * from './AgentRateLimitSettingsUio';
 export * from './AgentRateLimitSettingsUpdateRequestUio';
 export * from './AgentRefUio';

package/dist/models/index.js

@@ -72,6 +72,9 @@ __exportStar(require("./AgentModuleTypeUio"), exports);
 __exportStar(require("./AgentModuleUio"), exports);
 __exportStar(require("./AgentPatchEngineUio"), exports);
 __exportStar(require("./AgentPatchUio"), exports);
+__exportStar(require("./AgentPromptInitGenerationRequestNotesUio"), exports);
+__exportStar(require("./AgentPromptInitGenerationRequestUio"), exports);
+__exportStar(require("./AgentPromptInitGenerationResponseUio"), exports);
 __exportStar(require("./AgentRateLimitSettingsUio"), exports);
 __exportStar(require("./AgentRateLimitSettingsUpdateRequestUio"), exports);
 __exportStar(require("./AgentRefUio"), exports);

package/dist/openapi.json

@@ -1781,6 +1781,64 @@
         "tags" : [ "agent" ]
       }
     },
+    "/agents/{agentId}/prompt-init/generate" : {
+      "post" : {
+        "description" : "Writes a ready-to-use initialization prompt from a short brief, using the AI model configured on the agent (or, failing that, on its organisation). The result is returned only — it is never persisted on the agent, which is updated through PATCH /agents/{agentId}.\n",
+        "operationId" : "generateAgentPromptInit",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AgentPromptInitGenerationRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/AgentPromptInitGenerationResponse"
+                }
+              }
+            },
+            "description" : "Instructions generated successfully"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User doesn't have access to this agent"
+          },
+          "404" : {
+            "description" : "Agent not found"
+          },
+          "409" : {
+            "description" : "No AI model is configured for this agent or its organisation"
+          },
+          "502" : {
+            "description" : "The model failed to produce usable instructions"
+          }
+        },
+        "summary" : "Generate initialization instructions for an agent",
+        "tags" : [ "agent" ]
+      }
+    },
     "/agents/{agentId}/tools/{toolId}" : {
       "delete" : {
         "description" : "Unlinks an organization tool from the specified agent",
@@ -18664,6 +18722,80 @@
         "required" : [ "transcription" ],
         "type" : "object"
       },
+      "AgentPromptInitGenerationRequest" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "mission" : {
+            "description" : "What the agent is for, in the user's own words.",
+            "maxLength" : 600,
+            "minLength" : 10,
+            "type" : "string"
+          },
+          "audiences" : {
+            "description" : "Who the agent talks to. Several may apply at once; duplicates are rejected. Omit it when `notes.audience` is given — a free-text note replaces the presets. Defaults to `employees` when neither is given. Not declared as `uniqueItems` because the TypeScript generator would turn the field into a `Set`, which does not survive a server-action boundary — the server-side schema enforces uniqueness.\n",
+            "items" : {
+              "enum" : [ "general_public", "customers", "employees", "experts" ],
+              "type" : "string"
+            },
+            "maxItems" : 4,
+            "minItems" : 1,
+            "type" : "array"
+          },
+          "answerStyle" : {
+            "default" : "concise",
+            "description" : "Omit it when `notes.answerStyle` is given. Defaults to `concise`.",
+            "enum" : [ "concise", "detailed", "step_by_step" ],
+            "type" : "string"
+          },
+          "sourcePolicy" : {
+            "default" : "provided_only",
+            "description" : "Omit it when `notes.sourcePolicy` is given. Defaults to `provided_only`.",
+            "enum" : [ "provided_only", "provided_and_general" ],
+            "type" : "string"
+          },
+          "notes" : {
+            "$ref" : "#/components/schemas/AgentPromptInitGenerationRequest_notes"
+          },
+          "constraints" : {
+            "description" : "What the agent must never do.",
+            "maxLength" : 600,
+            "type" : "string"
+          },
+          "lang" : {
+            "description" : "Language the instructions are written in. Defaults to the agent's.",
+            "pattern" : "^[a-z]{2}$",
+            "type" : "string"
+          },
+          "providerId" : {
+            "description" : "Engine to write with, instead of the agent's. Must belong to the agent's organisation. Only honoured together with `model`.\n",
+            "type" : "string"
+          },
+          "model" : {
+            "description" : "Model id within `providerId`.",
+            "type" : "string"
+          }
+        },
+        "required" : [ "mission" ],
+        "type" : "object"
+      },
+      "AgentPromptInitGenerationResponse" : {
+        "properties" : {
+          "promptInit" : {
+            "maxLength" : 50000,
+            "minLength" : 50,
+            "type" : "string"
+          },
+          "warnings" : {
+            "description" : "Adjustments applied to the model's output, for information only.",
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "promptInit" ],
+        "type" : "object"
+      },
       "AgentToolAllowedMethodsRequest" : {
         "properties" : {
           "allowedMethods" : {
@@ -26915,6 +27047,25 @@
         "required" : [ "x", "y" ],
         "type" : "object"
       },
+      "AgentPromptInitGenerationRequest_notes" : {
+        "additionalProperties" : false,
+        "description" : "What the user wrote themselves when no preset fitted, per question. A note REPLACES the presets of its own question rather than adding to them.\n",
+        "properties" : {
+          "audience" : {
+            "maxLength" : 300,
+            "type" : "string"
+          },
+          "answerStyle" : {
+            "maxLength" : 300,
+            "type" : "string"
+          },
+          "sourcePolicy" : {
+            "maxLength" : 300,
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
       "ChatMessage_audio_inner" : {
         "properties" : {
           "sequence" : {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breign/client",
-  "version": "1.0.163",
+  "version": "1.0.164",
   "main": "dist/index.js",
   "exports": {
     ".": "./dist/index.js",