@deepraxis/sdk 0.1.1-dev.f0ef747 → 0.1.1-dev.f8aa5de

package/dist/helpers/application-build.d.ts

@@ -0,0 +1,10 @@
+import type { PublishInput } from './application-publish.js';
+/** A vite/vinext build read into memory: paths are relative to dist/server and dist/client. */
+export interface BuildOutput {
+    serverFiles: Record<string, Uint8Array>;
+    clientFiles: Record<string, Uint8Array>;
+    /** Parsed dist/server/wrangler.json. */
+    wranglerJson: unknown;
+}
+/** Pure mapping from a vite/vinext build (dist/server + dist/client + wrangler.json) to `praxis.application.publish` input. No fs, no network. */
+export declare function publishInputFromBuild(build: BuildOutput, name: string): PublishInput;

package/dist/helpers/application-build.js

@@ -0,0 +1,98 @@
+import { PraxisError } from "../core/errors.js";
+// wrangler.json keys that declare a binding the platform does not accept (it answers UNSUPPORTED).
+const UNSUPPORTED_BINDING_KEYS = ['services', 'queues', 'durable_objects', 'ai', 'analytics_engine_datasets', 'vectorize', 'hyperdrive',
+    'browser', 'send_email', 'mtls_certificates', 'dispatch_namespaces', 'unsafe', 'version_metadata', 'images', 'workflows', 'pipelines',
+    'secrets_store_secrets', 'ratelimits', 'vpc_services', 'media', 'tail_consumers', 'worker_loaders'];
+// A key declares something only if it holds a value somewhere inside: vite's generated wrangler.json writes
+// empty containers such as `queues: { producers: [], consumers: [] }` and `durable_objects: { bindings: [] }`.
+const isPresent = (value) => {
+    if (value === undefined || value === null)
+        return false;
+    if (Array.isArray(value))
+        return value.some(isPresent);
+    if (typeof value === 'object')
+        return Object.values(value).some(isPresent);
+    return true;
+};
+/** Compile one .assetsignore line (gitignore subset: names, `*`, `**`, leading /, trailing /) to a matcher over a relative path. */
+function ignoreMatcher(line) {
+    let pattern = line.trim();
+    if (!pattern || pattern.startsWith('#') || pattern.startsWith('!'))
+        return null;
+    const anchored = pattern.startsWith('/') || pattern.slice(0, -1).includes('/');
+    pattern = pattern.replace(/^\//, '').replace(/\/$/, '');
+    const source = pattern.split('**').map(part => part.split('*').map(piece => piece.replace(/[.+?^${}()|[\]\\]/g, '\\$&')).join('[^/]*')).join('.*');
+    const regex = new RegExp(`^${source}$`);
+    return path => {
+        const segments = path.split('/');
+        // The path or any of its parent directories matches, as in gitignore.
+        for (let end = 1; end <= segments.length; end++) {
+            if (anchored ? regex.test(segments.slice(0, end).join('/')) : regex.test(segments[end - 1]))
+                return true;
+        }
+        return false;
+    };
+}
+function bindingsFrom(wrangler) {
+    const bindings = [];
+    const fromList = (key, type) => {
+        const list = wrangler[key];
+        if (!isPresent(list))
+            return;
+        if (!Array.isArray(list))
+            throw new PraxisError({ code: 'INVALID_PARAMS', message: `wrangler.json ${key} must be an array` });
+        for (const entry of list) {
+            if (typeof entry?.binding !== 'string')
+                throw new PraxisError({ code: 'INVALID_PARAMS', message: `wrangler.json ${key} entry has no binding name` });
+            bindings.push({ type, name: entry.binding });
+        }
+    };
+    fromList('d1_databases', 'd1');
+    fromList('kv_namespaces', 'kv_namespace');
+    fromList('r2_buckets', 'r2_bucket');
+    for (const [name, value] of Object.entries((wrangler.vars ?? {}))) {
+        bindings.push((typeof value === 'string' ? { type: 'plain_text', name, text: value } : { type: 'json', name, json: value }));
+    }
+    if (typeof wrangler.assets?.binding === 'string')
+        bindings.push({ type: 'assets', name: wrangler.assets.binding });
+    return bindings;
+}
+/** Pure mapping from a vite/vinext build (dist/server + dist/client + wrangler.json) to `praxis.application.publish` input. No fs, no network. */
+export function publishInputFromBuild(build, name) {
+    const wrangler = build.wranglerJson;
+    if (!wrangler || typeof wrangler !== 'object' || Array.isArray(wrangler)) {
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: 'wranglerJson must be the parsed dist/server/wrangler.json object' });
+    }
+    const offending = UNSUPPORTED_BINDING_KEYS.filter(key => isPresent(wrangler[key]));
+    if (offending.length) {
+        throw new PraxisError({ code: 'UNSUPPORTED', message: `wrangler.json declares bindings the platform does not support: ${offending.join(', ')}` });
+    }
+    const modules = Object.entries(build.serverFiles)
+        .filter(([path]) => path.endsWith('.js'))
+        .map(([path, content]) => ({ name: path, content, content_type: 'application/javascript+module' }));
+    if (typeof wrangler.main !== 'string')
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: 'wrangler.json has no main entry' });
+    if (!modules.some(module => module.name === wrangler.main)) {
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: `wrangler.json main ${wrangler.main} is not a .js file under dist/server` });
+    }
+    const ignored = new TextDecoder().decode(build.clientFiles['.assetsignore'] ?? new Uint8Array()).split(/\r?\n/)
+        .map(ignoreMatcher).filter((matcher) => matcher !== null);
+    const files = {};
+    for (const [path, content] of Object.entries(build.clientFiles)) {
+        if (path === '.assetsignore' || ignored.some(matches => matches(path)))
+            continue;
+        files[`/${path}`] = content;
+    }
+    const { binding: _binding, directory: _directory, ...assetsConfig } = (wrangler.assets ?? {});
+    const bindings = bindingsFrom(wrangler);
+    return {
+        name,
+        files,
+        modules,
+        main_module: wrangler.main,
+        ...(typeof wrangler.compatibility_date === 'string' ? { compatibility_date: wrangler.compatibility_date } : {}),
+        ...(Array.isArray(wrangler.compatibility_flags) ? { compatibility_flags: wrangler.compatibility_flags } : {}),
+        ...(bindings.length ? { bindings } : {}),
+        ...(Object.keys(assetsConfig).length ? { assets_config: assetsConfig } : {}),
+    };
+}

