@ptkl/sdk 1.17.0 → 1.18.0

package/dist/index.0.10.js

@@ -1628,18 +1628,51 @@ var ProtokolSDK010 = (function (exports, axios) {
             return await this.client.get(`/luma/appservice/v1/forge/${ref}/services`);
         }
         // --- Variables ---
+        /**
+         * Build the variables path for a target app.
+         *
+         * Omitting `ref` selects the pathless self route, where the server resolves the
+         * app from the caller's own token. That is why the self forms work in every
+         * context an app token does, including Node, where `resolveCurrentAppUuid()`
+         * has nothing to read.
+         */
+        variablesPath(ref) {
+            return ref
+                ? `/luma/appservice/v1/forge/${encodeURIComponent(ref)}/variables`
+                : `/luma/appservice/v1/forge/variables`;
+        }
+        /**
+         * Read variables for the current environment (`X-Project-Env`, defaults to dev).
+         *
+         * With no argument this returns the CALLING APP's own variables and needs no
+         * permission at all. With a `ref` it reads that app's variables and needs
+         * `manage forge`.
+         *
+         * @param ref App uuid, name or tag. Omit for the current app.
+         *
+         * @example
+         * const mine = await platform.forge().getVariables()
+         * const other = await platform.forge().getVariables('storefront')
+         */
         async getVariables(ref) {
-            return await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
+            return await this.client.get(this.variablesPath(ref));
         }
-        async updateVariables(ref, variables) {
-            return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, variables);
+        async updateVariables(a, b) {
+            const [ref, variables] = typeof a === 'string'
+                ? [a, b]
+                : [undefined, a];
+            return await this.client.patch(this.variablesPath(ref), variables);
         }
-        async addVariable(ref, key, value) {
+        async addVariable(a, b, c) {
             var _a;
-            const resp = await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
-            const current = (_a = resp.data) !== null && _a !== void 0 ? _a : {};
-            current[key] = value;
-            return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, current);
+            // Arity, not `c !== undefined` — otherwise addVariable('ref', 'KEY', undefined)
+            // is read as the two-argument self form and writes a variable named "ref".
+            const [ref, key, value] = arguments.length >= 3
+                ? [a, b, c]
+                : [undefined, a, b];
+            const path = this.variablesPath(ref);
+            const resp = await this.client.get(path);
+            return await this.client.patch(path, { ...((_a = resp.data) !== null && _a !== void 0 ? _a : {}), [key]: value });
         }
         // --- Service execution (forge-runtime) ---
         /**
@@ -1795,17 +1828,40 @@ var ProtokolSDK010 = (function (exports, axios) {
         async injectMessage(conversationUUID, data) {
             return await this.client.post(`${BASE$1}/conversations/${conversationUUID}/messages/inject`, data);
         }
+        // ── Stateless chat ──
+        // Stateless completion — no conversation is created and nothing is
+        // persisted. The caller owns the message list.
+        //
+        // Returns the raw SSE body as a string: events separated by blank lines,
+        // each `event: <name>` + `data: <json>`. Tool calls arrive in
+        // message_complete for client-side execution; post the results back as
+        // messages with role 'tool' and the matching tool_call_id.
+        //
+        // NOT typed as a stream, deliberately. This SDK is executed inside
+        // isolated-vm sandboxes (the eval server runs the bundle in-isolate and
+        // proxies HTTP through an adapter), and every value crossing that boundary
+        // is structure-cloned. A Node Readable carries internal callbacks and dies
+        // there with "could not be cloned" — an error that points nowhere near the
+        // method that caused it. Buffering keeps this binding usable everywhere.
+        //
+        // A consumer that genuinely needs incremental delivery should drive the
+        // endpoint directly rather than through the SDK, as the kortex CLI does.
+        //
+        // Constraints enforced server-side: agent_uuid is required, the last
+        // message must have role 'user', 'context' or 'tool', and no message
+        // content may exceed 32000 bytes.
+        async chat(data) {
+            return await this.client.post(`${BASE$1}/chat`, data, {
+                responseType: 'text',
+                // Keep the SSE body intact — the default transform attempts JSON.parse.
+                transformResponse: [(body) => body],
+                timeout: 120000,
+            });
+        }
         // ── OCR ──
         async ocr(data) {
             return await this.client.post(`${BASE$1}/ocr`, data, { timeout: 120000 });
         }
-        // ── Workflow ──
-        async workflowComplete(data) {
-            return await this.client.post(`${BASE$1}/workflow/complete`, data);
-        }
-        async workflowOcr(data) {
-            return await this.client.post(`${BASE$1}/workflow/ocr`, data, { timeout: 120000 });
-        }
         // ── User Access ──
         async createUserAccess(data) {
             return await this.client.post(`${BASE$1}/user-access`, data);

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ptkl/sdk",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",

package/dist/v0.10/api/forge.d.ts

@@ -1,12 +1,61 @@
 import PlatformBaseClient from "./platformBaseClient";
+import type { ForgeVariables } from "../types/forge";
 export default class Forge extends PlatformBaseClient {
     bundleUpload(buffer: Buffer): Promise<any>;
     getWorkspaceApps(): Promise<any>;
     removeVersion(ref: string, version: string): Promise<any>;
     list(): Promise<any>;
     listServices(ref: string): Promise<any>;
-    getVariables(ref: string): Promise<any>;
-    updateVariables(ref: string, variables: Record<string, any>): Promise<any>;
+    /**
+     * Build the variables path for a target app.
+     *
+     * Omitting `ref` selects the pathless self route, where the server resolves the
+     * app from the caller's own token. That is why the self forms work in every
+     * context an app token does, including Node, where `resolveCurrentAppUuid()`
+     * has nothing to read.
+     */
+    private variablesPath;
+    /**
+     * Read variables for the current environment (`X-Project-Env`, defaults to dev).
+     *
+     * With no argument this returns the CALLING APP's own variables and needs no
+     * permission at all. With a `ref` it reads that app's variables and needs
+     * `manage forge`.
+     *
+     * @param ref App uuid, name or tag. Omit for the current app.
+     *
+     * @example
+     * const mine = await platform.forge().getVariables()
+     * const other = await platform.forge().getVariables('storefront')
+     */
+    getVariables(ref?: string): Promise<any>;
+    /**
+     * Replace the variable set for the current environment.
+     *
+     * This REPLACES the whole set for that environment — keys absent from
+     * `variables` are removed. The other environment is left untouched.
+     *
+     * The self form needs `manage_variables forge`, which only ever writes the
+     * calling app. Targeting another app by `ref` needs `manage forge`.
+     *
+     * @example
+     * await platform.forge().updateVariables({ WEBHOOK_URL: '...' })
+     * await platform.forge().updateVariables('storefront', { WEBHOOK_URL: '...' })
+     */
+    updateVariables(variables: ForgeVariables): Promise<any>;
+    updateVariables(ref: string, variables: ForgeVariables): Promise<any>;
+    /**
+     * Set a single variable, preserving the rest.
+     *
+     * A read-modify-write over a replace-everything PATCH, so concurrent writers
+     * can lose each other's updates. Prefer `updateVariables` when setting more
+     * than one key.
+     *
+     * @example
+     * await platform.forge().addVariable('WEBHOOK_URL', '...')
+     * await platform.forge().addVariable('storefront', 'WEBHOOK_URL', '...')
+     */
+    addVariable(key: string, value: any): Promise<any>;
     addVariable(ref: string, key: string, value: any): Promise<any>;
     /**
      * Run a Forge service: `runService(target, body?, { query?, headers? })`.

package/dist/v0.10/api/index.d.ts

@@ -1,7 +1,7 @@
 export type { PlatformFunctions, PlatformFunction, FunctionInput, FunctionOutput, FunctionCallParams, ComponentModels, ComponentFunctions, ComponentModel, ComponentFunctionInput, ComponentFunctionOutput, } from '../types/functions';
 export type { Settings, SettingsField, FieldRoles, FieldConstraints, Context, Preset, PresetContext, Filters, Extension, Policy, SetupData, Model, } from '../types/component';
 export type { WorkflowModel, WorkflowSettings, WorkflowNode, WorkflowNodeConnection, WorkflowCreatePayload, WorkflowUpdatePayload, WorkflowListResponse, } from '../types/workflow';
-export type { PagedResponse as KortexPagedResponse, PaginationParams as KortexPaginationParams, RAGConfig, LLMSettings, Agent, AgentCreatePayload, AgentUpdatePayload, ChunkingStrategy, KnowledgeBase, KnowledgeBaseCreatePayload, KnowledgeBaseUpdatePayload, Document as KortexDocument, Participant, TokenUsage, ToolCall, RAGSource, Message as KortexMessage, Conversation, ConversationCreatePayload, ConversationUpdatePayload, ParticipantAddPayload, ToolResultPayload, PageContext, SendMessagePayload, InjectMessagePayload, OCRPayload, OCRResult, UserAccess, UserAccessCreatePayload, UserAccessUpdatePayload, TopUpPayload, UserMonthlyUsage, UserUsageBreakdown, MyAccess, AggregatedUsage, Tier, KortexWorkflowMessage, KortexWorkflowPayload, KortexWorkflowResult, } from '../types/kortex';
+export type { PagedResponse as KortexPagedResponse, PaginationParams as KortexPaginationParams, RAGConfig, LLMSettings, Agent, AgentCreatePayload, AgentUpdatePayload, ChunkingStrategy, KnowledgeBase, KnowledgeBaseCreatePayload, KnowledgeBaseUpdatePayload, Document as KortexDocument, Participant, TokenUsage, ToolCall, RAGSource, Message as KortexMessage, Conversation, ConversationCreatePayload, ConversationUpdatePayload, ParticipantAddPayload, ToolResultPayload, PageContext, SendMessagePayload, InjectMessagePayload, OCRPayload, OCRResult, UserAccess, UserAccessCreatePayload, UserAccessUpdatePayload, TopUpPayload, UserMonthlyUsage, UserUsageBreakdown, MyAccess, AggregatedUsage, Tier, KortexChatRole, KortexChatMessage, KortexChatPayload, } from '../types/kortex';
 export type { TimberActor, TimberActorType, TimberChanges, TimberEntry, TimberLevel, TimberQueryParams, TimberQueryResponse, TimberSource, TimberUsage, TimberWritePayload, TimberLogPayload, } from '../types/timber';
 export type { SatelliteAuthConfig, SatelliteAuthType, SatelliteCommandExecutePayload, SatelliteCommandExecuteResponse, SatelliteCreatePayload, SatelliteDeployPayload, SatelliteEnv, SatelliteJsonRpcCommand, SatelliteLocaleText, SatelliteLogsParams, SatellitePermission, SatellitePermissionExport, SatelliteSchemaPayload, SatelliteSchemaVersion, SatelliteTemplate, SatelliteTemplatePayload, SatelliteWorkflowNode, SatelliteWorkflowNodeField, } from '../types/satellites';
 export { default as Component } from './component';
@@ -17,6 +17,7 @@ export { default as Sandbox } from './sandbox';
 export { default as System } from './system';
 export { default as Workflow } from './workflow';
 export { default as Forge } from './forge';
+export type { ForgeVariables } from '../types/forge';
 export { default as Kortex } from './kortex';
 export { default as Project } from './project';
 export { default as Config } from './config';

package/dist/v0.10/api/kortex.d.ts

@@ -1,6 +1,6 @@
 import { AxiosResponse } from 'axios';
 import PlatformBaseClient from "./platformBaseClient";
-import { PagedResponse, PaginationParams, Agent, AgentCreatePayload, AgentUpdatePayload, KnowledgeBase, KnowledgeBaseCreatePayload, KnowledgeBaseUpdatePayload, Document, Conversation, ConversationCreatePayload, ConversationUpdatePayload, ParticipantAddPayload, Message, SendMessagePayload, InjectMessagePayload, OCRPayload, OCRResult, UserAccess, UserAccessCreatePayload, UserAccessUpdatePayload, UserMonthlyUsage, UserUsageBreakdown, MyAccess, AggregatedUsage, Tier, KnowledgeBaseSearchPayload, KnowledgeBaseSearchResult, KortexWorkflowPayload, KortexWorkflowResult } from '../types/kortex';
+import { PagedResponse, PaginationParams, Agent, AgentCreatePayload, AgentUpdatePayload, KnowledgeBase, KnowledgeBaseCreatePayload, KnowledgeBaseUpdatePayload, Document, Conversation, ConversationCreatePayload, ConversationUpdatePayload, ParticipantAddPayload, Message, SendMessagePayload, InjectMessagePayload, OCRPayload, OCRResult, UserAccess, UserAccessCreatePayload, UserAccessUpdatePayload, UserMonthlyUsage, UserUsageBreakdown, MyAccess, AggregatedUsage, Tier, KnowledgeBaseSearchPayload, KnowledgeBaseSearchResult, KortexChatPayload } from '../types/kortex';
 export default class Kortex extends PlatformBaseClient {
     createAgent(data: AgentCreatePayload): Promise<AxiosResponse<Agent>>;
     listAgents(params?: PaginationParams): Promise<AxiosResponse<PagedResponse<Agent>>>;
@@ -35,9 +35,8 @@ export default class Kortex extends PlatformBaseClient {
     streamMessage(conversationUUID: string, data: SendMessagePayload): Promise<AxiosResponse<ReadableStream>>;
     listMessages(conversationUUID: string, params?: PaginationParams): Promise<AxiosResponse<PagedResponse<Message>>>;
     injectMessage(conversationUUID: string, data: InjectMessagePayload): Promise<AxiosResponse<Message>>;
+    chat(data: KortexChatPayload): Promise<AxiosResponse<string>>;
     ocr(data: OCRPayload): Promise<AxiosResponse<OCRResult>>;
-    workflowComplete(data: KortexWorkflowPayload): Promise<AxiosResponse<KortexWorkflowResult>>;
-    workflowOcr(data: OCRPayload): Promise<AxiosResponse<OCRResult>>;
     createUserAccess(data: UserAccessCreatePayload): Promise<AxiosResponse<UserAccess>>;
     listUserAccess(params?: PaginationParams): Promise<AxiosResponse<PagedResponse<UserAccess>>>;
     getUserAccess(uuid: string): Promise<AxiosResponse<UserAccess>>;

package/dist/v0.10/index.cjs.js

@@ -20594,18 +20594,51 @@ class Forge extends PlatformBaseClient {
         return await this.client.get(`/luma/appservice/v1/forge/${ref}/services`);
     }
     // --- Variables ---
+    /**
+     * Build the variables path for a target app.
+     *
+     * Omitting `ref` selects the pathless self route, where the server resolves the
+     * app from the caller's own token. That is why the self forms work in every
+     * context an app token does, including Node, where `resolveCurrentAppUuid()`
+     * has nothing to read.
+     */
+    variablesPath(ref) {
+        return ref
+            ? `/luma/appservice/v1/forge/${encodeURIComponent(ref)}/variables`
+            : `/luma/appservice/v1/forge/variables`;
+    }
+    /**
+     * Read variables for the current environment (`X-Project-Env`, defaults to dev).
+     *
+     * With no argument this returns the CALLING APP's own variables and needs no
+     * permission at all. With a `ref` it reads that app's variables and needs
+     * `manage forge`.
+     *
+     * @param ref App uuid, name or tag. Omit for the current app.
+     *
+     * @example
+     * const mine = await platform.forge().getVariables()
+     * const other = await platform.forge().getVariables('storefront')
+     */
     async getVariables(ref) {
-        return await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
+        return await this.client.get(this.variablesPath(ref));
     }
-    async updateVariables(ref, variables) {
-        return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, variables);
+    async updateVariables(a, b) {
+        const [ref, variables] = typeof a === 'string'
+            ? [a, b]
+            : [undefined, a];
+        return await this.client.patch(this.variablesPath(ref), variables);
     }
-    async addVariable(ref, key, value) {
+    async addVariable(a, b, c) {
         var _a;
-        const resp = await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
-        const current = (_a = resp.data) !== null && _a !== void 0 ? _a : {};
-        current[key] = value;
-        return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, current);
+        // Arity, not `c !== undefined` — otherwise addVariable('ref', 'KEY', undefined)
+        // is read as the two-argument self form and writes a variable named "ref".
+        const [ref, key, value] = arguments.length >= 3
+            ? [a, b, c]
+            : [undefined, a, b];
+        const path = this.variablesPath(ref);
+        const resp = await this.client.get(path);
+        return await this.client.patch(path, { ...((_a = resp.data) !== null && _a !== void 0 ? _a : {}), [key]: value });
     }
     // --- Service execution (forge-runtime) ---
     /**
@@ -20761,17 +20794,40 @@ class Kortex extends PlatformBaseClient {
     async injectMessage(conversationUUID, data) {
         return await this.client.post(`${BASE$1}/conversations/${conversationUUID}/messages/inject`, data);
     }
+    // ── Stateless chat ──
+    // Stateless completion — no conversation is created and nothing is
+    // persisted. The caller owns the message list.
+    //
+    // Returns the raw SSE body as a string: events separated by blank lines,
+    // each `event: <name>` + `data: <json>`. Tool calls arrive in
+    // message_complete for client-side execution; post the results back as
+    // messages with role 'tool' and the matching tool_call_id.
+    //
+    // NOT typed as a stream, deliberately. This SDK is executed inside
+    // isolated-vm sandboxes (the eval server runs the bundle in-isolate and
+    // proxies HTTP through an adapter), and every value crossing that boundary
+    // is structure-cloned. A Node Readable carries internal callbacks and dies
+    // there with "could not be cloned" — an error that points nowhere near the
+    // method that caused it. Buffering keeps this binding usable everywhere.
+    //
+    // A consumer that genuinely needs incremental delivery should drive the
+    // endpoint directly rather than through the SDK, as the kortex CLI does.
+    //
+    // Constraints enforced server-side: agent_uuid is required, the last
+    // message must have role 'user', 'context' or 'tool', and no message
+    // content may exceed 32000 bytes.
+    async chat(data) {
+        return await this.client.post(`${BASE$1}/chat`, data, {
+            responseType: 'text',
+            // Keep the SSE body intact — the default transform attempts JSON.parse.
+            transformResponse: [(body) => body],
+            timeout: 120000,
+        });
+    }
     // ── OCR ──
     async ocr(data) {
         return await this.client.post(`${BASE$1}/ocr`, data, { timeout: 120000 });
     }
-    // ── Workflow ──
-    async workflowComplete(data) {
-        return await this.client.post(`${BASE$1}/workflow/complete`, data);
-    }
-    async workflowOcr(data) {
-        return await this.client.post(`${BASE$1}/workflow/ocr`, data, { timeout: 120000 });
-    }
     // ── User Access ──
     async createUserAccess(data) {
         return await this.client.post(`${BASE$1}/user-access`, data);

package/dist/v0.10/index.esm.js

@@ -1627,18 +1627,51 @@ class Forge extends PlatformBaseClient {
         return await this.client.get(`/luma/appservice/v1/forge/${ref}/services`);
     }
     // --- Variables ---
+    /**
+     * Build the variables path for a target app.
+     *
+     * Omitting `ref` selects the pathless self route, where the server resolves the
+     * app from the caller's own token. That is why the self forms work in every
+     * context an app token does, including Node, where `resolveCurrentAppUuid()`
+     * has nothing to read.
+     */
+    variablesPath(ref) {
+        return ref
+            ? `/luma/appservice/v1/forge/${encodeURIComponent(ref)}/variables`
+            : `/luma/appservice/v1/forge/variables`;
+    }
+    /**
+     * Read variables for the current environment (`X-Project-Env`, defaults to dev).
+     *
+     * With no argument this returns the CALLING APP's own variables and needs no
+     * permission at all. With a `ref` it reads that app's variables and needs
+     * `manage forge`.
+     *
+     * @param ref App uuid, name or tag. Omit for the current app.
+     *
+     * @example
+     * const mine = await platform.forge().getVariables()
+     * const other = await platform.forge().getVariables('storefront')
+     */
     async getVariables(ref) {
-        return await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
+        return await this.client.get(this.variablesPath(ref));
     }
-    async updateVariables(ref, variables) {
-        return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, variables);
+    async updateVariables(a, b) {
+        const [ref, variables] = typeof a === 'string'
+            ? [a, b]
+            : [undefined, a];
+        return await this.client.patch(this.variablesPath(ref), variables);
     }
-    async addVariable(ref, key, value) {
+    async addVariable(a, b, c) {
         var _a;
-        const resp = await this.client.get(`/luma/appservice/v1/forge/${ref}/variables`);
-        const current = (_a = resp.data) !== null && _a !== void 0 ? _a : {};
-        current[key] = value;
-        return await this.client.patch(`/luma/appservice/v1/forge/${ref}/variables`, current);
+        // Arity, not `c !== undefined` — otherwise addVariable('ref', 'KEY', undefined)
+        // is read as the two-argument self form and writes a variable named "ref".
+        const [ref, key, value] = arguments.length >= 3
+            ? [a, b, c]
+            : [undefined, a, b];
+        const path = this.variablesPath(ref);
+        const resp = await this.client.get(path);
+        return await this.client.patch(path, { ...((_a = resp.data) !== null && _a !== void 0 ? _a : {}), [key]: value });
     }
     // --- Service execution (forge-runtime) ---
     /**
@@ -1794,17 +1827,40 @@ class Kortex extends PlatformBaseClient {
     async injectMessage(conversationUUID, data) {
         return await this.client.post(`${BASE$1}/conversations/${conversationUUID}/messages/inject`, data);
     }
+    // ── Stateless chat ──
+    // Stateless completion — no conversation is created and nothing is
+    // persisted. The caller owns the message list.
+    //
+    // Returns the raw SSE body as a string: events separated by blank lines,
+    // each `event: <name>` + `data: <json>`. Tool calls arrive in
+    // message_complete for client-side execution; post the results back as
+    // messages with role 'tool' and the matching tool_call_id.
+    //
+    // NOT typed as a stream, deliberately. This SDK is executed inside
+    // isolated-vm sandboxes (the eval server runs the bundle in-isolate and
+    // proxies HTTP through an adapter), and every value crossing that boundary
+    // is structure-cloned. A Node Readable carries internal callbacks and dies
+    // there with "could not be cloned" — an error that points nowhere near the
+    // method that caused it. Buffering keeps this binding usable everywhere.
+    //
+    // A consumer that genuinely needs incremental delivery should drive the
+    // endpoint directly rather than through the SDK, as the kortex CLI does.
+    //
+    // Constraints enforced server-side: agent_uuid is required, the last
+    // message must have role 'user', 'context' or 'tool', and no message
+    // content may exceed 32000 bytes.
+    async chat(data) {
+        return await this.client.post(`${BASE$1}/chat`, data, {
+            responseType: 'text',
+            // Keep the SSE body intact — the default transform attempts JSON.parse.
+            transformResponse: [(body) => body],
+            timeout: 120000,
+        });
+    }
     // ── OCR ──
     async ocr(data) {
         return await this.client.post(`${BASE$1}/ocr`, data, { timeout: 120000 });
     }
-    // ── Workflow ──
-    async workflowComplete(data) {
-        return await this.client.post(`${BASE$1}/workflow/complete`, data);
-    }
-    async workflowOcr(data) {
-        return await this.client.post(`${BASE$1}/workflow/ocr`, data, { timeout: 120000 });
-    }
     // ── User Access ──
     async createUserAccess(data) {
         return await this.client.post(`${BASE$1}/user-access`, data);

package/dist/v0.10/types/component.d.ts

@@ -251,10 +251,20 @@ type FieldConstraints = {
     unique?: boolean;
     placeholder?: string;
     default?: string;
+    /** Bounds the *length* of a string value (input/text, password, ...). */
     length?: {
         min?: number | null;
         max?: number | null;
     };
+    /**
+     * Bounds the *value* of a numeric field (input/number). Inclusive on both
+     * ends. Prefer this over `length` for numbers — `length` is only still read
+     * as a fallback for fields authored before `range` existed.
+     */
+    range?: {
+        min?: number | null;
+        max?: number | null;
+    };
     not_allowed_words?: string;
     regex?: string;
     date?: {

package/dist/v0.10/types/forge.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A Forge app's variables for a single environment: a flat, JSON-serialisable
+ * key/value map.
+ *
+ * Each app holds two independent sets, `dev` and `live`. Which one an API call
+ * reads or writes is selected by the `X-Project-Env` header, not by this type.
+ *
+ * @example
+ * const vars: ForgeVariables = { WEBHOOK_URL: 'https://example.com/hook', MAX_RETRIES: 3 }
+ */
+export type ForgeVariables = Record<string, any>;

package/dist/v0.10/types/kortex.d.ts

@@ -288,22 +288,16 @@ type KnowledgeBaseSearchChunk = {
 type KnowledgeBaseSearchResult = {
     chunks: KnowledgeBaseSearchChunk[];
 };
-type KortexWorkflowMessage = {
-    role: string;
+type KortexChatRole = 'user' | 'assistant' | 'context' | 'tool';
+type KortexChatMessage = {
+    role: KortexChatRole;
     content: string;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
 };
-type KortexWorkflowPayload = {
-    agent_uuid?: string;
-    system_prompt?: string;
-    response_format?: string;
-    messages: KortexWorkflowMessage[];
-    stream?: boolean;
-    temperature?: number;
-    max_tokens?: number;
+type KortexChatPayload = {
+    agent_uuid: string;
+    messages: KortexChatMessage[];
     tools?: Record<string, any>[];
 };
-type KortexWorkflowResult = {
-    content: string;
-    usage: TokenUsage;
-};
-export { PagedResponse, PaginationParams, RAGConfig, LLMSettings, Agent, AgentCreatePayload, AgentUpdatePayload, ChunkingStrategy, KnowledgeBase, KnowledgeBaseCreatePayload, KnowledgeBaseUpdatePayload, Document, Participant, TokenUsage, ToolCall, RAGSource, Message, Conversation, ConversationCreatePayload, ConversationUpdatePayload, ParticipantAddPayload, ToolResultApproval, ToolResultPayload, PageContext, SendMessagePayload, InjectMessagePayload, OCRPayload, OCRResult, UserAccess, UserAccessCreatePayload, UserAccessUpdatePayload, TopUpPayload, UserMonthlyUsage, UserUsageBreakdown, MyAccess, AggregatedUsage, Tier, KnowledgeBaseSearchPayload, KnowledgeBaseSearchChunk, KnowledgeBaseSearchResult, KortexWorkflowMessage, KortexWorkflowPayload, KortexWorkflowResult, };
+export { PagedResponse, PaginationParams, RAGConfig, LLMSettings, Agent, AgentCreatePayload, AgentUpdatePayload, ChunkingStrategy, KnowledgeBase, KnowledgeBaseCreatePayload, KnowledgeBaseUpdatePayload, Document, Participant, TokenUsage, ToolCall, RAGSource, Message, Conversation, ConversationCreatePayload, ConversationUpdatePayload, ParticipantAddPayload, ToolResultApproval, ToolResultPayload, PageContext, SendMessagePayload, InjectMessagePayload, OCRPayload, OCRResult, UserAccess, UserAccessCreatePayload, UserAccessUpdatePayload, TopUpPayload, UserMonthlyUsage, UserUsageBreakdown, MyAccess, AggregatedUsage, Tier, KnowledgeBaseSearchPayload, KnowledgeBaseSearchChunk, KnowledgeBaseSearchResult, KortexChatRole, KortexChatMessage, KortexChatPayload, };

package/dist/v0.9/types/component.d.ts

@@ -221,10 +221,20 @@ type FieldConstraints = {
     unique?: boolean;
     placeholder?: string;
     default?: string;
+    /** Bounds the *length* of a string value (input/text, password, ...). */
     length?: {
         min?: number | null;
         max?: number | null;
     };
+    /**
+     * Bounds the *value* of a numeric field (input/number). Inclusive on both
+     * ends. Prefer this over `length` for numbers — `length` is only still read
+     * as a fallback for fields authored before `range` existed.
+     */
+    range?: {
+        min?: number | null;
+        max?: number | null;
+    };
     not_allowed_words?: string;
     regex?: string;
     date?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ptkl/sdk",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "scripts": {
     "build": "rollup -c",
     "build:monaco": "npm run build && node scripts/generate-monaco-types.cjs",