@rox-one/sdk 0.0.0-stage → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CALLS.md +82 -0
- package/README.md +1259 -2
- package/dist/chunk-AOHK5YXC.js +5585 -0
- package/dist/chunk-CATFKTFD.js +80 -0
- package/dist/chunk-FQGPXWPJ.js +1491 -0
- package/dist/chunk-G43PLP2U.js +1087 -0
- package/dist/chunk-LMJW65ML.js +836 -0
- package/dist/chunk-MCSQNZ4E.js +836 -0
- package/dist/chunk-NSJ3GKUC.js +1552 -0
- package/dist/chunk-OGFKJOK7.js +2068 -0
- package/dist/chunk-RDEJZJBZ.js +1351 -0
- package/dist/chunk-TMTYN2UK.js +1128 -0
- package/dist/chunk-V45LUJDI.js +838 -0
- package/dist/chunk-YRUXFEZM.js +1044 -0
- package/dist/chunk-ZYBAKW25.js +994 -0
- package/dist/generated/agent-fold/index.d.ts +4520 -0
- package/dist/generated/agent-fold/index.js +0 -0
- package/dist/generated/agent-harness/client/client.gen.d.ts +2 -0
- package/dist/generated/agent-harness/client/index.d.ts +10 -0
- package/dist/generated/agent-harness/client/types.gen.d.ts +120 -0
- package/dist/generated/agent-harness/client/utils.gen.d.ts +37 -0
- package/dist/generated/agent-harness/client.gen.d.ts +12 -0
- package/dist/generated/agent-harness/core/auth.gen.d.ts +25 -0
- package/dist/generated/agent-harness/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/agent-harness/core/params.gen.d.ts +43 -0
- package/dist/generated/agent-harness/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/agent-harness/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/agent-harness/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/agent-harness/core/types.gen.d.ts +83 -0
- package/dist/generated/agent-harness/core/utils.gen.d.ts +19 -0
- package/dist/generated/agent-harness/index.d.ts +2 -0
- package/dist/generated/agent-harness/index.js +6 -0
- package/dist/generated/agent-harness/sdk.gen.d.ts +375 -0
- package/dist/generated/agent-harness/types.gen.d.ts +4725 -0
- package/dist/generated/agent-reviews/index.d.ts +895 -0
- package/dist/generated/agent-reviews/index.js +0 -0
- package/dist/generated/auth/client/client.gen.d.ts +2 -0
- package/dist/generated/auth/client/index.d.ts +10 -0
- package/dist/generated/auth/client/types.gen.d.ts +120 -0
- package/dist/generated/auth/client/utils.gen.d.ts +37 -0
- package/dist/generated/auth/client.gen.d.ts +12 -0
- package/dist/generated/auth/core/auth.gen.d.ts +25 -0
- package/dist/generated/auth/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/auth/core/params.gen.d.ts +43 -0
- package/dist/generated/auth/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/auth/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/auth/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/auth/core/types.gen.d.ts +83 -0
- package/dist/generated/auth/core/utils.gen.d.ts +19 -0
- package/dist/generated/auth/index.d.ts +2 -0
- package/dist/generated/auth/index.js +6 -0
- package/dist/generated/auth/sdk.gen.d.ts +674 -0
- package/dist/generated/auth/types.gen.d.ts +5233 -0
- package/dist/generated/calendar/client/client.gen.d.ts +2 -0
- package/dist/generated/calendar/client/index.d.ts +10 -0
- package/dist/generated/calendar/client/types.gen.d.ts +120 -0
- package/dist/generated/calendar/client/utils.gen.d.ts +37 -0
- package/dist/generated/calendar/client.gen.d.ts +12 -0
- package/dist/generated/calendar/core/auth.gen.d.ts +25 -0
- package/dist/generated/calendar/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/calendar/core/params.gen.d.ts +43 -0
- package/dist/generated/calendar/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/calendar/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/calendar/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/calendar/core/types.gen.d.ts +83 -0
- package/dist/generated/calendar/core/utils.gen.d.ts +19 -0
- package/dist/generated/calendar/index.d.ts +2 -0
- package/dist/generated/calendar/index.js +6 -0
- package/dist/generated/calendar/sdk.gen.d.ts +157 -0
- package/dist/generated/calendar/types.gen.d.ts +2333 -0
- package/dist/generated/cognition/client/client.gen.d.ts +2 -0
- package/dist/generated/cognition/client/index.d.ts +10 -0
- package/dist/generated/cognition/client/types.gen.d.ts +120 -0
- package/dist/generated/cognition/client/utils.gen.d.ts +37 -0
- package/dist/generated/cognition/client.gen.d.ts +12 -0
- package/dist/generated/cognition/core/auth.gen.d.ts +25 -0
- package/dist/generated/cognition/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/cognition/core/params.gen.d.ts +43 -0
- package/dist/generated/cognition/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/cognition/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/cognition/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/cognition/core/types.gen.d.ts +83 -0
- package/dist/generated/cognition/core/utils.gen.d.ts +19 -0
- package/dist/generated/cognition/index.d.ts +2 -0
- package/dist/generated/cognition/index.js +6 -0
- package/dist/generated/cognition/sdk.gen.d.ts +348 -0
- package/dist/generated/cognition/types.gen.d.ts +4228 -0
- package/dist/generated/connection/client/client.gen.d.ts +2 -0
- package/dist/generated/connection/client/index.d.ts +10 -0
- package/dist/generated/connection/client/types.gen.d.ts +120 -0
- package/dist/generated/connection/client/utils.gen.d.ts +37 -0
- package/dist/generated/connection/client.gen.d.ts +12 -0
- package/dist/generated/connection/core/auth.gen.d.ts +25 -0
- package/dist/generated/connection/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/connection/core/params.gen.d.ts +43 -0
- package/dist/generated/connection/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/connection/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/connection/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/connection/core/types.gen.d.ts +83 -0
- package/dist/generated/connection/core/utils.gen.d.ts +19 -0
- package/dist/generated/connection/index.d.ts +2 -0
- package/dist/generated/connection/index.js +854 -0
- package/dist/generated/connection/sdk.gen.d.ts +43 -0
- package/dist/generated/connection/types.gen.d.ts +252 -0
- package/dist/generated/contacts/client/client.gen.d.ts +2 -0
- package/dist/generated/contacts/client/index.d.ts +10 -0
- package/dist/generated/contacts/client/types.gen.d.ts +120 -0
- package/dist/generated/contacts/client/utils.gen.d.ts +37 -0
- package/dist/generated/contacts/client.gen.d.ts +12 -0
- package/dist/generated/contacts/core/auth.gen.d.ts +25 -0
- package/dist/generated/contacts/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/contacts/core/params.gen.d.ts +43 -0
- package/dist/generated/contacts/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/contacts/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/contacts/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/contacts/core/types.gen.d.ts +83 -0
- package/dist/generated/contacts/core/utils.gen.d.ts +19 -0
- package/dist/generated/contacts/index.d.ts +2 -0
- package/dist/generated/contacts/index.js +6 -0
- package/dist/generated/contacts/sdk.gen.d.ts +47 -0
- package/dist/generated/contacts/types.gen.d.ts +108 -0
- package/dist/generated/email/client/client.gen.d.ts +2 -0
- package/dist/generated/email/client/index.d.ts +10 -0
- package/dist/generated/email/client/types.gen.d.ts +120 -0
- package/dist/generated/email/client/utils.gen.d.ts +37 -0
- package/dist/generated/email/client.gen.d.ts +12 -0
- package/dist/generated/email/core/auth.gen.d.ts +25 -0
- package/dist/generated/email/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/email/core/params.gen.d.ts +43 -0
- package/dist/generated/email/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/email/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/email/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/email/core/types.gen.d.ts +83 -0
- package/dist/generated/email/core/utils.gen.d.ts +19 -0
- package/dist/generated/email/index.d.ts +2 -0
- package/dist/generated/email/index.js +6 -0
- package/dist/generated/email/sdk.gen.d.ts +301 -0
- package/dist/generated/email/types.gen.d.ts +3262 -0
- package/dist/generated/notification/client/client.gen.d.ts +2 -0
- package/dist/generated/notification/client/index.d.ts +10 -0
- package/dist/generated/notification/client/types.gen.d.ts +120 -0
- package/dist/generated/notification/client/utils.gen.d.ts +37 -0
- package/dist/generated/notification/client.gen.d.ts +12 -0
- package/dist/generated/notification/core/auth.gen.d.ts +25 -0
- package/dist/generated/notification/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/notification/core/params.gen.d.ts +43 -0
- package/dist/generated/notification/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/notification/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/notification/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/notification/core/types.gen.d.ts +83 -0
- package/dist/generated/notification/core/utils.gen.d.ts +19 -0
- package/dist/generated/notification/index.d.ts +2 -0
- package/dist/generated/notification/index.js +6 -0
- package/dist/generated/notification/sdk.gen.d.ts +127 -0
- package/dist/generated/notification/types.gen.d.ts +2084 -0
- package/dist/generated/properties/client/client.gen.d.ts +2 -0
- package/dist/generated/properties/client/index.d.ts +10 -0
- package/dist/generated/properties/client/types.gen.d.ts +120 -0
- package/dist/generated/properties/client/utils.gen.d.ts +37 -0
- package/dist/generated/properties/client.gen.d.ts +12 -0
- package/dist/generated/properties/core/auth.gen.d.ts +25 -0
- package/dist/generated/properties/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/properties/core/params.gen.d.ts +43 -0
- package/dist/generated/properties/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/properties/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/properties/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/properties/core/types.gen.d.ts +83 -0
- package/dist/generated/properties/core/utils.gen.d.ts +19 -0
- package/dist/generated/properties/index.d.ts +2 -0
- package/dist/generated/properties/index.js +6 -0
- package/dist/generated/properties/sdk.gen.d.ts +158 -0
- package/dist/generated/properties/types.gen.d.ts +1311 -0
- package/dist/generated/scheduled-action/client/client.gen.d.ts +2 -0
- package/dist/generated/scheduled-action/client/index.d.ts +10 -0
- package/dist/generated/scheduled-action/client/types.gen.d.ts +120 -0
- package/dist/generated/scheduled-action/client/utils.gen.d.ts +37 -0
- package/dist/generated/scheduled-action/client.gen.d.ts +12 -0
- package/dist/generated/scheduled-action/core/auth.gen.d.ts +25 -0
- package/dist/generated/scheduled-action/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/scheduled-action/core/params.gen.d.ts +43 -0
- package/dist/generated/scheduled-action/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/scheduled-action/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/scheduled-action/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/scheduled-action/core/types.gen.d.ts +83 -0
- package/dist/generated/scheduled-action/core/utils.gen.d.ts +19 -0
- package/dist/generated/scheduled-action/index.d.ts +2 -0
- package/dist/generated/scheduled-action/index.js +6 -0
- package/dist/generated/scheduled-action/sdk.gen.d.ts +156 -0
- package/dist/generated/scheduled-action/types.gen.d.ts +3099 -0
- package/dist/generated/search/client/client.gen.d.ts +2 -0
- package/dist/generated/search/client/index.d.ts +10 -0
- package/dist/generated/search/client/types.gen.d.ts +120 -0
- package/dist/generated/search/client/utils.gen.d.ts +37 -0
- package/dist/generated/search/client.gen.d.ts +12 -0
- package/dist/generated/search/core/auth.gen.d.ts +25 -0
- package/dist/generated/search/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/search/core/params.gen.d.ts +43 -0
- package/dist/generated/search/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/search/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/search/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/search/core/types.gen.d.ts +83 -0
- package/dist/generated/search/core/utils.gen.d.ts +19 -0
- package/dist/generated/search/index.d.ts +2 -0
- package/dist/generated/search/index.js +6 -0
- package/dist/generated/search/sdk.gen.d.ts +44 -0
- package/dist/generated/search/types.gen.d.ts +2532 -0
- package/dist/generated/static-files/client/client.gen.d.ts +2 -0
- package/dist/generated/static-files/client/index.d.ts +10 -0
- package/dist/generated/static-files/client/types.gen.d.ts +120 -0
- package/dist/generated/static-files/client/utils.gen.d.ts +37 -0
- package/dist/generated/static-files/client.gen.d.ts +12 -0
- package/dist/generated/static-files/core/auth.gen.d.ts +25 -0
- package/dist/generated/static-files/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/static-files/core/params.gen.d.ts +43 -0
- package/dist/generated/static-files/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/static-files/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/static-files/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/static-files/core/types.gen.d.ts +83 -0
- package/dist/generated/static-files/core/utils.gen.d.ts +19 -0
- package/dist/generated/static-files/index.d.ts +2 -0
- package/dist/generated/static-files/index.js +842 -0
- package/dist/generated/static-files/sdk.gen.d.ts +43 -0
- package/dist/generated/static-files/types.gen.d.ts +220 -0
- package/dist/generated/storage/client/client.gen.d.ts +2 -0
- package/dist/generated/storage/client/index.d.ts +10 -0
- package/dist/generated/storage/client/types.gen.d.ts +120 -0
- package/dist/generated/storage/client/utils.gen.d.ts +37 -0
- package/dist/generated/storage/client.gen.d.ts +12 -0
- package/dist/generated/storage/core/auth.gen.d.ts +25 -0
- package/dist/generated/storage/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/storage/core/params.gen.d.ts +43 -0
- package/dist/generated/storage/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/storage/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/storage/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/storage/core/types.gen.d.ts +83 -0
- package/dist/generated/storage/core/utils.gen.d.ts +19 -0
- package/dist/generated/storage/index.d.ts +2 -0
- package/dist/generated/storage/index.js +6 -0
- package/dist/generated/storage/sdk.gen.d.ts +2285 -0
- package/dist/generated/storage/types.gen.d.ts +34546 -0
- package/dist/generated/unfurl/client/client.gen.d.ts +2 -0
- package/dist/generated/unfurl/client/index.d.ts +10 -0
- package/dist/generated/unfurl/client/types.gen.d.ts +120 -0
- package/dist/generated/unfurl/client/utils.gen.d.ts +37 -0
- package/dist/generated/unfurl/client.gen.d.ts +12 -0
- package/dist/generated/unfurl/core/auth.gen.d.ts +25 -0
- package/dist/generated/unfurl/core/bodySerializer.gen.d.ts +25 -0
- package/dist/generated/unfurl/core/params.gen.d.ts +43 -0
- package/dist/generated/unfurl/core/pathSerializer.gen.d.ts +33 -0
- package/dist/generated/unfurl/core/queryKeySerializer.gen.d.ts +18 -0
- package/dist/generated/unfurl/core/serverSentEvents.gen.d.ts +71 -0
- package/dist/generated/unfurl/core/types.gen.d.ts +83 -0
- package/dist/generated/unfurl/core/utils.gen.d.ts +19 -0
- package/dist/generated/unfurl/index.d.ts +2 -0
- package/dist/generated/unfurl/index.js +6 -0
- package/dist/generated/unfurl/sdk.gen.d.ts +47 -0
- package/dist/generated/unfurl/types.gen.d.ts +145 -0
- package/dist/src/calls/browser.d.ts +14 -0
- package/dist/src/calls/browser.js +102 -0
- package/dist/src/calls/common.d.ts +18 -0
- package/dist/src/calls/node.d.ts +24 -0
- package/dist/src/calls/node.js +145 -0
- package/dist/src/calls/telemetry.d.ts +5 -0
- package/dist/src/config.d.ts +71 -0
- package/dist/src/entities/account-managers/grant.d.ts +62 -0
- package/dist/src/entities/account-managers/namespace.d.ts +29 -0
- package/dist/src/entities/activity/entity.d.ts +7 -0
- package/dist/src/entities/activity/namespace.d.ts +58 -0
- package/dist/src/entities/activity/namespace.test.d.ts +1 -0
- package/dist/src/entities/agent-sessions/activity.d.ts +48 -0
- package/dist/src/entities/agent-sessions/agent-session.d.ts +518 -0
- package/dist/src/entities/agent-sessions/code-execution.d.ts +60 -0
- package/dist/src/entities/agent-sessions/conversation.d.ts +91 -0
- package/dist/src/entities/agent-sessions/namespace.d.ts +142 -0
- package/dist/src/entities/agent-sessions/origin.d.ts +94 -0
- package/dist/src/entities/agent-sessions/queued-action.d.ts +60 -0
- package/dist/src/entities/agent-sessions/review.d.ts +114 -0
- package/dist/src/entities/agent-sessions/tool-approval.d.ts +25 -0
- package/dist/src/entities/agent-sessions/view.d.ts +11 -0
- package/dist/src/entities/agents/agent.d.ts +142 -0
- package/dist/src/entities/agents/namespace.d.ts +66 -0
- package/dist/src/entities/ai/namespace.d.ts +36 -0
- package/dist/src/entities/api-keys/api-key.d.ts +22 -0
- package/dist/src/entities/api-keys/namespace.d.ts +37 -0
- package/dist/src/entities/bots/bot.d.ts +143 -0
- package/dist/src/entities/bots/namespace.d.ts +50 -0
- package/dist/src/entities/bots/token.d.ts +39 -0
- package/dist/src/entities/calendar/booking-link.d.ts +55 -0
- package/dist/src/entities/calendar/booking-namespace.d.ts +143 -0
- package/dist/src/entities/calendar/booking-namespace.test.d.ts +1 -0
- package/dist/src/entities/calendar/booking.d.ts +97 -0
- package/dist/src/entities/calendar/calendar.d.ts +49 -0
- package/dist/src/entities/calendar/create-confirmed.test.d.ts +1 -0
- package/dist/src/entities/calendar/event.d.ts +283 -0
- package/dist/src/entities/calendar/event.test.d.ts +1 -0
- package/dist/src/entities/calendar/namespace.d.ts +334 -0
- package/dist/src/entities/calendar/namespace.test.d.ts +1 -0
- package/dist/src/entities/calendar/replacement.d.ts +31 -0
- package/dist/src/entities/calls/call-record.d.ts +231 -0
- package/dist/src/entities/calls/connection.d.ts +59 -0
- package/dist/src/entities/calls/errors.d.ts +15 -0
- package/dist/src/entities/calls/message.d.ts +55 -0
- package/dist/src/entities/calls/namespace.d.ts +41 -0
- package/dist/src/entities/calls/participant.d.ts +22 -0
- package/dist/src/entities/canvases/canvas.d.ts +329 -0
- package/dist/src/entities/channels/access-request.d.ts +42 -0
- package/dist/src/entities/channels/activity.d.ts +40 -0
- package/dist/src/entities/channels/channel.d.ts +302 -0
- package/dist/src/entities/channels/labels.d.ts +73 -0
- package/dist/src/entities/channels/message.d.ts +153 -0
- package/dist/src/entities/channels/message.test.d.ts +1 -0
- package/dist/src/entities/channels/namespace.d.ts +82 -0
- package/dist/src/entities/channels/namespace.test.d.ts +1 -0
- package/dist/src/entities/channels/picture.d.ts +11 -0
- package/dist/src/entities/channels/post.d.ts +37 -0
- package/dist/src/entities/channels/post.test.d.ts +1 -0
- package/dist/src/entities/channels/share.d.ts +9 -0
- package/dist/src/entities/channels/share.test.d.ts +1 -0
- package/dist/src/entities/channels/thread.d.ts +64 -0
- package/dist/src/entities/chats/chat.d.ts +121 -0
- package/dist/src/entities/chats/generation.d.ts +55 -0
- package/dist/src/entities/chats/namespace.d.ts +35 -0
- package/dist/src/entities/connected-apps/connected-app.d.ts +121 -0
- package/dist/src/entities/connected-apps/connector.d.ts +59 -0
- package/dist/src/entities/connected-apps/namespace.d.ts +92 -0
- package/dist/src/entities/crm/company.d.ts +154 -0
- package/dist/src/entities/crm/contact.d.ts +168 -0
- package/dist/src/entities/crm/namespace.d.ts +163 -0
- package/dist/src/entities/crm/pipeline-entry.d.ts +109 -0
- package/dist/src/entities/crm/pipeline.d.ts +426 -0
- package/dist/src/entities/crm/pipelines.d.ts +79 -0
- package/dist/src/entities/crm-email-privacy/email-privacy.d.ts +238 -0
- package/dist/src/entities/crm-email-privacy/email-rule-preview.d.ts +55 -0
- package/dist/src/entities/crm-email-privacy/email-rule-revision.d.ts +27 -0
- package/dist/src/entities/crm-email-privacy/email-rules.d.ts +32 -0
- package/dist/src/entities/databases/column.d.ts +122 -0
- package/dist/src/entities/databases/database.d.ts +431 -0
- package/dist/src/entities/databases/namespace.d.ts +109 -0
- package/dist/src/entities/databases/query.d.ts +86 -0
- package/dist/src/entities/databases/row.d.ts +29 -0
- package/dist/src/entities/databases/saved-query.d.ts +151 -0
- package/dist/src/entities/databases/table.d.ts +124 -0
- package/dist/src/entities/databases/view.d.ts +72 -0
- package/dist/src/entities/databases/webhook.d.ts +39 -0
- package/dist/src/entities/documents/ai-edit.d.ts +54 -0
- package/dist/src/entities/documents/anchor.d.ts +39 -0
- package/dist/src/entities/documents/comment.d.ts +68 -0
- package/dist/src/entities/documents/create.test.d.ts +1 -0
- package/dist/src/entities/documents/document.d.ts +675 -0
- package/dist/src/entities/documents/markdown.d.ts +25 -0
- package/dist/src/entities/documents/namespace.d.ts +291 -0
- package/dist/src/entities/documents/office-files.d.ts +47 -0
- package/dist/src/entities/documents/skills.test.d.ts +1 -0
- package/dist/src/entities/documents/system-skill.d.ts +36 -0
- package/dist/src/entities/documents/text-comment.d.ts +41 -0
- package/dist/src/entities/documents/text-comment.test.d.ts +1 -0
- package/dist/src/entities/documents/version.d.ts +26 -0
- package/dist/src/entities/email/attachment.d.ts +39 -0
- package/dist/src/entities/email/body-rox-compat.d.ts +22 -0
- package/dist/src/entities/email/draft.d.ts +164 -0
- package/dist/src/entities/email/filter.d.ts +44 -0
- package/dist/src/entities/email/label.d.ts +37 -0
- package/dist/src/entities/email/link.d.ts +35 -0
- package/dist/src/entities/email/message.d.ts +223 -0
- package/dist/src/entities/email/namespace.d.ts +235 -0
- package/dist/src/entities/email/namespace.test.d.ts +1 -0
- package/dist/src/entities/email/thread.d.ts +268 -0
- package/dist/src/entities/entity-mentions/mention.d.ts +21 -0
- package/dist/src/entities/entity-mentions/namespace.d.ts +20 -0
- package/dist/src/entities/entity.d.ts +167 -0
- package/dist/src/entities/external-chat/chat.d.ts +173 -0
- package/dist/src/entities/external-chat/message.d.ts +54 -0
- package/dist/src/entities/external-chat/namespace.d.ts +22 -0
- package/dist/src/entities/external-chat/participant.d.ts +28 -0
- package/dist/src/entities/external-chat/send.d.ts +40 -0
- package/dist/src/entities/external-chat/upload.d.ts +25 -0
- package/dist/src/entities/favorites/namespace.d.ts +52 -0
- package/dist/src/entities/foreign/foreign-entity.d.ts +36 -0
- package/dist/src/entities/foreign/namespace.d.ts +54 -0
- package/dist/src/entities/forms/form.d.ts +319 -0
- package/dist/src/entities/forms/namespace.d.ts +30 -0
- package/dist/src/entities/forms/question.d.ts +65 -0
- package/dist/src/entities/forms/response.d.ts +52 -0
- package/dist/src/entities/forms/section.d.ts +31 -0
- package/dist/src/entities/github-pull-requests/namespace.d.ts +20 -0
- package/dist/src/entities/github-pull-requests/pull-request.d.ts +64 -0
- package/dist/src/entities/harnesses/harness.d.ts +76 -0
- package/dist/src/entities/harnesses/namespace.d.ts +83 -0
- package/dist/src/entities/harnesses/pairing.d.ts +50 -0
- package/dist/src/entities/images/image.d.ts +88 -0
- package/dist/src/entities/images/namespace.d.ts +55 -0
- package/dist/src/entities/images/namespace.test.d.ts +1 -0
- package/dist/src/entities/imports/entry.d.ts +65 -0
- package/dist/src/entities/imports/namespace.d.ts +103 -0
- package/dist/src/entities/imports/namespace.test.d.ts +1 -0
- package/dist/src/entities/initiatives/initiative.d.ts +185 -0
- package/dist/src/entities/initiatives/initiative.test.d.ts +1 -0
- package/dist/src/entities/initiatives/namespace.d.ts +90 -0
- package/dist/src/entities/me/namespace.d.ts +68 -0
- package/dist/src/entities/meetings/meeting.d.ts +81 -0
- package/dist/src/entities/meetings/namespace.d.ts +38 -0
- package/dist/src/entities/memory/namespace.d.ts +49 -0
- package/dist/src/entities/memory/namespace.test.d.ts +1 -0
- package/dist/src/entities/messages/discussion.d.ts +84 -0
- package/dist/src/entities/messages/thread.d.ts +115 -0
- package/dist/src/entities/notifications/namespace.d.ts +66 -0
- package/dist/src/entities/notifications/notification.d.ts +78 -0
- package/dist/src/entities/notifications/notification.test.d.ts +1 -0
- package/dist/src/entities/passwords/item.d.ts +118 -0
- package/dist/src/entities/passwords/namespace.d.ts +45 -0
- package/dist/src/entities/pins/namespace.d.ts +42 -0
- package/dist/src/entities/projects/namespace.d.ts +45 -0
- package/dist/src/entities/projects/project.d.ts +108 -0
- package/dist/src/entities/properties/namespace.d.ts +105 -0
- package/dist/src/entities/properties/namespace.test.d.ts +1 -0
- package/dist/src/entities/properties/property-definition.d.ts +70 -0
- package/dist/src/entities/properties/property-option.d.ts +44 -0
- package/dist/src/entities/reference.d.ts +82 -0
- package/dist/src/entities/referrals/namespace.d.ts +40 -0
- package/dist/src/entities/routines/namespace.d.ts +239 -0
- package/dist/src/entities/routines/routine.d.ts +341 -0
- package/dist/src/entities/routines/suggestion.d.ts +38 -0
- package/dist/src/entities/saved-views/namespace.d.ts +58 -0
- package/dist/src/entities/saved-views/saved-view.d.ts +78 -0
- package/dist/src/entities/search/exclusions.d.ts +6 -0
- package/dist/src/entities/search/namespace.d.ts +71 -0
- package/dist/src/entities/search/options.d.ts +30 -0
- package/dist/src/entities/search/types.d.ts +90 -0
- package/dist/src/entities/sharing/access.d.ts +120 -0
- package/dist/src/entities/sharing/permissions.d.ts +13 -0
- package/dist/src/entities/spreadsheets/spreadsheet.d.ts +201 -0
- package/dist/src/entities/suggestions/namespace.d.ts +118 -0
- package/dist/src/entities/suggestions/suggestion.d.ts +172 -0
- package/dist/src/entities/suggestions/suggestion.test.d.ts +1 -0
- package/dist/src/entities/tasks/namespace.d.ts +77 -0
- package/dist/src/entities/tasks/task.d.ts +99 -0
- package/dist/src/entities/teams/invite.d.ts +33 -0
- package/dist/src/entities/teams/namespace.d.ts +23 -0
- package/dist/src/entities/teams/team.d.ts +129 -0
- package/dist/src/entities/ui/app-link.d.ts +24 -0
- package/dist/src/entities/ui/namespace.d.ts +75 -0
- package/dist/src/entities/unfurls/namespace.d.ts +24 -0
- package/dist/src/entities/users/namespace.d.ts +41 -0
- package/dist/src/entities/users/profile-picture.d.ts +29 -0
- package/dist/src/entities/users/profile-picture.test.d.ts +1 -0
- package/dist/src/entities/users/user.d.ts +102 -0
- package/dist/src/entities/web/namespace.d.ts +67 -0
- package/dist/src/entities/web/namespace.test.d.ts +1 -0
- package/dist/src/entities/webhooks/namespace.d.ts +38 -0
- package/dist/src/entities/webhooks/webhook.d.ts +130 -0
- package/dist/src/entities/whatsapp/account.d.ts +24 -0
- package/dist/src/entities/whatsapp/chat.d.ts +62 -0
- package/dist/src/entities/whatsapp/namespace.d.ts +29 -0
- package/dist/src/entities/workspace/items.d.ts +14 -0
- package/dist/src/entities/workspace/namespace.d.ts +96 -0
- package/dist/src/entities/workspace/query.d.ts +39 -0
- package/dist/src/entities/workspace/query.test.d.ts +1 -0
- package/dist/src/entities/workspace/types.d.ts +99 -0
- package/dist/src/events/hydrate/agentSession.d.ts +192 -0
- package/dist/src/events/hydrate/call.d.ts +101 -0
- package/dist/src/events/hydrate/channel.d.ts +55 -0
- package/dist/src/events/hydrate/document.d.ts +59 -0
- package/dist/src/events/hydrate/message.d.ts +70 -0
- package/dist/src/events/hydrate/user.d.ts +14 -0
- package/dist/src/events/receiver.d.ts +91 -0
- package/dist/src/events/types.d.ts +44 -0
- package/dist/src/events/verify.d.ts +13 -0
- package/dist/src/local-portmap.d.ts +8 -0
- package/dist/src/mentions.d.ts +42 -0
- package/dist/src/raw.d.ts +12 -0
- package/dist/src/rox.d.ts +268 -0
- package/dist/src/rox.js +23231 -0
- package/dist/src/utils/activity.d.ts +34 -0
- package/dist/src/utils/activity.test.d.ts +1 -0
- package/dist/src/utils/client.d.ts +62 -0
- package/dist/src/utils/concurrency.d.ts +5 -0
- package/dist/src/utils/index.d.ts +5 -0
- package/dist/src/utils/lazy.d.ts +37 -0
- package/dist/src/utils/options.d.ts +7 -0
- package/dist/src/utils/pagination.d.ts +28 -0
- package/dist/src/utils/unwrap.d.ts +48 -0
- package/dist/src/utils/verbs.d.ts +3 -0
- package/package.json +82 -4
|
@@ -0,0 +1,4725 @@
|
|
|
1
|
+
export type ClientOptions = {
|
|
2
|
+
baseUrl: `${string}://${string}` | (string & {});
|
|
3
|
+
};
|
|
4
|
+
/**
|
|
5
|
+
* Ordered from least to most access top -> bottom
|
|
6
|
+
*/
|
|
7
|
+
export type AccessLevel = 'view' | 'comment' | 'edit' | 'owner';
|
|
8
|
+
/**
|
|
9
|
+
* One activity row on the wire — the realtime projection of an inserted
|
|
10
|
+
* `activity_events` row.
|
|
11
|
+
*/
|
|
12
|
+
export type ActivityWireRow = {
|
|
13
|
+
/**
|
|
14
|
+
* The stored action tag.
|
|
15
|
+
*/
|
|
16
|
+
action: string;
|
|
17
|
+
/**
|
|
18
|
+
* The stored action payload, if any.
|
|
19
|
+
*/
|
|
20
|
+
action_payload?: unknown;
|
|
21
|
+
/**
|
|
22
|
+
* Who mechanically acted, as a principal string (`macro|…` / `bot|…`).
|
|
23
|
+
*/
|
|
24
|
+
actor_id: string;
|
|
25
|
+
/**
|
|
26
|
+
* Originating code-mode invocation, absent on older events.
|
|
27
|
+
*/
|
|
28
|
+
agent_correlation_id?: string | null;
|
|
29
|
+
/**
|
|
30
|
+
* SDK display verb, absent on older events.
|
|
31
|
+
*/
|
|
32
|
+
agent_verb?: string | null;
|
|
33
|
+
/**
|
|
34
|
+
* The entity acted on.
|
|
35
|
+
*/
|
|
36
|
+
entity_id: string;
|
|
37
|
+
/**
|
|
38
|
+
* The kind of entity acted on.
|
|
39
|
+
*/
|
|
40
|
+
entity_type: EntityType;
|
|
41
|
+
/**
|
|
42
|
+
* The stored activity id.
|
|
43
|
+
*/
|
|
44
|
+
id: string;
|
|
45
|
+
/**
|
|
46
|
+
* When it happened.
|
|
47
|
+
*/
|
|
48
|
+
occurred_at: string;
|
|
49
|
+
/**
|
|
50
|
+
* Whose activity this is (a principal string).
|
|
51
|
+
*/
|
|
52
|
+
subject_id: string;
|
|
53
|
+
};
|
|
54
|
+
/**
|
|
55
|
+
* One thing a caller wants an agent to do.
|
|
56
|
+
*/
|
|
57
|
+
export type AgentAction = (AgentPromptAction & {
|
|
58
|
+
type: 'prompt';
|
|
59
|
+
}) | (AgentSetModelAction & {
|
|
60
|
+
type: 'setModel';
|
|
61
|
+
}) | (AgentSetConfigOptionAction & {
|
|
62
|
+
type: 'setConfigOption';
|
|
63
|
+
}) | {
|
|
64
|
+
type: 'compact';
|
|
65
|
+
} | {
|
|
66
|
+
type: 'stop';
|
|
67
|
+
} | (AgentRespondElicitationAction & {
|
|
68
|
+
type: 'respondElicitation';
|
|
69
|
+
}) | (AgentPermissionAction & {
|
|
70
|
+
type: 'respondToPermission';
|
|
71
|
+
});
|
|
72
|
+
/**
|
|
73
|
+
* Identifies one accepted [`AgentAction`] end to end: returned by the
|
|
74
|
+
* control endpoint, written as the JSON-RPC request id on the action's wire
|
|
75
|
+
* frame, and read back off that frame as `request_id` on the folded message
|
|
76
|
+
* it derives.
|
|
77
|
+
*
|
|
78
|
+
* A v7 uuid, so ids sort by mint time. Minted by the server at accept time,
|
|
79
|
+
* or by a client that speculated the action and named it in the control
|
|
80
|
+
* request - either way the server is the only writer of runtime-bound
|
|
81
|
+
* frames, so a uuid-shaped request id remains the whole ownership test. The
|
|
82
|
+
* machine's own handshake request ids (`agent_session:{session}:{n}`) are
|
|
83
|
+
* not uuids and stay `None`.
|
|
84
|
+
*/
|
|
85
|
+
export type AgentActionId = string;
|
|
86
|
+
/**
|
|
87
|
+
* Stable chronological resume position.
|
|
88
|
+
*/
|
|
89
|
+
export type AgentActivityCursor = {
|
|
90
|
+
/**
|
|
91
|
+
* Tie-breaking activity identity.
|
|
92
|
+
*/
|
|
93
|
+
id: string;
|
|
94
|
+
/**
|
|
95
|
+
* Last stored event time.
|
|
96
|
+
*/
|
|
97
|
+
occurredAt: string;
|
|
98
|
+
};
|
|
99
|
+
/**
|
|
100
|
+
* One page of the activity caused by this session.
|
|
101
|
+
*/
|
|
102
|
+
export type AgentActivityPage = {
|
|
103
|
+
/**
|
|
104
|
+
* Original activity rows, also retained in the affected entities' histories.
|
|
105
|
+
*/
|
|
106
|
+
activities: Array<ActivityWireRow>;
|
|
107
|
+
nextCursor?: null | AgentActivityCursor;
|
|
108
|
+
};
|
|
109
|
+
/**
|
|
110
|
+
* An agent acting for a person.
|
|
111
|
+
*/
|
|
112
|
+
export type AgentActor = {
|
|
113
|
+
/**
|
|
114
|
+
* The agent.
|
|
115
|
+
*/
|
|
116
|
+
bot: BotId;
|
|
117
|
+
/**
|
|
118
|
+
* Where the agent's own work came from.
|
|
119
|
+
*/
|
|
120
|
+
lineage: Lineage;
|
|
121
|
+
/**
|
|
122
|
+
* The person it acts for.
|
|
123
|
+
*/
|
|
124
|
+
on_behalf_of: RoxUserIdStr;
|
|
125
|
+
};
|
|
126
|
+
/**
|
|
127
|
+
* Type-specific state for one agent session setting.
|
|
128
|
+
*/
|
|
129
|
+
export type AgentConfigKindDto = {
|
|
130
|
+
/**
|
|
131
|
+
* Current opaque value.
|
|
132
|
+
*/
|
|
133
|
+
currentValue: string;
|
|
134
|
+
/**
|
|
135
|
+
* Ordered values supplied by the agent.
|
|
136
|
+
*/
|
|
137
|
+
options: Array<AgentConfigSelectOptionDto>;
|
|
138
|
+
type: 'select';
|
|
139
|
+
} | {
|
|
140
|
+
/**
|
|
141
|
+
* Current value.
|
|
142
|
+
*/
|
|
143
|
+
currentValue: boolean;
|
|
144
|
+
type: 'boolean';
|
|
145
|
+
};
|
|
146
|
+
/**
|
|
147
|
+
* One agent-advertised ACP session setting.
|
|
148
|
+
*/
|
|
149
|
+
export type AgentConfigOptionDto = AgentConfigKindDto & {
|
|
150
|
+
/**
|
|
151
|
+
* ACP semantic category, such as `model` or `thought_level`.
|
|
152
|
+
*/
|
|
153
|
+
category?: string | null;
|
|
154
|
+
/**
|
|
155
|
+
* Optional explanatory copy.
|
|
156
|
+
*/
|
|
157
|
+
description?: string | null;
|
|
158
|
+
/**
|
|
159
|
+
* Opaque id used to change this setting.
|
|
160
|
+
*/
|
|
161
|
+
id: string;
|
|
162
|
+
/**
|
|
163
|
+
* Display label supplied by the agent.
|
|
164
|
+
*/
|
|
165
|
+
name: string;
|
|
166
|
+
};
|
|
167
|
+
/**
|
|
168
|
+
* One value in an agent-advertised select.
|
|
169
|
+
*/
|
|
170
|
+
export type AgentConfigSelectOptionDto = {
|
|
171
|
+
/**
|
|
172
|
+
* Optional provider description of this value.
|
|
173
|
+
*/
|
|
174
|
+
description?: string | null;
|
|
175
|
+
/**
|
|
176
|
+
* Optional group heading supplied by the provider.
|
|
177
|
+
*/
|
|
178
|
+
group?: string | null;
|
|
179
|
+
/**
|
|
180
|
+
* Display label.
|
|
181
|
+
*/
|
|
182
|
+
name: string;
|
|
183
|
+
/**
|
|
184
|
+
* Opaque value returned to the agent when selected.
|
|
185
|
+
*/
|
|
186
|
+
value: string;
|
|
187
|
+
};
|
|
188
|
+
/**
|
|
189
|
+
* An agent's conversation in a channel, as the person it is with sees it.
|
|
190
|
+
*/
|
|
191
|
+
export type AgentConversationDto = {
|
|
192
|
+
/**
|
|
193
|
+
* Whether the caller may currently send a new prompt.
|
|
194
|
+
*/
|
|
195
|
+
available: boolean;
|
|
196
|
+
/**
|
|
197
|
+
* Optional persona avatar.
|
|
198
|
+
*/
|
|
199
|
+
avatarUrl?: string | null;
|
|
200
|
+
/**
|
|
201
|
+
* Persona id (without the bot principal prefix).
|
|
202
|
+
*/
|
|
203
|
+
botId: string;
|
|
204
|
+
/**
|
|
205
|
+
* The channel containing the visible transcript.
|
|
206
|
+
*/
|
|
207
|
+
channelId: string;
|
|
208
|
+
/**
|
|
209
|
+
* Persona's historical display name.
|
|
210
|
+
*/
|
|
211
|
+
name: string;
|
|
212
|
+
/**
|
|
213
|
+
* The sessions the conversation has run on, oldest first.
|
|
214
|
+
*/
|
|
215
|
+
sessions: Array<AgentConversationSessionDto>;
|
|
216
|
+
/**
|
|
217
|
+
* Whether new persona settings are available to adopt explicitly.
|
|
218
|
+
*/
|
|
219
|
+
settingsChanged: boolean;
|
|
220
|
+
/**
|
|
221
|
+
* Persistent state of each accepted message and its current attempt.
|
|
222
|
+
*/
|
|
223
|
+
turns: Array<AgentConversationTurnDto>;
|
|
224
|
+
};
|
|
225
|
+
/**
|
|
226
|
+
* One session a conversation has run on; every channel message stays visible.
|
|
227
|
+
*/
|
|
228
|
+
export type AgentConversationSessionDto = {
|
|
229
|
+
/**
|
|
230
|
+
* When the session began.
|
|
231
|
+
*/
|
|
232
|
+
createdAt: string;
|
|
233
|
+
/**
|
|
234
|
+
* Whether this is the current agent context.
|
|
235
|
+
*/
|
|
236
|
+
isCurrent: boolean;
|
|
237
|
+
/**
|
|
238
|
+
* Session whose controls and live events belong to this context.
|
|
239
|
+
*/
|
|
240
|
+
sessionId: string;
|
|
241
|
+
};
|
|
242
|
+
/**
|
|
243
|
+
* Execution status without exposing the persona prompt or stored credentials.
|
|
244
|
+
*/
|
|
245
|
+
export type AgentConversationTurnDto = {
|
|
246
|
+
/**
|
|
247
|
+
* Current runtime attempt identity.
|
|
248
|
+
*/
|
|
249
|
+
actionId: string;
|
|
250
|
+
/**
|
|
251
|
+
* When the source message was first accepted.
|
|
252
|
+
*/
|
|
253
|
+
createdAt: string;
|
|
254
|
+
/**
|
|
255
|
+
* The associated agent reply, if it has been posted.
|
|
256
|
+
*/
|
|
257
|
+
replyMessageId?: string | null;
|
|
258
|
+
/**
|
|
259
|
+
* Whether Retry would be accepted now. A failed attempt is not retryable
|
|
260
|
+
* until its reply says how it ended.
|
|
261
|
+
*/
|
|
262
|
+
retryable: boolean;
|
|
263
|
+
/**
|
|
264
|
+
* Session carrying this turn.
|
|
265
|
+
*/
|
|
266
|
+
sessionId: string;
|
|
267
|
+
/**
|
|
268
|
+
* The user's message in the channel timeline.
|
|
269
|
+
*/
|
|
270
|
+
sourceMessageId: string;
|
|
271
|
+
/**
|
|
272
|
+
* Durable execution state.
|
|
273
|
+
*/
|
|
274
|
+
state: ConversationTurnState;
|
|
275
|
+
};
|
|
276
|
+
/**
|
|
277
|
+
* The agent conversations in a channel the caller may see.
|
|
278
|
+
*/
|
|
279
|
+
export type AgentConversationsDto = {
|
|
280
|
+
/**
|
|
281
|
+
* Empty for ordinary channels and other people's conversations.
|
|
282
|
+
*/
|
|
283
|
+
conversations: Array<AgentConversationDto>;
|
|
284
|
+
};
|
|
285
|
+
/**
|
|
286
|
+
* Which kind of agent a prompt is sent to.
|
|
287
|
+
*/
|
|
288
|
+
export type AgentMode = 'chat' | 'code';
|
|
289
|
+
/**
|
|
290
|
+
* Request body for `POST /agent-mode-choice`.
|
|
291
|
+
*/
|
|
292
|
+
export type AgentModeChoiceRequest = {
|
|
293
|
+
/**
|
|
294
|
+
* The prompt the composer is about to send.
|
|
295
|
+
*/
|
|
296
|
+
prompt: string;
|
|
297
|
+
};
|
|
298
|
+
/**
|
|
299
|
+
* Response body for `POST /agent-mode-choice`.
|
|
300
|
+
*/
|
|
301
|
+
export type AgentModeChoiceResponse = {
|
|
302
|
+
/**
|
|
303
|
+
* Which kind of agent should receive the prompt.
|
|
304
|
+
*/
|
|
305
|
+
mode: AgentMode;
|
|
306
|
+
};
|
|
307
|
+
/**
|
|
308
|
+
* One model picker option.
|
|
309
|
+
*/
|
|
310
|
+
export type AgentModelDto = {
|
|
311
|
+
/**
|
|
312
|
+
* Optional provider description.
|
|
313
|
+
*/
|
|
314
|
+
description?: string | null;
|
|
315
|
+
/**
|
|
316
|
+
* Optional group heading supplied by the provider.
|
|
317
|
+
*/
|
|
318
|
+
group?: string | null;
|
|
319
|
+
/**
|
|
320
|
+
* Provider model id.
|
|
321
|
+
*/
|
|
322
|
+
id: string;
|
|
323
|
+
/**
|
|
324
|
+
* Display name.
|
|
325
|
+
*/
|
|
326
|
+
name: string;
|
|
327
|
+
/**
|
|
328
|
+
* Image input support, absent when the runtime does not advertise it.
|
|
329
|
+
*/
|
|
330
|
+
supportsImages?: boolean | null;
|
|
331
|
+
};
|
|
332
|
+
/**
|
|
333
|
+
* Model-selection availability returned over HTTP.
|
|
334
|
+
*/
|
|
335
|
+
export type AgentModelsStatusDto = 'available' | 'unsupported';
|
|
336
|
+
/**
|
|
337
|
+
* A user's answer to the agent's `session/request_permission`.
|
|
338
|
+
*
|
|
339
|
+
* Unlike every other action this is not a new request but the reply to one
|
|
340
|
+
* the agent made, so it carries the agent's own request id rather than
|
|
341
|
+
* receiving a server-minted one.
|
|
342
|
+
*/
|
|
343
|
+
export type AgentPermissionAction = {
|
|
344
|
+
/**
|
|
345
|
+
* What the user decided.
|
|
346
|
+
*/
|
|
347
|
+
answer: PermissionAnswer;
|
|
348
|
+
/**
|
|
349
|
+
* The agent's JSON-RPC request id, echoed verbatim from the folded
|
|
350
|
+
* permission part. A string or a number on the wire; agents mint both,
|
|
351
|
+
* and `7` does not answer `"7"`.
|
|
352
|
+
*/
|
|
353
|
+
requestId: unknown;
|
|
354
|
+
};
|
|
355
|
+
/**
|
|
356
|
+
* Ask the agent to work on something.
|
|
357
|
+
*/
|
|
358
|
+
export type AgentPromptAction = {
|
|
359
|
+
/**
|
|
360
|
+
* Files the prompt refers to, in the order the user attached them.
|
|
361
|
+
* Delivered after the text as one `resource_link` block each.
|
|
362
|
+
*/
|
|
363
|
+
attachments?: Array<PromptAttachment>;
|
|
364
|
+
/**
|
|
365
|
+
* What to tell the agent.
|
|
366
|
+
*/
|
|
367
|
+
prompt: string;
|
|
368
|
+
};
|
|
369
|
+
/**
|
|
370
|
+
* Response body for `GET /agent-repositories`.
|
|
371
|
+
*/
|
|
372
|
+
export type AgentRepositoriesResponse = {
|
|
373
|
+
/**
|
|
374
|
+
* Every repository the caller reaches through Rox's GitHub App, sorted
|
|
375
|
+
* by `owner/name`. Empty when the App is installed nowhere the caller
|
|
376
|
+
* has a claim to.
|
|
377
|
+
*/
|
|
378
|
+
repositories: Array<AgentRepositoryDto>;
|
|
379
|
+
};
|
|
380
|
+
/**
|
|
381
|
+
* Response body for `GET /agent-repositories/branches`.
|
|
382
|
+
*/
|
|
383
|
+
export type AgentRepositoryBranchesResponse = {
|
|
384
|
+
/**
|
|
385
|
+
* Branch names on the repository, in the order GitHub returned them.
|
|
386
|
+
* Empty when the repository has no commits yet.
|
|
387
|
+
*/
|
|
388
|
+
branches: Array<string>;
|
|
389
|
+
};
|
|
390
|
+
/**
|
|
391
|
+
* One repository the caller can select for a coding session.
|
|
392
|
+
*/
|
|
393
|
+
export type AgentRepositoryDto = {
|
|
394
|
+
/**
|
|
395
|
+
* The branch a clone checks out, and where a session starts when its
|
|
396
|
+
* request selects this repository without a `repoBranch`. Absent for a
|
|
397
|
+
* repository with no commits.
|
|
398
|
+
*/
|
|
399
|
+
defaultBranch?: string | null;
|
|
400
|
+
/**
|
|
401
|
+
* The canonical `https://github.com/owner/name` url, in the form
|
|
402
|
+
* `POST /agent-sessions` accepts as `repoUrl`.
|
|
403
|
+
*/
|
|
404
|
+
url: string;
|
|
405
|
+
};
|
|
406
|
+
/**
|
|
407
|
+
* Answer an elicitation the agent is waiting on.
|
|
408
|
+
*/
|
|
409
|
+
export type AgentRespondElicitationAction = ElicitationAnswer & {
|
|
410
|
+
/**
|
|
411
|
+
* The agent's `elicitation/create` request id - not an
|
|
412
|
+
* [`AgentActionId`], because the agent minted it.
|
|
413
|
+
*/
|
|
414
|
+
requestId: ElicitationRequestId;
|
|
415
|
+
};
|
|
416
|
+
/**
|
|
417
|
+
* Response body for `GET /agent-sessions/{session_id}/changes/patch`.
|
|
418
|
+
*
|
|
419
|
+
* Clients deserialize this, so both derives are used.
|
|
420
|
+
*/
|
|
421
|
+
export type AgentSessionChangesPatchResponse = {
|
|
422
|
+
/**
|
|
423
|
+
* The git-style unified diff of the current changeset.
|
|
424
|
+
*/
|
|
425
|
+
patch: string;
|
|
426
|
+
};
|
|
427
|
+
/**
|
|
428
|
+
* Response body for `GET /agent-sessions/{session_id}/changes`.
|
|
429
|
+
*
|
|
430
|
+
* Clients deserialize this, so both derives are used.
|
|
431
|
+
*/
|
|
432
|
+
export type AgentSessionChangesResponse = {
|
|
433
|
+
attempt?: null | CaptureAttemptDto;
|
|
434
|
+
/**
|
|
435
|
+
* A capture is running right now.
|
|
436
|
+
*/
|
|
437
|
+
capturing: boolean;
|
|
438
|
+
changeset?: null | ChangesetDto;
|
|
439
|
+
};
|
|
440
|
+
/**
|
|
441
|
+
* Response body for one session's folded log.
|
|
442
|
+
*/
|
|
443
|
+
export type AgentSessionFoldedLogResponse = {
|
|
444
|
+
/**
|
|
445
|
+
* The agent whose messages these are; it sent every agent message.
|
|
446
|
+
*/
|
|
447
|
+
bot: SessionBot;
|
|
448
|
+
/**
|
|
449
|
+
* The conversation, oldest first: prompts, replies, tool calls and their
|
|
450
|
+
* results, plans, permission requests and how each turn ended. Each
|
|
451
|
+
* element is a `FoldedMessage` from the fold's TypeScript contract,
|
|
452
|
+
* which the SDK exports; the schema is opaque here because those types
|
|
453
|
+
* are described with specta rather than utoipa.
|
|
454
|
+
*/
|
|
455
|
+
messages: Array<{
|
|
456
|
+
[key: string]: unknown;
|
|
457
|
+
}>;
|
|
458
|
+
};
|
|
459
|
+
/**
|
|
460
|
+
* One entry of a session's protocol log.
|
|
461
|
+
*
|
|
462
|
+
* Serializes as `{"userId": ..., "direction": ..., "content": ...}` - the
|
|
463
|
+
* frame's own two fields, flattened in beside the attribution, which is the
|
|
464
|
+
* same shape a recorded session's JSONL carries. A reader can deserialize the
|
|
465
|
+
* `direction`/`content` pair straight back into the fold's own log type
|
|
466
|
+
* rather than through a transport vocabulary of its own.
|
|
467
|
+
*
|
|
468
|
+
* `agentSessionId` is not repeated per entry: every entry in a response
|
|
469
|
+
* belongs to the session named once at the top.
|
|
470
|
+
*
|
|
471
|
+
* `Deserialize` is for the wire-contract tests only - nothing server-side
|
|
472
|
+
* decodes its own response type.
|
|
473
|
+
*/
|
|
474
|
+
export type AgentSessionLogEntryDto = LogFrameDto & {
|
|
475
|
+
/**
|
|
476
|
+
* When the log recorded the frame.
|
|
477
|
+
*
|
|
478
|
+
* The frame itself carries no time, so this comes from the log row. It is
|
|
479
|
+
* what a reader has to order these against anything else it is showing
|
|
480
|
+
* beside them - the fold derives an order among the messages of one
|
|
481
|
+
* session and nothing more.
|
|
482
|
+
*/
|
|
483
|
+
createdAt: string;
|
|
484
|
+
/**
|
|
485
|
+
* Durable transport row identity; together with `createdAt`, its order cursor.
|
|
486
|
+
*/
|
|
487
|
+
id: string;
|
|
488
|
+
/**
|
|
489
|
+
* The user whose action produced the frame, absent when no user did.
|
|
490
|
+
*
|
|
491
|
+
* Only prompts carry one, and only when the frame was attributed at the
|
|
492
|
+
* time - a replayed or recorded session's are anonymous.
|
|
493
|
+
*/
|
|
494
|
+
userId?: string | null;
|
|
495
|
+
};
|
|
496
|
+
/**
|
|
497
|
+
* Response body for one session's raw protocol log.
|
|
498
|
+
*
|
|
499
|
+
* A wrapper rather than a bare array so that anything which is about the
|
|
500
|
+
* response rather than about a frame has somewhere to go later without
|
|
501
|
+
* breaking every client.
|
|
502
|
+
*/
|
|
503
|
+
export type AgentSessionLogResponse = {
|
|
504
|
+
/**
|
|
505
|
+
* The agent whose messages the log derives.
|
|
506
|
+
*
|
|
507
|
+
* Here because a client renders those messages and cannot otherwise work
|
|
508
|
+
* out who sent them: the sender of an agent message is this session's
|
|
509
|
+
* bot, and nothing else names it.
|
|
510
|
+
*/
|
|
511
|
+
bot: SessionBot;
|
|
512
|
+
/**
|
|
513
|
+
* Effective history in ascending `(createdAt, id)` order.
|
|
514
|
+
* The first row is the inclusive history boundary cursor: buffered rows
|
|
515
|
+
* before it are obsolete. Reconcile snapshot overlap by row ID, never content.
|
|
516
|
+
* An empty history has no boundary or overlapping rows.
|
|
517
|
+
*/
|
|
518
|
+
entries: Array<AgentSessionLogEntryDto>;
|
|
519
|
+
};
|
|
520
|
+
/**
|
|
521
|
+
* The fields a chip renders for a session the caller may view.
|
|
522
|
+
*
|
|
523
|
+
* Clients deserialize this, so both derives are used.
|
|
524
|
+
*/
|
|
525
|
+
export type AgentSessionPreviewData = {
|
|
526
|
+
bot?: null | SessionBot;
|
|
527
|
+
/**
|
|
528
|
+
* The bot running the agent.
|
|
529
|
+
*/
|
|
530
|
+
botId: string;
|
|
531
|
+
/**
|
|
532
|
+
* When the session was created.
|
|
533
|
+
*/
|
|
534
|
+
createdAt: string;
|
|
535
|
+
/**
|
|
536
|
+
* The session id.
|
|
537
|
+
*/
|
|
538
|
+
id: string;
|
|
539
|
+
/**
|
|
540
|
+
* When the session was last modified.
|
|
541
|
+
*/
|
|
542
|
+
modifiedAt: string;
|
|
543
|
+
/**
|
|
544
|
+
* User-facing session name.
|
|
545
|
+
*/
|
|
546
|
+
name: string;
|
|
547
|
+
/**
|
|
548
|
+
* The user who owns the session.
|
|
549
|
+
*/
|
|
550
|
+
ownerId: string;
|
|
551
|
+
/**
|
|
552
|
+
* The session's last known status.
|
|
553
|
+
*/
|
|
554
|
+
status: SessionStatusDto;
|
|
555
|
+
};
|
|
556
|
+
/**
|
|
557
|
+
* What one requested id resolved to, on the wire.
|
|
558
|
+
*
|
|
559
|
+
* Tagged the same way the chat and document preview endpoints tag theirs
|
|
560
|
+
* (`type` in `access` / `no_access` / `does_not_exist`), so a client that
|
|
561
|
+
* renders those chips can render this one with the same branch.
|
|
562
|
+
*
|
|
563
|
+
* Clients deserialize this, so both derives are used.
|
|
564
|
+
*/
|
|
565
|
+
export type AgentSessionPreviewDto = (AgentSessionPreviewData & {
|
|
566
|
+
type: 'access';
|
|
567
|
+
}) | (WithAgentSessionId & {
|
|
568
|
+
type: 'no_access';
|
|
569
|
+
}) | (WithAgentSessionId & {
|
|
570
|
+
type: 'does_not_exist';
|
|
571
|
+
});
|
|
572
|
+
/**
|
|
573
|
+
* Response body for a session's queue: everything waiting, oldest first.
|
|
574
|
+
*
|
|
575
|
+
* A wrapper rather than a bare array so that anything which is about the
|
|
576
|
+
* response rather than about an entry has somewhere to go later without
|
|
577
|
+
* breaking every client.
|
|
578
|
+
*/
|
|
579
|
+
export type AgentSessionQueueResponse = {
|
|
580
|
+
/**
|
|
581
|
+
* The waiting actions, in dispatch order.
|
|
582
|
+
*/
|
|
583
|
+
entries: Array<QueuedActionDto>;
|
|
584
|
+
};
|
|
585
|
+
/**
|
|
586
|
+
* Response body describing an agent session.
|
|
587
|
+
*
|
|
588
|
+
* Clients deserialize this, so both derives are used.
|
|
589
|
+
*/
|
|
590
|
+
export type AgentSessionResponse = {
|
|
591
|
+
/**
|
|
592
|
+
* The ACP session id, if one exists.
|
|
593
|
+
*/
|
|
594
|
+
acpSessionId?: string | null;
|
|
595
|
+
/**
|
|
596
|
+
* When the session was archived, or `None` while it is active.
|
|
597
|
+
*/
|
|
598
|
+
archivedAt?: string | null;
|
|
599
|
+
archivedBy?: null | ArchiveCause;
|
|
600
|
+
/**
|
|
601
|
+
* The bot running the agent.
|
|
602
|
+
*/
|
|
603
|
+
botId: string;
|
|
604
|
+
/**
|
|
605
|
+
* Whether the caller may drive the session - prompt it, answer its
|
|
606
|
+
* questions, stop it - rather than only watch. Edit access; the
|
|
607
|
+
* creator owns the session, so a create response always says so.
|
|
608
|
+
*/
|
|
609
|
+
canEdit: boolean;
|
|
610
|
+
/**
|
|
611
|
+
* When the session was created.
|
|
612
|
+
*/
|
|
613
|
+
createdAt: string;
|
|
614
|
+
external?: null | ExternalSessionResponse;
|
|
615
|
+
/**
|
|
616
|
+
* Harness slug.
|
|
617
|
+
*/
|
|
618
|
+
harness: string;
|
|
619
|
+
/**
|
|
620
|
+
* The session id.
|
|
621
|
+
*/
|
|
622
|
+
id: string;
|
|
623
|
+
/**
|
|
624
|
+
* Instructions the session's runtime works under, when any were stated
|
|
625
|
+
* at creation. Absent otherwise, so existing payloads are unchanged.
|
|
626
|
+
*/
|
|
627
|
+
instructions?: string | null;
|
|
628
|
+
/**
|
|
629
|
+
* Model slug.
|
|
630
|
+
*/
|
|
631
|
+
model: string;
|
|
632
|
+
/**
|
|
633
|
+
* When the session was last modified.
|
|
634
|
+
*/
|
|
635
|
+
modifiedAt: string;
|
|
636
|
+
/**
|
|
637
|
+
* User-facing session name.
|
|
638
|
+
*/
|
|
639
|
+
name: string;
|
|
640
|
+
/**
|
|
641
|
+
* What opened the session: who or what started it, and what it is about.
|
|
642
|
+
* `unknown` when nothing recorded it.
|
|
643
|
+
*/
|
|
644
|
+
origin?: TriggerOrigin;
|
|
645
|
+
/**
|
|
646
|
+
* The exact message that invoked the bot, if any.
|
|
647
|
+
*/
|
|
648
|
+
originatingMessageId?: string | null;
|
|
649
|
+
/**
|
|
650
|
+
* The user who created and owns the session.
|
|
651
|
+
*/
|
|
652
|
+
ownerId: string;
|
|
653
|
+
/**
|
|
654
|
+
* The session's linked pull request.
|
|
655
|
+
*/
|
|
656
|
+
pullRequestUrl?: string | null;
|
|
657
|
+
/**
|
|
658
|
+
* The repository the session works with, when one was stated.
|
|
659
|
+
*/
|
|
660
|
+
repoUrl?: string | null;
|
|
661
|
+
/**
|
|
662
|
+
* Compute tier of the managed sandbox.
|
|
663
|
+
*/
|
|
664
|
+
sandboxSize: SandboxSize;
|
|
665
|
+
/**
|
|
666
|
+
* The session's status.
|
|
667
|
+
*/
|
|
668
|
+
status: SessionStatusDto;
|
|
669
|
+
/**
|
|
670
|
+
* The Rox task the session was linked to.
|
|
671
|
+
*/
|
|
672
|
+
taskId?: string | null;
|
|
673
|
+
/**
|
|
674
|
+
* The channel `thread_id` lives in, when the session was spawned from a
|
|
675
|
+
* channel thread. Derived from `thread_parent`.
|
|
676
|
+
*/
|
|
677
|
+
threadChannelId?: string | null;
|
|
678
|
+
/**
|
|
679
|
+
* The root message of the thread the session was created from, if any.
|
|
680
|
+
*/
|
|
681
|
+
threadId?: string | null;
|
|
682
|
+
threadParent?: null | MessageParent;
|
|
683
|
+
/**
|
|
684
|
+
* The directory the session's harness runs in on its runtime.
|
|
685
|
+
*/
|
|
686
|
+
workspace: string;
|
|
687
|
+
};
|
|
688
|
+
/**
|
|
689
|
+
* Ask the agent to change one advertised select-style session setting.
|
|
690
|
+
*/
|
|
691
|
+
export type AgentSetConfigOptionAction = {
|
|
692
|
+
/**
|
|
693
|
+
* Opaque ACP config id advertised by the agent.
|
|
694
|
+
*/
|
|
695
|
+
configId: string;
|
|
696
|
+
/**
|
|
697
|
+
* Opaque select value advertised for that config option.
|
|
698
|
+
*/
|
|
699
|
+
value: string;
|
|
700
|
+
};
|
|
701
|
+
/**
|
|
702
|
+
* Ask the agent to run on a different model from here on.
|
|
703
|
+
*/
|
|
704
|
+
export type AgentSetModelAction = {
|
|
705
|
+
/**
|
|
706
|
+
* The model slug the agent should switch to.
|
|
707
|
+
*/
|
|
708
|
+
model: string;
|
|
709
|
+
};
|
|
710
|
+
/**
|
|
711
|
+
* One pending interaction, or one stalled session.
|
|
712
|
+
*/
|
|
713
|
+
export type AgentUpdate = {
|
|
714
|
+
/**
|
|
715
|
+
* The runtime the session runs on.
|
|
716
|
+
*/
|
|
717
|
+
harness: string;
|
|
718
|
+
/**
|
|
719
|
+
* What the session is waiting for.
|
|
720
|
+
*/
|
|
721
|
+
kind: AgentUpdateKind;
|
|
722
|
+
/**
|
|
723
|
+
* The choices a permission request offers; empty for other kinds.
|
|
724
|
+
*/
|
|
725
|
+
options: Array<string>;
|
|
726
|
+
/**
|
|
727
|
+
* The session's pull request, if it has one.
|
|
728
|
+
*/
|
|
729
|
+
pullRequestUrl?: string | null;
|
|
730
|
+
/**
|
|
731
|
+
* The session.
|
|
732
|
+
*/
|
|
733
|
+
sessionId: string;
|
|
734
|
+
/**
|
|
735
|
+
* The session's name.
|
|
736
|
+
*/
|
|
737
|
+
sessionName: string;
|
|
738
|
+
/**
|
|
739
|
+
* When the request was made, or the session's last activity.
|
|
740
|
+
*/
|
|
741
|
+
since: string;
|
|
742
|
+
/**
|
|
743
|
+
* What is asked, or why the session looks stalled, in at most 240 characters.
|
|
744
|
+
*/
|
|
745
|
+
summary: string;
|
|
746
|
+
};
|
|
747
|
+
/**
|
|
748
|
+
* A kind of action or inactivity the user should see: `permission` to run a tool, an
|
|
749
|
+
* `elicitation` question or form, a `tool_approval` held for the owner, or `stalled` with no
|
|
750
|
+
* activity for over 20 minutes.
|
|
751
|
+
*/
|
|
752
|
+
export type AgentUpdateKind = 'permission' | 'elicitation' | 'tool_approval' | 'stalled';
|
|
753
|
+
/**
|
|
754
|
+
* Bounded results; truncation means older qualifying sessions were not folded.
|
|
755
|
+
*/
|
|
756
|
+
export type AgentUpdates = {
|
|
757
|
+
/**
|
|
758
|
+
* One entry per pending request or stalled session, newest session activity first.
|
|
759
|
+
*/
|
|
760
|
+
items: Array<AgentUpdate>;
|
|
761
|
+
/**
|
|
762
|
+
* Whether qualifying sessions beyond the 25 most recent were left out.
|
|
763
|
+
*/
|
|
764
|
+
truncated: boolean;
|
|
765
|
+
/**
|
|
766
|
+
* Says what was left out, when truncated.
|
|
767
|
+
*/
|
|
768
|
+
truncationNotice?: string | null;
|
|
769
|
+
};
|
|
770
|
+
/**
|
|
771
|
+
* Public admission error payload. Handlers with additional fields can reuse the
|
|
772
|
+
* domain error's code and message and [`admission_status`].
|
|
773
|
+
*/
|
|
774
|
+
export type AiAdmissionErrorBody = {
|
|
775
|
+
/**
|
|
776
|
+
* Stable denial or unavailability code.
|
|
777
|
+
*/
|
|
778
|
+
code: string;
|
|
779
|
+
/**
|
|
780
|
+
* Human-readable explanation, without internal billing diagnostics.
|
|
781
|
+
*/
|
|
782
|
+
error: string;
|
|
783
|
+
};
|
|
784
|
+
/**
|
|
785
|
+
* Editable fields for ai inference, before submission and identity resolution.
|
|
786
|
+
*/
|
|
787
|
+
export type AiSuggestions = {
|
|
788
|
+
[key: string]: never;
|
|
789
|
+
};
|
|
790
|
+
/**
|
|
791
|
+
* Request body for answering a held tool call.
|
|
792
|
+
*/
|
|
793
|
+
export type AnswerToolApprovalRequest = {
|
|
794
|
+
/**
|
|
795
|
+
* The answer.
|
|
796
|
+
*/
|
|
797
|
+
answer: ToolApprovalAnswerDto;
|
|
798
|
+
};
|
|
799
|
+
/**
|
|
800
|
+
* Response body for answering a held tool call.
|
|
801
|
+
*/
|
|
802
|
+
export type AnswerToolApprovalResponse = {
|
|
803
|
+
/**
|
|
804
|
+
* Where the call stands now.
|
|
805
|
+
*/
|
|
806
|
+
status: ToolApprovalStatusDto;
|
|
807
|
+
};
|
|
808
|
+
/**
|
|
809
|
+
* Request body for reporting a connected app.
|
|
810
|
+
*/
|
|
811
|
+
export type AppConnectedRequest = {
|
|
812
|
+
actionId?: null | AgentActionId;
|
|
813
|
+
/**
|
|
814
|
+
* The Pipedream app slug the owner connected, e.g. `notion`.
|
|
815
|
+
*/
|
|
816
|
+
appSlug: string;
|
|
817
|
+
};
|
|
818
|
+
/**
|
|
819
|
+
* Who or what archived a session.
|
|
820
|
+
*/
|
|
821
|
+
export type ArchiveCause = 'user' | 'pull_request_merged' | 'runtime_closed';
|
|
822
|
+
/**
|
|
823
|
+
* One session's choices over its owner's defaults. `null` follows the owner.
|
|
824
|
+
*/
|
|
825
|
+
export type AutoArchiveOverridesBody = {
|
|
826
|
+
/**
|
|
827
|
+
* Archive once the session's pull requests merge, or `null` to follow the owner.
|
|
828
|
+
*/
|
|
829
|
+
onPullRequestMerged?: boolean | null;
|
|
830
|
+
/**
|
|
831
|
+
* Archive once the session's runtime session is deliberately closed, or `null` to follow
|
|
832
|
+
* the owner.
|
|
833
|
+
*/
|
|
834
|
+
onRuntimeClosed?: boolean | null;
|
|
835
|
+
};
|
|
836
|
+
/**
|
|
837
|
+
* Which triggers archive the caller's sessions when a session has no choice of its own.
|
|
838
|
+
*/
|
|
839
|
+
export type AutoArchivePreferencesBody = {
|
|
840
|
+
/**
|
|
841
|
+
* Archive a session once every pull request linked to it is closed and at least one merged.
|
|
842
|
+
*/
|
|
843
|
+
onPullRequestMerged: boolean;
|
|
844
|
+
/**
|
|
845
|
+
* Archive a session once the runtime session backing it is deliberately closed.
|
|
846
|
+
*/
|
|
847
|
+
onRuntimeClosed: boolean;
|
|
848
|
+
};
|
|
849
|
+
export type BotId = string;
|
|
850
|
+
/**
|
|
851
|
+
* Editable fields for calendar inference, before submission and identity resolution.
|
|
852
|
+
*/
|
|
853
|
+
export type CalendarSuggestions = {
|
|
854
|
+
/**
|
|
855
|
+
* Suggested Markdown content or outgoing message body.
|
|
856
|
+
*/
|
|
857
|
+
body?: string | null;
|
|
858
|
+
/**
|
|
859
|
+
* Event end as a local wall-clock value in the request's timezone.
|
|
860
|
+
*/
|
|
861
|
+
end?: string | null;
|
|
862
|
+
/**
|
|
863
|
+
* Only populated when an invitation was explicitly requested.
|
|
864
|
+
*/
|
|
865
|
+
guests?: Array<string>;
|
|
866
|
+
/**
|
|
867
|
+
* Human-readable event venue or meeting URL.
|
|
868
|
+
*/
|
|
869
|
+
location?: string | null;
|
|
870
|
+
recurrence?: null | RecurrenceSuggestion;
|
|
871
|
+
/**
|
|
872
|
+
* Local wall-clock values, interpreted in the request's IANA timezone.
|
|
873
|
+
*/
|
|
874
|
+
start?: string | null;
|
|
875
|
+
/**
|
|
876
|
+
* Verbatim clock phrase whose missing AM/PM required an editable assumption.
|
|
877
|
+
*/
|
|
878
|
+
start_assumption?: string | null;
|
|
879
|
+
/**
|
|
880
|
+
* Suggested note, task, or event title.
|
|
881
|
+
*/
|
|
882
|
+
title?: string | null;
|
|
883
|
+
};
|
|
884
|
+
/**
|
|
885
|
+
* Call one tool of a connected app.
|
|
886
|
+
*/
|
|
887
|
+
export type CallConnectedTool = {
|
|
888
|
+
/**
|
|
889
|
+
* The tool's arguments, matching its input schema.
|
|
890
|
+
*/
|
|
891
|
+
arguments?: {
|
|
892
|
+
[key: string]: unknown;
|
|
893
|
+
};
|
|
894
|
+
/**
|
|
895
|
+
* The tool's name on its server.
|
|
896
|
+
*/
|
|
897
|
+
tool: string;
|
|
898
|
+
};
|
|
899
|
+
/**
|
|
900
|
+
* Call search supports speakers, channels and attendance status.
|
|
901
|
+
*/
|
|
902
|
+
export type CallSearchSuggestions = {
|
|
903
|
+
/**
|
|
904
|
+
* Speaker names or supplied addresses.
|
|
905
|
+
*/
|
|
906
|
+
from: Array<string>;
|
|
907
|
+
/**
|
|
908
|
+
* Channel names.
|
|
909
|
+
*/
|
|
910
|
+
in: Array<string>;
|
|
911
|
+
/**
|
|
912
|
+
* Remaining keyword phrase.
|
|
913
|
+
*/
|
|
914
|
+
query?: string | null;
|
|
915
|
+
/**
|
|
916
|
+
* Attendance display value, resolved against supported options by the client.
|
|
917
|
+
*/
|
|
918
|
+
status?: string | null;
|
|
919
|
+
};
|
|
920
|
+
/**
|
|
921
|
+
* Who did something that opened a session.
|
|
922
|
+
*/
|
|
923
|
+
export type Caller = {
|
|
924
|
+
type: 'person';
|
|
925
|
+
/**
|
|
926
|
+
* Who.
|
|
927
|
+
*/
|
|
928
|
+
user: RoxUserIdStr;
|
|
929
|
+
} | (AgentActor & {
|
|
930
|
+
type: 'agent';
|
|
931
|
+
});
|
|
932
|
+
/**
|
|
933
|
+
* Harness names accepted by the capability-discovery endpoint.
|
|
934
|
+
*/
|
|
935
|
+
export type CapabilityHarnessDto = 'in-memory' | 'cursor' | 'roxd';
|
|
936
|
+
/**
|
|
937
|
+
* The latest capture attempt.
|
|
938
|
+
*
|
|
939
|
+
* Clients deserialize this, so both derives are used.
|
|
940
|
+
*/
|
|
941
|
+
export type CaptureAttemptDto = {
|
|
942
|
+
/**
|
|
943
|
+
* Why it did not capture, in a sentence the user can read.
|
|
944
|
+
*/
|
|
945
|
+
error?: string | null;
|
|
946
|
+
/**
|
|
947
|
+
* When it ended; absent while it runs.
|
|
948
|
+
*/
|
|
949
|
+
finishedAt?: string | null;
|
|
950
|
+
outcome?: null | CaptureOutcomeDto;
|
|
951
|
+
/**
|
|
952
|
+
* When it started.
|
|
953
|
+
*/
|
|
954
|
+
startedAt: string;
|
|
955
|
+
};
|
|
956
|
+
/**
|
|
957
|
+
* How the latest capture attempt ended, on the wire.
|
|
958
|
+
*/
|
|
959
|
+
export type CaptureOutcomeDto = 'captured' | 'not_ready' | 'failed';
|
|
960
|
+
/**
|
|
961
|
+
* One changed file.
|
|
962
|
+
*
|
|
963
|
+
* Clients deserialize this, so both derives are used.
|
|
964
|
+
*/
|
|
965
|
+
export type ChangedFileDto = {
|
|
966
|
+
/**
|
|
967
|
+
* Lines added.
|
|
968
|
+
*/
|
|
969
|
+
additions: number;
|
|
970
|
+
/**
|
|
971
|
+
* The diff carries no text for this file.
|
|
972
|
+
*/
|
|
973
|
+
binary: boolean;
|
|
974
|
+
/**
|
|
975
|
+
* Lines removed.
|
|
976
|
+
*/
|
|
977
|
+
deletions: number;
|
|
978
|
+
/**
|
|
979
|
+
* What happened to the file.
|
|
980
|
+
*/
|
|
981
|
+
kind: FileChangeKindDto;
|
|
982
|
+
/**
|
|
983
|
+
* The file's hunks were left out of the patch to fit the size budget.
|
|
984
|
+
*/
|
|
985
|
+
patchOmitted: boolean;
|
|
986
|
+
/**
|
|
987
|
+
* The file's path after the change, or before it for a deletion.
|
|
988
|
+
*/
|
|
989
|
+
path: string;
|
|
990
|
+
/**
|
|
991
|
+
* Where a renamed file came from.
|
|
992
|
+
*/
|
|
993
|
+
previousPath?: string | null;
|
|
994
|
+
};
|
|
995
|
+
/**
|
|
996
|
+
* One changeset: the files a patch touches and what happened to each.
|
|
997
|
+
*
|
|
998
|
+
* Clients deserialize this, so both derives are used.
|
|
999
|
+
*/
|
|
1000
|
+
export type ChangesetDto = {
|
|
1001
|
+
/**
|
|
1002
|
+
* Lines added across all files.
|
|
1003
|
+
*/
|
|
1004
|
+
additions: number;
|
|
1005
|
+
/**
|
|
1006
|
+
* The side the work started from.
|
|
1007
|
+
*/
|
|
1008
|
+
base: GitRefDto;
|
|
1009
|
+
/**
|
|
1010
|
+
* When the diff was taken.
|
|
1011
|
+
*/
|
|
1012
|
+
capturedAt: string;
|
|
1013
|
+
/**
|
|
1014
|
+
* Lines removed across all files.
|
|
1015
|
+
*/
|
|
1016
|
+
deletions: number;
|
|
1017
|
+
/**
|
|
1018
|
+
* Every changed file, in patch order.
|
|
1019
|
+
*/
|
|
1020
|
+
files: Array<ChangedFileDto>;
|
|
1021
|
+
/**
|
|
1022
|
+
* The side carrying the work.
|
|
1023
|
+
*/
|
|
1024
|
+
head: GitRefDto;
|
|
1025
|
+
/**
|
|
1026
|
+
* The changeset's id; a different id means different changes.
|
|
1027
|
+
*/
|
|
1028
|
+
id: string;
|
|
1029
|
+
/**
|
|
1030
|
+
* Size of the patch the matching patch route serves; zero when nothing
|
|
1031
|
+
* changed.
|
|
1032
|
+
*/
|
|
1033
|
+
patchBytes: number;
|
|
1034
|
+
/**
|
|
1035
|
+
* `https://github.com/owner/name`, when known.
|
|
1036
|
+
*/
|
|
1037
|
+
repository?: string | null;
|
|
1038
|
+
/**
|
|
1039
|
+
* Where the diff was read from.
|
|
1040
|
+
*/
|
|
1041
|
+
source: ChangesetSourceDto;
|
|
1042
|
+
/**
|
|
1043
|
+
* Some files' hunks were left out of the patch.
|
|
1044
|
+
*/
|
|
1045
|
+
truncated: boolean;
|
|
1046
|
+
};
|
|
1047
|
+
/**
|
|
1048
|
+
* The source of a changeset's diff, on the wire.
|
|
1049
|
+
*/
|
|
1050
|
+
export type ChangesetSourceDto = 'github_pull_request';
|
|
1051
|
+
/**
|
|
1052
|
+
* Message filters remain display names until resolved against the user's directory.
|
|
1053
|
+
*/
|
|
1054
|
+
export type ChannelSearchSuggestions = {
|
|
1055
|
+
/**
|
|
1056
|
+
* Explicit message sender names or addresses.
|
|
1057
|
+
*/
|
|
1058
|
+
from: Array<string>;
|
|
1059
|
+
/**
|
|
1060
|
+
* Explicit channel names.
|
|
1061
|
+
*/
|
|
1062
|
+
in: Array<string>;
|
|
1063
|
+
/**
|
|
1064
|
+
* Remaining keyword phrase.
|
|
1065
|
+
*/
|
|
1066
|
+
query?: string | null;
|
|
1067
|
+
};
|
|
1068
|
+
/**
|
|
1069
|
+
* The channel share permission
|
|
1070
|
+
*/
|
|
1071
|
+
export type ChannelSharePermission = {
|
|
1072
|
+
/**
|
|
1073
|
+
* The access level for the channel
|
|
1074
|
+
*/
|
|
1075
|
+
access_level: AccessLevel;
|
|
1076
|
+
/**
|
|
1077
|
+
* The channel id
|
|
1078
|
+
*/
|
|
1079
|
+
channel_id: string;
|
|
1080
|
+
};
|
|
1081
|
+
/**
|
|
1082
|
+
* A draft snapshot. Revisions are opaque to the server and echoed to the client.
|
|
1083
|
+
*/
|
|
1084
|
+
export type ClassifyInputRequest = {
|
|
1085
|
+
/**
|
|
1086
|
+
* Opaque client revision used to discard stale predictions.
|
|
1087
|
+
*/
|
|
1088
|
+
revision: number;
|
|
1089
|
+
/**
|
|
1090
|
+
* Current draft text to classify without executing it.
|
|
1091
|
+
*/
|
|
1092
|
+
text: string;
|
|
1093
|
+
};
|
|
1094
|
+
/**
|
|
1095
|
+
* Ranked-type evidence for a particular client draft revision.
|
|
1096
|
+
*/
|
|
1097
|
+
export type ClassifyInputResponse = {
|
|
1098
|
+
/**
|
|
1099
|
+
* Revision echoed from the classification request.
|
|
1100
|
+
*/
|
|
1101
|
+
revision: number;
|
|
1102
|
+
/**
|
|
1103
|
+
* Independent scores in the fixed intent-question order.
|
|
1104
|
+
*/
|
|
1105
|
+
scores: Array<IntentScore>;
|
|
1106
|
+
};
|
|
1107
|
+
/**
|
|
1108
|
+
* A computer's active Claude sign-in. Claude's long-lived credential names
|
|
1109
|
+
* no account, so there is no email or plan to show.
|
|
1110
|
+
*/
|
|
1111
|
+
export type ClaudeAccountStatus = {
|
|
1112
|
+
/**
|
|
1113
|
+
* When the credential stops working, as the computer last reported it.
|
|
1114
|
+
*/
|
|
1115
|
+
expiresAt?: string | null;
|
|
1116
|
+
/**
|
|
1117
|
+
* When it was signed in.
|
|
1118
|
+
*/
|
|
1119
|
+
signedInAt: string;
|
|
1120
|
+
/**
|
|
1121
|
+
* Who signed it in through Rox; absent once that user is deleted or
|
|
1122
|
+
* when it was signed in on the computer itself.
|
|
1123
|
+
*/
|
|
1124
|
+
signedInBy?: string | null;
|
|
1125
|
+
};
|
|
1126
|
+
/**
|
|
1127
|
+
* How Claude Code on a Rox computer is paid for: its own Claude account
|
|
1128
|
+
* when it has an active Claude login, otherwise Rox credits.
|
|
1129
|
+
*/
|
|
1130
|
+
export type ClaudeMode = 'macro_credits' | 'own_account';
|
|
1131
|
+
/**
|
|
1132
|
+
* How Claude Code on a computer is paid for, and its Claude sign-in when it
|
|
1133
|
+
* uses its own.
|
|
1134
|
+
*/
|
|
1135
|
+
export type ClaudeModeResponse = {
|
|
1136
|
+
account?: null | ClaudeAccountStatus;
|
|
1137
|
+
/**
|
|
1138
|
+
* How Claude Code is paid for.
|
|
1139
|
+
*/
|
|
1140
|
+
mode: ClaudeMode;
|
|
1141
|
+
};
|
|
1142
|
+
/**
|
|
1143
|
+
* `POST /harnesses/{harness_id}/claude-sign-in/complete` body.
|
|
1144
|
+
*/
|
|
1145
|
+
export type ClaudeSignInComplete = {
|
|
1146
|
+
/**
|
|
1147
|
+
* The code Claude showed after the user signed in.
|
|
1148
|
+
*/
|
|
1149
|
+
code: string;
|
|
1150
|
+
};
|
|
1151
|
+
/**
|
|
1152
|
+
* `POST /harnesses/{harness_id}/claude-sign-in` answer.
|
|
1153
|
+
*/
|
|
1154
|
+
export type ClaudeSignInStarted = {
|
|
1155
|
+
/**
|
|
1156
|
+
* Where the user signs in to Claude, in their own browser.
|
|
1157
|
+
*/
|
|
1158
|
+
url: string;
|
|
1159
|
+
};
|
|
1160
|
+
/**
|
|
1161
|
+
* `POST /harnesses/{harness_id}/claude-sign-in/complete` answer.
|
|
1162
|
+
*/
|
|
1163
|
+
export type ClaudeSignedIn = {
|
|
1164
|
+
/**
|
|
1165
|
+
* Always `true`.
|
|
1166
|
+
*/
|
|
1167
|
+
signedIn: boolean;
|
|
1168
|
+
};
|
|
1169
|
+
/**
|
|
1170
|
+
* Information used to choose a coding persona for a task.
|
|
1171
|
+
*/
|
|
1172
|
+
export type CodingAgent = {
|
|
1173
|
+
/**
|
|
1174
|
+
* What the persona is intended to do.
|
|
1175
|
+
*/
|
|
1176
|
+
description?: string | null;
|
|
1177
|
+
/**
|
|
1178
|
+
* Runtime configured for the persona.
|
|
1179
|
+
*/
|
|
1180
|
+
harness: string;
|
|
1181
|
+
/**
|
|
1182
|
+
* Persona id to pass to dispatch.
|
|
1183
|
+
*/
|
|
1184
|
+
id: string;
|
|
1185
|
+
/**
|
|
1186
|
+
* Saved guidance describing the persona's repositories and specialties.
|
|
1187
|
+
*/
|
|
1188
|
+
instructions: string;
|
|
1189
|
+
/**
|
|
1190
|
+
* Persona's configured default model, absent when the provider chooses it.
|
|
1191
|
+
*/
|
|
1192
|
+
model?: string | null;
|
|
1193
|
+
/**
|
|
1194
|
+
* User-facing persona name.
|
|
1195
|
+
*/
|
|
1196
|
+
name: string;
|
|
1197
|
+
};
|
|
1198
|
+
/**
|
|
1199
|
+
* The coding agents the caller can start a session as right now.
|
|
1200
|
+
*/
|
|
1201
|
+
export type CodingAgentsResponse = {
|
|
1202
|
+
/**
|
|
1203
|
+
* Available coding personas, built-in ones such as Cursor first.
|
|
1204
|
+
*/
|
|
1205
|
+
agents: Array<CodingAgent>;
|
|
1206
|
+
};
|
|
1207
|
+
/**
|
|
1208
|
+
* Request or response body for the caller's coding preferences.
|
|
1209
|
+
*/
|
|
1210
|
+
export type CodingPreferencesBody = {
|
|
1211
|
+
/**
|
|
1212
|
+
* Whether new coding sessions research prior work and link a Rox task.
|
|
1213
|
+
*/
|
|
1214
|
+
createTasks: boolean;
|
|
1215
|
+
/**
|
|
1216
|
+
* Whether new coding sessions deliver their work as a pull request.
|
|
1217
|
+
*/
|
|
1218
|
+
openPullRequests: boolean;
|
|
1219
|
+
};
|
|
1220
|
+
/**
|
|
1221
|
+
* Add a custom MCP server to the user's connections.
|
|
1222
|
+
*/
|
|
1223
|
+
export type ConnectMcpServer = {
|
|
1224
|
+
/**
|
|
1225
|
+
* Display name for the server.
|
|
1226
|
+
*/
|
|
1227
|
+
serverName: string;
|
|
1228
|
+
/**
|
|
1229
|
+
* The server's URL.
|
|
1230
|
+
*/
|
|
1231
|
+
url: string;
|
|
1232
|
+
};
|
|
1233
|
+
/**
|
|
1234
|
+
* Response from [`ConnectMcpServer`].
|
|
1235
|
+
*/
|
|
1236
|
+
export type ConnectMcpServerResponse = {
|
|
1237
|
+
/**
|
|
1238
|
+
* Whether the user already had this server before the call.
|
|
1239
|
+
*/
|
|
1240
|
+
alreadyConnected: boolean;
|
|
1241
|
+
/**
|
|
1242
|
+
* Whether the server holds the user's sign-in.
|
|
1243
|
+
*/
|
|
1244
|
+
authenticated: boolean;
|
|
1245
|
+
/**
|
|
1246
|
+
* Whether the server's tools are turned on.
|
|
1247
|
+
*/
|
|
1248
|
+
enabled: boolean;
|
|
1249
|
+
/**
|
|
1250
|
+
* The server's display name.
|
|
1251
|
+
*/
|
|
1252
|
+
serverName: string;
|
|
1253
|
+
/**
|
|
1254
|
+
* What happened and what the user still has to do.
|
|
1255
|
+
*/
|
|
1256
|
+
summary: string;
|
|
1257
|
+
/**
|
|
1258
|
+
* The server's URL.
|
|
1259
|
+
*/
|
|
1260
|
+
url: string;
|
|
1261
|
+
};
|
|
1262
|
+
/**
|
|
1263
|
+
* A connected app the session's agent may use.
|
|
1264
|
+
*/
|
|
1265
|
+
export type ConnectedApp = {
|
|
1266
|
+
/**
|
|
1267
|
+
* The app's slug, or its custom server key.
|
|
1268
|
+
*/
|
|
1269
|
+
key: string;
|
|
1270
|
+
/**
|
|
1271
|
+
* Which store the app comes from.
|
|
1272
|
+
*/
|
|
1273
|
+
kind: ConnectedAppKind;
|
|
1274
|
+
/**
|
|
1275
|
+
* Display name, e.g. `Slack` or the owner's name for a custom server.
|
|
1276
|
+
*/
|
|
1277
|
+
name: string;
|
|
1278
|
+
};
|
|
1279
|
+
/**
|
|
1280
|
+
* Which store a connected app comes from.
|
|
1281
|
+
*/
|
|
1282
|
+
export type ConnectedAppKind = 'app' | 'custom';
|
|
1283
|
+
/**
|
|
1284
|
+
* One tool a connected app serves.
|
|
1285
|
+
*/
|
|
1286
|
+
export type ConnectedTool = {
|
|
1287
|
+
/**
|
|
1288
|
+
* What the server says the tool does.
|
|
1289
|
+
*/
|
|
1290
|
+
description?: string | null;
|
|
1291
|
+
/**
|
|
1292
|
+
* JSON Schema for the tool's arguments.
|
|
1293
|
+
*/
|
|
1294
|
+
inputSchema: {
|
|
1295
|
+
[key: string]: unknown;
|
|
1296
|
+
};
|
|
1297
|
+
/**
|
|
1298
|
+
* The tool's name on its server.
|
|
1299
|
+
*/
|
|
1300
|
+
name: string;
|
|
1301
|
+
};
|
|
1302
|
+
/**
|
|
1303
|
+
* One tool found by a search across the agent's connected apps.
|
|
1304
|
+
*/
|
|
1305
|
+
export type ConnectedToolMatch = {
|
|
1306
|
+
/**
|
|
1307
|
+
* The app serving the tool.
|
|
1308
|
+
*/
|
|
1309
|
+
app: ConnectedApp;
|
|
1310
|
+
/**
|
|
1311
|
+
* The tool.
|
|
1312
|
+
*/
|
|
1313
|
+
tool: ConnectedTool;
|
|
1314
|
+
};
|
|
1315
|
+
/**
|
|
1316
|
+
* A connected tool's answer: MCP's `CallToolResult`.
|
|
1317
|
+
*/
|
|
1318
|
+
export type ConnectedToolResult = {
|
|
1319
|
+
/**
|
|
1320
|
+
* MCP content blocks, e.g. `{type: "text", text}`.
|
|
1321
|
+
*/
|
|
1322
|
+
content: Array<{
|
|
1323
|
+
[key: string]: unknown;
|
|
1324
|
+
}>;
|
|
1325
|
+
/**
|
|
1326
|
+
* The tool failed, or could not run; `content` says why.
|
|
1327
|
+
*/
|
|
1328
|
+
isError: boolean;
|
|
1329
|
+
/**
|
|
1330
|
+
* Structured output, for tools that declare an output schema.
|
|
1331
|
+
*/
|
|
1332
|
+
structuredContent?: {
|
|
1333
|
+
[key: string]: unknown;
|
|
1334
|
+
} | null;
|
|
1335
|
+
};
|
|
1336
|
+
/**
|
|
1337
|
+
* The best matches across the agent's connected apps, and the apps whose
|
|
1338
|
+
* tools could not be listed, which the search did not cover.
|
|
1339
|
+
*/
|
|
1340
|
+
export type ConnectedToolSearch = {
|
|
1341
|
+
/**
|
|
1342
|
+
* At most [`MAX_TOOL_MATCHES`] tools, best first.
|
|
1343
|
+
*/
|
|
1344
|
+
matches: Array<ConnectedToolMatch>;
|
|
1345
|
+
/**
|
|
1346
|
+
* Apps whose tools could not be listed.
|
|
1347
|
+
*/
|
|
1348
|
+
unsearched: Array<ConnectedApp>;
|
|
1349
|
+
};
|
|
1350
|
+
/**
|
|
1351
|
+
* An advertised action, not a tool loaded into the current turn.
|
|
1352
|
+
*/
|
|
1353
|
+
export type ConnectorTool = {
|
|
1354
|
+
/**
|
|
1355
|
+
* What the action supports.
|
|
1356
|
+
*/
|
|
1357
|
+
description: string;
|
|
1358
|
+
/**
|
|
1359
|
+
* Upstream tool name.
|
|
1360
|
+
*/
|
|
1361
|
+
name: string;
|
|
1362
|
+
};
|
|
1363
|
+
/**
|
|
1364
|
+
* Request body for a control operation on a live session.
|
|
1365
|
+
*
|
|
1366
|
+
* A wrapper around the operation rather than the bare enum so that fields
|
|
1367
|
+
* which are about the request rather than the operation have somewhere to go.
|
|
1368
|
+
* The acting user is deliberately not one of them: it comes from the caller's
|
|
1369
|
+
* credentials, so that a caller cannot attribute an operation to someone else.
|
|
1370
|
+
*
|
|
1371
|
+
* Clients serialize this, so both derives are used.
|
|
1372
|
+
*/
|
|
1373
|
+
export type ControlRequest = AgentAction & {
|
|
1374
|
+
actionId?: null | AgentActionId;
|
|
1375
|
+
/**
|
|
1376
|
+
* The app tab the person typed this in (a UUID the tab keeps for its
|
|
1377
|
+
* lifetime), so what the turn opens in the app reaches that tab only.
|
|
1378
|
+
* Only a person's own request may send it; a runtime's is refused.
|
|
1379
|
+
*/
|
|
1380
|
+
clientId?: string | null;
|
|
1381
|
+
/**
|
|
1382
|
+
* Why the agent is being asked. Only a runtime forwarding a triggered
|
|
1383
|
+
* prompt may send it; a user's request carrying it is refused.
|
|
1384
|
+
*/
|
|
1385
|
+
context?: {
|
|
1386
|
+
[key: string]: unknown;
|
|
1387
|
+
} | null;
|
|
1388
|
+
};
|
|
1389
|
+
/**
|
|
1390
|
+
* Response body for a control operation.
|
|
1391
|
+
*
|
|
1392
|
+
* Clients deserialize this, so both derives are used.
|
|
1393
|
+
*/
|
|
1394
|
+
export type ControlResponse = {
|
|
1395
|
+
/**
|
|
1396
|
+
* Matches `requestId` on the folded message this action derives once it
|
|
1397
|
+
* dispatches, and names the queue entry until then. The caller's own
|
|
1398
|
+
* `actionId` when it supplied one; a freshly minted id otherwise.
|
|
1399
|
+
*/
|
|
1400
|
+
actionId: AgentActionId;
|
|
1401
|
+
/**
|
|
1402
|
+
* Whether the action went out or waits in the queue.
|
|
1403
|
+
*/
|
|
1404
|
+
status: ControlStatusDto;
|
|
1405
|
+
};
|
|
1406
|
+
/**
|
|
1407
|
+
* What accepting a control operation did with it, on the wire.
|
|
1408
|
+
*/
|
|
1409
|
+
export type ControlStatusDto = 'sent' | 'queued';
|
|
1410
|
+
/**
|
|
1411
|
+
* The state of one source message, retained after completion for deduplication.
|
|
1412
|
+
*/
|
|
1413
|
+
export type ConversationTurnState = 'queued' | 'running' | 'succeeded' | 'failed' | 'stopped' | 'interrupted';
|
|
1414
|
+
/**
|
|
1415
|
+
* Request body for `POST /agent-sessions`.
|
|
1416
|
+
*
|
|
1417
|
+
* Carries two shapes, told apart by `workspace`. Naming one asks for an
|
|
1418
|
+
* external session: the runtime is the bot operator's, so the caller has to
|
|
1419
|
+
* say which bot and which directory, and must own that bot. Omitting it asks
|
|
1420
|
+
* for a managed session, whose runtime this deployment provisions. A managed
|
|
1421
|
+
* request may select an authorized persisted persona with `botId`; omitting
|
|
1422
|
+
* it uses the deployment's default coding persona, or Cursor when `repoUrl`
|
|
1423
|
+
* is set. Fields describing someone else's runtime must still be omitted
|
|
1424
|
+
* rather than quietly ignored. Mixing the two shapes is refused rather
|
|
1425
|
+
* than guessed at.
|
|
1426
|
+
*
|
|
1427
|
+
* Clients serialize this, so both derives are used.
|
|
1428
|
+
*/
|
|
1429
|
+
export type CreateAgentSessionRequest = {
|
|
1430
|
+
/**
|
|
1431
|
+
* Bot the session runs for. On a managed request this optionally selects
|
|
1432
|
+
* a persisted persona the user owns, may use through team membership, or
|
|
1433
|
+
* can `@` mention in a shared channel; omitting it uses the deployment's
|
|
1434
|
+
* default coding persona, or Cursor when `repoUrl` is set. On an
|
|
1435
|
+
* external request, bot callers may omit it (their own identity is used)
|
|
1436
|
+
* and must not name another bot; user callers must supply a bot they own.
|
|
1437
|
+
*/
|
|
1438
|
+
botId?: string | null;
|
|
1439
|
+
/**
|
|
1440
|
+
* Id to create the session under, minted by the caller. Lets a surface
|
|
1441
|
+
* open on the session's final id - URL, history row, references - the
|
|
1442
|
+
* moment the user acts, rather than after this request answers (which
|
|
1443
|
+
* for a managed sandbox can take a while). Omitted, the service mints
|
|
1444
|
+
* one. Answers 409 if a session already holds the id. On an external
|
|
1445
|
+
* request it is how a runtime answering a composer request names the
|
|
1446
|
+
* id it was handed, so the requester waiting on that id finds the session.
|
|
1447
|
+
*/
|
|
1448
|
+
id?: string | null;
|
|
1449
|
+
/**
|
|
1450
|
+
* Instructions the session's runtime works under, for its whole life.
|
|
1451
|
+
*
|
|
1452
|
+
* Recorded on the session whichever runtime serves it. Only the
|
|
1453
|
+
* in-process one acts on them today; `agent_harness`'s `AgentKind`
|
|
1454
|
+
* records what each of the others will need to.
|
|
1455
|
+
*/
|
|
1456
|
+
instructions?: string | null;
|
|
1457
|
+
/**
|
|
1458
|
+
* Model the managed session runs on, overriding the persona's. Managed
|
|
1459
|
+
* sessions only: an external runtime picks its own.
|
|
1460
|
+
*
|
|
1461
|
+
* The session's model from the moment it exists, which is what a caller
|
|
1462
|
+
* choosing one before the first prompt means. Selecting a model *during*
|
|
1463
|
+
* a session is a control action instead, and reads as one in its
|
|
1464
|
+
* transcript.
|
|
1465
|
+
*/
|
|
1466
|
+
model?: string | null;
|
|
1467
|
+
/**
|
|
1468
|
+
* The user who owns the session. Ignored for user callers, who always
|
|
1469
|
+
* own their own sessions, for harness callers, whose verified acting
|
|
1470
|
+
* user owns the session, and for bots that already act for a verified
|
|
1471
|
+
* user. A bot without one may name a user here. That claim is trusted
|
|
1472
|
+
* for the bot's own sessions. With no claim, a team bot owns the session
|
|
1473
|
+
* itself only while non-user owners are enabled. Every other bot still
|
|
1474
|
+
* needs an owner.
|
|
1475
|
+
*/
|
|
1476
|
+
owner?: string | null;
|
|
1477
|
+
/**
|
|
1478
|
+
* First prompt to deliver once the session is running. The managed shape
|
|
1479
|
+
* only: a persona its operator runs gets it through the session's control
|
|
1480
|
+
* path once its runtime opens the session, while a runtime opening its
|
|
1481
|
+
* own (the `workspace` shape) sends its first prompt through the control
|
|
1482
|
+
* endpoint. Omitted, the session opens idle.
|
|
1483
|
+
*/
|
|
1484
|
+
prompt?: string | null;
|
|
1485
|
+
promptActionId?: null | AgentActionId;
|
|
1486
|
+
/**
|
|
1487
|
+
* Files `prompt` refers to, in the order the user attached them.
|
|
1488
|
+
* Requires `prompt`.
|
|
1489
|
+
*/
|
|
1490
|
+
promptAttachments?: Array<PromptAttachment>;
|
|
1491
|
+
/**
|
|
1492
|
+
* The app tab the person typed `prompt` in, as `clientId` on a control
|
|
1493
|
+
* request, so what the first turn opens in the app reaches that tab
|
|
1494
|
+
* only. Requires `prompt`. Only a person's own request may send it; a
|
|
1495
|
+
* runtime's is refused, and a program using a person's credential has
|
|
1496
|
+
* it dropped.
|
|
1497
|
+
*/
|
|
1498
|
+
promptClientId?: string | null;
|
|
1499
|
+
/**
|
|
1500
|
+
* Starting branch for a managed coding session's selected repository.
|
|
1501
|
+
* Omitted, the session starts on the repository's default branch.
|
|
1502
|
+
*/
|
|
1503
|
+
repoBranch?: string | null;
|
|
1504
|
+
/**
|
|
1505
|
+
* Explicit GitHub repository for a managed Cursor session, as one of the
|
|
1506
|
+
* urls `GET /agent-repositories` lists for the caller. Access is checked
|
|
1507
|
+
* for the session owner. On a managed request that names no `botId`,
|
|
1508
|
+
* this starts the session as Cursor — the only managed persona that
|
|
1509
|
+
* honors a repository. For external sessions this is informational:
|
|
1510
|
+
* cloning it is the runtime operator's job.
|
|
1511
|
+
*/
|
|
1512
|
+
repoUrl?: string | null;
|
|
1513
|
+
thread?: null | CreateSessionThread;
|
|
1514
|
+
/**
|
|
1515
|
+
* Absolute directory the bot's harness runs in on its runtime. Present
|
|
1516
|
+
* for an external session, absent for a managed one, which runs in the
|
|
1517
|
+
* path baked into its image.
|
|
1518
|
+
*/
|
|
1519
|
+
workspace?: string | null;
|
|
1520
|
+
};
|
|
1521
|
+
/**
|
|
1522
|
+
* Response body for `POST /agent-sessions`.
|
|
1523
|
+
*
|
|
1524
|
+
* Clients deserialize this, so both derives are used.
|
|
1525
|
+
*/
|
|
1526
|
+
export type CreateAgentSessionResponse = {
|
|
1527
|
+
/**
|
|
1528
|
+
* The created session.
|
|
1529
|
+
*/
|
|
1530
|
+
session: AgentSessionResponse;
|
|
1531
|
+
};
|
|
1532
|
+
/**
|
|
1533
|
+
* Review creation. Decoding it validates every draft; creating a review only
|
|
1534
|
+
* presents the drafts, and the account holder acts separately.
|
|
1535
|
+
*/
|
|
1536
|
+
export type CreateReview = {
|
|
1537
|
+
[key: string]: unknown;
|
|
1538
|
+
} & {
|
|
1539
|
+
executionId?: null | ExecutionId;
|
|
1540
|
+
/**
|
|
1541
|
+
* Stack label.
|
|
1542
|
+
*/
|
|
1543
|
+
title: string;
|
|
1544
|
+
};
|
|
1545
|
+
/**
|
|
1546
|
+
* The triggering mention on a create request.
|
|
1547
|
+
*
|
|
1548
|
+
* Clients serialize this, so both derives are used.
|
|
1549
|
+
*/
|
|
1550
|
+
export type CreateSessionThread = {
|
|
1551
|
+
/**
|
|
1552
|
+
* Channel the mentioning message was posted in. Runtimes built before
|
|
1553
|
+
* message parents send this instead of `parent`.
|
|
1554
|
+
*/
|
|
1555
|
+
channelId?: string | null;
|
|
1556
|
+
/**
|
|
1557
|
+
* The mention's text, quoted in the session's announcement.
|
|
1558
|
+
*/
|
|
1559
|
+
content?: string;
|
|
1560
|
+
/**
|
|
1561
|
+
* The mentioning message.
|
|
1562
|
+
*/
|
|
1563
|
+
messageId: string;
|
|
1564
|
+
parent?: null | MessageParent;
|
|
1565
|
+
/**
|
|
1566
|
+
* Update the existing bot response reserved by a task assignment.
|
|
1567
|
+
*/
|
|
1568
|
+
reuseOriginMessage?: boolean;
|
|
1569
|
+
/**
|
|
1570
|
+
* Thread the session belongs to; defaults to the message itself, which
|
|
1571
|
+
* is how a top-level mention roots its own thread.
|
|
1572
|
+
*/
|
|
1573
|
+
threadId?: string | null;
|
|
1574
|
+
};
|
|
1575
|
+
/**
|
|
1576
|
+
* Error body for a provider that refused the caller's connected credential.
|
|
1577
|
+
*
|
|
1578
|
+
* JSON rather than the plain text other failures answer with, so a client
|
|
1579
|
+
* can tell this 409 from a disconnected runtime and show `message` as is.
|
|
1580
|
+
*/
|
|
1581
|
+
export type CredentialRejectedResponse = {
|
|
1582
|
+
/**
|
|
1583
|
+
* Always [`Self::CODE`].
|
|
1584
|
+
*/
|
|
1585
|
+
code: string;
|
|
1586
|
+
/**
|
|
1587
|
+
* What to tell the caller, e.g. which kind of key to reconnect with.
|
|
1588
|
+
*/
|
|
1589
|
+
message: string;
|
|
1590
|
+
};
|
|
1591
|
+
/**
|
|
1592
|
+
* Surface of a review decision.
|
|
1593
|
+
*/
|
|
1594
|
+
export type DecisionVia = 'card' | 'chat' | 'inbox';
|
|
1595
|
+
/**
|
|
1596
|
+
* HTTP request selecting one provider to probe.
|
|
1597
|
+
*/
|
|
1598
|
+
export type DiscoverAgentCapabilitiesRequest = {
|
|
1599
|
+
/**
|
|
1600
|
+
* Provider to probe.
|
|
1601
|
+
*/
|
|
1602
|
+
harness: CapabilityHarnessDto;
|
|
1603
|
+
/**
|
|
1604
|
+
* Required for roxd and forbidden for other targets.
|
|
1605
|
+
*/
|
|
1606
|
+
harnessId?: string | null;
|
|
1607
|
+
/**
|
|
1608
|
+
* Model whose session settings should be inspected.
|
|
1609
|
+
*/
|
|
1610
|
+
model?: string | null;
|
|
1611
|
+
};
|
|
1612
|
+
/**
|
|
1613
|
+
* Successful capability-discovery response.
|
|
1614
|
+
*/
|
|
1615
|
+
export type DiscoverAgentCapabilitiesResponse = {
|
|
1616
|
+
/**
|
|
1617
|
+
* Complete ordered ACP session configuration advertised by the agent.
|
|
1618
|
+
*/
|
|
1619
|
+
configOptions: Array<AgentConfigOptionDto>;
|
|
1620
|
+
};
|
|
1621
|
+
/**
|
|
1622
|
+
* Discovery metadata and optional markup for a user-controlled auth flow.
|
|
1623
|
+
*/
|
|
1624
|
+
export type DiscoverConnectorsResponse = {
|
|
1625
|
+
/**
|
|
1626
|
+
* Include verbatim only if an advertised tool supports the requested task.
|
|
1627
|
+
*/
|
|
1628
|
+
connect_markup?: string | null;
|
|
1629
|
+
/**
|
|
1630
|
+
* Catalog or capability results.
|
|
1631
|
+
*/
|
|
1632
|
+
result: DiscoveryResult;
|
|
1633
|
+
};
|
|
1634
|
+
/**
|
|
1635
|
+
* A verified app identity from the directory.
|
|
1636
|
+
*/
|
|
1637
|
+
export type DiscoveredApp = {
|
|
1638
|
+
/**
|
|
1639
|
+
* Exact identity to inspect or connect.
|
|
1640
|
+
*/
|
|
1641
|
+
app_slug: string;
|
|
1642
|
+
/**
|
|
1643
|
+
* Directory description; inspect tools to verify specific capabilities.
|
|
1644
|
+
*/
|
|
1645
|
+
description?: string | null;
|
|
1646
|
+
/**
|
|
1647
|
+
* Human-readable app name.
|
|
1648
|
+
*/
|
|
1649
|
+
name: string;
|
|
1650
|
+
};
|
|
1651
|
+
/**
|
|
1652
|
+
* Search by app name, then inspect a returned slug before recommending auth.
|
|
1653
|
+
*/
|
|
1654
|
+
export type DiscoveryRequest = {
|
|
1655
|
+
operation: 'search';
|
|
1656
|
+
/**
|
|
1657
|
+
* App name, e.g. "Notion" or "Linear", not a task description.
|
|
1658
|
+
*/
|
|
1659
|
+
query: string;
|
|
1660
|
+
} | {
|
|
1661
|
+
/**
|
|
1662
|
+
* Exact app slug from search results.
|
|
1663
|
+
*/
|
|
1664
|
+
app_slug: string;
|
|
1665
|
+
operation: 'inspect';
|
|
1666
|
+
};
|
|
1667
|
+
/**
|
|
1668
|
+
* Discovery results never execute tools or change connections.
|
|
1669
|
+
*/
|
|
1670
|
+
export type DiscoveryResult = {
|
|
1671
|
+
/**
|
|
1672
|
+
* Matching apps.
|
|
1673
|
+
*/
|
|
1674
|
+
apps: Array<DiscoveredApp>;
|
|
1675
|
+
/**
|
|
1676
|
+
* Narrow the app name if this is true.
|
|
1677
|
+
*/
|
|
1678
|
+
more_results: boolean;
|
|
1679
|
+
operation: 'search';
|
|
1680
|
+
} | {
|
|
1681
|
+
/**
|
|
1682
|
+
* App from the directory.
|
|
1683
|
+
*/
|
|
1684
|
+
app: DiscoveredApp;
|
|
1685
|
+
/**
|
|
1686
|
+
* Whether this caller has an enabled connection. For an app that
|
|
1687
|
+
* connects through its own MCP server, that connection is checked
|
|
1688
|
+
* there, not in Pipedream.
|
|
1689
|
+
*/
|
|
1690
|
+
connected: boolean;
|
|
1691
|
+
operation: 'inspect';
|
|
1692
|
+
/**
|
|
1693
|
+
* Advertised tools. Use SearchTools after connecting to load them.
|
|
1694
|
+
*/
|
|
1695
|
+
tools: Array<ConnectorTool>;
|
|
1696
|
+
/**
|
|
1697
|
+
* True when some advertised tools were omitted.
|
|
1698
|
+
*/
|
|
1699
|
+
tools_truncated: boolean;
|
|
1700
|
+
};
|
|
1701
|
+
/**
|
|
1702
|
+
* A validated document identifier. Historical document ids need not be UUIDs.
|
|
1703
|
+
*/
|
|
1704
|
+
export type DocumentId = string;
|
|
1705
|
+
/**
|
|
1706
|
+
* Request body for editing a queued prompt.
|
|
1707
|
+
*/
|
|
1708
|
+
export type EditQueuedActionRequest = {
|
|
1709
|
+
/**
|
|
1710
|
+
* The new raw prompt text, replacing the old wholesale. Never blank: a
|
|
1711
|
+
* prompt with nothing to say is a removal, and there is an endpoint for
|
|
1712
|
+
* that.
|
|
1713
|
+
*/
|
|
1714
|
+
prompt: string;
|
|
1715
|
+
};
|
|
1716
|
+
/**
|
|
1717
|
+
* What the user decided about an elicitation. Mirrors ACP's three actions;
|
|
1718
|
+
* there is no `Other` because we never originate an action we do not know.
|
|
1719
|
+
*/
|
|
1720
|
+
export type ElicitationAnswer = {
|
|
1721
|
+
action: 'accept';
|
|
1722
|
+
/**
|
|
1723
|
+
* Form: the submitted values keyed by property. URL: omitted.
|
|
1724
|
+
*/
|
|
1725
|
+
content?: {
|
|
1726
|
+
[key: string]: ElicitationContentValue;
|
|
1727
|
+
} | null;
|
|
1728
|
+
} | {
|
|
1729
|
+
action: 'decline';
|
|
1730
|
+
} | {
|
|
1731
|
+
action: 'cancel';
|
|
1732
|
+
};
|
|
1733
|
+
/**
|
|
1734
|
+
* A value ACP accepts in an elicitation answer.
|
|
1735
|
+
*
|
|
1736
|
+
* Mirrors ACP's `ElicitationContentValue` so that the contract a caller
|
|
1737
|
+
* answers against is the closed union ACP will accept, rather than arbitrary
|
|
1738
|
+
* JSON narrowed on the way out. An object, a null, or a mixed array is
|
|
1739
|
+
* refused when the request is deserialized - where the caller learns of it -
|
|
1740
|
+
* instead of at send time, when the elicitation slot has already been
|
|
1741
|
+
* released.
|
|
1742
|
+
*/
|
|
1743
|
+
export type ElicitationContentValue = string | boolean | number | number | Array<string>;
|
|
1744
|
+
/**
|
|
1745
|
+
* The JSON-RPC id of an agent's `elicitation/create` request, carried whole
|
|
1746
|
+
* so the answer echoes exactly what the agent sent.
|
|
1747
|
+
*
|
|
1748
|
+
* Agents pick these, not us: Claude Code counts from `0`, others use
|
|
1749
|
+
* strings. `null` is not a legal id for a request that expects a response,
|
|
1750
|
+
* so it is not representable here.
|
|
1751
|
+
*/
|
|
1752
|
+
export type ElicitationRequestId = number | string;
|
|
1753
|
+
/**
|
|
1754
|
+
* Email search exposes importance and connected inbox addresses, not sender filters.
|
|
1755
|
+
*/
|
|
1756
|
+
export type EmailSearchSuggestions = {
|
|
1757
|
+
/**
|
|
1758
|
+
* Explicit importance wording, resolved by the client.
|
|
1759
|
+
*/
|
|
1760
|
+
importance?: string | null;
|
|
1761
|
+
/**
|
|
1762
|
+
* Explicit connected inbox addresses, resolved by the client.
|
|
1763
|
+
*/
|
|
1764
|
+
inboxes: Array<string>;
|
|
1765
|
+
/**
|
|
1766
|
+
* Remaining keyword phrase.
|
|
1767
|
+
*/
|
|
1768
|
+
query?: string | null;
|
|
1769
|
+
};
|
|
1770
|
+
/**
|
|
1771
|
+
* Editable fields for email inference, before submission and identity resolution.
|
|
1772
|
+
*/
|
|
1773
|
+
export type EmailSuggestions = {
|
|
1774
|
+
/**
|
|
1775
|
+
* Explicit blind-carbon-copy recipient names or supplied email addresses.
|
|
1776
|
+
*/
|
|
1777
|
+
bcc?: Array<string>;
|
|
1778
|
+
/**
|
|
1779
|
+
* Suggested Markdown content or outgoing message body.
|
|
1780
|
+
*/
|
|
1781
|
+
body?: string | null;
|
|
1782
|
+
/**
|
|
1783
|
+
* Explicit carbon-copy recipient names or supplied email addresses.
|
|
1784
|
+
*/
|
|
1785
|
+
cc?: Array<string>;
|
|
1786
|
+
/**
|
|
1787
|
+
* Person or channel names for the client to resolve.
|
|
1788
|
+
*/
|
|
1789
|
+
recipients?: Array<string>;
|
|
1790
|
+
/**
|
|
1791
|
+
* Suggested outgoing email subject.
|
|
1792
|
+
*/
|
|
1793
|
+
subject?: string | null;
|
|
1794
|
+
};
|
|
1795
|
+
/**
|
|
1796
|
+
* The type of an entity in Macro
|
|
1797
|
+
*/
|
|
1798
|
+
export type EntityType = 'user' | 'chat' | 'channel' | 'channel_message' | 'document' | 'project' | 'email_thread' | 'calendar_event' | 'team' | 'call' | 'foreign_entity' | 'static_file' | 'crm_company' | 'crm_contact' | 'crm_pipeline' | 'reminder' | 'harness' | 'skill' | 'agent_session' | 'scheduled_action' | 'initiative' | 'database' | 'database_row' | 'form' | 'external_chat';
|
|
1799
|
+
/**
|
|
1800
|
+
* A plain old json error response for use with axum.
|
|
1801
|
+
* yup, thats it.
|
|
1802
|
+
*/
|
|
1803
|
+
export type ErrorResponse = {
|
|
1804
|
+
/**
|
|
1805
|
+
* Message to explain failure
|
|
1806
|
+
*/
|
|
1807
|
+
message: string;
|
|
1808
|
+
};
|
|
1809
|
+
/**
|
|
1810
|
+
* A bounded SDK operation observed during execution; not an authorization or write receipt.
|
|
1811
|
+
*/
|
|
1812
|
+
export type ExecutionActivity = {
|
|
1813
|
+
/**
|
|
1814
|
+
* Request identity within the execution.
|
|
1815
|
+
*/
|
|
1816
|
+
id: number;
|
|
1817
|
+
/**
|
|
1818
|
+
* Server-selected label from the generated operation catalog.
|
|
1819
|
+
*/
|
|
1820
|
+
label: string;
|
|
1821
|
+
/**
|
|
1822
|
+
* Observed request state; unfinished operations have unknown outcomes.
|
|
1823
|
+
*/
|
|
1824
|
+
status: RecordedCallStatus;
|
|
1825
|
+
};
|
|
1826
|
+
/**
|
|
1827
|
+
* Caller-selected UUID persisted in tool input before execution begins.
|
|
1828
|
+
*/
|
|
1829
|
+
export type ExecutionId = string;
|
|
1830
|
+
/**
|
|
1831
|
+
* Durable source and final outcome, with historical bridge calls when present.
|
|
1832
|
+
* The full journal is not included in the model's tool result.
|
|
1833
|
+
*/
|
|
1834
|
+
export type ExecutionRecord = {
|
|
1835
|
+
actingAs?: null | ToolActor;
|
|
1836
|
+
/**
|
|
1837
|
+
* Advisory SDK operation activity, without arguments or response contents.
|
|
1838
|
+
*/
|
|
1839
|
+
activity?: Array<ExecutionActivity>;
|
|
1840
|
+
/**
|
|
1841
|
+
* Additional request activity was omitted at the bounded observation limit.
|
|
1842
|
+
*/
|
|
1843
|
+
activityTruncated?: boolean;
|
|
1844
|
+
/**
|
|
1845
|
+
* Historical bridge calls. Direct HTTP executions leave this empty.
|
|
1846
|
+
*/
|
|
1847
|
+
calls: Array<RecordedToolCall>;
|
|
1848
|
+
/**
|
|
1849
|
+
* Safe execution failure text.
|
|
1850
|
+
*/
|
|
1851
|
+
error?: string | null;
|
|
1852
|
+
/**
|
|
1853
|
+
* Execution identity.
|
|
1854
|
+
*/
|
|
1855
|
+
executionId: ExecutionId;
|
|
1856
|
+
/**
|
|
1857
|
+
* JSON returned by the program, if successful.
|
|
1858
|
+
*/
|
|
1859
|
+
result?: unknown;
|
|
1860
|
+
/**
|
|
1861
|
+
* The submitted JavaScript module.
|
|
1862
|
+
*/
|
|
1863
|
+
source: string;
|
|
1864
|
+
/**
|
|
1865
|
+
* Overall execution state.
|
|
1866
|
+
*/
|
|
1867
|
+
status: ExecutionStatus;
|
|
1868
|
+
/**
|
|
1869
|
+
* Original turn, preventing another requester from replaying a saved result.
|
|
1870
|
+
*/
|
|
1871
|
+
turnId?: string | null;
|
|
1872
|
+
};
|
|
1873
|
+
/**
|
|
1874
|
+
* The recorded outcome of a program.
|
|
1875
|
+
*/
|
|
1876
|
+
export type ExecutionStatus = 'running' | 'succeeded' | 'failed' | 'cancelled' | 'timed_out';
|
|
1877
|
+
/**
|
|
1878
|
+
* The provider-side identity of an externally-served session.
|
|
1879
|
+
*/
|
|
1880
|
+
export type ExternalSessionResponse = {
|
|
1881
|
+
/**
|
|
1882
|
+
* The provider's display name for the agent, when it reported one.
|
|
1883
|
+
*/
|
|
1884
|
+
name?: string | null;
|
|
1885
|
+
/**
|
|
1886
|
+
* Which provider serves the session, e.g. `cursor`.
|
|
1887
|
+
*/
|
|
1888
|
+
provider: string;
|
|
1889
|
+
/**
|
|
1890
|
+
* The agent's page on the provider's site, for a client to link out to.
|
|
1891
|
+
*/
|
|
1892
|
+
url?: string | null;
|
|
1893
|
+
};
|
|
1894
|
+
/**
|
|
1895
|
+
* Draft snapshot and local context used to suggest editable destination fields.
|
|
1896
|
+
*/
|
|
1897
|
+
export type ExtractInputRequest = {
|
|
1898
|
+
/**
|
|
1899
|
+
* Destination whose fields should be extracted.
|
|
1900
|
+
*/
|
|
1901
|
+
intent: InputIntent;
|
|
1902
|
+
/**
|
|
1903
|
+
* Available task fields and display values, never authorized entity IDs.
|
|
1904
|
+
*/
|
|
1905
|
+
property_definitions?: Array<InputPropertyDefinition>;
|
|
1906
|
+
/**
|
|
1907
|
+
* Reference instant for interpreting relative dates.
|
|
1908
|
+
*/
|
|
1909
|
+
reference_time: string;
|
|
1910
|
+
/**
|
|
1911
|
+
* Opaque client revision used to discard stale suggestions.
|
|
1912
|
+
*/
|
|
1913
|
+
revision: number;
|
|
1914
|
+
search_type?: null | SearchType;
|
|
1915
|
+
/**
|
|
1916
|
+
* Original draft text; inference must not execute its instructions.
|
|
1917
|
+
*/
|
|
1918
|
+
text: string;
|
|
1919
|
+
/**
|
|
1920
|
+
* IANA timezone for interpreting local dates and clock times.
|
|
1921
|
+
*/
|
|
1922
|
+
time_zone: string;
|
|
1923
|
+
};
|
|
1924
|
+
/**
|
|
1925
|
+
* Validated suggestions for a particular client draft revision.
|
|
1926
|
+
*/
|
|
1927
|
+
export type ExtractInputResponse = InputSuggestions & {
|
|
1928
|
+
/**
|
|
1929
|
+
* Revision echoed from the extraction request.
|
|
1930
|
+
*/
|
|
1931
|
+
revision: number;
|
|
1932
|
+
};
|
|
1933
|
+
/**
|
|
1934
|
+
* What happened to a file, on the wire.
|
|
1935
|
+
*/
|
|
1936
|
+
export type FileChangeKindDto = 'added' | 'modified' | 'deleted' | 'renamed';
|
|
1937
|
+
/**
|
|
1938
|
+
* One end of the compared range.
|
|
1939
|
+
*/
|
|
1940
|
+
export type GitRefDto = {
|
|
1941
|
+
/**
|
|
1942
|
+
* The branch name, when known.
|
|
1943
|
+
*/
|
|
1944
|
+
name?: string | null;
|
|
1945
|
+
/**
|
|
1946
|
+
* The commit, when known.
|
|
1947
|
+
*/
|
|
1948
|
+
sha?: string | null;
|
|
1949
|
+
};
|
|
1950
|
+
/**
|
|
1951
|
+
* A destination the composer can prepare, but never execute through inference.
|
|
1952
|
+
*/
|
|
1953
|
+
export type InputIntent = 'ai' | 'search' | 'email' | 'note' | 'task' | 'calendar' | 'message';
|
|
1954
|
+
/**
|
|
1955
|
+
* A task property and the display values available for extraction.
|
|
1956
|
+
*/
|
|
1957
|
+
export type InputPropertyDefinition = {
|
|
1958
|
+
/**
|
|
1959
|
+
* Property display name from the client's catalog.
|
|
1960
|
+
*/
|
|
1961
|
+
name: string;
|
|
1962
|
+
/**
|
|
1963
|
+
* Allowed display values; an empty list permits free-text suggestions.
|
|
1964
|
+
*/
|
|
1965
|
+
options?: Array<string>;
|
|
1966
|
+
};
|
|
1967
|
+
/**
|
|
1968
|
+
* Suggested display values to resolve against a real task-property catalog.
|
|
1969
|
+
*/
|
|
1970
|
+
export type InputPropertySuggestion = {
|
|
1971
|
+
/**
|
|
1972
|
+
* Property display name, never an authorized identifier.
|
|
1973
|
+
*/
|
|
1974
|
+
name: string;
|
|
1975
|
+
/**
|
|
1976
|
+
* Suggested display values, never authorized entity identifiers.
|
|
1977
|
+
*/
|
|
1978
|
+
values: Array<string>;
|
|
1979
|
+
};
|
|
1980
|
+
/**
|
|
1981
|
+
* A single inferred destination together with only its applicable fields.
|
|
1982
|
+
*/
|
|
1983
|
+
export type InputSuggestions = {
|
|
1984
|
+
intent: 'ai';
|
|
1985
|
+
/**
|
|
1986
|
+
* Editable ai fields.
|
|
1987
|
+
*/
|
|
1988
|
+
suggestions: AiSuggestions;
|
|
1989
|
+
} | {
|
|
1990
|
+
intent: 'search';
|
|
1991
|
+
/**
|
|
1992
|
+
* Editable search fields.
|
|
1993
|
+
*/
|
|
1994
|
+
suggestions: SearchSuggestions;
|
|
1995
|
+
} | {
|
|
1996
|
+
intent: 'email';
|
|
1997
|
+
/**
|
|
1998
|
+
* Editable email fields.
|
|
1999
|
+
*/
|
|
2000
|
+
suggestions: EmailSuggestions;
|
|
2001
|
+
} | {
|
|
2002
|
+
intent: 'note';
|
|
2003
|
+
/**
|
|
2004
|
+
* Editable note fields.
|
|
2005
|
+
*/
|
|
2006
|
+
suggestions: NoteSuggestions;
|
|
2007
|
+
} | {
|
|
2008
|
+
intent: 'task';
|
|
2009
|
+
/**
|
|
2010
|
+
* Editable task fields.
|
|
2011
|
+
*/
|
|
2012
|
+
suggestions: TaskSuggestions;
|
|
2013
|
+
} | {
|
|
2014
|
+
intent: 'calendar';
|
|
2015
|
+
/**
|
|
2016
|
+
* Editable calendar fields.
|
|
2017
|
+
*/
|
|
2018
|
+
suggestions: CalendarSuggestions;
|
|
2019
|
+
} | {
|
|
2020
|
+
intent: 'message';
|
|
2021
|
+
/**
|
|
2022
|
+
* Editable message fields.
|
|
2023
|
+
*/
|
|
2024
|
+
suggestions: MessageSuggestions;
|
|
2025
|
+
};
|
|
2026
|
+
/**
|
|
2027
|
+
* Independent yes/no probabilities; these do not sum to one.
|
|
2028
|
+
*/
|
|
2029
|
+
export type IntentScore = {
|
|
2030
|
+
/**
|
|
2031
|
+
* Destination evaluated by the classifier.
|
|
2032
|
+
*/
|
|
2033
|
+
intent: InputIntent;
|
|
2034
|
+
/**
|
|
2035
|
+
* Independent probability between zero and one.
|
|
2036
|
+
*/
|
|
2037
|
+
score: number;
|
|
2038
|
+
};
|
|
2039
|
+
/**
|
|
2040
|
+
* Where an acting agent's work came from.
|
|
2041
|
+
*/
|
|
2042
|
+
export type Lineage = {
|
|
2043
|
+
/**
|
|
2044
|
+
* The first non-agent cause of its work.
|
|
2045
|
+
*/
|
|
2046
|
+
root: Root;
|
|
2047
|
+
/**
|
|
2048
|
+
* The acting session.
|
|
2049
|
+
*/
|
|
2050
|
+
session: string;
|
|
2051
|
+
type: 'session';
|
|
2052
|
+
} | {
|
|
2053
|
+
type: 'unattributed';
|
|
2054
|
+
};
|
|
2055
|
+
/**
|
|
2056
|
+
* Defines who can access an item through its share link.
|
|
2057
|
+
*/
|
|
2058
|
+
export type LinkShare = 'PUBLIC' | 'TEAM';
|
|
2059
|
+
/**
|
|
2060
|
+
* The task to link a session to.
|
|
2061
|
+
*/
|
|
2062
|
+
export type LinkTaskRequest = {
|
|
2063
|
+
/**
|
|
2064
|
+
* The task document's id.
|
|
2065
|
+
*/
|
|
2066
|
+
taskId: string;
|
|
2067
|
+
};
|
|
2068
|
+
/**
|
|
2069
|
+
* The task a session is now linked to.
|
|
2070
|
+
*/
|
|
2071
|
+
export type LinkedTaskResponse = {
|
|
2072
|
+
/**
|
|
2073
|
+
* The session's pull request, now linked to the task, if it has one.
|
|
2074
|
+
*/
|
|
2075
|
+
pullRequestUrl?: string | null;
|
|
2076
|
+
/**
|
|
2077
|
+
* Put this in the pull request description so GitHub activity reaches the task.
|
|
2078
|
+
*/
|
|
2079
|
+
reference: string;
|
|
2080
|
+
/**
|
|
2081
|
+
* The task document's id.
|
|
2082
|
+
*/
|
|
2083
|
+
taskId: string;
|
|
2084
|
+
};
|
|
2085
|
+
/**
|
|
2086
|
+
* HTTP request selecting one provider to probe.
|
|
2087
|
+
*/
|
|
2088
|
+
export type LoadAgentModelsRequest = {
|
|
2089
|
+
/**
|
|
2090
|
+
* Provider to probe.
|
|
2091
|
+
*/
|
|
2092
|
+
harness: ModelHarnessDto;
|
|
2093
|
+
/**
|
|
2094
|
+
* Required for roxd and forbidden for other targets.
|
|
2095
|
+
*/
|
|
2096
|
+
harnessId?: string | null;
|
|
2097
|
+
};
|
|
2098
|
+
/**
|
|
2099
|
+
* Successful model-discovery response.
|
|
2100
|
+
*/
|
|
2101
|
+
export type LoadAgentModelsResponse = {
|
|
2102
|
+
/**
|
|
2103
|
+
* When a paired runtime that is off or unreachable last reported this
|
|
2104
|
+
* catalog; null when it was probed live.
|
|
2105
|
+
*/
|
|
2106
|
+
cachedAt?: string | null;
|
|
2107
|
+
/**
|
|
2108
|
+
* Current provider model, if model selection is available.
|
|
2109
|
+
*/
|
|
2110
|
+
currentModel?: string | null;
|
|
2111
|
+
/**
|
|
2112
|
+
* Ordered model catalog.
|
|
2113
|
+
*/
|
|
2114
|
+
models: Array<AgentModelDto>;
|
|
2115
|
+
/**
|
|
2116
|
+
* Model-selection availability.
|
|
2117
|
+
*/
|
|
2118
|
+
status: AgentModelsStatusDto;
|
|
2119
|
+
};
|
|
2120
|
+
/**
|
|
2121
|
+
* Which way a logged frame travelled, mirroring [`Message`]'s discriminant.
|
|
2122
|
+
*/
|
|
2123
|
+
export type LogDirectionDto = 'notification' | 'to_server' | 'to_runtime';
|
|
2124
|
+
/**
|
|
2125
|
+
* The two fields [`AgentSessionLogEntryDto`] flattens in.
|
|
2126
|
+
*
|
|
2127
|
+
* Schema only. Nothing constructs one: the entry serializes through
|
|
2128
|
+
* [`Message`], and this exists so the generated clients see `direction` and
|
|
2129
|
+
* `content` as named fields instead of an open map. A hand-built copy could
|
|
2130
|
+
* drift from the fold's wire format, and the point of the endpoint is that it
|
|
2131
|
+
* cannot - so this describes that format without being able to produce it.
|
|
2132
|
+
*/
|
|
2133
|
+
export type LogFrameDto = {
|
|
2134
|
+
/**
|
|
2135
|
+
* The protocol envelope, verbatim. Opaque here: it is Agent Runtime
|
|
2136
|
+
* Protocol, whose shape belongs to the fold rather than this endpoint.
|
|
2137
|
+
*/
|
|
2138
|
+
content: {
|
|
2139
|
+
[key: string]: unknown;
|
|
2140
|
+
};
|
|
2141
|
+
/**
|
|
2142
|
+
* Which way the frame travelled.
|
|
2143
|
+
*/
|
|
2144
|
+
direction: LogDirectionDto;
|
|
2145
|
+
};
|
|
2146
|
+
export type RoxUserIdStr = string;
|
|
2147
|
+
/**
|
|
2148
|
+
* The entity whose permissions and lifecycle govern a message.
|
|
2149
|
+
*/
|
|
2150
|
+
export type MessageParent = {
|
|
2151
|
+
/**
|
|
2152
|
+
* A channel, including direct messages.
|
|
2153
|
+
*/
|
|
2154
|
+
id: string;
|
|
2155
|
+
type: 'channel';
|
|
2156
|
+
} | {
|
|
2157
|
+
/**
|
|
2158
|
+
* A document, including tasks and PDFs.
|
|
2159
|
+
*/
|
|
2160
|
+
id: DocumentId;
|
|
2161
|
+
type: 'document';
|
|
2162
|
+
} | {
|
|
2163
|
+
/**
|
|
2164
|
+
* An initiative, presented as a project in the application.
|
|
2165
|
+
*/
|
|
2166
|
+
id: string;
|
|
2167
|
+
type: 'initiative';
|
|
2168
|
+
} | {
|
|
2169
|
+
/**
|
|
2170
|
+
* A CRM company.
|
|
2171
|
+
*/
|
|
2172
|
+
id: string;
|
|
2173
|
+
type: 'crm_company';
|
|
2174
|
+
} | {
|
|
2175
|
+
/**
|
|
2176
|
+
* A CRM contact.
|
|
2177
|
+
*/
|
|
2178
|
+
id: string;
|
|
2179
|
+
type: 'crm_contact';
|
|
2180
|
+
} | {
|
|
2181
|
+
/**
|
|
2182
|
+
* A video call and its persistent chat thread.
|
|
2183
|
+
*/
|
|
2184
|
+
id: string;
|
|
2185
|
+
type: 'call';
|
|
2186
|
+
};
|
|
2187
|
+
/**
|
|
2188
|
+
* Editable fields for message inference, before submission and identity resolution.
|
|
2189
|
+
*/
|
|
2190
|
+
export type MessageSuggestions = {
|
|
2191
|
+
/**
|
|
2192
|
+
* Suggested Markdown content or outgoing message body.
|
|
2193
|
+
*/
|
|
2194
|
+
body?: string | null;
|
|
2195
|
+
/**
|
|
2196
|
+
* Person or channel names for the client to resolve.
|
|
2197
|
+
*/
|
|
2198
|
+
recipients?: Array<string>;
|
|
2199
|
+
};
|
|
2200
|
+
/**
|
|
2201
|
+
* Harness names accepted by the model discovery endpoint.
|
|
2202
|
+
*/
|
|
2203
|
+
export type ModelHarnessDto = 'in-memory' | 'cursor' | 'roxd';
|
|
2204
|
+
/**
|
|
2205
|
+
* Monthly ordinal weekday, such as the first Friday.
|
|
2206
|
+
*/
|
|
2207
|
+
export type MonthlyWeekday = {
|
|
2208
|
+
/**
|
|
2209
|
+
* One through five, or minus one for last.
|
|
2210
|
+
*/
|
|
2211
|
+
ordinal: number;
|
|
2212
|
+
/**
|
|
2213
|
+
* Weekday selected by the ordinal.
|
|
2214
|
+
*/
|
|
2215
|
+
weekday: WeekdayCode;
|
|
2216
|
+
};
|
|
2217
|
+
/**
|
|
2218
|
+
* Editable fields for note inference, before submission and identity resolution.
|
|
2219
|
+
*/
|
|
2220
|
+
export type NoteSuggestions = {
|
|
2221
|
+
/**
|
|
2222
|
+
* Suggested Markdown content or outgoing message body.
|
|
2223
|
+
*/
|
|
2224
|
+
body?: string | null;
|
|
2225
|
+
/**
|
|
2226
|
+
* Suggested note, task, or event title.
|
|
2227
|
+
*/
|
|
2228
|
+
title?: string | null;
|
|
2229
|
+
};
|
|
2230
|
+
/**
|
|
2231
|
+
* Open an item in the prompting person's app tab.
|
|
2232
|
+
*/
|
|
2233
|
+
export type OpenInApp = {
|
|
2234
|
+
/**
|
|
2235
|
+
* The running execution asking; it must belong to the session's
|
|
2236
|
+
* current turn.
|
|
2237
|
+
*/
|
|
2238
|
+
executionId: ExecutionId;
|
|
2239
|
+
/**
|
|
2240
|
+
* An app path, such as `/md/<id>` or `/channels/<id>?s0.channels.messageId=<id>`:
|
|
2241
|
+
* what follows `/app` in a Rox link. Never an origin.
|
|
2242
|
+
*/
|
|
2243
|
+
path: string;
|
|
2244
|
+
/**
|
|
2245
|
+
* Where to put it; beside the agent by default.
|
|
2246
|
+
*/
|
|
2247
|
+
placement?: UiPlacement;
|
|
2248
|
+
};
|
|
2249
|
+
/**
|
|
2250
|
+
* The decision carried by an [`AgentPermissionAction`].
|
|
2251
|
+
*/
|
|
2252
|
+
export type PermissionAnswer = {
|
|
2253
|
+
kind: 'selected';
|
|
2254
|
+
/**
|
|
2255
|
+
* The chosen option's id, as the agent listed it.
|
|
2256
|
+
*/
|
|
2257
|
+
optionId: string;
|
|
2258
|
+
} | {
|
|
2259
|
+
kind: 'cancelled';
|
|
2260
|
+
};
|
|
2261
|
+
/**
|
|
2262
|
+
* A view to present.
|
|
2263
|
+
*/
|
|
2264
|
+
export type PresentView = {
|
|
2265
|
+
executionId?: null | ExecutionId;
|
|
2266
|
+
/**
|
|
2267
|
+
* A dynamic-UI view, in the format of the PresentView schema in
|
|
2268
|
+
* ExecuteCode's description.
|
|
2269
|
+
*/
|
|
2270
|
+
view: {
|
|
2271
|
+
[key: string]: unknown;
|
|
2272
|
+
};
|
|
2273
|
+
};
|
|
2274
|
+
/**
|
|
2275
|
+
* Request body for `POST /agent-sessions/preview`.
|
|
2276
|
+
*
|
|
2277
|
+
* Clients serialize this, so both derives are used.
|
|
2278
|
+
*/
|
|
2279
|
+
export type PreviewAgentSessionsRequest = {
|
|
2280
|
+
/**
|
|
2281
|
+
* The sessions to preview. Duplicates are collapsed server-side; at most
|
|
2282
|
+
* [`MAX_PREVIEW_SESSION_IDS`](crate::domain::model::MAX_PREVIEW_SESSION_IDS)
|
|
2283
|
+
* distinct ids per request.
|
|
2284
|
+
*/
|
|
2285
|
+
sessionIds: Array<string>;
|
|
2286
|
+
};
|
|
2287
|
+
/**
|
|
2288
|
+
* Response body for `POST /agent-sessions/preview`: one entry per distinct
|
|
2289
|
+
* requested id, in no particular order.
|
|
2290
|
+
*
|
|
2291
|
+
* Clients deserialize this, so both derives are used.
|
|
2292
|
+
*/
|
|
2293
|
+
export type PreviewAgentSessionsResponse = {
|
|
2294
|
+
/**
|
|
2295
|
+
* What the caller may see of each requested session.
|
|
2296
|
+
*/
|
|
2297
|
+
previews: Array<AgentSessionPreviewDto>;
|
|
2298
|
+
};
|
|
2299
|
+
/**
|
|
2300
|
+
* A file the prompt refers to, by where the agent can fetch it.
|
|
2301
|
+
*
|
|
2302
|
+
* Mirrors ACP's `resource_link` content block, which every agent must
|
|
2303
|
+
* accept: bytes never ride the prompt, only a URI (a static file service URL
|
|
2304
|
+
* in practice) with enough metadata for a client to render a chip and for
|
|
2305
|
+
* the agent to decide whether to fetch it. Keeping the wire shape ACP-native
|
|
2306
|
+
* means the harness translates without resolving anything, and the fold
|
|
2307
|
+
* reads the same fields back off the logged frame.
|
|
2308
|
+
*/
|
|
2309
|
+
export type PromptAttachment = {
|
|
2310
|
+
/**
|
|
2311
|
+
* The file's media type, when known.
|
|
2312
|
+
*/
|
|
2313
|
+
mimeType?: string | null;
|
|
2314
|
+
/**
|
|
2315
|
+
* Display name, typically the original file name.
|
|
2316
|
+
*/
|
|
2317
|
+
name: string;
|
|
2318
|
+
/**
|
|
2319
|
+
* Size in bytes, when known.
|
|
2320
|
+
*/
|
|
2321
|
+
size?: number | null;
|
|
2322
|
+
/**
|
|
2323
|
+
* Where the agent can fetch the file.
|
|
2324
|
+
*/
|
|
2325
|
+
uri: string;
|
|
2326
|
+
};
|
|
2327
|
+
/**
|
|
2328
|
+
* Who associated a pull request with a session.
|
|
2329
|
+
*/
|
|
2330
|
+
export type PullRequestLinkSource = 'agent' | 'user';
|
|
2331
|
+
/**
|
|
2332
|
+
* A session linked to a pull request, as a viewer of that session sees it.
|
|
2333
|
+
*/
|
|
2334
|
+
export type PullRequestLinkedSession = {
|
|
2335
|
+
/**
|
|
2336
|
+
* The message that started the session, such as an @mention, when it was
|
|
2337
|
+
* started from a thread. A mention inside a thread is that reply, not the root.
|
|
2338
|
+
*/
|
|
2339
|
+
originMessageId?: string | null;
|
|
2340
|
+
/**
|
|
2341
|
+
* The session id.
|
|
2342
|
+
*/
|
|
2343
|
+
sessionId: string;
|
|
2344
|
+
/**
|
|
2345
|
+
* Who associated the pull request with the session.
|
|
2346
|
+
*/
|
|
2347
|
+
source: PullRequestLinkSource;
|
|
2348
|
+
threadParent?: null | MessageParent;
|
|
2349
|
+
};
|
|
2350
|
+
/**
|
|
2351
|
+
* The sessions linked to one pull request that the caller can view.
|
|
2352
|
+
*/
|
|
2353
|
+
export type PullRequestSessions = {
|
|
2354
|
+
/**
|
|
2355
|
+
* The pull request's `owner/repo/pull/number` key.
|
|
2356
|
+
*/
|
|
2357
|
+
githubKey: string;
|
|
2358
|
+
/**
|
|
2359
|
+
* Linked sessions the caller can view, oldest link first.
|
|
2360
|
+
*/
|
|
2361
|
+
sessions: Array<PullRequestLinkedSession>;
|
|
2362
|
+
/**
|
|
2363
|
+
* The requested pull request URL, canonicalized.
|
|
2364
|
+
*/
|
|
2365
|
+
url: string;
|
|
2366
|
+
};
|
|
2367
|
+
/**
|
|
2368
|
+
* The sessions associated with a pull request.
|
|
2369
|
+
*/
|
|
2370
|
+
export type PullRequestSessionsResponse = {
|
|
2371
|
+
/**
|
|
2372
|
+
* Sessions associated with the pull request that the caller can view.
|
|
2373
|
+
*/
|
|
2374
|
+
sessionIds: Array<string>;
|
|
2375
|
+
};
|
|
2376
|
+
/**
|
|
2377
|
+
* A GitHub pull request, by URL.
|
|
2378
|
+
*/
|
|
2379
|
+
export type PullRequestUrl = {
|
|
2380
|
+
/**
|
|
2381
|
+
* The pull request's GitHub URL, such as `https://github.com/owner/repo/pull/12`.
|
|
2382
|
+
*/
|
|
2383
|
+
url: string;
|
|
2384
|
+
};
|
|
2385
|
+
/**
|
|
2386
|
+
* GitHub pull requests, by URL.
|
|
2387
|
+
*/
|
|
2388
|
+
export type PullRequestUrls = {
|
|
2389
|
+
/**
|
|
2390
|
+
* Pull request GitHub URLs, at most 100.
|
|
2391
|
+
*/
|
|
2392
|
+
urls: Array<string>;
|
|
2393
|
+
};
|
|
2394
|
+
/**
|
|
2395
|
+
* The sessions associated with each requested pull request.
|
|
2396
|
+
*/
|
|
2397
|
+
export type PullRequestsSessionsResponse = {
|
|
2398
|
+
/**
|
|
2399
|
+
* One entry per requested pull request, in request order.
|
|
2400
|
+
*/
|
|
2401
|
+
pullRequests: Array<PullRequestSessions>;
|
|
2402
|
+
};
|
|
2403
|
+
/**
|
|
2404
|
+
* A topic for search types without additional supported facets.
|
|
2405
|
+
*/
|
|
2406
|
+
export type QuerySearchSuggestions = {
|
|
2407
|
+
/**
|
|
2408
|
+
* Remaining keyword phrase after supported filters and instructions.
|
|
2409
|
+
*/
|
|
2410
|
+
query?: string | null;
|
|
2411
|
+
};
|
|
2412
|
+
/**
|
|
2413
|
+
* One action waiting in a session's queue.
|
|
2414
|
+
*
|
|
2415
|
+
* Clients deserialize this, so both derives are used.
|
|
2416
|
+
*/
|
|
2417
|
+
export type QueuedActionDto = {
|
|
2418
|
+
/**
|
|
2419
|
+
* The id the action was accepted under.
|
|
2420
|
+
*/
|
|
2421
|
+
actionId: AgentActionId;
|
|
2422
|
+
/**
|
|
2423
|
+
* The user who queued it, absent when a bot acted on nobody's behalf.
|
|
2424
|
+
*/
|
|
2425
|
+
actorUserId?: string | null;
|
|
2426
|
+
/**
|
|
2427
|
+
* Files the prompt refers to, for prompts only. Kept through an edit,
|
|
2428
|
+
* which replaces the text alone.
|
|
2429
|
+
*/
|
|
2430
|
+
attachments?: Array<PromptAttachment>;
|
|
2431
|
+
/**
|
|
2432
|
+
* When it was accepted.
|
|
2433
|
+
*/
|
|
2434
|
+
createdAt: string;
|
|
2435
|
+
/**
|
|
2436
|
+
* What kind of action waits - `prompt` or `compact`; only
|
|
2437
|
+
* turn-occupying actions are ever queued.
|
|
2438
|
+
*/
|
|
2439
|
+
kind: string;
|
|
2440
|
+
/**
|
|
2441
|
+
* The prompt's raw text, present for prompts only. What an edit
|
|
2442
|
+
* replaces.
|
|
2443
|
+
*/
|
|
2444
|
+
prompt?: string | null;
|
|
2445
|
+
};
|
|
2446
|
+
/**
|
|
2447
|
+
* A dispatch result; unfinished work is never reported as success.
|
|
2448
|
+
*/
|
|
2449
|
+
export type RecordedCallStatus = 'running' | 'completed' | 'failed' | 'unknown';
|
|
2450
|
+
/**
|
|
2451
|
+
* A real inner call, recorded by trusted dispatch for the existing renderers.
|
|
2452
|
+
*/
|
|
2453
|
+
export type RecordedToolCall = {
|
|
2454
|
+
/**
|
|
2455
|
+
* Safe tool failure, if one was returned.
|
|
2456
|
+
*/
|
|
2457
|
+
error?: string | null;
|
|
2458
|
+
/**
|
|
2459
|
+
* Stable, execution-scoped component identity.
|
|
2460
|
+
*/
|
|
2461
|
+
id: string;
|
|
2462
|
+
/**
|
|
2463
|
+
* Arguments passed to the actual tool.
|
|
2464
|
+
*/
|
|
2465
|
+
input: unknown;
|
|
2466
|
+
/**
|
|
2467
|
+
* Canonical Rox tool name from the allowlisted registry.
|
|
2468
|
+
*/
|
|
2469
|
+
name: string;
|
|
2470
|
+
/**
|
|
2471
|
+
* Original tool output, retained independently of the program's return value.
|
|
2472
|
+
*/
|
|
2473
|
+
output?: unknown;
|
|
2474
|
+
/**
|
|
2475
|
+
* Whether the response was omitted to keep the durable journal bounded.
|
|
2476
|
+
*/
|
|
2477
|
+
outputOmitted: boolean;
|
|
2478
|
+
/**
|
|
2479
|
+
* A started call that never replied has an unknown side-effect outcome.
|
|
2480
|
+
*/
|
|
2481
|
+
status: RecordedCallStatus;
|
|
2482
|
+
};
|
|
2483
|
+
/**
|
|
2484
|
+
* Resolved recurrence ending condition accepted by the shared calendar editor.
|
|
2485
|
+
*/
|
|
2486
|
+
export type RecurrenceEnd = {
|
|
2487
|
+
kind: 'never';
|
|
2488
|
+
} | {
|
|
2489
|
+
/**
|
|
2490
|
+
* Positive occurrence count.
|
|
2491
|
+
*/
|
|
2492
|
+
count: number;
|
|
2493
|
+
kind: 'after';
|
|
2494
|
+
} | {
|
|
2495
|
+
/**
|
|
2496
|
+
* Date resolved against the request's clock and timezone.
|
|
2497
|
+
*/
|
|
2498
|
+
date: string;
|
|
2499
|
+
kind: 'on';
|
|
2500
|
+
};
|
|
2501
|
+
/**
|
|
2502
|
+
* Repetition units supported by the shared calendar editor.
|
|
2503
|
+
*/
|
|
2504
|
+
export type RecurrenceFrequency = 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY';
|
|
2505
|
+
/**
|
|
2506
|
+
* Resolved, editable repetition values; the existing calendar serializer builds RRULEs.
|
|
2507
|
+
*/
|
|
2508
|
+
export type RecurrenceSuggestion = {
|
|
2509
|
+
/**
|
|
2510
|
+
* Weekly weekday selectors.
|
|
2511
|
+
*/
|
|
2512
|
+
by_day: Array<WeekdayCode>;
|
|
2513
|
+
/**
|
|
2514
|
+
* Resolved ending condition.
|
|
2515
|
+
*/
|
|
2516
|
+
ends: RecurrenceEnd;
|
|
2517
|
+
/**
|
|
2518
|
+
* Repetition unit.
|
|
2519
|
+
*/
|
|
2520
|
+
frequency: RecurrenceFrequency;
|
|
2521
|
+
/**
|
|
2522
|
+
* Positive interval.
|
|
2523
|
+
*/
|
|
2524
|
+
interval: number;
|
|
2525
|
+
monthly_by_day?: null | MonthlyWeekday;
|
|
2526
|
+
};
|
|
2527
|
+
/**
|
|
2528
|
+
* Request body for renaming an agent session.
|
|
2529
|
+
*/
|
|
2530
|
+
export type RenameAgentSessionRequest = {
|
|
2531
|
+
/**
|
|
2532
|
+
* New user-facing name. Leading and trailing whitespace is discarded.
|
|
2533
|
+
*/
|
|
2534
|
+
name: string;
|
|
2535
|
+
};
|
|
2536
|
+
/**
|
|
2537
|
+
* The attempt the user saw and chose to retry; prevents double-click reruns.
|
|
2538
|
+
*/
|
|
2539
|
+
export type RetryAgentConversationTurnRequest = {
|
|
2540
|
+
/**
|
|
2541
|
+
* Current failed attempt identity.
|
|
2542
|
+
*/
|
|
2543
|
+
actionId: string;
|
|
2544
|
+
};
|
|
2545
|
+
/**
|
|
2546
|
+
* One atomic user decision against the displayed revision.
|
|
2547
|
+
*/
|
|
2548
|
+
export type ReviewDecision = {
|
|
2549
|
+
action: 'edit';
|
|
2550
|
+
/**
|
|
2551
|
+
* Replacement action arguments, keyed by the review's kind.
|
|
2552
|
+
*/
|
|
2553
|
+
draft: {
|
|
2554
|
+
[key: string]: unknown;
|
|
2555
|
+
};
|
|
2556
|
+
/**
|
|
2557
|
+
* Pending item to update.
|
|
2558
|
+
*/
|
|
2559
|
+
item: string;
|
|
2560
|
+
/**
|
|
2561
|
+
* Revision displayed by the caller.
|
|
2562
|
+
*/
|
|
2563
|
+
revision: number;
|
|
2564
|
+
} | {
|
|
2565
|
+
action: 'submit';
|
|
2566
|
+
/**
|
|
2567
|
+
* Pending items, or an empty list to select all pending items.
|
|
2568
|
+
*/
|
|
2569
|
+
items: Array<string>;
|
|
2570
|
+
/**
|
|
2571
|
+
* Revision displayed by the caller.
|
|
2572
|
+
*/
|
|
2573
|
+
revision: number;
|
|
2574
|
+
} | {
|
|
2575
|
+
action: 'dismiss';
|
|
2576
|
+
/**
|
|
2577
|
+
* Pending items, or an empty list to select all pending items.
|
|
2578
|
+
*/
|
|
2579
|
+
items: Array<string>;
|
|
2580
|
+
/**
|
|
2581
|
+
* Revision displayed by the caller.
|
|
2582
|
+
*/
|
|
2583
|
+
revision: number;
|
|
2584
|
+
};
|
|
2585
|
+
/**
|
|
2586
|
+
* Facts about the most recent account-holder decision.
|
|
2587
|
+
*/
|
|
2588
|
+
export type ReviewDecisionContext = {
|
|
2589
|
+
/**
|
|
2590
|
+
* Authenticated account holder.
|
|
2591
|
+
*/
|
|
2592
|
+
by: string;
|
|
2593
|
+
/**
|
|
2594
|
+
* Items selected by this decision.
|
|
2595
|
+
*/
|
|
2596
|
+
items: Array<string>;
|
|
2597
|
+
/**
|
|
2598
|
+
* Revision claimed by this batch, used in notification deduplication.
|
|
2599
|
+
*/
|
|
2600
|
+
revision: number;
|
|
2601
|
+
/**
|
|
2602
|
+
* Entry surface.
|
|
2603
|
+
*/
|
|
2604
|
+
via: DecisionVia;
|
|
2605
|
+
};
|
|
2606
|
+
/**
|
|
2607
|
+
* Persisted review identity.
|
|
2608
|
+
*/
|
|
2609
|
+
export type ReviewId = string;
|
|
2610
|
+
/**
|
|
2611
|
+
* Full UI record, fetched outside the model context.
|
|
2612
|
+
*/
|
|
2613
|
+
export type ReviewRecord = {
|
|
2614
|
+
[key: string]: unknown;
|
|
2615
|
+
} & {
|
|
2616
|
+
/**
|
|
2617
|
+
* Account whose email/calendar the drafts use.
|
|
2618
|
+
*/
|
|
2619
|
+
actingUser: string;
|
|
2620
|
+
decision?: null | ReviewDecisionContext;
|
|
2621
|
+
executionId?: null | ExecutionId;
|
|
2622
|
+
/**
|
|
2623
|
+
* Review identity.
|
|
2624
|
+
*/
|
|
2625
|
+
id: ReviewId;
|
|
2626
|
+
/**
|
|
2627
|
+
* Durable presentation acknowledgment, separate from user decisions.
|
|
2628
|
+
*/
|
|
2629
|
+
presentedAt?: number | null;
|
|
2630
|
+
/**
|
|
2631
|
+
* Compare-and-swap revision for edits and submissions.
|
|
2632
|
+
*/
|
|
2633
|
+
revision: number;
|
|
2634
|
+
/**
|
|
2635
|
+
* Owning session.
|
|
2636
|
+
*/
|
|
2637
|
+
sessionId: string;
|
|
2638
|
+
/**
|
|
2639
|
+
* Stack label.
|
|
2640
|
+
*/
|
|
2641
|
+
title: string;
|
|
2642
|
+
/**
|
|
2643
|
+
* Milliseconds since epoch of the last state change.
|
|
2644
|
+
*/
|
|
2645
|
+
updatedAt: number;
|
|
2646
|
+
};
|
|
2647
|
+
/**
|
|
2648
|
+
* The first non-agent cause. An agent cannot be one, so a chain always ends
|
|
2649
|
+
* at a person or a routine.
|
|
2650
|
+
*/
|
|
2651
|
+
export type Root = {
|
|
2652
|
+
type: 'person';
|
|
2653
|
+
/**
|
|
2654
|
+
* Who.
|
|
2655
|
+
*/
|
|
2656
|
+
user: RoxUserIdStr;
|
|
2657
|
+
} | {
|
|
2658
|
+
/**
|
|
2659
|
+
* The routine.
|
|
2660
|
+
*/
|
|
2661
|
+
routine: string;
|
|
2662
|
+
type: 'routine';
|
|
2663
|
+
};
|
|
2664
|
+
/**
|
|
2665
|
+
* What made a routine fire.
|
|
2666
|
+
*/
|
|
2667
|
+
export type RoutineCause = {
|
|
2668
|
+
type: 'scheduled';
|
|
2669
|
+
} | {
|
|
2670
|
+
type: 'manual';
|
|
2671
|
+
} | {
|
|
2672
|
+
/**
|
|
2673
|
+
* The event.
|
|
2674
|
+
*/
|
|
2675
|
+
event_id: string;
|
|
2676
|
+
type: 'event';
|
|
2677
|
+
};
|
|
2678
|
+
/**
|
|
2679
|
+
* Named compute tier for a managed sandbox.
|
|
2680
|
+
*
|
|
2681
|
+
* The API and database store the name. CPU, RAM, and disk live in
|
|
2682
|
+
* `crates/agent_harness/sandbox_sizes.json`.
|
|
2683
|
+
*/
|
|
2684
|
+
export type SandboxSize = 'small' | 'default' | 'large';
|
|
2685
|
+
/**
|
|
2686
|
+
* Request or response body for a named sandbox size.
|
|
2687
|
+
*/
|
|
2688
|
+
export type SandboxSizeBody = {
|
|
2689
|
+
/**
|
|
2690
|
+
* Named compute tier.
|
|
2691
|
+
*/
|
|
2692
|
+
size: SandboxSize;
|
|
2693
|
+
};
|
|
2694
|
+
/**
|
|
2695
|
+
* Only the selected type's fields can appear in a search suggestion.
|
|
2696
|
+
*/
|
|
2697
|
+
export type SearchSuggestions = (QuerySearchSuggestions & {
|
|
2698
|
+
type: 'all';
|
|
2699
|
+
}) | (ChannelSearchSuggestions & {
|
|
2700
|
+
type: 'channels';
|
|
2701
|
+
}) | (QuerySearchSuggestions & {
|
|
2702
|
+
type: 'document-or-file';
|
|
2703
|
+
}) | (TaskSearchSuggestions & {
|
|
2704
|
+
type: 'task';
|
|
2705
|
+
}) | (EmailSearchSuggestions & {
|
|
2706
|
+
type: 'email';
|
|
2707
|
+
}) | (CallSearchSuggestions & {
|
|
2708
|
+
type: 'calls';
|
|
2709
|
+
}) | (QuerySearchSuggestions & {
|
|
2710
|
+
type: 'folders';
|
|
2711
|
+
}) | (QuerySearchSuggestions & {
|
|
2712
|
+
type: 'agent';
|
|
2713
|
+
}) | (QuerySearchSuggestions & {
|
|
2714
|
+
type: 'calendar';
|
|
2715
|
+
});
|
|
2716
|
+
/**
|
|
2717
|
+
* Search indexes supported by the shared search editor.
|
|
2718
|
+
*/
|
|
2719
|
+
export type SearchType = 'all' | 'channels' | 'document-or-file' | 'task' | 'email' | 'calls' | 'folders' | 'agent' | 'calendar';
|
|
2720
|
+
/**
|
|
2721
|
+
* A session's auto-archive settings and history.
|
|
2722
|
+
*/
|
|
2723
|
+
export type SessionAutoArchiveResponse = {
|
|
2724
|
+
/**
|
|
2725
|
+
* When a trigger first archived the session. Kept when a person restores it: a session
|
|
2726
|
+
* archives itself at most once.
|
|
2727
|
+
*/
|
|
2728
|
+
autoArchivedAt?: string | null;
|
|
2729
|
+
/**
|
|
2730
|
+
* The owner's defaults, which apply where the session has no choice of its own.
|
|
2731
|
+
*/
|
|
2732
|
+
defaults: AutoArchivePreferencesBody;
|
|
2733
|
+
/**
|
|
2734
|
+
* The session's own choices.
|
|
2735
|
+
*/
|
|
2736
|
+
overrides: AutoArchiveOverridesBody;
|
|
2737
|
+
};
|
|
2738
|
+
/**
|
|
2739
|
+
* The agent behind a session, as much of it as rendering a message needs.
|
|
2740
|
+
*/
|
|
2741
|
+
export type SessionBot = {
|
|
2742
|
+
/**
|
|
2743
|
+
* Avatar, when it has one.
|
|
2744
|
+
*/
|
|
2745
|
+
avatarUrl?: string | null;
|
|
2746
|
+
/**
|
|
2747
|
+
* Stable `@` handle, without a leading `@`.
|
|
2748
|
+
*/
|
|
2749
|
+
handle: string;
|
|
2750
|
+
/**
|
|
2751
|
+
* The bot's id. A message it sent has `"bot|{id}"` as its sender.
|
|
2752
|
+
*/
|
|
2753
|
+
id: BotId;
|
|
2754
|
+
/**
|
|
2755
|
+
* Display name.
|
|
2756
|
+
*/
|
|
2757
|
+
name: string;
|
|
2758
|
+
};
|
|
2759
|
+
/**
|
|
2760
|
+
* A pull request associated with a session.
|
|
2761
|
+
*/
|
|
2762
|
+
export type SessionPullRequestLink = {
|
|
2763
|
+
/**
|
|
2764
|
+
* When the pull request was associated with the session.
|
|
2765
|
+
*/
|
|
2766
|
+
createdAt: string;
|
|
2767
|
+
/**
|
|
2768
|
+
* The pull request's `owner/repo/pull/number` key.
|
|
2769
|
+
*/
|
|
2770
|
+
githubKey: string;
|
|
2771
|
+
/**
|
|
2772
|
+
* The Rox user who linked it, for links a person made.
|
|
2773
|
+
*/
|
|
2774
|
+
linkedBy?: string | null;
|
|
2775
|
+
/**
|
|
2776
|
+
* Who associated the pull request with the session.
|
|
2777
|
+
*/
|
|
2778
|
+
source: PullRequestLinkSource;
|
|
2779
|
+
/**
|
|
2780
|
+
* The pull request's GitHub URL.
|
|
2781
|
+
*/
|
|
2782
|
+
url: string;
|
|
2783
|
+
};
|
|
2784
|
+
/**
|
|
2785
|
+
* The pull requests associated with a session.
|
|
2786
|
+
*/
|
|
2787
|
+
export type SessionPullRequestsResponse = {
|
|
2788
|
+
/**
|
|
2789
|
+
* Pull requests, oldest link first.
|
|
2790
|
+
*/
|
|
2791
|
+
pullRequests: Array<SessionPullRequestLink>;
|
|
2792
|
+
};
|
|
2793
|
+
/**
|
|
2794
|
+
* Transport representation of a session's status, mirroring
|
|
2795
|
+
* [`SessionStatus`].
|
|
2796
|
+
*/
|
|
2797
|
+
export type SessionStatusDto = {
|
|
2798
|
+
kind: 'no_messages';
|
|
2799
|
+
} | {
|
|
2800
|
+
/**
|
|
2801
|
+
* The wire name of the system event, e.g. `acp_ready`.
|
|
2802
|
+
*/
|
|
2803
|
+
event: string;
|
|
2804
|
+
kind: 'event';
|
|
2805
|
+
} | {
|
|
2806
|
+
kind: 'disconnected';
|
|
2807
|
+
};
|
|
2808
|
+
/**
|
|
2809
|
+
* Request body for archiving or unarchiving an agent session.
|
|
2810
|
+
*/
|
|
2811
|
+
export type SetAgentSessionArchivedRequest = {
|
|
2812
|
+
/**
|
|
2813
|
+
* Archive the session, or restore it.
|
|
2814
|
+
*/
|
|
2815
|
+
archived: boolean;
|
|
2816
|
+
};
|
|
2817
|
+
export type SharePermissionV2 = {
|
|
2818
|
+
/**
|
|
2819
|
+
* The channel share permissions for the item
|
|
2820
|
+
*/
|
|
2821
|
+
channelSharePermissions?: Array<ChannelSharePermission> | null;
|
|
2822
|
+
/**
|
|
2823
|
+
* The share permission id
|
|
2824
|
+
*/
|
|
2825
|
+
id: string;
|
|
2826
|
+
linkShare?: null | LinkShare;
|
|
2827
|
+
linkShareAccessLevel?: null | AccessLevel;
|
|
2828
|
+
/**
|
|
2829
|
+
* The owner of the item
|
|
2830
|
+
*/
|
|
2831
|
+
owner: string;
|
|
2832
|
+
teamShareAccessLevel?: null | AccessLevel;
|
|
2833
|
+
};
|
|
2834
|
+
/**
|
|
2835
|
+
* The session the user is choosing to leave behind.
|
|
2836
|
+
*/
|
|
2837
|
+
export type StartFreshAgentConversationRequest = {
|
|
2838
|
+
/**
|
|
2839
|
+
* Current session id shown in the conversation metadata.
|
|
2840
|
+
*/
|
|
2841
|
+
sessionId: string;
|
|
2842
|
+
};
|
|
2843
|
+
/**
|
|
2844
|
+
* Task facets match the shared search editor; assignee and creator are distinct.
|
|
2845
|
+
*/
|
|
2846
|
+
export type TaskSearchSuggestions = {
|
|
2847
|
+
/**
|
|
2848
|
+
* Assigned people's names or supplied addresses.
|
|
2849
|
+
*/
|
|
2850
|
+
assignees: Array<string>;
|
|
2851
|
+
/**
|
|
2852
|
+
* Task creators' names or supplied addresses.
|
|
2853
|
+
*/
|
|
2854
|
+
created_by: Array<string>;
|
|
2855
|
+
/**
|
|
2856
|
+
* Priority display values for client-side option resolution.
|
|
2857
|
+
*/
|
|
2858
|
+
priority: Array<string>;
|
|
2859
|
+
/**
|
|
2860
|
+
* Remaining keyword phrase.
|
|
2861
|
+
*/
|
|
2862
|
+
query?: string | null;
|
|
2863
|
+
/**
|
|
2864
|
+
* Status display values for client-side option resolution.
|
|
2865
|
+
*/
|
|
2866
|
+
status: Array<string>;
|
|
2867
|
+
};
|
|
2868
|
+
/**
|
|
2869
|
+
* Editable fields for task inference, before submission and identity resolution.
|
|
2870
|
+
*/
|
|
2871
|
+
export type TaskSuggestions = {
|
|
2872
|
+
/**
|
|
2873
|
+
* Suggested Markdown content or outgoing message body.
|
|
2874
|
+
*/
|
|
2875
|
+
body?: string | null;
|
|
2876
|
+
/**
|
|
2877
|
+
* Task deadline as a local ISO date.
|
|
2878
|
+
*/
|
|
2879
|
+
due_date?: string | null;
|
|
2880
|
+
/**
|
|
2881
|
+
* Display names/values that the client resolves against available task fields.
|
|
2882
|
+
*/
|
|
2883
|
+
properties?: Array<InputPropertySuggestion>;
|
|
2884
|
+
/**
|
|
2885
|
+
* Suggested note, task, or event title.
|
|
2886
|
+
*/
|
|
2887
|
+
title?: string | null;
|
|
2888
|
+
};
|
|
2889
|
+
/**
|
|
2890
|
+
* Which authenticated participant's access a tool call requests.
|
|
2891
|
+
*/
|
|
2892
|
+
export type ToolActor = 'requester' | 'owner';
|
|
2893
|
+
/**
|
|
2894
|
+
* How a person answers a held tool call.
|
|
2895
|
+
*/
|
|
2896
|
+
export type ToolApprovalAnswerDto = 'approve' | 'approve_and_remember' | 'deny' | 'cancel';
|
|
2897
|
+
/**
|
|
2898
|
+
* Where a held tool call stands once answered.
|
|
2899
|
+
*/
|
|
2900
|
+
export type ToolApprovalStatusDto = 'pending' | 'approved' | 'denied' | 'cancelled' | 'expired';
|
|
2901
|
+
/**
|
|
2902
|
+
* What opened a session.
|
|
2903
|
+
*/
|
|
2904
|
+
export type TriggerOrigin = {
|
|
2905
|
+
/**
|
|
2906
|
+
* Who posted it.
|
|
2907
|
+
*/
|
|
2908
|
+
by: Caller;
|
|
2909
|
+
/**
|
|
2910
|
+
* The message.
|
|
2911
|
+
*/
|
|
2912
|
+
message_id: string;
|
|
2913
|
+
origin: 'mentioned';
|
|
2914
|
+
} | {
|
|
2915
|
+
/**
|
|
2916
|
+
* Who wrote.
|
|
2917
|
+
*/
|
|
2918
|
+
by: RoxUserIdStr;
|
|
2919
|
+
/**
|
|
2920
|
+
* The message.
|
|
2921
|
+
*/
|
|
2922
|
+
message_id: string;
|
|
2923
|
+
origin: 'conversation';
|
|
2924
|
+
} | {
|
|
2925
|
+
/**
|
|
2926
|
+
* Who assigned it.
|
|
2927
|
+
*/
|
|
2928
|
+
by: Caller;
|
|
2929
|
+
origin: 'task_assigned';
|
|
2930
|
+
/**
|
|
2931
|
+
* The task.
|
|
2932
|
+
*/
|
|
2933
|
+
task: string;
|
|
2934
|
+
} | {
|
|
2935
|
+
/**
|
|
2936
|
+
* Who added the task to the project.
|
|
2937
|
+
*/
|
|
2938
|
+
by: Caller;
|
|
2939
|
+
origin: 'project_inherited';
|
|
2940
|
+
/**
|
|
2941
|
+
* The project.
|
|
2942
|
+
*/
|
|
2943
|
+
project: string;
|
|
2944
|
+
/**
|
|
2945
|
+
* The task.
|
|
2946
|
+
*/
|
|
2947
|
+
task: string;
|
|
2948
|
+
} | {
|
|
2949
|
+
/**
|
|
2950
|
+
* Who opened it.
|
|
2951
|
+
*/
|
|
2952
|
+
by: RoxUserIdStr;
|
|
2953
|
+
origin: 'requested';
|
|
2954
|
+
} | {
|
|
2955
|
+
/**
|
|
2956
|
+
* The user whose authority the work runs under.
|
|
2957
|
+
*/
|
|
2958
|
+
on_behalf_of: RoxUserIdStr;
|
|
2959
|
+
origin: 'dispatched';
|
|
2960
|
+
} | {
|
|
2961
|
+
/**
|
|
2962
|
+
* What made it fire.
|
|
2963
|
+
*/
|
|
2964
|
+
firing: RoutineCause;
|
|
2965
|
+
origin: 'routine';
|
|
2966
|
+
/**
|
|
2967
|
+
* The routine.
|
|
2968
|
+
*/
|
|
2969
|
+
routine: string;
|
|
2970
|
+
} | {
|
|
2971
|
+
origin: 'unknown';
|
|
2972
|
+
};
|
|
2973
|
+
/**
|
|
2974
|
+
* What happened to a command.
|
|
2975
|
+
*/
|
|
2976
|
+
export type UiCommandOutcome = {
|
|
2977
|
+
/**
|
|
2978
|
+
* The command's id, as the tab sees it.
|
|
2979
|
+
*/
|
|
2980
|
+
commandId: string;
|
|
2981
|
+
status: 'sent';
|
|
2982
|
+
} | {
|
|
2983
|
+
status: 'no_client';
|
|
2984
|
+
} | {
|
|
2985
|
+
/**
|
|
2986
|
+
* Why.
|
|
2987
|
+
*/
|
|
2988
|
+
reason: UiDeclineReason;
|
|
2989
|
+
status: 'declined';
|
|
2990
|
+
};
|
|
2991
|
+
/**
|
|
2992
|
+
* Why a command was not sent.
|
|
2993
|
+
*/
|
|
2994
|
+
export type UiDeclineReason = 'turned_off' | 'not_allowed_route' | 'rate_limited';
|
|
2995
|
+
/**
|
|
2996
|
+
* Where the opened item goes. Neither replaces what the person is reading.
|
|
2997
|
+
*/
|
|
2998
|
+
export type UiPlacement = 'beside-agent' | 'new';
|
|
2999
|
+
export type UpdateChannelSharePermission = {
|
|
3000
|
+
accessLevel?: null | AccessLevel;
|
|
3001
|
+
/**
|
|
3002
|
+
* The channel id
|
|
3003
|
+
*/
|
|
3004
|
+
channelId: string;
|
|
3005
|
+
/**
|
|
3006
|
+
* The type of operation to be performed on the chanel share permission
|
|
3007
|
+
* You can add, remove or replace and existing permission
|
|
3008
|
+
*/
|
|
3009
|
+
operation: UpdateOperation;
|
|
3010
|
+
};
|
|
3011
|
+
export type UpdateOperation = 'add' | 'remove' | 'replace';
|
|
3012
|
+
export type UpdateSharePermissionRequestV2 = {
|
|
3013
|
+
/**
|
|
3014
|
+
* Any channel share permissions to be created/updated/removed
|
|
3015
|
+
*/
|
|
3016
|
+
channelSharePermissions?: Array<UpdateChannelSharePermission> | null;
|
|
3017
|
+
linkShare?: null | LinkShare;
|
|
3018
|
+
linkShareAccessLevel?: null | AccessLevel;
|
|
3019
|
+
teamShareAccessLevel?: null | AccessLevel;
|
|
3020
|
+
};
|
|
3021
|
+
/**
|
|
3022
|
+
* One voice of the provider's catalog.
|
|
3023
|
+
*/
|
|
3024
|
+
export type Voice = {
|
|
3025
|
+
/**
|
|
3026
|
+
* The provider's accent label.
|
|
3027
|
+
*/
|
|
3028
|
+
accent: string;
|
|
3029
|
+
/**
|
|
3030
|
+
* Languages the voice speaks.
|
|
3031
|
+
*/
|
|
3032
|
+
languages: Array<string>;
|
|
3033
|
+
/**
|
|
3034
|
+
* The model to save as the agent's voice.
|
|
3035
|
+
*/
|
|
3036
|
+
model: string;
|
|
3037
|
+
/**
|
|
3038
|
+
* The provider's name for the voice.
|
|
3039
|
+
*/
|
|
3040
|
+
name: string;
|
|
3041
|
+
/**
|
|
3042
|
+
* The provider's gender and character tags.
|
|
3043
|
+
*/
|
|
3044
|
+
tags: Array<string>;
|
|
3045
|
+
};
|
|
3046
|
+
/**
|
|
3047
|
+
* A client-minted id deduplicates warm calls without creating a conversation.
|
|
3048
|
+
*/
|
|
3049
|
+
export type WarmAgentSessionRequest = {
|
|
3050
|
+
/**
|
|
3051
|
+
* Id reserved by this browser for its next in-memory conversation.
|
|
3052
|
+
*/
|
|
3053
|
+
id: string;
|
|
3054
|
+
};
|
|
3055
|
+
/**
|
|
3056
|
+
* A bounded best-effort warm attempt; absence means normal creation should proceed.
|
|
3057
|
+
*/
|
|
3058
|
+
export type WarmAgentSessionResponse = {
|
|
3059
|
+
session?: null | AgentSessionResponse;
|
|
3060
|
+
};
|
|
3061
|
+
/**
|
|
3062
|
+
* RFC weekday values used by the existing recurrence UI.
|
|
3063
|
+
*/
|
|
3064
|
+
export type WeekdayCode = 'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU';
|
|
3065
|
+
/**
|
|
3066
|
+
* Just a session id, for the preview variants that carry nothing else.
|
|
3067
|
+
*
|
|
3068
|
+
* Clients deserialize this, so both derives are used.
|
|
3069
|
+
*/
|
|
3070
|
+
export type WithAgentSessionId = {
|
|
3071
|
+
/**
|
|
3072
|
+
* The session id.
|
|
3073
|
+
*/
|
|
3074
|
+
id: string;
|
|
3075
|
+
};
|
|
3076
|
+
/**
|
|
3077
|
+
* One account's active registration of one session as its work.
|
|
3078
|
+
*/
|
|
3079
|
+
export type WorkRegistrationResponse = {
|
|
3080
|
+
/**
|
|
3081
|
+
* The account whose work this is.
|
|
3082
|
+
*/
|
|
3083
|
+
accountId: string;
|
|
3084
|
+
/**
|
|
3085
|
+
* The session registered.
|
|
3086
|
+
*/
|
|
3087
|
+
agentSessionId: string;
|
|
3088
|
+
/**
|
|
3089
|
+
* The registration.
|
|
3090
|
+
*/
|
|
3091
|
+
id: string;
|
|
3092
|
+
/**
|
|
3093
|
+
* When the account registered it.
|
|
3094
|
+
*/
|
|
3095
|
+
registeredAt: string;
|
|
3096
|
+
};
|
|
3097
|
+
export type GetAgentAutoArchivePreferencesData = {
|
|
3098
|
+
body?: never;
|
|
3099
|
+
path?: never;
|
|
3100
|
+
query?: never;
|
|
3101
|
+
url: '/agent-auto-archive-preferences';
|
|
3102
|
+
};
|
|
3103
|
+
export type GetAgentAutoArchivePreferencesErrors = {
|
|
3104
|
+
401: string;
|
|
3105
|
+
500: string;
|
|
3106
|
+
};
|
|
3107
|
+
export type GetAgentAutoArchivePreferencesError = GetAgentAutoArchivePreferencesErrors[keyof GetAgentAutoArchivePreferencesErrors];
|
|
3108
|
+
export type GetAgentAutoArchivePreferencesResponses = {
|
|
3109
|
+
200: AutoArchivePreferencesBody;
|
|
3110
|
+
};
|
|
3111
|
+
export type GetAgentAutoArchivePreferencesResponse = GetAgentAutoArchivePreferencesResponses[keyof GetAgentAutoArchivePreferencesResponses];
|
|
3112
|
+
export type PutAgentAutoArchivePreferencesData = {
|
|
3113
|
+
body: AutoArchivePreferencesBody;
|
|
3114
|
+
path?: never;
|
|
3115
|
+
query?: never;
|
|
3116
|
+
url: '/agent-auto-archive-preferences';
|
|
3117
|
+
};
|
|
3118
|
+
export type PutAgentAutoArchivePreferencesErrors = {
|
|
3119
|
+
401: string;
|
|
3120
|
+
500: string;
|
|
3121
|
+
};
|
|
3122
|
+
export type PutAgentAutoArchivePreferencesError = PutAgentAutoArchivePreferencesErrors[keyof PutAgentAutoArchivePreferencesErrors];
|
|
3123
|
+
export type PutAgentAutoArchivePreferencesResponses = {
|
|
3124
|
+
200: AutoArchivePreferencesBody;
|
|
3125
|
+
};
|
|
3126
|
+
export type PutAgentAutoArchivePreferencesResponse = PutAgentAutoArchivePreferencesResponses[keyof PutAgentAutoArchivePreferencesResponses];
|
|
3127
|
+
export type DiscoverAgentCapabilitiesHandlerData = {
|
|
3128
|
+
body: DiscoverAgentCapabilitiesRequest;
|
|
3129
|
+
path?: never;
|
|
3130
|
+
query?: never;
|
|
3131
|
+
url: '/agent-capabilities/discover';
|
|
3132
|
+
};
|
|
3133
|
+
export type DiscoverAgentCapabilitiesHandlerErrors = {
|
|
3134
|
+
/**
|
|
3135
|
+
* Invalid target
|
|
3136
|
+
*/
|
|
3137
|
+
400: unknown;
|
|
3138
|
+
/**
|
|
3139
|
+
* Unauthenticated
|
|
3140
|
+
*/
|
|
3141
|
+
401: unknown;
|
|
3142
|
+
/**
|
|
3143
|
+
* Harness is not visible to caller
|
|
3144
|
+
*/
|
|
3145
|
+
403: unknown;
|
|
3146
|
+
/**
|
|
3147
|
+
* Roxd machine or Cursor account is not connected (plain text), or the provider refused the connected credential (JSON)
|
|
3148
|
+
*/
|
|
3149
|
+
409: CredentialRejectedResponse;
|
|
3150
|
+
/**
|
|
3151
|
+
* Provider probe failed
|
|
3152
|
+
*/
|
|
3153
|
+
502: unknown;
|
|
3154
|
+
/**
|
|
3155
|
+
* Roxd probe timed out
|
|
3156
|
+
*/
|
|
3157
|
+
504: unknown;
|
|
3158
|
+
};
|
|
3159
|
+
export type DiscoverAgentCapabilitiesHandlerError = DiscoverAgentCapabilitiesHandlerErrors[keyof DiscoverAgentCapabilitiesHandlerErrors];
|
|
3160
|
+
export type DiscoverAgentCapabilitiesHandlerResponses = {
|
|
3161
|
+
/**
|
|
3162
|
+
* Fresh provider session capabilities
|
|
3163
|
+
*/
|
|
3164
|
+
200: DiscoverAgentCapabilitiesResponse;
|
|
3165
|
+
};
|
|
3166
|
+
export type DiscoverAgentCapabilitiesHandlerResponse = DiscoverAgentCapabilitiesHandlerResponses[keyof DiscoverAgentCapabilitiesHandlerResponses];
|
|
3167
|
+
export type GetAgentCodingPreferencesData = {
|
|
3168
|
+
body?: never;
|
|
3169
|
+
path?: never;
|
|
3170
|
+
query?: never;
|
|
3171
|
+
url: '/agent-coding-preferences';
|
|
3172
|
+
};
|
|
3173
|
+
export type GetAgentCodingPreferencesErrors = {
|
|
3174
|
+
401: string;
|
|
3175
|
+
500: string;
|
|
3176
|
+
};
|
|
3177
|
+
export type GetAgentCodingPreferencesError = GetAgentCodingPreferencesErrors[keyof GetAgentCodingPreferencesErrors];
|
|
3178
|
+
export type GetAgentCodingPreferencesResponses = {
|
|
3179
|
+
200: CodingPreferencesBody;
|
|
3180
|
+
};
|
|
3181
|
+
export type GetAgentCodingPreferencesResponse = GetAgentCodingPreferencesResponses[keyof GetAgentCodingPreferencesResponses];
|
|
3182
|
+
export type PutAgentCodingPreferencesData = {
|
|
3183
|
+
body: CodingPreferencesBody;
|
|
3184
|
+
path?: never;
|
|
3185
|
+
query?: never;
|
|
3186
|
+
url: '/agent-coding-preferences';
|
|
3187
|
+
};
|
|
3188
|
+
export type PutAgentCodingPreferencesErrors = {
|
|
3189
|
+
401: string;
|
|
3190
|
+
500: string;
|
|
3191
|
+
};
|
|
3192
|
+
export type PutAgentCodingPreferencesError = PutAgentCodingPreferencesErrors[keyof PutAgentCodingPreferencesErrors];
|
|
3193
|
+
export type PutAgentCodingPreferencesResponses = {
|
|
3194
|
+
200: CodingPreferencesBody;
|
|
3195
|
+
};
|
|
3196
|
+
export type PutAgentCodingPreferencesResponse = PutAgentCodingPreferencesResponses[keyof PutAgentCodingPreferencesResponses];
|
|
3197
|
+
export type ListAgentConversationsData = {
|
|
3198
|
+
body?: never;
|
|
3199
|
+
path: {
|
|
3200
|
+
/**
|
|
3201
|
+
* Conversation channel
|
|
3202
|
+
*/
|
|
3203
|
+
channel_id: string;
|
|
3204
|
+
};
|
|
3205
|
+
query?: never;
|
|
3206
|
+
url: '/agent-conversations/{channel_id}';
|
|
3207
|
+
};
|
|
3208
|
+
export type ListAgentConversationsErrors = {
|
|
3209
|
+
/**
|
|
3210
|
+
* Conversations temporarily unavailable
|
|
3211
|
+
*/
|
|
3212
|
+
503: unknown;
|
|
3213
|
+
};
|
|
3214
|
+
export type ListAgentConversationsResponses = {
|
|
3215
|
+
/**
|
|
3216
|
+
* The caller's agent conversations in the channel
|
|
3217
|
+
*/
|
|
3218
|
+
200: AgentConversationsDto;
|
|
3219
|
+
};
|
|
3220
|
+
export type ListAgentConversationsResponse = ListAgentConversationsResponses[keyof ListAgentConversationsResponses];
|
|
3221
|
+
export type StartFreshAgentConversationData = {
|
|
3222
|
+
body: StartFreshAgentConversationRequest;
|
|
3223
|
+
path: {
|
|
3224
|
+
channel_id: string;
|
|
3225
|
+
/**
|
|
3226
|
+
* Persona the conversation is with
|
|
3227
|
+
*/
|
|
3228
|
+
bot_id: string;
|
|
3229
|
+
};
|
|
3230
|
+
query?: never;
|
|
3231
|
+
url: '/agent-conversations/{channel_id}/{bot_id}/start-fresh';
|
|
3232
|
+
};
|
|
3233
|
+
export type StartFreshAgentConversationErrors = {
|
|
3234
|
+
/**
|
|
3235
|
+
* Conversation not found
|
|
3236
|
+
*/
|
|
3237
|
+
404: unknown;
|
|
3238
|
+
/**
|
|
3239
|
+
* Context is busy, stale or unavailable
|
|
3240
|
+
*/
|
|
3241
|
+
409: unknown;
|
|
3242
|
+
/**
|
|
3243
|
+
* Temporarily unavailable
|
|
3244
|
+
*/
|
|
3245
|
+
503: unknown;
|
|
3246
|
+
};
|
|
3247
|
+
export type StartFreshAgentConversationResponses = {
|
|
3248
|
+
/**
|
|
3249
|
+
* New context reserved
|
|
3250
|
+
*/
|
|
3251
|
+
204: void;
|
|
3252
|
+
};
|
|
3253
|
+
export type StartFreshAgentConversationResponse = StartFreshAgentConversationResponses[keyof StartFreshAgentConversationResponses];
|
|
3254
|
+
export type RetryAgentConversationTurnData = {
|
|
3255
|
+
body: RetryAgentConversationTurnRequest;
|
|
3256
|
+
path: {
|
|
3257
|
+
channel_id: string;
|
|
3258
|
+
/**
|
|
3259
|
+
* Persona the conversation is with
|
|
3260
|
+
*/
|
|
3261
|
+
bot_id: string;
|
|
3262
|
+
source: string;
|
|
3263
|
+
};
|
|
3264
|
+
query?: never;
|
|
3265
|
+
url: '/agent-conversations/{channel_id}/{bot_id}/turns/{source}/retry';
|
|
3266
|
+
};
|
|
3267
|
+
export type RetryAgentConversationTurnErrors = {
|
|
3268
|
+
/**
|
|
3269
|
+
* Conversation or turn not found
|
|
3270
|
+
*/
|
|
3271
|
+
404: unknown;
|
|
3272
|
+
/**
|
|
3273
|
+
* Attempt cannot be retried
|
|
3274
|
+
*/
|
|
3275
|
+
409: unknown;
|
|
3276
|
+
/**
|
|
3277
|
+
* Temporarily unavailable
|
|
3278
|
+
*/
|
|
3279
|
+
503: unknown;
|
|
3280
|
+
};
|
|
3281
|
+
export type RetryAgentConversationTurnResponses = {
|
|
3282
|
+
/**
|
|
3283
|
+
* Retry queued
|
|
3284
|
+
*/
|
|
3285
|
+
204: void;
|
|
3286
|
+
};
|
|
3287
|
+
export type RetryAgentConversationTurnResponse = RetryAgentConversationTurnResponses[keyof RetryAgentConversationTurnResponses];
|
|
3288
|
+
export type ChooseAgentModeData = {
|
|
3289
|
+
body: AgentModeChoiceRequest;
|
|
3290
|
+
path?: never;
|
|
3291
|
+
query?: never;
|
|
3292
|
+
url: '/agent-mode-choice';
|
|
3293
|
+
};
|
|
3294
|
+
export type ChooseAgentModeErrors = {
|
|
3295
|
+
/**
|
|
3296
|
+
* The prompt is blank
|
|
3297
|
+
*/
|
|
3298
|
+
400: unknown;
|
|
3299
|
+
/**
|
|
3300
|
+
* Unauthenticated
|
|
3301
|
+
*/
|
|
3302
|
+
401: unknown;
|
|
3303
|
+
/**
|
|
3304
|
+
* The caller cannot start new AI work
|
|
3305
|
+
*/
|
|
3306
|
+
402: unknown;
|
|
3307
|
+
/**
|
|
3308
|
+
* Auto mode is not enabled for the caller
|
|
3309
|
+
*/
|
|
3310
|
+
403: unknown;
|
|
3311
|
+
/**
|
|
3312
|
+
* The classifier is unconfigured, failed, or timed out
|
|
3313
|
+
*/
|
|
3314
|
+
503: unknown;
|
|
3315
|
+
};
|
|
3316
|
+
export type ChooseAgentModeResponses = {
|
|
3317
|
+
/**
|
|
3318
|
+
* The kind of agent the prompt goes to
|
|
3319
|
+
*/
|
|
3320
|
+
200: AgentModeChoiceResponse;
|
|
3321
|
+
};
|
|
3322
|
+
export type ChooseAgentModeResponse = ChooseAgentModeResponses[keyof ChooseAgentModeResponses];
|
|
3323
|
+
export type LoadAgentModelsHandlerData = {
|
|
3324
|
+
body: LoadAgentModelsRequest;
|
|
3325
|
+
path?: never;
|
|
3326
|
+
query?: never;
|
|
3327
|
+
url: '/agent-models/load';
|
|
3328
|
+
};
|
|
3329
|
+
export type LoadAgentModelsHandlerErrors = {
|
|
3330
|
+
/**
|
|
3331
|
+
* Invalid target
|
|
3332
|
+
*/
|
|
3333
|
+
400: unknown;
|
|
3334
|
+
/**
|
|
3335
|
+
* Unauthenticated
|
|
3336
|
+
*/
|
|
3337
|
+
401: unknown;
|
|
3338
|
+
/**
|
|
3339
|
+
* Harness is not visible to caller
|
|
3340
|
+
*/
|
|
3341
|
+
403: unknown;
|
|
3342
|
+
/**
|
|
3343
|
+
* Roxd machine or Cursor account is not connected (plain text), or the provider refused the connected credential (JSON)
|
|
3344
|
+
*/
|
|
3345
|
+
409: CredentialRejectedResponse;
|
|
3346
|
+
/**
|
|
3347
|
+
* Provider probe failed
|
|
3348
|
+
*/
|
|
3349
|
+
502: unknown;
|
|
3350
|
+
/**
|
|
3351
|
+
* Roxd probe timed out
|
|
3352
|
+
*/
|
|
3353
|
+
504: unknown;
|
|
3354
|
+
};
|
|
3355
|
+
export type LoadAgentModelsHandlerError = LoadAgentModelsHandlerErrors[keyof LoadAgentModelsHandlerErrors];
|
|
3356
|
+
export type LoadAgentModelsHandlerResponses = {
|
|
3357
|
+
/**
|
|
3358
|
+
* Fresh provider model catalog
|
|
3359
|
+
*/
|
|
3360
|
+
200: LoadAgentModelsResponse;
|
|
3361
|
+
};
|
|
3362
|
+
export type LoadAgentModelsHandlerResponse = LoadAgentModelsHandlerResponses[keyof LoadAgentModelsHandlerResponses];
|
|
3363
|
+
export type ListAgentRepositoriesData = {
|
|
3364
|
+
body?: never;
|
|
3365
|
+
path?: never;
|
|
3366
|
+
query?: never;
|
|
3367
|
+
url: '/agent-repositories';
|
|
3368
|
+
};
|
|
3369
|
+
export type ListAgentRepositoriesErrors = {
|
|
3370
|
+
/**
|
|
3371
|
+
* Unauthenticated
|
|
3372
|
+
*/
|
|
3373
|
+
401: unknown;
|
|
3374
|
+
/**
|
|
3375
|
+
* GitHub could not be asked which repositories the caller reaches
|
|
3376
|
+
*/
|
|
3377
|
+
502: unknown;
|
|
3378
|
+
};
|
|
3379
|
+
export type ListAgentRepositoriesResponses = {
|
|
3380
|
+
/**
|
|
3381
|
+
* The caller's reachable repositories
|
|
3382
|
+
*/
|
|
3383
|
+
200: AgentRepositoriesResponse;
|
|
3384
|
+
};
|
|
3385
|
+
export type ListAgentRepositoriesResponse = ListAgentRepositoriesResponses[keyof ListAgentRepositoriesResponses];
|
|
3386
|
+
export type ListAgentRepositoryBranchesData = {
|
|
3387
|
+
body?: never;
|
|
3388
|
+
path?: never;
|
|
3389
|
+
query: {
|
|
3390
|
+
/**
|
|
3391
|
+
* Canonical https://github.com/owner/name URL
|
|
3392
|
+
*/
|
|
3393
|
+
repoUrl: string;
|
|
3394
|
+
};
|
|
3395
|
+
url: '/agent-repositories/branches';
|
|
3396
|
+
};
|
|
3397
|
+
export type ListAgentRepositoryBranchesErrors = {
|
|
3398
|
+
/**
|
|
3399
|
+
* The query did not name a GitHub repository
|
|
3400
|
+
*/
|
|
3401
|
+
400: unknown;
|
|
3402
|
+
/**
|
|
3403
|
+
* Unauthenticated
|
|
3404
|
+
*/
|
|
3405
|
+
401: unknown;
|
|
3406
|
+
/**
|
|
3407
|
+
* The caller cannot reach this repository
|
|
3408
|
+
*/
|
|
3409
|
+
403: unknown;
|
|
3410
|
+
/**
|
|
3411
|
+
* GitHub could not be asked which branches the repository has
|
|
3412
|
+
*/
|
|
3413
|
+
502: unknown;
|
|
3414
|
+
};
|
|
3415
|
+
export type ListAgentRepositoryBranchesResponses = {
|
|
3416
|
+
/**
|
|
3417
|
+
* The repository's branches
|
|
3418
|
+
*/
|
|
3419
|
+
200: AgentRepositoryBranchesResponse;
|
|
3420
|
+
};
|
|
3421
|
+
export type ListAgentRepositoryBranchesResponse = ListAgentRepositoryBranchesResponses[keyof ListAgentRepositoryBranchesResponses];
|
|
3422
|
+
export type GetAgentSandboxSizeData = {
|
|
3423
|
+
body?: never;
|
|
3424
|
+
path?: never;
|
|
3425
|
+
query?: never;
|
|
3426
|
+
url: '/agent-sandbox-size';
|
|
3427
|
+
};
|
|
3428
|
+
export type GetAgentSandboxSizeErrors = {
|
|
3429
|
+
401: string;
|
|
3430
|
+
500: string;
|
|
3431
|
+
};
|
|
3432
|
+
export type GetAgentSandboxSizeError = GetAgentSandboxSizeErrors[keyof GetAgentSandboxSizeErrors];
|
|
3433
|
+
export type GetAgentSandboxSizeResponses = {
|
|
3434
|
+
200: SandboxSizeBody;
|
|
3435
|
+
};
|
|
3436
|
+
export type GetAgentSandboxSizeResponse = GetAgentSandboxSizeResponses[keyof GetAgentSandboxSizeResponses];
|
|
3437
|
+
export type PutAgentSandboxSizeData = {
|
|
3438
|
+
body: SandboxSizeBody;
|
|
3439
|
+
path?: never;
|
|
3440
|
+
query?: never;
|
|
3441
|
+
url: '/agent-sandbox-size';
|
|
3442
|
+
};
|
|
3443
|
+
export type PutAgentSandboxSizeErrors = {
|
|
3444
|
+
401: string;
|
|
3445
|
+
500: string;
|
|
3446
|
+
};
|
|
3447
|
+
export type PutAgentSandboxSizeError = PutAgentSandboxSizeErrors[keyof PutAgentSandboxSizeErrors];
|
|
3448
|
+
export type PutAgentSandboxSizeResponses = {
|
|
3449
|
+
200: SandboxSizeBody;
|
|
3450
|
+
};
|
|
3451
|
+
export type PutAgentSandboxSizeResponse = PutAgentSandboxSizeResponses[keyof PutAgentSandboxSizeResponses];
|
|
3452
|
+
export type CreateAgentSessionData = {
|
|
3453
|
+
body: CreateAgentSessionRequest;
|
|
3454
|
+
path?: never;
|
|
3455
|
+
query?: never;
|
|
3456
|
+
url: '/agent-sessions';
|
|
3457
|
+
};
|
|
3458
|
+
export type CreateAgentSessionErrors = {
|
|
3459
|
+
401: string;
|
|
3460
|
+
/**
|
|
3461
|
+
* AI allowance exhausted
|
|
3462
|
+
*/
|
|
3463
|
+
402: AiAdmissionErrorBody;
|
|
3464
|
+
403: string;
|
|
3465
|
+
404: string;
|
|
3466
|
+
422: string;
|
|
3467
|
+
500: string;
|
|
3468
|
+
/**
|
|
3469
|
+
* AI usage validation unavailable; retry later
|
|
3470
|
+
*/
|
|
3471
|
+
503: AiAdmissionErrorBody;
|
|
3472
|
+
};
|
|
3473
|
+
export type CreateAgentSessionError = CreateAgentSessionErrors[keyof CreateAgentSessionErrors];
|
|
3474
|
+
export type CreateAgentSessionResponses = {
|
|
3475
|
+
201: CreateAgentSessionResponse;
|
|
3476
|
+
};
|
|
3477
|
+
export type CreateAgentSessionResponse2 = CreateAgentSessionResponses[keyof CreateAgentSessionResponses];
|
|
3478
|
+
export type AgentSessionsForPullRequestData = {
|
|
3479
|
+
body: PullRequestUrl;
|
|
3480
|
+
path?: never;
|
|
3481
|
+
query?: never;
|
|
3482
|
+
url: '/agent-sessions/by-pull-request';
|
|
3483
|
+
};
|
|
3484
|
+
export type AgentSessionsForPullRequestErrors = {
|
|
3485
|
+
400: string;
|
|
3486
|
+
401: string;
|
|
3487
|
+
500: string;
|
|
3488
|
+
};
|
|
3489
|
+
export type AgentSessionsForPullRequestError = AgentSessionsForPullRequestErrors[keyof AgentSessionsForPullRequestErrors];
|
|
3490
|
+
export type AgentSessionsForPullRequestResponses = {
|
|
3491
|
+
200: PullRequestSessionsResponse;
|
|
3492
|
+
};
|
|
3493
|
+
export type AgentSessionsForPullRequestResponse = AgentSessionsForPullRequestResponses[keyof AgentSessionsForPullRequestResponses];
|
|
3494
|
+
export type AgentSessionsForPullRequestsData = {
|
|
3495
|
+
body: PullRequestUrls;
|
|
3496
|
+
path?: never;
|
|
3497
|
+
query?: never;
|
|
3498
|
+
url: '/agent-sessions/by-pull-requests';
|
|
3499
|
+
};
|
|
3500
|
+
export type AgentSessionsForPullRequestsErrors = {
|
|
3501
|
+
400: string;
|
|
3502
|
+
401: string;
|
|
3503
|
+
500: string;
|
|
3504
|
+
};
|
|
3505
|
+
export type AgentSessionsForPullRequestsError = AgentSessionsForPullRequestsErrors[keyof AgentSessionsForPullRequestsErrors];
|
|
3506
|
+
export type AgentSessionsForPullRequestsResponses = {
|
|
3507
|
+
200: PullRequestsSessionsResponse;
|
|
3508
|
+
};
|
|
3509
|
+
export type AgentSessionsForPullRequestsResponse = AgentSessionsForPullRequestsResponses[keyof AgentSessionsForPullRequestsResponses];
|
|
3510
|
+
export type PreviewAgentSessionsData = {
|
|
3511
|
+
body: PreviewAgentSessionsRequest;
|
|
3512
|
+
path?: never;
|
|
3513
|
+
query?: never;
|
|
3514
|
+
url: '/agent-sessions/preview';
|
|
3515
|
+
};
|
|
3516
|
+
export type PreviewAgentSessionsErrors = {
|
|
3517
|
+
/**
|
|
3518
|
+
* more than the maximum number of session ids
|
|
3519
|
+
*/
|
|
3520
|
+
400: string;
|
|
3521
|
+
401: string;
|
|
3522
|
+
500: string;
|
|
3523
|
+
};
|
|
3524
|
+
export type PreviewAgentSessionsError = PreviewAgentSessionsErrors[keyof PreviewAgentSessionsErrors];
|
|
3525
|
+
export type PreviewAgentSessionsResponses = {
|
|
3526
|
+
200: PreviewAgentSessionsResponse;
|
|
3527
|
+
};
|
|
3528
|
+
export type PreviewAgentSessionsResponse2 = PreviewAgentSessionsResponses[keyof PreviewAgentSessionsResponses];
|
|
3529
|
+
export type ListAgentSessionUpdatesData = {
|
|
3530
|
+
body?: never;
|
|
3531
|
+
path?: never;
|
|
3532
|
+
query?: never;
|
|
3533
|
+
url: '/agent-sessions/updates';
|
|
3534
|
+
};
|
|
3535
|
+
export type ListAgentSessionUpdatesErrors = {
|
|
3536
|
+
401: string;
|
|
3537
|
+
500: string;
|
|
3538
|
+
};
|
|
3539
|
+
export type ListAgentSessionUpdatesError = ListAgentSessionUpdatesErrors[keyof ListAgentSessionUpdatesErrors];
|
|
3540
|
+
export type ListAgentSessionUpdatesResponses = {
|
|
3541
|
+
200: AgentUpdates;
|
|
3542
|
+
};
|
|
3543
|
+
export type ListAgentSessionUpdatesResponse = ListAgentSessionUpdatesResponses[keyof ListAgentSessionUpdatesResponses];
|
|
3544
|
+
export type WarmAgentSessionHandlerData = {
|
|
3545
|
+
body: WarmAgentSessionRequest;
|
|
3546
|
+
path?: never;
|
|
3547
|
+
query?: never;
|
|
3548
|
+
url: '/agent-sessions/warm';
|
|
3549
|
+
};
|
|
3550
|
+
export type WarmAgentSessionHandlerResponses = {
|
|
3551
|
+
200: WarmAgentSessionResponse;
|
|
3552
|
+
};
|
|
3553
|
+
export type WarmAgentSessionHandlerResponse = WarmAgentSessionHandlerResponses[keyof WarmAgentSessionHandlerResponses];
|
|
3554
|
+
export type DeleteAgentSessionData = {
|
|
3555
|
+
body?: never;
|
|
3556
|
+
path: {
|
|
3557
|
+
/**
|
|
3558
|
+
* ID of the agent session
|
|
3559
|
+
*/
|
|
3560
|
+
session_id: string;
|
|
3561
|
+
};
|
|
3562
|
+
query?: never;
|
|
3563
|
+
url: '/agent-sessions/{session_id}';
|
|
3564
|
+
};
|
|
3565
|
+
export type DeleteAgentSessionErrors = {
|
|
3566
|
+
401: string;
|
|
3567
|
+
403: string;
|
|
3568
|
+
500: string;
|
|
3569
|
+
};
|
|
3570
|
+
export type DeleteAgentSessionError = DeleteAgentSessionErrors[keyof DeleteAgentSessionErrors];
|
|
3571
|
+
export type DeleteAgentSessionResponses = {
|
|
3572
|
+
200: unknown;
|
|
3573
|
+
};
|
|
3574
|
+
export type GetAgentSessionData = {
|
|
3575
|
+
body?: never;
|
|
3576
|
+
path: {
|
|
3577
|
+
/**
|
|
3578
|
+
* ID of the agent session
|
|
3579
|
+
*/
|
|
3580
|
+
session_id: string;
|
|
3581
|
+
};
|
|
3582
|
+
query?: never;
|
|
3583
|
+
url: '/agent-sessions/{session_id}';
|
|
3584
|
+
};
|
|
3585
|
+
export type GetAgentSessionErrors = {
|
|
3586
|
+
/**
|
|
3587
|
+
* the session exists but is not this caller's
|
|
3588
|
+
*/
|
|
3589
|
+
401: string;
|
|
3590
|
+
403: string;
|
|
3591
|
+
/**
|
|
3592
|
+
* no session with this id: not created yet, or deleted since
|
|
3593
|
+
*/
|
|
3594
|
+
404: string;
|
|
3595
|
+
500: string;
|
|
3596
|
+
};
|
|
3597
|
+
export type GetAgentSessionError = GetAgentSessionErrors[keyof GetAgentSessionErrors];
|
|
3598
|
+
export type GetAgentSessionResponses = {
|
|
3599
|
+
200: AgentSessionResponse;
|
|
3600
|
+
};
|
|
3601
|
+
export type GetAgentSessionResponse = GetAgentSessionResponses[keyof GetAgentSessionResponses];
|
|
3602
|
+
export type GetAgentSessionActivityData = {
|
|
3603
|
+
body?: never;
|
|
3604
|
+
path: {
|
|
3605
|
+
session_id: string;
|
|
3606
|
+
};
|
|
3607
|
+
query?: {
|
|
3608
|
+
/**
|
|
3609
|
+
* Restrict activity to one code-mode invocation within this session.
|
|
3610
|
+
*/
|
|
3611
|
+
agentCorrelationId?: string | null;
|
|
3612
|
+
/**
|
|
3613
|
+
* Cursor timestamp from the previous page.
|
|
3614
|
+
*/
|
|
3615
|
+
beforeAt?: string | null;
|
|
3616
|
+
/**
|
|
3617
|
+
* Cursor activity ID from the previous page.
|
|
3618
|
+
*/
|
|
3619
|
+
beforeId?: string | null;
|
|
3620
|
+
/**
|
|
3621
|
+
* Page size, from 1 to 100; defaults to 50.
|
|
3622
|
+
*/
|
|
3623
|
+
limit?: number | null;
|
|
3624
|
+
};
|
|
3625
|
+
url: '/agent-sessions/{session_id}/activity';
|
|
3626
|
+
};
|
|
3627
|
+
export type GetAgentSessionActivityErrors = {
|
|
3628
|
+
400: unknown;
|
|
3629
|
+
401: unknown;
|
|
3630
|
+
403: unknown;
|
|
3631
|
+
};
|
|
3632
|
+
export type GetAgentSessionActivityResponses = {
|
|
3633
|
+
200: AgentActivityPage;
|
|
3634
|
+
};
|
|
3635
|
+
export type GetAgentSessionActivityResponse = GetAgentSessionActivityResponses[keyof GetAgentSessionActivityResponses];
|
|
3636
|
+
export type ReportAgentSessionAppConnectedData = {
|
|
3637
|
+
body: AppConnectedRequest;
|
|
3638
|
+
path: {
|
|
3639
|
+
/**
|
|
3640
|
+
* ID of the agent session
|
|
3641
|
+
*/
|
|
3642
|
+
session_id: string;
|
|
3643
|
+
};
|
|
3644
|
+
query?: never;
|
|
3645
|
+
url: '/agent-sessions/{session_id}/app-connections';
|
|
3646
|
+
};
|
|
3647
|
+
export type ReportAgentSessionAppConnectedErrors = {
|
|
3648
|
+
401: string;
|
|
3649
|
+
/**
|
|
3650
|
+
* Not the session's owner, or no edit access
|
|
3651
|
+
*/
|
|
3652
|
+
403: string;
|
|
3653
|
+
/**
|
|
3654
|
+
* The session is archived
|
|
3655
|
+
*/
|
|
3656
|
+
409: string;
|
|
3657
|
+
/**
|
|
3658
|
+
* The owner has not connected that app
|
|
3659
|
+
*/
|
|
3660
|
+
422: string;
|
|
3661
|
+
500: string;
|
|
3662
|
+
};
|
|
3663
|
+
export type ReportAgentSessionAppConnectedError = ReportAgentSessionAppConnectedErrors[keyof ReportAgentSessionAppConnectedErrors];
|
|
3664
|
+
export type ReportAgentSessionAppConnectedResponses = {
|
|
3665
|
+
/**
|
|
3666
|
+
* The session continues once it is idle
|
|
3667
|
+
*/
|
|
3668
|
+
202: unknown;
|
|
3669
|
+
};
|
|
3670
|
+
export type SetAgentSessionArchivedData = {
|
|
3671
|
+
body: SetAgentSessionArchivedRequest;
|
|
3672
|
+
path: {
|
|
3673
|
+
/**
|
|
3674
|
+
* ID of the agent session
|
|
3675
|
+
*/
|
|
3676
|
+
session_id: string;
|
|
3677
|
+
};
|
|
3678
|
+
query?: never;
|
|
3679
|
+
url: '/agent-sessions/{session_id}/archived';
|
|
3680
|
+
};
|
|
3681
|
+
export type SetAgentSessionArchivedErrors = {
|
|
3682
|
+
401: string;
|
|
3683
|
+
403: string;
|
|
3684
|
+
/**
|
|
3685
|
+
* The session answers an agent conversation
|
|
3686
|
+
*/
|
|
3687
|
+
409: string;
|
|
3688
|
+
500: string;
|
|
3689
|
+
};
|
|
3690
|
+
export type SetAgentSessionArchivedError = SetAgentSessionArchivedErrors[keyof SetAgentSessionArchivedErrors];
|
|
3691
|
+
export type SetAgentSessionArchivedResponses = {
|
|
3692
|
+
204: void;
|
|
3693
|
+
};
|
|
3694
|
+
export type SetAgentSessionArchivedResponse = SetAgentSessionArchivedResponses[keyof SetAgentSessionArchivedResponses];
|
|
3695
|
+
export type GetAgentSessionAutoArchiveData = {
|
|
3696
|
+
body?: never;
|
|
3697
|
+
path: {
|
|
3698
|
+
/**
|
|
3699
|
+
* ID of the agent session
|
|
3700
|
+
*/
|
|
3701
|
+
session_id: string;
|
|
3702
|
+
};
|
|
3703
|
+
query?: never;
|
|
3704
|
+
url: '/agent-sessions/{session_id}/auto-archive';
|
|
3705
|
+
};
|
|
3706
|
+
export type GetAgentSessionAutoArchiveErrors = {
|
|
3707
|
+
401: string;
|
|
3708
|
+
403: string;
|
|
3709
|
+
500: string;
|
|
3710
|
+
};
|
|
3711
|
+
export type GetAgentSessionAutoArchiveError = GetAgentSessionAutoArchiveErrors[keyof GetAgentSessionAutoArchiveErrors];
|
|
3712
|
+
export type GetAgentSessionAutoArchiveResponses = {
|
|
3713
|
+
200: SessionAutoArchiveResponse;
|
|
3714
|
+
};
|
|
3715
|
+
export type GetAgentSessionAutoArchiveResponse = GetAgentSessionAutoArchiveResponses[keyof GetAgentSessionAutoArchiveResponses];
|
|
3716
|
+
export type PutAgentSessionAutoArchiveData = {
|
|
3717
|
+
body: AutoArchiveOverridesBody;
|
|
3718
|
+
path: {
|
|
3719
|
+
/**
|
|
3720
|
+
* ID of the agent session
|
|
3721
|
+
*/
|
|
3722
|
+
session_id: string;
|
|
3723
|
+
};
|
|
3724
|
+
query?: never;
|
|
3725
|
+
url: '/agent-sessions/{session_id}/auto-archive';
|
|
3726
|
+
};
|
|
3727
|
+
export type PutAgentSessionAutoArchiveErrors = {
|
|
3728
|
+
401: string;
|
|
3729
|
+
403: string;
|
|
3730
|
+
500: string;
|
|
3731
|
+
};
|
|
3732
|
+
export type PutAgentSessionAutoArchiveError = PutAgentSessionAutoArchiveErrors[keyof PutAgentSessionAutoArchiveErrors];
|
|
3733
|
+
export type PutAgentSessionAutoArchiveResponses = {
|
|
3734
|
+
200: AutoArchiveOverridesBody;
|
|
3735
|
+
};
|
|
3736
|
+
export type PutAgentSessionAutoArchiveResponse = PutAgentSessionAutoArchiveResponses[keyof PutAgentSessionAutoArchiveResponses];
|
|
3737
|
+
export type GetAgentSessionChangesData = {
|
|
3738
|
+
body?: never;
|
|
3739
|
+
path: {
|
|
3740
|
+
/**
|
|
3741
|
+
* ID of the agent session
|
|
3742
|
+
*/
|
|
3743
|
+
session_id: string;
|
|
3744
|
+
};
|
|
3745
|
+
query?: never;
|
|
3746
|
+
url: '/agent-sessions/{session_id}/changes';
|
|
3747
|
+
};
|
|
3748
|
+
export type GetAgentSessionChangesErrors = {
|
|
3749
|
+
401: string;
|
|
3750
|
+
403: string;
|
|
3751
|
+
500: string;
|
|
3752
|
+
};
|
|
3753
|
+
export type GetAgentSessionChangesError = GetAgentSessionChangesErrors[keyof GetAgentSessionChangesErrors];
|
|
3754
|
+
export type GetAgentSessionChangesResponses = {
|
|
3755
|
+
200: AgentSessionChangesResponse;
|
|
3756
|
+
};
|
|
3757
|
+
export type GetAgentSessionChangesResponse = GetAgentSessionChangesResponses[keyof GetAgentSessionChangesResponses];
|
|
3758
|
+
export type GetAgentSessionChangesPatchData = {
|
|
3759
|
+
body?: never;
|
|
3760
|
+
path: {
|
|
3761
|
+
/**
|
|
3762
|
+
* ID of the agent session
|
|
3763
|
+
*/
|
|
3764
|
+
session_id: string;
|
|
3765
|
+
};
|
|
3766
|
+
query?: never;
|
|
3767
|
+
url: '/agent-sessions/{session_id}/changes/patch';
|
|
3768
|
+
};
|
|
3769
|
+
export type GetAgentSessionChangesPatchErrors = {
|
|
3770
|
+
401: string;
|
|
3771
|
+
403: string;
|
|
3772
|
+
404: string;
|
|
3773
|
+
500: string;
|
|
3774
|
+
};
|
|
3775
|
+
export type GetAgentSessionChangesPatchError = GetAgentSessionChangesPatchErrors[keyof GetAgentSessionChangesPatchErrors];
|
|
3776
|
+
export type GetAgentSessionChangesPatchResponses = {
|
|
3777
|
+
200: AgentSessionChangesPatchResponse;
|
|
3778
|
+
};
|
|
3779
|
+
export type GetAgentSessionChangesPatchResponse = GetAgentSessionChangesPatchResponses[keyof GetAgentSessionChangesPatchResponses];
|
|
3780
|
+
export type RefreshAgentSessionChangesData = {
|
|
3781
|
+
body?: never;
|
|
3782
|
+
path: {
|
|
3783
|
+
/**
|
|
3784
|
+
* ID of the agent session
|
|
3785
|
+
*/
|
|
3786
|
+
session_id: string;
|
|
3787
|
+
};
|
|
3788
|
+
query?: never;
|
|
3789
|
+
url: '/agent-sessions/{session_id}/changes/refresh';
|
|
3790
|
+
};
|
|
3791
|
+
export type RefreshAgentSessionChangesErrors = {
|
|
3792
|
+
401: string;
|
|
3793
|
+
403: string;
|
|
3794
|
+
500: string;
|
|
3795
|
+
};
|
|
3796
|
+
export type RefreshAgentSessionChangesError = RefreshAgentSessionChangesErrors[keyof RefreshAgentSessionChangesErrors];
|
|
3797
|
+
export type RefreshAgentSessionChangesResponses = {
|
|
3798
|
+
202: AgentSessionChangesResponse;
|
|
3799
|
+
};
|
|
3800
|
+
export type RefreshAgentSessionChangesResponse = RefreshAgentSessionChangesResponses[keyof RefreshAgentSessionChangesResponses];
|
|
3801
|
+
export type GetCodeExecutionData = {
|
|
3802
|
+
body?: never;
|
|
3803
|
+
path: {
|
|
3804
|
+
/**
|
|
3805
|
+
* Owning session
|
|
3806
|
+
*/
|
|
3807
|
+
session_id: string;
|
|
3808
|
+
/**
|
|
3809
|
+
* Execution receipt identity
|
|
3810
|
+
*/
|
|
3811
|
+
execution_id: string;
|
|
3812
|
+
};
|
|
3813
|
+
query?: never;
|
|
3814
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}';
|
|
3815
|
+
};
|
|
3816
|
+
export type GetCodeExecutionErrors = {
|
|
3817
|
+
401: unknown;
|
|
3818
|
+
403: unknown;
|
|
3819
|
+
404: unknown;
|
|
3820
|
+
500: unknown;
|
|
3821
|
+
};
|
|
3822
|
+
export type GetCodeExecutionResponses = {
|
|
3823
|
+
200: ExecutionRecord;
|
|
3824
|
+
};
|
|
3825
|
+
export type GetCodeExecutionResponse = GetCodeExecutionResponses[keyof GetCodeExecutionResponses];
|
|
3826
|
+
export type ListExecutionConnectedAppsData = {
|
|
3827
|
+
body?: never;
|
|
3828
|
+
path: {
|
|
3829
|
+
session_id: string;
|
|
3830
|
+
/**
|
|
3831
|
+
* A running execution of the session's current turn
|
|
3832
|
+
*/
|
|
3833
|
+
execution_id: string;
|
|
3834
|
+
};
|
|
3835
|
+
query?: never;
|
|
3836
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}/connected-apps';
|
|
3837
|
+
};
|
|
3838
|
+
export type ListExecutionConnectedAppsErrors = {
|
|
3839
|
+
403: unknown;
|
|
3840
|
+
404: unknown;
|
|
3841
|
+
};
|
|
3842
|
+
export type ListExecutionConnectedAppsResponses = {
|
|
3843
|
+
200: Array<ConnectedApp>;
|
|
3844
|
+
};
|
|
3845
|
+
export type ListExecutionConnectedAppsResponse = ListExecutionConnectedAppsResponses[keyof ListExecutionConnectedAppsResponses];
|
|
3846
|
+
export type DiscoverConnectedAppsData = {
|
|
3847
|
+
body: DiscoveryRequest;
|
|
3848
|
+
path: {
|
|
3849
|
+
session_id: string;
|
|
3850
|
+
execution_id: string;
|
|
3851
|
+
};
|
|
3852
|
+
query?: never;
|
|
3853
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}/connected-apps/discover';
|
|
3854
|
+
};
|
|
3855
|
+
export type DiscoverConnectedAppsErrors = {
|
|
3856
|
+
400: unknown;
|
|
3857
|
+
403: unknown;
|
|
3858
|
+
404: unknown;
|
|
3859
|
+
};
|
|
3860
|
+
export type DiscoverConnectedAppsResponses = {
|
|
3861
|
+
200: DiscoverConnectorsResponse;
|
|
3862
|
+
};
|
|
3863
|
+
export type DiscoverConnectedAppsResponse = DiscoverConnectedAppsResponses[keyof DiscoverConnectedAppsResponses];
|
|
3864
|
+
export type AddConnectedMcpServerData = {
|
|
3865
|
+
body: ConnectMcpServer;
|
|
3866
|
+
path: {
|
|
3867
|
+
session_id: string;
|
|
3868
|
+
execution_id: string;
|
|
3869
|
+
};
|
|
3870
|
+
query?: never;
|
|
3871
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}/connected-apps/servers';
|
|
3872
|
+
};
|
|
3873
|
+
export type AddConnectedMcpServerErrors = {
|
|
3874
|
+
400: unknown;
|
|
3875
|
+
403: unknown;
|
|
3876
|
+
404: unknown;
|
|
3877
|
+
};
|
|
3878
|
+
export type AddConnectedMcpServerResponses = {
|
|
3879
|
+
200: ConnectMcpServerResponse;
|
|
3880
|
+
};
|
|
3881
|
+
export type AddConnectedMcpServerResponse = AddConnectedMcpServerResponses[keyof AddConnectedMcpServerResponses];
|
|
3882
|
+
export type SearchConnectedAppToolsData = {
|
|
3883
|
+
body?: never;
|
|
3884
|
+
path: {
|
|
3885
|
+
session_id: string;
|
|
3886
|
+
execution_id: string;
|
|
3887
|
+
};
|
|
3888
|
+
query: {
|
|
3889
|
+
/**
|
|
3890
|
+
* Keywords matched against tool names and descriptions, e.g. `linear issue`.
|
|
3891
|
+
*/
|
|
3892
|
+
query: string;
|
|
3893
|
+
};
|
|
3894
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}/connected-apps/tools';
|
|
3895
|
+
};
|
|
3896
|
+
export type SearchConnectedAppToolsErrors = {
|
|
3897
|
+
403: unknown;
|
|
3898
|
+
404: unknown;
|
|
3899
|
+
};
|
|
3900
|
+
export type SearchConnectedAppToolsResponses = {
|
|
3901
|
+
200: ConnectedToolSearch;
|
|
3902
|
+
};
|
|
3903
|
+
export type SearchConnectedAppToolsResponse = SearchConnectedAppToolsResponses[keyof SearchConnectedAppToolsResponses];
|
|
3904
|
+
export type CallConnectedAppToolData = {
|
|
3905
|
+
body: CallConnectedTool;
|
|
3906
|
+
path: {
|
|
3907
|
+
session_id: string;
|
|
3908
|
+
execution_id: string;
|
|
3909
|
+
kind: ConnectedAppKind;
|
|
3910
|
+
/**
|
|
3911
|
+
* The app's slug or custom server key
|
|
3912
|
+
*/
|
|
3913
|
+
key: string;
|
|
3914
|
+
};
|
|
3915
|
+
query?: never;
|
|
3916
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}/connected-apps/{kind}/{key}/calls';
|
|
3917
|
+
};
|
|
3918
|
+
export type CallConnectedAppToolErrors = {
|
|
3919
|
+
400: unknown;
|
|
3920
|
+
403: unknown;
|
|
3921
|
+
404: unknown;
|
|
3922
|
+
};
|
|
3923
|
+
export type CallConnectedAppToolResponses = {
|
|
3924
|
+
200: ConnectedToolResult;
|
|
3925
|
+
};
|
|
3926
|
+
export type CallConnectedAppToolResponse = CallConnectedAppToolResponses[keyof CallConnectedAppToolResponses];
|
|
3927
|
+
export type ListConnectedAppToolsData = {
|
|
3928
|
+
body?: never;
|
|
3929
|
+
path: {
|
|
3930
|
+
session_id: string;
|
|
3931
|
+
execution_id: string;
|
|
3932
|
+
kind: ConnectedAppKind;
|
|
3933
|
+
/**
|
|
3934
|
+
* The app's slug or custom server key
|
|
3935
|
+
*/
|
|
3936
|
+
key: string;
|
|
3937
|
+
};
|
|
3938
|
+
query?: never;
|
|
3939
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}/connected-apps/{kind}/{key}/tools';
|
|
3940
|
+
};
|
|
3941
|
+
export type ListConnectedAppToolsErrors = {
|
|
3942
|
+
403: unknown;
|
|
3943
|
+
404: unknown;
|
|
3944
|
+
};
|
|
3945
|
+
export type ListConnectedAppToolsResponses = {
|
|
3946
|
+
200: Array<ConnectedTool>;
|
|
3947
|
+
};
|
|
3948
|
+
export type ListConnectedAppToolsResponse = ListConnectedAppToolsResponses[keyof ListConnectedAppToolsResponses];
|
|
3949
|
+
export type ListExecutionReviewsData = {
|
|
3950
|
+
body?: never;
|
|
3951
|
+
path: {
|
|
3952
|
+
session_id: string;
|
|
3953
|
+
execution_id: string;
|
|
3954
|
+
};
|
|
3955
|
+
query?: never;
|
|
3956
|
+
url: '/agent-sessions/{session_id}/code-executions/{execution_id}/reviews';
|
|
3957
|
+
};
|
|
3958
|
+
export type ListExecutionReviewsErrors = {
|
|
3959
|
+
403: unknown;
|
|
3960
|
+
};
|
|
3961
|
+
export type ListExecutionReviewsResponses = {
|
|
3962
|
+
200: Array<ReviewRecord>;
|
|
3963
|
+
};
|
|
3964
|
+
export type ListExecutionReviewsResponse = ListExecutionReviewsResponses[keyof ListExecutionReviewsResponses];
|
|
3965
|
+
export type ControlAgentSessionData = {
|
|
3966
|
+
body: ControlRequest;
|
|
3967
|
+
path: {
|
|
3968
|
+
/**
|
|
3969
|
+
* ID of the agent session
|
|
3970
|
+
*/
|
|
3971
|
+
session_id: string;
|
|
3972
|
+
};
|
|
3973
|
+
query?: never;
|
|
3974
|
+
url: '/agent-sessions/{session_id}/control';
|
|
3975
|
+
};
|
|
3976
|
+
export type ControlAgentSessionErrors = {
|
|
3977
|
+
401: string;
|
|
3978
|
+
/**
|
|
3979
|
+
* AI allowance exhausted
|
|
3980
|
+
*/
|
|
3981
|
+
402: AiAdmissionErrorBody;
|
|
3982
|
+
403: string;
|
|
3983
|
+
422: string;
|
|
3984
|
+
500: string;
|
|
3985
|
+
/**
|
|
3986
|
+
* AI usage validation unavailable, or replica draining; retry later
|
|
3987
|
+
*/
|
|
3988
|
+
503: AiAdmissionErrorBody;
|
|
3989
|
+
};
|
|
3990
|
+
export type ControlAgentSessionError = ControlAgentSessionErrors[keyof ControlAgentSessionErrors];
|
|
3991
|
+
export type ControlAgentSessionResponses = {
|
|
3992
|
+
/**
|
|
3993
|
+
* Accepted. `sent` reached the runtime; `queued` waits for the running turn to end and can be edited or removed meanwhile.
|
|
3994
|
+
*/
|
|
3995
|
+
200: ControlResponse;
|
|
3996
|
+
};
|
|
3997
|
+
export type ControlAgentSessionResponse = ControlAgentSessionResponses[keyof ControlAgentSessionResponses];
|
|
3998
|
+
export type GetAgentSessionLogData = {
|
|
3999
|
+
body?: never;
|
|
4000
|
+
path: {
|
|
4001
|
+
/**
|
|
4002
|
+
* ID of the agent session
|
|
4003
|
+
*/
|
|
4004
|
+
session_id: string;
|
|
4005
|
+
};
|
|
4006
|
+
query?: never;
|
|
4007
|
+
url: '/agent-sessions/{session_id}/log';
|
|
4008
|
+
};
|
|
4009
|
+
export type GetAgentSessionLogErrors = {
|
|
4010
|
+
401: string;
|
|
4011
|
+
403: string;
|
|
4012
|
+
500: string;
|
|
4013
|
+
};
|
|
4014
|
+
export type GetAgentSessionLogError = GetAgentSessionLogErrors[keyof GetAgentSessionLogErrors];
|
|
4015
|
+
export type GetAgentSessionLogResponses = {
|
|
4016
|
+
200: AgentSessionLogResponse;
|
|
4017
|
+
};
|
|
4018
|
+
export type GetAgentSessionLogResponse = GetAgentSessionLogResponses[keyof GetAgentSessionLogResponses];
|
|
4019
|
+
export type GetAgentSessionFoldedLogData = {
|
|
4020
|
+
body?: never;
|
|
4021
|
+
path: {
|
|
4022
|
+
/**
|
|
4023
|
+
* ID of the agent session
|
|
4024
|
+
*/
|
|
4025
|
+
session_id: string;
|
|
4026
|
+
};
|
|
4027
|
+
query?: never;
|
|
4028
|
+
url: '/agent-sessions/{session_id}/log/folded';
|
|
4029
|
+
};
|
|
4030
|
+
export type GetAgentSessionFoldedLogErrors = {
|
|
4031
|
+
401: string;
|
|
4032
|
+
403: string;
|
|
4033
|
+
500: string;
|
|
4034
|
+
};
|
|
4035
|
+
export type GetAgentSessionFoldedLogError = GetAgentSessionFoldedLogErrors[keyof GetAgentSessionFoldedLogErrors];
|
|
4036
|
+
export type GetAgentSessionFoldedLogResponses = {
|
|
4037
|
+
200: AgentSessionFoldedLogResponse;
|
|
4038
|
+
};
|
|
4039
|
+
export type GetAgentSessionFoldedLogResponse = GetAgentSessionFoldedLogResponses[keyof GetAgentSessionFoldedLogResponses];
|
|
4040
|
+
export type RenameAgentSessionData = {
|
|
4041
|
+
body: RenameAgentSessionRequest;
|
|
4042
|
+
path: {
|
|
4043
|
+
/**
|
|
4044
|
+
* ID of the agent session
|
|
4045
|
+
*/
|
|
4046
|
+
session_id: string;
|
|
4047
|
+
};
|
|
4048
|
+
query?: never;
|
|
4049
|
+
url: '/agent-sessions/{session_id}/name';
|
|
4050
|
+
};
|
|
4051
|
+
export type RenameAgentSessionErrors = {
|
|
4052
|
+
400: string;
|
|
4053
|
+
401: string;
|
|
4054
|
+
403: string;
|
|
4055
|
+
/**
|
|
4056
|
+
* The session is archived
|
|
4057
|
+
*/
|
|
4058
|
+
409: string;
|
|
4059
|
+
500: string;
|
|
4060
|
+
};
|
|
4061
|
+
export type RenameAgentSessionError = RenameAgentSessionErrors[keyof RenameAgentSessionErrors];
|
|
4062
|
+
export type RenameAgentSessionResponses = {
|
|
4063
|
+
204: void;
|
|
4064
|
+
};
|
|
4065
|
+
export type RenameAgentSessionResponse = RenameAgentSessionResponses[keyof RenameAgentSessionResponses];
|
|
4066
|
+
export type GetAgentSessionPermissionsData = {
|
|
4067
|
+
body?: never;
|
|
4068
|
+
path: {
|
|
4069
|
+
/**
|
|
4070
|
+
* ID of the agent session
|
|
4071
|
+
*/
|
|
4072
|
+
session_id: string;
|
|
4073
|
+
};
|
|
4074
|
+
query?: never;
|
|
4075
|
+
url: '/agent-sessions/{session_id}/permissions';
|
|
4076
|
+
};
|
|
4077
|
+
export type GetAgentSessionPermissionsErrors = {
|
|
4078
|
+
403: string;
|
|
4079
|
+
500: string;
|
|
4080
|
+
};
|
|
4081
|
+
export type GetAgentSessionPermissionsError = GetAgentSessionPermissionsErrors[keyof GetAgentSessionPermissionsErrors];
|
|
4082
|
+
export type GetAgentSessionPermissionsResponses = {
|
|
4083
|
+
200: SharePermissionV2;
|
|
4084
|
+
};
|
|
4085
|
+
export type GetAgentSessionPermissionsResponse = GetAgentSessionPermissionsResponses[keyof GetAgentSessionPermissionsResponses];
|
|
4086
|
+
export type UpdateAgentSessionPermissionsData = {
|
|
4087
|
+
body: UpdateSharePermissionRequestV2;
|
|
4088
|
+
path: {
|
|
4089
|
+
/**
|
|
4090
|
+
* ID of the agent session
|
|
4091
|
+
*/
|
|
4092
|
+
session_id: string;
|
|
4093
|
+
};
|
|
4094
|
+
query?: never;
|
|
4095
|
+
url: '/agent-sessions/{session_id}/permissions';
|
|
4096
|
+
};
|
|
4097
|
+
export type UpdateAgentSessionPermissionsErrors = {
|
|
4098
|
+
400: string;
|
|
4099
|
+
403: string;
|
|
4100
|
+
409: string;
|
|
4101
|
+
500: string;
|
|
4102
|
+
};
|
|
4103
|
+
export type UpdateAgentSessionPermissionsError = UpdateAgentSessionPermissionsErrors[keyof UpdateAgentSessionPermissionsErrors];
|
|
4104
|
+
export type UpdateAgentSessionPermissionsResponses = {
|
|
4105
|
+
200: SharePermissionV2;
|
|
4106
|
+
};
|
|
4107
|
+
export type UpdateAgentSessionPermissionsResponse = UpdateAgentSessionPermissionsResponses[keyof UpdateAgentSessionPermissionsResponses];
|
|
4108
|
+
export type UnlinkAgentSessionPullRequestData = {
|
|
4109
|
+
body?: never;
|
|
4110
|
+
path: {
|
|
4111
|
+
/**
|
|
4112
|
+
* ID of the agent session
|
|
4113
|
+
*/
|
|
4114
|
+
session_id: string;
|
|
4115
|
+
};
|
|
4116
|
+
query: {
|
|
4117
|
+
/**
|
|
4118
|
+
* The pull request's GitHub URL
|
|
4119
|
+
*/
|
|
4120
|
+
url: string;
|
|
4121
|
+
};
|
|
4122
|
+
url: '/agent-sessions/{session_id}/pull-requests';
|
|
4123
|
+
};
|
|
4124
|
+
export type UnlinkAgentSessionPullRequestErrors = {
|
|
4125
|
+
400: string;
|
|
4126
|
+
401: string;
|
|
4127
|
+
403: string;
|
|
4128
|
+
500: string;
|
|
4129
|
+
};
|
|
4130
|
+
export type UnlinkAgentSessionPullRequestError = UnlinkAgentSessionPullRequestErrors[keyof UnlinkAgentSessionPullRequestErrors];
|
|
4131
|
+
export type UnlinkAgentSessionPullRequestResponses = {
|
|
4132
|
+
204: void;
|
|
4133
|
+
};
|
|
4134
|
+
export type UnlinkAgentSessionPullRequestResponse = UnlinkAgentSessionPullRequestResponses[keyof UnlinkAgentSessionPullRequestResponses];
|
|
4135
|
+
export type ListAgentSessionPullRequestsData = {
|
|
4136
|
+
body?: never;
|
|
4137
|
+
path: {
|
|
4138
|
+
/**
|
|
4139
|
+
* ID of the agent session
|
|
4140
|
+
*/
|
|
4141
|
+
session_id: string;
|
|
4142
|
+
};
|
|
4143
|
+
query?: never;
|
|
4144
|
+
url: '/agent-sessions/{session_id}/pull-requests';
|
|
4145
|
+
};
|
|
4146
|
+
export type ListAgentSessionPullRequestsErrors = {
|
|
4147
|
+
401: string;
|
|
4148
|
+
403: string;
|
|
4149
|
+
500: string;
|
|
4150
|
+
};
|
|
4151
|
+
export type ListAgentSessionPullRequestsError = ListAgentSessionPullRequestsErrors[keyof ListAgentSessionPullRequestsErrors];
|
|
4152
|
+
export type ListAgentSessionPullRequestsResponses = {
|
|
4153
|
+
200: SessionPullRequestsResponse;
|
|
4154
|
+
};
|
|
4155
|
+
export type ListAgentSessionPullRequestsResponse = ListAgentSessionPullRequestsResponses[keyof ListAgentSessionPullRequestsResponses];
|
|
4156
|
+
export type LinkAgentSessionPullRequestData = {
|
|
4157
|
+
body: PullRequestUrl;
|
|
4158
|
+
path: {
|
|
4159
|
+
/**
|
|
4160
|
+
* ID of the agent session
|
|
4161
|
+
*/
|
|
4162
|
+
session_id: string;
|
|
4163
|
+
};
|
|
4164
|
+
query?: never;
|
|
4165
|
+
url: '/agent-sessions/{session_id}/pull-requests';
|
|
4166
|
+
};
|
|
4167
|
+
export type LinkAgentSessionPullRequestErrors = {
|
|
4168
|
+
400: string;
|
|
4169
|
+
401: string;
|
|
4170
|
+
403: string;
|
|
4171
|
+
500: string;
|
|
4172
|
+
};
|
|
4173
|
+
export type LinkAgentSessionPullRequestError = LinkAgentSessionPullRequestErrors[keyof LinkAgentSessionPullRequestErrors];
|
|
4174
|
+
export type LinkAgentSessionPullRequestResponses = {
|
|
4175
|
+
204: void;
|
|
4176
|
+
};
|
|
4177
|
+
export type LinkAgentSessionPullRequestResponse = LinkAgentSessionPullRequestResponses[keyof LinkAgentSessionPullRequestResponses];
|
|
4178
|
+
export type GetAgentSessionQueueData = {
|
|
4179
|
+
body?: never;
|
|
4180
|
+
path: {
|
|
4181
|
+
/**
|
|
4182
|
+
* ID of the agent session
|
|
4183
|
+
*/
|
|
4184
|
+
session_id: string;
|
|
4185
|
+
};
|
|
4186
|
+
query?: never;
|
|
4187
|
+
url: '/agent-sessions/{session_id}/queue';
|
|
4188
|
+
};
|
|
4189
|
+
export type GetAgentSessionQueueErrors = {
|
|
4190
|
+
401: string;
|
|
4191
|
+
403: string;
|
|
4192
|
+
500: string;
|
|
4193
|
+
};
|
|
4194
|
+
export type GetAgentSessionQueueError = GetAgentSessionQueueErrors[keyof GetAgentSessionQueueErrors];
|
|
4195
|
+
export type GetAgentSessionQueueResponses = {
|
|
4196
|
+
200: AgentSessionQueueResponse;
|
|
4197
|
+
};
|
|
4198
|
+
export type GetAgentSessionQueueResponse = GetAgentSessionQueueResponses[keyof GetAgentSessionQueueResponses];
|
|
4199
|
+
export type RemoveQueuedActionData = {
|
|
4200
|
+
body?: never;
|
|
4201
|
+
path: {
|
|
4202
|
+
/**
|
|
4203
|
+
* ID of the agent session
|
|
4204
|
+
*/
|
|
4205
|
+
session_id: string;
|
|
4206
|
+
/**
|
|
4207
|
+
* ID the action was accepted under
|
|
4208
|
+
*/
|
|
4209
|
+
action_id: string;
|
|
4210
|
+
};
|
|
4211
|
+
query?: never;
|
|
4212
|
+
url: '/agent-sessions/{session_id}/queue/{action_id}';
|
|
4213
|
+
};
|
|
4214
|
+
export type RemoveQueuedActionErrors = {
|
|
4215
|
+
401: string;
|
|
4216
|
+
403: string;
|
|
4217
|
+
/**
|
|
4218
|
+
* Already dispatched or never queued
|
|
4219
|
+
*/
|
|
4220
|
+
404: string;
|
|
4221
|
+
500: string;
|
|
4222
|
+
};
|
|
4223
|
+
export type RemoveQueuedActionError = RemoveQueuedActionErrors[keyof RemoveQueuedActionErrors];
|
|
4224
|
+
export type RemoveQueuedActionResponses = {
|
|
4225
|
+
204: void;
|
|
4226
|
+
};
|
|
4227
|
+
export type RemoveQueuedActionResponse = RemoveQueuedActionResponses[keyof RemoveQueuedActionResponses];
|
|
4228
|
+
export type EditQueuedActionData = {
|
|
4229
|
+
body: EditQueuedActionRequest;
|
|
4230
|
+
path: {
|
|
4231
|
+
/**
|
|
4232
|
+
* ID of the agent session
|
|
4233
|
+
*/
|
|
4234
|
+
session_id: string;
|
|
4235
|
+
/**
|
|
4236
|
+
* ID the action was accepted under
|
|
4237
|
+
*/
|
|
4238
|
+
action_id: string;
|
|
4239
|
+
};
|
|
4240
|
+
query?: never;
|
|
4241
|
+
url: '/agent-sessions/{session_id}/queue/{action_id}';
|
|
4242
|
+
};
|
|
4243
|
+
export type EditQueuedActionErrors = {
|
|
4244
|
+
401: string;
|
|
4245
|
+
403: string;
|
|
4246
|
+
/**
|
|
4247
|
+
* Already dispatched or never queued
|
|
4248
|
+
*/
|
|
4249
|
+
404: string;
|
|
4250
|
+
/**
|
|
4251
|
+
* The queued action carries no text
|
|
4252
|
+
*/
|
|
4253
|
+
422: string;
|
|
4254
|
+
500: string;
|
|
4255
|
+
};
|
|
4256
|
+
export type EditQueuedActionError = EditQueuedActionErrors[keyof EditQueuedActionErrors];
|
|
4257
|
+
export type EditQueuedActionResponses = {
|
|
4258
|
+
204: void;
|
|
4259
|
+
};
|
|
4260
|
+
export type EditQueuedActionResponse = EditQueuedActionResponses[keyof EditQueuedActionResponses];
|
|
4261
|
+
export type SteerQueuedActionData = {
|
|
4262
|
+
body?: never;
|
|
4263
|
+
path: {
|
|
4264
|
+
/**
|
|
4265
|
+
* ID of the agent session
|
|
4266
|
+
*/
|
|
4267
|
+
session_id: string;
|
|
4268
|
+
/**
|
|
4269
|
+
* ID the action was accepted under
|
|
4270
|
+
*/
|
|
4271
|
+
action_id: string;
|
|
4272
|
+
};
|
|
4273
|
+
query?: never;
|
|
4274
|
+
url: '/agent-sessions/{session_id}/queue/{action_id}/steer';
|
|
4275
|
+
};
|
|
4276
|
+
export type SteerQueuedActionErrors = {
|
|
4277
|
+
401: string;
|
|
4278
|
+
403: string;
|
|
4279
|
+
/**
|
|
4280
|
+
* Already dispatched or never queued
|
|
4281
|
+
*/
|
|
4282
|
+
404: string;
|
|
4283
|
+
500: string;
|
|
4284
|
+
};
|
|
4285
|
+
export type SteerQueuedActionError = SteerQueuedActionErrors[keyof SteerQueuedActionErrors];
|
|
4286
|
+
export type SteerQueuedActionResponses = {
|
|
4287
|
+
204: void;
|
|
4288
|
+
};
|
|
4289
|
+
export type SteerQueuedActionResponse = SteerQueuedActionResponses[keyof SteerQueuedActionResponses];
|
|
4290
|
+
export type CreateSessionReviewData = {
|
|
4291
|
+
body: CreateReview;
|
|
4292
|
+
path: {
|
|
4293
|
+
session_id: string;
|
|
4294
|
+
};
|
|
4295
|
+
query?: never;
|
|
4296
|
+
url: '/agent-sessions/{session_id}/reviews';
|
|
4297
|
+
};
|
|
4298
|
+
export type CreateSessionReviewErrors = {
|
|
4299
|
+
400: unknown;
|
|
4300
|
+
403: unknown;
|
|
4301
|
+
};
|
|
4302
|
+
export type CreateSessionReviewResponses = {
|
|
4303
|
+
200: ReviewRecord;
|
|
4304
|
+
};
|
|
4305
|
+
export type CreateSessionReviewResponse = CreateSessionReviewResponses[keyof CreateSessionReviewResponses];
|
|
4306
|
+
export type GetSessionReviewData = {
|
|
4307
|
+
body?: never;
|
|
4308
|
+
path: {
|
|
4309
|
+
session_id: string;
|
|
4310
|
+
review_id: string;
|
|
4311
|
+
};
|
|
4312
|
+
query?: never;
|
|
4313
|
+
url: '/agent-sessions/{session_id}/reviews/{review_id}';
|
|
4314
|
+
};
|
|
4315
|
+
export type GetSessionReviewErrors = {
|
|
4316
|
+
403: unknown;
|
|
4317
|
+
404: unknown;
|
|
4318
|
+
};
|
|
4319
|
+
export type GetSessionReviewResponses = {
|
|
4320
|
+
200: ReviewRecord;
|
|
4321
|
+
};
|
|
4322
|
+
export type GetSessionReviewResponse = GetSessionReviewResponses[keyof GetSessionReviewResponses];
|
|
4323
|
+
export type DecideSessionReviewData = {
|
|
4324
|
+
body: ReviewDecision;
|
|
4325
|
+
path: {
|
|
4326
|
+
session_id: string;
|
|
4327
|
+
review_id: string;
|
|
4328
|
+
};
|
|
4329
|
+
query?: never;
|
|
4330
|
+
url: '/agent-sessions/{session_id}/reviews/{review_id}';
|
|
4331
|
+
};
|
|
4332
|
+
export type DecideSessionReviewErrors = {
|
|
4333
|
+
403: unknown;
|
|
4334
|
+
409: unknown;
|
|
4335
|
+
};
|
|
4336
|
+
export type DecideSessionReviewResponses = {
|
|
4337
|
+
200: ReviewRecord;
|
|
4338
|
+
};
|
|
4339
|
+
export type DecideSessionReviewResponse = DecideSessionReviewResponses[keyof DecideSessionReviewResponses];
|
|
4340
|
+
export type PutAgentSessionSandboxSizeData = {
|
|
4341
|
+
body: SandboxSizeBody;
|
|
4342
|
+
path: {
|
|
4343
|
+
/**
|
|
4344
|
+
* ID of the agent session
|
|
4345
|
+
*/
|
|
4346
|
+
session_id: string;
|
|
4347
|
+
};
|
|
4348
|
+
query?: never;
|
|
4349
|
+
url: '/agent-sessions/{session_id}/sandbox-size';
|
|
4350
|
+
};
|
|
4351
|
+
export type PutAgentSessionSandboxSizeErrors = {
|
|
4352
|
+
401: string;
|
|
4353
|
+
403: string;
|
|
4354
|
+
500: string;
|
|
4355
|
+
};
|
|
4356
|
+
export type PutAgentSessionSandboxSizeError = PutAgentSessionSandboxSizeErrors[keyof PutAgentSessionSandboxSizeErrors];
|
|
4357
|
+
export type PutAgentSessionSandboxSizeResponses = {
|
|
4358
|
+
200: SandboxSizeBody;
|
|
4359
|
+
};
|
|
4360
|
+
export type PutAgentSessionSandboxSizeResponse = PutAgentSessionSandboxSizeResponses[keyof PutAgentSessionSandboxSizeResponses];
|
|
4361
|
+
export type LinkAgentSessionTaskData = {
|
|
4362
|
+
body: LinkTaskRequest;
|
|
4363
|
+
path: {
|
|
4364
|
+
/**
|
|
4365
|
+
* ID of the agent session
|
|
4366
|
+
*/
|
|
4367
|
+
session_id: string;
|
|
4368
|
+
};
|
|
4369
|
+
query?: never;
|
|
4370
|
+
url: '/agent-sessions/{session_id}/task';
|
|
4371
|
+
};
|
|
4372
|
+
export type LinkAgentSessionTaskErrors = {
|
|
4373
|
+
400: string;
|
|
4374
|
+
401: string;
|
|
4375
|
+
403: string;
|
|
4376
|
+
404: string;
|
|
4377
|
+
500: string;
|
|
4378
|
+
};
|
|
4379
|
+
export type LinkAgentSessionTaskError = LinkAgentSessionTaskErrors[keyof LinkAgentSessionTaskErrors];
|
|
4380
|
+
export type LinkAgentSessionTaskResponses = {
|
|
4381
|
+
200: LinkedTaskResponse;
|
|
4382
|
+
};
|
|
4383
|
+
export type LinkAgentSessionTaskResponse = LinkAgentSessionTaskResponses[keyof LinkAgentSessionTaskResponses];
|
|
4384
|
+
export type AnswerAgentSessionToolApprovalData = {
|
|
4385
|
+
body: AnswerToolApprovalRequest;
|
|
4386
|
+
path: {
|
|
4387
|
+
/**
|
|
4388
|
+
* ID of the agent session
|
|
4389
|
+
*/
|
|
4390
|
+
session_id: string;
|
|
4391
|
+
/**
|
|
4392
|
+
* ID of the held tool call
|
|
4393
|
+
*/
|
|
4394
|
+
approval_id: string;
|
|
4395
|
+
};
|
|
4396
|
+
query?: never;
|
|
4397
|
+
url: '/agent-sessions/{session_id}/tool-approvals/{approval_id}';
|
|
4398
|
+
};
|
|
4399
|
+
export type AnswerAgentSessionToolApprovalErrors = {
|
|
4400
|
+
401: string;
|
|
4401
|
+
/**
|
|
4402
|
+
* Agent run approving, not the owner for approve or deny, or no edit access
|
|
4403
|
+
*/
|
|
4404
|
+
403: string;
|
|
4405
|
+
404: string;
|
|
4406
|
+
/**
|
|
4407
|
+
* Already resolved
|
|
4408
|
+
*/
|
|
4409
|
+
409: string;
|
|
4410
|
+
/**
|
|
4411
|
+
* Approve for good, for a call no person asked for
|
|
4412
|
+
*/
|
|
4413
|
+
422: string;
|
|
4414
|
+
500: string;
|
|
4415
|
+
};
|
|
4416
|
+
export type AnswerAgentSessionToolApprovalError = AnswerAgentSessionToolApprovalErrors[keyof AnswerAgentSessionToolApprovalErrors];
|
|
4417
|
+
export type AnswerAgentSessionToolApprovalResponses = {
|
|
4418
|
+
200: AnswerToolApprovalResponse;
|
|
4419
|
+
};
|
|
4420
|
+
export type AnswerAgentSessionToolApprovalResponse = AnswerAgentSessionToolApprovalResponses[keyof AnswerAgentSessionToolApprovalResponses];
|
|
4421
|
+
export type OpenInAppData = {
|
|
4422
|
+
body: OpenInApp;
|
|
4423
|
+
path: {
|
|
4424
|
+
session_id: string;
|
|
4425
|
+
};
|
|
4426
|
+
query?: never;
|
|
4427
|
+
url: '/agent-sessions/{session_id}/ui-commands';
|
|
4428
|
+
};
|
|
4429
|
+
export type OpenInAppErrors = {
|
|
4430
|
+
400: unknown;
|
|
4431
|
+
403: unknown;
|
|
4432
|
+
};
|
|
4433
|
+
export type OpenInAppResponses = {
|
|
4434
|
+
200: UiCommandOutcome;
|
|
4435
|
+
};
|
|
4436
|
+
export type OpenInAppResponse = OpenInAppResponses[keyof OpenInAppResponses];
|
|
4437
|
+
export type PresentSessionViewData = {
|
|
4438
|
+
body: PresentView;
|
|
4439
|
+
path: {
|
|
4440
|
+
session_id: string;
|
|
4441
|
+
};
|
|
4442
|
+
query?: never;
|
|
4443
|
+
url: '/agent-sessions/{session_id}/views';
|
|
4444
|
+
};
|
|
4445
|
+
export type PresentSessionViewErrors = {
|
|
4446
|
+
400: unknown;
|
|
4447
|
+
403: unknown;
|
|
4448
|
+
};
|
|
4449
|
+
export type PresentSessionViewResponses = {
|
|
4450
|
+
204: void;
|
|
4451
|
+
};
|
|
4452
|
+
export type PresentSessionViewResponse = PresentSessionViewResponses[keyof PresentSessionViewResponses];
|
|
4453
|
+
export type UnregisterAgentSessionWorkData = {
|
|
4454
|
+
body?: never;
|
|
4455
|
+
path: {
|
|
4456
|
+
/**
|
|
4457
|
+
* ID of the agent session
|
|
4458
|
+
*/
|
|
4459
|
+
session_id: string;
|
|
4460
|
+
};
|
|
4461
|
+
query?: never;
|
|
4462
|
+
url: '/agent-sessions/{session_id}/work-registration';
|
|
4463
|
+
};
|
|
4464
|
+
export type UnregisterAgentSessionWorkErrors = {
|
|
4465
|
+
401: string;
|
|
4466
|
+
500: string;
|
|
4467
|
+
};
|
|
4468
|
+
export type UnregisterAgentSessionWorkError = UnregisterAgentSessionWorkErrors[keyof UnregisterAgentSessionWorkErrors];
|
|
4469
|
+
export type UnregisterAgentSessionWorkResponses = {
|
|
4470
|
+
/**
|
|
4471
|
+
* The caller has no active registration of the session
|
|
4472
|
+
*/
|
|
4473
|
+
204: void;
|
|
4474
|
+
};
|
|
4475
|
+
export type UnregisterAgentSessionWorkResponse = UnregisterAgentSessionWorkResponses[keyof UnregisterAgentSessionWorkResponses];
|
|
4476
|
+
export type RegisterAgentSessionWorkData = {
|
|
4477
|
+
body?: never;
|
|
4478
|
+
path: {
|
|
4479
|
+
/**
|
|
4480
|
+
* ID of the agent session
|
|
4481
|
+
*/
|
|
4482
|
+
session_id: string;
|
|
4483
|
+
};
|
|
4484
|
+
query?: never;
|
|
4485
|
+
url: '/agent-sessions/{session_id}/work-registration';
|
|
4486
|
+
};
|
|
4487
|
+
export type RegisterAgentSessionWorkErrors = {
|
|
4488
|
+
401: string;
|
|
4489
|
+
403: string;
|
|
4490
|
+
409: string;
|
|
4491
|
+
500: string;
|
|
4492
|
+
};
|
|
4493
|
+
export type RegisterAgentSessionWorkError = RegisterAgentSessionWorkErrors[keyof RegisterAgentSessionWorkErrors];
|
|
4494
|
+
export type RegisterAgentSessionWorkResponses = {
|
|
4495
|
+
200: WorkRegistrationResponse;
|
|
4496
|
+
};
|
|
4497
|
+
export type RegisterAgentSessionWorkResponse = RegisterAgentSessionWorkResponses[keyof RegisterAgentSessionWorkResponses];
|
|
4498
|
+
export type ListAgentWorkRegistrationsData = {
|
|
4499
|
+
body?: never;
|
|
4500
|
+
path?: never;
|
|
4501
|
+
query?: never;
|
|
4502
|
+
url: '/agent-work-registrations';
|
|
4503
|
+
};
|
|
4504
|
+
export type ListAgentWorkRegistrationsErrors = {
|
|
4505
|
+
401: string;
|
|
4506
|
+
500: string;
|
|
4507
|
+
};
|
|
4508
|
+
export type ListAgentWorkRegistrationsError = ListAgentWorkRegistrationsErrors[keyof ListAgentWorkRegistrationsErrors];
|
|
4509
|
+
export type ListAgentWorkRegistrationsResponses = {
|
|
4510
|
+
200: Array<WorkRegistrationResponse>;
|
|
4511
|
+
};
|
|
4512
|
+
export type ListAgentWorkRegistrationsResponse = ListAgentWorkRegistrationsResponses[keyof ListAgentWorkRegistrationsResponses];
|
|
4513
|
+
export type ListCodingAgentsData = {
|
|
4514
|
+
body?: never;
|
|
4515
|
+
path?: never;
|
|
4516
|
+
query?: never;
|
|
4517
|
+
url: '/coding-agents';
|
|
4518
|
+
};
|
|
4519
|
+
export type ListCodingAgentsErrors = {
|
|
4520
|
+
/**
|
|
4521
|
+
* Unauthenticated
|
|
4522
|
+
*/
|
|
4523
|
+
401: unknown;
|
|
4524
|
+
/**
|
|
4525
|
+
* The personas or their runtime connections could not be read
|
|
4526
|
+
*/
|
|
4527
|
+
500: unknown;
|
|
4528
|
+
};
|
|
4529
|
+
export type ListCodingAgentsResponses = {
|
|
4530
|
+
/**
|
|
4531
|
+
* The caller's available coding agents
|
|
4532
|
+
*/
|
|
4533
|
+
200: CodingAgentsResponse;
|
|
4534
|
+
};
|
|
4535
|
+
export type ListCodingAgentsResponse = ListCodingAgentsResponses[keyof ListCodingAgentsResponses];
|
|
4536
|
+
export type GetClaudeModeData = {
|
|
4537
|
+
body?: never;
|
|
4538
|
+
path: {
|
|
4539
|
+
/**
|
|
4540
|
+
* Harness ID
|
|
4541
|
+
*/
|
|
4542
|
+
harness_id: string;
|
|
4543
|
+
};
|
|
4544
|
+
query?: never;
|
|
4545
|
+
url: '/harnesses/{harness_id}/claude-mode';
|
|
4546
|
+
};
|
|
4547
|
+
export type GetClaudeModeErrors = {
|
|
4548
|
+
403: unknown;
|
|
4549
|
+
404: unknown;
|
|
4550
|
+
503: unknown;
|
|
4551
|
+
};
|
|
4552
|
+
export type GetClaudeModeResponses = {
|
|
4553
|
+
200: ClaudeModeResponse;
|
|
4554
|
+
};
|
|
4555
|
+
export type GetClaudeModeResponse = GetClaudeModeResponses[keyof GetClaudeModeResponses];
|
|
4556
|
+
export type StartClaudeSignInData = {
|
|
4557
|
+
body?: never;
|
|
4558
|
+
path: {
|
|
4559
|
+
/**
|
|
4560
|
+
* Harness ID
|
|
4561
|
+
*/
|
|
4562
|
+
harness_id: string;
|
|
4563
|
+
};
|
|
4564
|
+
query?: never;
|
|
4565
|
+
url: '/harnesses/{harness_id}/claude-sign-in';
|
|
4566
|
+
};
|
|
4567
|
+
export type StartClaudeSignInErrors = {
|
|
4568
|
+
400: unknown;
|
|
4569
|
+
403: unknown;
|
|
4570
|
+
404: unknown;
|
|
4571
|
+
409: unknown;
|
|
4572
|
+
410: unknown;
|
|
4573
|
+
422: unknown;
|
|
4574
|
+
503: unknown;
|
|
4575
|
+
504: unknown;
|
|
4576
|
+
};
|
|
4577
|
+
export type StartClaudeSignInResponses = {
|
|
4578
|
+
200: ClaudeSignInStarted;
|
|
4579
|
+
};
|
|
4580
|
+
export type StartClaudeSignInResponse = StartClaudeSignInResponses[keyof StartClaudeSignInResponses];
|
|
4581
|
+
export type CompleteClaudeSignInData = {
|
|
4582
|
+
body: ClaudeSignInComplete;
|
|
4583
|
+
path: {
|
|
4584
|
+
/**
|
|
4585
|
+
* Harness ID
|
|
4586
|
+
*/
|
|
4587
|
+
harness_id: string;
|
|
4588
|
+
};
|
|
4589
|
+
query?: never;
|
|
4590
|
+
url: '/harnesses/{harness_id}/claude-sign-in/complete';
|
|
4591
|
+
};
|
|
4592
|
+
export type CompleteClaudeSignInErrors = {
|
|
4593
|
+
400: unknown;
|
|
4594
|
+
403: unknown;
|
|
4595
|
+
404: unknown;
|
|
4596
|
+
409: unknown;
|
|
4597
|
+
410: unknown;
|
|
4598
|
+
422: unknown;
|
|
4599
|
+
503: unknown;
|
|
4600
|
+
504: unknown;
|
|
4601
|
+
};
|
|
4602
|
+
export type CompleteClaudeSignInResponses = {
|
|
4603
|
+
200: ClaudeSignedIn;
|
|
4604
|
+
};
|
|
4605
|
+
export type CompleteClaudeSignInResponse = CompleteClaudeSignInResponses[keyof CompleteClaudeSignInResponses];
|
|
4606
|
+
export type ClaudeSignOutData = {
|
|
4607
|
+
body?: never;
|
|
4608
|
+
path: {
|
|
4609
|
+
/**
|
|
4610
|
+
* Harness ID
|
|
4611
|
+
*/
|
|
4612
|
+
harness_id: string;
|
|
4613
|
+
};
|
|
4614
|
+
query?: never;
|
|
4615
|
+
url: '/harnesses/{harness_id}/claude-sign-out';
|
|
4616
|
+
};
|
|
4617
|
+
export type ClaudeSignOutErrors = {
|
|
4618
|
+
403: unknown;
|
|
4619
|
+
404: unknown;
|
|
4620
|
+
409: unknown;
|
|
4621
|
+
422: unknown;
|
|
4622
|
+
503: unknown;
|
|
4623
|
+
504: unknown;
|
|
4624
|
+
};
|
|
4625
|
+
export type ClaudeSignOutResponses = {
|
|
4626
|
+
200: ClaudeModeResponse;
|
|
4627
|
+
};
|
|
4628
|
+
export type ClaudeSignOutResponse = ClaudeSignOutResponses[keyof ClaudeSignOutResponses];
|
|
4629
|
+
export type ClassifyData = {
|
|
4630
|
+
body: ClassifyInputRequest;
|
|
4631
|
+
path?: never;
|
|
4632
|
+
query?: never;
|
|
4633
|
+
url: '/universal_input/classify';
|
|
4634
|
+
};
|
|
4635
|
+
export type ClassifyErrors = {
|
|
4636
|
+
/**
|
|
4637
|
+
* Invalid input
|
|
4638
|
+
*/
|
|
4639
|
+
400: unknown;
|
|
4640
|
+
/**
|
|
4641
|
+
* Unauthenticated
|
|
4642
|
+
*/
|
|
4643
|
+
401: unknown;
|
|
4644
|
+
/**
|
|
4645
|
+
* AI allowance exhausted
|
|
4646
|
+
*/
|
|
4647
|
+
402: unknown;
|
|
4648
|
+
/**
|
|
4649
|
+
* Detection unavailable
|
|
4650
|
+
*/
|
|
4651
|
+
503: unknown;
|
|
4652
|
+
};
|
|
4653
|
+
export type ClassifyResponses = {
|
|
4654
|
+
200: ClassifyInputResponse;
|
|
4655
|
+
};
|
|
4656
|
+
export type ClassifyResponse = ClassifyResponses[keyof ClassifyResponses];
|
|
4657
|
+
export type ExtractData = {
|
|
4658
|
+
body: ExtractInputRequest;
|
|
4659
|
+
path?: never;
|
|
4660
|
+
query?: never;
|
|
4661
|
+
url: '/universal_input/extract';
|
|
4662
|
+
};
|
|
4663
|
+
export type ExtractErrors = {
|
|
4664
|
+
/**
|
|
4665
|
+
* Invalid input
|
|
4666
|
+
*/
|
|
4667
|
+
400: unknown;
|
|
4668
|
+
/**
|
|
4669
|
+
* Unauthenticated
|
|
4670
|
+
*/
|
|
4671
|
+
401: unknown;
|
|
4672
|
+
/**
|
|
4673
|
+
* AI allowance exhausted
|
|
4674
|
+
*/
|
|
4675
|
+
402: unknown;
|
|
4676
|
+
/**
|
|
4677
|
+
* Extraction unavailable
|
|
4678
|
+
*/
|
|
4679
|
+
503: unknown;
|
|
4680
|
+
};
|
|
4681
|
+
export type ExtractResponses = {
|
|
4682
|
+
200: ExtractInputResponse;
|
|
4683
|
+
};
|
|
4684
|
+
export type ExtractResponse = ExtractResponses[keyof ExtractResponses];
|
|
4685
|
+
export type GetAgentVoicesData = {
|
|
4686
|
+
body?: never;
|
|
4687
|
+
path?: never;
|
|
4688
|
+
query?: never;
|
|
4689
|
+
url: '/voices';
|
|
4690
|
+
};
|
|
4691
|
+
export type GetAgentVoicesErrors = {
|
|
4692
|
+
401: ErrorResponse;
|
|
4693
|
+
403: ErrorResponse;
|
|
4694
|
+
502: ErrorResponse;
|
|
4695
|
+
};
|
|
4696
|
+
export type GetAgentVoicesError = GetAgentVoicesErrors[keyof GetAgentVoicesErrors];
|
|
4697
|
+
export type GetAgentVoicesResponses = {
|
|
4698
|
+
200: Array<Voice>;
|
|
4699
|
+
};
|
|
4700
|
+
export type GetAgentVoicesResponse = GetAgentVoicesResponses[keyof GetAgentVoicesResponses];
|
|
4701
|
+
export type GetAgentVoiceSampleData = {
|
|
4702
|
+
body?: never;
|
|
4703
|
+
path: {
|
|
4704
|
+
/**
|
|
4705
|
+
* An Aura-2 model, such as aura-2-thalia-en
|
|
4706
|
+
*/
|
|
4707
|
+
model: string;
|
|
4708
|
+
};
|
|
4709
|
+
query?: never;
|
|
4710
|
+
url: '/voices/{model}/sample';
|
|
4711
|
+
};
|
|
4712
|
+
export type GetAgentVoiceSampleErrors = {
|
|
4713
|
+
400: ErrorResponse;
|
|
4714
|
+
401: ErrorResponse;
|
|
4715
|
+
403: ErrorResponse;
|
|
4716
|
+
502: ErrorResponse;
|
|
4717
|
+
};
|
|
4718
|
+
export type GetAgentVoiceSampleError = GetAgentVoiceSampleErrors[keyof GetAgentVoiceSampleErrors];
|
|
4719
|
+
export type GetAgentVoiceSampleResponses = {
|
|
4720
|
+
/**
|
|
4721
|
+
* WAV audio
|
|
4722
|
+
*/
|
|
4723
|
+
200: Array<number>;
|
|
4724
|
+
};
|
|
4725
|
+
export type GetAgentVoiceSampleResponse = GetAgentVoiceSampleResponses[keyof GetAgentVoiceSampleResponses];
|