@archastro/sdk 0.9.0 → 0.11.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.
Files changed (102) hide show
  1. package/dist/client.d.ts +14 -0
  2. package/dist/client.d.ts.map +1 -1
  3. package/dist/client.js +15 -1
  4. package/dist/client.js.map +1 -1
  5. package/dist/types/ai.d.ts +2 -2
  6. package/dist/types/chat.d.ts +111 -50
  7. package/dist/types/chat.d.ts.map +1 -1
  8. package/dist/types/common.d.ts +1096 -468
  9. package/dist/types/common.d.ts.map +1 -1
  10. package/dist/types/common.js +155 -62
  11. package/dist/types/common.js.map +1 -1
  12. package/dist/types/extractions.d.ts +36 -0
  13. package/dist/types/extractions.d.ts.map +1 -1
  14. package/dist/types/index.d.ts +2 -0
  15. package/dist/types/index.d.ts.map +1 -1
  16. package/dist/types/index.js +3 -1
  17. package/dist/types/index.js.map +1 -1
  18. package/dist/types/status.d.ts +121 -0
  19. package/dist/types/status.d.ts.map +1 -0
  20. package/dist/types/status.js +18 -0
  21. package/dist/types/status.js.map +1 -0
  22. package/dist/types/tasks.d.ts +601 -0
  23. package/dist/types/tasks.d.ts.map +1 -0
  24. package/dist/types/tasks.js +118 -0
  25. package/dist/types/tasks.js.map +1 -0
  26. package/dist/types/threads.d.ts +542 -5
  27. package/dist/types/threads.d.ts.map +1 -1
  28. package/dist/types/threads.js +45 -2
  29. package/dist/types/threads.js.map +1 -1
  30. package/dist/v1/resources/activity_feed.d.ts +1 -1
  31. package/dist/v1/resources/activity_feed.js +2 -2
  32. package/dist/v1/resources/agents.d.ts +2 -2
  33. package/dist/v1/resources/agents.js +3 -3
  34. package/dist/v1/resources/custom_objects.d.ts +86 -20
  35. package/dist/v1/resources/custom_objects.d.ts.map +1 -1
  36. package/dist/v1/resources/custom_objects.js +41 -19
  37. package/dist/v1/resources/custom_objects.js.map +1 -1
  38. package/dist/v1/resources/files.d.ts +19 -0
  39. package/dist/v1/resources/files.d.ts.map +1 -1
  40. package/dist/v1/resources/files.js +3 -1
  41. package/dist/v1/resources/files.js.map +1 -1
  42. package/dist/v1/resources/index.d.ts +7 -0
  43. package/dist/v1/resources/index.d.ts.map +1 -1
  44. package/dist/v1/resources/index.js +8 -1
  45. package/dist/v1/resources/index.js.map +1 -1
  46. package/dist/v1/resources/private_service_definitions.d.ts +12 -0
  47. package/dist/v1/resources/private_service_definitions.d.ts.map +1 -0
  48. package/dist/v1/resources/private_service_definitions.js +18 -0
  49. package/dist/v1/resources/private_service_definitions.js.map +1 -0
  50. package/dist/v1/resources/private_service_enrollments.d.ts +42 -0
  51. package/dist/v1/resources/private_service_enrollments.d.ts.map +1 -0
  52. package/dist/v1/resources/private_service_enrollments.js +56 -0
  53. package/dist/v1/resources/private_service_enrollments.js.map +1 -0
  54. package/dist/v1/resources/private_services.d.ts +46 -0
  55. package/dist/v1/resources/private_services.d.ts.map +1 -0
  56. package/dist/v1/resources/private_services.js +55 -0
  57. package/dist/v1/resources/private_services.js.map +1 -0
  58. package/dist/v1/resources/sandboxes.d.ts +81 -0
  59. package/dist/v1/resources/sandboxes.d.ts.map +1 -0
  60. package/dist/v1/resources/sandboxes.js +84 -0
  61. package/dist/v1/resources/sandboxes.js.map +1 -0
  62. package/dist/v1/resources/slack_channel_bindings.d.ts +37 -0
  63. package/dist/v1/resources/slack_channel_bindings.d.ts.map +1 -1
  64. package/dist/v1/resources/slack_channel_bindings.js +31 -1
  65. package/dist/v1/resources/slack_channel_bindings.js.map +1 -1
  66. package/dist/v1/resources/solutions.d.ts +2 -0
  67. package/dist/v1/resources/solutions.d.ts.map +1 -1
  68. package/dist/v1/resources/solutions.js +2 -1
  69. package/dist/v1/resources/solutions.js.map +1 -1
  70. package/dist/v1/resources/status.d.ts +22 -0
  71. package/dist/v1/resources/status.d.ts.map +1 -0
  72. package/dist/v1/resources/status.js +27 -0
  73. package/dist/v1/resources/status.js.map +1 -0
  74. package/dist/v1/resources/tasks.d.ts +599 -0
  75. package/dist/v1/resources/tasks.d.ts.map +1 -0
  76. package/dist/v1/resources/tasks.js +436 -0
  77. package/dist/v1/resources/tasks.js.map +1 -0
  78. package/dist/v1/resources/teams.d.ts +463 -0
  79. package/dist/v1/resources/teams.d.ts.map +1 -1
  80. package/dist/v1/resources/teams.js +281 -1
  81. package/dist/v1/resources/teams.js.map +1 -1
  82. package/dist/v1/resources/thread_messages.d.ts +25 -3
  83. package/dist/v1/resources/thread_messages.d.ts.map +1 -1
  84. package/dist/v1/resources/thread_messages.js +25 -4
  85. package/dist/v1/resources/thread_messages.js.map +1 -1
  86. package/dist/v1/resources/threads.d.ts +40 -0
  87. package/dist/v1/resources/threads.d.ts.map +1 -1
  88. package/dist/v1/resources/threads.js +36 -1
  89. package/dist/v1/resources/threads.js.map +1 -1
  90. package/dist/v1/resources/trajectories.d.ts +34 -0
  91. package/dist/v1/resources/trajectories.d.ts.map +1 -0
  92. package/dist/v1/resources/trajectories.js +41 -0
  93. package/dist/v1/resources/trajectories.js.map +1 -0
  94. package/dist/v1/resources/users.d.ts +353 -0
  95. package/dist/v1/resources/users.d.ts.map +1 -1
  96. package/dist/v1/resources/users.js +208 -1
  97. package/dist/v1/resources/users.js.map +1 -1
  98. package/dist/v1.d.ts +14 -0
  99. package/dist/v1.d.ts.map +1 -1
  100. package/dist/v1.js +22 -1
  101. package/dist/v1.js.map +1 -1
  102. package/package.json +1 -1
