@realtimex/sdk 2.0.38 → 2.0.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts CHANGED
@@ -583,6 +583,24 @@ export interface EnableWorkspaceAgentSkillOptions extends RealtimeXRequestOption
583
583
  body?: EnableWorkspaceAgentSkillBody;
584
584
  }
585
585
 
586
+ export type ForgetMemoryParams = Record<string, never>;
587
+ export type ForgetMemoryQuery = Record<string, never>;
588
+ export type ForgetMemoryHeaders = Record<string, never>;
589
+ export type ForgetMemoryBody = {
590
+ workspaceSlug?: string;
591
+ topic: string;
592
+ expectedHash: string;
593
+ purge?: boolean;
594
+ confirmPurge?: boolean;
595
+ };
596
+ export type ForgetMemoryResponse = Record<string, unknown>;
597
+ export interface ForgetMemoryOptions extends RealtimeXRequestOptions {
598
+ params?: ForgetMemoryParams;
599
+ query?: ForgetMemoryQuery;
600
+ headers?: ForgetMemoryHeaders & Record<string, string>;
601
+ body?: ForgetMemoryBody;
602
+ }
603
+
586
604
  export type GetArtifactParams = {
587
605
  artifactId: string;
588
606
  };
@@ -658,6 +676,20 @@ export interface GetLocalAppStatusOptions extends RealtimeXRequestOptions {
658
676
  body?: GetLocalAppStatusBody;
659
677
  }
660
678
 
679
+ export type GetMemoryStatusParams = Record<string, never>;
680
+ export type GetMemoryStatusQuery = {
681
+ workspaceSlug?: string;
682
+ };
683
+ export type GetMemoryStatusHeaders = Record<string, never>;
684
+ export type GetMemoryStatusBody = unknown;
685
+ export type GetMemoryStatusResponse = Record<string, unknown>;
686
+ export interface GetMemoryStatusOptions extends RealtimeXRequestOptions {
687
+ params?: GetMemoryStatusParams;
688
+ query?: GetMemoryStatusQuery;
689
+ headers?: GetMemoryStatusHeaders & Record<string, string>;
690
+ body?: GetMemoryStatusBody;
691
+ }
692
+
661
693
  export type GetPluginParams = {
662
694
  pluginId: string;
663
695
  };
@@ -773,6 +805,24 @@ export interface GoalKickoffComposerOptions extends RealtimeXRequestOptions {
773
805
  body?: GoalKickoffComposerBody;
774
806
  }
775
807
 
808
+ export type HumanTaskConfirmationLayoutParams = Record<string, never>;
809
+ export type HumanTaskConfirmationLayoutQuery = Record<string, never>;
810
+ export type HumanTaskConfirmationLayoutHeaders = Record<string, never>;
811
+ export type HumanTaskConfirmationLayoutBody = {
812
+ storageUser?: string;
813
+ artifactPath?: string;
814
+ screenshotDir?: string;
815
+ timeoutMs?: number;
816
+ confirmDestructive?: boolean;
817
+ };
818
+ export type HumanTaskConfirmationLayoutResponse = Record<string, unknown>;
819
+ export interface HumanTaskConfirmationLayoutOptions extends RealtimeXRequestOptions {
820
+ params?: HumanTaskConfirmationLayoutParams;
821
+ query?: HumanTaskConfirmationLayoutQuery;
822
+ headers?: HumanTaskConfirmationLayoutHeaders & Record<string, string>;
823
+ body?: HumanTaskConfirmationLayoutBody;
824
+ }
825
+
776
826
  export type InstallPluginParams = Record<string, never>;
777
827
  export type InstallPluginQuery = Record<string, never>;
778
828
  export type InstallPluginHeaders = {
@@ -1197,6 +1247,30 @@ export interface PostCliDelegateRunsRunIdEvidenceOptions extends RealtimeXReques
1197
1247
  body?: PostCliDelegateRunsRunIdEvidenceBody;
1198
1248
  }
1199
1249
 