package/dist/helpers/application-publish.d.ts

@@ -12,6 +12,14 @@ export interface PublishInput {
         content: string;
         content_type?: string;
     };
+    /** Multi-module Worker (e.g. a vite/vinext build). Names pass through unchanged; relative paths with / are legal. Mutually exclusive with main. */
+    modules?: {
+        name: string;
+        content: string | Uint8Array;
+        content_type?: string;
+    }[];
+    /** Entry module name; defaults to the first module and must name one of modules. */
+    main_module?: string;
     /** 运行时兼容日期，默认当天 UTC（YYYY-MM-DD）。 */
     compatibility_date?: string;
     /** 运行时兼容标志，原样传递；平台固定附加 global_fetch_strictly_public。 */

package/dist/helpers/application-publish.js

@@ -21,11 +21,30 @@ export async function publish(client, input) {
     const timeout = input.timeout_ms ?? 120_000;
     if (!Number.isFinite(timeout) || timeout < 0)
         throw new RangeError('timeout_ms must be non-negative and finite');
-    const contentType = ['application/javascript+module', 'text/javascript', 'application/javascript', 'application/json',
-        'text/plain', 'application/wasm', 'application/octet-stream', 'application/x-python']
-        .find(type => type === (input.main?.content_type ?? 'application/javascript+module'));
-    if (!contentType)
-        throw new PraxisError({ code: 'INVALID_PARAMS', message: `Unsupported module content_type: ${input.main?.content_type}` });
+    const moduleTypes = ['application/javascript+module', 'text/javascript', 'application/javascript', 'application/json',
+        'text/plain', 'application/wasm', 'application/octet-stream', 'application/x-python'];
+    const moduleType = (type) => {
+        const found = moduleTypes.find(candidate => candidate === (type ?? 'application/javascript+module'));
+        if (!found)
+            throw new PraxisError({ code: 'INVALID_PARAMS', message: `Unsupported module content_type: ${type}` });
+        return found;
+    };
+    if (input.main && input.modules)
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: 'Pass either main or modules, not both' });
+    if (input.main_module !== undefined && !input.modules)
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: 'main_module requires modules; with main the entry is main.name' });
+    if (input.modules && input.modules.length === 0)
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: 'modules must not be empty' });
+    const entryModules = input.main
+        ? [{ name: input.main.name, content_type: moduleType(input.main.content_type), content_base64: base64(new TextEncoder().encode(input.main.content)) }]
+        : input.modules?.map(module => ({ name: module.name, content_type: moduleType(module.content_type),
+            content_base64: base64(typeof module.content === 'string' ? new TextEncoder().encode(module.content) : module.content) }));
+    if (new Set(entryModules?.map(module => module.name)).size !== (entryModules?.length ?? 0))
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: 'Duplicate module name' });
+    const mainModule = input.main ? input.main.name : input.modules ? (input.main_module ?? input.modules[0].name) : undefined;
+    if (input.modules && !input.modules.some(module => module.name === mainModule)) {
+        throw new PraxisError({ code: 'INVALID_PARAMS', message: `main_module ${mainModule} is not among modules` });
+    }
     const files = Object.entries(input.files);
     if (files.length > 100_000)
         throw new PraxisError({ code: 'LIMIT_EXCEEDED', message: 'At most 100000 asset paths can be published' });
@@ -80,7 +99,7 @@ export async function publish(client, input) {
     const removed = Object.keys(previous).filter(key => !Object.hasOwn(manifest, key));
     const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(JSON.stringify(manifest))));
     const manifestHash = Array.from(digest, byte => byte.toString(16).padStart(2, '0')).join('');
-    const staticOnly = !['main', 'bindings', 'compatibility_date', 'compatibility_flags', 'assets_config'].some(key => Object.hasOwn(input, key));
+    const staticOnly = !['main', 'modules', 'main_module', 'bindings', 'compatibility_date', 'compatibility_flags', 'assets_config'].some(key => Object.hasOwn(input, key));
     const unchanged = staticOnly && !!currentVersion && manifestHash === currentVersion.praxis.assets_manifest?.manifest_hash;
     const hashes = new Set(Object.values(manifest).map(entry => entry.hash));
     const currentResult = { url: worker.subdomain.url, worker_id: worker.id, version_id: currentVersion?.id ?? null,
@@ -127,9 +146,7 @@ export async function publish(client, input) {
             assets: versionAssets,
             ...(input.compatibility_flags ? { compatibility_flags: input.compatibility_flags } : {}),
             ...(input.bindings ? { bindings: input.bindings } : {}),
-            ...(input.main ? { main_module: input.main.name, modules: [{ name: input.main.name,
-                        content_type: contentType,
-                        content_base64: base64(new TextEncoder().encode(input.main.content)) }] } : {}),
+            ...(entryModules ? { main_module: mainModule, modules: entryModules } : {}),
         } });
     let deployment = result.deployment;
     if (!deployment)

package/dist/helpers/browser-decisions.d.ts

@@ -40,3 +40,5 @@ export interface ContextLike {
 export declare function pickAgentContext<T extends ContextLike>(contexts: readonly T[], agentId: string): T | undefined;
 /** Context names accept ASCII letters, digits and . _ : - only. */
 export declare const agentContextName: (agentId: string) => string;
+/** Start pages are expendable only on Console hosts, never arbitrary sites' /start pages. */
+export declare function isBlankTab(value: string): boolean;

package/dist/helpers/browser-decisions.js

@@ -48,7 +48,7 @@ export function decideTabReuse(targetUrl, tabs) {
         if (best === undefined || rank < best.rank || rank === best.rank && (tab.active || !best.tab.active))
             best = { tab, rank };
     }
-    return best?.tab;
+    return best?.tab ?? tabs.find(tab => isBlankTab(tab.url));
 }
 /** The `/browser/v1/connect` WebSocket URL. The token travels in a header, never in this URL. */
 export function buildConnectUrl(parts) {
@@ -69,3 +69,16 @@ export function pickAgentContext(contexts, agentId) {
 }
 /** Context names accept ASCII letters, digits and . _ : - only. */
 export const agentContextName = (agentId) => `agent-${agentId}`.replace(/[^A-Za-z0-9._:-]/g, '-').slice(0, 128);
+/** Start pages are expendable only on Console hosts, never arbitrary sites' /start pages. */
+export function isBlankTab(value) {
+    if (value === "" || value === "about:blank")
+        return true;
+    try {
+        const url = new URL(value);
+        return (url.protocol === "https:" || url.protocol === "http:") && url.pathname === "/start" &&
+            (url.hostname.startsWith("console-") || url.hostname === "console.deepraxis.com");
+    }
+    catch {
+        return false;
+    }
+}

package/dist/helpers/file-upload.d.ts

@@ -1,8 +1,8 @@
 import type { Praxis } from '../core/client.js';
 import type { OwnFileOpenAiFile } from '../generated/types.gen.js';
 export interface UploadFileOptions {
-    /** user_data for conversation attachments; assistants for assistant files; vision for PNG/JPEG/GIF/WebP. */
-    purpose: 'user_data' | 'assistants' | 'vision';
+    /** user_data for conversation attachments and documents; vision for PNG/JPEG/GIF/WebP. */
+    purpose: 'user_data' | 'vision';
     /** Defaults to File.name, or upload for a Blob. */
     filename?: string;
     /** Fixed part size in bytes, 5 MiB–64 MB; defaults to 50 MiB. */

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export { parseSSE } from './core/sse.js';
 export type { SSEEvent, SSEOptions } from './core/sse.js';
 export { publish } from './helpers/application-publish.js';
 export type { PublishInput, PublishResult, AssetsConfig } from './helpers/application-publish.js';
+export { publishInputFromBuild } from './helpers/application-build.js';
+export type { BuildOutput } from './helpers/application-build.js';
 export { count } from './helpers/database-count.js';
 export type { CountInput, CountResult } from './helpers/database-count.js';
 export { uploadFile } from './helpers/file-upload.js';

package/dist/index.js

@@ -3,6 +3,7 @@ export { PraxisError, PraxisConnectionError, PraxisTimeoutError } from "./core/e
 export { Page } from "./core/pagination.js";
 export { parseSSE } from "./core/sse.js";
 export { publish } from "./helpers/application-publish.js";
+export { publishInputFromBuild } from "./helpers/application-build.js";
 export { count } from "./helpers/database-count.js";
 export { uploadFile } from "./helpers/file-upload.js";
 export { connectBrowser } from "./helpers/browser-connect.js";

package/dist/operations.generated.d.ts

@@ -1536,7 +1536,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.sessions";
     readonly method: "create";
     readonly summary: "Create session";
-    readonly description: "Create a session: one conversation with an agent. Pass agent as an agent id or {type:\"agent\", id, version?}; an id alone, or an object without version, pins the agent's active_version (the version chosen with agents.versions.apply, not necessarily the newest saved one). Unlike Anthropic Managed Agents, omit environment_id to use the default environment saved in the agent version (light for a new agent), unless computer_id (explicit, or the agent's default) selects a Computer; pass an environment id for a sandbox recipe. For service agents, explicit null allocates no machine, so codemode, bash and other machine tools are unavailable. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Unlike Anthropic Managed Agents, the only inline agent override is system ({type:\"agent_with_overrides\", id, system}); to change the model, tools, MCP servers or skills, save a version instead. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. budget is {type:\"limit\", max_list_cost:{amount, currency:\"USD\"}} where amount is a positive integer string of US cents (\"2000\" is USD 20.00); omitted budget defaults to \"2000\" and null removes the limit. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.";
+    readonly description: "Create a session: one conversation with an agent. Pass agent as an agent id or {type:\"agent\", id, version?}; an id alone, or an object without version, pins the agent's active_version (the version chosen with agents.versions.apply, not necessarily the newest saved one). Unlike Anthropic Managed Agents, omit environment_id to use the default environment saved in the agent version (light for a new agent), unless computer_id (explicit, or the agent's default) selects a Computer; pass an environment id for a sandbox recipe. For service agents, explicit null allocates no machine, so codemode, bash and other machine tools are unavailable. Optional model must be one of the agent's allowed models; optional thinking is {effort: low|medium|high|xhigh|max|none} or null, where null inherits the agent default and then the model default (none requires the model to allow disabling thinking). Selections are saved before initial_events run; invalid ones return 400 invalid_request_error. Unlike Anthropic Managed Agents, the only inline agent override is system ({type:\"agent_with_overrides\", id, system}); to change the model, tools, MCP servers or skills, save a version instead. Supports vault_ids, up to 50, owned by the current organization and not archived; credential injection is deferred to a later version. budget is {type:\"limit\", max_list_cost:{amount, currency:\"USD\"}} where amount is a positive decimal string of US dollars with at most 2 decimal places (\"20.00\" is USD 20.00); omitted budget defaults to \"20.00\" and null removes the limit. Up to 500 file resources can be attached. Use initial_events to send a first user.message in this request, or send messages afterwards with sessions.events.send. The returned status can still be idle before initial events run; read agent.message and the subsequent session.status_idle event to confirm completion.";
     readonly http: "POST";
     readonly path: "/agent/v1/sessions";
     readonly streaming: "no";
@@ -1990,9 +1990,9 @@ export declare const operations: readonly [{
     }];
     readonly query: readonly [{
         readonly name: "limit";
-        readonly type: "number";
+        readonly type: "integer";
         readonly required: false;
-        readonly description: "Number of items per page.";
+        readonly description: "Number of resources per page, from 1 to 100; defaults to 100.";
     }, {
         readonly name: "page";
         readonly type: "string";
@@ -3108,7 +3108,7 @@ export declare const operations: readonly [{
     readonly resource: "automation.actions";
     readonly method: "list";
     readonly summary: "List actions";
-    readonly description: "Discover callable Actions and their ns/name references without executing them. Combine each returned namespace and name as ns/name; Action calls use the current revision and do not accept @version or @tag. Filter by name or description; results include seven-day statistics and revision summaries without implementation source. Archived actions are excluded by default.";
+    readonly description: "Discover callable Actions and their ns/name references without executing them. Combine each returned namespace and name as ns/name; Action calls use the current revision and do not accept @version or @tag. Filter by name or description; results include seven-day statistics and revision summaries without implementation source. Archived actions are excluded by default. List items carry no input contract: get the action and read current_revision.input_schema. Call it with call(\"ns/name\", input) in a script or call: ns/name with with: in a workflow.";
     readonly http: "GET";
     readonly path: "/automation/v1/actions";
     readonly streaming: "no";
@@ -3245,7 +3245,7 @@ export declare const operations: readonly [{
     readonly resource: "automation.actions";
     readonly method: "retrieve";
     readonly summary: "Get an Action with its current input and output JSON Schemas";
-    readonly description: "Read the Action and its full current implementation, with input and output JSON Schemas at current_revision.input_schema and current_revision.output_schema. To read a built-in Action, use ns=praxis and name=<bare name>, for example name=ocr; invoke it in a script with call(\"ocr\", input). The response ETag is the current revision ID for conditional updates.";
+    readonly description: "Read the Action and its full current implementation, with input and output JSON Schemas at current_revision.input_schema and current_revision.output_schema. To read a built-in Action, use ns=praxis and name=<bare name>, for example name=ocr; invoke it in a script with call(\"ocr\", input) or in a workflow step with call: ocr and with:. Input that breaks the contract returns INPUT_INVALID, with the fields in errors[]. The response ETag is the current revision ID for conditional updates.";
     readonly http: "GET";
     readonly path: "/automation/v1/actions/{ns}/{name}";
     readonly streaming: "no";
@@ -3580,6 +3580,142 @@ export declare const operations: readonly [{
         readonly required: false;
         readonly fields: readonly [];
     };
+}, {
+    readonly resource: "automation.humanTasks";
+    readonly method: "list";
+    readonly summary: "List human tasks";
+    readonly description: "List the human tasks that praxis/approval workflow steps opened, newest first. By default it returns only open tasks assigned to the caller: their approval inbox. scope=all lists every task of the organization, and status and run_id narrow the list. Use a returned id with retrieve for details and respond to decide. Read-only: listing never changes a task.";
+    readonly http: "GET";
+    readonly path: "/automation/v1/human-tasks";
+    readonly streaming: "no";
+    readonly pagination: true;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "limit";
+        readonly type: "integer";
+        readonly required: false;
+        readonly description: "Page size, 1–100, default 50.";
+    }, {
+        readonly name: "cursor";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "The next_cursor of the previous page; omit for the first page.";
+    }, {
+        readonly name: "status";
+        readonly type: "array";
+        readonly itemType: "string";
+        readonly enum: readonly ["open", "completed", "expired", "cancelled"];
+        readonly required: false;
+        readonly description: "Filter by status, comma-separated: open, completed, expired, cancelled. Defaults to open.";
+    }, {
+        readonly name: "run_id";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "Only tasks opened by this run (run_).";
+    }, {
+        readonly name: "scope";
+        readonly type: "string";
+        readonly enum: readonly ["assigned", "all"];
+        readonly required: false;
+        readonly description: "assigned (default) lists only tasks assigned to the caller; all lists every task of the organization.";
+    }];
+}, {
+    readonly resource: "automation.humanTasks";
+    readonly method: "retrieve";
+    readonly summary: "Retrieve a human task";
+    readonly description: "Read one human task - title, Markdown body, context, actions, form, assignees, mode, due time, responses and outcome - so an assignee can choose an action and fill the form. Read-only; the Console approval page /automation/tasks/{id} reads the same resource.";
+    readonly http: "GET";
+    readonly path: "/automation/v1/human-tasks/{id}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "id";
+        readonly sdkName: "id";
+        readonly description: "Human task ID (htask_), from the list or the run's waits.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "automation.humanTasks";
+    readonly method: "cancel";
+    readonly summary: "Cancel a human task";
+    readonly description: "Cancel an open human task; only the person who started the run or an organization API key may cancel. The task becomes cancelled and the waiting workflow step raises a runtime error with code HUMAN_TASK_CANCELLED, which try/catch can catch. Open tasks are cancelled automatically when their run ends, so this call is not needed then.";
+    readonly http: "POST";
+    readonly path: "/automation/v1/human-tasks/{id}/cancel";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "id";
+        readonly sdkName: "id";
+        readonly description: "Human task ID (htask_).";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: false;
+        readonly fields: readonly [{
+            readonly name: "reason";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Optional cancellation reason, at most 500 characters.";
+        }];
+    };
+}, {
+    readonly resource: "automation.humanTasks";
+    readonly method: "delegate";
+    readonly summary: "Delegate a human task";
+    readonly description: "An assignee who has not responded hands their place to another user (to_user), replacing their entry in assignees.users in place, so sequential order is kept. The new user cannot already be an assignee, nor the initiator unless self-approval is allowed. The task must still be open.";
+    readonly http: "POST";
+    readonly path: "/automation/v1/human-tasks/{id}/delegate";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "id";
+        readonly sdkName: "id";
+        readonly description: "Human task ID (htask_).";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "to_user";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "User ID taking over; cannot already be an assignee, nor the initiator unless self-approval is allowed.";
+        }];
+    };
+}, {
+    readonly resource: "automation.humanTasks";
+    readonly method: "respond";
+    readonly summary: "Respond to a human task";
+    readonly description: "Submit an action (action_id), form values (values) and a comment as the calling user. Depending on the task's mode the response either decides it (status becomes completed, outcome is set, and the waiting workflow resumes with outcome as the step output) or is recorded while other assignees are awaited. When two assignees respond at once, exactly one decides and the other gets TASK_CLOSED. An agent may respond only if the workflow set allow_agent_decision. Send an Idempotency-Key to retry safely.";
+    readonly http: "POST";
+    readonly path: "/automation/v1/human-tasks/{id}/respond";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "id";
+        readonly sdkName: "id";
+        readonly description: "Human task ID (htask_).";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "action_id";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "The chosen action ID from the task's actions, for example approve.";
+        }, {
+            readonly name: "values";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Any JSON object whose keys are strings and whose values are any JSON value.";
+        }, {
+            readonly name: "comment";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Comment of at most 4000 characters; required when the action has require_comment true.";
+        }];
+    };
 }, {
     readonly resource: "automation.resolve";
     readonly method: "retrieve";
@@ -3711,7 +3847,7 @@ export declare const operations: readonly [{
     readonly resource: "automation.runs";
     readonly method: "create";
     readonly summary: "Run a published target or execute draft source";
-    readonly description: "Execute a published script or workflow with target, or test unpublished code directly with source and language (ts for TypeScript, yaml for workflow YAML), without first saving or publishing a definition. Minimal script: `export default async ({ file_id }: { file_id: string }) => { const result = await call(\"ocr\", { document: { type: \"file\", file_id } }); return result; }`; send it as source with language=\"ts\", input={\"file_id\":\"<uploaded file ID>\"} and wait=0, using a PDF or image already uploaded to your account. To call a platform API directly in the same script, use the praxis SDK object, for example `praxis.model.ocr.create({ body: { model: \"glm-ocr\", document: { type: \"file\", file_id } } })`; Action IDs are strings passed to call(), not SDK methods such as praxis.ocr(...). praxis, call, invoke, console and codemode are module-scope bindings, not on globalThis, and need no import; invoke(\"namespace/name\", input) starts a child run. target and source are mutually exclusive; target accepts ns/name@version, @tag or @range and defaults to latest when @ is omitted. Source/input validation precedes run creation, so a separate validate call is optional. input defaults to {} and must match the input schema and fit within 1 MiB. wait is 0–60 seconds (default 0): a terminal run returns 200, otherwise 202. Use the returned id with praxis.automation.runs.retrieve and inspect status, output and error; acceptance does not mean successful completion. For long-running, background or batch work, use wait: 0 and poll the run, or split work into child runs or a workflow; wait only controls the response wait and does not extend execution limits. Actions time out after 30 s (run-sandbox after 10 min); scripts have a 5 min wall-clock limit and a 30 s CPU limit; workflows default to 24 h and allow up to 7 days. Each run can start at most 100 child runs, with at most 20 active at once; nesting depth is limited to 10. Idempotency-Key is scoped to tenant, method and path for 24 hours, excluding wait from the fingerprint; replay returns the current run with Idempotent-Replayed: true, changed contents return 422 and an in-flight request returns 409. New non-deterministic run IDs contain 78 characters, compared with 46 for legacy random IDs; treat IDs as opaque strings. Historical and deterministic IDs remain valid; same-millisecond order is not guaranteed.";
+    readonly description: "Execute a published script or workflow with target, or test unpublished code directly with source and language (ts for TypeScript, yaml for workflow YAML), without first saving or publishing a definition. Minimal script: `export default async ({ file_id }: { file_id: string }) => { const result = await call(\"ocr\", { document: { type: \"file\", file_id } }); return result; }`; send it as source with language=\"ts\", input={\"file_id\":\"<uploaded file ID>\"} and wait=0, using a PDF or image already uploaded to your account. To call a platform API directly in the same script, use the praxis SDK object, for example `praxis.model.ocr.create({ body: { model: \"glm-ocr\", document: { type: \"file\", file_id } } })`; Action IDs are strings passed to call(), not SDK methods such as praxis.ocr(...). praxis, call, invoke, console and codemode are module-scope bindings, not on globalThis, and need no import; invoke(\"namespace/name\", input) starts a child run. target and source are mutually exclusive; target accepts ns/name@version, @tag or @range and defaults to latest when @ is omitted. Source/input validation precedes run creation, so a separate validate call is optional. input defaults to {} and must match the input schema and fit within 1 MiB. wait is 0–60 seconds (default 0): a terminal run returns 200, otherwise 202. Use the returned id with praxis.automation.runs.retrieve and inspect status, output and error; acceptance does not mean successful completion. For long-running, background or batch work, use wait: 0 and poll the run, or split work into child runs or a workflow; wait only controls the response wait and does not extend execution limits. Actions time out after 30 s (run-sandbox after 10 min); scripts have a 5 min wall-clock limit and a 30 s CPU limit; workflows default to 24 h and allow up to 30 days. Each run can start at most 100 child runs, with at most 20 active at once; nesting depth is limited to 10. Idempotency-Key is scoped to tenant, method and path for 24 hours, excluding wait from the fingerprint; replay returns the current run with Idempotent-Replayed: true, changed contents return 422 and an in-flight request returns 409. With language=yaml, source is a workflow YAML: the run input is . in the first step, and the shape is described in create workflow. Error details are in errors[] (pointer, detail, hint). New non-deterministic run IDs contain 78 characters, compared with 46 for legacy random IDs; treat IDs as opaque strings. Historical and deterministic IDs remain valid; same-millisecond order is not guaranteed.";
     readonly http: "POST";
     readonly path: "/automation/v1/runs";
     readonly streaming: "no";
@@ -4108,7 +4244,7 @@ export declare const operations: readonly [{
     readonly resource: "automation.scripts";
     readonly method: "create";
     readonly summary: "Create a script";
-    readonly description: "Save a TypeScript script as an editable draft for later reuse; this does not publish or start a run. Choose your own namespace without registering it first; praxis is reserved for built-in Actions. Scripts and workflows share names within the tenant; a duplicate returns NAME_TAKEN. The draft is a source string with a default-exported function, for example `export default async (input: {name: string}) => ({greeting: \"Hello, \" + input.name});`. Scripts provide praxis, call, invoke, console and codemode as module-scope bindings, not on globalThis, with no import needed: praxis.<domain>.<resource>.<method>(...) calls a platform API, call(\"ocr\", input) calls a built-in Action, and invoke(\"namespace/name\", input) starts a child run. Action IDs are strings (bare names for built-ins, namespace/name for your own Actions); praxis.ocr(...) does not exist. To test it, pass that source and language=ts to praxis.automation.runs.create without publishing. To publish later, use the returned draft.revision as expected_draft_revision.";
+    readonly description: "Save a TypeScript script as an editable draft for later reuse; this does not publish or start a run. Choose your own namespace without registering it first; praxis is reserved for built-in Actions. Scripts and workflows share names within the tenant; a duplicate returns NAME_TAKEN. The draft is a source string with a default-exported function, for example `export default async (input: {name: string}) => ({greeting: \"Hello, \" + input.name});`. Scripts provide praxis, call, invoke, console and codemode as module-scope bindings, not on globalThis, with no import needed: praxis.<domain>.<resource>.<method>(...) calls a platform API, call(\"ocr\", input) calls a built-in Action, and invoke(\"namespace/name\", input) starts a child run. Action IDs are strings (bare names for built-ins, namespace/name for your own Actions); praxis.ocr(...) does not exist. The return value is limited to 1 MiB: write large results to a file with call(\"write-file\", ...) and return the file ID. A call error carries errors[] (pointer, detail, hint); String(e) is only the summary. To test it, pass that source and language=ts to praxis.automation.runs.create without publishing. To publish later, use the returned draft.revision as expected_draft_revision.";
     readonly http: "POST";
     readonly path: "/automation/v1/scripts";
     readonly streaming: "no";
@@ -4873,7 +5009,7 @@ export declare const operations: readonly [{
     readonly resource: "automation.validate";
     readonly method: "create";
     readonly summary: "Validate a definition";
-    readonly description: "Check source without executing it when you need diagnostics, inferred schemas or references. This is optional before praxis.automation.runs.create, which also validates source before execution. Actions, scripts and workflows are supported; results include validity without saving. Invalid source is reported with valid=false. Script/action output schemas are inferred from return types: Promise unwrapping, Record, intersections and Date. Unknown types yield an empty schema and a warning in warnings. Source diagnostics use /source or /implementation/source with 1-based line/column. For kind=action the same admission checks as action creation apply (no external imports, platform operations only as direct call(praxis/<api>.<op>, input) calls, no agent or automation calls), so source that validates is not rejected at creation.";
+    readonly description: "Check source without executing it when you need diagnostics, inferred schemas or references. This is optional before praxis.automation.runs.create, which also validates source before execution. Actions, scripts and workflows are supported; results include validity without saving. Invalid source is reported with valid=false. Script/action output schemas are inferred from return types: Promise unwrapping, Record, intersections and Date. Unknown types yield an empty schema and a warning in warnings. Source diagnostics use /source or /implementation/source with 1-based line/column. For kind=action the same admission checks as action creation apply (no external imports, platform operations only as direct call(praxis/<api>.<op>, input) calls, no agent or automation calls), so source that validates is not rejected at creation. For kind=workflow the YAML needs document (dsl, namespace, name, version) and do; each problem is one entry in errors[] (pointer, detail, hint), so read the first one. A listen outside the supported subset (to.all, inside a fork) and emit are not reported here and fail with DEFINITION_INVALID only when a run is created.";
     readonly http: "POST";
     readonly path: "/automation/v1/validate";
     readonly streaming: "no";
@@ -4958,7 +5094,7 @@ export declare const operations: readonly [{
     readonly resource: "automation.workflows";
     readonly method: "create";
     readonly summary: "Create a workflow";
-    readonly description: "Save a YAML workflow as an editable draft without publishing or starting a run. Choose your own namespace without registering it first; praxis is reserved for built-in Actions. To test the draft, send its source and language=yaml to praxis.automation.runs.create. Scripts and workflows share names within the tenant; a duplicate returns NAME_TAKEN. run.workflow accepts ns/name@range or {namespace, name, version, input}; run.script uses the same reference shape as a platform extension. Object namespace, name and version are required; version accepts an exact version, dist-tag or range, locked at publication. Object input defaults to {} and supports expressions; string references retain task-level with. run.await defaults to true and returns the child output. With false, the child uses detach and the task immediately returns {run_id}; parent cancellation does not cascade. Inline script.code returns DEFINITION_INVALID with a detail asking you to save a script and reference it first. raise.error retains its type URI, status, title and detail in the run error.";
+    readonly description: "Save a YAML workflow as an editable draft; this does not validate, publish or run it, so check it with validate (kind=workflow) first. Minimal draft: document with dsl (\"1.0.3\"), namespace, name and version, plus a do list of steps, for example document: {dsl: \"1.0.3\", namespace: demo, name: add, version: \"1.0.0\"} and do: [{first: {call: demo/add-one, with: {n: \"${ .n }\"}}}]. call: <ns/name> calls an Action directly (bare name for built-ins such as ocr) and with is the Action input; the input contract is at current_revision.input_schema in the get-action response. run: starts a saved script or child workflow. The run input is . in the first step, and expressions are jq written as a whole ${ ... } string. Limits: Action 30 s (run-sandbox 10 min), workflow 24 h by default and 30 days at most, payload 1 MiB. Test the draft by sending its source and language=yaml to praxis.automation.runs.create. Guide: /docs/developers/automation/guides/write-workflow. Error details are in the errors[] of the response (pointer, detail, hint). Choose your own namespace without registering it first; praxis is reserved for built-in Actions. Scripts and workflows share names within the tenant; a duplicate returns NAME_TAKEN. run.workflow accepts ns/name@range or {namespace, name, version, input}; run.script uses the same reference shape as a platform extension. Object namespace, name and version are required; version accepts an exact version, dist-tag or range, locked at publication. Object input defaults to {} and supports expressions; string references retain task-level with. run.await defaults to true and returns the child output. With false, the child uses detach and the task immediately returns {run_id}; parent cancellation does not cascade. Inline script.code returns DEFINITION_INVALID with a detail asking you to save a script and reference it first. raise.error retains its type URI, status, title and detail in the run error.";
     readonly http: "POST";
     readonly path: "/automation/v1/workflows";
     readonly streaming: "no";
@@ -5017,7 +5153,7 @@ export declare const operations: readonly [{
     readonly resource: "automation.workflows";
     readonly method: "update";
     readonly summary: "Update a workflow draft";
-    readonly description: "Update description, labels or draft with the current draft revision in If-Match. Even metadata-only updates create a new draft revision.";
+    readonly description: "Update description, labels or draft with the current draft revision in If-Match, taken from draft.revision in the get-workflow response. Even metadata-only updates create a new draft revision. A mismatch returns 412 PRECONDITION_FAILED; read the draft again, merge and retry. The draft is not validated here, so check it with validate (kind=workflow) before publishing. Error details are in errors[].";
     readonly http: "PATCH";
     readonly path: "/automation/v1/workflows/{ns}/{name}";
     readonly streaming: "no";
@@ -5211,7 +5347,7 @@ export declare const operations: readonly [{
     readonly method: "create";
     readonly aliases: readonly ["publish"];
     readonly summary: "Publish a workflow version";
-    readonly description: "Publish a saved definition from its draft or an ad hoc run as a reusable version for named runs or triggers, validating the definition and locking dependencies. To test unpublished code, use praxis.automation.runs.create with source and language instead. Use draft.revision from create or retrieve as expected_draft_revision. The draft must match expected_draft_revision; an ad hoc run requires from_run and expected_source_sha256. The same version and contents return the existing version; different contents return VERSION_EXISTS, prereleases require an explicit tag (not latest, URL-safe characters only, not a version or range; violations return TAG_REQUIRED or TAG_INVALID with the complete rules in hint), and invalid definitions return DEFINITION_INVALID. Stable releases automatically advance latest only above the highest existing stable version; workflows becoming latest synchronize their declared schedule. String and object run.workflow/run.script references share version resolution and dependency locking. Publishing removes +build metadata from the version number.";
+    readonly description: "Publish a saved definition from its draft or an ad hoc run as a reusable version for named runs or triggers, validating the definition and locking dependencies. To test unpublished code, use praxis.automation.runs.create with source and language instead. Use draft.revision from create or retrieve as expected_draft_revision. The draft must match expected_draft_revision; an ad hoc run requires from_run and expected_source_sha256. The same version and contents return the existing version; different contents return VERSION_EXISTS, prereleases require an explicit tag (not latest, URL-safe characters only, not a version or range; violations return TAG_REQUIRED or TAG_INVALID with the complete rules in hint), and invalid definitions return DEFINITION_INVALID. Stable releases automatically advance latest only above the highest existing stable version; workflows becoming latest synchronize their declared schedule. String and object run.workflow/run.script references share version resolution and dependency locking. Publishing removes +build metadata from the version number. For a workflow, document namespace, name and version must equal the publish target, otherwise DEFINITION_IDENTITY_MISMATCH; where a DEFINITION_INVALID failure sits is listed in errors[] (pointer, detail, hint).";
     readonly http: "POST";
     readonly path: "/automation/v1/workflows/{ns}/{name}/versions";
     readonly streaming: "no";
@@ -6596,7 +6732,7 @@ export declare const operations: readonly [{
     readonly resource: "file.files";
     readonly method: "create";
     readonly summary: "Upload file";
-    readonly description: "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 100000000 bytes, and only user_data, assistants and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. Use Uploads for larger files. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–2592000), or praxis[expires_in_seconds] (3600–7776000), never both. Without expiry, the file persists until deleted.";
+    readonly description: "Upload a file to reuse in conversations or attach to a knowledge base. Unlike OpenAI Files, uploads must be nonempty and at most 100000000 bytes, and only user_data and vision purposes are accepted. Send file bytes as a multipart file part, not a filename or file ID; in the SDK use a File or Blob, for example new File([\"Return within 23 days.\"], \"policy.txt\", { type: \"text/plain\" }). Content determines the MIME type. Supported uploads include PDF, DOCX/XLSX/PPTX, PNG/JPEG/GIF/WebP, MP3/WAV/FLAC/OGG/M4A, MP4/WebM, and UTF-8 JSON/NDJSON/CSV/Markdown/plain text; empty, unsupported, oversized files and unsupported purposes return 400. Use Uploads for larger files. The purpose vision accepts only PNG, JPEG, GIF and WebP, while conversation images require user_data. The returned ID belongs to your tenant; upload alone does not ingest the file into Knowledge. Knowledge attachment has a lower limit of 100000000 bytes. Optionally set expires_after[anchor]=created_at with expires_after[seconds] (3600–7776000). Without expiry, the file persists until deleted.";
     readonly http: "POST";
     readonly path: "/file/v1/files";
     readonly streaming: "no";
@@ -6614,19 +6750,14 @@ export declare const operations: readonly [{
         }, {
             readonly name: "purpose";
             readonly type: "string";
-            readonly enum: readonly ["user_data", "assistants", "vision"];
+            readonly enum: readonly ["user_data", "vision"];
             readonly required: true;
-            readonly description: "Purpose label stored with the file: user_data, assistants or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.";
+            readonly description: "Purpose label stored with the file: user_data or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.";
         }, {
             readonly name: "expires_after";
             readonly type: "object";
             readonly required: false;
             readonly description: "Optional expiry relative to created_at. Files without an expiry persist until deleted.";
-        }, {
-            readonly name: "praxis";
-            readonly type: "object";
-            readonly required: false;
-            readonly description: "Own-face extensions. Use at most one expiry setting.";
         }];
     };
 }, {
@@ -6678,7 +6809,7 @@ export declare const operations: readonly [{
     readonly resource: "file.uploads";
     readonly method: "create";
     readonly summary: "Create an upload";
-    readonly description: "Start a multipart upload for a file larger than the 100000000-byte direct-upload limit. Supply the exact byte length, filename, MIME type and purpose. Unlike OpenAI, uploads accept at most 2 GiB (2147483648 bytes) and only user_data, assistants and vision purposes. Add parts of at most 64000000 bytes and complete within one hour. Optional part_size enables fixed-size, retryable parts. expires_after applies to the resulting file (3600–7776000 seconds on this own face); without it the file persists until deleted.";
+    readonly description: "Start a multipart upload for a file larger than the 100000000-byte direct-upload limit. Supply the exact byte length, filename, MIME type and purpose. Unlike OpenAI, uploads accept at most 2 GiB (2147483648 bytes) and only user_data and vision purposes. Add parts of at most 64000000 bytes and complete within one hour. Optional part_size enables fixed-size, retryable parts. expires_after applies to the resulting file (3600–7776000 seconds on this own face); without it the file persists until deleted.";
     readonly http: "POST";
     readonly path: "/file/v1/uploads";
     readonly streaming: "no";
@@ -6705,9 +6836,9 @@ export declare const operations: readonly [{
         }, {
             readonly name: "purpose";
             readonly type: "string";
-            readonly enum: readonly ["user_data", "assistants", "vision"];
+            readonly enum: readonly ["user_data", "vision"];
             readonly required: true;
-            readonly description: "Use user_data for conversation attachments, assistants for assistant files, or vision for PNG, JPEG, GIF and WebP images.";
+            readonly description: "Use user_data for conversation attachments, or vision for PNG, JPEG, GIF and WebP images.";
         }, {
             readonly name: "expires_after";
             readonly type: "object";
@@ -7657,7 +7788,7 @@ export declare const operations: readonly [{
             readonly name: "overwrite";
             readonly type: "boolean";
             readonly required: false;
-            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true.";
+            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true.";
         }, {
             readonly name: "tags";
             readonly type: "object";
@@ -7702,6 +7833,7 @@ export declare const operations: readonly [{
             readonly name: "file_id";
             readonly type: "string";
             readonly required: true;
+            readonly description: "File ID to copy into this library; passed as the upload source instead of file bytes. This creates an independent public copy readable without authentication. Deleting the source File does not delete this asset; do not import confidential content.";
         }, {
             readonly name: "public_id";
             readonly type: "string";
@@ -7746,7 +7878,7 @@ export declare const operations: readonly [{
             readonly name: "overwrite";
             readonly type: "boolean";
             readonly required: false;
-            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. False returns the existing resource without replacing it; defaults to true.";
+            readonly description: "Allow replacing an existing public_id, preserving its asset_id and increasing its version. Only the latest version is deliverable; old version URLs return 404. Create a new public_id to retain old deliveries. False returns the existing resource without replacing it; defaults to true.";
         }, {
             readonly name: "tags";
             readonly type: "object";
@@ -8155,7 +8287,7 @@ export declare const operations: readonly [{
             readonly name: "expression";
             readonly type: "string";
             readonly required: false;
-            readonly description: "Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets.";
+            readonly description: "Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: [\"context\"] to include context.";
         }, {
             readonly name: "sort_by";
             readonly type: "array";