@@ -5688,6 +5688,8 @@ export interface Message {
5688
5688
  reply_count?: number | undefined;
5689
5689
  /** The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded. */
5690
5690
  reply_to?: Record<string, unknown> | undefined;
5691
+ /** ID of the root message in this reply chain (`msg_...`). `null` for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages. */
5692
+ root_message_id?: string | null | undefined;
5691
5693
  /** ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages. */
5692
5694
  sandbox?: string | undefined;
5693
5695
  /** ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped. */
@@ -6141,6 +6143,8 @@ export declare const messageSchema: z.ZodObject<{
6141
6143
  reply_count: z.ZodOptional<z.ZodNumber>;
6142
6144
  /** The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded. */
6143
6145
  reply_to: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6146
+ /** ID of the root message in this reply chain (`msg_...`). `null` for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages. */
6147
+ root_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
6144
6148
  /** ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages. */
6145
6149
  sandbox: z.ZodOptional<z.ZodString>;
6146
6150
  /** ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped. */
@@ -6261,6 +6265,7 @@ export declare const messageSchema: z.ZodObject<{
6261
6265
  replies_before_cursor?: string | undefined;
6262
6266
  reply_count?: number | undefined;
6263
6267
  reply_to?: Record<string, unknown> | undefined;
6268
+ root_message_id?: string | null | undefined;
6264
6269
  }, {
6265
6270
  id: string;
6266
6271
  content?: string | undefined;
@@ -6369,6 +6374,7 @@ export declare const messageSchema: z.ZodObject<{
6369
6374
  replies_before_cursor?: string | undefined;
6370
6375
  reply_count?: number | undefined;
6371
6376
  reply_to?: Record<string, unknown> | undefined;
6377
+ root_message_id?: string | null | undefined;
6372
6378
  }>;
6373
6379
  /** The result of executing a shell command on an agent's computer environment. Contains the captured output and the process exit code. */
6374
6380
  export interface ComputerExecResult {
@@ -6642,8 +6648,45 @@ export declare const contextIngestionSchema: z.ZodObject<{
6642
6648
  completed_at?: string | undefined;
6643
6649
  started_at?: string | undefined;
6644
6650
  }>;
6651
+ /**
6652
+ * Creation-only private service enrollment response. The raw token is shown
6653
+ * once and is omitted from every read schema.
6654
+ */
6655
+ export interface CreatedPrivateServiceEnrollment {
6656
+ /** One-time connector enrollment token. Store it immediately. */
6657
+ enrollment_token: string;
6658
+ /** When the one-time enrollment token expires. */
6659
+ enrollment_token_expires_at: string;
6660
+ generation: number;
6661
+ id: string;
6662
+ private_service: string;
6663
+ }
6664
+ /** Runtime validator for {@link CreatedPrivateServiceEnrollment}. */
6665
+ export declare const createdPrivateServiceEnrollmentSchema: z.ZodObject<{
6666
+ /** One-time connector enrollment token. Store it immediately. */
6667
+ enrollment_token: z.ZodString;
6668
+ /** When the one-time enrollment token expires. */
6669
+ enrollment_token_expires_at: z.ZodString;
6670
+ generation: z.ZodNumber;
6671
+ id: z.ZodString;
6672
+ private_service: z.ZodString;
6673
+ }, "strip", z.ZodTypeAny, {
6674
+ id: string;
6675
+ enrollment_token: string;
6676
+ enrollment_token_expires_at: string;
6677
+ generation: number;
6678
+ private_service: string;
6679
+ }, {
6680
+ id: string;
6681
+ enrollment_token: string;
6682
+ enrollment_token_expires_at: string;
6683
+ generation: number;
6684
+ private_service: string;
6685
+ }>;
6645
6686
  /** A custom object belonging to an organization. Custom objects store arbitrary structured data defined by a schema type and are scoped to an org, team, or user. */
6646
6687
  export interface CustomObject {
6688
+ /** Access control list governing read and write access to this custom object. Only returned to resource owners and privileged or organization-admin viewers; `null` for everyone else. */
6689
+ acl?: Acl | undefined;
6647
6690
  /** When the custom object was created (ISO 8601). */
6648
6691
  created_at?: string | undefined;
6649
6692
  /** Map of field names to their current values as defined by the object's schema type. */
@@ -6669,6 +6712,86 @@ export interface CustomObject {
6669
6712
  }
6670
6713
  /** Runtime validator for {@link CustomObject}. */
6671
6714
  export declare const customObjectSchema: z.ZodObject<{
6715
+ /** Access control list governing read and write access to this custom object. Only returned to resource owners and privileged or organization-admin viewers; `null` for everyone else. */
6716
+ acl: z.ZodOptional<z.ZodObject<{
6717
+ /** Patch mode: grants to add or merge into the existing list. Cannot be combined with `grants`. */
6718
+ add: z.ZodOptional<z.ZodArray<z.ZodObject<{
6719
+ /** Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry. */
6720
+ actions: z.ZodArray<z.ZodString, "many">;
6721
+ /** The identifier of the principal. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`; omit entirely when `principal_type` is `"everyone"`. */
6722
+ principal: z.ZodOptional<z.ZodString>;
6723
+ /** The kind of principal receiving the grant. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`. */
6724
+ principal_type: z.ZodString;
6725
+ }, "strip", z.ZodTypeAny, {
6726
+ actions: string[];
6727
+ principal_type: string;
6728
+ principal?: string | undefined;
6729
+ }, {
6730
+ actions: string[];
6731
+ principal_type: string;
6732
+ principal?: string | undefined;
6733
+ }>, "many">>;
6734
+ /** Replace mode: the complete new list of grants that replaces all existing entries. Send an empty array (`[]`) to clear all grants. Cannot be combined with `add` or `remove`. */
6735
+ grants: z.ZodOptional<z.ZodArray<z.ZodObject<{
6736
+ /** Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry. */
6737
+ actions: z.ZodArray<z.ZodString, "many">;
6738
+ /** The identifier of the principal. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`; omit entirely when `principal_type` is `"everyone"`. */
6739
+ principal: z.ZodOptional<z.ZodString>;
6740
+ /** The kind of principal receiving the grant. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`. */
6741
+ principal_type: z.ZodString;
6742
+ }, "strip", z.ZodTypeAny, {
6743
+ actions: string[];
6744
+ principal_type: string;
6745
+ principal?: string | undefined;
6746
+ }, {
6747
+ actions: string[];
6748
+ principal_type: string;
6749
+ principal?: string | undefined;
6750
+ }>, "many">>;
6751
+ /** Patch mode: principals whose grants should be removed from the existing list. Cannot be combined with `grants`. */
6752
+ remove: z.ZodOptional<z.ZodArray<z.ZodObject<{
6753
+ /** The identifier of the principal to remove. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`. Omit when `principal_type` is `"everyone"`. */
6754
+ principal: z.ZodOptional<z.ZodString>;
6755
+ /** The kind of principal to remove. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`. */
6756
+ principal_type: z.ZodString;
6757
+ }, "strip", z.ZodTypeAny, {
6758
+ principal_type: string;
6759
+ principal?: string | undefined;
6760
+ }, {
6761
+ principal_type: string;
6762
+ principal?: string | undefined;
6763
+ }>, "many">>;
6764
+ }, "strip", z.ZodTypeAny, {
6765
+ add?: {
6766
+ actions: string[];
6767
+ principal_type: string;
6768
+ principal?: string | undefined;
6769
+ }[] | undefined;
6770
+ grants?: {
6771
+ actions: string[];
6772
+ principal_type: string;
6773
+ principal?: string | undefined;
6774
+ }[] | undefined;
6775
+ remove?: {
6776
+ principal_type: string;
6777
+ principal?: string | undefined;
6778
+ }[] | undefined;
6779
+ }, {
6780
+ add?: {
6781
+ actions: string[];
6782
+ principal_type: string;
6783
+ principal?: string | undefined;
6784
+ }[] | undefined;
6785
+ grants?: {
6786
+ actions: string[];
6787
+ principal_type: string;
6788
+ principal?: string | undefined;
6789
+ }[] | undefined;
6790
+ remove?: {
6791
+ principal_type: string;
6792
+ principal?: string | undefined;
6793
+ }[] | undefined;
6794
+ }>>;
6672
6795
  /** When the custom object was created (ISO 8601). */
6673
6796
  created_at: z.ZodOptional<z.ZodString>;
6674
6797
  /** Map of field names to their current values as defined by the object's schema type. */
@@ -6699,6 +6822,22 @@ export declare const customObjectSchema: z.ZodObject<{
6699
6822
  updated_at?: string | undefined;
6700
6823
  user?: string | undefined;
6701
6824
  sandbox?: string | undefined;
6825
+ acl?: {
6826
+ add?: {
6827
+ actions: string[];
6828
+ principal_type: string;
6829
+ principal?: string | undefined;
6830
+ }[] | undefined;
6831
+ grants?: {
6832
+ actions: string[];
6833
+ principal_type: string;
6834
+ principal?: string | undefined;
6835
+ }[] | undefined;
6836
+ remove?: {
6837
+ principal_type: string;
6838
+ principal?: string | undefined;
6839
+ }[] | undefined;
6840
+ } | undefined;
6702
6841
  version?: number | undefined;
6703
6842
  fields?: Record<string, unknown> | undefined;
6704
6843
  row_key?: string | undefined;
@@ -6711,6 +6850,22 @@ export declare const customObjectSchema: z.ZodObject<{
6711
6850
  updated_at?: string | undefined;
6712
6851
  user?: string | undefined;
6713
6852
  sandbox?: string | undefined;
6853
+ acl?: {
6854
+ add?: {
6855
+ actions: string[];
6856
+ principal_type: string;
6857
+ principal?: string | undefined;
6858
+ }[] | undefined;
6859
+ grants?: {
6860
+ actions: string[];
6861
+ principal_type: string;
6862
+ principal?: string | undefined;
6863
+ }[] | undefined;
6864
+ remove?: {
6865
+ principal_type: string;
6866
+ principal?: string | undefined;
6867
+ }[] | undefined;
6868
+ } | undefined;
6714
6869
  version?: number | undefined;
6715
6870
  fields?: Record<string, unknown> | undefined;
6716
6871
  row_key?: string | undefined;
@@ -6775,6 +6930,86 @@ export interface CustomObjectListResponse {
6775
6930
  export declare const customObjectListResponseSchema: z.ZodObject<{
6776
6931
  /** Array of custom objects for the current page. */
6777
6932
  data: z.ZodArray<z.ZodObject<{
6933
+ /** Access control list governing read and write access to this custom object. Only returned to resource owners and privileged or organization-admin viewers; `null` for everyone else. */
6934
+ acl: z.ZodOptional<z.ZodObject<{
6935
+ /** Patch mode: grants to add or merge into the existing list. Cannot be combined with `grants`. */
6936
+ add: z.ZodOptional<z.ZodArray<z.ZodObject<{
6937
+ /** Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry. */
6938
+ actions: z.ZodArray<z.ZodString, "many">;
6939
+ /** The identifier of the principal. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`; omit entirely when `principal_type` is `"everyone"`. */
6940
+ principal: z.ZodOptional<z.ZodString>;
6941
+ /** The kind of principal receiving the grant. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`. */
6942
+ principal_type: z.ZodString;
6943
+ }, "strip", z.ZodTypeAny, {
6944
+ actions: string[];
6945
+ principal_type: string;
6946
+ principal?: string | undefined;
6947
+ }, {
6948
+ actions: string[];
6949
+ principal_type: string;
6950
+ principal?: string | undefined;
6951
+ }>, "many">>;
6952
+ /** Replace mode: the complete new list of grants that replaces all existing entries. Send an empty array (`[]`) to clear all grants. Cannot be combined with `add` or `remove`. */
6953
+ grants: z.ZodOptional<z.ZodArray<z.ZodObject<{
6954
+ /** Array of action strings the principal is permitted to perform, e.g. `["read", "write"]`. Must contain at least one entry. */
6955
+ actions: z.ZodArray<z.ZodString, "many">;
6956
+ /** The identifier of the principal. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`; omit entirely when `principal_type` is `"everyone"`. */
6957
+ principal: z.ZodOptional<z.ZodString>;
6958
+ /** The kind of principal receiving the grant. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`. */
6959
+ principal_type: z.ZodString;
6960
+ }, "strip", z.ZodTypeAny, {
6961
+ actions: string[];
6962
+ principal_type: string;
6963
+ principal?: string | undefined;
6964
+ }, {
6965
+ actions: string[];
6966
+ principal_type: string;
6967
+ principal?: string | undefined;
6968
+ }>, "many">>;
6969
+ /** Patch mode: principals whose grants should be removed from the existing list. Cannot be combined with `grants`. */
6970
+ remove: z.ZodOptional<z.ZodArray<z.ZodObject<{
6971
+ /** The identifier of the principal to remove. A string ID for `"user"`, `"team"`, `"org"`, and `"agent"` types; one of `"admin"`, `"member"`, or `"viewer"` for `"org_role"`. Omit when `principal_type` is `"everyone"`. */
6972
+ principal: z.ZodOptional<z.ZodString>;
6973
+ /** The kind of principal to remove. One of `"user"`, `"team"`, `"org"`, `"org_role"`, `"agent"`, or `"everyone"`. */
6974
+ principal_type: z.ZodString;
6975
+ }, "strip", z.ZodTypeAny, {
6976
+ principal_type: string;
6977
+ principal?: string | undefined;
6978
+ }, {
6979
+ principal_type: string;
6980
+ principal?: string | undefined;
6981
+ }>, "many">>;
6982
+ }, "strip", z.ZodTypeAny, {
6983
+ add?: {
6984
+ actions: string[];
6985
+ principal_type: string;
6986
+ principal?: string | undefined;
6987
+ }[] | undefined;
6988
+ grants?: {
6989
+ actions: string[];
6990
+ principal_type: string;
6991
+ principal?: string | undefined;
6992
+ }[] | undefined;
6993
+ remove?: {
6994
+ principal_type: string;
6995
+ principal?: string | undefined;
6996
+ }[] | undefined;
6997
+ }, {
6998
+ add?: {
6999
+ actions: string[];
7000
+ principal_type: string;
7001
+ principal?: string | undefined;
7002
+ }[] | undefined;
7003
+ grants?: {
7004
+ actions: string[];
7005
+ principal_type: string;
7006
+ principal?: string | undefined;
7007
+ }[] | undefined;
7008
+ remove?: {
7009
+ principal_type: string;
7010
+ principal?: string | undefined;
7011
+ }[] | undefined;
7012
+ }>>;
6778
7013
  /** When the custom object was created (ISO 8601). */
6779
7014
  created_at: z.ZodOptional<z.ZodString>;
6780
7015
  /** Map of field names to their current values as defined by the object's schema type. */
@@ -6805,6 +7040,22 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
6805
7040
  updated_at?: string | undefined;
6806
7041
  user?: string | undefined;
6807
7042
  sandbox?: string | undefined;
7043
+ acl?: {
7044
+ add?: {
7045
+ actions: string[];
7046
+ principal_type: string;
7047
+ principal?: string | undefined;
7048
+ }[] | undefined;
7049
+ grants?: {
7050
+ actions: string[];
7051
+ principal_type: string;
7052
+ principal?: string | undefined;
7053
+ }[] | undefined;
7054
+ remove?: {
7055
+ principal_type: string;
7056
+ principal?: string | undefined;
7057
+ }[] | undefined;
7058
+ } | undefined;
6808
7059
  version?: number | undefined;
6809
7060
  fields?: Record<string, unknown> | undefined;
6810
7061
  row_key?: string | undefined;
@@ -6817,6 +7068,22 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
6817
7068
  updated_at?: string | undefined;
6818
7069
  user?: string | undefined;
6819
7070
  sandbox?: string | undefined;
7071
+ acl?: {
7072
+ add?: {
7073
+ actions: string[];
7074
+ principal_type: string;
7075
+ principal?: string | undefined;
7076
+ }[] | undefined;
7077
+ grants?: {
7078
+ actions: string[];
7079
+ principal_type: string;
7080
+ principal?: string | undefined;
7081
+ }[] | undefined;
7082
+ remove?: {
7083
+ principal_type: string;
7084
+ principal?: string | undefined;
7085
+ }[] | undefined;
7086
+ } | undefined;
6820
7087
  version?: number | undefined;
6821
7088
  fields?: Record<string, unknown> | undefined;
6822
7089
  row_key?: string | undefined;
@@ -6843,6 +7110,22 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
6843
7110
  updated_at?: string | undefined;
6844
7111
  user?: string | undefined;
6845
7112
  sandbox?: string | undefined;
7113
+ acl?: {
7114
+ add?: {
7115
+ actions: string[];
7116
+ principal_type: string;
7117
+ principal?: string | undefined;
7118
+ }[] | undefined;
7119
+ grants?: {
7120
+ actions: string[];
7121
+ principal_type: string;
7122
+ principal?: string | undefined;
7123
+ }[] | undefined;
7124
+ remove?: {
7125
+ principal_type: string;
7126
+ principal?: string | undefined;
7127
+ }[] | undefined;
7128
+ } | undefined;
6846
7129
  version?: number | undefined;
6847
7130
  fields?: Record<string, unknown> | undefined;
6848
7131
  row_key?: string | undefined;
@@ -6863,6 +7146,22 @@ export declare const customObjectListResponseSchema: z.ZodObject<{
6863
7146
  updated_at?: string | undefined;
6864
7147
  user?: string | undefined;
6865
7148
  sandbox?: string | undefined;
7149
+ acl?: {
7150
+ add?: {
7151
+ actions: string[];
7152
+ principal_type: string;
7153
+ principal?: string | undefined;
7154
+ }[] | undefined;
7155
+ grants?: {
7156
+ actions: string[];
7157
+ principal_type: string;
7158
+ principal?: string | undefined;
7159
+ }[] | undefined;
7160
+ remove?: {
7161
+ principal_type: string;
7162
+ principal?: string | undefined;
7163
+ }[] | undefined;
7164
+ } | undefined;
6866
7165
  version?: number | undefined;
6867
7166
  fields?: Record<string, unknown> | undefined;
6868
7167
  row_key?: string | undefined;
@@ -6929,8 +7228,30 @@ export declare const customObjectUpdateFieldsResponseSchema: z.ZodObject<{
6929
7228
  fields: Record<string, unknown>;
6930
7229
  operation_id: string;
6931
7230
  }>;
7231
+ /** Deployment metadata. */
7232
+ export interface Deployment {
7233
+ /** Deployment environment, or `null` when it is not configured. */
7234
+ environment?: string | null | undefined;
7235
+ /** Opaque SHA-256 fingerprint of the image reference, or `null` in local development. */
7236
+ release?: string | null | undefined;
7237
+ }
7238
+ /** Runtime validator for {@link Deployment}. */
7239
+ export declare const deploymentSchema: z.ZodObject<{
7240
+ /** Deployment environment, or `null` when it is not configured. */
7241
+ environment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
7242
+ /** Opaque SHA-256 fingerprint of the image reference, or `null` in local development. */
7243
+ release: z.ZodOptional<z.ZodNullable<z.ZodString>>;
7244
+ }, "strip", z.ZodTypeAny, {
7245
+ environment?: string | null | undefined;
7246
+ release?: string | null | undefined;
7247
+ }, {
7248
+ environment?: string | null | undefined;
7249
+ release?: string | null | undefined;
7250
+ }>;
6932
7251
  /** A file stored in the platform's object storage, with metadata and a signed URL for downloading its contents. */
6933
7252
  export interface StorageFile {
7253
+ /** ID of the app this file belongs to (`app_...`). */
7254
+ app?: string | undefined;
6934
7255
  /** MIME type of the file, e.g. `"image/png"` or `"application/pdf"`. */
6935
7256
  content_type?: string | undefined;
6936
7257
  /** When the file was uploaded (ISO 8601). */
@@ -6949,13 +7270,19 @@ export interface StorageFile {
6949
7270
  share_url?: string | undefined;
6950
7271
  /** Size of the file in bytes. */
6951
7272
  size?: number | undefined;
7273
+ /** ID of the team that owns this file (`team_...`). `null` if not team-owned. */
7274
+ team?: string | undefined;
6952
7275
  /** When the file record was last modified (ISO 8601). */
6953
7276
  updated_at?: string | undefined;
6954
7277
  /** Short-lived signed URL for downloading the file. `null` if a URL could not be generated. */
6955
7278
  url?: string | undefined;
7279
+ /** ID of the user that owns this file (`user_...`). `null` if not user-owned. */
7280
+ user?: string | undefined;
6956
7281
  }
6957
7282
  /** Runtime validator for {@link StorageFile}. */
6958
7283
  export declare const storageFileSchema: z.ZodObject<{
7284
+ /** ID of the app this file belongs to (`app_...`). */
7285
+ app: z.ZodOptional<z.ZodString>;
6959
7286
  /** MIME type of the file, e.g. `"image/png"` or `"application/pdf"`. */
6960
7287
  content_type: z.ZodOptional<z.ZodString>;
6961
7288
  /** When the file was uploaded (ISO 8601). */
@@ -6998,15 +7325,22 @@ export declare const storageFileSchema: z.ZodObject<{
6998
7325
  share_url: z.ZodOptional<z.ZodString>;
6999
7326
  /** Size of the file in bytes. */
7000
7327
  size: z.ZodOptional<z.ZodNumber>;
7328
+ /** ID of the team that owns this file (`team_...`). `null` if not team-owned. */
7329
+ team: z.ZodOptional<z.ZodString>;
7001
7330
  /** When the file record was last modified (ISO 8601). */
7002
7331
  updated_at: z.ZodOptional<z.ZodString>;
7003
7332
  /** Short-lived signed URL for downloading the file. `null` if a URL could not be generated. */
7004
7333
  url: z.ZodOptional<z.ZodString>;
7334
+ /** ID of the user that owns this file (`user_...`). `null` if not user-owned. */
7335
+ user: z.ZodOptional<z.ZodString>;
7005
7336
  }, "strip", z.ZodTypeAny, {
7006
7337
  id: string;
7338
+ team?: string | undefined;
7007
7339
  org?: string | undefined;
7340
+ app?: string | undefined;
7008
7341
  created_at?: string | undefined;
7009
7342
  updated_at?: string | undefined;
7343
+ user?: string | undefined;
7010
7344
  sandbox?: string | undefined;
7011
7345
  url?: string | undefined;
7012
7346
  content_type?: string | undefined;
@@ -7024,9 +7358,12 @@ export declare const storageFileSchema: z.ZodObject<{
7024
7358
  size?: number | undefined;
7025
7359
  }, {
7026
7360
  id: string;
7361
+ team?: string | undefined;
7027
7362
  org?: string | undefined;
7363
+ app?: string | undefined;
7028
7364
  created_at?: string | undefined;
7029
7365
  updated_at?: string | undefined;
7366
+ user?: string | undefined;
7030
7367
  sandbox?: string | undefined;
7031
7368
  url?: string | undefined;
7032
7369
  content_type?: string | undefined;
@@ -8546,6 +8883,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
8546
8883
  reply_count: z.ZodOptional<z.ZodNumber>;
8547
8884
  /** The parent message this message is a reply to, expanded as a full message object when loaded. `null` if this is a top-level message or the association is not preloaded. */
8548
8885
  reply_to: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
8886
+ /** ID of the root message in this reply chain (`msg_...`). `null` for a top-level message. The value is persisted when the reply is created, so callers can correlate a multi-turn session without walking parent messages. */
8887
+ root_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
8549
8888
  /** ID of the developer sandbox this message belongs to (`dsb_...`). `null` for non-sandbox messages. */
8550
8889
  sandbox: z.ZodOptional<z.ZodString>;
8551
8890
  /** ID of the team this message is scoped to (`tem_...`). `null` if the message is not team-scoped. */
@@ -8666,6 +9005,7 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
8666
9005
  replies_before_cursor?: string | undefined;
8667
9006
  reply_count?: number | undefined;
8668
9007
  reply_to?: Record<string, unknown> | undefined;
9008
+ root_message_id?: string | null | undefined;
8669
9009
  }, {
8670
9010
  id: string;
8671
9011
  content?: string | undefined;
@@ -8774,6 +9114,7 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
8774
9114
  replies_before_cursor?: string | undefined;
8775
9115
  reply_count?: number | undefined;
8776
9116
  reply_to?: Record<string, unknown> | undefined;
9117
+ root_message_id?: string | null | undefined;
8777
9118
  }>, "many">;
8778
9119
  /** Total number of replies in the thread across all pages. */
8779
9120
  total_count: z.ZodOptional<z.ZodNumber>;
@@ -8886,125 +9227,388 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
8886
9227
  replies_before_cursor?: string | undefined;
8887
9228
  reply_count?: number | undefined;
8888
9229
  reply_to?: Record<string, unknown> | undefined;
9230
+ root_message_id?: string | null | undefined;
9231
+ }[];
9232
+ before_cursor?: string | undefined;
9233
+ after_cursor?: string | undefined;
9234
+ has_more?: boolean | undefined;
9235
+ total_count?: number | undefined;
9236
+ }, {
9237
+ replies: {
9238
+ id: string;
9239
+ content?: string | undefined;
9240
+ agent?: string | undefined;
9241
+ thread?: string | undefined;
9242
+ team?: string | undefined;
9243
+ org?: string | undefined;
9244
+ type?: string | undefined;
9245
+ created_at?: string | undefined;
9246
+ user?: string | undefined;
9247
+ sandbox?: string | undefined;
9248
+ metadata?: Record<string, unknown> | undefined;
9249
+ acl?: {
9250
+ add?: {
9251
+ actions: string[];
9252
+ principal_type: string;
9253
+ principal?: string | undefined;
9254
+ }[] | undefined;
9255
+ grants?: {
9256
+ actions: string[];
9257
+ principal_type: string;
9258
+ principal?: string | undefined;
9259
+ }[] | undefined;
9260
+ remove?: {
9261
+ principal_type: string;
9262
+ principal?: string | undefined;
9263
+ }[] | undefined;
9264
+ } | undefined;
9265
+ attachments?: {
9266
+ type: string;
9267
+ id: string;
9268
+ object?: Record<string, unknown> | undefined;
9269
+ description?: string | undefined;
9270
+ name?: string | undefined;
9271
+ height?: number | undefined;
9272
+ url?: string | undefined;
9273
+ width?: number | undefined;
9274
+ image_url?: string | undefined;
9275
+ title?: string | undefined;
9276
+ content_type?: string | undefined;
9277
+ filename?: string | undefined;
9278
+ image_source?: {
9279
+ mime_type?: string | undefined;
9280
+ file?: string | undefined;
9281
+ height?: number | undefined;
9282
+ media?: string | undefined;
9283
+ refresh_url?: string | undefined;
9284
+ url?: string | undefined;
9285
+ width?: number | undefined;
9286
+ } | undefined;
9287
+ image_height?: number | undefined;
9288
+ image_width?: number | undefined;
9289
+ media_type?: string | undefined;
9290
+ variants?: {
9291
+ id: string;
9292
+ created_at?: string | undefined;
9293
+ updated_at?: string | undefined;
9294
+ file?: string | undefined;
9295
+ height?: number | undefined;
9296
+ url?: string | undefined;
9297
+ width?: number | undefined;
9298
+ content_type?: string | undefined;
9299
+ filename?: string | undefined;
9300
+ image_source?: {
9301
+ mime_type?: string | undefined;
9302
+ file?: string | undefined;
9303
+ height?: number | undefined;
9304
+ media?: string | undefined;
9305
+ refresh_url?: string | undefined;
9306
+ url?: string | undefined;
9307
+ width?: number | undefined;
9308
+ } | undefined;
9309
+ variant_key?: string | undefined;
9310
+ }[] | undefined;
9311
+ version?: number | undefined;
9312
+ }[] | undefined;
9313
+ visibility?: "default" | "private" | undefined;
9314
+ actors?: {
9315
+ alias?: string | undefined;
9316
+ name?: string | undefined;
9317
+ id?: string | undefined;
9318
+ profile_picture?: {
9319
+ mime_type?: string | undefined;
9320
+ file?: string | undefined;
9321
+ height?: number | undefined;
9322
+ media?: string | undefined;
9323
+ refresh_url?: string | undefined;
9324
+ url?: string | undefined;
9325
+ width?: number | undefined;
9326
+ } | undefined;
9327
+ }[] | undefined;
9328
+ agent_mode?: "cli" | "embedded" | undefined;
9329
+ branched_thread?: string | undefined;
9330
+ has_replies?: boolean | undefined;
9331
+ idempotency_key?: string | undefined;
9332
+ is_deleted?: boolean | undefined;
9333
+ legacy_agent?: string | undefined;
9334
+ reactions?: {
9335
+ type: string;
9336
+ payload?: Record<string, unknown> | undefined;
9337
+ user?: string | undefined;
9338
+ }[] | undefined;
9339
+ rendering_mode?: string | undefined;
9340
+ replies?: Record<string, unknown>[] | undefined;
9341
+ replies_after_cursor?: string | undefined;
9342
+ replies_before_cursor?: string | undefined;
9343
+ reply_count?: number | undefined;
9344
+ reply_to?: Record<string, unknown> | undefined;
9345
+ root_message_id?: string | null | undefined;
9346
+ }[];
9347
+ before_cursor?: string | undefined;
9348
+ after_cursor?: string | undefined;
9349
+ has_more?: boolean | undefined;
9350
+ total_count?: number | undefined;
9351
+ }>;
9352
+ /** A documented callable operation exposed by a private service. */
9353
+ export interface PrivateServiceFunction {
9354
+ /** Human-readable guidance describing when and why to call the operation. */
9355
+ description: string;
9356
+ /** JSON Schema Draft 7 object describing the operation's argument object. */
9357
+ input_schema: Record<string, unknown>;
9358
+ /** Stable operation name used when invoking the private service. */
9359
+ name: string;
9360
+ /** Optional JSON Schema Draft 7 object describing the successful result. */
9361
+ output_schema?: Record<string, unknown> | undefined;
9362
+ }
9363
+ /** Runtime validator for {@link PrivateServiceFunction}. */
9364
+ export declare const privateServiceFunctionSchema: z.ZodObject<{
9365
+ /** Human-readable guidance describing when and why to call the operation. */
9366
+ description: z.ZodString;
9367
+ /** JSON Schema Draft 7 object describing the operation's argument object. */
9368
+ input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
9369
+ /** Stable operation name used when invoking the private service. */
9370
+ name: z.ZodString;
9371
+ /** Optional JSON Schema Draft 7 object describing the successful result. */
9372
+ output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
9373
+ }, "strip", z.ZodTypeAny, {
9374
+ description: string;
9375
+ name: string;
9376
+ input_schema: Record<string, unknown>;
9377
+ output_schema?: Record<string, unknown> | undefined;
9378
+ }, {
9379
+ description: string;
9380
+ name: string;
9381
+ input_schema: Record<string, unknown>;
9382
+ output_schema?: Record<string, unknown> | undefined;
9383
+ }>;
9384
+ /** An immutable private service with complete callable operation contracts. */
9385
+ export interface PrivateService {
9386
+ /** Sorted callable definitions exposed by this private service. */
9387
+ functions: PrivateServiceFunction[];
9388
+ /** Private service ID (`pvs_...`). */
9389
+ id: string;
9390
+ }
9391
+ /** Runtime validator for {@link PrivateService}. */
9392
+ export declare const privateServiceSchema: z.ZodObject<{
9393
+ /** Sorted callable definitions exposed by this private service. */
9394
+ functions: z.ZodArray<z.ZodObject<{
9395
+ /** Human-readable guidance describing when and why to call the operation. */
9396
+ description: z.ZodString;
9397
+ /** JSON Schema Draft 7 object describing the operation's argument object. */
9398
+ input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
9399
+ /** Stable operation name used when invoking the private service. */
9400
+ name: z.ZodString;
9401
+ /** Optional JSON Schema Draft 7 object describing the successful result. */
9402
+ output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
9403
+ }, "strip", z.ZodTypeAny, {
9404
+ description: string;
9405
+ name: string;
9406
+ input_schema: Record<string, unknown>;
9407
+ output_schema?: Record<string, unknown> | undefined;
9408
+ }, {
9409
+ description: string;
9410
+ name: string;
9411
+ input_schema: Record<string, unknown>;
9412
+ output_schema?: Record<string, unknown> | undefined;
9413
+ }>, "many">;
9414
+ /** Private service ID (`pvs_...`). */
9415
+ id: z.ZodString;
9416
+ }, "strip", z.ZodTypeAny, {
9417
+ id: string;
9418
+ functions: {
9419
+ description: string;
9420
+ name: string;
9421
+ input_schema: Record<string, unknown>;
9422
+ output_schema?: Record<string, unknown> | undefined;
9423
+ }[];
9424
+ }, {
9425
+ id: string;
9426
+ functions: {
9427
+ description: string;
9428
+ name: string;
9429
+ input_schema: Record<string, unknown>;
9430
+ output_schema?: Record<string, unknown> | undefined;
9431
+ }[];
9432
+ }>;
9433
+ /**
9434
+ * A private service's durable connector identity. Read responses never contain
9435
+ * an enrollment token or certificate.
9436
+ */
9437
+ export interface PrivateServiceEnrollment {
9438
+ /** Latest committed connector certificate generation, or zero before enrollment. */
9439
+ generation: number;
9440
+ /** Canonical certificate-bound service identity. */
9441
+ id: string;
9442
+ /** Immutable private service ID (`pvs_...`). */
9443
+ private_service: string;
9444
+ }
9445
+ /** Runtime validator for {@link PrivateServiceEnrollment}. */
9446
+ export declare const privateServiceEnrollmentSchema: z.ZodObject<{
9447
+ /** Latest committed connector certificate generation, or zero before enrollment. */
9448
+ generation: z.ZodNumber;
9449
+ /** Canonical certificate-bound service identity. */
9450
+ id: z.ZodString;
9451
+ /** Immutable private service ID (`pvs_...`). */
9452
+ private_service: z.ZodString;
9453
+ }, "strip", z.ZodTypeAny, {
9454
+ id: string;
9455
+ generation: number;
9456
+ private_service: string;
9457
+ }, {
9458
+ id: string;
9459
+ generation: number;
9460
+ private_service: string;
9461
+ }>;
9462
+ /** A secret-free page of private service enrollments. */
9463
+ export interface PrivateServiceEnrollmentPage {
9464
+ data: PrivateServiceEnrollment[];
9465
+ has_next: boolean;
9466
+ has_prev: boolean;
9467
+ page: number;
9468
+ page_size: number;
9469
+ total_entries: number;
9470
+ total_pages: number;
9471
+ }
9472
+ /** Runtime validator for {@link PrivateServiceEnrollmentPage}. */
9473
+ export declare const privateServiceEnrollmentPageSchema: z.ZodObject<{
9474
+ data: z.ZodArray<z.ZodObject<{
9475
+ /** Latest committed connector certificate generation, or zero before enrollment. */
9476
+ generation: z.ZodNumber;
9477
+ /** Canonical certificate-bound service identity. */
9478
+ id: z.ZodString;
9479
+ /** Immutable private service ID (`pvs_...`). */
9480
+ private_service: z.ZodString;
9481
+ }, "strip", z.ZodTypeAny, {
9482
+ id: string;
9483
+ generation: number;
9484
+ private_service: string;
9485
+ }, {
9486
+ id: string;
9487
+ generation: number;
9488
+ private_service: string;
9489
+ }>, "many">;
9490
+ has_next: z.ZodBoolean;
9491
+ has_prev: z.ZodBoolean;
9492
+ page: z.ZodNumber;
9493
+ page_size: z.ZodNumber;
9494
+ total_entries: z.ZodNumber;
9495
+ total_pages: z.ZodNumber;
9496
+ }, "strip", z.ZodTypeAny, {
9497
+ data: {
9498
+ id: string;
9499
+ generation: number;
9500
+ private_service: string;
9501
+ }[];
9502
+ has_next: boolean;
9503
+ has_prev: boolean;
9504
+ page: number;
9505
+ page_size: number;
9506
+ total_entries: number;
9507
+ total_pages: number;
9508
+ }, {
9509
+ data: {
9510
+ id: string;
9511
+ generation: number;
9512
+ private_service: string;
9513
+ }[];
9514
+ has_next: boolean;
9515
+ has_prev: boolean;
9516
+ page: number;
9517
+ page_size: number;
9518
+ total_entries: number;
9519
+ total_pages: number;
9520
+ }>;
9521
+ /** A page of private services. */
9522
+ export interface PrivateServicePage {
9523
+ data: PrivateService[];
9524
+ has_next: boolean;
9525
+ has_prev: boolean;
9526
+ page: number;
9527
+ page_size: number;
9528
+ total_entries: number;
9529
+ total_pages: number;
9530
+ }
9531
+ /** Runtime validator for {@link PrivateServicePage}. */
9532
+ export declare const privateServicePageSchema: z.ZodObject<{
9533
+ data: z.ZodArray<z.ZodObject<{
9534
+ /** Sorted callable definitions exposed by this private service. */
9535
+ functions: z.ZodArray<z.ZodObject<{
9536
+ /** Human-readable guidance describing when and why to call the operation. */
9537
+ description: z.ZodString;
9538
+ /** JSON Schema Draft 7 object describing the operation's argument object. */
9539
+ input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
9540
+ /** Stable operation name used when invoking the private service. */
9541
+ name: z.ZodString;
9542
+ /** Optional JSON Schema Draft 7 object describing the successful result. */
9543
+ output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
9544
+ }, "strip", z.ZodTypeAny, {
9545
+ description: string;
9546
+ name: string;
9547
+ input_schema: Record<string, unknown>;
9548
+ output_schema?: Record<string, unknown> | undefined;
9549
+ }, {
9550
+ description: string;
9551
+ name: string;
9552
+ input_schema: Record<string, unknown>;
9553
+ output_schema?: Record<string, unknown> | undefined;
9554
+ }>, "many">;
9555
+ /** Private service ID (`pvs_...`). */
9556
+ id: z.ZodString;
9557
+ }, "strip", z.ZodTypeAny, {
9558
+ id: string;
9559
+ functions: {
9560
+ description: string;
9561
+ name: string;
9562
+ input_schema: Record<string, unknown>;
9563
+ output_schema?: Record<string, unknown> | undefined;
9564
+ }[];
9565
+ }, {
9566
+ id: string;
9567
+ functions: {
9568
+ description: string;
9569
+ name: string;
9570
+ input_schema: Record<string, unknown>;
9571
+ output_schema?: Record<string, unknown> | undefined;
9572
+ }[];
9573
+ }>, "many">;
9574
+ has_next: z.ZodBoolean;
9575
+ has_prev: z.ZodBoolean;
9576
+ page: z.ZodNumber;
9577
+ page_size: z.ZodNumber;
9578
+ total_entries: z.ZodNumber;
9579
+ total_pages: z.ZodNumber;
9580
+ }, "strip", z.ZodTypeAny, {
9581
+ data: {
9582
+ id: string;
9583
+ functions: {
9584
+ description: string;
9585
+ name: string;
9586
+ input_schema: Record<string, unknown>;
9587
+ output_schema?: Record<string, unknown> | undefined;
9588
+ }[];
8889
9589
  }[];
8890
- before_cursor?: string | undefined;
8891
- after_cursor?: string | undefined;
8892
- has_more?: boolean | undefined;
8893
- total_count?: number | undefined;
9590
+ has_next: boolean;
9591
+ has_prev: boolean;
9592
+ page: number;
9593
+ page_size: number;
9594
+ total_entries: number;
9595
+ total_pages: number;
8894
9596
  }, {
8895
- replies: {
9597
+ data: {
8896
9598
  id: string;
8897
- content?: string | undefined;
8898
- agent?: string | undefined;
8899
- thread?: string | undefined;
8900
- team?: string | undefined;
8901
- org?: string | undefined;
8902
- type?: string | undefined;
8903
- created_at?: string | undefined;
8904
- user?: string | undefined;
8905
- sandbox?: string | undefined;
8906
- metadata?: Record<string, unknown> | undefined;
8907
- acl?: {
8908
- add?: {
8909
- actions: string[];
8910
- principal_type: string;
8911
- principal?: string | undefined;
8912
- }[] | undefined;
8913
- grants?: {
8914
- actions: string[];
8915
- principal_type: string;
8916
- principal?: string | undefined;
8917
- }[] | undefined;
8918
- remove?: {
8919
- principal_type: string;
8920
- principal?: string | undefined;
8921
- }[] | undefined;
8922
- } | undefined;
8923
- attachments?: {
8924
- type: string;
8925
- id: string;
8926
- object?: Record<string, unknown> | undefined;
8927
- description?: string | undefined;
8928
- name?: string | undefined;
8929
- height?: number | undefined;
8930
- url?: string | undefined;
8931
- width?: number | undefined;
8932
- image_url?: string | undefined;
8933
- title?: string | undefined;
8934
- content_type?: string | undefined;
8935
- filename?: string | undefined;
8936
- image_source?: {
8937
- mime_type?: string | undefined;
8938
- file?: string | undefined;
8939
- height?: number | undefined;
8940
- media?: string | undefined;
8941
- refresh_url?: string | undefined;
8942
- url?: string | undefined;
8943
- width?: number | undefined;
8944
- } | undefined;
8945
- image_height?: number | undefined;
8946
- image_width?: number | undefined;
8947
- media_type?: string | undefined;
8948
- variants?: {
8949
- id: string;
8950
- created_at?: string | undefined;
8951
- updated_at?: string | undefined;
8952
- file?: string | undefined;
8953
- height?: number | undefined;
8954
- url?: string | undefined;
8955
- width?: number | undefined;
8956
- content_type?: string | undefined;
8957
- filename?: string | undefined;
8958
- image_source?: {
8959
- mime_type?: string | undefined;
8960
- file?: string | undefined;
8961
- height?: number | undefined;
8962
- media?: string | undefined;
8963
- refresh_url?: string | undefined;
8964
- url?: string | undefined;
8965
- width?: number | undefined;
8966
- } | undefined;
8967
- variant_key?: string | undefined;
8968
- }[] | undefined;
8969
- version?: number | undefined;
8970
- }[] | undefined;
8971
- visibility?: "default" | "private" | undefined;
8972
- actors?: {
8973
- alias?: string | undefined;
8974
- name?: string | undefined;
8975
- id?: string | undefined;
8976
- profile_picture?: {
8977
- mime_type?: string | undefined;
8978
- file?: string | undefined;
8979
- height?: number | undefined;
8980
- media?: string | undefined;
8981
- refresh_url?: string | undefined;
8982
- url?: string | undefined;
8983
- width?: number | undefined;
8984
- } | undefined;
8985
- }[] | undefined;
8986
- agent_mode?: "cli" | "embedded" | undefined;
8987
- branched_thread?: string | undefined;
8988
- has_replies?: boolean | undefined;
8989
- idempotency_key?: string | undefined;
8990
- is_deleted?: boolean | undefined;
8991
- legacy_agent?: string | undefined;
8992
- reactions?: {
8993
- type: string;
8994
- payload?: Record<string, unknown> | undefined;
8995
- user?: string | undefined;
8996
- }[] | undefined;
8997
- rendering_mode?: string | undefined;
8998
- replies?: Record<string, unknown>[] | undefined;
8999
- replies_after_cursor?: string | undefined;
9000
- replies_before_cursor?: string | undefined;
9001
- reply_count?: number | undefined;
9002
- reply_to?: Record<string, unknown> | undefined;
9599
+ functions: {
9600
+ description: string;
9601
+ name: string;
9602
+ input_schema: Record<string, unknown>;
9603
+ output_schema?: Record<string, unknown> | undefined;
9604
+ }[];
9003
9605
  }[];
9004
- before_cursor?: string | undefined;
9005
- after_cursor?: string | undefined;
9006
- has_more?: boolean | undefined;
9007
- total_count?: number | undefined;
9606
+ has_next: boolean;
9607
+ has_prev: boolean;
9608
+ page: number;
9609
+ page_size: number;
9610
+ total_entries: number;
9611
+ total_pages: number;
9008
9612
  }>;
9009
9613
  /** A named preset that defines the execution model and constraints for a routine. Presets are shared definitions; individual routines reference a preset by name. */
9010
9614
  export interface RoutinePreset {
@@ -9277,28 +9881,263 @@ export declare const runJournalPageSchema: z.ZodObject<{
9277
9881
  started_at?: string | undefined;
9278
9882
  } | undefined;
9279
9883
  }, {
9280
- data: {
9884
+ data: {
9885
+ type: string;
9886
+ id: string;
9887
+ record: Record<string, unknown>;
9888
+ sequence: number;
9889
+ created_at?: string | undefined;
9890
+ command_id?: string | undefined;
9891
+ node_id?: string | undefined;
9892
+ timer_id?: string | undefined;
9893
+ }[];
9894
+ has_more: boolean;
9895
+ before_cursor?: string | undefined;
9896
+ after_cursor?: string | undefined;
9897
+ journal?: {
9898
+ status: string;
9899
+ id: string;
9900
+ current_sequence: number;
9901
+ created_at?: string | undefined;
9902
+ updated_at?: string | undefined;
9903
+ completed_at?: string | undefined;
9904
+ started_at?: string | undefined;
9905
+ } | undefined;
9906
+ }>;
9907
+ /** An API key scoped to a developer sandbox, used to authenticate requests against sandbox resources. */
9908
+ export interface SandboxKey {
9909
+ /** When this key was created (ISO 8601). */
9910
+ created_at?: string | undefined;
9911
+ /** When this key expires and becomes invalid. `null` if the key does not expire. */
9912
+ expires_at?: string | undefined;
9913
+ /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
9914
+ full_key?: string | undefined;
9915
+ /** Sandbox key ID (`dsk_...`). */
9916
+ id: string;
9917
+ /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
9918
+ key_hint?: string | undefined;
9919
+ /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
9920
+ key_value?: string | undefined;
9921
+ /** When this key was last used to authenticate a request. `null` if the key has never been used. */
9922
+ last_used_at?: string | undefined;
9923
+ /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
9924
+ status: string;
9925
+ /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
9926
+ type: string;
9927
+ }
9928
+ /** Runtime validator for {@link SandboxKey}. */
9929
+ export declare const sandboxKeySchema: z.ZodObject<{
9930
+ /** When this key was created (ISO 8601). */
9931
+ created_at: z.ZodOptional<z.ZodString>;
9932
+ /** When this key expires and becomes invalid. `null` if the key does not expire. */
9933
+ expires_at: z.ZodOptional<z.ZodString>;
9934
+ /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
9935
+ full_key: z.ZodOptional<z.ZodString>;
9936
+ /** Sandbox key ID (`dsk_...`). */
9937
+ id: z.ZodString;
9938
+ /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
9939
+ key_hint: z.ZodOptional<z.ZodString>;
9940
+ /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
9941
+ key_value: z.ZodOptional<z.ZodString>;
9942
+ /** When this key was last used to authenticate a request. `null` if the key has never been used. */
9943
+ last_used_at: z.ZodOptional<z.ZodString>;
9944
+ /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
9945
+ status: z.ZodString;
9946
+ /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
9947
+ type: z.ZodString;
9948
+ }, "strip", z.ZodTypeAny, {
9949
+ type: string;
9950
+ status: string;
9951
+ id: string;
9952
+ created_at?: string | undefined;
9953
+ expires_at?: string | undefined;
9954
+ full_key?: string | undefined;
9955
+ key_hint?: string | undefined;
9956
+ key_value?: string | undefined;
9957
+ last_used_at?: string | undefined;
9958
+ }, {
9959
+ type: string;
9960
+ status: string;
9961
+ id: string;
9962
+ created_at?: string | undefined;
9963
+ expires_at?: string | undefined;
9964
+ full_key?: string | undefined;
9965
+ key_hint?: string | undefined;
9966
+ key_value?: string | undefined;
9967
+ last_used_at?: string | undefined;
9968
+ }>;
9969
+ /** An isolated developer sandbox environment used for testing integrations without affecting production data or sending real emails. */
9970
+ export interface Sandbox {
9971
+ /** When this sandbox was created (ISO 8601). */
9972
+ created_at?: string | undefined;
9973
+ /** When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes. */
9974
+ expires_at?: string | undefined;
9975
+ /** Sandbox ID (`dsb_...`). */
9976
+ id: string;
9977
+ /** API keys associated with this sandbox. `null` if keys were not loaded with this response. */
9978
+ keys?: SandboxKey[] | undefined;
9979
+ /** Human-readable display name for the sandbox. */
9980
+ name: string;
9981
+ /** Organization ID this sandbox is scoped to, or `null` for an app-level sandbox. */
9982
+ org?: string | undefined;
9983
+ /** Logo of the owning organization, when present. */
9984
+ org_logo?: ImageSource | undefined;
9985
+ /** Display name of the owning organization, when org-scoped. */
9986
+ org_name?: string | undefined;
9987
+ /** Sandbox purpose marker. `"eval"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes. */
9988
+ purpose?: string | undefined;
9989
+ /** URL-safe identifier for the sandbox, unique within the application (e.g. `"my-sandbox"`). */
9990
+ slug: string;
9991
+ /** When this sandbox was last modified (ISO 8601). */
9992
+ updated_at?: string | undefined;
9993
+ }
9994
+ /** Runtime validator for {@link Sandbox}. */
9995
+ export declare const sandboxSchema: z.ZodObject<{
9996
+ /** When this sandbox was created (ISO 8601). */
9997
+ created_at: z.ZodOptional<z.ZodString>;
9998
+ /** When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes. */
9999
+ expires_at: z.ZodOptional<z.ZodString>;
10000
+ /** Sandbox ID (`dsb_...`). */
10001
+ id: z.ZodString;
10002
+ /** API keys associated with this sandbox. `null` if keys were not loaded with this response. */
10003
+ keys: z.ZodOptional<z.ZodArray<z.ZodObject<{
10004
+ /** When this key was created (ISO 8601). */
10005
+ created_at: z.ZodOptional<z.ZodString>;
10006
+ /** When this key expires and becomes invalid. `null` if the key does not expire. */
10007
+ expires_at: z.ZodOptional<z.ZodString>;
10008
+ /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
10009
+ full_key: z.ZodOptional<z.ZodString>;
10010
+ /** Sandbox key ID (`dsk_...`). */
10011
+ id: z.ZodString;
10012
+ /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
10013
+ key_hint: z.ZodOptional<z.ZodString>;
10014
+ /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
10015
+ key_value: z.ZodOptional<z.ZodString>;
10016
+ /** When this key was last used to authenticate a request. `null` if the key has never been used. */
10017
+ last_used_at: z.ZodOptional<z.ZodString>;
10018
+ /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
10019
+ status: z.ZodString;
10020
+ /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
10021
+ type: z.ZodString;
10022
+ }, "strip", z.ZodTypeAny, {
10023
+ type: string;
10024
+ status: string;
10025
+ id: string;
10026
+ created_at?: string | undefined;
10027
+ expires_at?: string | undefined;
10028
+ full_key?: string | undefined;
10029
+ key_hint?: string | undefined;
10030
+ key_value?: string | undefined;
10031
+ last_used_at?: string | undefined;
10032
+ }, {
10033
+ type: string;
10034
+ status: string;
10035
+ id: string;
10036
+ created_at?: string | undefined;
10037
+ expires_at?: string | undefined;
10038
+ full_key?: string | undefined;
10039
+ key_hint?: string | undefined;
10040
+ key_value?: string | undefined;
10041
+ last_used_at?: string | undefined;
10042
+ }>, "many">>;
10043
+ /** Human-readable display name for the sandbox. */
10044
+ name: z.ZodString;
10045
+ /** Organization ID this sandbox is scoped to, or `null` for an app-level sandbox. */
10046
+ org: z.ZodOptional<z.ZodString>;
10047
+ /** Logo of the owning organization, when present. */
10048
+ org_logo: z.ZodOptional<z.ZodObject<{
10049
+ file: z.ZodOptional<z.ZodString>;
10050
+ height: z.ZodOptional<z.ZodNumber>;
10051
+ media: z.ZodOptional<z.ZodString>;
10052
+ mime_type: z.ZodOptional<z.ZodString>;
10053
+ refresh_url: z.ZodOptional<z.ZodString>;
10054
+ url: z.ZodOptional<z.ZodString>;
10055
+ width: z.ZodOptional<z.ZodNumber>;
10056
+ }, "strip", z.ZodTypeAny, {
10057
+ mime_type?: string | undefined;
10058
+ file?: string | undefined;
10059
+ height?: number | undefined;
10060
+ media?: string | undefined;
10061
+ refresh_url?: string | undefined;
10062
+ url?: string | undefined;
10063
+ width?: number | undefined;
10064
+ }, {
10065
+ mime_type?: string | undefined;
10066
+ file?: string | undefined;
10067
+ height?: number | undefined;
10068
+ media?: string | undefined;
10069
+ refresh_url?: string | undefined;
10070
+ url?: string | undefined;
10071
+ width?: number | undefined;
10072
+ }>>;
10073
+ /** Display name of the owning organization, when org-scoped. */
10074
+ org_name: z.ZodOptional<z.ZodString>;
10075
+ /** Sandbox purpose marker. `"eval"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes. */
10076
+ purpose: z.ZodOptional<z.ZodString>;
10077
+ /** URL-safe identifier for the sandbox, unique within the application (e.g. `"my-sandbox"`). */
10078
+ slug: z.ZodString;
10079
+ /** When this sandbox was last modified (ISO 8601). */
10080
+ updated_at: z.ZodOptional<z.ZodString>;
10081
+ }, "strip", z.ZodTypeAny, {
10082
+ name: string;
10083
+ id: string;
10084
+ slug: string;
10085
+ org?: string | undefined;
10086
+ keys?: {
10087
+ type: string;
10088
+ status: string;
10089
+ id: string;
10090
+ created_at?: string | undefined;
10091
+ expires_at?: string | undefined;
10092
+ full_key?: string | undefined;
10093
+ key_hint?: string | undefined;
10094
+ key_value?: string | undefined;
10095
+ last_used_at?: string | undefined;
10096
+ }[] | undefined;
10097
+ created_at?: string | undefined;
10098
+ updated_at?: string | undefined;
10099
+ org_name?: string | undefined;
10100
+ org_logo?: {
10101
+ mime_type?: string | undefined;
10102
+ file?: string | undefined;
10103
+ height?: number | undefined;
10104
+ media?: string | undefined;
10105
+ refresh_url?: string | undefined;
10106
+ url?: string | undefined;
10107
+ width?: number | undefined;
10108
+ } | undefined;
10109
+ expires_at?: string | undefined;
10110
+ purpose?: string | undefined;
10111
+ }, {
10112
+ name: string;
10113
+ id: string;
10114
+ slug: string;
10115
+ org?: string | undefined;
10116
+ keys?: {
9281
10117
  type: string;
9282
- id: string;
9283
- record: Record<string, unknown>;
9284
- sequence: number;
9285
- created_at?: string | undefined;
9286
- command_id?: string | undefined;
9287
- node_id?: string | undefined;
9288
- timer_id?: string | undefined;
9289
- }[];
9290
- has_more: boolean;
9291
- before_cursor?: string | undefined;
9292
- after_cursor?: string | undefined;
9293
- journal?: {
9294
10118
  status: string;
9295
10119
  id: string;
9296
- current_sequence: number;
9297
10120
  created_at?: string | undefined;
9298
- updated_at?: string | undefined;
9299
- completed_at?: string | undefined;
9300
- started_at?: string | undefined;
10121
+ expires_at?: string | undefined;
10122
+ full_key?: string | undefined;
10123
+ key_hint?: string | undefined;
10124
+ key_value?: string | undefined;
10125
+ last_used_at?: string | undefined;
10126
+ }[] | undefined;
10127
+ created_at?: string | undefined;
10128
+ updated_at?: string | undefined;
10129
+ org_name?: string | undefined;
10130
+ org_logo?: {
10131
+ mime_type?: string | undefined;
10132
+ file?: string | undefined;
10133
+ height?: number | undefined;
10134
+ media?: string | undefined;
10135
+ refresh_url?: string | undefined;
10136
+ url?: string | undefined;
10137
+ width?: number | undefined;
9301
10138
  } | undefined;
10139
+ expires_at?: string | undefined;
10140
+ purpose?: string | undefined;
9302
10141
  }>;
9303
10142
  /** A binding that connects a Slack channel to an ArchAstro team and one or more agents, enabling those agents to receive and respond to messages in that channel. */
9304
10143
  export interface SlackChannelBinding {
@@ -9312,6 +10151,8 @@ export interface SlackChannelBinding {
9312
10151
  customer_label?: string | undefined;
9313
10152
  /** Staging thread the deposit pipe copies this channel's mirror content into (`thr_…` public ID). `null` when the pipe is off for this binding. */
9314
10153
  deposit_thread?: string | undefined;
10154
+ /** Slack Connect lifecycle: `pending` while the customer has not accepted the invite (nothing mirrors), `posted` once the AI disclosure is in the channel and the channel is live, `suppressed` when relay is stopped. `null` for a binding that never went through Connect provisioning. */
10155
+ disclosure_state?: "pending" | "posted" | "suppressed" | undefined;
9315
10156
  /** Unique identifier for this Slack channel binding. */
9316
10157
  id: string;
9317
10158
  /** ID of the Slack integration that owns this binding. */
@@ -9330,8 +10171,12 @@ export interface SlackChannelBinding {
9330
10171
  resident_agent?: string | undefined;
9331
10172
  /** Effective Slack ingress route: `fda` for a team-bound resident, `resident` for an unbound resident, or `concierge` when no non-concierge agent is attached. */
9332
10173
  route_kind: "fda" | "resident" | "concierge";
10174
+ /** The customer key this channel's agent is locked to, written when adding the customer finishes. A `posted` binding whose `scope_key` is still null has been accepted but not finished — the addition is either in flight or was refused. */
10175
+ scope_key?: string | undefined;
9333
10176
  /** ID of the ArchAstro team this channel is bound to. */
9334
10177
  team?: string | undefined;
10178
+ /** Whether the admin who added this customer ended up inside a Connect channel we created for them: `invited` (we put them in), `already_member` (they were in it already), `no_slack_user` (their account email is not a Slack account in your workspace, so nobody was invited), or `failed` (Slack refused). A created Connect channel is private and has no self-join, so the last two mean the channel has no human from your side until someone already in it adds one. `null` when nobody was added: the channel was adopted rather than created (an existing channel already has its own members), the binding never went through Connect provisioning, or the call had no admin behind it. */
10179
+ vendor_admin_channel_access?: "invited" | "already_member" | "no_slack_user" | "failed" | undefined;
9335
10180
  }
9336
10181
  /** Runtime validator for {@link SlackChannelBinding}. */
9337
10182
  export declare const slackChannelBindingSchema: z.ZodObject<{
@@ -9345,6 +10190,8 @@ export declare const slackChannelBindingSchema: z.ZodObject<{
9345
10190
  customer_label: z.ZodOptional<z.ZodString>;
9346
10191
  /** Staging thread the deposit pipe copies this channel's mirror content into (`thr_…` public ID). `null` when the pipe is off for this binding. */
9347
10192
  deposit_thread: z.ZodOptional<z.ZodString>;
10193
+ /** Slack Connect lifecycle: `pending` while the customer has not accepted the invite (nothing mirrors), `posted` once the AI disclosure is in the channel and the channel is live, `suppressed` when relay is stopped. `null` for a binding that never went through Connect provisioning. */
10194
+ disclosure_state: z.ZodOptional<z.ZodEnum<["pending", "posted", "suppressed"]>>;
9348
10195
  /** Unique identifier for this Slack channel binding. */
9349
10196
  id: z.ZodString;
9350
10197
  /** ID of the Slack integration that owns this binding. */
@@ -9363,8 +10210,12 @@ export declare const slackChannelBindingSchema: z.ZodObject<{
9363
10210
  resident_agent: z.ZodOptional<z.ZodString>;
9364
10211
  /** Effective Slack ingress route: `fda` for a team-bound resident, `resident` for an unbound resident, or `concierge` when no non-concierge agent is attached. */
9365
10212
  route_kind: z.ZodEnum<["fda", "resident", "concierge"]>;
10213
+ /** The customer key this channel's agent is locked to, written when adding the customer finishes. A `posted` binding whose `scope_key` is still null has been accepted but not finished — the addition is either in flight or was refused. */
10214
+ scope_key: z.ZodOptional<z.ZodString>;
9366
10215
  /** ID of the ArchAstro team this channel is bound to. */
9367
10216
  team: z.ZodOptional<z.ZodString>;
10217
+ /** Whether the admin who added this customer ended up inside a Connect channel we created for them: `invited` (we put them in), `already_member` (they were in it already), `no_slack_user` (their account email is not a Slack account in your workspace, so nobody was invited), or `failed` (Slack refused). A created Connect channel is private and has no self-join, so the last two mean the channel has no human from your side until someone already in it adds one. `null` when nobody was added: the channel was adopted rather than created (an existing channel already has its own members), the binding never went through Connect provisioning, or the call had no admin behind it. */
10218
+ vendor_admin_channel_access: z.ZodOptional<z.ZodEnum<["invited", "already_member", "no_slack_user", "failed"]>>;
9368
10219
  }, "strip", z.ZodTypeAny, {
9369
10220
  id: string;
9370
10221
  allow_bot_conversations: boolean;
@@ -9376,11 +10227,14 @@ export declare const slackChannelBindingSchema: z.ZodObject<{
9376
10227
  channel?: string | undefined;
9377
10228
  customer_label?: string | undefined;
9378
10229
  deposit_thread?: string | undefined;
10230
+ disclosure_state?: "pending" | "posted" | "suppressed" | undefined;
9379
10231
  integration?: string | undefined;
9380
10232
  is_ext_shared_cached?: boolean | undefined;
9381
10233
  is_private_cached?: boolean | undefined;
9382
10234
  muted_until?: string | undefined;
9383
10235
  resident_agent?: string | undefined;
10236
+ scope_key?: string | undefined;
10237
+ vendor_admin_channel_access?: "invited" | "already_member" | "no_slack_user" | "failed" | undefined;
9384
10238
  }, {
9385
10239
  id: string;
9386
10240
  allow_bot_conversations: boolean;
@@ -9392,11 +10246,14 @@ export declare const slackChannelBindingSchema: z.ZodObject<{
9392
10246
  channel?: string | undefined;
9393
10247
  customer_label?: string | undefined;
9394
10248
  deposit_thread?: string | undefined;
10249
+ disclosure_state?: "pending" | "posted" | "suppressed" | undefined;
9395
10250
  integration?: string | undefined;
9396
10251
  is_ext_shared_cached?: boolean | undefined;
9397
10252
  is_private_cached?: boolean | undefined;
9398
10253
  muted_until?: string | undefined;
9399
10254
  resident_agent?: string | undefined;
10255
+ scope_key?: string | undefined;
10256
+ vendor_admin_channel_access?: "invited" | "already_member" | "no_slack_user" | "failed" | undefined;
9400
10257
  }>;
9401
10258
  /** Paginated list of Slack channel bindings for the requested integration or team. Use the `page` and `per_page` fields to navigate pages of results. */
9402
10259
  export interface SlackChannelBindingListResponse {
@@ -9425,6 +10282,8 @@ export declare const slackChannelBindingListResponseSchema: z.ZodObject<{
9425
10282
  customer_label: z.ZodOptional<z.ZodString>;
9426
10283
  /** Staging thread the deposit pipe copies this channel's mirror content into (`thr_…` public ID). `null` when the pipe is off for this binding. */
9427
10284
  deposit_thread: z.ZodOptional<z.ZodString>;
10285
+ /** Slack Connect lifecycle: `pending` while the customer has not accepted the invite (nothing mirrors), `posted` once the AI disclosure is in the channel and the channel is live, `suppressed` when relay is stopped. `null` for a binding that never went through Connect provisioning. */
10286
+ disclosure_state: z.ZodOptional<z.ZodEnum<["pending", "posted", "suppressed"]>>;
9428
10287
  /** Unique identifier for this Slack channel binding. */
9429
10288
  id: z.ZodString;
9430
10289
  /** ID of the Slack integration that owns this binding. */
@@ -9443,8 +10302,12 @@ export declare const slackChannelBindingListResponseSchema: z.ZodObject<{
9443
10302
  resident_agent: z.ZodOptional<z.ZodString>;
9444
10303
  /** Effective Slack ingress route: `fda` for a team-bound resident, `resident` for an unbound resident, or `concierge` when no non-concierge agent is attached. */
9445
10304
  route_kind: z.ZodEnum<["fda", "resident", "concierge"]>;
10305
+ /** The customer key this channel's agent is locked to, written when adding the customer finishes. A `posted` binding whose `scope_key` is still null has been accepted but not finished — the addition is either in flight or was refused. */
10306
+ scope_key: z.ZodOptional<z.ZodString>;
9446
10307
  /** ID of the ArchAstro team this channel is bound to. */
9447
10308
  team: z.ZodOptional<z.ZodString>;
10309
+ /** Whether the admin who added this customer ended up inside a Connect channel we created for them: `invited` (we put them in), `already_member` (they were in it already), `no_slack_user` (their account email is not a Slack account in your workspace, so nobody was invited), or `failed` (Slack refused). A created Connect channel is private and has no self-join, so the last two mean the channel has no human from your side until someone already in it adds one. `null` when nobody was added: the channel was adopted rather than created (an existing channel already has its own members), the binding never went through Connect provisioning, or the call had no admin behind it. */
10310
+ vendor_admin_channel_access: z.ZodOptional<z.ZodEnum<["invited", "already_member", "no_slack_user", "failed"]>>;
9448
10311
  }, "strip", z.ZodTypeAny, {
9449
10312
  id: string;
9450
10313
  allow_bot_conversations: boolean;
@@ -9456,11 +10319,14 @@ export declare const slackChannelBindingListResponseSchema: z.ZodObject<{
9456
10319
  channel?: string | undefined;
9457
10320
  customer_label?: string | undefined;
9458
10321
  deposit_thread?: string | undefined;
10322
+ disclosure_state?: "pending" | "posted" | "suppressed" | undefined;
9459
10323
  integration?: string | undefined;
9460
10324
  is_ext_shared_cached?: boolean | undefined;
9461
10325
  is_private_cached?: boolean | undefined;
9462
10326
  muted_until?: string | undefined;
9463
10327
  resident_agent?: string | undefined;
10328
+ scope_key?: string | undefined;
10329
+ vendor_admin_channel_access?: "invited" | "already_member" | "no_slack_user" | "failed" | undefined;
9464
10330
  }, {
9465
10331
  id: string;
9466
10332
  allow_bot_conversations: boolean;
@@ -9472,11 +10338,14 @@ export declare const slackChannelBindingListResponseSchema: z.ZodObject<{
9472
10338
  channel?: string | undefined;
9473
10339
  customer_label?: string | undefined;
9474
10340
  deposit_thread?: string | undefined;
10341
+ disclosure_state?: "pending" | "posted" | "suppressed" | undefined;
9475
10342
  integration?: string | undefined;
9476
10343
  is_ext_shared_cached?: boolean | undefined;
9477
10344
  is_private_cached?: boolean | undefined;
9478
10345
  muted_until?: string | undefined;
9479
10346
  resident_agent?: string | undefined;
10347
+ scope_key?: string | undefined;
10348
+ vendor_admin_channel_access?: "invited" | "already_member" | "no_slack_user" | "failed" | undefined;
9480
10349
  }>, "many">;
9481
10350
  /** Current page number (1-indexed). */
9482
10351
  page: z.ZodNumber;
@@ -9498,11 +10367,14 @@ export declare const slackChannelBindingListResponseSchema: z.ZodObject<{
9498
10367
  channel?: string | undefined;
9499
10368
  customer_label?: string | undefined;
9500
10369
  deposit_thread?: string | undefined;
10370
+ disclosure_state?: "pending" | "posted" | "suppressed" | undefined;
9501
10371
  integration?: string | undefined;
9502
10372
  is_ext_shared_cached?: boolean | undefined;
9503
10373
  is_private_cached?: boolean | undefined;
9504
10374
  muted_until?: string | undefined;
9505
10375
  resident_agent?: string | undefined;
10376
+ scope_key?: string | undefined;
10377
+ vendor_admin_channel_access?: "invited" | "already_member" | "no_slack_user" | "failed" | undefined;
9506
10378
  }[];
9507
10379
  page: number;
9508
10380
  total_pages: number;
@@ -9520,368 +10392,75 @@ export declare const slackChannelBindingListResponseSchema: z.ZodObject<{
9520
10392
  channel?: string | undefined;
9521
10393
  customer_label?: string | undefined;
9522
10394
  deposit_thread?: string | undefined;
10395
+ disclosure_state?: "pending" | "posted" | "suppressed" | undefined;
9523
10396
  integration?: string | undefined;
9524
10397
  is_ext_shared_cached?: boolean | undefined;
9525
10398
  is_private_cached?: boolean | undefined;
9526
10399
  muted_until?: string | undefined;
9527
10400
  resident_agent?: string | undefined;
10401
+ scope_key?: string | undefined;
10402
+ vendor_admin_channel_access?: "invited" | "already_member" | "no_slack_user" | "failed" | undefined;
9528
10403
  }[];
9529
10404
  page: number;
9530
10405
  total_pages: number;
9531
10406
  total_count: number;
9532
10407
  per_page: number;
9533
10408
  }>;
9534
- /** A task representing a unit of work, optionally assignable to a user or agent. */
9535
- export interface Task {
9536
- /** ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user. */
9537
- agent?: string | undefined;
9538
- /** Number of tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
9539
- blocked_by_count?: number | undefined;
9540
- /** When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open. */
9541
- closed_at?: string | undefined;
9542
- /** Total number of comments posted on this task. */
9543
- comments_count?: number | undefined;
9544
- /** When the task was created (ISO 8601). */
10409
+ /** A recorded sequence of AI messages and tool interactions representing a single AI reasoning session. Trajectories are stored as structured message logs and can be replayed or inspected after execution. */
10410
+ export interface Trajectory {
10411
+ /** When the trajectory was recorded (ISO 8601). */
9545
10412
  created_at?: string | undefined;
9546
- /** Resolved creator details including `id`, `name`, `alias`, and `profile_picture`. `null` if no creator is set or the creator cannot be resolved (e.g. creating agent was deleted). */
9547
- created_by_actor?: Actor | undefined;
9548
- /** ID of the agent that created this task (`agi_...`). `null` if the task was created by a human user, or if the creating agent was later deleted. */
9549
- created_by_agent?: string | undefined;
9550
- /** ID of the user who created this task (`usr_...`). `null` if the task was created by an agent, or if creator provenance was cleared after the creator was deleted. */
9551
- created_by_user?: string | undefined;
9552
- /** Long-form description or notes for the task. `null` if no description has been provided. */
9553
- description?: string | undefined;
9554
- /** Date and time by which the task should be completed (ISO 8601). `null` if no due date is set. */
9555
- due_date?: string | undefined;
9556
- /** Task ID (`tsk_...`). */
10413
+ /** ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file. */
10414
+ file?: string | undefined;
10415
+ /** Trajectory ID (`trj_...`). */
9557
10416
  id: string;
9558
- /** `true` while at least one blocking task is not yet done. Informational only a blocked task can still change status — and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on list/show reads; create/update responses report `false` until the next read. */
9559
- is_blocked?: boolean | undefined;
9560
- /** Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set. */
9561
- links?: Record<string, unknown> | undefined;
9562
- /** Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set. */
9563
- metadata?: Record<string, unknown> | undefined;
9564
- /** Human-readable title of the task. */
9565
- name: string;
9566
- /** ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context. */
10417
+ /** Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session. */
10418
+ messages?: Record<string, unknown> | undefined;
10419
+ /** ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context. */
9567
10420
  org?: string | undefined;
9568
- /** Resolved owner details including `id`, `name`, `alias`, and `profile_picture`. `null` if the task is unassigned or the owner cannot be resolved (e.g. assigned agent was deleted). */
9569
- owner_actor?: Actor | undefined;
9570
- /** ID of the agent assigned as owner (`agi_...`). `null` if the owner is a human user, the task is unassigned, or the assigned agent was deleted. */
9571
- owner_agent?: string | undefined;
9572
- /** ID of the user assigned as owner (`usr_...`). `null` if the owner is an agent, the task is unassigned, or the assigned agent was deleted. */
9573
- owner_user?: string | undefined;
9574
- /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level. */
9575
- parent?: string | undefined;
9576
- /** Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set. */
9577
- priority?: number | undefined;
9578
- /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
10421
+ /** ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories. */
9579
10422
  sandbox?: string | undefined;
9580
- /** Current status of the task. One of `"open"`, `"in_progress"`, or `"done"`. */
9581
- status: string;
9582
- /** Number of subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
9583
- subtasks_count?: number | undefined;
9584
- /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
9585
- tags?: string[] | undefined;
9586
- /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
10423
+ /** ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team. */
9587
10424
  team?: string | undefined;
9588
- /** ID of the thread this task is bound to (`thr_...`) — the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
9589
- thread?: string | undefined;
9590
- /** When the task was last modified (ISO 8601). */
10425
+ /** When the trajectory record was last updated (ISO 8601). */
9591
10426
  updated_at?: string | undefined;
9592
- /** ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team. */
9593
- user?: string | undefined;
9594
10427
  }
9595
- /** Runtime validator for {@link Task}. */
9596
- export declare const taskSchema: z.ZodObject<{
9597
- /** ID of the agent that owns this task (`agi_...`). `null` if the task is scoped to a team or user. */
9598
- agent: z.ZodOptional<z.ZodString>;
9599
- /** Number of tasks marked as blocking this task, whether or not they are done (see `GET /tasks/{task}/blockers`). Computed on list/show reads; create/update responses may lag one read behind. */
9600
- blocked_by_count: z.ZodOptional<z.ZodNumber>;
9601
- /** When the task was marked as done or otherwise closed (ISO 8601). `null` if the task is still open. */
9602
- closed_at: z.ZodOptional<z.ZodString>;
9603
- /** Total number of comments posted on this task. */
9604
- comments_count: z.ZodOptional<z.ZodNumber>;
9605
- /** When the task was created (ISO 8601). */
10428
+ /** Runtime validator for {@link Trajectory}. */
10429
+ export declare const trajectorySchema: z.ZodObject<{
10430
+ /** When the trajectory was recorded (ISO 8601). */
9606
10431
  created_at: z.ZodOptional<z.ZodString>;
9607
- /** Resolved creator details including `id`, `name`, `alias`, and `profile_picture`. `null` if no creator is set or the creator cannot be resolved (e.g. creating agent was deleted). */
9608
- created_by_actor: z.ZodOptional<z.ZodObject<{
9609
- /** Short handle or alias for the actor, used as an alternate display identifier. `null` if not configured. */
9610
- alias: z.ZodOptional<z.ZodString>;
9611
- /** Composite actor identifier. Format is `"user-<usr_...>"` for human users or `"agent-<agi_...>"` for agents. */
9612
- id: z.ZodOptional<z.ZodString>;
9613
- /** Display name of the actor shown in the UI. `null` if no name is set. */
9614
- name: z.ZodOptional<z.ZodString>;
9615
- /** Profile picture for the actor. `null` if the actor has no profile picture. */
9616
- profile_picture: z.ZodOptional<z.ZodObject<{
9617
- file: z.ZodOptional<z.ZodString>;
9618
- height: z.ZodOptional<z.ZodNumber>;
9619
- media: z.ZodOptional<z.ZodString>;
9620
- mime_type: z.ZodOptional<z.ZodString>;
9621
- refresh_url: z.ZodOptional<z.ZodString>;
9622
- url: z.ZodOptional<z.ZodString>;
9623
- width: z.ZodOptional<z.ZodNumber>;
9624
- }, "strip", z.ZodTypeAny, {
9625
- mime_type?: string | undefined;
9626
- file?: string | undefined;
9627
- height?: number | undefined;
9628
- media?: string | undefined;
9629
- refresh_url?: string | undefined;
9630
- url?: string | undefined;
9631
- width?: number | undefined;
9632
- }, {
9633
- mime_type?: string | undefined;
9634
- file?: string | undefined;
9635
- height?: number | undefined;
9636
- media?: string | undefined;
9637
- refresh_url?: string | undefined;
9638
- url?: string | undefined;
9639
- width?: number | undefined;
9640
- }>>;
9641
- }, "strip", z.ZodTypeAny, {
9642
- alias?: string | undefined;
9643
- name?: string | undefined;
9644
- id?: string | undefined;
9645
- profile_picture?: {
9646
- mime_type?: string | undefined;
9647
- file?: string | undefined;
9648
- height?: number | undefined;
9649
- media?: string | undefined;
9650
- refresh_url?: string | undefined;
9651
- url?: string | undefined;
9652
- width?: number | undefined;
9653
- } | undefined;
9654
- }, {
9655
- alias?: string | undefined;
9656
- name?: string | undefined;
9657
- id?: string | undefined;
9658
- profile_picture?: {
9659
- mime_type?: string | undefined;
9660
- file?: string | undefined;
9661
- height?: number | undefined;
9662
- media?: string | undefined;
9663
- refresh_url?: string | undefined;
9664
- url?: string | undefined;
9665
- width?: number | undefined;
9666
- } | undefined;
9667
- }>>;
9668
- /** ID of the agent that created this task (`agi_...`). `null` if the task was created by a human user, or if the creating agent was later deleted. */
9669
- created_by_agent: z.ZodOptional<z.ZodString>;
9670
- /** ID of the user who created this task (`usr_...`). `null` if the task was created by an agent, or if creator provenance was cleared after the creator was deleted. */
9671
- created_by_user: z.ZodOptional<z.ZodString>;
9672
- /** Long-form description or notes for the task. `null` if no description has been provided. */
9673
- description: z.ZodOptional<z.ZodString>;
9674
- /** Date and time by which the task should be completed (ISO 8601). `null` if no due date is set. */
9675
- due_date: z.ZodOptional<z.ZodString>;
9676
- /** Task ID (`tsk_...`). */
10432
+ /** ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file. */
10433
+ file: z.ZodOptional<z.ZodString>;
10434
+ /** Trajectory ID (`trj_...`). */
9677
10435
  id: z.ZodString;
9678
- /** `true` while at least one blocking task is not yet done. Informational only a blocked task can still change status — and derived at read time, so the task un-blocks automatically when its last open blocker completes. Computed on list/show reads; create/update responses report `false` until the next read. */
9679
- is_blocked: z.ZodOptional<z.ZodBoolean>;
9680
- /** Key-value map of named URLs or references associated with the task. Returns an empty object when no links have been set. */
9681
- links: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
9682
- /** Arbitrary key-value map of application-specific data stored alongside the task. Returns an empty object when no metadata has been set. */
9683
- metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
9684
- /** Human-readable title of the task. */
9685
- name: z.ZodString;
9686
- /** ID of the organization this task belongs to (`org_...`). `null` for tasks outside an org context. */
10436
+ /** Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session. */
10437
+ messages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
10438
+ /** ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context. */
9687
10439
  org: z.ZodOptional<z.ZodString>;
9688
- /** Resolved owner details including `id`, `name`, `alias`, and `profile_picture`. `null` if the task is unassigned or the owner cannot be resolved (e.g. assigned agent was deleted). */
9689
- owner_actor: z.ZodOptional<z.ZodObject<{
9690
- /** Short handle or alias for the actor, used as an alternate display identifier. `null` if not configured. */
9691
- alias: z.ZodOptional<z.ZodString>;
9692
- /** Composite actor identifier. Format is `"user-<usr_...>"` for human users or `"agent-<agi_...>"` for agents. */
9693
- id: z.ZodOptional<z.ZodString>;
9694
- /** Display name of the actor shown in the UI. `null` if no name is set. */
9695
- name: z.ZodOptional<z.ZodString>;
9696
- /** Profile picture for the actor. `null` if the actor has no profile picture. */
9697
- profile_picture: z.ZodOptional<z.ZodObject<{
9698
- file: z.ZodOptional<z.ZodString>;
9699
- height: z.ZodOptional<z.ZodNumber>;
9700
- media: z.ZodOptional<z.ZodString>;
9701
- mime_type: z.ZodOptional<z.ZodString>;
9702
- refresh_url: z.ZodOptional<z.ZodString>;
9703
- url: z.ZodOptional<z.ZodString>;
9704
- width: z.ZodOptional<z.ZodNumber>;
9705
- }, "strip", z.ZodTypeAny, {
9706
- mime_type?: string | undefined;
9707
- file?: string | undefined;
9708
- height?: number | undefined;
9709
- media?: string | undefined;
9710
- refresh_url?: string | undefined;
9711
- url?: string | undefined;
9712
- width?: number | undefined;
9713
- }, {
9714
- mime_type?: string | undefined;
9715
- file?: string | undefined;
9716
- height?: number | undefined;
9717
- media?: string | undefined;
9718
- refresh_url?: string | undefined;
9719
- url?: string | undefined;
9720
- width?: number | undefined;
9721
- }>>;
9722
- }, "strip", z.ZodTypeAny, {
9723
- alias?: string | undefined;
9724
- name?: string | undefined;
9725
- id?: string | undefined;
9726
- profile_picture?: {
9727
- mime_type?: string | undefined;
9728
- file?: string | undefined;
9729
- height?: number | undefined;
9730
- media?: string | undefined;
9731
- refresh_url?: string | undefined;
9732
- url?: string | undefined;
9733
- width?: number | undefined;
9734
- } | undefined;
9735
- }, {
9736
- alias?: string | undefined;
9737
- name?: string | undefined;
9738
- id?: string | undefined;
9739
- profile_picture?: {
9740
- mime_type?: string | undefined;
9741
- file?: string | undefined;
9742
- height?: number | undefined;
9743
- media?: string | undefined;
9744
- refresh_url?: string | undefined;
9745
- url?: string | undefined;
9746
- width?: number | undefined;
9747
- } | undefined;
9748
- }>>;
9749
- /** ID of the agent assigned as owner (`agi_...`). `null` if the owner is a human user, the task is unassigned, or the assigned agent was deleted. */
9750
- owner_agent: z.ZodOptional<z.ZodString>;
9751
- /** ID of the user assigned as owner (`usr_...`). `null` if the owner is an agent, the task is unassigned, or the assigned agent was deleted. */
9752
- owner_user: z.ZodOptional<z.ZodString>;
9753
- /** ID of the parent task when this task is a subtask (`tsk_...`). `null` for top-level tasks. Subtasks nest exactly one level. */
9754
- parent: z.ZodOptional<z.ZodString>;
9755
- /** Priority level of the task from `0` (highest) to `4` (lowest). Defaults to `2` (medium) when not explicitly set. */
9756
- priority: z.ZodOptional<z.ZodNumber>;
9757
- /** ID of the developer sandbox this task is scoped to (`dsb_...`). `null` for tasks outside a sandbox environment. */
10440
+ /** ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories. */
9758
10441
  sandbox: z.ZodOptional<z.ZodString>;
9759
- /** Current status of the task. One of `"open"`, `"in_progress"`, or `"done"`. */
9760
- status: z.ZodString;
9761
- /** Number of subtasks under this task. Computed on list/show reads; create/update responses may report 0 until the next read. Always 0 for subtasks. */
9762
- subtasks_count: z.ZodOptional<z.ZodNumber>;
9763
- /** Labels for grouping and filtering, stored lowercase and de-duplicated. Empty array when untagged. */
9764
- tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
9765
- /** ID of the team that owns this task (`tem_...`). `null` if the task is not scoped to a team. */
10442
+ /** ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team. */
9766
10443
  team: z.ZodOptional<z.ZodString>;
9767
- /** ID of the thread this task is bound to (`thr_...`) — the conversation it was filed from, or the thread passed at creation. `null` for tasks not tied to a thread. */
9768
- thread: z.ZodOptional<z.ZodString>;
9769
- /** When the task was last modified (ISO 8601). */
10444
+ /** When the trajectory record was last updated (ISO 8601). */
9770
10445
  updated_at: z.ZodOptional<z.ZodString>;
9771
- /** ID of the user that owns this task (`usr_...`). `null` if the task is scoped to a team. */
9772
- user: z.ZodOptional<z.ZodString>;
9773
10446
  }, "strip", z.ZodTypeAny, {
9774
- name: string;
9775
- status: string;
9776
10447
  id: string;
9777
- agent?: string | undefined;
9778
- thread?: string | undefined;
9779
10448
  team?: string | undefined;
9780
10449
  org?: string | undefined;
9781
- description?: string | undefined;
9782
10450
  created_at?: string | undefined;
9783
10451
  updated_at?: string | undefined;
9784
- user?: string | undefined;
9785
10452
  sandbox?: string | undefined;
9786
- parent?: string | undefined;
9787
- metadata?: Record<string, unknown> | undefined;
9788
- blocked_by_count?: number | undefined;
9789
- closed_at?: string | undefined;
9790
- comments_count?: number | undefined;
9791
- created_by_actor?: {
9792
- alias?: string | undefined;
9793
- name?: string | undefined;
9794
- id?: string | undefined;
9795
- profile_picture?: {
9796
- mime_type?: string | undefined;
9797
- file?: string | undefined;
9798
- height?: number | undefined;
9799
- media?: string | undefined;
9800
- refresh_url?: string | undefined;
9801
- url?: string | undefined;
9802
- width?: number | undefined;
9803
- } | undefined;
9804
- } | undefined;
9805
- created_by_agent?: string | undefined;
9806
- created_by_user?: string | undefined;
9807
- due_date?: string | undefined;
9808
- is_blocked?: boolean | undefined;
9809
- links?: Record<string, unknown> | undefined;
9810
- owner_actor?: {
9811
- alias?: string | undefined;
9812
- name?: string | undefined;
9813
- id?: string | undefined;
9814
- profile_picture?: {
9815
- mime_type?: string | undefined;
9816
- file?: string | undefined;
9817
- height?: number | undefined;
9818
- media?: string | undefined;
9819
- refresh_url?: string | undefined;
9820
- url?: string | undefined;
9821
- width?: number | undefined;
9822
- } | undefined;
9823
- } | undefined;
9824
- owner_agent?: string | undefined;
9825
- owner_user?: string | undefined;
9826
- priority?: number | undefined;
9827
- subtasks_count?: number | undefined;
9828
- tags?: string[] | undefined;
10453
+ file?: string | undefined;
10454
+ messages?: Record<string, unknown> | undefined;
9829
10455
  }, {
9830
- name: string;
9831
- status: string;
9832
10456
  id: string;
9833
- agent?: string | undefined;
9834
- thread?: string | undefined;
9835
10457
  team?: string | undefined;
9836
10458
  org?: string | undefined;
9837
- description?: string | undefined;
9838
10459
  created_at?: string | undefined;
9839
10460
  updated_at?: string | undefined;
9840
- user?: string | undefined;
9841
10461
  sandbox?: string | undefined;
9842
- parent?: string | undefined;
9843
- metadata?: Record<string, unknown> | undefined;
9844
- blocked_by_count?: number | undefined;
9845
- closed_at?: string | undefined;
9846
- comments_count?: number | undefined;
9847
- created_by_actor?: {
9848
- alias?: string | undefined;
9849
- name?: string | undefined;
9850
- id?: string | undefined;
9851
- profile_picture?: {
9852
- mime_type?: string | undefined;
9853
- file?: string | undefined;
9854
- height?: number | undefined;
9855
- media?: string | undefined;
9856
- refresh_url?: string | undefined;
9857
- url?: string | undefined;
9858
- width?: number | undefined;
9859
- } | undefined;
9860
- } | undefined;
9861
- created_by_agent?: string | undefined;
9862
- created_by_user?: string | undefined;
9863
- due_date?: string | undefined;
9864
- is_blocked?: boolean | undefined;
9865
- links?: Record<string, unknown> | undefined;
9866
- owner_actor?: {
9867
- alias?: string | undefined;
9868
- name?: string | undefined;
9869
- id?: string | undefined;
9870
- profile_picture?: {
9871
- mime_type?: string | undefined;
9872
- file?: string | undefined;
9873
- height?: number | undefined;
9874
- media?: string | undefined;
9875
- refresh_url?: string | undefined;
9876
- url?: string | undefined;
9877
- width?: number | undefined;
9878
- } | undefined;
9879
- } | undefined;
9880
- owner_agent?: string | undefined;
9881
- owner_user?: string | undefined;
9882
- priority?: number | undefined;
9883
- subtasks_count?: number | undefined;
9884
- tags?: string[] | undefined;
10462
+ file?: string | undefined;
10463
+ messages?: Record<string, unknown> | undefined;
9885
10464
  }>;
9886
10465
  /** The result of a configuration validation check, indicating whether the config is valid and listing any errors or warnings. */
9887
10466
  export interface ValidationResult {
@@ -19533,7 +20112,7 @@ export declare const agentRoutineRunDeliverySchema: z.ZodObject<{
19533
20112
  type: z.ZodEnum<["none", "thread", "reply"]>;
19534
20113
  }, "strip", z.ZodTypeAny, {
19535
20114
  type: "thread" | "none" | "reply";
19536
- status: "not_requested" | "pending" | "delivered" | "failed";
20115
+ status: "pending" | "failed" | "not_requested" | "delivered";
19537
20116
  message?: string | undefined;
19538
20117
  thread?: string | undefined;
19539
20118
  delivered_at?: string | undefined;
@@ -19541,7 +20120,7 @@ export declare const agentRoutineRunDeliverySchema: z.ZodObject<{
19541
20120
  last_error?: string | undefined;
19542
20121
  }, {
19543
20122
  type: "thread" | "none" | "reply";
19544
- status: "not_requested" | "pending" | "delivered" | "failed";
20123
+ status: "pending" | "failed" | "not_requested" | "delivered";
19545
20124
  message?: string | undefined;
19546
20125
  thread?: string | undefined;
19547
20126
  delivered_at?: string | undefined;
@@ -19691,7 +20270,7 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
19691
20270
  type: z.ZodEnum<["none", "thread", "reply"]>;
19692
20271
  }, "strip", z.ZodTypeAny, {
19693
20272
  type: "thread" | "none" | "reply";
19694
- status: "not_requested" | "pending" | "delivered" | "failed";
20273
+ status: "pending" | "failed" | "not_requested" | "delivered";
19695
20274
  message?: string | undefined;
19696
20275
  thread?: string | undefined;
19697
20276
  delivered_at?: string | undefined;
@@ -19699,7 +20278,7 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
19699
20278
  last_error?: string | undefined;
19700
20279
  }, {
19701
20280
  type: "thread" | "none" | "reply";
19702
- status: "not_requested" | "pending" | "delivered" | "failed";
20281
+ status: "pending" | "failed" | "not_requested" | "delivered";
19703
20282
  message?: string | undefined;
19704
20283
  thread?: string | undefined;
19705
20284
  delivered_at?: string | undefined;
@@ -19775,7 +20354,7 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
19775
20354
  } | undefined;
19776
20355
  delivery?: {
19777
20356
  type: "thread" | "none" | "reply";
19778
- status: "not_requested" | "pending" | "delivered" | "failed";
20357
+ status: "pending" | "failed" | "not_requested" | "delivered";
19779
20358
  message?: string | undefined;
19780
20359
  thread?: string | undefined;
19781
20360
  delivered_at?: string | undefined;
@@ -19820,7 +20399,7 @@ export declare const agentRoutineRunSchema: z.ZodObject<{
19820
20399
  } | undefined;
19821
20400
  delivery?: {
19822
20401
  type: "thread" | "none" | "reply";
19823
- status: "not_requested" | "pending" | "delivered" | "failed";
20402
+ status: "pending" | "failed" | "not_requested" | "delivered";
19824
20403
  message?: string | undefined;
19825
20404
  thread?: string | undefined;
19826
20405
  delivered_at?: string | undefined;
@@ -19957,7 +20536,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
19957
20536
  type: z.ZodEnum<["none", "thread", "reply"]>;
19958
20537
  }, "strip", z.ZodTypeAny, {
19959
20538
  type: "thread" | "none" | "reply";
19960
- status: "not_requested" | "pending" | "delivered" | "failed";
20539
+ status: "pending" | "failed" | "not_requested" | "delivered";
19961
20540
  message?: string | undefined;
19962
20541
  thread?: string | undefined;
19963
20542
  delivered_at?: string | undefined;
@@ -19965,7 +20544,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
19965
20544
  last_error?: string | undefined;
19966
20545
  }, {
19967
20546
  type: "thread" | "none" | "reply";
19968
- status: "not_requested" | "pending" | "delivered" | "failed";
20547
+ status: "pending" | "failed" | "not_requested" | "delivered";
19969
20548
  message?: string | undefined;
19970
20549
  thread?: string | undefined;
19971
20550
  delivered_at?: string | undefined;
@@ -20041,7 +20620,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
20041
20620
  } | undefined;
20042
20621
  delivery?: {
20043
20622
  type: "thread" | "none" | "reply";
20044
- status: "not_requested" | "pending" | "delivered" | "failed";
20623
+ status: "pending" | "failed" | "not_requested" | "delivered";
20045
20624
  message?: string | undefined;
20046
20625
  thread?: string | undefined;
20047
20626
  delivered_at?: string | undefined;
@@ -20086,7 +20665,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
20086
20665
  } | undefined;
20087
20666
  delivery?: {
20088
20667
  type: "thread" | "none" | "reply";
20089
- status: "not_requested" | "pending" | "delivered" | "failed";
20668
+ status: "pending" | "failed" | "not_requested" | "delivered";
20090
20669
  message?: string | undefined;
20091
20670
  thread?: string | undefined;
20092
20671
  delivered_at?: string | undefined;
@@ -20133,7 +20712,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
20133
20712
  } | undefined;
20134
20713
  delivery?: {
20135
20714
  type: "thread" | "none" | "reply";
20136
- status: "not_requested" | "pending" | "delivered" | "failed";
20715
+ status: "pending" | "failed" | "not_requested" | "delivered";
20137
20716
  message?: string | undefined;
20138
20717
  thread?: string | undefined;
20139
20718
  delivered_at?: string | undefined;
@@ -20182,7 +20761,7 @@ export declare const agentRoutineRunListResponseSchema: z.ZodObject<{
20182
20761
  } | undefined;
20183
20762
  delivery?: {
20184
20763
  type: "thread" | "none" | "reply";
20185
- status: "not_requested" | "pending" | "delivered" | "failed";
20764
+ status: "pending" | "failed" | "not_requested" | "delivered";
20186
20765
  message?: string | undefined;
20187
20766
  thread?: string | undefined;
20188
20767
  delivered_at?: string | undefined;
@@ -25742,6 +26321,22 @@ export declare const solutionImportResponseSchema: z.ZodObject<{
25742
26321
  lookup_key?: string | undefined;
25743
26322
  }[] | undefined;
25744
26323
  }>;
26324
+ /** One-time connection details for a webhook-auth Automation install. */
26325
+ export interface SolutionInstallResponseWebhook {
26326
+ signing_secret: string;
26327
+ url: string;
26328
+ }
26329
+ /** Runtime validator for {@link SolutionInstallResponseWebhook}. */
26330
+ export declare const solutionInstallResponseWebhookSchema: z.ZodObject<{
26331
+ signing_secret: z.ZodString;
26332
+ url: z.ZodString;
26333
+ }, "strip", z.ZodTypeAny, {
26334
+ url: string;
26335
+ signing_secret: string;
26336
+ }, {
26337
+ url: string;
26338
+ signing_secret: string;
26339
+ }>;
25745
26340
  /** The runtime resource provisioned by installing a Solution, along with a reference back to the source Solution config. */
25746
26341
  export interface SolutionInstallResponse {
25747
26342
  /** Public ID of the provisioned resource. The prefix reflects the resource kind: `agi_...` for Agent, `aut_...` for Automation, `art_...` for AgentRoutine, `att_...` for AgentTool, `ask_...` for AgentSkill, `cmp_...` for AgentComputer. */
@@ -25752,6 +26347,8 @@ export interface SolutionInstallResponse {
25752
26347
  lookup_key?: string | undefined;
25753
26348
  /** Solution config ID (`cfg_...`) that was used as the source for this install. */
25754
26349
  solution: string;
26350
+ /** One-time connection details for a webhook-auth Automation install. */
26351
+ webhook?: SolutionInstallResponseWebhook | undefined;
25755
26352
  }
25756
26353
  /** Runtime validator for {@link SolutionInstallResponse}. */
25757
26354
  export declare const solutionInstallResponseSchema: z.ZodObject<{
@@ -25763,21 +26360,42 @@ export declare const solutionInstallResponseSchema: z.ZodObject<{
25763
26360
  lookup_key: z.ZodOptional<z.ZodString>;
25764
26361
  /** Solution config ID (`cfg_...`) that was used as the source for this install. */
25765
26362
  solution: z.ZodString;
26363
+ /** One-time connection details for a webhook-auth Automation install. */
26364
+ webhook: z.ZodOptional<z.ZodObject<{
26365
+ signing_secret: z.ZodString;
26366
+ url: z.ZodString;
26367
+ }, "strip", z.ZodTypeAny, {
26368
+ url: string;
26369
+ signing_secret: string;
26370
+ }, {
26371
+ url: string;
26372
+ signing_secret: string;
26373
+ }>>;
25766
26374
  }, "strip", z.ZodTypeAny, {
25767
26375
  kind: string;
25768
26376
  id: string;
25769
26377
  solution: string;
25770
26378
  lookup_key?: string | undefined;
26379
+ webhook?: {
26380
+ url: string;
26381
+ signing_secret: string;
26382
+ } | undefined;
25771
26383
  }, {
25772
26384
  kind: string;
25773
26385
  id: string;
25774
26386
  solution: string;
25775
26387
  lookup_key?: string | undefined;
26388
+ webhook?: {
26389
+ url: string;
26390
+ signing_secret: string;
26391
+ } | undefined;
25776
26392
  }>;
25777
26393
  /** A customer-keyed instance stamped from an installed solution template. */
25778
26394
  export interface SolutionInstance {
25779
26395
  /** Materialized agent for this customer (`agi_...`). `null` for a row without an agent. */
25780
26396
  agent?: string | undefined;
26397
+ /** Human-readable display name of the materialized agent. `null` when no agent is visible. */
26398
+ agent_name?: string | undefined;
25781
26399
  /** Opaque tagged reference to the deployment target. Consumers interpret its kind. */
25782
26400
  attachment_ref?: Record<string, unknown> | undefined;
25783
26401
  /** When this instance was stamped. */
@@ -25805,6 +26423,8 @@ export interface SolutionInstance {
25805
26423
  export declare const solutionInstanceSchema: z.ZodObject<{
25806
26424
  /** Materialized agent for this customer (`agi_...`). `null` for a row without an agent. */
25807
26425
  agent: z.ZodOptional<z.ZodString>;
26426
+ /** Human-readable display name of the materialized agent. `null` when no agent is visible. */
26427
+ agent_name: z.ZodOptional<z.ZodString>;
25808
26428
  /** Opaque tagged reference to the deployment target. Consumers interpret its kind. */
25809
26429
  attachment_ref: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
25810
26430
  /** When this instance was stamped. */
@@ -25836,6 +26456,7 @@ export declare const solutionInstanceSchema: z.ZodObject<{
25836
26456
  solution_template_config: string;
25837
26457
  agent?: string | undefined;
25838
26458
  customer_label?: string | undefined;
26459
+ agent_name?: string | undefined;
25839
26460
  attachment_ref?: Record<string, unknown> | undefined;
25840
26461
  local_edit_count?: number | undefined;
25841
26462
  pinned_template_version?: string | undefined;
@@ -25849,6 +26470,7 @@ export declare const solutionInstanceSchema: z.ZodObject<{
25849
26470
  solution_template_config: string;
25850
26471
  agent?: string | undefined;
25851
26472
  customer_label?: string | undefined;
26473
+ agent_name?: string | undefined;
25852
26474
  attachment_ref?: Record<string, unknown> | undefined;
25853
26475
  local_edit_count?: number | undefined;
25854
26476
  pinned_template_version?: string | undefined;
@@ -25875,6 +26497,8 @@ export declare const solutionInstanceListResponseSchema: z.ZodObject<{
25875
26497
  data: z.ZodArray<z.ZodObject<{
25876
26498
  /** Materialized agent for this customer (`agi_...`). `null` for a row without an agent. */
25877
26499
  agent: z.ZodOptional<z.ZodString>;
26500
+ /** Human-readable display name of the materialized agent. `null` when no agent is visible. */
26501
+ agent_name: z.ZodOptional<z.ZodString>;
25878
26502
  /** Opaque tagged reference to the deployment target. Consumers interpret its kind. */
25879
26503
  attachment_ref: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
25880
26504
  /** When this instance was stamped. */
@@ -25906,6 +26530,7 @@ export declare const solutionInstanceListResponseSchema: z.ZodObject<{
25906
26530
  solution_template_config: string;
25907
26531
  agent?: string | undefined;
25908
26532
  customer_label?: string | undefined;
26533
+ agent_name?: string | undefined;
25909
26534
  attachment_ref?: Record<string, unknown> | undefined;
25910
26535
  local_edit_count?: number | undefined;
25911
26536
  pinned_template_version?: string | undefined;
@@ -25919,6 +26544,7 @@ export declare const solutionInstanceListResponseSchema: z.ZodObject<{
25919
26544
  solution_template_config: string;
25920
26545
  agent?: string | undefined;
25921
26546
  customer_label?: string | undefined;
26547
+ agent_name?: string | undefined;
25922
26548
  attachment_ref?: Record<string, unknown> | undefined;
25923
26549
  local_edit_count?: number | undefined;
25924
26550
  pinned_template_version?: string | undefined;
@@ -25936,6 +26562,7 @@ export declare const solutionInstanceListResponseSchema: z.ZodObject<{
25936
26562
  solution_template_config: string;
25937
26563
  agent?: string | undefined;
25938
26564
  customer_label?: string | undefined;
26565
+ agent_name?: string | undefined;
25939
26566
  attachment_ref?: Record<string, unknown> | undefined;
25940
26567
  local_edit_count?: number | undefined;
25941
26568
  pinned_template_version?: string | undefined;
@@ -25954,6 +26581,7 @@ export declare const solutionInstanceListResponseSchema: z.ZodObject<{
25954
26581
  solution_template_config: string;
25955
26582
  agent?: string | undefined;
25956
26583
  customer_label?: string | undefined;
26584
+ agent_name?: string | undefined;
25957
26585
  attachment_ref?: Record<string, unknown> | undefined;
25958
26586
  local_edit_count?: number | undefined;
25959
26587
  pinned_template_version?: string | undefined;