@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 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { ActivityWireRow } from '../../../generated/agent-harness/types.gen';
|
|
2
|
+
import { type IterationOptions } from '../../utils';
|
|
3
|
+
import type { RoxClient } from '../../utils/client';
|
|
4
|
+
import type { AgentSession } from './agent-session';
|
|
5
|
+
/** Page options for recorded session activity, newest first. */
|
|
6
|
+
export type AgentActivityOptions = IterationOptions & {
|
|
7
|
+
/** Page size, from 1 to 100; defaults to 50. */
|
|
8
|
+
limit?: number;
|
|
9
|
+
/** Restrict to one code-mode invocation belonging to this session. */
|
|
10
|
+
invocation?: AgentInvocation;
|
|
11
|
+
};
|
|
12
|
+
/** A code-mode invocation, identified independently of its runtime or retries. */
|
|
13
|
+
export declare class AgentInvocation {
|
|
14
|
+
private readonly client;
|
|
15
|
+
private readonly parent;
|
|
16
|
+
readonly id: string;
|
|
17
|
+
private constructor();
|
|
18
|
+
/** Construct a handle without making a request. */
|
|
19
|
+
static byId(client: RoxClient, session: AgentSession, id: string): AgentInvocation;
|
|
20
|
+
/**
|
|
21
|
+
* The session that owns this invocation.
|
|
22
|
+
*
|
|
23
|
+
* @readonly
|
|
24
|
+
*/
|
|
25
|
+
session(): AgentSession;
|
|
26
|
+
/**
|
|
27
|
+
* Recorded activity caused by this invocation, lazily paginated; `maxItems` caps the total.
|
|
28
|
+
*
|
|
29
|
+
* @readonly
|
|
30
|
+
*/
|
|
31
|
+
activity(options?: Omit<AgentActivityOptions, 'invocation'>): AsyncGenerator<AgentActivity, any, any>;
|
|
32
|
+
/** Safe identity without an authenticated client. */
|
|
33
|
+
toJSON(): {
|
|
34
|
+
id: string;
|
|
35
|
+
session: {
|
|
36
|
+
id: string;
|
|
37
|
+
};
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
/** An original activity-history row attributed to a session. */
|
|
41
|
+
export type AgentActivity = {
|
|
42
|
+
/** The originating invocation; absent on legacy rows. */
|
|
43
|
+
invocation?: AgentInvocation;
|
|
44
|
+
/** Original recorded metadata. Action tags and payloads are forward-compatible. */
|
|
45
|
+
snapshot: ActivityWireRow;
|
|
46
|
+
};
|
|
47
|
+
/** Iterate recorded mutations; reads and failed requests do not create history. */
|
|
48
|
+
export declare function sessionActivity(client: RoxClient, session: AgentSession, options?: AgentActivityOptions): AsyncGenerator<AgentActivity>;
|
|
@@ -0,0 +1,518 @@
|
|
|
1
|
+
import type { FoldedMessage } from '../../../generated/agent-fold';
|
|
2
|
+
import type { AgentAction, AgentMode, AgentSessionChangesResponse, AgentSessionLogResponse, AgentSessionResponse, AgentUpdateKind, ArchiveCause, AutoArchivePreferencesBody, CodingPreferencesBody, ControlResponse, PromptAttachment, PullRequestLinkSource, SandboxSize, SessionBot } from '../../../generated/agent-harness/types.gen';
|
|
3
|
+
import type { RoxClient } from '../../utils/client';
|
|
4
|
+
import type { Agent } from '../agents/agent';
|
|
5
|
+
import type { Channel } from '../channels/channel';
|
|
6
|
+
import { RoxEntity } from '../entity';
|
|
7
|
+
import { EntityAccess } from '../sharing/access';
|
|
8
|
+
import { type SharePermissionOptions } from '../sharing/permissions';
|
|
9
|
+
import { Task } from '../tasks/task';
|
|
10
|
+
import { User } from '../users/user';
|
|
11
|
+
import { type AgentActivityOptions, AgentInvocation } from './activity';
|
|
12
|
+
import { CodeExecution } from './code-execution';
|
|
13
|
+
import { type SessionOrigin } from './origin';
|
|
14
|
+
import { QueuedAction } from './queued-action';
|
|
15
|
+
import { type CreateReviewOptions, SessionReview } from './review';
|
|
16
|
+
import { ToolApproval } from './tool-approval';
|
|
17
|
+
import { type SessionView } from './view';
|
|
18
|
+
export type { ArchiveCause };
|
|
19
|
+
/**
|
|
20
|
+
* One session's auto-archive choices. A trigger left `undefined` follows the
|
|
21
|
+
* owner's default.
|
|
22
|
+
*/
|
|
23
|
+
export type AutoArchiveOverrides = {
|
|
24
|
+
/** Archive once every linked pull request is closed and at least one merged. */
|
|
25
|
+
onPullRequestMerged?: boolean;
|
|
26
|
+
/** Archive once the runtime session backing it is deliberately closed. */
|
|
27
|
+
onRuntimeClosed?: boolean;
|
|
28
|
+
};
|
|
29
|
+
/** A session's auto-archive settings, and when a trigger archived it. */
|
|
30
|
+
export type SessionAutoArchive = {
|
|
31
|
+
/** The session's own choices. */
|
|
32
|
+
overrides: AutoArchiveOverrides;
|
|
33
|
+
/** The owner's defaults, which apply where the session has no choice. */
|
|
34
|
+
defaults: AutoArchivePreferencesBody;
|
|
35
|
+
/**
|
|
36
|
+
* When a trigger first archived the session, if one did. It stays after the
|
|
37
|
+
* session is unarchived, since a session archives itself at most once.
|
|
38
|
+
*/
|
|
39
|
+
autoArchivedAt?: string;
|
|
40
|
+
};
|
|
41
|
+
/** A session's history folded into readable messages, oldest first. */
|
|
42
|
+
export type FoldedAgentSessionLog = {
|
|
43
|
+
/** The agent that sent every agent message. */
|
|
44
|
+
bot: SessionBot;
|
|
45
|
+
/**
|
|
46
|
+
* Prompts and replies with their tool calls, results, plans, permission
|
|
47
|
+
* requests and how each turn ended.
|
|
48
|
+
*/
|
|
49
|
+
messages: FoldedMessage[];
|
|
50
|
+
};
|
|
51
|
+
/** A GitHub pull request linked to a session. */
|
|
52
|
+
/** An agent session an account registered as its work. */
|
|
53
|
+
export type RegisteredWork = {
|
|
54
|
+
/** The session registered. */
|
|
55
|
+
session: AgentSession;
|
|
56
|
+
/** The account whose work this is. */
|
|
57
|
+
account: User;
|
|
58
|
+
/** When the account registered it. */
|
|
59
|
+
registeredAt: string;
|
|
60
|
+
};
|
|
61
|
+
export type SessionPullRequest = {
|
|
62
|
+
/** The pull request's `owner/repo/pull/number` key. */
|
|
63
|
+
githubKey: string;
|
|
64
|
+
/** The pull request's GitHub URL. */
|
|
65
|
+
url: string;
|
|
66
|
+
/** Whether the session's agent opened it or a person linked it. */
|
|
67
|
+
source: PullRequestLinkSource;
|
|
68
|
+
/** Who linked it, for pull requests a person linked. */
|
|
69
|
+
linkedBy?: User;
|
|
70
|
+
/** When it was linked. */
|
|
71
|
+
createdAt: string;
|
|
72
|
+
};
|
|
73
|
+
/** A request a session is waiting on its owner to answer, or a session gone quiet. */
|
|
74
|
+
export type AgentSessionUpdate = {
|
|
75
|
+
/** The session. */
|
|
76
|
+
session: AgentSession;
|
|
77
|
+
/** The session's name. */
|
|
78
|
+
sessionName: string;
|
|
79
|
+
/** The runtime the session runs on. */
|
|
80
|
+
harness: string;
|
|
81
|
+
/** The session's pull request, if it has one. */
|
|
82
|
+
pullRequestUrl?: string;
|
|
83
|
+
/**
|
|
84
|
+
* What the session waits for: `permission` to run a tool, an `elicitation`
|
|
85
|
+
* question, a held `tool_approval`, or `stalled` with no activity for over
|
|
86
|
+
* 20 minutes.
|
|
87
|
+
*/
|
|
88
|
+
kind: AgentUpdateKind;
|
|
89
|
+
/** What is asked, or why the session looks stalled. */
|
|
90
|
+
summary: string;
|
|
91
|
+
/** When the request was made, or the session's last activity. */
|
|
92
|
+
since: string;
|
|
93
|
+
/** The choices a permission request offers; empty for other kinds. */
|
|
94
|
+
options: string[];
|
|
95
|
+
};
|
|
96
|
+
/** The caller's sessions waiting for them, newest activity first. */
|
|
97
|
+
export type AgentSessionUpdates = {
|
|
98
|
+
/** One entry per pending request or stalled session. */
|
|
99
|
+
items: AgentSessionUpdate[];
|
|
100
|
+
/** Whether sessions beyond the 25 most recent were left out. */
|
|
101
|
+
truncated: boolean;
|
|
102
|
+
/** Says what was left out, when truncated. */
|
|
103
|
+
truncationNotice?: string;
|
|
104
|
+
};
|
|
105
|
+
/** A tool call the session's runtime holds until its owner answers. */
|
|
106
|
+
export type PendingToolApproval = {
|
|
107
|
+
/** Answer it with {@link ToolApproval.answer}. */
|
|
108
|
+
approval: ToolApproval;
|
|
109
|
+
/** What a person calls the server the tool is on. */
|
|
110
|
+
serverName: string;
|
|
111
|
+
/** The tool called. */
|
|
112
|
+
toolName: string;
|
|
113
|
+
/** What it was called with. */
|
|
114
|
+
arguments: unknown;
|
|
115
|
+
/** Who prompted the turn; absent for a bot on nobody's behalf. */
|
|
116
|
+
requestedBy?: User;
|
|
117
|
+
};
|
|
118
|
+
/** The task a session is linked to. */
|
|
119
|
+
export type LinkedTask = {
|
|
120
|
+
/** The task. */
|
|
121
|
+
task: Task;
|
|
122
|
+
/** Put this in the pull request description so GitHub activity reaches the task. */
|
|
123
|
+
reference: string;
|
|
124
|
+
/** The session's pull request, now linked to the task, if it has one. */
|
|
125
|
+
pullRequestUrl?: string;
|
|
126
|
+
};
|
|
127
|
+
/** A GitHub repository the caller can point a managed session at. */
|
|
128
|
+
export type SelectableRepository = {
|
|
129
|
+
/** The canonical `https://github.com/owner/name` URL, as `createManaged` takes it. */
|
|
130
|
+
url: string;
|
|
131
|
+
/**
|
|
132
|
+
* The branch its clones check out, and where a session starts unless
|
|
133
|
+
* `createManaged` names another. Absent for a repository with no commits.
|
|
134
|
+
*/
|
|
135
|
+
defaultBranch?: string;
|
|
136
|
+
};
|
|
137
|
+
/** What a managed session is created with. */
|
|
138
|
+
export type CreateManagedSessionOptions = {
|
|
139
|
+
/**
|
|
140
|
+
* Persona the session runs as, from {@link AgentNamespace.coding} or
|
|
141
|
+
* {@link AgentNamespace.list}. The caller must be able to use it. Omitted, the
|
|
142
|
+
* deployment's default coding persona, or Cursor when `repoUrl` is set.
|
|
143
|
+
* Its harness, instructions and model apply unless `instructions` or
|
|
144
|
+
* `model` override them.
|
|
145
|
+
*/
|
|
146
|
+
agent?: Agent;
|
|
147
|
+
/** First prompt to deliver once the session is running. */
|
|
148
|
+
prompt?: string;
|
|
149
|
+
/**
|
|
150
|
+
* Instructions the session's runtime works under, fixed for its life.
|
|
151
|
+
* Outranks the persona's when both are set.
|
|
152
|
+
*/
|
|
153
|
+
instructions?: string;
|
|
154
|
+
/**
|
|
155
|
+
* The model the session runs on, instead of its persona's. The session's
|
|
156
|
+
* model from creation, read back as {@link AgentSession.model}.
|
|
157
|
+
*/
|
|
158
|
+
model?: string;
|
|
159
|
+
/**
|
|
160
|
+
* The repository the session works on, as one of the URLs
|
|
161
|
+
* {@link AgentSession.repositories} lists for the caller. Omitted, the
|
|
162
|
+
* runtime chooses from the prompt. Honored for Cursor sessions; omit
|
|
163
|
+
* `agent` and the session starts as Cursor.
|
|
164
|
+
*/
|
|
165
|
+
repoUrl?: string;
|
|
166
|
+
/**
|
|
167
|
+
* The branch the session starts on; needs `repoUrl`. Omitted, the
|
|
168
|
+
* repository's default branch.
|
|
169
|
+
*/
|
|
170
|
+
repoBranch?: string;
|
|
171
|
+
};
|
|
172
|
+
/** A managed or externally hosted coding-agent session. */
|
|
173
|
+
export declare class AgentSession extends RoxEntity<AgentSessionResponse> {
|
|
174
|
+
/** Access requests and direct user grants. */
|
|
175
|
+
readonly access: EntityAccess;
|
|
176
|
+
/**
|
|
177
|
+
* Share this agent session with a channel's current members, as posting it in the
|
|
178
|
+
* channel does. The caller must be in the channel and able to share the
|
|
179
|
+
* agent session; sharing again changes nothing.
|
|
180
|
+
*
|
|
181
|
+
* @write
|
|
182
|
+
* @idempotent
|
|
183
|
+
*/
|
|
184
|
+
shareWithChannel(channel: Channel): Promise<void>;
|
|
185
|
+
/**
|
|
186
|
+
* Construct an approval handle scoped to this session.
|
|
187
|
+
*
|
|
188
|
+
* @readonly
|
|
189
|
+
*/
|
|
190
|
+
toolApprovalById(id: string): ToolApproval;
|
|
191
|
+
/**
|
|
192
|
+
* Sharing configuration.
|
|
193
|
+
*
|
|
194
|
+
* @readonly
|
|
195
|
+
*/
|
|
196
|
+
sharePermissions(): Promise<import("../../../generated/agent-harness").SharePermissionV2>;
|
|
197
|
+
/**
|
|
198
|
+
* Replace sharing grants.
|
|
199
|
+
*
|
|
200
|
+
* @write
|
|
201
|
+
* @idempotent
|
|
202
|
+
*/
|
|
203
|
+
updateSharePermissions(options: SharePermissionOptions): Promise<import("../../../generated/agent-harness").SharePermissionV2>;
|
|
204
|
+
/**
|
|
205
|
+
* The session's URL in the Rox web app; hand it to users as the link.
|
|
206
|
+
*
|
|
207
|
+
* @readonly
|
|
208
|
+
*/
|
|
209
|
+
webUrl(): string;
|
|
210
|
+
/** Identity, loaded detail and {@link webUrl}, so serialized handles carry their link. */
|
|
211
|
+
toJSON(): {
|
|
212
|
+
url: string;
|
|
213
|
+
id: string;
|
|
214
|
+
detail?: AgentSessionResponse | undefined;
|
|
215
|
+
};
|
|
216
|
+
/** A handle to an agent session by id. Details load on first access. */
|
|
217
|
+
static byId(client: RoxClient, id: string): AgentSession;
|
|
218
|
+
/**
|
|
219
|
+
* Create a managed session as `agent` when one is named, otherwise the
|
|
220
|
+
* deployment's default coding persona. List personas with
|
|
221
|
+
* {@link AgentNamespace.list} and construct one with {@link Agent.byId}.
|
|
222
|
+
* Unknown or inaccessible personas fail. `model` and `instructions`
|
|
223
|
+
* outrank the persona's. `repoUrl` is honored for Cursor; omit `agent`
|
|
224
|
+
* and it starts as Cursor.
|
|
225
|
+
*/
|
|
226
|
+
static createManaged(client: RoxClient, opts?: CreateManagedSessionOptions): Promise<AgentSession>;
|
|
227
|
+
/**
|
|
228
|
+
* List repositories available for managed sessions.
|
|
229
|
+
*
|
|
230
|
+
* Includes every repository under an installation of Rox's GitHub App they or their
|
|
231
|
+
* teams made, sorted by `owner/name`. Empty when the App is installed
|
|
232
|
+
* nowhere they reach.
|
|
233
|
+
*/
|
|
234
|
+
static repositories(client: RoxClient): Promise<SelectableRepository[]>;
|
|
235
|
+
/**
|
|
236
|
+
* Branch names on one repository the caller can start a managed session
|
|
237
|
+
* from, in the order GitHub listed them. Empty when the repository has
|
|
238
|
+
* no commits yet. `repoUrl` is one of the URLs {@link AgentSession.repositories}
|
|
239
|
+
* lists.
|
|
240
|
+
*/
|
|
241
|
+
static repositoryBranches(client: RoxClient, repoUrl: string): Promise<string[]>;
|
|
242
|
+
/**
|
|
243
|
+
* Whether `prompt` needs a chat agent or a coding agent, as the app's Auto
|
|
244
|
+
* mode decides before starting a session. Rejects when Auto mode is not
|
|
245
|
+
* enabled for the caller, the classifier is unavailable or slow, or the
|
|
246
|
+
* caller is out of AI quota.
|
|
247
|
+
*/
|
|
248
|
+
static chooseMode(client: RoxClient, prompt: string): Promise<AgentMode>;
|
|
249
|
+
protected fetch(): Promise<AgentSessionResponse>;
|
|
250
|
+
/** The session's user-facing display name. */
|
|
251
|
+
readonly name: () => Promise<string>;
|
|
252
|
+
/**
|
|
253
|
+
* What opened the session: who or what started it, and what it is about.
|
|
254
|
+
* Readable by anyone who can view the session, including other agents.
|
|
255
|
+
*
|
|
256
|
+
* @readonly
|
|
257
|
+
*/
|
|
258
|
+
origin(): Promise<SessionOrigin>;
|
|
259
|
+
/**
|
|
260
|
+
* Who archived the session, making it read-only: `'user'`,
|
|
261
|
+
* `'pull_request_merged'` or `'runtime_closed'`. `undefined` while it is not
|
|
262
|
+
* archived.
|
|
263
|
+
*/
|
|
264
|
+
readonly archivedBy: () => Promise<NonNullable<ArchiveCause | null | undefined> | undefined>;
|
|
265
|
+
/** When the session was archived (RFC 3339), or `undefined` while it is not. */
|
|
266
|
+
readonly archivedAt: () => Promise<string | undefined>;
|
|
267
|
+
/** The model currently configured for the session. */
|
|
268
|
+
readonly model: () => Promise<string>;
|
|
269
|
+
/** The agent harness implementation serving the session. */
|
|
270
|
+
readonly harness: () => Promise<string>;
|
|
271
|
+
/** The repository the agent works with, when one was supplied. */
|
|
272
|
+
readonly repoUrl: () => Promise<string | undefined>;
|
|
273
|
+
/** The directory in which the agent harness runs. */
|
|
274
|
+
readonly workspace: () => Promise<string>;
|
|
275
|
+
/**
|
|
276
|
+
* Instructions the session's runtime works under, when any were stated at
|
|
277
|
+
* creation. Fixed for the session's life.
|
|
278
|
+
*/
|
|
279
|
+
readonly instructions: () => Promise<string | undefined>;
|
|
280
|
+
/** The session's latest runtime status. */
|
|
281
|
+
readonly status: () => Promise<import("../../../generated/agent-harness").SessionStatusDto>;
|
|
282
|
+
/** Compute tier of the managed sandbox. */
|
|
283
|
+
readonly sandboxSize: () => Promise<SandboxSize>;
|
|
284
|
+
/** When the session was created. */
|
|
285
|
+
readonly createdAt: () => Promise<string>;
|
|
286
|
+
/** When the session was last modified. */
|
|
287
|
+
readonly modifiedAt: () => Promise<string>;
|
|
288
|
+
/**
|
|
289
|
+
* The sessions linked to the GitHub pull request at `url` that the caller
|
|
290
|
+
* can view, oldest link first.
|
|
291
|
+
*/
|
|
292
|
+
static forPullRequest(client: RoxClient, url: string): Promise<AgentSession[]>;
|
|
293
|
+
/**
|
|
294
|
+
* The caller's coding sessions waiting for an answer from them, or stalled
|
|
295
|
+
* for over 20 minutes, newest activity first. Only the 25 most recent such
|
|
296
|
+
* sessions are inspected.
|
|
297
|
+
*/
|
|
298
|
+
static updates(client: RoxClient): Promise<AgentSessionUpdates>;
|
|
299
|
+
/**
|
|
300
|
+
* Tool calls this session's runtime holds until its owner approves them,
|
|
301
|
+
* oldest first. Answer each with {@link ToolApproval.answer}; only the
|
|
302
|
+
* owner may approve or decline. Permission requests and questions from the
|
|
303
|
+
* agent itself are answered with {@link control}.
|
|
304
|
+
*
|
|
305
|
+
* @readonly
|
|
306
|
+
*/
|
|
307
|
+
pendingApprovals(): Promise<PendingToolApproval[]>;
|
|
308
|
+
/**
|
|
309
|
+
* Link this session to the task it works on, replacing any earlier link.
|
|
310
|
+
* Only the session's owner can link it, to a task they can view. The
|
|
311
|
+
* session's pull request, now or later, is linked to the task too.
|
|
312
|
+
*
|
|
313
|
+
* @write
|
|
314
|
+
*/
|
|
315
|
+
linkTask(task: Task): Promise<LinkedTask>;
|
|
316
|
+
/**
|
|
317
|
+
* The GitHub pull requests linked to this session: the one its agent
|
|
318
|
+
* opened and any a person linked, oldest first.
|
|
319
|
+
*
|
|
320
|
+
* @readonly
|
|
321
|
+
*/
|
|
322
|
+
pullRequests(): Promise<SessionPullRequest[]>;
|
|
323
|
+
/**
|
|
324
|
+
* Link the GitHub pull request at `url` to this session. Linking one that
|
|
325
|
+
* is already linked changes nothing.
|
|
326
|
+
*
|
|
327
|
+
* @write
|
|
328
|
+
* @idempotent
|
|
329
|
+
*/
|
|
330
|
+
linkPullRequest(url: string): Promise<void>;
|
|
331
|
+
/**
|
|
332
|
+
* Unlink a GitHub pull request a person linked to this session. The pull
|
|
333
|
+
* request the session's agent opened stays linked.
|
|
334
|
+
*
|
|
335
|
+
* @write
|
|
336
|
+
* @idempotent
|
|
337
|
+
*/
|
|
338
|
+
unlinkPullRequest(url: string): Promise<void>;
|
|
339
|
+
/**
|
|
340
|
+
* This session's auto-archive settings, and when a trigger archived it.
|
|
341
|
+
*
|
|
342
|
+
* @readonly
|
|
343
|
+
*/
|
|
344
|
+
autoArchive(): Promise<SessionAutoArchive>;
|
|
345
|
+
/**
|
|
346
|
+
* Replace this session's auto-archive choices. Owner only; a trigger left
|
|
347
|
+
* `undefined` follows the owner's default.
|
|
348
|
+
*
|
|
349
|
+
* @write
|
|
350
|
+
* @idempotent
|
|
351
|
+
*/
|
|
352
|
+
setAutoArchive(overrides: AutoArchiveOverrides): Promise<void>;
|
|
353
|
+
/**
|
|
354
|
+
* Rename this session.
|
|
355
|
+
*
|
|
356
|
+
* @write
|
|
357
|
+
* @idempotent
|
|
358
|
+
*/
|
|
359
|
+
rename(name: string): Promise<void>;
|
|
360
|
+
/**
|
|
361
|
+
* Register this session as the caller's work, so it shows as what the caller
|
|
362
|
+
* is working on. Requires edit access. Registering again changes nothing.
|
|
363
|
+
*
|
|
364
|
+
* Registering does not share the session: a viewer who cannot open it does
|
|
365
|
+
* not see it, so share it too with {@link AgentSession.updateSharePermissions}.
|
|
366
|
+
*
|
|
367
|
+
* The registration ends on its own when the session's pull requests finish,
|
|
368
|
+
* when it is archived, after a day without work, or after a week blocked on
|
|
369
|
+
* input. A later turn does not register it again.
|
|
370
|
+
*
|
|
371
|
+
* @write
|
|
372
|
+
* @idempotent
|
|
373
|
+
*/
|
|
374
|
+
registerAsWork(): Promise<RegisteredWork>;
|
|
375
|
+
/**
|
|
376
|
+
* End the caller's registration of this session as its work. Doing it again
|
|
377
|
+
* changes nothing. The session itself is untouched.
|
|
378
|
+
*
|
|
379
|
+
* @write
|
|
380
|
+
* @idempotent
|
|
381
|
+
*/
|
|
382
|
+
unregisterAsWork(): Promise<void>;
|
|
383
|
+
/** The caller's active registrations, newest first. */
|
|
384
|
+
static listRegisteredWork(client: RoxClient): Promise<RegisteredWork[]>;
|
|
385
|
+
private static registeredWork;
|
|
386
|
+
/**
|
|
387
|
+
* Archive this session, making it read-only until unarchived.
|
|
388
|
+
*
|
|
389
|
+
* @write
|
|
390
|
+
* @idempotent
|
|
391
|
+
*/
|
|
392
|
+
archive(): Promise<void>;
|
|
393
|
+
/**
|
|
394
|
+
* Restore an archived session so it can be edited and prompted again.
|
|
395
|
+
*
|
|
396
|
+
* @write
|
|
397
|
+
* @idempotent
|
|
398
|
+
*/
|
|
399
|
+
unarchive(): Promise<void>;
|
|
400
|
+
private setArchived;
|
|
401
|
+
/**
|
|
402
|
+
* Resize this session's sandbox and remember the size as the owner's default.
|
|
403
|
+
*
|
|
404
|
+
* @write
|
|
405
|
+
* @idempotent
|
|
406
|
+
*/
|
|
407
|
+
setSandboxSize(size: SandboxSize): Promise<SandboxSize>;
|
|
408
|
+
/** The caller's default sandbox size for new `@coder` sessions. */
|
|
409
|
+
static defaultSandboxSize(client: RoxClient): Promise<SandboxSize>;
|
|
410
|
+
/** Set the caller's default sandbox size for the next `@coder` mention. */
|
|
411
|
+
static setDefaultSandboxSize(client: RoxClient, size: SandboxSize): Promise<SandboxSize>;
|
|
412
|
+
/** What the caller's new coding sessions are told to do beyond their assignment. */
|
|
413
|
+
static codingPreferences(client: RoxClient): Promise<CodingPreferencesBody>;
|
|
414
|
+
/** Which triggers archive the caller's sessions by default; each is off unless chosen. */
|
|
415
|
+
static autoArchivePreferences(client: RoxClient): Promise<AutoArchivePreferencesBody>;
|
|
416
|
+
/** Replace which triggers archive the caller's sessions by default. */
|
|
417
|
+
static setAutoArchivePreferences(client: RoxClient, preferences: AutoArchivePreferencesBody): Promise<AutoArchivePreferencesBody>;
|
|
418
|
+
/** Replace the caller's coding preferences. */
|
|
419
|
+
static setCodingPreferences(client: RoxClient, preferences: CodingPreferencesBody): Promise<CodingPreferencesBody>;
|
|
420
|
+
/**
|
|
421
|
+
* Send a prompt or lifecycle operation to the live agent session.
|
|
422
|
+
*
|
|
423
|
+
* The returned `actionId` matches `requestId` on the folded message the
|
|
424
|
+
* action derives once it dispatches. A `queued` status means a turn was
|
|
425
|
+
* running: the action waits in the session's queue ({@link queue}) and
|
|
426
|
+
* dispatches when that turn ends.
|
|
427
|
+
*
|
|
428
|
+
* @destructive
|
|
429
|
+
* @openworld
|
|
430
|
+
*/
|
|
431
|
+
control(action: AgentAction): Promise<ControlResponse>;
|
|
432
|
+
/**
|
|
433
|
+
* Send a prompt to the session — sugar over {@link control}.
|
|
434
|
+
*
|
|
435
|
+
* `attachments` are files the prompt refers to, each by a URL the agent
|
|
436
|
+
* can fetch (a static file service URL in practice); they reach the agent
|
|
437
|
+
* as ACP `resource_link` blocks after the text.
|
|
438
|
+
*
|
|
439
|
+
* @destructive
|
|
440
|
+
* @openworld
|
|
441
|
+
*/
|
|
442
|
+
prompt(text: string, attachments?: PromptAttachment[]): Promise<ControlResponse>;
|
|
443
|
+
/**
|
|
444
|
+
* The actions waiting to dispatch in this session, oldest first. Each can
|
|
445
|
+
* be edited or removed until it dispatches.
|
|
446
|
+
*
|
|
447
|
+
* @readonly
|
|
448
|
+
*/
|
|
449
|
+
queue(): Promise<QueuedAction[]>;
|
|
450
|
+
/**
|
|
451
|
+
* Read the latest captured GitHub pull request changes and capture status.
|
|
452
|
+
*
|
|
453
|
+
* @readonly
|
|
454
|
+
*/
|
|
455
|
+
changes(): Promise<AgentSessionChangesResponse>;
|
|
456
|
+
/**
|
|
457
|
+
* Read the unified diff of the latest captured changeset.
|
|
458
|
+
*
|
|
459
|
+
* @readonly
|
|
460
|
+
*/
|
|
461
|
+
changesPatch(): Promise<string>;
|
|
462
|
+
/**
|
|
463
|
+
* Request a fresh capture and return the current state while it runs.
|
|
464
|
+
*
|
|
465
|
+
* @write
|
|
466
|
+
* @idempotent
|
|
467
|
+
* @openworld
|
|
468
|
+
*/
|
|
469
|
+
refreshChanges(): Promise<AgentSessionChangesResponse>;
|
|
470
|
+
/**
|
|
471
|
+
* Read this session's full conversation as the app renders it.
|
|
472
|
+
*
|
|
473
|
+
* Includes each user prompt and agent reply, oldest first, with tool calls and their
|
|
474
|
+
* results, plans, permission requests and how each turn ended. Works on any
|
|
475
|
+
* session the caller can view, live or finished, so it is the way to read
|
|
476
|
+
* what another agent session did. Prefer it to {@link log}, which returns
|
|
477
|
+
* raw protocol frames.
|
|
478
|
+
*
|
|
479
|
+
* @readonly
|
|
480
|
+
*/
|
|
481
|
+
foldedLog(): Promise<FoldedAgentSessionLog>;
|
|
482
|
+
/**
|
|
483
|
+
* Read the complete raw protocol log for this session.
|
|
484
|
+
*
|
|
485
|
+
* @readonly
|
|
486
|
+
*/
|
|
487
|
+
log(): Promise<AgentSessionLogResponse>;
|
|
488
|
+
/** Persisted reviews scoped to this session, with or without a code execution. */
|
|
489
|
+
readonly reviews: {
|
|
490
|
+
create: (input: CreateReviewOptions) => Promise<SessionReview>;
|
|
491
|
+
byId: (id: string) => SessionReview;
|
|
492
|
+
};
|
|
493
|
+
/** Views shown in this session at once, with nothing saved. */
|
|
494
|
+
readonly views: {
|
|
495
|
+
present: (view: SessionView) => Promise<void>;
|
|
496
|
+
};
|
|
497
|
+
/** Saved code executions scoped to this session. Handle construction makes no request. */
|
|
498
|
+
readonly codeExecutions: {
|
|
499
|
+
byId: (id: string) => CodeExecution;
|
|
500
|
+
};
|
|
501
|
+
/**
|
|
502
|
+
* Recorded activity caused by this session, lazily paginated newest first; `maxItems` caps the total.
|
|
503
|
+
*
|
|
504
|
+
* @readonly
|
|
505
|
+
*/
|
|
506
|
+
activity(options?: AgentActivityOptions): AsyncGenerator<import("./activity").AgentActivity, any, any>;
|
|
507
|
+
/** Code-mode invocation handles, distinct from saved code executions. */
|
|
508
|
+
readonly invocations: {
|
|
509
|
+
byId: (id: string) => AgentInvocation;
|
|
510
|
+
};
|
|
511
|
+
/**
|
|
512
|
+
* Delete this session and any live resources it owns.
|
|
513
|
+
*
|
|
514
|
+
* @destructive
|
|
515
|
+
* @idempotent
|
|
516
|
+
*/
|
|
517
|
+
delete(): Promise<void>;
|
|
518
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import type { ExecutionRecord } from '../../../generated/agent-harness/types.gen';
|
|
2
|
+
import type { RoxClient } from '../../utils/client';
|
|
3
|
+
import { RoxEntity } from '../entity';
|
|
4
|
+
import type { AgentSession } from './agent-session';
|
|
5
|
+
import { type CreateReviewOptions, SessionReview } from './review';
|
|
6
|
+
import { type SessionView } from './view';
|
|
7
|
+
/** A saved code execution belonging to one agent session. */
|
|
8
|
+
export declare class CodeExecution extends RoxEntity<ExecutionRecord> {
|
|
9
|
+
private readonly parent;
|
|
10
|
+
private constructor();
|
|
11
|
+
/** Construct a lazy execution handle within its owning session. */
|
|
12
|
+
static byId(client: RoxClient, session: AgentSession, id: string): CodeExecution;
|
|
13
|
+
protected fetch(): Promise<ExecutionRecord>;
|
|
14
|
+
/** Persistent UI blocks, independent of the execution lifetime. */
|
|
15
|
+
readonly reviews: {
|
|
16
|
+
create: (input: CreateReviewOptions) => Promise<SessionReview>;
|
|
17
|
+
list: () => Promise<SessionReview[]>;
|
|
18
|
+
};
|
|
19
|
+
/** Views: shown to the user at once, with nothing saved. */
|
|
20
|
+
readonly views: {
|
|
21
|
+
present: (view: SessionView) => Promise<void>;
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
* The session this execution belongs to.
|
|
25
|
+
*
|
|
26
|
+
* @readonly
|
|
27
|
+
*/
|
|
28
|
+
session(): AgentSession;
|
|
29
|
+
/** Saved execution state. Call refresh to observe subsequent changes. */
|
|
30
|
+
readonly status: () => Promise<import("../../../generated/agent-harness").ExecutionStatus>;
|
|
31
|
+
/** The submitted JavaScript module source. */
|
|
32
|
+
readonly source: () => Promise<string>;
|
|
33
|
+
/** Legacy bridge calls; direct HTTP executions leave this empty. */
|
|
34
|
+
readonly calls: () => Promise<import("../../../generated/agent-harness").RecordedToolCall[]>;
|
|
35
|
+
/** Execution failure text, when present. */
|
|
36
|
+
readonly error: () => Promise<string | undefined>;
|
|
37
|
+
/**
|
|
38
|
+
* The program's returned JSON; preserves an explicit null result.
|
|
39
|
+
*
|
|
40
|
+
* @readonly
|
|
41
|
+
*/
|
|
42
|
+
result(): Promise<unknown>;
|
|
43
|
+
/**
|
|
44
|
+
* Reload the saved state, for example after a running execution completes.
|
|
45
|
+
*
|
|
46
|
+
* @readonly
|
|
47
|
+
*/
|
|
48
|
+
refresh(): Promise<this>;
|
|
49
|
+
}
|
|
50
|
+
/** JSON data returned to the model, plus references to independently saved UI. */
|
|
51
|
+
export type CodeResult = {
|
|
52
|
+
data: JsonValue;
|
|
53
|
+
reviews: Array<{
|
|
54
|
+
kind: 'email' | 'calendar';
|
|
55
|
+
id: string;
|
|
56
|
+
}>;
|
|
57
|
+
};
|
|
58
|
+
export type JsonValue = null | boolean | number | string | JsonValue[] | {
|
|
59
|
+
[key: string]: JsonValue;
|
|
60
|
+
};
|