1250
+ export type PostCliDelegateSubmissionsLookupParams = Record<string, never>;
1251
+ export type PostCliDelegateSubmissionsLookupQuery = Record<string, never>;
1252
+ export type PostCliDelegateSubmissionsLookupHeaders = Record<string, never>;
1253
+ export type PostCliDelegateSubmissionsLookupBody = unknown;
1254
+ export type PostCliDelegateSubmissionsLookupResponse = Record<string, unknown>;
1255
+ export interface PostCliDelegateSubmissionsLookupOptions extends RealtimeXRequestOptions {
1256
+ params?: PostCliDelegateSubmissionsLookupParams;
1257
+ query?: PostCliDelegateSubmissionsLookupQuery;
1258
+ headers?: PostCliDelegateSubmissionsLookupHeaders & Record<string, string>;
1259
+ body?: PostCliDelegateSubmissionsLookupBody;
1260
+ }
1261
+
1262
+ export type PostV1DelegatesMandateAuthoringParams = Record<string, never>;
1263
+ export type PostV1DelegatesMandateAuthoringQuery = Record<string, never>;
1264
+ export type PostV1DelegatesMandateAuthoringHeaders = Record<string, never>;
1265
+ export type PostV1DelegatesMandateAuthoringBody = unknown;
1266
+ export type PostV1DelegatesMandateAuthoringResponse = unknown;
1267
+ export interface PostV1DelegatesMandateAuthoringOptions extends RealtimeXRequestOptions {
1268
+ params?: PostV1DelegatesMandateAuthoringParams;
1269
+ query?: PostV1DelegatesMandateAuthoringQuery;
1270
+ headers?: PostV1DelegatesMandateAuthoringHeaders & Record<string, string>;
1271
+ body?: PostV1DelegatesMandateAuthoringBody;
1272
+ }
1273
+
1200
1274
  export type PrepareParams = Record<string, never>;
1201
1275
  export type PrepareQuery = {
1202
1276
  workspaceSlug?: string;
@@ -1302,6 +1376,21 @@ export interface PublishArtifactOptions extends RealtimeXRequestOptions {
1302
1376
  body?: PublishArtifactBody;
1303
1377
  }
1304
1378
 
1379
+ export type ReadMemoryParams = Record<string, never>;
1380
+ export type ReadMemoryQuery = {
1381
+ workspaceSlug?: string;
1382
+ topic?: string;
1383
+ };
1384
+ export type ReadMemoryHeaders = Record<string, never>;
1385
+ export type ReadMemoryBody = unknown;
1386
+ export type ReadMemoryResponse = Record<string, unknown>;
1387
+ export interface ReadMemoryOptions extends RealtimeXRequestOptions {
1388
+ params?: ReadMemoryParams;
1389
+ query?: ReadMemoryQuery;
1390
+ headers?: ReadMemoryHeaders & Record<string, string>;
1391
+ body?: ReadMemoryBody;
1392
+ }
1393
+
1305
1394
  export type ReloadAgentSkillsParams = Record<string, never>;
1306
1395
  export type ReloadAgentSkillsQuery = Record<string, never>;
1307
1396
  export type ReloadAgentSkillsHeaders = {
@@ -1543,13 +1632,29 @@ export interface RunAutomationWorkflowOptions extends RealtimeXRequestOptions {
1543
1632
  body?: RunAutomationWorkflowBody;
1544
1633
  }
1545
1634
 
1635
+ export type SearchMemoryParams = Record<string, never>;
1636
+ export type SearchMemoryQuery = {
1637
+ workspaceSlug?: string;
1638
+ query: string;
1639
+ limit?: number;
1640
+ };
1641
+ export type SearchMemoryHeaders = Record<string, never>;
1642
+ export type SearchMemoryBody = unknown;
1643
+ export type SearchMemoryResponse = Record<string, unknown>;
1644
+ export interface SearchMemoryOptions extends RealtimeXRequestOptions {
1645
+ params?: SearchMemoryParams;
1646
+ query?: SearchMemoryQuery;
1647
+ headers?: SearchMemoryHeaders & Record<string, string>;
1648
+ body?: SearchMemoryBody;
1649
+ }
1650
+
1546
1651
  export type SendChannelFileParams = Record<string, never>;
1547
1652
  export type SendChannelFileQuery = Record<string, never>;
1548
1653
  export type SendChannelFileHeaders = {
1549
1654
  "x-app-id"?: string;
1550
1655
  };
1551
1656
  export type SendChannelFileBody = {
1552
- context: string;
1657
+ context?: string;
1553
1658
  filePath?: string;
1554
1659
  fileName?: string;
1555
1660
  runtimeSessionId?: string;
@@ -1565,6 +1670,24 @@ export interface SendChannelFileOptions extends RealtimeXRequestOptions {
1565
1670
  body?: SendChannelFileBody;
1566
1671
  }
1567
1672
 
1673
+ export type SendChannelMessageParams = Record<string, never>;
1674
+ export type SendChannelMessageQuery = Record<string, never>;
1675
+ export type SendChannelMessageHeaders = {
1676
+ "x-app-id"?: string;
1677
+ };
1678
+ export type SendChannelMessageBody = {
1679
+ text: string;
1680
+ context?: string;
1681
+ idempotencyKey?: string;
1682
+ };
1683
+ export type SendChannelMessageResponse = Record<string, unknown>;
1684
+ export interface SendChannelMessageOptions extends RealtimeXRequestOptions {
1685
+ params?: SendChannelMessageParams;
1686
+ query?: SendChannelMessageQuery;
1687
+ headers?: SendChannelMessageHeaders & Record<string, string>;
1688
+ body?: SendChannelMessageBody;
1689
+ }
1690
+
1568
1691
  export type SendMessageParams = {
1569
1692
  workspaceSlug: string;
1570
1693
  threadSlug: string;
@@ -2068,9 +2191,11 @@ export type UpdateChannelBody = {
2068
2191
  name?: string;
2069
2192
  thread_id?: number;
2070
2193
  threadId?: number;
2194
+ chatOutput?: "auto" | "verbose" | "quiet";
2071
2195
  terminalProgressRelay?: boolean;
2072
2196
  terminalProgressThrottleSeconds?: number;
2073
2197
  terminalExternalUserContext?: boolean;
2198
+ busyTurnPolicy?: "immediate" | "queue";
2074
2199
  maxFileUploadMb?: number;
2075
2200
  ttsEnabled?: boolean;
2076
2201
  tts_enabled?: boolean;
@@ -2217,6 +2342,23 @@ export interface WorkspaceShellLayoutOptions extends RealtimeXRequestOptions {
2217
2342
  body?: WorkspaceShellLayoutBody;
2218
2343
  }
2219
2344
 
2345
+ export type WriteMemoryParams = Record<string, never>;
2346
+ export type WriteMemoryQuery = Record<string, never>;
2347
+ export type WriteMemoryHeaders = Record<string, never>;
2348
+ export type WriteMemoryBody = {
2349
+ workspaceSlug?: string;
2350
+ content: string;
2351
+ topic?: string;
2352
+ expectedHash?: string | null;
2353
+ };
2354
+ export type WriteMemoryResponse = Record<string, unknown>;
2355
+ export interface WriteMemoryOptions extends RealtimeXRequestOptions {
2356
+ params?: WriteMemoryParams;
2357
+ query?: WriteMemoryQuery;
2358
+ headers?: WriteMemoryHeaders & Record<string, string>;
2359
+ body?: WriteMemoryBody;
2360
+ }
2361
+
2220
2362
  export interface RealtimeXClientOptions {
2221
2363
  baseUrl?: string;
2222
2364
  appId?: string;
@@ -2381,6 +2523,8 @@ export declare class RealtimeXClient {
2381
2523
  /** Enable one agent skill in a workspace. Use a skill id, name, or displayName from list-workspace-agent-skills. */
2382
2524
  enableWorkspaceAgentSkill(options?: EnableWorkspaceAgentSkillOptions): Promise<EnableWorkspaceAgentSkillResponse>;
2383
2525
  enableWorkspaceAgentSkill(params: EnableWorkspaceAgentSkillParams, options?: Omit<EnableWorkspaceAgentSkillOptions, 'params'>): Promise<EnableWorkspaceAgentSkillResponse>;
2526
+ forgetMemory(options?: ForgetMemoryOptions): Promise<ForgetMemoryResponse>;
2527
+ forgetMemory(body: ForgetMemoryBody, options?: Omit<ForgetMemoryOptions, 'body'>): Promise<ForgetMemoryResponse>;
2384
2528
  /** Get one public artifact by artifact id. */
2385
2529
  getArtifact(options?: GetArtifactOptions): Promise<GetArtifactResponse>;
2386
2530
  getArtifact(artifactId: string, options?: Omit<GetArtifactOptions, 'params'>): Promise<GetArtifactResponse>;
@@ -2393,6 +2537,8 @@ export declare class RealtimeXClient {
2393
2537
  getLocalAppLogs(appId: string, options?: Omit<GetLocalAppLogsOptions, 'params'>): Promise<GetLocalAppLogsResponse>;
2394
2538
  getLocalAppStatus(options?: GetLocalAppStatusOptions): Promise<GetLocalAppStatusResponse>;
2395
2539
  getLocalAppStatus(appId: string, options?: Omit<GetLocalAppStatusOptions, 'params'>): Promise<GetLocalAppStatusResponse>;
2540
+ getMemoryStatus(options?: GetMemoryStatusOptions): Promise<GetMemoryStatusResponse>;
2541
+ getMemoryStatus(query?: GetMemoryStatusQuery, options?: Omit<GetMemoryStatusOptions, 'query'>): Promise<GetMemoryStatusResponse>;
2396
2542
  /** Get one installed plugin with its global config schema and current non-secret global values. Secret values are never returned; secretConfigState reports whether each global secret is set. Workspace-owned fields are listed separately and must be configured in Workspace Settings → Plugins. */
2397
2543
  getPlugin(options?: GetPluginOptions): Promise<GetPluginResponse>;
2398
2544
  getPlugin(pluginId: string, options?: Omit<GetPluginOptions, 'params'>): Promise<GetPluginResponse>;
@@ -2413,6 +2559,9 @@ export declare class RealtimeXClient {
2413
2559
  /** Verify the shared Project/global Goal kickoff composer, routing, attachment authorization, retry, preview, and responsive layouts. */
2414
2560
  goalKickoffComposer(options?: GoalKickoffComposerOptions): Promise<GoalKickoffComposerResponse>;
2415
2561
  goalKickoffComposer(body: GoalKickoffComposerBody, options?: Omit<GoalKickoffComposerOptions, 'body'>): Promise<GoalKickoffComposerResponse>;
2562
+ /** Seed a synthetic pending Human task with long bounds and measure its Approve confirmation in the owned Electron renderer. Never records a decision. */
2563
+ humanTaskConfirmationLayout(options?: HumanTaskConfirmationLayoutOptions): Promise<HumanTaskConfirmationLayoutResponse>;
2564
+ humanTaskConfirmationLayout(body: HumanTaskConfirmationLayoutBody, options?: Omit<HumanTaskConfirmationLayoutOptions, 'body'>): Promise<HumanTaskConfirmationLayoutResponse>;
2416
2565
  /** Install a plugin from a local source directory on the same machine as the server. Pass an absolute path containing realtimex.plugin.json. Pass force=true to replace an already-installed version; its saved configuration (including secrets) is preserved. Workspace-owned setup is listed separately for Workspace Settings → Plugins. */
2417
2566
  installPlugin(options?: InstallPluginOptions): Promise<InstallPluginResponse>;
2418
2567
  installPlugin(body: InstallPluginBody, options?: Omit<InstallPluginOptions, 'body'>): Promise<InstallPluginResponse>;
@@ -2477,6 +2626,9 @@ export declare class RealtimeXClient {
2477
2626
  postCliDelegateRunsRunIdDecision(runId: string, options?: Omit<PostCliDelegateRunsRunIdDecisionOptions, 'params'>): Promise<PostCliDelegateRunsRunIdDecisionResponse>;
2478
2627
  postCliDelegateRunsRunIdEvidence(options?: PostCliDelegateRunsRunIdEvidenceOptions): Promise<PostCliDelegateRunsRunIdEvidenceResponse>;
2479
2628
  postCliDelegateRunsRunIdEvidence(runId: string, options?: Omit<PostCliDelegateRunsRunIdEvidenceOptions, 'params'>): Promise<PostCliDelegateRunsRunIdEvidenceResponse>;
2629
+ postCliDelegateSubmissionsLookup(options?: PostCliDelegateSubmissionsLookupOptions): Promise<PostCliDelegateSubmissionsLookupResponse>;
2630
+ /** Legacy conversational mandate authoring */
2631
+ postV1DelegatesMandateAuthoring(options?: PostV1DelegatesMandateAuthoringOptions): Promise<PostV1DelegatesMandateAuthoringResponse>;
2480
2632
  /** 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. */
2481
2633
  prepare(options?: PrepareOptions): Promise<PrepareResponse>;
2482
2634
  prepare(query?: PrepareQuery, options?: Omit<PrepareOptions, 'query'>): Promise<PrepareResponse>;
@@ -2488,6 +2640,8 @@ export declare class RealtimeXClient {
2488
2640
  /** Publish a browser-viewable file or folder under a workspace artifacts directory. artifactPath is relative to that workspace artifacts directory. */
2489
2641
  publishArtifact(options?: PublishArtifactOptions): Promise<PublishArtifactResponse>;
2490
2642
  publishArtifact(workspaceSlug: string, body: PublishArtifactBody, options?: Omit<PublishArtifactOptions, 'params' | 'body'>): Promise<PublishArtifactResponse>;
2643
+ readMemory(options?: ReadMemoryOptions): Promise<ReadMemoryResponse>;
2644
+ readMemory(query?: ReadMemoryQuery, options?: Omit<ReadMemoryOptions, 'query'>): Promise<ReadMemoryResponse>;
2491
2645
  /** Force reload all enabled agent skills into one workspace working directory. Pass workspaceSlug; agents should pass the current RTX_WORKSPACE_SLUG when reloading the current workspace. This updates files, not necessarily the live CLI inventory. In QA, Claude Code 2.1.263 detected additions after startup but retained removed skills, including skills from disabled plugins, until a new session started; changes during the folder-trust prompt could also be missed. Start a new session for an accurate inventory in those cases. Gemini CLI 0.59.0 required /skills reload. Codex and Qwen live refresh was not verified in the QA environment. */
2492
2646
  reloadAgentSkills(options?: ReloadAgentSkillsOptions): Promise<ReloadAgentSkillsResponse>;
2493
2647
  reloadAgentSkills(body: ReloadAgentSkillsBody, options?: Omit<ReloadAgentSkillsOptions, 'body'>): Promise<ReloadAgentSkillsResponse>;
@@ -2528,9 +2682,14 @@ export declare class RealtimeXClient {
2528
2682
  /** Run any app automation flow or scenario exposed via flowMetadata.cli.enabled=true by passing workflowName. */
2529
2683
  runAutomationWorkflow(options?: RunAutomationWorkflowOptions): Promise<RunAutomationWorkflowResponse>;
2530
2684
  runAutomationWorkflow(body: RunAutomationWorkflowBody, options?: Omit<RunAutomationWorkflowOptions, 'body'>): Promise<RunAutomationWorkflowResponse>;
2531
- /** Send one local CLI file back to an external channel using an explicit channel delivery context id. Channel-linked terminal agents should pass --context "$REALTIMEX_CHANNEL_DELIVERY_CONTEXT_ID". In desktop/local runtime the CLI should send an absolute filePath; contentBase64 remains available as fallback transport. */
2685
+ searchMemory(options?: SearchMemoryOptions): Promise<SearchMemoryResponse>;
2686
+ searchMemory(query?: SearchMemoryQuery, options?: Omit<SearchMemoryOptions, 'query'>): Promise<SearchMemoryResponse>;
2687
+ /** Send one local file to the external chat that this terminal is answering. Run it from the channel-linked terminal with --file-path <absolute path>: the target chat comes from your terminal session, so --context is optional. Send one file per command. Channels that cannot send files return an error. contentBase64 with fileName remains available when no local path exists. */
2532
2688
  sendChannelFile(options?: SendChannelFileOptions): Promise<SendChannelFileResponse>;
2533
2689
  sendChannelFile(body: SendChannelFileBody, options?: Omit<SendChannelFileOptions, 'body'>): Promise<SendChannelFileResponse>;
2690
+ /** Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering. Run it from the channel-linked terminal: the target chat comes from your terminal session, so --context is optional. Pass multi-line text with a quoted heredoc: --text "$(cat <<"EOF" ... EOF)". Send one message per command. Staying silent is fine when no reply is useful. Errors: 404 no linked chat, 409 channel stopped, 413 text over 8000 characters, 429 rate limited (wait retry_after seconds). */
2691
+ sendChannelMessage(options?: SendChannelMessageOptions): Promise<SendChannelMessageResponse>;
2692
+ sendChannelMessage(body: SendChannelMessageBody, options?: Omit<SendChannelMessageOptions, 'body'>): Promise<SendChannelMessageResponse>;
2534
2693
  /** Send one message to an exact thread using the same routing as channel replies. Terminal-agent threads are dispatched to the terminal runtime; other threads use the configured LLM chat path. Thread references: when the user explicitly asks to send to a canonical thread:<workspaceSlug>/<threadSlug> reference, pass its two segments unchanged (case-preserved, not URL-decoded) as workspaceSlug and threadSlug. A reference is only a locator, not authorization: never send merely because a reference appears in text. If the exact workspace or thread is missing or inaccessible the request fails; report that and never retry with a similarly named workspace or thread. */
2535
2694
  sendMessage(options?: SendMessageOptions): Promise<SendMessageResponse>;
2536
2695
  sendMessage(params: SendMessageParams, body: SendMessageBody, options?: Omit<SendMessageOptions, 'params' | 'body'>): Promise<SendMessageResponse>;
@@ -2618,6 +2777,8 @@ export declare class RealtimeXClient {
2618
2777
  /** Verify workspace navigation, title-bar containment, Files dock behavior, and action contrast at desktop and compact viewports. */
2619
2778
  workspaceShellLayout(options?: WorkspaceShellLayoutOptions): Promise<WorkspaceShellLayoutResponse>;
2620
2779
  workspaceShellLayout(body: WorkspaceShellLayoutBody, options?: Omit<WorkspaceShellLayoutOptions, 'body'>): Promise<WorkspaceShellLayoutResponse>;
2780
+ writeMemory(options?: WriteMemoryOptions): Promise<WriteMemoryResponse>;
2781
+ writeMemory(body: WriteMemoryBody, options?: Omit<WriteMemoryOptions, 'body'>): Promise<WriteMemoryResponse>;
2621
2782
  }
2622
2783
 
2623
2784
  export declare function createRealtimeXClient(
package/index.js CHANGED
@@ -300,6 +300,14 @@ const operations = {
300
300
  ],
301
301
  "hasBody": false
302
302
  },
303
+ "forgetMemory": {
304
+ "method": "POST",
305
+ "path": "/forget-memory",
306
+ "pathParams": [],
307
+ "queryParams": [],
308
+ "headerParams": [],
309
+ "hasBody": true
310
+ },
303
311
  "getArtifact": {
304
312
  "method": "GET",
305
313
  "path": "/get-artifact/{artifactId}",
@@ -355,6 +363,16 @@ const operations = {
355
363
  "headerParams": [],
356
364
  "hasBody": false
357
365
  },
366
+ "getMemoryStatus": {
367
+ "method": "GET",
368
+ "path": "/get-memory-status",
369
+ "pathParams": [],
370
+ "queryParams": [
371
+ "workspaceSlug"
372
+ ],
373
+ "headerParams": [],
374
+ "hasBody": false
375
+ },
358
376
  "getPlugin": {
359
377
  "method": "GET",
360
378
  "path": "/get-plugin/{pluginId}",
@@ -435,6 +453,14 @@ const operations = {
435
453
  "headerParams": [],
436
454
  "hasBody": true
437
455
  },
456
+ "humanTaskConfirmationLayout": {
457
+ "method": "POST",
458
+ "path": "/human-task-confirmation-layout",
459
+ "pathParams": [],
460
+ "queryParams": [],
461
+ "headerParams": [],
462
+ "hasBody": true
463
+ },
438
464
  "installPlugin": {
439
465
  "method": "POST",
440
466
  "path": "/install-plugin",
@@ -718,6 +744,22 @@ const operations = {
718
744
  "headerParams": [],
719
745
  "hasBody": false
720
746
  },
747
+ "postCliDelegateSubmissionsLookup": {
748
+ "method": "POST",
749
+ "path": "/delegate-submissions/lookup",
750
+ "pathParams": [],
751
+ "queryParams": [],
752
+ "headerParams": [],
753
+ "hasBody": false
754
+ },
755
+ "postV1DelegatesMandateAuthoring": {
756
+ "method": "POST",
757
+ "path": "/v1/delegates/mandate-authoring",
758
+ "pathParams": [],
759
+ "queryParams": [],
760
+ "headerParams": [],
761
+ "hasBody": false
762
+ },
721
763
  "prepare": {
722
764
  "method": "GET",
723
765
  "path": "/prepare",
@@ -766,6 +808,17 @@ const operations = {
766
808
  ],
767
809
  "hasBody": true
768
810
  },
811
+ "readMemory": {
812
+ "method": "GET",
813
+ "path": "/read-memory",
814
+ "pathParams": [],
815
+ "queryParams": [
816
+ "workspaceSlug",
817
+ "topic"
818
+ ],
819
+ "headerParams": [],
820
+ "hasBody": false
821
+ },
769
822
  "reloadAgentSkills": {
770
823
  "method": "POST",
771
824
  "path": "/reload-agent-skills",
@@ -924,6 +977,18 @@ const operations = {
924
977
  ],
925
978
  "hasBody": true
926
979
  },
980
+ "searchMemory": {
981
+ "method": "GET",
982
+ "path": "/search-memory",
983
+ "pathParams": [],
984
+ "queryParams": [
985
+ "workspaceSlug",
986
+ "query",
987
+ "limit"
988
+ ],
989
+ "headerParams": [],
990
+ "hasBody": false
991
+ },
927
992
  "sendChannelFile": {
928
993
  "method": "POST",
929
994
  "path": "/send-channel-file",
@@ -934,6 +999,16 @@ const operations = {
934
999
  ],
935
1000
  "hasBody": true
936
1001
  },
1002
+ "sendChannelMessage": {
1003
+ "method": "POST",
1004
+ "path": "/send-channel-message",
1005
+ "pathParams": [],
1006
+ "queryParams": [],
1007
+ "headerParams": [
1008
+ "x-app-id"
1009
+ ],
1010
+ "hasBody": true
1011
+ },
937
1012
  "sendMessage": {
938
1013
  "method": "POST",
939
1014
  "path": "/send-message/{workspaceSlug}/{threadSlug}",
@@ -1265,6 +1340,14 @@ const operations = {
1265
1340
  "queryParams": [],
1266
1341
  "headerParams": [],
1267
1342
  "hasBody": true
1343
+ },
1344
+ "writeMemory": {
1345
+ "method": "PUT",
1346
+ "path": "/write-memory",
1347
+ "pathParams": [],
1348
+ "queryParams": [],
1349
+ "headerParams": [],
1350
+ "hasBody": true
1268
1351
  }
1269
1352
  };
1270
1353
 
@@ -1887,6 +1970,13 @@ class RealtimeXClient {
1887
1970
  );
1888
1971
  }
1889
1972
 
1973
+ forgetMemory(...args) {
1974
+ return this.request(
1975
+ "forgetMemory",
1976
+ normalizeOperationOptions(operations["forgetMemory"], args)
1977
+ );
1978
+ }
1979
+
1890
1980
  getArtifact(...args) {
1891
1981
  return this.request(
1892
1982
  "getArtifact",
@@ -1922,6 +2012,13 @@ class RealtimeXClient {
1922
2012
  );
1923
2013
  }
1924
2014
 
2015
+ getMemoryStatus(...args) {
2016
+ return this.request(
2017
+ "getMemoryStatus",
2018
+ normalizeOperationOptions(operations["getMemoryStatus"], args)
2019
+ );
2020
+ }
2021
+
1925
2022
  getPlugin(...args) {
1926
2023
  return this.request(
1927
2024
  "getPlugin",
@@ -1971,6 +2068,13 @@ class RealtimeXClient {
1971
2068
  );
1972
2069
  }
1973
2070
 
2071
+ humanTaskConfirmationLayout(...args) {
2072
+ return this.request(
2073
+ "humanTaskConfirmationLayout",
2074
+ normalizeOperationOptions(operations["humanTaskConfirmationLayout"], args)
2075
+ );
2076
+ }
2077
+
1974
2078
  installPlugin(...args) {
1975
2079
  return this.request(
1976
2080
  "installPlugin",
@@ -2160,6 +2264,20 @@ class RealtimeXClient {
2160
2264
  );
2161
2265
  }
2162
2266
 
2267
+ postCliDelegateSubmissionsLookup(...args) {
2268
+ return this.request(
2269
+ "postCliDelegateSubmissionsLookup",
2270
+ normalizeOperationOptions(operations["postCliDelegateSubmissionsLookup"], args)
2271
+ );
2272
+ }
2273
+
2274
+ postV1DelegatesMandateAuthoring(...args) {
2275
+ return this.request(
2276
+ "postV1DelegatesMandateAuthoring",
2277
+ normalizeOperationOptions(operations["postV1DelegatesMandateAuthoring"], args)
2278
+ );
2279
+ }
2280
+
2163
2281
  prepare(...args) {
2164
2282
  return this.request(
2165
2283
  "prepare",
@@ -2188,6 +2306,13 @@ class RealtimeXClient {
2188
2306
  );
2189
2307
  }
2190
2308
 
2309
+ readMemory(...args) {
2310
+ return this.request(
2311
+ "readMemory",
2312
+ normalizeOperationOptions(operations["readMemory"], args)
2313
+ );
2314
+ }
2315
+
2191
2316
  reloadAgentSkills(...args) {
2192
2317
  return this.request(
2193
2318
  "reloadAgentSkills",
@@ -2286,6 +2411,13 @@ class RealtimeXClient {
2286
2411
  );
2287
2412
  }
2288
2413
 
2414
+ searchMemory(...args) {
2415
+ return this.request(
2416
+ "searchMemory",
2417
+ normalizeOperationOptions(operations["searchMemory"], args)
2418
+ );
2419
+ }
2420
+
2289
2421
  sendChannelFile(...args) {
2290
2422
  return this.request(
2291
2423
  "sendChannelFile",
@@ -2293,6 +2425,13 @@ class RealtimeXClient {
2293
2425
  );
2294
2426
  }
2295
2427
 
2428
+ sendChannelMessage(...args) {
2429
+ return this.request(
2430
+ "sendChannelMessage",
2431
+ normalizeOperationOptions(operations["sendChannelMessage"], args)
2432
+ );
2433
+ }
2434
+
2296
2435
  sendMessage(...args) {
2297
2436
  return this.request(
2298
2437
  "sendMessage",
@@ -2509,6 +2648,13 @@ class RealtimeXClient {
2509
2648
  normalizeOperationOptions(operations["workspaceShellLayout"], args)
2510
2649
  );
2511
2650
  }
2651
+
2652
+ writeMemory(...args) {
2653
+ return this.request(
2654
+ "writeMemory",
2655
+ normalizeOperationOptions(operations["writeMemory"], args)
2656
+ );
2657
+ }
2512
2658
  }
2513
2659
 
2514
2660
  function createRealtimeXClient(options = {}) {
@@ -2528,5 +2674,5 @@ module.exports = {
2528
2674
  createRealtimeXClient,
2529
2675
  createRealtimeXWebhookClient,
2530
2676
  operations,
2531
- version: "2.0.38",
2677
+ version: "2.0.40",
2532
2678
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@realtimex/sdk",
3
- "version": "2.0.38",
3
+ "version": "2.0.40",
4
4
  "description": "RealtimeX runtime SDK package and moderator agent skill assets.",
5
5
  "private": false,
6
6
  "main": "./index.js",
@@ -15,16 +15,16 @@ List, publish, inspect, pause, resume, and revoke RealTimeX workspace artifacts.
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Run RealTimeX automation workflows and guided automation-flow commands, includin
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -63,6 +63,10 @@ realtimex-pp-cli prepare --agent
63
63
 
64
64
  - `realtimex-pp-cli goal-kickoff-composer` — Verify the shared Project/global Goal kickoff composer, routing, attachment authorization, retry, preview
65
65
 
66
+ **human-task-confirmation-layout** — Manage human task confirmation layout
67
+
68
+ - `realtimex-pp-cli human-task-confirmation-layout` — Seed a synthetic pending Human task with long bounds and measure its Approve confirmation in the owned Electron
69
+
66
70
  **loop-background-handoff-order-e2e** — Manage loop background handoff order e2e
67
71
 
68
72
  - `realtimex-pp-cli loop-background-handoff-order-e2e` — Verify handoff, reply, and card order after returning to a cached background thread.
@@ -15,16 +15,16 @@ List, create, start, stop, and delete isolated RealTimeX browser sessions. Use f
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Create, configure, start, stop, and delete RealTimeX chat channels, approve pair
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -53,7 +53,11 @@ realtimex-pp-cli prepare --agent
53
53
 
54
54
  **send-channel-file** — Manage send channel file
55
55
 
56
- - `realtimex-pp-cli send-channel-file` — Send one local CLI file back to an external channel using an explicit channel delivery context id.
56
+ - `realtimex-pp-cli send-channel-file` — Send one local file to the external chat that this terminal is answering.
57
+
58
+ **send-channel-message** — Manage send channel message
59
+
60
+ - `realtimex-pp-cli send-channel-message` — Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering.
57
61
 
58
62
  **start-channel** — Manage start channel
59
63
 
@@ -15,16 +15,16 @@ Manage RealTimeX Delegate scope bindings, policy drafts and compiler jobs, activ
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Configure RealTimeX heartbeat scheduling, agents, active hours, timezone, autopi
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Create, inspect, configure, start, stop, restart, and delete RealTimeX Local App
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Use this router to select the smallest RealTimeX skill that owns the requested o
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Manage RealTimeX plugins and agent skills, including configuration, enablement,
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Manage encrypted Login, Card, Identity, SSH key and Secure note items, tags and
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -68,7 +68,7 @@ Read a scalar value with `--value-stdin` (trusted raw stdin, never a shell liter
68
68
  - Use realtimex-pp-cli for secret management only. List/get responses contain metadata and references, never values.
69
69
  - Prefer the Secrets settings screen for entering or rotating values. Never put a raw secret in a command argument, shell history, chat, or an agent-created temporary file.
70
70
  - Secrets default to all workspaces. Set workspaceSlugs to an explicit list to restrict execution; an empty list permits no workspace. Management remains app-wide in this single-user app.
71
- - Use rtxexec only for execution. Install @realtimex/rtxexec@0.3.0 if unavailable. It uses REALTIMEX_TERMINAL_SESSION_TOKEN and the app-provided local server URL; workspace scope comes from the authenticated session.
71
+ - Use rtxexec only for execution. Install @realtimex/rtxexec@0.4.0 if unavailable. It uses REALTIMEX_TERMINAL_SESSION_TOKEN and the app-provided local server URL; workspace scope comes from the authenticated session.
72
72
  - The item kinds are login, card, identity, ssh_key and note. Login also covers token-only entries: username, password, apiToken and websites are optional. Use the built-in apiToken field for an API key/token and custom fields for additional values. Tags replace folders. Names shown to people are displayName; name/reference remains stable.
73
73
  - Create/edit values in Settings when possible. For moderator management use --display-name and --kind with --item-stdin containing JSON {"fields":{"password":"..."},"notes":"..."} from a trusted source. Never construct raw-value JSON in an agent command. Custom field definitions use --custom-fields JSON containing name,label,type (text or hidden); their values belong in fields. Omitted fields retain their values; null or empty clears them. Omit notes to retain, use empty notes to clear. Removing a custom definition deletes its stored value.
74
74
  - Use --tags and --websites for comma-separated metadata. Empty --tags= or --websites= clears the list. Browser use requires the destination in allowedOrigins (derived from websites by default). Old --value-stdin and --login-stdin remain compatible; do not combine stdin modes, and never use secret stdin with --dry-run.
@@ -15,16 +15,16 @@ Manage RealTimeX terminal agents, terminal sessions, session messages, and idle
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Create, inspect, update, test, and delete RealTimeX public webhook endpoints and
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first:
@@ -15,16 +15,16 @@ Manage RealTimeX workspaces, threads, messages, workspace personality, LLM confi
15
15
 
16
16
  ## CLI setup
17
17
 
18
- This skill uses `realtimex-pp-cli` version 2.0.38. Before using its commands:
18
+ This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
19
19
 
20
20
  ```bash
21
21
  realtimex-pp-cli --version
22
22
  ```
23
23
 
24
- If it is missing or does not report `realtimex-pp-cli 2.0.38`, install the pinned version:
24
+ If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
25
25
 
26
26
  ```bash
27
- npm install -g @realtimex/pp-cli@2.0.38
27
+ npm install -g @realtimex/pp-cli@2.0.40
28
28
  ```
29
29
 
30
30
  For requests about the current workspace or thread, resolve context first: