@realtimex/sdk 2.0.69 → 2.0.70

package/index.d.ts

@@ -64,6 +64,8 @@ export type AskHumanBody = {
   requestKey: string;
   supersedes?: string;
   expectedRevision?: number;
+  actionClass?: string;
+  alongsidePendingDelegateTask?: boolean;
   contractVersion?: "human-request@1";
 };
 export type AskHumanResponse = unknown;
@@ -2154,6 +2156,33 @@ export interface PrepareOptions extends RealtimeXRequestOptions {
   body?: PrepareBody;
 }
 
+export type PrintToPdfParams = Record<string, never>;
+export type PrintToPdfQuery = Record<string, never>;
+export type PrintToPdfHeaders = {
+  "x-app-id"?: string;
+};
+export type PrintToPdfBody = {
+  file: string;
+  out: string;
+  pageSize?: "A3" | "A4" | "A5" | "Legal" | "Letter" | "Tabloid";
+  landscape?: boolean;
+  printBackground?: boolean;
+  margins?: "default" | "none";
+  overwrite?: boolean;
+  allowNetwork?: boolean;
+};
+export type PrintToPdfResponse = {
+  success: true;
+  out: string;
+  bytes: number;
+};
+export interface PrintToPdfOptions extends RealtimeXRequestOptions {
+  params?: PrintToPdfParams;
+  query?: PrintToPdfQuery;
+  headers?: PrintToPdfHeaders & Record<string, string>;
+  body?: PrintToPdfBody;
+}
+
 export type PromoteWorkspaceAgentSkillParams = {
   workspaceSlug: string;
   skillId: string;
@@ -4171,6 +4200,9 @@ export declare class RealtimeXClient {
   /** Return compact workspace, thread, current workspace/thread, LLM provider, model, and CLI agent context before choosing arguments. Managed RealtimeX terminal authentication supplies the current route automatically; workspaceSlug and threadSlug remain optional compatibility inputs for other callers. */
   prepare(options?: PrepareOptions): Promise<PrepareResponse>;
   prepare(query?: PrepareQuery, options?: Omit<PrepareOptions, 'query'>): Promise<PrepareResponse>;
+  /** Print a local HTML document to a PDF file with the built-in Chromium of the desktop app, in a hidden window that runs no page scripts. The page may load images, CSS and fonts from its own folder (and below); remote resources are blocked unless allowNetwork is true. A blocked or missing resource fails the print. Needs the RealTimeX desktop app on this computer; nothing is installed. The PDF is saved at out and never replaces an existing file unless overwrite is true. If the call is interrupted, look at out before retrying. */
+  printToPdf(options?: PrintToPdfOptions): Promise<PrintToPdfResponse>;
+  printToPdf(body: PrintToPdfBody, options?: Omit<PrintToPdfOptions, 'body'>): Promise<PrintToPdfResponse>;
   /** Promote one workspace-owned agent skill to a global managed skill by copying its files into a new global skill row. */
   promoteWorkspaceAgentSkill(options?: PromoteWorkspaceAgentSkillOptions): Promise<PromoteWorkspaceAgentSkillResponse>;
   promoteWorkspaceAgentSkill(params: PromoteWorkspaceAgentSkillParams, body: PromoteWorkspaceAgentSkillBody, options?: Omit<PromoteWorkspaceAgentSkillOptions, 'params' | 'body'>): Promise<PromoteWorkspaceAgentSkillResponse>;
@@ -4262,7 +4294,7 @@ export declare class RealtimeXClient {
   /** Watch one RealTimeX Browser tab for a condition and wake the thread of the calling agent session when it occurs, until a deadline. The host observes the tab; waiting costs no turns. kind dom watches rendered elements (CSS selector, optional text, appears or changes); kind url watches the tab address. Name the tab by its id from list-browser-sessions. Setting an existing key replaces that watch. The watch is a Webhooks & Events endpoint the person sees and can pause or remove. It wakes your own thread; to deliver to another thread, a workspace */
   setBrowserWatch(options?: SetBrowserWatchOptions): Promise<SetBrowserWatchResponse>;
   setBrowserWatch(body: SetBrowserWatchBody, options?: Omit<SetBrowserWatchOptions, 'body'>): Promise<SetBrowserWatchResponse>;
-  /** Set who can use one channel, as Settings › Channels › Who can use it does. Only the fields you pass change. Private chats (dmPolicy): open (anyone), pairing (people I approve; not on Pancake), allowlist (only people I pick) or disabled. On Zalo Personal and WhatsApp also: groups (groupPolicy open, allowlist = only groups I turn on, or disabled), requireMention and replyMode for groups, the picked people (addAllowFrom/removeAllowFrom, ids from list-channel-friends) and the trusted members whose new groups turn on automatically (addTrustedMembers/removeTrustedMembers). Switching to allowlist while people can use the agent privately needs approvedPeople keep (they join the list) or pause. Pancake also takes its picked conversations (addAllowFrom/removeAllowFrom, Pancake conversation ids) and an invite code testers send to be picked (inviteCode create with inviteHours and inviteMaxUses, or inviteCode revoke; leaving allowlist revokes it); anyone else who messages the page is ignored. Other channel types take dmPolicy only. Anything that may widen access (any policy but disabled, adding people or members, creating an invite code, mentions not required, replies to every message) waits for the owner on the desktop when run from a terminal answering an external chat. Errors: 400 invalid value or a setting this channel type does not have, 404 no such channel, 409 approvedPeople needed. */
+  /** Set who can use one channel, as Settings › Channels › Who can use it does. Only the fields you pass change. Private chats (dmPolicy): open (anyone), pairing (people I approve; not on Pancake or Messenger), allowlist (only people I pick) or disabled. On Zalo Personal and WhatsApp also: groups (groupPolicy open, allowlist = only groups I turn on, or disabled), requireMention and replyMode for groups, the picked people (addAllowFrom/removeAllowFrom, ids from list-channel-friends) and the trusted members whose new groups turn on automatically (addTrustedMembers/removeTrustedMembers). Switching to allowlist while people can use the agent privately needs approvedPeople keep (they join the list) or pause. Pancake and Messenger also take their picked people (addAllowFrom/removeAllowFrom: Pancake conversation ids, or Messenger PSIDs, digits only and never the Page id) and an invite code testers send to be picked (inviteCode create with inviteHours and inviteMaxUses, or inviteCode revoke; leaving allowlist revokes it); anyone else who messages the page is ignored. Every id and option is checked before anything is saved. Other channel types take dmPolicy only. Anything that may widen access (any policy but disabled, adding people or members, creating an invite code, mentions not required, replies to every message) waits for the owner on the desktop when run from a terminal answering an external chat. Errors: 400 invalid value or a setting this channel type does not have, 404 no such channel, 409 approvedPeople needed. */
   setChannelAccess(options?: SetChannelAccessOptions): Promise<SetChannelAccessResponse>;
   setChannelAccess(channelId: string, body: SetChannelAccessBody, options?: Omit<SetChannelAccessOptions, 'params' | 'body'>): Promise<SetChannelAccessResponse>;
   /** Change one chat of a channel, as the Chats tab does. Name it with chatType (group or dm) and chatId (from list-channel-groups or list-channel-friends; for a private chat also a sealed sender_handle cu_<n>, or on Pancake the conversation id or the person\'s id). Any chat: guidance (or clearGuidance) is the chat\'s own guidance, always used when set, and useFrom picks which levels above it apply: a group uses all (All chats) and groups (All groups), a private chat all and private (All private chats); each on, off or inherit (follow the level above), for example all=off,groups=on. get-channel-guidance shows what the agent then sees. Zalo Personal and WhatsApp only: for a group allow (turn it on or off) and replyMode; for a private chat picked (on or off the list under only people I pick); for either routeWorkspaceId and routeThreadId send the chat to that workspace or thread, clearRoute sends it back to the channel\'s own. Other channel types take guidance, clearGuidance and useFrom only; website takes none. Only the fields you pass change. Turning a group on, picking a person, replies to every message and any route change wait for the owner on the desktop when run from a terminal answering an external chat. Errors: 400 invalid chat or field (CHANNEL_TYPE_UNSUPPORTED for a field this channel type does not have; USE_FROM_INVALID_KEY or USE_FROM_INVALID_VALUE for useFrom; CHANNEL_GUIDANCE_TOO_LONG above 4,000 characters), 403 a route into or out of a workspace this session cannot reach (ISOLATED_WORKSPACE_CROSSING_REFUSED), 404 no such channel or person (CONTACT_NOT_FOUND), 409 picked while the channel does not use only people I pick, or a person with several conversations (CONTACT_AMBIGUOUS, lists them). */

package/index.js

@@ -1178,6 +1178,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "printToPdf": {
+    "method": "POST",
+    "path": "/print-to-pdf",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "promoteWorkspaceAgentSkill": {
     "method": "POST",
     "path": "/promote-workspace-agent-skill/{workspaceSlug}/{skillId}",
@@ -3164,6 +3174,13 @@ class RealtimeXClient {
     );
   }
 
+  printToPdf(...args) {
+    return this.request(
+      "printToPdf",
+      normalizeOperationOptions(operations["printToPdf"], args)
+    );
+  }
+
   promoteWorkspaceAgentSkill(...args) {
     return this.request(
       "promoteWorkspaceAgentSkill",
@@ -3693,5 +3710,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.69",
+  version: "2.0.70",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.69",
+    "version": "2.0.70",
     "description": "RealtimeX runtime SDK package and moderator agent skill assets.",
     "private": false,
     "main": "./index.js",

package/skills/realtimex-artifacts/SKILL.md

@@ -15,16 +15,16 @@ List, publish, inspect, pause, resume, and revoke RealTimeX workspace artifacts.
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-automation-flows/SKILL.md

@@ -15,16 +15,16 @@ Run RealTimeX automation workflows and guided automation-flow commands, includin
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-browser-sessions/SKILL.md

@@ -15,16 +15,16 @@ List, create, start, stop, delete and show tabs of named RealTimeX browser sessi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -67,6 +67,10 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli list-browser-watches` — List the browser watches of the thread of the calling agent session, newest first: open ones
 
+**print-to-pdf** — Manage print to pdf
+
+- `realtimex-pp-cli print-to-pdf` — Print a local HTML document to a PDF file with the built-in Chromium of the desktop app
+
 **set-browser-watch** — Manage set browser watch
 
 - `realtimex-pp-cli set-browser-watch` — Watch one RealTimeX Browser tab for a condition and wake the thread of the calling agent session when it occurs

package/skills/realtimex-channels/SKILL.md

@@ -15,16 +15,16 @@ Create, configure, start, stop, and delete RealTimeX chat channels: who can use
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-decisions/SKILL.md

@@ -15,16 +15,16 @@ Run advisory decision-model judgments, list decision batteries, and calibrate ba
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-delegates/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX Delegate scope bindings, policy drafts and compiler jobs, activ
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-heartbeat/SKILL.md

@@ -15,16 +15,16 @@ Configure RealTimeX heartbeat scheduling, agents, active hours, timezone, autopi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-local-apps/SKILL.md

@@ -15,16 +15,16 @@ Create, inspect, configure, start, stop, restart, and delete RealTimeX Local App
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-moderator-sdk/SKILL.md

@@ -15,16 +15,16 @@ Use this router to select the smallest RealTimeX skill that owns the requested o
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-plugin-and-skill/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX plugins and agent skills, including configuration, enablement,
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-secrets/SKILL.md

@@ -15,16 +15,16 @@ Manage encrypted Login, Card, Identity, SSH key and Secure note items, tags and
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-terminal-agents/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX terminal agents, terminal sessions, session messages, and idle
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-webhooks/SKILL.md

@@ -15,16 +15,16 @@ Create, inspect, update, test, and delete RealTimeX public webhook endpoints and
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-workspaces/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX workspaces, threads, messages, workspace personality, LLM confi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.69. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.70. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.69`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.70`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.69
+npm install -g @realtimex/pp-cli@2.0.70
 ```
 
 For requests about the current workspace or thread, resolve context first: