@lunnoa/client 0.0.0-development → 1.0.0

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/dist/index.d.cts CHANGED
@@ -696,6 +696,26 @@ interface paths {
696
696
  patch?: never;
697
697
  trace?: never;
698
698
  };
699
+ "/api/objects/{objectId}/queue-items": {
700
+ parameters: {
701
+ query?: never;
702
+ header?: never;
703
+ path?: never;
704
+ cookie?: never;
705
+ };
706
+ /**
707
+ * List queue items for an Object
708
+ * @description Returns work items linked to the given Object across all queues in the workspace. Use this for an Object detail "Work" panel.
709
+ */
710
+ get: operations["ObjectQueueItemsController_listForObject"];
711
+ put?: never;
712
+ post?: never;
713
+ delete?: never;
714
+ options?: never;
715
+ head?: never;
716
+ patch?: never;
717
+ trace?: never;
718
+ };
699
719
  "/api/workflows": {
700
720
  parameters: {
701
721
  query?: never;
@@ -756,6 +776,66 @@ interface paths {
756
776
  patch?: never;
757
777
  trace?: never;
758
778
  };
779
+ "/api/agents": {
780
+ parameters: {
781
+ query?: never;
782
+ header?: never;
783
+ path?: never;
784
+ cookie?: never;
785
+ };
786
+ /**
787
+ * List agents in current workspace
788
+ * @description Lists every agent in the caller's active workspace, most recently updated first. By default each item carries only `id`, `name`, and `FK_aiConnectionId`; request additional fields with the `expansion` query parameter.
789
+ */
790
+ get: operations["AgentsController_findAllForWorkspace"];
791
+ put?: never;
792
+ post?: never;
793
+ delete?: never;
794
+ options?: never;
795
+ head?: never;
796
+ patch?: never;
797
+ trace?: never;
798
+ };
799
+ "/api/agents/{agentId}": {
800
+ parameters: {
801
+ query?: never;
802
+ header?: never;
803
+ path?: never;
804
+ cookie?: never;
805
+ };
806
+ /**
807
+ * Get agent by ID
808
+ * @description Returns a single agent. By default only `id`, `name`, and `FK_aiConnectionId` are returned; request additional fields with the `expansion` query parameter. Access is gated by the `agents:use` permission, so agents reachable via a share grant can also be fetched.
809
+ */
810
+ get: operations["AgentsController_findOne"];
811
+ put?: never;
812
+ post?: never;
813
+ delete?: never;
814
+ options?: never;
815
+ head?: never;
816
+ patch?: never;
817
+ trace?: never;
818
+ };
819
+ "/api/projects/{projectId}/agents/upsert": {
820
+ parameters: {
821
+ query?: never;
822
+ header?: never;
823
+ path?: never;
824
+ cookie?: never;
825
+ };
826
+ get?: never;
827
+ put?: never;
828
+ /**
829
+ * Upsert an agent by slug
830
+ * @description Creates or updates an agent identified by project-scoped `slug`. Accepts instructions, model, optional aiConnectionId / connectionIds / workflowIds, and catalogue action tools. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client agents deploy`) over calling this from application code.
831
+ */
832
+ post: operations["ProjectAgentsController_upsertBySlug"];
833
+ delete?: never;
834
+ options?: never;
835
+ head?: never;
836
+ patch?: never;
837
+ trace?: never;
838
+ };
759
839
  "/api/workflow-apps": {
760
840
  parameters: {
761
841
  query?: never;
@@ -1392,66 +1472,6 @@ interface paths {
1392
1472
  patch?: never;
1393
1473
  trace?: never;
1394
1474
  };
1395
- "/api/agents": {
1396
- parameters: {
1397
- query?: never;
1398
- header?: never;
1399
- path?: never;
1400
- cookie?: never;
1401
- };
1402
- /**
1403
- * List agents in current workspace
1404
- * @description Lists every agent in the caller's active workspace, most recently updated first. By default each item carries only `id`, `name`, and `FK_aiConnectionId`; request additional fields with the `expansion` query parameter.
1405
- */
1406
- get: operations["AgentsController_findAllForWorkspace"];
1407
- put?: never;
1408
- post?: never;
1409
- delete?: never;
1410
- options?: never;
1411
- head?: never;
1412
- patch?: never;
1413
- trace?: never;
1414
- };
1415
- "/api/agents/{agentId}": {
1416
- parameters: {
1417
- query?: never;
1418
- header?: never;
1419
- path?: never;
1420
- cookie?: never;
1421
- };
1422
- /**
1423
- * Get agent by ID
1424
- * @description Returns a single agent. By default only `id`, `name`, and `FK_aiConnectionId` are returned; request additional fields with the `expansion` query parameter. Access is gated by the `agents:use` permission, so agents reachable via a share grant can also be fetched.
1425
- */
1426
- get: operations["AgentsController_findOne"];
1427
- put?: never;
1428
- post?: never;
1429
- delete?: never;
1430
- options?: never;
1431
- head?: never;
1432
- patch?: never;
1433
- trace?: never;
1434
- };
1435
- "/api/projects/{projectId}/agents/upsert": {
1436
- parameters: {
1437
- query?: never;
1438
- header?: never;
1439
- path?: never;
1440
- cookie?: never;
1441
- };
1442
- get?: never;
1443
- put?: never;
1444
- /**
1445
- * Upsert an agent by slug
1446
- * @description Creates or updates an agent identified by project-scoped `slug`. Accepts instructions, model, optional aiConnectionId / connectionIds / workflowIds, and catalogue action tools. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client agents deploy`) over calling this from application code.
1447
- */
1448
- post: operations["ProjectAgentsController_upsertBySlug"];
1449
- delete?: never;
1450
- options?: never;
1451
- head?: never;
1452
- patch?: never;
1453
- trace?: never;
1454
- };
1455
1475
  "/api/tasks": {
1456
1476
  parameters: {
1457
1477
  query?: never;
@@ -1690,6 +1710,8 @@ interface components {
1690
1710
  CreateQueueDto: {
1691
1711
  /** @description Human-readable name for the queue. */
1692
1712
  name: string;
1713
+ /** @description ObjectType IDs this queue accepts for linked items. Empty/omitted = any ObjectType (and untyped items) allowed. */
1714
+ allowedObjectTypeIds?: string[];
1693
1715
  /** @description Description of what the queue is used for. */
1694
1716
  description?: string;
1695
1717
  /** @description Maximum number of retry attempts per item. Defaults to 3. */
@@ -1731,6 +1753,14 @@ interface components {
1731
1753
  /** @description Number of items in the queue. */
1732
1754
  items: number;
1733
1755
  };
1756
+ QueueAllowedObjectTypeDto: {
1757
+ /** @description Object type ID. */
1758
+ id: string;
1759
+ /** @description Object type name. */
1760
+ name: string;
1761
+ /** @description Object type slug. */
1762
+ slug: string;
1763
+ };
1734
1764
  QueueResponseDto: {
1735
1765
  /** @description Queue ID. */
1736
1766
  id: string;
@@ -1776,6 +1806,8 @@ interface components {
1776
1806
  createdByWorkspaceUser?: components["schemas"]["QueueCreatedByWorkspaceUserDto"];
1777
1807
  /** @description Relation counts. Included when `expansion=itemCounts` is requested. */
1778
1808
  _count?: components["schemas"]["QueueItemCountsDto"];
1809
+ /** @description ObjectTypes this queue accepts for linked items. Empty means any type is allowed. Included when `expansion=allowedObjectTypes` is requested. */
1810
+ allowedObjectTypes?: components["schemas"]["QueueAllowedObjectTypeDto"][];
1779
1811
  };
1780
1812
  QueueStatsResponseDto: {
1781
1813
  /** @description Total number of items in the queue. */
@@ -1794,6 +1826,8 @@ interface components {
1794
1826
  UpdateQueueDto: {
1795
1827
  /** @description Human-readable name for the queue. */
1796
1828
  name?: string;
1829
+ /** @description ObjectType IDs this queue accepts for linked items. Empty/omitted = any ObjectType (and untyped items) allowed. */
1830
+ allowedObjectTypeIds?: string[];
1797
1831
  /** @description Description of what the queue is used for. */
1798
1832
  description?: string;
1799
1833
  /** @description Maximum number of retry attempts per item. Defaults to 3. */
@@ -1814,6 +1848,8 @@ interface components {
1814
1848
  CreateQueueItemDto: {
1815
1849
  /** @description External identifier used to deduplicate items within the queue. */
1816
1850
  externalId?: string;
1851
+ /** @description Optional Object (entity) this work item is about. Must belong to the same workspace. If the queue has allowed ObjectTypes configured, the Object type must be one of them. */
1852
+ objectId?: string;
1817
1853
  /** @description Arbitrary JSON payload for the item. Maximum size 64KB. */
1818
1854
  data?: {
1819
1855
  [key: string]: unknown;
@@ -1860,11 +1896,31 @@ interface components {
1860
1896
  /** @description Workflow the execution belongs to. */
1861
1897
  workflow: components["schemas"]["QueueItemExecutionWorkflowDto"];
1862
1898
  };
1899
+ QueueItemObjectTypeSummaryDto: {
1900
+ /** @description Object type ID. */
1901
+ id: string;
1902
+ /** @description Object type name. */
1903
+ name: string;
1904
+ /** @description Object type slug. */
1905
+ slug: string;
1906
+ };
1907
+ QueueItemObjectSummaryDto: {
1908
+ /** @description Object ID. */
1909
+ id: string;
1910
+ /** @description Object display name. */
1911
+ name: string;
1912
+ /** @description Current object state ID. */
1913
+ state: string | null;
1914
+ /** @description Object type summary. */
1915
+ objectType: components["schemas"]["QueueItemObjectTypeSummaryDto"];
1916
+ };
1863
1917
  QueueItemCreateResponseDto: {
1864
1918
  /** @description Queue item ID. */
1865
1919
  id: string;
1866
1920
  /** @description External identifier used for deduplication. */
1867
1921
  externalId: string | null;
1922
+ /** @description Linked Object (entity) ID this work item is about, if any. */
1923
+ objectId: string | null;
1868
1924
  /** @description JSON payload for the item. */
1869
1925
  data: {
1870
1926
  [key: string]: unknown;
@@ -1927,6 +1983,8 @@ interface components {
1927
1983
  queue?: components["schemas"]["QueueItemQueueSummaryDto"];
1928
1984
  /** @description Most recently linked workflow execution. Included when `expansion=lastExecution` is requested. */
1929
1985
  lastExecution?: components["schemas"]["QueueItemLastExecutionDto"] | null;
1986
+ /** @description Linked Object summary. Included when `expansion=object` is requested. */
1987
+ object?: components["schemas"]["QueueItemObjectSummaryDto"] | null;
1930
1988
  /** @description True when an existing item with the same externalId was returned instead of creating a new one. */
1931
1989
  isDuplicate: boolean;
1932
1990
  };
@@ -1947,6 +2005,8 @@ interface components {
1947
2005
  id: string;
1948
2006
  /** @description External identifier used for deduplication. */
1949
2007
  externalId: string | null;
2008
+ /** @description Linked Object (entity) ID this work item is about, if any. */
2009
+ objectId: string | null;
1950
2010
  /** @description JSON payload for the item. */
1951
2011
  data: {
1952
2012
  [key: string]: unknown;
@@ -2009,6 +2069,8 @@ interface components {
2009
2069
  queue?: components["schemas"]["QueueItemQueueSummaryDto"];
2010
2070
  /** @description Most recently linked workflow execution. Included when `expansion=lastExecution` is requested. */
2011
2071
  lastExecution?: components["schemas"]["QueueItemLastExecutionDto"] | null;
2072
+ /** @description Linked Object summary. Included when `expansion=object` is requested. */
2073
+ object?: components["schemas"]["QueueItemObjectSummaryDto"] | null;
2012
2074
  };
2013
2075
  BulkCreateQueueItemsSummaryDto: {
2014
2076
  /** @description Number of items created. */
@@ -2059,6 +2121,8 @@ interface components {
2059
2121
  updatedAt: string;
2060
2122
  /** @description External identifier used for deduplication. */
2061
2123
  externalId: string | null;
2124
+ /** @description Linked Object (entity) ID this work item is about, if any. */
2125
+ FK_objectId: string | null;
2062
2126
  /** @description JSON payload for the item. */
2063
2127
  data: {
2064
2128
  [key: string]: unknown;
@@ -2149,6 +2213,8 @@ interface components {
2149
2213
  UpdateQueueItemDto: {
2150
2214
  /** @description External identifier used to deduplicate items within the queue. */
2151
2215
  externalId?: string;
2216
+ /** @description Optional Object (entity) this work item is about. Must belong to the same workspace. If the queue has allowed ObjectTypes configured, the Object type must be one of them. */
2217
+ objectId?: string;
2152
2218
  /** @description Arbitrary JSON payload for the item. Maximum size 64KB. */
2153
2219
  data?: {
2154
2220
  [key: string]: unknown;
@@ -2314,103 +2380,385 @@ interface components {
2314
2380
  /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
2315
2381
  managedByCode?: boolean;
2316
2382
  };
2317
- WorkflowAppResponseDto: {
2318
- /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
2319
- id: string;
2320
- /** @description Human-readable app name. */
2321
- name: string;
2322
- /** @description App description. */
2323
- description: string;
2324
- /** @description URL of the app logo. */
2325
- logoUrl: string;
2326
- /** @description Whether the app is published and available for use. */
2327
- isPublished: boolean;
2328
- /** @description Whether the app requires a connection before its actions and triggers can run. */
2329
- needsConnection: boolean;
2330
- /** @description Whether the app can be used by agents. */
2331
- availableForAgent: boolean;
2332
- /** @description Action definitions, each with id, name, description, iconUrl, needsConnection, availableForAgent, viewOptions and the declarative inputConfig field metadata used to render action UIs. */
2333
- actions: {
2334
- [key: string]: unknown;
2335
- }[];
2336
- /** @description Trigger definitions, each with id, name, description, iconUrl, needsConnection and the declarative inputConfig field metadata used to render trigger UIs. */
2337
- triggers: {
2338
- [key: string]: unknown;
2339
- }[];
2340
- /** @description Connection type definitions supported by the app (e.g. oauth2, apiKey, basic), each with id, name, description, connectionType and any declarative inputConfig fields. */
2341
- connections: {
2342
- [key: string]: unknown;
2343
- }[];
2344
- };
2345
- ObjectTypeUserSummaryDto: {
2346
- /** @description User ID. */
2347
- id: string;
2348
- /** @description Email address of the user. */
2349
- email: string;
2350
- /** @description Display name of the user. */
2351
- name: string;
2352
- };
2353
- ObjectTypeCreatedByDto: {
2354
- /** @description Workspace user ID. */
2355
- id: string;
2356
- user: components["schemas"]["ObjectTypeUserSummaryDto"];
2357
- };
2358
- ObjectTypeCountDto: {
2359
- /** @description Number of non-deleted entities of this type. */
2360
- objects: number;
2361
- };
2362
- ObjectTypeResponseDto: {
2363
- /** @description Entity type ID. */
2383
+ AgentResponseDto: {
2384
+ /**
2385
+ * @description Agent ID (UUID)
2386
+ * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
2387
+ */
2364
2388
  id: string;
2365
- /** @description Singular display name of the entity type. */
2389
+ /**
2390
+ * @description Agent name
2391
+ * @example Invoice Triage Agent
2392
+ */
2366
2393
  name: string;
2367
- /** @description Plural display name of the entity type. */
2368
- namePlural: string;
2369
- /** @description URL-safe slug, unique within the workspace. */
2370
- slug: string;
2371
- /** @description Icon identifier for the entity type. */
2372
- icon: string;
2373
- /** @description Hex colour of the entity type. */
2374
- color: string;
2375
- /** @description Whether the entity type is enabled. */
2376
- isEnabled: boolean;
2377
- /** @description Description of the entity type. Included when `expansion=description` is requested. */
2394
+ /** @description Stable project-scoped slug for CLI / code deploy upserts. Included when `expansion=slug` is requested. */
2395
+ slug?: string | null;
2396
+ /** @description True when last written by code (CLI / SDK). Included when `expansion=managedByCode` is requested. */
2397
+ managedByCode?: boolean;
2398
+ /** @description ID of the AI provider connection assigned to the agent. Always included. Null when the agent falls back to the workspace default connection. */
2399
+ FK_aiConnectionId: string | null;
2400
+ /** @description Agent description. Included when `expansion=description` is requested. */
2378
2401
  description?: string | null;
2379
- /** @description Field definitions grouped into sections. Included when `expansion=attributeSchema` is requested. */
2380
- attributeSchema?: {
2381
- [key: string]: unknown;
2382
- };
2383
- /** @description State machine definition. Included when `expansion=stateSchema` is requested. */
2384
- stateSchema?: {
2385
- [key: string]: unknown;
2386
- } | null;
2402
+ /** @description Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
2403
+ profileImageUrl?: string | null;
2387
2404
  /**
2388
2405
  * Format: date-time
2389
- * @description Included when `expansion=createdAt` is requested.
2406
+ * @description Creation timestamp. Included when `expansion=createdAt` is requested.
2390
2407
  */
2391
2408
  createdAt?: string;
2392
2409
  /**
2393
2410
  * Format: date-time
2394
- * @description Included when `expansion=updatedAt` is requested.
2411
+ * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
2395
2412
  */
2396
2413
  updatedAt?: string;
2397
- /** @description Workspace member who created the entity type. Included when `expansion=createdBy` is requested. */
2398
- createdBy?: components["schemas"]["ObjectTypeCreatedByDto"];
2399
- /** @description Included when `expansion=countObjects` is requested. */
2400
- _count?: components["schemas"]["ObjectTypeCountDto"];
2401
- };
2402
- CreateObjectDto: {
2403
- /** @description Display name of the entity. */
2404
- name: string;
2414
+ /** @description System instructions authored for the agent. Included when `expansion=instructions` is requested. */
2415
+ instructions?: string | null;
2405
2416
  /**
2406
- * Format: uuid
2407
- * @description ID of the entity type to create the entity under.
2417
+ * @description Model temperature. Included when `expansion=temperature` is requested.
2418
+ * @example 1
2408
2419
  */
2409
- objectTypeId: string;
2410
- /** @description Initial state ID. Must exist in the entity type state schema. Defaults to the schema initial state when omitted. */
2411
- state?: string;
2412
- /** @description Dynamic attribute values keyed by field ID. */
2413
- attributes?: {
2420
+ temperature?: number;
2421
+ /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
2422
+ maxOutputTokens?: number | null;
2423
+ /**
2424
+ * @description Top-p sampling. Included when `expansion=topP` is requested.
2425
+ * @example 1
2426
+ */
2427
+ topP?: number;
2428
+ /**
2429
+ * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
2430
+ * @example 0
2431
+ */
2432
+ frequencyPenalty?: number;
2433
+ /**
2434
+ * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
2435
+ * @example 0
2436
+ */
2437
+ presencePenalty?: number;
2438
+ /**
2439
+ * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
2440
+ * @example 0
2441
+ */
2442
+ maxRetries?: number;
2443
+ /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
2444
+ seed?: number | null;
2445
+ /**
2446
+ * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
2447
+ * @example 5
2448
+ */
2449
+ maxToolRoundtrips?: number;
2450
+ /**
2451
+ * @description How many previous messages are sent to the model. Included when `expansion=messageLookbackLimit` is requested.
2452
+ * @example 40
2453
+ */
2454
+ messageLookbackLimit?: number;
2455
+ /** @description Configured tool nodes (app actions) for the agent. Included when `expansion=tools` is requested. */
2456
+ tools?: {
2457
+ [key: string]: unknown;
2458
+ }[] | null;
2459
+ /** @description Action IDs of the configured tools. Included when `expansion=toolIds` is requested. */
2460
+ toolIds?: string[];
2461
+ /** @description Instructions used when auto-naming new tasks. Included when `expansion=taskNamingInstructions` is requested. */
2462
+ taskNamingInstructions?: string | null;
2463
+ /** @description IDs of enabled provider built-in tools. Included when `expansion=enabledBuiltInTools` is requested. */
2464
+ enabledBuiltInTools?: string[];
2465
+ /** @description IDs of enabled platform tools. Included when `expansion=enabledPlatformTools` is requested. */
2466
+ enabledPlatformTools?: string[];
2467
+ /** @description Whether dynamic workflow-app action discovery is enabled. Included when `expansion=dynamicActionDiscoveryEnabled` is requested. */
2468
+ dynamicActionDiscoveryEnabled?: boolean;
2469
+ /** @description Whether dynamic MCP server discovery is enabled. Included when `expansion=dynamicMcpDiscoveryEnabled` is requested. */
2470
+ dynamicMcpDiscoveryEnabled?: boolean;
2471
+ /** @description Whether the agent maintains its own instructions. Included when `expansion=dynamicSelfInstructionsEnabled` is requested. */
2472
+ dynamicSelfInstructionsEnabled?: boolean;
2473
+ /** @description Whether long-term memory is enabled. Included when `expansion=memoryEnabled` is requested. */
2474
+ memoryEnabled?: boolean;
2475
+ /**
2476
+ * @description Memory partitioning scope. Included when `expansion=memoryScope` is requested.
2477
+ * @enum {string}
2478
+ */
2479
+ memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
2480
+ /**
2481
+ * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
2482
+ * @example 90
2483
+ */
2484
+ memoryRetentionDays?: number;
2485
+ /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
2486
+ suggestedPrompts?: string[];
2487
+ /**
2488
+ * Format: date-time
2489
+ * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
2490
+ */
2491
+ builderSetupCompletedAt?: string | null;
2492
+ /** @description Saved canvas node positions for the agent builder. Included when `expansion=builderCanvasPositions` is requested. */
2493
+ builderCanvasPositions?: {
2494
+ [key: string]: unknown;
2495
+ } | null;
2496
+ /** @description Selected model ID within the AI provider connection. Included when `expansion=selectedModelId` is requested. */
2497
+ selectedModelId?: string | null;
2498
+ /** @description Assigned AI provider connection. Included when `expansion=aiConnection` is requested. */
2499
+ aiConnection?: {
2500
+ id?: string;
2501
+ name?: string;
2502
+ providerConfig?: {
2503
+ id?: string;
2504
+ providerSlug?: string;
2505
+ };
2506
+ } | null;
2507
+ /** @description Knowledge notebooks attached to the agent. Included when `expansion=knowledge` is requested. */
2508
+ agentKnowledge?: {
2509
+ id?: string;
2510
+ knowledge?: {
2511
+ id?: string;
2512
+ name?: string;
2513
+ };
2514
+ }[];
2515
+ /** @description Object types attached to the agent. Included when `expansion=objectTypes` is requested. */
2516
+ agentObjectTypes?: {
2517
+ id?: string;
2518
+ scope?: string;
2519
+ objectType?: {
2520
+ id?: string;
2521
+ name?: string;
2522
+ slug?: string;
2523
+ icon?: string | null;
2524
+ color?: string | null;
2525
+ };
2526
+ }[];
2527
+ /** @description Objects attached to the agent. Included when `expansion=objects` is requested. */
2528
+ agentObjects?: {
2529
+ id?: string;
2530
+ scope?: string;
2531
+ object?: {
2532
+ id?: string;
2533
+ name?: string;
2534
+ state?: string;
2535
+ objectType?: {
2536
+ id?: string;
2537
+ name?: string;
2538
+ slug?: string;
2539
+ icon?: string | null;
2540
+ color?: string | null;
2541
+ };
2542
+ };
2543
+ }[];
2544
+ /** @description App connections available to the agent. Included when `expansion=connections` is requested. */
2545
+ connections?: {
2546
+ id?: string;
2547
+ name?: string;
2548
+ }[];
2549
+ /** @description Variables attached to the agent. Included when `expansion=variables` is requested. */
2550
+ agentVariables?: {
2551
+ id?: string;
2552
+ variable?: {
2553
+ id?: string;
2554
+ name?: string;
2555
+ };
2556
+ }[];
2557
+ /** @description Workflows the agent can trigger. Included when `expansion=workflows` is requested. */
2558
+ agentWorkflows?: {
2559
+ id?: string;
2560
+ workflow?: {
2561
+ id?: string;
2562
+ name?: string;
2563
+ };
2564
+ }[];
2565
+ /** @description Sub-agent links for the agent. Included when `expansion=subAgents` is requested. */
2566
+ agentSubAgents?: {
2567
+ id?: string;
2568
+ subagent?: {
2569
+ id?: string;
2570
+ name?: string;
2571
+ };
2572
+ parentAgent?: {
2573
+ id?: string;
2574
+ name?: string;
2575
+ };
2576
+ }[];
2577
+ /** @description MCP servers attached to the agent, with per-tool overrides. Included when `expansion=mcpServers` is requested. */
2578
+ agentMcpServers?: {
2579
+ id?: string;
2580
+ mcpServer?: {
2581
+ id?: string;
2582
+ slug?: string;
2583
+ name?: string;
2584
+ provider?: string;
2585
+ logoUrl?: string | null;
2586
+ description?: string | null;
2587
+ };
2588
+ toolOverrides?: {
2589
+ id?: string;
2590
+ toolName?: string;
2591
+ enabled?: boolean;
2592
+ requireApproval?: boolean;
2593
+ }[];
2594
+ }[];
2595
+ /** @description A2A (agent-to-agent) endpoints attached to the agent. Included when `expansion=a2aAgents` is requested. */
2596
+ agentA2aAgents?: {
2597
+ id?: string;
2598
+ a2aAgent?: {
2599
+ id?: string;
2600
+ slug?: string;
2601
+ name?: string;
2602
+ logoUrl?: string | null;
2603
+ description?: string | null;
2604
+ authType?: string;
2605
+ };
2606
+ }[];
2607
+ /** @description Web access configuration. Included when `expansion=webAccess` is requested. */
2608
+ agentWebAccess?: {
2609
+ service?: string;
2610
+ webSearchEnabled?: boolean;
2611
+ websiteAccessEnabled?: boolean;
2612
+ } | null;
2613
+ /** @description Phone access configuration. Included when `expansion=phoneAccess` is requested. */
2614
+ agentPhoneAccess?: {
2615
+ service?: string;
2616
+ outboundCallsEnabled?: boolean;
2617
+ inboundCallsEnabled?: boolean;
2618
+ } | null;
2619
+ /** @description Project the agent belongs to. Included when `expansion=project` is requested. */
2620
+ project?: {
2621
+ id?: string;
2622
+ name?: string;
2623
+ };
2624
+ };
2625
+ UpsertAgentToolDto: {
2626
+ /** @description Workflow app id (catalogue slug). */
2627
+ appId: string;
2628
+ /** @description Catalogue action id. */
2629
+ actionId: string;
2630
+ /** @description Connection instance UUID pre-bound on the tool. */
2631
+ connectionId?: string;
2632
+ /** @description Tool display name for the model. */
2633
+ name?: string;
2634
+ /** @description Tool description shown to the model. */
2635
+ description?: string;
2636
+ /** @description Pre-filled tool config (fields left empty are filled by the model). */
2637
+ input?: {
2638
+ [key: string]: unknown;
2639
+ };
2640
+ };
2641
+ UpsertAgentBySlugDto: {
2642
+ /**
2643
+ * @description Stable project-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
2644
+ * @example support-triage
2645
+ */
2646
+ slug: string;
2647
+ /** @description Display name. Defaults to the slug when omitted. */
2648
+ name?: string;
2649
+ description?: string;
2650
+ /** @description System instructions / prompt for the agent. */
2651
+ instructions: string;
2652
+ /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
2653
+ model: string;
2654
+ /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
2655
+ aiConnectionId?: string;
2656
+ /** @description App Connection UUIDs the agent may use for tools. */
2657
+ connectionIds?: string[];
2658
+ /** @description Workflow UUIDs the agent may run (AgentWorkflow links). */
2659
+ workflowIds?: string[];
2660
+ /** @description Catalogue action tools (WorkflowNodeForRunner-shaped). */
2661
+ tools?: components["schemas"]["UpsertAgentToolDto"][];
2662
+ /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
2663
+ managedByCode?: boolean;
2664
+ };
2665
+ WorkflowAppResponseDto: {
2666
+ /** @description App ID, e.g. `gmail`. Matches the appId used in workflow execution steps. */
2667
+ id: string;
2668
+ /** @description Human-readable app name. */
2669
+ name: string;
2670
+ /** @description App description. */
2671
+ description: string;
2672
+ /** @description URL of the app logo. */
2673
+ logoUrl: string;
2674
+ /** @description Whether the app is published and available for use. */
2675
+ isPublished: boolean;
2676
+ /** @description Whether the app requires a connection before its actions and triggers can run. */
2677
+ needsConnection: boolean;
2678
+ /** @description Whether the app can be used by agents. */
2679
+ availableForAgent: boolean;
2680
+ /** @description Action definitions, each with id, name, description, iconUrl, needsConnection, availableForAgent, viewOptions and the declarative inputConfig field metadata used to render action UIs. */
2681
+ actions: {
2682
+ [key: string]: unknown;
2683
+ }[];
2684
+ /** @description Trigger definitions, each with id, name, description, iconUrl, needsConnection and the declarative inputConfig field metadata used to render trigger UIs. */
2685
+ triggers: {
2686
+ [key: string]: unknown;
2687
+ }[];
2688
+ /** @description Connection type definitions supported by the app (e.g. oauth2, apiKey, basic), each with id, name, description, connectionType and any declarative inputConfig fields. */
2689
+ connections: {
2690
+ [key: string]: unknown;
2691
+ }[];
2692
+ };
2693
+ ObjectTypeUserSummaryDto: {
2694
+ /** @description User ID. */
2695
+ id: string;
2696
+ /** @description Email address of the user. */
2697
+ email: string;
2698
+ /** @description Display name of the user. */
2699
+ name: string;
2700
+ };
2701
+ ObjectTypeCreatedByDto: {
2702
+ /** @description Workspace user ID. */
2703
+ id: string;
2704
+ user: components["schemas"]["ObjectTypeUserSummaryDto"];
2705
+ };
2706
+ ObjectTypeCountDto: {
2707
+ /** @description Number of non-deleted entities of this type. */
2708
+ objects: number;
2709
+ };
2710
+ ObjectTypeResponseDto: {
2711
+ /** @description Entity type ID. */
2712
+ id: string;
2713
+ /** @description Singular display name of the entity type. */
2714
+ name: string;
2715
+ /** @description Plural display name of the entity type. */
2716
+ namePlural: string;
2717
+ /** @description URL-safe slug, unique within the workspace. */
2718
+ slug: string;
2719
+ /** @description Icon identifier for the entity type. */
2720
+ icon: string;
2721
+ /** @description Hex colour of the entity type. */
2722
+ color: string;
2723
+ /** @description Whether the entity type is enabled. */
2724
+ isEnabled: boolean;
2725
+ /** @description Description of the entity type. Included when `expansion=description` is requested. */
2726
+ description?: string | null;
2727
+ /** @description Field definitions grouped into sections. Included when `expansion=attributeSchema` is requested. */
2728
+ attributeSchema?: {
2729
+ [key: string]: unknown;
2730
+ };
2731
+ /** @description State machine definition. Included when `expansion=stateSchema` is requested. */
2732
+ stateSchema?: {
2733
+ [key: string]: unknown;
2734
+ } | null;
2735
+ /**
2736
+ * Format: date-time
2737
+ * @description Included when `expansion=createdAt` is requested.
2738
+ */
2739
+ createdAt?: string;
2740
+ /**
2741
+ * Format: date-time
2742
+ * @description Included when `expansion=updatedAt` is requested.
2743
+ */
2744
+ updatedAt?: string;
2745
+ /** @description Workspace member who created the entity type. Included when `expansion=createdBy` is requested. */
2746
+ createdBy?: components["schemas"]["ObjectTypeCreatedByDto"];
2747
+ /** @description Included when `expansion=countObjects` is requested. */
2748
+ _count?: components["schemas"]["ObjectTypeCountDto"];
2749
+ };
2750
+ CreateObjectDto: {
2751
+ /** @description Display name of the entity. */
2752
+ name: string;
2753
+ /**
2754
+ * Format: uuid
2755
+ * @description ID of the entity type to create the entity under.
2756
+ */
2757
+ objectTypeId: string;
2758
+ /** @description Initial state ID. Must exist in the entity type state schema. Defaults to the schema initial state when omitted. */
2759
+ state?: string;
2760
+ /** @description Dynamic attribute values keyed by field ID. */
2761
+ attributes?: {
2414
2762
  [key: string]: unknown;
2415
2763
  };
2416
2764
  /**
@@ -3061,115 +3409,27 @@ interface components {
3061
3409
  /** @description Project ID. */
3062
3410
  id: string;
3063
3411
  /** @description Project name. */
3064
- name: string;
3065
- };
3066
- VariableResponseDto: {
3067
- /** @description Variable ID. */
3068
- id: string;
3069
- /** @description Variable name. */
3070
- name: string;
3071
- /**
3072
- * @description Data type of the variable value.
3073
- * @enum {string}
3074
- */
3075
- dataType: "string" | "number" | "boolean" | "date" | "json";
3076
- /**
3077
- * @description Scope of the variable (system, workspace or project).
3078
- * @enum {string}
3079
- */
3080
- type: "system" | "workspace" | "project";
3081
- /** @description Variable value. Included when `expansion=value` is requested. */
3082
- value?: Record<string, never>;
3083
- /** @description Variable description. Included when `expansion=description` is requested. */
3084
- description?: string;
3085
- /**
3086
- * Format: date-time
3087
- * @description Creation timestamp. Included when `expansion=createdAt` is requested.
3088
- */
3089
- createdAt?: string;
3090
- /**
3091
- * Format: date-time
3092
- * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3093
- */
3094
- updatedAt?: string;
3095
- /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3096
- workspace?: components["schemas"]["VariableWorkspaceDto"];
3097
- /** @description Owning project for project-scoped variables. Included when `expansion=project` is requested. */
3098
- project?: components["schemas"]["VariableProjectDto"];
3099
- };
3100
- UpdateVariableDto: {
3101
- /** @description Name of the variable. */
3102
- name?: string;
3103
- /** @description Description of the variable. */
3104
- description?: string;
3105
- /**
3106
- * @description Scope of the variable (system, workspace or project).
3107
- * @enum {string}
3108
- */
3109
- type?: "system" | "workspace" | "project";
3110
- /**
3111
- * @description Data type of the variable value.
3112
- * @enum {string}
3113
- */
3114
- dataType?: "string" | "number" | "boolean" | "date" | "json";
3115
- /** @description Project ID to scope the variable to. Must belong to the current workspace. */
3116
- projectId?: string;
3117
- /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
3118
- value?: string;
3119
- };
3120
- ConnectionWorkspaceDto: {
3121
- /** @description Workspace ID. */
3122
- id: string;
3123
- /** @description Workspace name. */
3124
- name: string;
3125
- };
3126
- ConnectionResponseDto: {
3127
- /** @description Connection ID. */
3128
- id: string;
3129
- /** @description Connection name. */
3130
- name: string;
3131
- /**
3132
- * Format: date-time
3133
- * @description Creation timestamp. Included when `expansion=createdAt` is requested.
3134
- */
3135
- createdAt?: string;
3136
- /**
3137
- * Format: date-time
3138
- * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3139
- */
3140
- updatedAt?: string;
3141
- /** @description App connection type ID (e.g. the OAuth2 or API key connection definition of the app). Included when `expansion=connectionId` is requested. */
3142
- connectionId?: string;
3143
- /** @description ID of the workflow app this connection belongs to. Included when `expansion=workflowAppId` or `expansion=workflowApp` is requested. */
3144
- workflowAppId?: string;
3145
- /** @description Full workflow app definition for this connection. Included when `expansion=workflowApp` is requested on the list endpoint. */
3146
- workflowApp?: {
3147
- [key: string]: unknown;
3148
- };
3149
- /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3150
- workspace?: components["schemas"]["ConnectionWorkspaceDto"];
3412
+ name: string;
3151
3413
  };
3152
- AgentResponseDto: {
3414
+ VariableResponseDto: {
3415
+ /** @description Variable ID. */
3416
+ id: string;
3417
+ /** @description Variable name. */
3418
+ name: string;
3153
3419
  /**
3154
- * @description Agent ID (UUID)
3155
- * @example 4f7c9d2e-8a1b-4c3d-9e5f-6a7b8c9d0e1f
3420
+ * @description Data type of the variable value.
3421
+ * @enum {string}
3156
3422
  */
3157
- id: string;
3423
+ dataType: "string" | "number" | "boolean" | "date" | "json";
3158
3424
  /**
3159
- * @description Agent name
3160
- * @example Invoice Triage Agent
3425
+ * @description Scope of the variable (system, workspace or project).
3426
+ * @enum {string}
3161
3427
  */
3162
- name: string;
3163
- /** @description Stable project-scoped slug for CLI / code deploy upserts. Included when `expansion=slug` is requested. */
3164
- slug?: string | null;
3165
- /** @description True when last written by code (CLI / SDK). Included when `expansion=managedByCode` is requested. */
3166
- managedByCode?: boolean;
3167
- /** @description ID of the AI provider connection assigned to the agent. Always included. Null when the agent falls back to the workspace default connection. */
3168
- FK_aiConnectionId: string | null;
3169
- /** @description Agent description. Included when `expansion=description` is requested. */
3170
- description?: string | null;
3171
- /** @description Public URL of the agent profile image. Included when `expansion=profileImageUrl` is requested. */
3172
- profileImageUrl?: string | null;
3428
+ type: "system" | "workspace" | "project";
3429
+ /** @description Variable value. Included when `expansion=value` is requested. */
3430
+ value?: Record<string, never>;
3431
+ /** @description Variable description. Included when `expansion=description` is requested. */
3432
+ description?: string;
3173
3433
  /**
3174
3434
  * Format: date-time
3175
3435
  * @description Creation timestamp. Included when `expansion=createdAt` is requested.
@@ -3180,256 +3440,62 @@ interface components {
3180
3440
  * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3181
3441
  */
3182
3442
  updatedAt?: string;
3183
- /** @description System instructions authored for the agent. Included when `expansion=instructions` is requested. */
3184
- instructions?: string | null;
3185
- /**
3186
- * @description Model temperature. Included when `expansion=temperature` is requested.
3187
- * @example 1
3188
- */
3189
- temperature?: number;
3190
- /** @description Maximum output tokens per turn. Included when `expansion=maxOutputTokens` is requested. */
3191
- maxOutputTokens?: number | null;
3192
- /**
3193
- * @description Top-p sampling. Included when `expansion=topP` is requested.
3194
- * @example 1
3195
- */
3196
- topP?: number;
3197
- /**
3198
- * @description Frequency penalty. Included when `expansion=frequencyPenalty` is requested.
3199
- * @example 0
3200
- */
3201
- frequencyPenalty?: number;
3202
- /**
3203
- * @description Presence penalty. Included when `expansion=presencePenalty` is requested.
3204
- * @example 0
3205
- */
3206
- presencePenalty?: number;
3207
- /**
3208
- * @description Maximum retries for a failed model call. Included when `expansion=maxRetries` is requested.
3209
- * @example 0
3210
- */
3211
- maxRetries?: number;
3212
- /** @description Fixed sampling seed. Included when `expansion=seed` is requested. */
3213
- seed?: number | null;
3214
- /**
3215
- * @description Maximum tool roundtrips per turn. Included when `expansion=maxToolRoundtrips` is requested.
3216
- * @example 5
3217
- */
3218
- maxToolRoundtrips?: number;
3219
- /**
3220
- * @description How many previous messages are sent to the model. Included when `expansion=messageLookbackLimit` is requested.
3221
- * @example 40
3222
- */
3223
- messageLookbackLimit?: number;
3224
- /** @description Configured tool nodes (app actions) for the agent. Included when `expansion=tools` is requested. */
3225
- tools?: {
3226
- [key: string]: unknown;
3227
- }[] | null;
3228
- /** @description Action IDs of the configured tools. Included when `expansion=toolIds` is requested. */
3229
- toolIds?: string[];
3230
- /** @description Instructions used when auto-naming new tasks. Included when `expansion=taskNamingInstructions` is requested. */
3231
- taskNamingInstructions?: string | null;
3232
- /** @description IDs of enabled provider built-in tools. Included when `expansion=enabledBuiltInTools` is requested. */
3233
- enabledBuiltInTools?: string[];
3234
- /** @description IDs of enabled platform tools. Included when `expansion=enabledPlatformTools` is requested. */
3235
- enabledPlatformTools?: string[];
3236
- /** @description Whether dynamic workflow-app action discovery is enabled. Included when `expansion=dynamicActionDiscoveryEnabled` is requested. */
3237
- dynamicActionDiscoveryEnabled?: boolean;
3238
- /** @description Whether dynamic MCP server discovery is enabled. Included when `expansion=dynamicMcpDiscoveryEnabled` is requested. */
3239
- dynamicMcpDiscoveryEnabled?: boolean;
3240
- /** @description Whether the agent maintains its own instructions. Included when `expansion=dynamicSelfInstructionsEnabled` is requested. */
3241
- dynamicSelfInstructionsEnabled?: boolean;
3242
- /** @description Whether long-term memory is enabled. Included when `expansion=memoryEnabled` is requested. */
3243
- memoryEnabled?: boolean;
3443
+ /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3444
+ workspace?: components["schemas"]["VariableWorkspaceDto"];
3445
+ /** @description Owning project for project-scoped variables. Included when `expansion=project` is requested. */
3446
+ project?: components["schemas"]["VariableProjectDto"];
3447
+ };
3448
+ UpdateVariableDto: {
3449
+ /** @description Name of the variable. */
3450
+ name?: string;
3451
+ /** @description Description of the variable. */
3452
+ description?: string;
3244
3453
  /**
3245
- * @description Memory partitioning scope. Included when `expansion=memoryScope` is requested.
3454
+ * @description Scope of the variable (system, workspace or project).
3246
3455
  * @enum {string}
3247
3456
  */
3248
- memoryScope?: "PER_USER" | "PER_AGENT" | "PER_USER_PER_AGENT";
3249
- /**
3250
- * @description Days memories are retained. Included when `expansion=memoryRetentionDays` is requested.
3251
- * @example 90
3252
- */
3253
- memoryRetentionDays?: number;
3254
- /** @description Suggested prompts shown to users starting a conversation. Included when `expansion=suggestedPrompts` is requested. */
3255
- suggestedPrompts?: string[];
3457
+ type?: "system" | "workspace" | "project";
3256
3458
  /**
3257
- * Format: date-time
3258
- * @description When the first-time builder setup wizard was completed. Included when `expansion=builderSetupCompletedAt` is requested.
3459
+ * @description Data type of the variable value.
3460
+ * @enum {string}
3259
3461
  */
3260
- builderSetupCompletedAt?: string | null;
3261
- /** @description Saved canvas node positions for the agent builder. Included when `expansion=builderCanvasPositions` is requested. */
3262
- builderCanvasPositions?: {
3263
- [key: string]: unknown;
3264
- } | null;
3265
- /** @description Selected model ID within the AI provider connection. Included when `expansion=selectedModelId` is requested. */
3266
- selectedModelId?: string | null;
3267
- /** @description Assigned AI provider connection. Included when `expansion=aiConnection` is requested. */
3268
- aiConnection?: {
3269
- id?: string;
3270
- name?: string;
3271
- providerConfig?: {
3272
- id?: string;
3273
- providerSlug?: string;
3274
- };
3275
- } | null;
3276
- /** @description Knowledge notebooks attached to the agent. Included when `expansion=knowledge` is requested. */
3277
- agentKnowledge?: {
3278
- id?: string;
3279
- knowledge?: {
3280
- id?: string;
3281
- name?: string;
3282
- };
3283
- }[];
3284
- /** @description Object types attached to the agent. Included when `expansion=objectTypes` is requested. */
3285
- agentObjectTypes?: {
3286
- id?: string;
3287
- scope?: string;
3288
- objectType?: {
3289
- id?: string;
3290
- name?: string;
3291
- slug?: string;
3292
- icon?: string | null;
3293
- color?: string | null;
3294
- };
3295
- }[];
3296
- /** @description Objects attached to the agent. Included when `expansion=objects` is requested. */
3297
- agentObjects?: {
3298
- id?: string;
3299
- scope?: string;
3300
- object?: {
3301
- id?: string;
3302
- name?: string;
3303
- state?: string;
3304
- objectType?: {
3305
- id?: string;
3306
- name?: string;
3307
- slug?: string;
3308
- icon?: string | null;
3309
- color?: string | null;
3310
- };
3311
- };
3312
- }[];
3313
- /** @description App connections available to the agent. Included when `expansion=connections` is requested. */
3314
- connections?: {
3315
- id?: string;
3316
- name?: string;
3317
- }[];
3318
- /** @description Variables attached to the agent. Included when `expansion=variables` is requested. */
3319
- agentVariables?: {
3320
- id?: string;
3321
- variable?: {
3322
- id?: string;
3323
- name?: string;
3324
- };
3325
- }[];
3326
- /** @description Workflows the agent can trigger. Included when `expansion=workflows` is requested. */
3327
- agentWorkflows?: {
3328
- id?: string;
3329
- workflow?: {
3330
- id?: string;
3331
- name?: string;
3332
- };
3333
- }[];
3334
- /** @description Sub-agent links for the agent. Included when `expansion=subAgents` is requested. */
3335
- agentSubAgents?: {
3336
- id?: string;
3337
- subagent?: {
3338
- id?: string;
3339
- name?: string;
3340
- };
3341
- parentAgent?: {
3342
- id?: string;
3343
- name?: string;
3344
- };
3345
- }[];
3346
- /** @description MCP servers attached to the agent, with per-tool overrides. Included when `expansion=mcpServers` is requested. */
3347
- agentMcpServers?: {
3348
- id?: string;
3349
- mcpServer?: {
3350
- id?: string;
3351
- slug?: string;
3352
- name?: string;
3353
- provider?: string;
3354
- logoUrl?: string | null;
3355
- description?: string | null;
3356
- };
3357
- toolOverrides?: {
3358
- id?: string;
3359
- toolName?: string;
3360
- enabled?: boolean;
3361
- requireApproval?: boolean;
3362
- }[];
3363
- }[];
3364
- /** @description A2A (agent-to-agent) endpoints attached to the agent. Included when `expansion=a2aAgents` is requested. */
3365
- agentA2aAgents?: {
3366
- id?: string;
3367
- a2aAgent?: {
3368
- id?: string;
3369
- slug?: string;
3370
- name?: string;
3371
- logoUrl?: string | null;
3372
- description?: string | null;
3373
- authType?: string;
3374
- };
3375
- }[];
3376
- /** @description Web access configuration. Included when `expansion=webAccess` is requested. */
3377
- agentWebAccess?: {
3378
- service?: string;
3379
- webSearchEnabled?: boolean;
3380
- websiteAccessEnabled?: boolean;
3381
- } | null;
3382
- /** @description Phone access configuration. Included when `expansion=phoneAccess` is requested. */
3383
- agentPhoneAccess?: {
3384
- service?: string;
3385
- outboundCallsEnabled?: boolean;
3386
- inboundCallsEnabled?: boolean;
3387
- } | null;
3388
- /** @description Project the agent belongs to. Included when `expansion=project` is requested. */
3389
- project?: {
3390
- id?: string;
3391
- name?: string;
3392
- };
3462
+ dataType?: "string" | "number" | "boolean" | "date" | "json";
3463
+ /** @description Project ID to scope the variable to. Must belong to the current workspace. */
3464
+ projectId?: string;
3465
+ /** @description Variable value, submitted as a string. Values with dataType `number` are converted to numbers on save. */
3466
+ value?: string;
3393
3467
  };
3394
- UpsertAgentToolDto: {
3395
- /** @description Workflow app id (catalogue slug). */
3396
- appId: string;
3397
- /** @description Catalogue action id. */
3398
- actionId: string;
3399
- /** @description Connection instance UUID pre-bound on the tool. */
3400
- connectionId?: string;
3401
- /** @description Tool display name for the model. */
3402
- name?: string;
3403
- /** @description Tool description shown to the model. */
3404
- description?: string;
3405
- /** @description Pre-filled tool config (fields left empty are filled by the model). */
3406
- input?: {
3407
- [key: string]: unknown;
3408
- };
3468
+ ConnectionWorkspaceDto: {
3469
+ /** @description Workspace ID. */
3470
+ id: string;
3471
+ /** @description Workspace name. */
3472
+ name: string;
3409
3473
  };
3410
- UpsertAgentBySlugDto: {
3474
+ ConnectionResponseDto: {
3475
+ /** @description Connection ID. */
3476
+ id: string;
3477
+ /** @description Connection name. */
3478
+ name: string;
3411
3479
  /**
3412
- * @description Stable project-scoped slug (lowercase, digits, hyphens). Used as the upsert key.
3413
- * @example support-triage
3480
+ * Format: date-time
3481
+ * @description Creation timestamp. Included when `expansion=createdAt` is requested.
3414
3482
  */
3415
- slug: string;
3416
- /** @description Display name. Defaults to the slug when omitted. */
3417
- name?: string;
3418
- description?: string;
3419
- /** @description System instructions / prompt for the agent. */
3420
- instructions: string;
3421
- /** @description Selected model id on the AI provider connection (e.g. `gpt-4o`). */
3422
- model: string;
3423
- /** @description AiProviderConnection UUID. When omitted, platform AI defaults apply. */
3424
- aiConnectionId?: string;
3425
- /** @description App Connection UUIDs the agent may use for tools. */
3426
- connectionIds?: string[];
3427
- /** @description Workflow UUIDs the agent may run (AgentWorkflow links). */
3428
- workflowIds?: string[];
3429
- /** @description Catalogue action tools (WorkflowNodeForRunner-shaped). */
3430
- tools?: components["schemas"]["UpsertAgentToolDto"][];
3431
- /** @description Marks the row as managed by code (CLI / SDK). Defaults to true on this endpoint. */
3432
- managedByCode?: boolean;
3483
+ createdAt?: string;
3484
+ /**
3485
+ * Format: date-time
3486
+ * @description Last update timestamp. Included when `expansion=updatedAt` is requested.
3487
+ */
3488
+ updatedAt?: string;
3489
+ /** @description App connection type ID (e.g. the OAuth2 or API key connection definition of the app). Included when `expansion=connectionId` is requested. */
3490
+ connectionId?: string;
3491
+ /** @description ID of the workflow app this connection belongs to. Included when `expansion=workflowAppId` or `expansion=workflowApp` is requested. */
3492
+ workflowAppId?: string;
3493
+ /** @description Full workflow app definition for this connection. Included when `expansion=workflowApp` is requested on the list endpoint. */
3494
+ workflowApp?: {
3495
+ [key: string]: unknown;
3496
+ };
3497
+ /** @description Owning workspace. Included when `expansion=workspace` is requested. */
3498
+ workspace?: components["schemas"]["ConnectionWorkspaceDto"];
3433
3499
  };
3434
3500
  TaskListItemResponseDto: {
3435
3501
  /**
@@ -3974,9 +4040,9 @@ interface operations {
3974
4040
  limit?: number;
3975
4041
  /** @description Number of items to skip for pagination. */
3976
4042
  offset?: number;
3977
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4043
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
3978
4044
  expansion?: string;
3979
- /** @description Comma-separated key:value filter pairs. Available keys: status, externalId, priority, scheduledFor, search, createdAfter, createdBefore. */
4045
+ /** @description Comma-separated key:value filter pairs. Available keys: status, externalId, objectId, priority, scheduledFor, search, createdAfter, createdBefore. */
3980
4046
  filterBy?: string;
3981
4047
  };
3982
4048
  header?: never;
@@ -4001,7 +4067,7 @@ interface operations {
4001
4067
  QueueItemsController_create: {
4002
4068
  parameters: {
4003
4069
  query?: {
4004
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4070
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4005
4071
  expansion?: string;
4006
4072
  };
4007
4073
  header?: never;
@@ -4030,7 +4096,7 @@ interface operations {
4030
4096
  QueueItemsController_bulkCreate: {
4031
4097
  parameters: {
4032
4098
  query?: {
4033
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4099
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4034
4100
  expansion?: string;
4035
4101
  };
4036
4102
  header?: never;
@@ -4085,7 +4151,7 @@ interface operations {
4085
4151
  QueueItemsController_bulkUpdate: {
4086
4152
  parameters: {
4087
4153
  query?: {
4088
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4154
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4089
4155
  expansion?: string;
4090
4156
  };
4091
4157
  header?: never;
@@ -4195,7 +4261,7 @@ interface operations {
4195
4261
  QueueItemsController_findByExternalId: {
4196
4262
  parameters: {
4197
4263
  query?: {
4198
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4264
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4199
4265
  expansion?: string;
4200
4266
  };
4201
4267
  header?: never;
@@ -4225,9 +4291,9 @@ interface operations {
4225
4291
  limit?: number;
4226
4292
  /** @description Number of items to skip for pagination. */
4227
4293
  offset?: number;
4228
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4294
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4229
4295
  expansion?: string;
4230
- /** @description Comma-separated key:value filter pairs. Available keys: status, externalId, priority, scheduledFor, search, createdAfter, createdBefore. */
4296
+ /** @description Comma-separated key:value filter pairs. Available keys: status, externalId, objectId, priority, scheduledFor, search, createdAfter, createdBefore. */
4231
4297
  filterBy?: string;
4232
4298
  };
4233
4299
  header?: never;
@@ -4274,7 +4340,7 @@ interface operations {
4274
4340
  QueueItemsController_findOne: {
4275
4341
  parameters: {
4276
4342
  query?: {
4277
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4343
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4278
4344
  expansion?: string;
4279
4345
  };
4280
4346
  header?: never;
@@ -4323,7 +4389,7 @@ interface operations {
4323
4389
  QueueItemsController_update: {
4324
4390
  parameters: {
4325
4391
  query?: {
4326
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4392
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4327
4393
  expansion?: string;
4328
4394
  };
4329
4395
  header?: never;
@@ -4376,7 +4442,7 @@ interface operations {
4376
4442
  QueueItemsController_updateStatus: {
4377
4443
  parameters: {
4378
4444
  query?: {
4379
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4445
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4380
4446
  expansion?: string;
4381
4447
  };
4382
4448
  header?: never;
@@ -4406,7 +4472,7 @@ interface operations {
4406
4472
  QueueItemsController_linkExecution: {
4407
4473
  parameters: {
4408
4474
  query?: {
4409
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4475
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4410
4476
  expansion?: string;
4411
4477
  };
4412
4478
  header?: never;
@@ -4436,7 +4502,7 @@ interface operations {
4436
4502
  QueueItemsController_retryItem: {
4437
4503
  parameters: {
4438
4504
  query?: {
4439
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4505
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4440
4506
  expansion?: string;
4441
4507
  };
4442
4508
  header?: never;
@@ -4462,7 +4528,7 @@ interface operations {
4462
4528
  QueueItemsController_addError: {
4463
4529
  parameters: {
4464
4530
  query?: {
4465
- /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4531
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Note: createdAt also expands the other timestamp fields (nextRetryAt, processingStartedAt, processingCompletedAt, lastErrorAt, scheduledFor). */
4466
4532
  expansion?: string;
4467
4533
  };
4468
4534
  header?: never;
@@ -4489,6 +4555,38 @@ interface operations {
4489
4555
  };
4490
4556
  };
4491
4557
  };
4558
+ ObjectQueueItemsController_listForObject: {
4559
+ parameters: {
4560
+ query?: {
4561
+ /** @description Optional status filter */
4562
+ status?: "PENDING" | "PROCESSING" | "SUCCESS" | "FAILED" | "RETRYING";
4563
+ /** @description Maximum number of items to return. */
4564
+ limit?: number;
4565
+ /** @description Number of items to skip for pagination. */
4566
+ offset?: number;
4567
+ /** @description Comma-separated fields to expand. Available: createdAt, updatedAt, queue, lastExecution, errorHistory, object. Defaults include queue and object. */
4568
+ expansion?: string;
4569
+ };
4570
+ header?: never;
4571
+ path: {
4572
+ /** @description Object (entity) ID */
4573
+ objectId: string;
4574
+ };
4575
+ cookie?: never;
4576
+ };
4577
+ requestBody?: never;
4578
+ responses: {
4579
+ /** @description Queue items linked to the Object. */
4580
+ 200: {
4581
+ headers: {
4582
+ [name: string]: unknown;
4583
+ };
4584
+ content: {
4585
+ "application/json": components["schemas"]["QueueItemListResponseDto"];
4586
+ };
4587
+ };
4588
+ };
4589
+ };
4492
4590
  WorkflowsController_findAllForWorkspace: {
4493
4591
  parameters: {
4494
4592
  query?: {
@@ -4567,6 +4665,84 @@ interface operations {
4567
4665
  };
4568
4666
  };
4569
4667
  };
4668
+ AgentsController_findAllForWorkspace: {
4669
+ parameters: {
4670
+ query?: {
4671
+ /** @description Comma-separated include flags, e.g. `includeType=all`. Available: all */
4672
+ includeType?: string;
4673
+ /** @description Filters in `key:value` format, comma-separated, e.g. `filterBy=projectId:<uuid>`. Available: projectId */
4674
+ filterBy?: string;
4675
+ /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
4676
+ expansion?: string;
4677
+ };
4678
+ header?: never;
4679
+ path?: never;
4680
+ cookie?: never;
4681
+ };
4682
+ requestBody?: never;
4683
+ responses: {
4684
+ /** @description Agents in the current workspace */
4685
+ 200: {
4686
+ headers: {
4687
+ [name: string]: unknown;
4688
+ };
4689
+ content: {
4690
+ "application/json": components["schemas"]["AgentResponseDto"][];
4691
+ };
4692
+ };
4693
+ };
4694
+ };
4695
+ AgentsController_findOne: {
4696
+ parameters: {
4697
+ query?: {
4698
+ /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
4699
+ expansion?: string;
4700
+ };
4701
+ header?: never;
4702
+ path: {
4703
+ agentId: string;
4704
+ };
4705
+ cookie?: never;
4706
+ };
4707
+ requestBody?: never;
4708
+ responses: {
4709
+ /** @description The requested agent */
4710
+ 200: {
4711
+ headers: {
4712
+ [name: string]: unknown;
4713
+ };
4714
+ content: {
4715
+ "application/json": components["schemas"]["AgentResponseDto"];
4716
+ };
4717
+ };
4718
+ };
4719
+ };
4720
+ ProjectAgentsController_upsertBySlug: {
4721
+ parameters: {
4722
+ query?: never;
4723
+ header?: never;
4724
+ path: {
4725
+ projectId: string;
4726
+ };
4727
+ cookie?: never;
4728
+ };
4729
+ requestBody: {
4730
+ content: {
4731
+ "application/json": components["schemas"]["UpsertAgentBySlugDto"];
4732
+ };
4733
+ };
4734
+ responses: {
4735
+ /** @description The created or updated agent. */
4736
+ 200: {
4737
+ headers: {
4738
+ [name: string]: unknown;
4739
+ };
4740
+ content: {
4741
+ "application/json": components["schemas"]["AgentResponseDto"];
4742
+ };
4743
+ };
4744
+ };
4745
+ };
4570
4746
  WorkflowAppsController_findAll: {
4571
4747
  parameters: {
4572
4748
  query?: never;
@@ -5336,11 +5512,14 @@ interface operations {
5336
5512
  };
5337
5513
  requestBody?: never;
5338
5514
  responses: {
5515
+ /** @description SSE stream of execution progress, loop progress, finished, and heartbeat events */
5339
5516
  200: {
5340
5517
  headers: {
5341
5518
  [name: string]: unknown;
5342
5519
  };
5343
- content?: never;
5520
+ content: {
5521
+ "text/event-stream": string;
5522
+ };
5344
5523
  };
5345
5524
  };
5346
5525
  };
@@ -5689,84 +5868,6 @@ interface operations {
5689
5868
  };
5690
5869
  };
5691
5870
  };
5692
- AgentsController_findAllForWorkspace: {
5693
- parameters: {
5694
- query?: {
5695
- /** @description Comma-separated include flags, e.g. `includeType=all`. Available: all */
5696
- includeType?: string;
5697
- /** @description Filters in `key:value` format, comma-separated, e.g. `filterBy=projectId:<uuid>`. Available: projectId */
5698
- filterBy?: string;
5699
- /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
5700
- expansion?: string;
5701
- };
5702
- header?: never;
5703
- path?: never;
5704
- cookie?: never;
5705
- };
5706
- requestBody?: never;
5707
- responses: {
5708
- /** @description Agents in the current workspace */
5709
- 200: {
5710
- headers: {
5711
- [name: string]: unknown;
5712
- };
5713
- content: {
5714
- "application/json": components["schemas"]["AgentResponseDto"][];
5715
- };
5716
- };
5717
- };
5718
- };
5719
- AgentsController_findOne: {
5720
- parameters: {
5721
- query?: {
5722
- /** @description Comma-separated fields to expand, e.g. `expansion=description,createdAt`. Available: createdAt, updatedAt, description, profileImageUrl, instructions, temperature, maxOutputTokens, topP, frequencyPenalty, presencePenalty, maxRetries, seed, maxToolRoundtrips, messageLookbackLimit, project, tools, toolIds, knowledge, objects, objectTypes, connections, variables, workflows, subAgents, webAccess, phoneAccess, aiConnection, selectedModelId, taskNamingInstructions, enabledBuiltInTools, enabledPlatformTools, mcpServers, a2aAgents, dynamicActionDiscoveryEnabled, dynamicMcpDiscoveryEnabled, dynamicSelfInstructionsEnabled, memoryEnabled, memoryScope, memoryRetentionDays, suggestedPrompts, builderSetupCompletedAt, builderCanvasPositions, slug, managedByCode */
5723
- expansion?: string;
5724
- };
5725
- header?: never;
5726
- path: {
5727
- agentId: string;
5728
- };
5729
- cookie?: never;
5730
- };
5731
- requestBody?: never;
5732
- responses: {
5733
- /** @description The requested agent */
5734
- 200: {
5735
- headers: {
5736
- [name: string]: unknown;
5737
- };
5738
- content: {
5739
- "application/json": components["schemas"]["AgentResponseDto"];
5740
- };
5741
- };
5742
- };
5743
- };
5744
- ProjectAgentsController_upsertBySlug: {
5745
- parameters: {
5746
- query?: never;
5747
- header?: never;
5748
- path: {
5749
- projectId: string;
5750
- };
5751
- cookie?: never;
5752
- };
5753
- requestBody: {
5754
- content: {
5755
- "application/json": components["schemas"]["UpsertAgentBySlugDto"];
5756
- };
5757
- };
5758
- responses: {
5759
- /** @description The created or updated agent. */
5760
- 200: {
5761
- headers: {
5762
- [name: string]: unknown;
5763
- };
5764
- content: {
5765
- "application/json": components["schemas"]["AgentResponseDto"];
5766
- };
5767
- };
5768
- };
5769
- };
5770
5871
  TasksController_findAllForWorkspace: {
5771
5872
  parameters: {
5772
5873
  query?: {
@@ -6067,8 +6168,10 @@ type Queue = Schemas['QueueResponseDto'];
6067
6168
  type CreateQueueInput = Schemas['CreateQueueDto'];
6068
6169
  type UpdateQueueInput = Schemas['UpdateQueueDto'];
6069
6170
  type QueueStats = Schemas['QueueStatsResponseDto'];
6171
+ type QueueAllowedObjectType = Schemas['QueueAllowedObjectTypeDto'];
6070
6172
  type QueueItem = Schemas['QueueItemResponseDto'];
6071
6173
  type QueueItemFull = Schemas['QueueItemFullResponseDto'];
6174
+ type QueueItemCreated = Schemas['QueueItemCreateResponseDto'];
6072
6175
  type CreateQueueItemInput = Schemas['CreateQueueItemDto'];
6073
6176
  type UpdateQueueItemInput = Schemas['UpdateQueueItemDto'];
6074
6177
  type QueueItemList = Schemas['QueueItemListResponseDto'];
@@ -6076,6 +6179,7 @@ type QueueItemStats = Schemas['QueueItemStatsResponseDto'];
6076
6179
  type BulkCreateQueueItemsInput = Schemas['BulkCreateQueueItemsDto'];
6077
6180
  type BulkCreateQueueItemsResult = Schemas['BulkCreateQueueItemsResponseDto'];
6078
6181
  type QueueItemErrorEntry = Schemas['QueueItemErrorEntryResponseDto'];
6182
+ type QueueItemObjectSummary = Schemas['QueueItemObjectSummaryDto'];
6079
6183
  type Variable = Schemas['VariableResponseDto'];
6080
6184
  type CreateVariableInput = Schemas['CreateVariableDto'];
6081
6185
  type UpdateVariableInput = Schemas['UpdateVariableDto'];
@@ -6819,8 +6923,15 @@ interface ListQueueItemsOptions {
6819
6923
  limit?: number;
6820
6924
  offset?: number;
6821
6925
  expansion?: string | string[];
6926
+ /** Supports keys including `status`, `externalId`, `objectId`, `priority`. */
6822
6927
  filterBy?: string | Record<string, string>;
6823
6928
  }
6929
+ interface ListQueueItemsByObjectOptions {
6930
+ status?: string;
6931
+ limit?: number;
6932
+ offset?: number;
6933
+ expansion?: string | string[];
6934
+ }
6824
6935
  declare class QueueItemsResource {
6825
6936
  private readonly http;
6826
6937
  constructor(http: HttpClient);
@@ -6830,8 +6941,15 @@ declare class QueueItemsResource {
6830
6941
  iterate(queueId: string, options?: Omit<ListQueueItemsOptions, 'offset'>): AsyncGenerator<QueueItem, void, undefined>;
6831
6942
  /** Returns a single queue item. */
6832
6943
  get(queueId: string, itemId: string): Promise<QueueItemFull>;
6833
- /** Adds an item to a queue. */
6834
- create(queueId: string, data: CreateQueueItemInput): Promise<QueueItem>;
6944
+ /** Adds an item to a queue. Pass `objectId` to link the item to an entity. */
6945
+ create(queueId: string, data: CreateQueueItemInput): Promise<QueueItemCreated>;
6946
+ /**
6947
+ * Lists queue items linked to an Object across all queues in the workspace.
6948
+ * Use for Object detail "Work" panels.
6949
+ */
6950
+ listByObject(objectId: string, options?: ListQueueItemsByObjectOptions): Promise<QueueItemList>;
6951
+ /** Async-iterates every queue item linked to an Object. */
6952
+ iterateByObject(objectId: string, options?: Omit<ListQueueItemsByObjectOptions, 'offset'>): AsyncGenerator<QueueItem, void, undefined>;
6835
6953
  /** Adds many items to a queue in one call. */
6836
6954
  bulkCreate(queueId: string, data: BulkCreateQueueItemsInput): Promise<BulkCreateQueueItemsResult>;
6837
6955
  /** Updates a queue item. */
@@ -7208,4 +7326,4 @@ interface CreateServerClientOptions {
7208
7326
  */
7209
7327
  declare function createServerClient(options: CreateServerClientOptions): LunnoaClient;
7210
7328
 
7211
- export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnectionDefinition, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateProjectInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type Project, ProjectsResource, type QueryValue, type Queue, type QueueItem, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemStats, QueueItemsResource, type QueueStats, QueuesResource, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Task, type TaskListItem, TasksResource, type TokenStore, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineWorkflow, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, resolveActionAppId, resolveActionId };
7329
+ export { API_KEY_PREFIX, type ActionDefinition, ActionsResource, type Agent, AgentChatClient, AgentChatStream, type AgentDefinition, type AgentToolDefinition, AgentsResource, type AiConnectionDefinition, type ApprovalInboxItem, ApprovalsResource, AuthResource, type AuthTokens, type BulkCreateQueueItemsInput, type BulkCreateQueueItemsResult, type ChangeEntityStateInput, type ChangeEntityStateResult, type ChatMode, type Connection, type ConnectionDefinition, ConnectionsResource, type CreateBrowserClientOptions, type CreateEntityInput, type CreateKnowledgeInput, type CreateProjectInput, type CreateQueueInput, type CreateQueueItemInput, type CreateServerClientOptions, type CreateTaskInput, type CreateVariableInput, type CurrentUser, DEFINE_KINDS, type DefineKind, type DeletedTask, DiscoveryResource, type EligibleApprover, type EnabledFeatures, EntitiesResource, type Entity, type EntityStateHistoryEntry, type EntityStateTransitions, type EntityType, type EntityTypeReadOptions, EntityTypesResource, type ExecuteWorkflowResult, type Execution, type ExecutionPathStep, type ExecutionProgress, type ExecutionProgressPayload, type ExecutionProgressStep, ExecutionProgressStream, type ExecutionStatus, type ExecutionStreamEvent, type ExecutionStreamEventType, ExecutionTimeoutError, ExecutionsResource, type ExportEntitiesInput, type FetchLike, HttpClient, type ImportEntitiesInput, type ImportEntitiesResult, type ImportTemplate, type Knowledge, type KnowledgeDocument, type KnowledgeDocumentGroup, KnowledgeResource, type ListEntitiesOptions, type ListQueryOptions, type ListQueueItemsByObjectOptions, type ListQueueItemsOptions, type LocalStorageTokenStoreOptions, type LoginRequires2FA, type LoginResult, type LoginSuccess, LunnoaApiError, LunnoaClient, type LunnoaClientOptions, type MessageTaskInput, type OffsetPagination, type PagePagination, type PaginatedEntities, type PendingInput, type PendingInputField, type Project, ProjectsResource, type QueryValue, type Queue, type QueueAllowedObjectType, type QueueItem, type QueueItemCreated, type QueueItemErrorEntry, type QueueItemFull, type QueueItemList, type QueueItemObjectSummary, type QueueItemStats, QueueItemsResource, type QueueStats, QueuesResource, type RequestOptions, type RunActionInput, type RunActionOptions, type RunActionResult, RunsResource, type SaveUploadedTextInput, type SseEvent, SsoAuthResource, type SsoProviderSummary, type SsoProvidersResponse, type StartRunInput, type StartRunInputDto, type StartRunOptions, type StartRunStep, type StopStreamOptions, type StreamMessageOptions, type Task, type TaskListItem, TasksResource, type TokenStore, type UpdateEntityInput, type UpdateKnowledgeInput, type UpdateQueueInput, type UpdateQueueItemInput, type UpdateTaskInput, type UpdateVariableInput, type UpsertAgentBySlugInput, type UpsertAgentBySlugInputDto, type UpsertAgentToolInput, type UpsertWorkflowBySlugInput, type UpsertWorkflowBySlugInputDto, type UpsertWorkflowStepInput, type Variable, VariablesResource, type WaitUntilFinishedOptions, type WatchProgressOptions, type Workflow, type WorkflowApp, WorkflowAppsResource, type WorkflowDefinition, type WorkflowStepDefinition, WorkflowsResource, assertApiKeyAllowedInEnvironment, type components, createBrowserClient, createLocalStorageTokenStore, createMemoryTokenStore, createServerClient, defineAction, defineAgent, defineAiConnection, defineConnection, defineWorkflow, isBrowserEnvironment, isLoginRequires2FA, iterateOffset, iteratePages, type operations, parseSseEvents, parseSseStream, type paths, resolveActionAppId, resolveActionId };