copilotz 1.0.0-rc.2 → 1.0.0-rc.21
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/CHANGELOG.md +927 -0
- package/README.md +351 -35
- package/hosts/orgs/mod.d.ts +29 -3
- package/hosts/orgs/mod.js +135 -12
- package/hosts/web/files.d.ts +6 -2
- package/hosts/web/files.js +36 -3
- package/hosts/web/mod.d.ts +1 -1
- package/hosts/web/mod.js +1 -1
- package/hosts/web/node/mod.d.ts +1 -1
- package/hosts/web/node/mod.js +1 -1
- package/hosts/web/node/serve.d.ts +26 -0
- package/hosts/web/node/serve.js +27 -2
- package/hosts/web/orgs.d.ts +36 -0
- package/hosts/web/orgs.js +21 -3
- package/hosts/web/pwa.js +1 -1
- package/hosts/web/routes.d.ts +90 -6
- package/hosts/web/routes.js +190 -34
- package/hosts/web/server.d.ts +13 -2
- package/hosts/web/server.js +12 -4
- package/hosts/web/style.d.ts +1 -1
- package/hosts/web/style.js +10 -0
- package/hosts/web/toolkit/button.js +6 -0
- package/hosts/web/toolkit/copy-button.js +4 -0
- package/hosts/web/toolkit/icon-button.js +6 -0
- package/hosts/web/toolkit/icon.d.ts +1 -0
- package/hosts/web/toolkit/icon.js +2 -0
- package/hosts/web/toolkit/input.js +6 -0
- package/hosts/web/toolkit/time.js +2 -1
- package/package.json +10 -6
- package/plugins/access/accounts/actions/complete.js +2 -2
- package/plugins/access/accounts/actions/connect.js +2 -2
- package/plugins/access/accounts/actions/disconnect.js +2 -2
- package/plugins/access/accounts/actions/model-key.d.ts +5 -0
- package/plugins/access/accounts/actions/model-key.js +102 -0
- package/plugins/access/accounts/collections/account.d.ts +2 -2
- package/plugins/access/accounts/collections/account.js +1 -2
- package/plugins/access/accounts/collections/flow.d.ts +1 -1
- package/plugins/access/accounts/collections/model-key.d.ts +58 -0
- package/plugins/access/accounts/collections/model-key.js +17 -0
- package/plugins/access/accounts/mod.d.ts +5 -0
- package/plugins/access/accounts/mod.js +14 -1
- package/plugins/access/accounts/resources/models.js +2 -0
- package/plugins/access/accounts/shared/rules.js +1 -1
- package/plugins/access/accounts/shared/settings.js +2 -2
- package/plugins/access/contacts/actions/chat.d.ts +1 -0
- package/plugins/access/contacts/actions/chat.js +45 -0
- package/plugins/access/contacts/actions/forget.d.ts +1 -0
- package/plugins/access/contacts/actions/forget.js +56 -0
- package/plugins/access/contacts/actions/start.d.ts +1 -0
- package/plugins/access/contacts/actions/start.js +50 -0
- package/plugins/access/contacts/collections/contact.d.ts +81 -0
- package/plugins/access/contacts/collections/contact.js +58 -0
- package/plugins/access/contacts/contract.d.ts +10 -0
- package/plugins/access/contacts/contract.js +10 -0
- package/plugins/access/contacts/mod.d.ts +27 -0
- package/plugins/access/contacts/mod.js +49 -0
- package/plugins/access/contacts/views/contact.d.ts +8 -0
- package/plugins/access/contacts/views/contact.js +25 -0
- package/plugins/access/contacts/web.d.ts +7 -0
- package/plugins/access/contacts/web.js +11 -0
- package/plugins/access/directory/actions/code.d.ts +4 -0
- package/plugins/access/directory/actions/code.js +135 -0
- package/plugins/access/directory/actions/host.d.ts +2 -0
- package/plugins/access/directory/actions/host.js +54 -0
- package/plugins/access/directory/actions/invite.js +1 -2
- package/plugins/access/directory/actions/org.js +19 -9
- package/plugins/access/directory/collections/credit-code.d.ts +114 -0
- package/plugins/access/directory/collections/credit-code.js +28 -0
- package/plugins/access/directory/collections/invite.d.ts +1 -1
- package/plugins/access/directory/collections/org-host.d.ts +61 -0
- package/plugins/access/directory/collections/org-host.js +29 -0
- package/plugins/access/directory/collections/org.d.ts +3 -3
- package/plugins/access/directory/mod.d.ts +4 -1
- package/plugins/access/directory/mod.js +13 -2
- package/plugins/access/identity/actions/key.js +3 -3
- package/plugins/access/identity/actions/session.js +2 -2
- package/plugins/access/identity/collections/credential.d.ts +1 -1
- package/plugins/access/identity/collections/credential.js +2 -2
- package/plugins/access/identity/mod.js +8 -6
- package/plugins/access/mod.d.ts +7 -1
- package/plugins/access/mod.js +7 -2
- package/plugins/access/spaces/actions/agents.js +15 -12
- package/plugins/access/spaces/actions/archive.js +4 -5
- package/plugins/access/spaces/actions/can.js +4 -4
- package/plugins/access/spaces/actions/create.js +12 -3
- package/plugins/access/spaces/actions/invitation.js +16 -13
- package/plugins/access/spaces/actions/keep.d.ts +1 -0
- package/plugins/access/spaces/actions/keep.js +55 -0
- package/plugins/access/spaces/actions/leave.js +2 -2
- package/plugins/access/spaces/actions/member.js +46 -38
- package/plugins/access/spaces/actions/org.d.ts +1 -0
- package/plugins/access/spaces/actions/org.js +26 -17
- package/plugins/access/spaces/actions/personal.js +5 -2
- package/plugins/access/spaces/actions/rename.js +8 -5
- package/plugins/access/spaces/actions/request.js +8 -13
- package/plugins/access/spaces/actions/share.js +2 -3
- package/plugins/access/spaces/collections/invitation.js +2 -2
- package/plugins/access/spaces/collections/member.d.ts +1 -1
- package/plugins/access/spaces/collections/profile.d.ts +61 -0
- package/plugins/access/spaces/collections/profile.js +54 -0
- package/plugins/access/spaces/collections/request.d.ts +1 -1
- package/plugins/access/spaces/collections/request.js +2 -2
- package/plugins/access/spaces/collections/space.d.ts +9 -0
- package/plugins/access/spaces/collections/space.js +33 -4
- package/plugins/access/spaces/contract.d.ts +50 -6
- package/plugins/access/spaces/contract.js +3 -0
- package/plugins/access/spaces/mod.d.ts +12 -1
- package/plugins/access/spaces/mod.js +26 -3
- package/plugins/access/spaces/processors/profile.d.ts +7 -0
- package/plugins/access/spaces/processors/profile.js +10 -0
- package/plugins/access/spaces/resources/commands.js +14 -4
- package/plugins/access/spaces/resources/tools.d.ts +0 -5
- package/plugins/access/spaces/resources/tools.js +14 -2
- package/plugins/access/spaces/shared/agents.js +2 -2
- package/plugins/access/spaces/shared/can.d.ts +27 -0
- package/plugins/access/spaces/shared/can.js +51 -0
- package/plugins/access/spaces/shared/declared.d.ts +21 -0
- package/plugins/access/spaces/shared/declared.js +8 -0
- package/plugins/access/spaces/shared/labels.d.ts +7 -1
- package/plugins/access/spaces/shared/labels.js +79 -11
- package/plugins/access/spaces/shared/managers.js +3 -3
- package/plugins/access/spaces/shared/names.d.ts +70 -0
- package/plugins/access/spaces/shared/names.js +105 -0
- package/plugins/access/spaces/shared/profile.d.ts +21 -0
- package/plugins/access/spaces/shared/profile.js +27 -0
- package/plugins/access/spaces/shared/reach.d.ts +28 -4
- package/plugins/access/spaces/shared/reach.js +81 -14
- package/plugins/access/spaces/shared/rules.d.ts +10 -5
- package/plugins/access/spaces/shared/rules.js +39 -12
- package/plugins/access/spaces/shared/seat.d.ts +10 -0
- package/plugins/access/spaces/shared/seat.js +29 -0
- package/plugins/access/spaces/views/elsewhere.d.ts +2 -1
- package/plugins/access/spaces/views/elsewhere.js +30 -8
- package/plugins/access/spaces/views/web/agents.d.ts +6 -1
- package/plugins/access/spaces/views/web/agents.js +7 -5
- package/plugins/access/spaces/views/web/header.d.ts +3 -1
- package/plugins/access/spaces/views/web/header.js +5 -5
- package/plugins/access/spaces/views/web/invitation.d.ts +3 -1
- package/plugins/access/spaces/views/web/invitation.js +2 -2
- package/plugins/access/spaces/views/web/invitations.js +3 -1
- package/plugins/access/spaces/views/web/invited.js +3 -1
- package/plugins/access/spaces/views/web/inviting.js +5 -3
- package/plugins/access/spaces/views/web/members.d.ts +3 -1
- package/plugins/access/spaces/views/web/members.js +52 -19
- package/plugins/access/spaces/views/web/org-about.js +3 -3
- package/plugins/access/spaces/views/web/org-members.d.ts +1 -1
- package/plugins/access/spaces/views/web/org-members.js +8 -7
- package/plugins/access/spaces/views/web/palette.js +18 -10
- package/plugins/access/spaces/views/web/panel.d.ts +3 -2
- package/plugins/access/spaces/views/web/panel.js +33 -17
- package/plugins/access/spaces/views/web/pending.d.ts +3 -1
- package/plugins/access/spaces/views/web/pending.js +5 -5
- package/plugins/access/spaces/views/web/sections.d.ts +31 -0
- package/plugins/access/spaces/views/web/sections.js +22 -0
- package/plugins/access/spaces/views/web/space.d.ts +4 -2
- package/plugins/access/spaces/views/web/space.js +25 -9
- package/plugins/access/spaces/views/web/spaces.js +3 -2
- package/plugins/access/spaces/views/web/style.d.ts +1 -1
- package/plugins/access/spaces/views/web/style.js +41 -0
- package/plugins/access/spaces/views/web/tabs.d.ts +18 -6
- package/plugins/access/spaces/views/web/tabs.js +24 -8
- package/plugins/access/spaces/views/web/tree.d.ts +3 -1
- package/plugins/access/spaces/views/web/tree.js +10 -9
- package/plugins/access/spaces/views/web/who.d.ts +14 -5
- package/plugins/access/spaces/views/web/who.js +25 -10
- package/plugins/access/spaces/views/where.d.ts +4 -2
- package/plugins/access/spaces/views/where.js +18 -3
- package/plugins/access/spaces/web.js +19 -2
- package/plugins/access/web.d.ts +1 -0
- package/plugins/access/web.js +1 -0
- package/plugins/agents/chat/actions/erase.d.ts +1 -0
- package/plugins/agents/chat/actions/erase.js +51 -0
- package/plugins/agents/chat/actions/fork.js +2 -2
- package/plugins/agents/chat/actions/move.js +2 -2
- package/plugins/agents/chat/actions/open.d.ts +1 -0
- package/plugins/agents/chat/actions/open.js +49 -0
- package/plugins/agents/chat/actions/quiet.d.ts +1 -0
- package/plugins/agents/chat/actions/quiet.js +33 -0
- package/plugins/agents/chat/actions/say.d.ts +1 -0
- package/plugins/agents/chat/actions/say.js +82 -0
- package/plugins/agents/chat/actions/send.js +77 -18
- package/plugins/agents/chat/actions/shown.d.ts +1 -0
- package/plugins/agents/chat/actions/shown.js +35 -0
- package/plugins/agents/chat/actions/stop.js +9 -2
- package/plugins/agents/chat/collections/file.d.ts +2 -0
- package/plugins/agents/chat/collections/file.js +4 -2
- package/plugins/agents/chat/collections/intent.d.ts +124 -0
- package/plugins/agents/chat/collections/intent.js +52 -0
- package/plugins/agents/chat/collections/message.d.ts +223 -3
- package/plugins/agents/chat/collections/message.js +73 -6
- package/plugins/agents/chat/collections/shown.d.ts +105 -0
- package/plugins/agents/chat/collections/shown.js +34 -0
- package/plugins/agents/chat/collections/thread.d.ts +9 -0
- package/plugins/agents/chat/collections/thread.js +5 -3
- package/plugins/agents/chat/contract.d.ts +19 -8
- package/plugins/agents/chat/contract.js +9 -0
- package/plugins/agents/chat/mod.d.ts +30 -7
- package/plugins/agents/chat/mod.js +62 -9
- package/plugins/agents/chat/processors/failed.js +21 -5
- package/plugins/agents/chat/processors/turn.d.ts +1 -1
- package/plugins/agents/chat/processors/turn.js +139 -43
- package/plugins/agents/chat/shared/agents.d.ts +9 -0
- package/plugins/agents/chat/shared/delivery.d.ts +23 -3
- package/plugins/agents/chat/shared/delivery.js +96 -10
- package/plugins/agents/chat/shared/lineage.d.ts +31 -5
- package/plugins/agents/chat/shared/lineage.js +65 -21
- package/plugins/agents/chat/shared/origin.d.ts +22 -0
- package/plugins/agents/chat/shared/origin.js +11 -0
- package/plugins/agents/chat/shared/send.d.ts +3 -1
- package/plugins/agents/chat/shared/send.js +82 -3
- package/plugins/agents/chat/shared/tools.d.ts +33 -0
- package/plugins/agents/chat/shared/tools.js +28 -0
- package/plugins/agents/chat/shared/types.d.ts +105 -9
- package/plugins/agents/chat/shared/types.js +3 -0
- package/plugins/agents/chat/views/context.d.ts +4 -2
- package/plugins/agents/chat/views/context.js +7 -3
- package/plugins/agents/chat/views/history.d.ts +4 -0
- package/plugins/agents/chat/views/message.d.ts +8 -2
- package/plugins/agents/chat/views/message.js +46 -10
- package/plugins/agents/chat/views/participants.js +7 -1
- package/plugins/agents/chat/views/prompt.d.ts +3 -1
- package/plugins/agents/chat/views/prompt.js +66 -18
- package/plugins/agents/chat/views/terminal/agent-prompt.js +2 -2
- package/plugins/agents/chat/views/terminal/author.js +5 -1
- package/plugins/agents/chat/views/web/composer.d.ts +7 -2
- package/plugins/agents/chat/views/web/composer.js +9 -1
- package/plugins/agents/chat/views/web/conversation.d.ts +3 -2
- package/plugins/agents/chat/views/web/conversation.js +18 -5
- package/plugins/agents/chat/views/web/header.d.ts +2 -1
- package/plugins/agents/chat/views/web/header.js +1 -1
- package/plugins/agents/chat/views/web/held.d.ts +10 -9
- package/plugins/agents/chat/views/web/held.js +27 -20
- package/plugins/agents/chat/views/web/home.d.ts +3 -2
- package/plugins/agents/chat/views/web/home.js +1 -1
- package/plugins/agents/chat/views/web/message.d.ts +10 -1
- package/plugins/agents/chat/views/web/message.js +23 -5
- package/plugins/agents/chat/views/web/over.d.ts +9 -8
- package/plugins/agents/chat/views/web/over.js +10 -9
- package/plugins/agents/chat/views/web/style.d.ts +1 -1
- package/plugins/agents/chat/views/web/style.js +19 -6
- package/plugins/agents/chat/web.d.ts +5 -1
- package/plugins/agents/chat/web.js +5 -1
- package/plugins/agents/history/collections/outline.d.ts +74 -7
- package/plugins/agents/history/collections/outline.js +20 -4
- package/plugins/agents/history/collections/summary.d.ts +1 -1
- package/plugins/agents/history/mod.d.ts +14 -6
- package/plugins/agents/history/mod.js +16 -7
- package/plugins/agents/history/processors/compact.d.ts +6 -1
- package/plugins/agents/history/processors/compact.js +112 -43
- package/plugins/agents/history/processors/erase.d.ts +3 -0
- package/plugins/agents/history/processors/erase.js +11 -0
- package/plugins/agents/history/resources/tools.js +12 -3
- package/plugins/agents/history/shared/lines.d.ts +5 -2
- package/plugins/agents/history/shared/lines.js +10 -2
- package/plugins/agents/history/shared/settings.d.ts +5 -1
- package/plugins/agents/history/shared/weight.d.ts +28 -0
- package/plugins/agents/history/shared/weight.js +62 -0
- package/plugins/agents/history/views/history.d.ts +4 -1
- package/plugins/agents/history/views/history.js +21 -7
- package/plugins/agents/history/views/since.d.ts +6 -3
- package/plugins/agents/history/views/since.js +9 -2
- package/plugins/agents/memory/collections/memory.js +17 -6
- package/plugins/agents/memory/mod.js +4 -3
- package/plugins/agents/memory/processors/extract.d.ts +1 -1
- package/plugins/agents/memory/processors/extract.js +14 -4
- package/plugins/agents/memory/resources/context.d.ts +9 -1
- package/plugins/agents/memory/resources/context.js +7 -1
- package/plugins/agents/memory/resources/tools.js +12 -9
- package/plugins/agents/memory/shared/scope.d.ts +12 -3
- package/plugins/agents/memory/shared/scope.js +25 -6
- package/plugins/agents/memory/shared/search.d.ts +3 -1
- package/plugins/agents/memory/shared/search.js +18 -4
- package/plugins/agents/memory/shared/settings.d.ts +12 -4
- package/plugins/agents/memory/shared/settings.js +15 -4
- package/plugins/agents/memory/views/context.d.ts +4 -1
- package/plugins/agents/memory/views/context.js +27 -11
- package/plugins/agents/memory/views/memory.d.ts +1 -0
- package/plugins/agents/memory/views/memory.js +4 -2
- package/plugins/agents/memory/views/terminal/memory.d.ts +4 -1
- package/plugins/agents/memory/views/terminal/memory.js +7 -2
- package/plugins/agents/memory/views/web/card.d.ts +4 -2
- package/plugins/agents/memory/views/web/card.js +4 -3
- package/plugins/agents/memory/views/web/list.d.ts +3 -1
- package/plugins/agents/memory/views/web/list.js +20 -9
- package/plugins/agents/memory/views/web/memories.js +5 -1
- package/plugins/agents/memory/views/web/pick.js +8 -5
- package/plugins/agents/memory/web.js +9 -1
- package/plugins/agents/mod.d.ts +7 -3
- package/plugins/agents/mod.js +7 -3
- package/plugins/agents/openapi/actions/operation.d.ts +11 -0
- package/plugins/agents/openapi/actions/operation.js +86 -0
- package/plugins/agents/openapi/contract.d.ts +79 -0
- package/plugins/agents/openapi/contract.js +1 -0
- package/plugins/agents/openapi/mod.d.ts +5 -0
- package/plugins/agents/openapi/mod.js +78 -0
- package/plugins/agents/openapi/resources/tools.d.ts +9 -0
- package/plugins/agents/openapi/resources/tools.js +23 -0
- package/plugins/agents/openapi/shared/files.d.ts +4 -0
- package/plugins/agents/openapi/shared/files.js +126 -0
- package/plugins/agents/openapi/shared/plan.d.ts +34 -0
- package/plugins/agents/openapi/shared/plan.js +122 -0
- package/plugins/agents/openapi/shared/request.d.ts +15 -0
- package/plugins/agents/openapi/shared/request.js +87 -0
- package/plugins/agents/openapi/shared/response.d.ts +24 -0
- package/plugins/agents/openapi/shared/response.js +133 -0
- package/plugins/agents/openapi/shared/schema.d.ts +20 -0
- package/plugins/agents/openapi/shared/schema.js +128 -0
- package/plugins/agents/openapi/shared/settings.d.ts +22 -0
- package/plugins/agents/openapi/shared/settings.js +34 -0
- package/plugins/agents/openapi/shared/spec.d.ts +55 -0
- package/plugins/agents/openapi/shared/spec.js +99 -0
- package/plugins/agents/routines/actions/create.js +24 -12
- package/plugins/agents/routines/actions/delete.js +2 -2
- package/plugins/agents/routines/actions/origin.d.ts +1 -0
- package/plugins/agents/routines/actions/origin.js +32 -0
- package/plugins/agents/routines/actions/pause.js +2 -2
- package/plugins/agents/routines/actions/resume.js +2 -2
- package/plugins/agents/routines/actions/run.js +4 -4
- package/plugins/agents/routines/actions/update.js +18 -10
- package/plugins/agents/routines/collections/routine.d.ts +15 -3
- package/plugins/agents/routines/collections/routine.js +14 -8
- package/plugins/agents/routines/collections/run.d.ts +10 -1
- package/plugins/agents/routines/collections/run.js +2 -0
- package/plugins/agents/routines/contract.d.ts +7 -1
- package/plugins/agents/routines/mod.d.ts +10 -2
- package/plugins/agents/routines/mod.js +14 -2
- package/plugins/agents/routines/resources/tools.js +64 -13
- package/plugins/agents/routines/shared/fire.d.ts +5 -2
- package/plugins/agents/routines/shared/fire.js +30 -14
- package/plugins/agents/routines/shared/routines.d.ts +17 -8
- package/plugins/agents/routines/shared/routines.js +33 -19
- package/plugins/agents/routines/shared/schedule.d.ts +5 -0
- package/plugins/agents/routines/shared/schedule.js +12 -1
- package/plugins/agents/routines/views/web/form.d.ts +4 -3
- package/plugins/agents/routines/views/web/form.js +29 -7
- package/plugins/agents/routines/views/web/new.js +1 -1
- package/plugins/agents/routines/views/web/page.d.ts +2 -1
- package/plugins/agents/routines/views/web/page.js +32 -10
- package/plugins/agents/routines/views/web/routines.d.ts +2 -1
- package/plugins/agents/routines/views/web/routines.js +1 -1
- package/plugins/agents/routines/views/web/step.js +3 -1
- package/plugins/agents/routines/views/web/style.d.ts +1 -1
- package/plugins/agents/routines/views/web/style.js +1 -0
- package/plugins/agents/routines/web.js +1 -1
- package/plugins/agents/skills/actions/create.js +2 -2
- package/plugins/agents/skills/actions/delete.js +2 -2
- package/plugins/agents/skills/actions/update.js +2 -2
- package/plugins/agents/skills/collections/skill.js +4 -4
- package/plugins/agents/skills/shared/write.d.ts +2 -3
- package/plugins/agents/skills/shared/write.js +2 -1
- package/plugins/agents/skills/views/web/page.js +7 -3
- package/plugins/agents/skills/web.js +3 -1
- package/plugins/agents/team/actions/agent.js +5 -6
- package/plugins/agents/team/collections/agent.js +3 -3
- package/plugins/agents/team/contract.d.ts +7 -4
- package/plugins/agents/team/views/web/agent-fields.js +3 -4
- package/plugins/agents/team/views/web/model-pick.d.ts +25 -0
- package/plugins/agents/team/views/web/model-pick.js +39 -0
- package/plugins/agents/team/views/web/model-picker.d.ts +23 -0
- package/plugins/agents/team/views/web/model-picker.js +206 -0
- package/plugins/agents/team/views/web/style.d.ts +2 -2
- package/plugins/agents/team/views/web/style.js +52 -1
- package/plugins/agents/team/web.d.ts +4 -2
- package/plugins/agents/team/web.js +6 -2
- package/plugins/agents/tiers/actions/choose.d.ts +2 -0
- package/plugins/agents/tiers/actions/choose.js +98 -0
- package/plugins/agents/tiers/actions/model.d.ts +1 -0
- package/plugins/agents/tiers/actions/model.js +36 -0
- package/plugins/agents/tiers/collections/choice.d.ts +48 -0
- package/plugins/agents/tiers/collections/choice.js +59 -0
- package/plugins/agents/tiers/contract.d.ts +19 -0
- package/plugins/agents/tiers/contract.js +1 -0
- package/plugins/agents/tiers/mod.d.ts +54 -0
- package/plugins/agents/tiers/mod.js +92 -0
- package/plugins/agents/tiers/shared/shown.d.ts +87 -0
- package/plugins/agents/tiers/shared/shown.js +155 -0
- package/plugins/agents/tiers/shared/tiers.d.ts +103 -0
- package/plugins/agents/tiers/shared/tiers.js +129 -0
- package/plugins/agents/tiers/views/web/org.d.ts +38 -0
- package/plugins/agents/tiers/views/web/org.js +142 -0
- package/plugins/agents/tiers/views/web/space.d.ts +43 -0
- package/plugins/agents/tiers/views/web/space.js +103 -0
- package/plugins/agents/tiers/views/web/style.d.ts +7 -0
- package/plugins/agents/tiers/views/web/style.js +87 -0
- package/plugins/agents/tiers/views/web/words.d.ts +21 -0
- package/plugins/agents/tiers/views/web/words.js +49 -0
- package/plugins/agents/tiers/web.d.ts +18 -0
- package/plugins/agents/tiers/web.js +40 -0
- package/plugins/agents/web.d.ts +1 -0
- package/plugins/agents/web.js +1 -0
- package/plugins/billing/credits/actions/check.d.ts +5 -0
- package/plugins/billing/credits/actions/check.js +97 -0
- package/plugins/billing/credits/actions/manage.d.ts +9 -0
- package/plugins/billing/credits/actions/manage.js +266 -0
- package/plugins/billing/credits/actions/state.d.ts +2 -0
- package/plugins/billing/credits/actions/state.js +172 -0
- package/plugins/billing/credits/collections/credit.d.ts +110 -0
- package/plugins/billing/credits/collections/credit.js +31 -0
- package/plugins/billing/credits/collections/payment.d.ts +139 -0
- package/plugins/billing/credits/collections/payment.js +32 -0
- package/plugins/billing/credits/collections/plan.d.ts +428 -0
- package/plugins/billing/credits/collections/plan.js +97 -0
- package/plugins/billing/credits/collections/room.d.ts +85 -0
- package/plugins/billing/credits/collections/room.js +24 -0
- package/plugins/billing/credits/contract.d.ts +19 -0
- package/plugins/billing/credits/contract.js +12 -0
- package/plugins/billing/credits/mod.d.ts +38 -0
- package/plugins/billing/credits/mod.js +72 -0
- package/plugins/billing/credits/shared/apply.d.ts +66 -0
- package/plugins/billing/credits/shared/apply.js +106 -0
- package/plugins/billing/credits/shared/settings.d.ts +70 -0
- package/plugins/billing/credits/shared/settings.js +28 -0
- package/plugins/billing/credits/shared/standing.d.ts +71 -0
- package/plugins/billing/credits/shared/standing.js +235 -0
- package/plugins/billing/credits/shared/walk.d.ts +50 -0
- package/plugins/billing/credits/shared/walk.js +127 -0
- package/plugins/billing/credits/views/web/add.d.ts +25 -0
- package/plugins/billing/credits/views/web/add.js +92 -0
- package/plugins/billing/credits/views/web/budget.d.ts +16 -0
- package/plugins/billing/credits/views/web/budget.js +62 -0
- package/plugins/billing/credits/views/web/composer.d.ts +13 -0
- package/plugins/billing/credits/views/web/composer.js +64 -0
- package/plugins/billing/credits/views/web/history.d.ts +12 -0
- package/plugins/billing/credits/views/web/history.js +55 -0
- package/plugins/billing/credits/views/web/numbers.d.ts +256 -0
- package/plugins/billing/credits/views/web/numbers.js +291 -0
- package/plugins/billing/credits/views/web/org.d.ts +31 -0
- package/plugins/billing/credits/views/web/org.js +238 -0
- package/plugins/billing/credits/views/web/plan.d.ts +28 -0
- package/plugins/billing/credits/views/web/plan.js +84 -0
- package/plugins/billing/credits/views/web/staff.d.ts +20 -0
- package/plugins/billing/credits/views/web/staff.js +265 -0
- package/plugins/billing/credits/views/web/style.d.ts +9 -0
- package/plugins/billing/credits/views/web/style.js +190 -0
- package/plugins/billing/credits/views/web/types.d.ts +17 -0
- package/plugins/billing/credits/views/web/types.js +32 -0
- package/plugins/billing/credits/web.d.ts +12 -0
- package/plugins/billing/credits/web.js +33 -0
- package/plugins/billing/mod.d.ts +8 -3
- package/plugins/billing/mod.js +7 -3
- package/plugins/billing/stripe/actions/checkout.d.ts +4 -0
- package/plugins/billing/stripe/actions/checkout.js +188 -0
- package/plugins/billing/stripe/mod.d.ts +18 -0
- package/plugins/billing/stripe/mod.js +33 -0
- package/plugins/billing/stripe/shared/api.d.ts +14 -0
- package/plugins/billing/stripe/shared/api.js +42 -0
- package/plugins/billing/stripe/shared/events.d.ts +42 -0
- package/plugins/billing/stripe/shared/events.js +226 -0
- package/plugins/billing/stripe/shared/settings.d.ts +34 -0
- package/plugins/billing/stripe/shared/settings.js +10 -0
- package/plugins/billing/stripe/webhook.d.ts +17 -0
- package/plugins/billing/stripe/webhook.js +45 -0
- package/plugins/billing/usage/actions/activity.d.ts +84 -0
- package/plugins/billing/usage/actions/activity.js +310 -0
- package/plugins/billing/usage/actions/close.js +36 -5
- package/plugins/billing/usage/actions/org.d.ts +29 -1
- package/plugins/billing/usage/actions/org.js +32 -62
- package/plugins/billing/usage/actions/quote.d.ts +7 -0
- package/plugins/billing/usage/actions/quote.js +86 -0
- package/plugins/billing/usage/actions/rerate.js +23 -2
- package/plugins/billing/usage/collections/closed.d.ts +11 -1
- package/plugins/billing/usage/collections/closed.js +4 -1
- package/plugins/billing/usage/collections/rollup.d.ts +81 -2
- package/plugins/billing/usage/collections/rollup.js +16 -4
- package/plugins/billing/usage/collections/usage.d.ts +75 -5
- package/plugins/billing/usage/collections/usage.js +34 -15
- package/plugins/billing/usage/mod.d.ts +31 -11
- package/plugins/billing/usage/mod.js +41 -13
- package/plugins/billing/usage/resources/commands.js +1 -1
- package/plugins/billing/usage/shared/categories.d.ts +23 -0
- package/plugins/billing/usage/shared/categories.js +40 -0
- package/plugins/billing/usage/shared/names.d.ts +45 -0
- package/plugins/billing/usage/shared/names.js +60 -0
- package/plugins/billing/usage/shared/rate.d.ts +39 -11
- package/plugins/billing/usage/shared/rate.js +90 -32
- package/plugins/billing/usage/shared/settings.d.ts +18 -1
- package/plugins/billing/usage/shared/settings.js +11 -2
- package/plugins/billing/usage/shared/totals.d.ts +38 -8
- package/plugins/billing/usage/shared/totals.js +87 -22
- package/plugins/billing/usage/shared/use.d.ts +12 -1
- package/plugins/billing/usage/shared/use.js +14 -7
- package/plugins/billing/usage/views/terminal/totals.d.ts +6 -2
- package/plugins/billing/usage/views/terminal/totals.js +38 -6
- package/plugins/billing/usage/views/web/chart.d.ts +25 -10
- package/plugins/billing/usage/views/web/chart.js +67 -39
- package/plugins/billing/usage/views/web/numbers.d.ts +143 -48
- package/plugins/billing/usage/views/web/numbers.js +250 -56
- package/plugins/billing/usage/views/web/org.d.ts +32 -6
- package/plugins/billing/usage/views/web/org.js +538 -123
- package/plugins/billing/usage/views/web/style.d.ts +9 -5
- package/plugins/billing/usage/views/web/style.js +148 -65
- package/plugins/billing/usage/web.d.ts +8 -5
- package/plugins/billing/usage/web.js +8 -5
- package/plugins/billing/web.d.ts +3 -0
- package/plugins/billing/web.js +3 -0
- package/plugins/compute/apps/actions/build.d.ts +1 -0
- package/plugins/compute/apps/actions/build.js +99 -0
- package/plugins/compute/apps/actions/configure.d.ts +1 -0
- package/plugins/compute/apps/actions/configure.js +74 -0
- package/plugins/compute/apps/actions/list.d.ts +1 -0
- package/plugins/compute/apps/actions/list.js +13 -0
- package/plugins/compute/apps/actions/meter.d.ts +1 -0
- package/plugins/compute/apps/actions/meter.js +43 -0
- package/plugins/compute/apps/actions/publish.d.ts +1 -0
- package/plugins/compute/apps/actions/publish.js +41 -0
- package/plugins/compute/apps/actions/redeploy.d.ts +1 -0
- package/plugins/compute/apps/actions/redeploy.js +26 -0
- package/plugins/compute/apps/actions/remove.d.ts +1 -0
- package/plugins/compute/apps/actions/remove.js +47 -0
- package/plugins/compute/apps/adapters/cloudrun.d.ts +90 -0
- package/plugins/compute/apps/adapters/cloudrun.js +353 -0
- package/plugins/compute/apps/adapters/front.d.ts +24 -0
- package/plugins/compute/apps/adapters/front.js +131 -0
- package/plugins/compute/apps/adapters/local.d.ts +15 -0
- package/plugins/compute/apps/adapters/local.js +139 -0
- package/plugins/compute/apps/adapters/tar.d.ts +29 -0
- package/plugins/compute/apps/adapters/tar.js +178 -0
- package/plugins/compute/apps/collections/app.d.ts +143 -0
- package/plugins/compute/apps/collections/app.js +60 -0
- package/plugins/compute/apps/contract.d.ts +73 -0
- package/plugins/compute/apps/contract.js +8 -0
- package/plugins/compute/apps/mod.d.ts +42 -0
- package/plugins/compute/apps/mod.js +69 -0
- package/plugins/compute/apps/resources/tools.d.ts +10 -0
- package/plugins/compute/apps/resources/tools.js +85 -0
- package/plugins/compute/apps/shared/archive.d.ts +24 -0
- package/plugins/compute/apps/shared/archive.js +69 -0
- package/plugins/compute/apps/shared/claims.d.ts +28 -0
- package/plugins/compute/apps/shared/claims.js +18 -0
- package/plugins/compute/apps/shared/environment.d.ts +8 -0
- package/plugins/compute/apps/shared/environment.js +15 -0
- package/plugins/compute/apps/shared/errors.d.ts +4 -0
- package/plugins/compute/apps/shared/errors.js +4 -0
- package/plugins/compute/apps/shared/host.d.ts +19 -0
- package/plugins/compute/apps/shared/host.js +19 -0
- package/plugins/compute/apps/shared/label.d.ts +21 -0
- package/plugins/compute/apps/shared/label.js +51 -0
- package/plugins/compute/apps/shared/meter.d.ts +17 -0
- package/plugins/compute/apps/shared/meter.js +29 -0
- package/plugins/compute/apps/shared/publish.d.ts +41 -0
- package/plugins/compute/apps/shared/publish.js +141 -0
- package/plugins/compute/apps/shared/settings.d.ts +49 -0
- package/plugins/compute/apps/shared/settings.js +22 -0
- package/plugins/compute/apps/views/web/apps.d.ts +54 -0
- package/plugins/compute/apps/views/web/apps.js +48 -0
- package/plugins/compute/apps/views/web/env.d.ts +54 -0
- package/plugins/compute/apps/views/web/env.js +195 -0
- package/plugins/compute/apps/views/web/publish.d.ts +24 -0
- package/plugins/compute/apps/views/web/publish.js +158 -0
- package/plugins/compute/apps/views/web/space.d.ts +16 -0
- package/plugins/compute/apps/views/web/space.js +138 -0
- package/plugins/compute/apps/views/web/style.d.ts +7 -0
- package/plugins/compute/apps/views/web/style.js +155 -0
- package/plugins/compute/apps/web.d.ts +17 -0
- package/plugins/compute/apps/web.js +35 -0
- package/plugins/compute/cloud/actions/create.d.ts +1 -0
- package/plugins/compute/cloud/actions/create.js +76 -0
- package/plugins/compute/cloud/actions/daily.d.ts +1 -0
- package/plugins/compute/cloud/actions/daily.js +75 -0
- package/plugins/compute/cloud/actions/destroy.d.ts +1 -0
- package/plugins/compute/cloud/actions/destroy.js +71 -0
- package/plugins/compute/cloud/actions/may.d.ts +1 -0
- package/plugins/compute/cloud/actions/may.js +15 -0
- package/plugins/compute/cloud/actions/org.d.ts +1 -0
- package/plugins/compute/cloud/actions/org.js +21 -0
- package/plugins/compute/cloud/actions/pool-tick.d.ts +4 -0
- package/plugins/compute/cloud/actions/pool-tick.js +96 -0
- package/plugins/compute/cloud/actions/pool.d.ts +3 -0
- package/plugins/compute/cloud/actions/pool.js +98 -0
- package/plugins/compute/cloud/actions/release.d.ts +1 -0
- package/plugins/compute/cloud/actions/release.js +58 -0
- package/plugins/compute/cloud/actions/remote.d.ts +10 -0
- package/plugins/compute/cloud/actions/remote.js +24 -0
- package/plugins/compute/cloud/actions/tick.d.ts +1 -0
- package/plugins/compute/cloud/actions/tick.js +105 -0
- package/plugins/compute/cloud/actions/touch.d.ts +1 -0
- package/plugins/compute/cloud/actions/touch.js +32 -0
- package/plugins/compute/cloud/actions/vms.d.ts +7 -0
- package/plugins/compute/cloud/actions/vms.js +211 -0
- package/plugins/compute/cloud/actions/wake.d.ts +1 -0
- package/plugins/compute/cloud/actions/wake.js +153 -0
- package/plugins/compute/cloud/adapters/gce/index.d.ts +73 -0
- package/plugins/compute/cloud/adapters/gce/index.js +242 -0
- package/plugins/compute/cloud/adapters/local.d.ts +48 -0
- package/plugins/compute/cloud/adapters/local.js +188 -0
- package/plugins/compute/cloud/collections/cloud-computer.d.ts +109 -0
- package/plugins/compute/cloud/collections/cloud-computer.js +89 -0
- package/plugins/compute/cloud/collections/pool-vm.d.ts +79 -0
- package/plugins/compute/cloud/collections/pool-vm.js +36 -0
- package/plugins/compute/cloud/collections/pool-want.d.ts +94 -0
- package/plugins/compute/cloud/collections/pool-want.js +27 -0
- package/plugins/compute/cloud/contract.d.ts +236 -0
- package/plugins/compute/cloud/contract.js +67 -0
- package/plugins/compute/cloud/mod.d.ts +97 -0
- package/plugins/compute/cloud/mod.js +197 -0
- package/plugins/compute/cloud/processors/mark.d.ts +9 -0
- package/plugins/compute/cloud/processors/mark.js +13 -0
- package/plugins/compute/cloud/resources/tools.d.ts +3 -0
- package/plugins/compute/cloud/resources/tools.js +237 -0
- package/plugins/compute/cloud/shared/google.d.ts +75 -0
- package/plugins/compute/cloud/shared/google.js +218 -0
- package/plugins/compute/cloud/shared/host.d.ts +11 -0
- package/plugins/compute/cloud/shared/host.js +29 -0
- package/plugins/compute/cloud/shared/may.d.ts +21 -0
- package/plugins/compute/cloud/shared/may.js +22 -0
- package/plugins/compute/cloud/shared/meter.d.ts +36 -0
- package/plugins/compute/cloud/shared/meter.js +68 -0
- package/plugins/compute/cloud/shared/names.d.ts +10 -0
- package/plugins/compute/cloud/shared/names.js +11 -0
- package/plugins/compute/cloud/shared/people.d.ts +19 -0
- package/plugins/compute/cloud/shared/people.js +12 -0
- package/plugins/compute/cloud/shared/records.d.ts +31 -0
- package/plugins/compute/cloud/shared/records.js +18 -0
- package/plugins/compute/cloud/shared/settings.d.ts +70 -0
- package/plugins/compute/cloud/shared/settings.js +47 -0
- package/plugins/compute/cloud/shared/time.d.ts +21 -0
- package/plugins/compute/cloud/shared/time.js +33 -0
- package/plugins/compute/cloud/views/web/cloud.d.ts +79 -0
- package/plugins/compute/cloud/views/web/cloud.js +122 -0
- package/plugins/compute/cloud/views/web/computer.d.ts +37 -0
- package/plugins/compute/cloud/views/web/computer.js +195 -0
- package/plugins/compute/cloud/views/web/new.d.ts +27 -0
- package/plugins/compute/cloud/views/web/new.js +103 -0
- package/plugins/compute/cloud/views/web/style.d.ts +6 -0
- package/plugins/compute/cloud/views/web/style.js +84 -0
- package/plugins/compute/cloud/web.d.ts +19 -0
- package/plugins/compute/cloud/web.js +61 -0
- package/plugins/compute/computers/actions/allow-origin.d.ts +5 -0
- package/plugins/compute/computers/actions/allow-origin.js +48 -0
- package/plugins/compute/computers/actions/allowed.d.ts +1 -0
- package/plugins/compute/computers/actions/allowed.js +50 -0
- package/plugins/compute/computers/actions/approve.js +19 -10
- package/plugins/compute/computers/actions/code.js +4 -4
- package/plugins/compute/computers/actions/default.js +4 -8
- package/plugins/compute/computers/actions/enrollment.d.ts +1 -0
- package/plugins/compute/computers/actions/enrollment.js +49 -0
- package/plugins/compute/computers/actions/env.d.ts +3 -0
- package/plugins/compute/computers/actions/env.js +134 -0
- package/plugins/compute/computers/actions/forget-grant.d.ts +1 -0
- package/plugins/compute/computers/actions/forget-grant.js +16 -0
- package/plugins/compute/computers/actions/forget.js +2 -2
- package/plugins/compute/computers/actions/mark.d.ts +1 -0
- package/plugins/compute/computers/actions/mark.js +36 -0
- package/plugins/compute/computers/actions/move.js +5 -4
- package/plugins/compute/computers/actions/preview.d.ts +4 -0
- package/plugins/compute/computers/actions/preview.js +183 -0
- package/plugins/compute/computers/actions/provision.d.ts +1 -0
- package/plugins/compute/computers/actions/provision.js +51 -0
- package/plugins/compute/computers/actions/rename.js +2 -2
- package/plugins/compute/computers/actions/running.d.ts +1 -0
- package/plugins/compute/computers/actions/running.js +33 -0
- package/plugins/compute/computers/actions/scope.d.ts +1 -0
- package/plugins/compute/computers/actions/scope.js +61 -0
- package/plugins/compute/computers/actions/share.js +5 -4
- package/plugins/compute/computers/actions/unshare.js +5 -8
- package/plugins/compute/computers/actions/view.d.ts +1 -0
- package/plugins/compute/computers/actions/view.js +29 -0
- package/plugins/compute/computers/actions/work.js +41 -6
- package/plugins/compute/computers/collections/approval.d.ts +57 -5
- package/plugins/compute/computers/collections/approval.js +16 -4
- package/plugins/compute/computers/collections/computer.d.ts +70 -1
- package/plugins/compute/computers/collections/computer.js +18 -2
- package/plugins/compute/computers/collections/desk.d.ts +53 -0
- package/plugins/compute/computers/collections/desk.js +11 -3
- package/plugins/compute/computers/collections/env-var.d.ts +122 -0
- package/plugins/compute/computers/collections/env-var.js +51 -0
- package/plugins/compute/computers/collections/grant.d.ts +20 -3
- package/plugins/compute/computers/collections/grant.js +21 -5
- package/plugins/compute/computers/collections/preview.d.ts +111 -0
- package/plugins/compute/computers/collections/preview.js +58 -0
- package/plugins/compute/computers/contract.d.ts +18 -0
- package/plugins/compute/computers/contract.js +8 -0
- package/plugins/compute/computers/mod.d.ts +9 -1
- package/plugins/compute/computers/mod.js +50 -6
- package/plugins/compute/computers/processors/left.d.ts +8 -0
- package/plugins/compute/computers/processors/left.js +31 -0
- package/plugins/compute/computers/program/version.d.ts +1 -1
- package/plugins/compute/computers/program/version.js +1 -1
- package/plugins/compute/computers/resources/commands.js +29 -13
- package/plugins/compute/computers/resources/downloads.js +1 -1
- package/plugins/compute/computers/resources/previews.d.ts +48 -0
- package/plugins/compute/computers/resources/previews.js +391 -0
- package/plugins/compute/computers/resources/tools.d.ts +11 -5
- package/plugins/compute/computers/resources/tools.js +155 -22
- package/plugins/compute/computers/shared/ask.d.ts +7 -3
- package/plugins/compute/computers/shared/ask.js +36 -11
- package/plugins/compute/computers/shared/asks.d.ts +2 -2
- package/plugins/compute/computers/shared/asks.js +3 -2
- package/plugins/compute/computers/shared/desks.d.ts +1 -5
- package/plugins/compute/computers/shared/desks.js +2 -11
- package/plugins/compute/computers/shared/env.d.ts +20 -0
- package/plugins/compute/computers/shared/env.js +50 -0
- package/plugins/compute/computers/shared/grants.d.ts +26 -0
- package/plugins/compute/computers/shared/grants.js +49 -0
- package/plugins/compute/computers/shared/jobs.d.ts +13 -0
- package/plugins/compute/computers/shared/jobs.js +16 -0
- package/plugins/compute/computers/shared/preview-url.d.ts +5 -0
- package/plugins/compute/computers/shared/preview-url.js +5 -0
- package/plugins/compute/computers/shared/seal.d.ts +4 -0
- package/plugins/compute/computers/shared/seal.js +60 -0
- package/plugins/compute/computers/shared/settings.d.ts +32 -5
- package/plugins/compute/computers/shared/settings.js +12 -0
- package/plugins/compute/computers/shared/wake.d.ts +43 -0
- package/plugins/compute/computers/shared/wake.js +80 -0
- package/plugins/compute/computers/shared/where.d.ts +34 -7
- package/plugins/compute/computers/shared/where.js +81 -11
- package/plugins/compute/computers/shared/workloads.d.ts +50 -0
- package/plugins/compute/computers/shared/workloads.js +4 -0
- package/plugins/compute/computers/views/context.d.ts +6 -3
- package/plugins/compute/computers/views/context.js +85 -6
- package/plugins/compute/computers/views/terminal/approvals.js +3 -1
- package/plugins/compute/computers/views/web/add.d.ts +41 -0
- package/plugins/compute/computers/views/web/add.js +60 -0
- package/plugins/compute/computers/views/web/allowed.d.ts +16 -0
- package/plugins/compute/computers/views/web/allowed.js +38 -0
- package/plugins/compute/computers/views/web/asked.d.ts +26 -7
- package/plugins/compute/computers/views/web/asked.js +47 -10
- package/plugins/compute/computers/views/web/asks.d.ts +10 -5
- package/plugins/compute/computers/views/web/asks.js +38 -13
- package/plugins/compute/computers/views/web/calls.js +5 -2
- package/plugins/compute/computers/views/web/computer.d.ts +4 -1
- package/plugins/compute/computers/views/web/computer.js +21 -2
- package/plugins/compute/computers/views/web/connect.d.ts +18 -3
- package/plugins/compute/computers/views/web/connect.js +52 -35
- package/plugins/compute/computers/views/web/desks.d.ts +19 -8
- package/plugins/compute/computers/views/web/desks.js +67 -37
- package/plugins/compute/computers/views/web/env.d.ts +32 -0
- package/plugins/compute/computers/views/web/env.js +154 -0
- package/plugins/compute/computers/views/web/environment.d.ts +23 -0
- package/plugins/compute/computers/views/web/environment.js +47 -0
- package/plugins/compute/computers/views/web/jobs.d.ts +18 -6
- package/plugins/compute/computers/views/web/jobs.js +56 -21
- package/plugins/compute/computers/views/web/kinds.d.ts +102 -0
- package/plugins/compute/computers/views/web/kinds.js +37 -0
- package/plugins/compute/computers/views/web/mark.d.ts +7 -2
- package/plugins/compute/computers/views/web/mark.js +2 -2
- package/plugins/compute/computers/views/web/names.d.ts +3 -2
- package/plugins/compute/computers/views/web/names.js +5 -3
- package/plugins/compute/computers/views/web/page.d.ts +14 -2
- package/plugins/compute/computers/views/web/page.js +48 -26
- package/plugins/compute/computers/views/web/previews.d.ts +44 -0
- package/plugins/compute/computers/views/web/previews.js +33 -0
- package/plugins/compute/computers/views/web/routine-panel.d.ts +14 -0
- package/plugins/compute/computers/views/web/routine-panel.js +91 -0
- package/plugins/compute/computers/views/web/serve.d.ts +47 -0
- package/plugins/compute/computers/views/web/serve.js +168 -0
- package/plugins/compute/computers/views/web/space-tab.d.ts +4 -3
- package/plugins/compute/computers/views/web/space-tab.js +39 -9
- package/plugins/compute/computers/views/web/step.js +7 -1
- package/plugins/compute/computers/views/web/style.d.ts +1 -1
- package/plugins/compute/computers/views/web/style.js +166 -2
- package/plugins/compute/computers/views/web/workspace.d.ts +16 -3
- package/plugins/compute/computers/views/web/workspace.js +49 -6
- package/plugins/compute/computers/web.d.ts +17 -4
- package/plugins/compute/computers/web.js +32 -5
- package/plugins/compute/mod.d.ts +8 -1
- package/plugins/compute/mod.js +8 -1
- package/plugins/compute/web.d.ts +13 -0
- package/plugins/compute/web.js +13 -0
- package/plugins/interfaces/api/actions/create.js +2 -3
- package/plugins/interfaces/api/actions/revoke.js +2 -2
- package/plugins/interfaces/api/collections/key.d.ts +2 -2
- package/plugins/interfaces/api/collections/key.js +3 -3
- package/plugins/interfaces/api/mod.js +2 -0
- package/plugins/interfaces/api/processors/left.d.ts +6 -0
- package/plugins/interfaces/api/processors/left.js +12 -0
- package/plugins/interfaces/api/shared/actor.d.ts +3 -11
- package/plugins/interfaces/api/shared/actor.js +1 -23
- package/plugins/interfaces/api/shared/events.js +7 -6
- package/plugins/interfaces/api/shared/rules.d.ts +3 -10
- package/plugins/interfaces/api/shared/rules.js +8 -24
- package/plugins/interfaces/api/shared/server.js +1 -1
- package/plugins/interfaces/api/web.js +3 -1
- package/plugins/interfaces/maintenance/actions/read.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/read.js +76 -0
- package/plugins/interfaces/maintenance/actions/write.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/write.js +64 -0
- package/plugins/interfaces/maintenance/contract.d.ts +60 -0
- package/plugins/interfaces/maintenance/contract.js +2 -0
- package/plugins/interfaces/maintenance/mod.d.ts +52 -0
- package/plugins/interfaces/maintenance/mod.js +66 -0
- package/plugins/interfaces/maintenance/resources/routes.d.ts +71 -0
- package/plugins/interfaces/maintenance/resources/routes.js +457 -0
- package/plugins/interfaces/maintenance/shared/ops.d.ts +4 -0
- package/plugins/interfaces/maintenance/shared/ops.js +19 -0
- package/plugins/interfaces/mcp/actions/call.d.ts +11 -0
- package/plugins/interfaces/mcp/actions/call.js +304 -0
- package/plugins/interfaces/mcp/actions/prune.d.ts +1 -0
- package/plugins/interfaces/mcp/actions/prune.js +18 -0
- package/plugins/interfaces/mcp/collections/closed.d.ts +23 -0
- package/plugins/interfaces/mcp/collections/closed.js +17 -0
- package/plugins/interfaces/mcp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/mcp/collections/rate.js +18 -0
- package/plugins/interfaces/mcp/collections/receipt.d.ts +46 -0
- package/plugins/interfaces/mcp/collections/receipt.js +46 -0
- package/plugins/interfaces/mcp/contract.d.ts +9 -0
- package/plugins/interfaces/mcp/contract.js +9 -0
- package/plugins/interfaces/mcp/mod.d.ts +84 -0
- package/plugins/interfaces/mcp/mod.js +122 -0
- package/plugins/interfaces/mcp/processors/closed.d.ts +13 -0
- package/plugins/interfaces/mcp/processors/closed.js +16 -0
- package/plugins/interfaces/mcp/resources/running.d.ts +21 -0
- package/plugins/interfaces/mcp/resources/running.js +36 -0
- package/plugins/interfaces/mcp/resources/server.d.ts +54 -0
- package/plugins/interfaces/mcp/resources/server.js +423 -0
- package/plugins/interfaces/mcp/resources/tools.d.ts +114 -0
- package/plugins/interfaces/mcp/resources/tools.js +324 -0
- package/plugins/interfaces/mcp/shared/caller.d.ts +45 -0
- package/plugins/interfaces/mcp/shared/caller.js +99 -0
- package/plugins/interfaces/mcp/shared/keys.d.ts +50 -0
- package/plugins/interfaces/mcp/shared/keys.js +53 -0
- package/plugins/interfaces/mcp/shared/settings.d.ts +187 -0
- package/plugins/interfaces/mcp/shared/settings.js +176 -0
- package/plugins/interfaces/mcp/views/offered.d.ts +20 -0
- package/plugins/interfaces/mcp/views/offered.js +20 -0
- package/plugins/interfaces/mod.d.ts +5 -1
- package/plugins/interfaces/mod.js +5 -1
- package/plugins/interfaces/terminal/actions/print.js +1 -1
- package/plugins/interfaces/terminal/actions/set.js +1 -1
- package/plugins/interfaces/terminal/collections/output.d.ts +1 -1
- package/plugins/interfaces/terminal/collections/shell.js +1 -1
- package/plugins/interfaces/voice/actions/block.d.ts +2 -0
- package/plugins/interfaces/voice/actions/block.js +74 -0
- package/plugins/interfaces/voice/actions/call.d.ts +19 -0
- package/plugins/interfaces/voice/actions/call.js +253 -0
- package/plugins/interfaces/voice/actions/hook.d.ts +5 -0
- package/plugins/interfaces/voice/actions/hook.js +225 -0
- package/plugins/interfaces/voice/actions/prune.d.ts +1 -0
- package/plugins/interfaces/voice/actions/prune.js +35 -0
- package/plugins/interfaces/voice/collections/blocked.d.ts +87 -0
- package/plugins/interfaces/voice/collections/blocked.js +34 -0
- package/plugins/interfaces/voice/collections/call.d.ts +279 -0
- package/plugins/interfaces/voice/collections/call.js +77 -0
- package/plugins/interfaces/voice/collections/phone.d.ts +74 -0
- package/plugins/interfaces/voice/collections/phone.js +26 -0
- package/plugins/interfaces/voice/contract.d.ts +14 -0
- package/plugins/interfaces/voice/contract.js +2 -0
- package/plugins/interfaces/voice/mod.d.ts +57 -0
- package/plugins/interfaces/voice/mod.js +118 -0
- package/plugins/interfaces/voice/processors/forget.d.ts +13 -0
- package/plugins/interfaces/voice/processors/forget.js +27 -0
- package/plugins/interfaces/voice/resources/relay.d.ts +77 -0
- package/plugins/interfaces/voice/resources/relay.js +428 -0
- package/plugins/interfaces/voice/resources/tools.d.ts +1 -0
- package/plugins/interfaces/voice/resources/tools.js +25 -0
- package/plugins/interfaces/voice/shared/caller.d.ts +27 -0
- package/plugins/interfaces/voice/shared/caller.js +38 -0
- package/plugins/interfaces/voice/shared/settings.d.ts +136 -0
- package/plugins/interfaces/voice/shared/settings.js +121 -0
- package/plugins/interfaces/voice/shared/signature.d.ts +11 -0
- package/plugins/interfaces/voice/shared/signature.js +34 -0
- package/plugins/interfaces/voice/views/call.d.ts +41 -0
- package/plugins/interfaces/voice/views/call.js +30 -0
- package/plugins/interfaces/voice/views/context.d.ts +9 -0
- package/plugins/interfaces/voice/views/context.js +14 -0
- package/plugins/interfaces/voice/views/message.d.ts +17 -0
- package/plugins/interfaces/voice/views/message.js +41 -0
- package/plugins/interfaces/web/shared/codes.d.ts +31 -0
- package/plugins/interfaces/web/shared/codes.js +44 -0
- package/plugins/interfaces/web/shared/orgs.d.ts +1 -1
- package/plugins/interfaces/web/shared/orgs.js +1 -1
- package/plugins/interfaces/web/shared/style.d.ts +1 -1
- package/plugins/interfaces/web/shared/style.js +3 -0
- package/plugins/interfaces/web/views/console-codes.d.ts +14 -0
- package/plugins/interfaces/web/views/console-codes.js +159 -0
- package/plugins/interfaces/web/views/console.d.ts +4 -2
- package/plugins/interfaces/web/views/console.js +24 -10
- package/plugins/interfaces/web/views/org.js +12 -6
- package/plugins/interfaces/web/views/orgs.js +13 -3
- package/plugins/interfaces/whatsapp/actions/connect.js +11 -10
- package/plugins/interfaces/whatsapp/actions/disconnect.js +6 -3
- package/plugins/interfaces/whatsapp/actions/hook.js +27 -11
- package/plugins/interfaces/whatsapp/actions/link.js +10 -13
- package/plugins/interfaces/whatsapp/actions/set.d.ts +8 -0
- package/plugins/interfaces/whatsapp/actions/set.js +121 -0
- package/plugins/interfaces/whatsapp/collections/blocked.d.ts +29 -0
- package/plugins/interfaces/whatsapp/collections/blocked.js +22 -0
- package/plugins/interfaces/whatsapp/collections/code.d.ts +1 -1
- package/plugins/interfaces/whatsapp/collections/number.d.ts +90 -4
- package/plugins/interfaces/whatsapp/collections/number.js +36 -4
- package/plugins/interfaces/whatsapp/collections/phone.d.ts +14 -4
- package/plugins/interfaces/whatsapp/collections/phone.js +9 -3
- package/plugins/interfaces/whatsapp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/whatsapp/collections/rate.js +13 -0
- package/plugins/interfaces/whatsapp/collections/sent.d.ts +24 -12
- package/plugins/interfaces/whatsapp/collections/sent.js +11 -7
- package/plugins/interfaces/whatsapp/collections/thread.d.ts +14 -6
- package/plugins/interfaces/whatsapp/collections/thread.js +7 -5
- package/plugins/interfaces/whatsapp/collections/typing.d.ts +70 -0
- package/plugins/interfaces/whatsapp/collections/typing.js +21 -0
- package/plugins/interfaces/whatsapp/contract.d.ts +27 -4
- package/plugins/interfaces/whatsapp/contract.js +34 -1
- package/plugins/interfaces/whatsapp/events/undelivered.d.ts +8 -0
- package/plugins/interfaces/whatsapp/events/undelivered.js +17 -0
- package/plugins/interfaces/whatsapp/mod.d.ts +28 -2
- package/plugins/interfaces/whatsapp/mod.js +65 -6
- package/plugins/interfaces/whatsapp/processors/forget.d.ts +6 -0
- package/plugins/interfaces/whatsapp/processors/forget.js +11 -0
- package/plugins/interfaces/whatsapp/processors/receive.d.ts +17 -3
- package/plugins/interfaces/whatsapp/processors/receive.js +267 -91
- package/plugins/interfaces/whatsapp/processors/reply.d.ts +25 -5
- package/plugins/interfaces/whatsapp/processors/reply.js +216 -20
- package/plugins/interfaces/whatsapp/processors/typing.d.ts +8 -0
- package/plugins/interfaces/whatsapp/processors/typing.js +25 -0
- package/plugins/interfaces/whatsapp/shared/customers.d.ts +13 -0
- package/plugins/interfaces/whatsapp/shared/customers.js +16 -0
- package/plugins/interfaces/whatsapp/shared/graph.d.ts +31 -6
- package/plugins/interfaces/whatsapp/shared/graph.js +117 -10
- package/plugins/interfaces/whatsapp/shared/media.d.ts +23 -0
- package/plugins/interfaces/whatsapp/shared/media.js +46 -0
- package/plugins/interfaces/whatsapp/shared/number.d.ts +19 -8
- package/plugins/interfaces/whatsapp/shared/number.js +64 -7
- package/plugins/interfaces/whatsapp/shared/parts.d.ts +94 -0
- package/plugins/interfaces/whatsapp/shared/parts.js +184 -0
- package/plugins/interfaces/whatsapp/shared/payload.d.ts +27 -1
- package/plugins/interfaces/whatsapp/shared/payload.js +36 -1
- package/plugins/interfaces/whatsapp/shared/rules.d.ts +1 -3
- package/plugins/interfaces/whatsapp/shared/rules.js +1 -9
- package/plugins/interfaces/whatsapp/shared/settings.d.ts +49 -1
- package/plugins/interfaces/whatsapp/shared/settings.js +11 -0
- package/plugins/interfaces/whatsapp/views/message.d.ts +13 -0
- package/plugins/interfaces/whatsapp/views/message.js +13 -0
- package/plugins/interfaces/whatsapp/views/web/line.d.ts +24 -0
- package/plugins/interfaces/whatsapp/views/web/line.js +44 -0
- package/plugins/interfaces/whatsapp/views/web/space.d.ts +7 -5
- package/plugins/interfaces/whatsapp/views/web/space.js +17 -10
- package/plugins/interfaces/whatsapp/views/web/style.d.ts +1 -1
- package/plugins/interfaces/whatsapp/views/web/style.js +8 -0
- package/plugins/interfaces/whatsapp/web.js +8 -1
- package/plugins/models/actions/check.d.ts +1 -0
- package/plugins/models/actions/check.js +25 -0
- package/plugins/models/actions/offered.d.ts +34 -0
- package/plugins/models/actions/offered.js +186 -0
- package/plugins/models/adapters/llm/anthropic.d.ts +1 -1
- package/plugins/models/adapters/llm/anthropic.js +38 -20
- package/plugins/models/adapters/llm/gemini.d.ts +1 -1
- package/plugins/models/adapters/llm/gemini.js +7 -2
- package/plugins/models/adapters/llm/openai-compatible.d.ts +1 -1
- package/plugins/models/adapters/llm/openai-compatible.js +36 -7
- package/plugins/models/adapters/llm/openai.d.ts +1 -1
- package/plugins/models/adapters/llm/openai.js +158 -28
- package/plugins/models/contract.d.ts +6 -1
- package/plugins/models/mod.d.ts +7 -1
- package/plugins/models/mod.js +12 -2
- package/plugins/models/shared/catalog.json +9208 -8909
- package/plugins/models/shared/choice.d.ts +31 -0
- package/plugins/models/shared/choice.js +19 -3
- package/plugins/models/shared/generate.d.ts +3 -1
- package/plugins/models/shared/generate.js +91 -11
- package/plugins/models/shared/provider.d.ts +5 -0
- package/plugins/models/shared/provider.js +14 -0
- package/plugins/models/shared/types.d.ts +21 -2
- package/plugins/models/shared/types.js +10 -0
- package/plugins/models/shared/use.d.ts +6 -2
- package/plugins/models/shared/use.js +15 -5
- package/runtime/actor.d.ts +15 -0
- package/runtime/actor.js +14 -0
- package/runtime/aggregate.js +8 -2
- package/runtime/blobs.d.ts +15 -12
- package/runtime/blobs.js +58 -11
- package/runtime/cache.d.ts +6 -0
- package/runtime/cache.js +19 -1
- package/runtime/client.js +28 -5
- package/runtime/define.d.ts +10 -0
- package/runtime/errors.d.ts +36 -0
- package/runtime/errors.js +13 -0
- package/runtime/executor.js +29 -13
- package/runtime/links.d.ts +31 -0
- package/runtime/links.js +60 -0
- package/runtime/maintain.d.ts +88 -0
- package/runtime/maintain.js +120 -0
- package/runtime/memory.js +7 -4
- package/runtime/mod.d.ts +6 -2
- package/runtime/mod.js +5 -0
- package/runtime/mongo.d.ts +13 -0
- package/runtime/mongo.js +39 -8
- package/runtime/observe.d.ts +2 -0
- package/runtime/observe.js +14 -10
- package/runtime/ops.d.ts +5 -0
- package/runtime/ops.js +10 -1
- package/runtime/owner.d.ts +31 -2
- package/runtime/owner.js +159 -59
- package/runtime/presence.d.ts +18 -0
- package/runtime/presence.js +25 -0
- package/runtime/registry.d.ts +5 -0
- package/runtime/registry.js +18 -0
- package/runtime/runtime.js +9 -3
- package/runtime/store.d.ts +48 -1
- package/runtime/wire.d.ts +1 -0
- package/runtime/wire.js +3 -1
- package/stores/blobs/files/mod.js +4 -2
- package/stores/blobs/gcs/mod.d.ts +30 -0
- package/stores/blobs/gcs/mod.js +106 -0
- package/stores/blobs/http/mod.d.ts +1 -1
- package/stores/blobs/http/mod.js +2 -1
- package/stores/latency/mod.js +5 -1
- package/stores/sql/postgres/maintenance.d.ts +24 -0
- package/stores/sql/postgres/maintenance.js +258 -0
- package/stores/sql/postgres/mod.d.ts +20 -4
- package/stores/sql/postgres/mod.js +363 -96
- package/stores/sql/postgres/update.js +3 -1
- package/stores/sql/shared/capped.d.ts +2 -0
- package/stores/sql/shared/capped.js +22 -0
- package/stores/sql/shared/rows.d.ts +14 -0
- package/stores/sql/shared/rows.js +29 -0
- package/stores/sql/shared/statement.d.ts +12 -0
- package/stores/sql/shared/statement.js +244 -0
- package/stores/sql/sqlite/apart.d.ts +11 -0
- package/stores/sql/sqlite/apart.js +219 -0
- package/stores/sql/sqlite/mod.d.ts +16 -2
- package/stores/sql/sqlite/mod.js +246 -51
- package/testing/mod.js +1 -1
- package/plugins/compute/computers/shared/person.d.ts +0 -3
- package/plugins/compute/computers/shared/person.js +0 -8
package/README.md
CHANGED
|
@@ -8,11 +8,11 @@ browser.
|
|
|
8
8
|
|
|
9
9
|
An app is plugins: agents that answer with tools and talk to each other and to people, conversations
|
|
10
10
|
in shared spaces, memory, skills and routines, a usage ledger, people's computers, sign-in and
|
|
11
|
-
connected accounts, a developer API, WhatsApp. Each is a plain object built from the
|
|
12
|
-
primitives (collections, Actions, Processors, Views, resources and adapters), and the
|
|
13
|
-
nothing else. Everything durable is an event, a document, an edge, a vector or a blob,
|
|
14
|
-
one owner to one store (memory, SQLite or PostgreSQL), so every change is on the record
|
|
15
|
-
screen follows it live: in a terminal, in a browser, or in an agent's prompt.
|
|
11
|
+
connected accounts, a developer API, WhatsApp, phone calls. Each is a plain object built from the
|
|
12
|
+
same few primitives (collections, Actions, Processors, Views, resources and adapters), and the
|
|
13
|
+
runtime knows nothing else. Everything durable is an event, a document, an edge, a vector or a blob,
|
|
14
|
+
written by one owner to one store (memory, SQLite or PostgreSQL), so every change is on the record
|
|
15
|
+
and every screen follows it live: in a terminal, in a browser, or in an agent's prompt.
|
|
16
16
|
|
|
17
17
|
## Install
|
|
18
18
|
|
|
@@ -22,10 +22,10 @@ bun add copilotz # Bun
|
|
|
22
22
|
deno add jsr:@copilotz/copilotz # Deno (or `deno add npm:copilotz`)
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
-
On Deno, name it `copilotz` in `deno.json` (`"copilotz": "jsr:@copilotz/copilotz@^1.0.0-rc.
|
|
26
|
-
the imports below are the same everywhere. Some pieces need a package of their own, installed
|
|
27
|
-
it: `esbuild` to bundle the web host on Node, `@electric-sql/pglite` for PostgreSQL in the
|
|
28
|
-
and `@types/react` for the front ends' types.
|
|
25
|
+
On Deno, name it `copilotz` in `deno.json` (`"copilotz": "jsr:@copilotz/copilotz@^1.0.0-rc.21"`),
|
|
26
|
+
and the imports below are the same everywhere. Some pieces need a package of their own, installed
|
|
27
|
+
beside it: `esbuild` to bundle the web host on Node, `@electric-sql/pglite` for PostgreSQL in the
|
|
28
|
+
process, and `@types/react` for the front ends' types.
|
|
29
29
|
|
|
30
30
|
## A first app
|
|
31
31
|
|
|
@@ -98,12 +98,13 @@ The package's entry points, the same names on npm (`copilotz/…`) and JSR (`@co
|
|
|
98
98
|
| `copilotz/stores/latency` | `withLatency(store, ms)`: a store with round trips, to measure |
|
|
99
99
|
| `copilotz/blobs/files` | `fileBlobs({ dir })`: blobs as files |
|
|
100
100
|
| `copilotz/blobs/http` | `httpBlobs({ url, headers })`: blobs in a bucket (S3, GCS, R2…) |
|
|
101
|
+
| `copilotz/blobs/gcs` | `gcsBlobs({ bucket, prefix })`: blobs in a Google Cloud Storage bucket, as the instance's service account |
|
|
101
102
|
| `copilotz/plugins/models` | `models`: llm, embeddings, transcription, the models.dev catalog |
|
|
102
|
-
| `copilotz/plugins/agents` | `chat`, `history`, `memory`, `memoryExtraction`, `team`, `skills`, `routines`, `tool`
|
|
103
|
-
| `copilotz/plugins/agents/web` | their web front ends: `chatWeb`, `teamWeb`, `memoryWeb`, `skillsWeb`, `routinesWeb`
|
|
103
|
+
| `copilotz/plugins/agents` | `chat`, `history`, `memory`, `memoryExtraction`, `team`, `skills`, `routines`, `tiers`, `openapi`, `tool` |
|
|
104
|
+
| `copilotz/plugins/agents/web` | their web front ends: `chatWeb`, `teamWeb`, `memoryWeb`, `skillsWeb`, `routinesWeb`, `tiersWeb` |
|
|
104
105
|
| `copilotz/plugins/agents/terminal` | their terminal front ends: `chatTerminal`, `memoryTerminal` |
|
|
105
|
-
| `copilotz/plugins/access` | `access` (`spaces`, `identity`), `accounts`, `directory`, `googleSignIn`
|
|
106
|
-
| `copilotz/plugins/access/web` | `spacesWeb`, `accountsWeb`
|
|
106
|
+
| `copilotz/plugins/access` | `access` (`spaces`, `identity`, `contacts`), `accounts`, `directory`, `googleSignIn` |
|
|
107
|
+
| `copilotz/plugins/access/web` | `spacesWeb`, `accountsWeb`, `contactsWeb` |
|
|
107
108
|
| `copilotz/plugins/access/terminal` | `accessTerminal` |
|
|
108
109
|
| `copilotz/plugins/billing` | `usage`: the ledger |
|
|
109
110
|
| `copilotz/plugins/billing/web` | `usageWeb` |
|
|
@@ -112,14 +113,14 @@ The package's entry points, the same names on npm (`copilotz/…`) and JSR (`@co
|
|
|
112
113
|
| `copilotz/plugins/compute/web` | `computersWeb` |
|
|
113
114
|
| `copilotz/plugins/compute/terminal` | `computersTerminal` |
|
|
114
115
|
| `copilotz/plugins/compute/downloads` | `computerDownloads`: the computer program's release, served by the app (Node) |
|
|
115
|
-
| `copilotz/plugins/interfaces` | `terminalPlugin` (the terminal's data), `api`, `whatsapp`
|
|
116
|
+
| `copilotz/plugins/interfaces` | `terminalPlugin` (the terminal's data), `api`, `whatsapp`, `voice`, `mcp`, `maintenance` |
|
|
116
117
|
| `copilotz/plugins/interfaces/web` | `webShell` (the web's root View), `apiWeb`, `whatsappWeb` |
|
|
117
118
|
| `copilotz/plugins/interfaces/terminal` | `terminalShell`: the terminal's root View |
|
|
118
119
|
| `copilotz/web` | the web host in the browser (`web`), and its toolkit (`Button`, `Markdown`…) |
|
|
119
|
-
| `copilotz/web/server` | its server half: `webServer`, `socket`
|
|
120
|
+
| `copilotz/web/server` | its server half: `webServer`, `socket`; `routeHost` (the app's routes alone) |
|
|
120
121
|
| `copilotz/web/tickets` | `createTickets`: sessions traded for one-time tickets |
|
|
121
122
|
| `copilotz/web/theme` | `themeOf(plugins)`: the app's theme, for the page's first paint |
|
|
122
|
-
| `copilotz/web/node` | `bundle` (the browser's code, with esbuild), `serve`, `listen` (HTTP, sockets)
|
|
123
|
+
| `copilotz/web/node` | `bundle` (the browser's code, with esbuild), `serve`, `serveRoutes`, `listen` (HTTP, sockets) |
|
|
123
124
|
| `copilotz/orgs` | `orgsHost`: many orgs behind one address, each a runtime of its own |
|
|
124
125
|
| `copilotz/terminal` | the terminal host: `terminal({ runtime, me })`, and its toolkit |
|
|
125
126
|
| `copilotz/exporters` | `otlp`, `exposition`: metrics out, the OpenTelemetry way |
|
|
@@ -193,6 +194,48 @@ each socket to the runtime of the org its request is for:
|
|
|
193
194
|
`listen({ fetch: host.serve, hypervisor: (request) => host.openRuntime(request)?.hypervisor })`
|
|
194
195
|
(`examples/web-node/orgs.ts`).
|
|
195
196
|
|
|
197
|
+
### Without the web app
|
|
198
|
+
|
|
199
|
+
An app people use on WhatsApp or on the phone needs no page: `serveRoutes` serves its plugins'
|
|
200
|
+
routes alone (`routes` resources: Meta's webhook, Twilio's), `GET /health` for whatever watches it,
|
|
201
|
+
and 404 for anything else. Nobody signs in there: a route's Action is called as a visitor, and its
|
|
202
|
+
`allow` decides (a webhook checks the request's signature, then acts for the person it's from with
|
|
203
|
+
`ctx.as`). Deno and Bun run it too.
|
|
204
|
+
|
|
205
|
+
```ts
|
|
206
|
+
import { createRuntime } from "copilotz";
|
|
207
|
+
import { serveRoutes } from "copilotz/web/node";
|
|
208
|
+
|
|
209
|
+
const runtime = await createRuntime({ store, plugins });
|
|
210
|
+
const server = await serveRoutes({ runtime, hostname: "0.0.0.0", port: 8080 });
|
|
211
|
+
// A deploy's SIGTERM: stop listening, give running turns a while, close the runtime.
|
|
212
|
+
process.once("SIGTERM", () => server.close({ drain: 8_000 }));
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
A `serve` route may take a WebSocket of its own (a voice call's relay): `host.upgrade()` accepts the
|
|
216
|
+
request's upgrade, and the route answers with the response it gives. It can refuse first (`403`,
|
|
217
|
+
before any handshake). The socket is a browser's `WebSocket` as far as `onmessage`, `send` and
|
|
218
|
+
`close` go; the listener (`serveRoutes`, or the web host's `serve`) takes it.
|
|
219
|
+
|
|
220
|
+
```ts
|
|
221
|
+
routes: {
|
|
222
|
+
relay: {
|
|
223
|
+
path: "/voice/relay",
|
|
224
|
+
serve: (request, host) => {
|
|
225
|
+
if (!signed(request)) return new Response("Forbidden", { status: 403 });
|
|
226
|
+
const { socket, response } = host.upgrade();
|
|
227
|
+
socket.onmessage = async (event) => socket.send(await answer(host.runtime, event.data));
|
|
228
|
+
return response;
|
|
229
|
+
},
|
|
230
|
+
},
|
|
231
|
+
},
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
A runtime that declares the `socket` transport (remote executors) still takes its sockets at
|
|
235
|
+
`/oxian`. `routeHost(runtime)` (`copilotz/web/server`) is the same as a fetch handler, for another
|
|
236
|
+
listener; a route's socket needs Oxian's (`copilotz/web/node`'s). The example is
|
|
237
|
+
`examples/web-node/routes.ts`.
|
|
238
|
+
|
|
196
239
|
## Installing a computer
|
|
197
240
|
|
|
198
241
|
People's computers run the computer program (`plugins/compute/computers/program/`), a single
|
|
@@ -204,7 +247,7 @@ and an app serves it from there by default:
|
|
|
204
247
|
import { computerDownloads } from "copilotz/plugins/compute/downloads";
|
|
205
248
|
|
|
206
249
|
plugins: [...plugins, await computerDownloads()], // this Copilotz's release
|
|
207
|
-
plugins: [...plugins, await computerDownloads({ dir: "dist/computer/1.0.0-rc.
|
|
250
|
+
plugins: [...plugins, await computerDownloads({ dir: "dist/computer/1.0.0-rc.21" })], // its own: /computer/download/
|
|
208
251
|
plugins: [...plugins, await computerDownloads({ url: "https://downloads.example.com/computer/" })], // or elsewhere
|
|
209
252
|
```
|
|
210
253
|
|
|
@@ -303,11 +346,23 @@ name, never by importing its code.
|
|
|
303
346
|
**`agents/`**: conversations and the agents in them.
|
|
304
347
|
|
|
305
348
|
- **`chat`**: threads, messages, and agents
|
|
306
|
-
(`{ instructions, model, effort?, maxTokens?, temperature?, tools? }`) that answer with
|
|
307
|
-
calling models through `llm`. A reasoning model's thinking (its provider state) is kept on
|
|
308
|
-
agent's tool steps and goes back to that model while its turn goes on.
|
|
349
|
+
(`{ instructions, model, effort?, maxTokens?, temperature?, tools?, history? }`) that answer with
|
|
350
|
+
tools, calling models through `llm`. A reasoning model's thinking (its provider state) is kept on
|
|
351
|
+
the agent's tool steps and goes back to that model while its turn goes on.
|
|
309
352
|
- **Several agents** take turns in parallel. With `send_message` an agent messages another agent
|
|
310
353
|
or a person, and waits for the replies before it continues.
|
|
354
|
+
- **History by age:** an agent with `history: { maxAge: 4 * 3_600_000 }` (ms) is sent only the
|
|
355
|
+
last four hours of a conversation, back from its newest message (summaries too, with `history`);
|
|
356
|
+
what's older stays in the chat. The start moves in steps of a tenth of `maxAge`, so prompts keep
|
|
357
|
+
hitting the provider's cache ([design](design/views.md#history-as-views)).
|
|
358
|
+
- **A tool call runs once:** before a step's tools run, the step's calls are written (an
|
|
359
|
+
`intent`), and what each returns as soon as it does. A retried turn (it failed after its tools
|
|
360
|
+
ran, its executor died, the runtime restarted) goes on with those calls instead of asking its
|
|
361
|
+
model again: a call that returned isn't run again, and one cut short runs again as itself, with
|
|
362
|
+
the same `ctx.callId` and `ctx.retry` true. Pass `callId` to an outside API as the idempotency
|
|
363
|
+
key, or call recorded Actions (they answer from the log), and a payment behind a tool is made
|
|
364
|
+
once. A turn that ends without its step (failed for good, stopped) keeps it, saying which calls
|
|
365
|
+
never returned, so people and its later turns know what happened.
|
|
311
366
|
- **Subthreads are forks:** whoever works in one sees the conversation up to the message it hangs
|
|
312
367
|
from, through every level, without anything being copied. A new thread starts from its first
|
|
313
368
|
message and records the thread it came from.
|
|
@@ -326,6 +381,16 @@ name, never by importing its code.
|
|
|
326
381
|
the `transcribe` model alias), and agents read the transcript. If it fails nothing is sent
|
|
327
382
|
(`transcription_failed`); `transcribe: false` sends audio as it is. A voice message may say
|
|
328
383
|
nothing else; its file carries `voice` (duration, peaks) for its player.
|
|
384
|
+
- **In spaces:** chat declares its own `shared` entries (threads, messages with labels, files,
|
|
385
|
+
what's being written), so an app with the access plugin needn't. A chat's messages, files and
|
|
386
|
+
live writing are part of it (`part: "thread"`): shared on its own (with a contact), its parts
|
|
387
|
+
come with it. `chat.open` opens an empty chat in a space; `chat.say` has an agent say a fixed
|
|
388
|
+
message there without a turn (trusted code only: a payment confirmed), which goes out like any
|
|
389
|
+
of its answers.
|
|
390
|
+
- **After an answer:** a medium that can (WhatsApp) shows features' additions
|
|
391
|
+
(`resources.additions.<name> = { order?, agents? }` and an `addition:<name>` View there), each
|
|
392
|
+
once per chat per key, recorded in `shown`; the model is told what went (`[then shown: …]`). A
|
|
393
|
+
message tapped from a button carries `tap: { id, title, key }`, and agents read the id.
|
|
329
394
|
- **`history`** keeps chat history from outgrowing the prompt
|
|
330
395
|
(`resources: { history: { summarizer: "openai/gpt-5.4-mini" } }`): every message stays whole, a
|
|
331
396
|
cheap model writes a line for each and merges pairs up a binary tree, and an agent gets recent
|
|
@@ -354,6 +419,23 @@ name, never by importing its code.
|
|
|
354
419
|
- **`routines`**: a message sent to an agent on a schedule, in a space ("every weekday at 9:00, ask
|
|
355
420
|
@researcher for the news"), as whoever made it, reaching only what they reach; each run's chat and
|
|
356
421
|
outcome are kept. Agents make them from a conversation too (`schedule_routine`).
|
|
422
|
+
- **`tiers`**: which models the app's agents think with, named by what the work needs (Everyday,
|
|
423
|
+
Expert…): the app declares each tier's model for each agent; an org chooses one, a space can
|
|
424
|
+
choose another, and either can pick a model for one agent, the tier's list kept behind it. Kept by
|
|
425
|
+
name, so retuning a tier moves everyone on it; while an org hasn't chosen, its plan's tier
|
|
426
|
+
applies. Each tier shows what a typical reply comes to at the org's prices.
|
|
427
|
+
- **`openapi`**: an HTTP API's operations, from its OpenAPI 3 spec, as Actions and tools:
|
|
428
|
+
`openapi({ name: "trips", spec })` is a plugin with, for each operation, a recorded Action
|
|
429
|
+
(`trips.getTrip`: a turn tried again gets the call it already made back, not a second one) and a
|
|
430
|
+
tool calling it (`trips_getTrip`), which agents get by listing it in their `tools`. A tool's input
|
|
431
|
+
is one object: the path, query, header and cookie parameters beside the JSON body's properties
|
|
432
|
+
(refs followed; 3.0's `nullable` converted; read-only properties left out; two inputs of one name
|
|
433
|
+
fail). Its settings are a resource (`resources.openapi.trips`: `baseUrl`, `headers` static or a
|
|
434
|
+
hook per call, `query`, `timeout`, `maxBytes`), so a deployment says where and as whom. A failed
|
|
435
|
+
call says `HTTP <status>: <what the API said>` and carries its status. Files in a response (an
|
|
436
|
+
image as base64 or a data URL, in the fields `files` names, or a response that is one) become
|
|
437
|
+
files of the conversation, and the agent gets a reference instead (`maxFileBytes`, `fileTypes`). A
|
|
438
|
+
tool of your own is `{ ...trips.tools.getTrip, run }`.
|
|
357
439
|
|
|
358
440
|
**`access/`**: who can see and do what (see [design/access.md](design/access.md)).
|
|
359
441
|
|
|
@@ -364,6 +446,12 @@ name, never by importing its code.
|
|
|
364
446
|
it's one; a new space has the app's default agents. An answer drawn from a space not everyone in
|
|
365
447
|
the conversation can see shows only to those who see both, marked, until someone shares it.
|
|
366
448
|
- **`identity`**: people, sessions and keys, and who a secret proves.
|
|
449
|
+
- **`contacts`**: people outside the org who talk to its agents (a WhatsApp customer). A contact is
|
|
450
|
+
its own kind of actor (`{ kind: "contact", id }`), never a person: every Action and query stays
|
|
451
|
+
shut to it unless it says otherwise (`peopleOrContacts`, as `chat.send` does). Its chat lives in
|
|
452
|
+
the line's space and is shared with it on its own: it reaches that chat, what's said and filed
|
|
453
|
+
there, and nothing else; the space's people reach it as any chat there, and the agent working for
|
|
454
|
+
the contact reaches exactly that chat. Agents are told whom they're talking with.
|
|
367
455
|
- **`googleSignIn`**: sign-in with a Google ID token (the `google` resource names your client).
|
|
368
456
|
- **`accounts`**: outside accounts a person connects once, for their agents to use: first their
|
|
369
457
|
ChatGPT plan, as a model provider, instead of the app's API key. Tokens are a private field only
|
|
@@ -382,9 +470,15 @@ name, never by importing its code.
|
|
|
382
470
|
billing; billing builds on models. An app records its own uses with `usage.record`.
|
|
383
471
|
- **Rated as recorded,** so a record keeps what applied. Cost comes from `resources.cost` (the
|
|
384
472
|
app's rates: negotiated, a subscription at 0, compute by the second), else from the catalog's
|
|
385
|
-
prices
|
|
386
|
-
|
|
387
|
-
|
|
473
|
+
prices (each kind of token at its own: input, cache reads and writes, output, reasoning). The
|
|
474
|
+
price is the cost, a margin of 0, unless `resources.price` says otherwise: rates of its own, or
|
|
475
|
+
a gross margin on the cost (`{ "*": { margin: 0.2 }, "cloud/*": { margin: 0.9 } }`: 0.9 is ten
|
|
476
|
+
times the cost). Rates are keyed by subject, then `provider/*`, then the catalog, then `*`, and
|
|
477
|
+
dated lists apply each rate from its `since`, so a new margin applies from its date on. Each
|
|
478
|
+
record keeps its cost and price by part too, and what caching saved. A use nothing prices is
|
|
479
|
+
kept and flagged `unpriced`.
|
|
480
|
+
- **People see prices** (what they're charged); costs, and so margins, only platform staff and the
|
|
481
|
+
system.
|
|
388
482
|
- **Totals** by any field or tag, summed by the store (`aggregate`) over indexed fields (time,
|
|
389
483
|
meter, subject, thread; more from the app:
|
|
390
484
|
`collections: { usage: { indexes: [["tags.tenant", "at"]] } }`):
|
|
@@ -398,8 +492,19 @@ name, never by importing its code.
|
|
|
398
492
|
from an older day. `schedules: { "usage.close": null }` turns them off.
|
|
399
493
|
- **Re-rating** (`usage.rerate`) never changes a record: it appends adjustments, dated when made,
|
|
400
494
|
and totals follow.
|
|
401
|
-
- **
|
|
402
|
-
|
|
495
|
+
- **Categories:** each meter is one (`llm`, `embeddings` and `transcription` are agents',
|
|
496
|
+
`computer` computers', `app` apps'; any other its own); totals group and filter by `category`,
|
|
497
|
+
and rollups serve it. Rollups keep `tags.space` too; days rolled up in another shape are closed
|
|
498
|
+
again, and read from records until then.
|
|
499
|
+
- **Across an org:** `usage.org` (totals, naming what they're grouped by as the caller reaches it)
|
|
500
|
+
and `usage.activity` (agents' turns, computers' sessions, apps' days and conversations' upkeep,
|
|
501
|
+
newest first): owners and admins see everyone's, anyone else their own. What a tag points to is
|
|
502
|
+
named by the plugin that owns it, in the `usageNames` resource kind
|
|
503
|
+
(`{ tag: "tags.app", collection: "app", field: "name" }`); a tag nobody names shows as its id.
|
|
504
|
+
- **On the web** (`usageWeb`): an org's Usage page: the billing month's spend against the budget
|
|
505
|
+
and credits left (from the credits plugin, when it's there) and the same point last month; a
|
|
506
|
+
daily chart and a ranked list by kind, space, person, agent or model, whose rows filter the
|
|
507
|
+
page; and activity. Staff see cost and margin in place.
|
|
403
508
|
|
|
404
509
|
**`compute/`**: **`computers`**, machines people connect (the computer program in
|
|
405
510
|
`computers/program/`, a worker of the plugin's `computer` kind) and their desks, one per space
|
|
@@ -420,7 +525,42 @@ filled by the front ends through resources).
|
|
|
420
525
|
server-sent events, as that person, in that space only.
|
|
421
526
|
- **`whatsapp`**: people talk to their agents from WhatsApp, through Meta's Cloud API. A space's
|
|
422
527
|
managers connect a number; a person links their phone with a code; what they send becomes their
|
|
423
|
-
messages, and what agents say to them goes back, a long answer in several messages.
|
|
528
|
+
messages, and what agents say to them goes back, a long answer in several messages. It's a medium
|
|
529
|
+
for Views (renderer `whatsapp`, parts built with its toolkit: text, buttons, a list, a carousel,
|
|
530
|
+
an image, a document, each checked against Meta's limits): after an answer, features show more
|
|
531
|
+
(`additions`: a carousel of trips, buttons to pay), once per chat per key, the answer's text in
|
|
532
|
+
the same message when there's room, a fallback when Meta refuses one; taps come back with their
|
|
533
|
+
ids. Pictures and files go as public links, signed links to the app's routes or files (the `links`
|
|
534
|
+
resource, `{ origin, secret }`; the runtime's `signLink`, `verifyLink`), or uploads. Opened to
|
|
535
|
+
anyone (`whatsapp.set`, or declared in the app's settings: `whatsapp.lines`), a number is a
|
|
536
|
+
customer line: a stranger who writes is a contact, in a chat of their own in the number's space,
|
|
537
|
+
answered by its agent, and a chat quiet for the number's `gap` (12 hours) is over: their next
|
|
538
|
+
message starts a new one.
|
|
539
|
+
- **`voice`**: people call the app's phone number and talk to its agents, through Twilio's
|
|
540
|
+
ConversationRelay (Twilio hears them and speaks; the app gets and sends text). The app declares
|
|
541
|
+
its lines (`voice.lines`: the space, Twilio's account and auth token, the app's public address,
|
|
542
|
+
the agent, language, voice, greeting and limits); Twilio's webhook is checked against its
|
|
543
|
+
signature, a call is taken within its caller's limits and the line's (calls at once, a day: else
|
|
544
|
+
busy, nothing spent) and opens the line's socket with a one-time ticket. A caller is a contact in
|
|
545
|
+
a chat of their own, the same one when they call back only if Twilio verified their number; what
|
|
546
|
+
the agent writes for them is said as it writes it (a medium for Views: renderer `voice`), a caller
|
|
547
|
+
speaking over it cuts it there (the agent is told what was heard), a failed or slow answer says a
|
|
548
|
+
short line in the line's language, and silence, a call too long or too many prompts, or the
|
|
549
|
+
agent's `end_call` end it. Managers block a caller (`voice.block`). Its socket needs a host that
|
|
550
|
+
takes a route's socket (`serveRoutes`).
|
|
551
|
+
- **`mcp`**: models outside the app (ChatGPT, Claude, any MCP client) call its tools. A line the app
|
|
552
|
+
declares (`mcp.lines.<name>`: its space, the tools it lists, each with its `tool:<name>` View, how
|
|
553
|
+
each is shown, who calls, its limits) is an MCP server at `POST /mcp/<name>`: Streamable HTTP,
|
|
554
|
+
JSON-RPC 2.0, no session, MCP 2026-07-28 and the versions with a handshake. Each conversation
|
|
555
|
+
(ChatGPT's `openai/session`, or a `chat` handle the app gives a client that names none) is a
|
|
556
|
+
contact in a chat of its own in the line's space, its ids an HMAC with the `links` secret. A call
|
|
557
|
+
runs the tool through chat's runner as that contact, is written there as a step, and answers what
|
|
558
|
+
the app's agents read of it (only public errors say their words); a request sent again to a tool
|
|
559
|
+
that changes things is answered from the first, and the line's limits (calls at once, a minute,
|
|
560
|
+
new conversations an hour, by conversation, user, caller's address and in all) refuse the rest.
|
|
561
|
+
- **`maintenance`**: HTTP for an app's operators when they can't reach its database, with one key:
|
|
562
|
+
read SQL, the collections' operations through the owner, raw SQL writes inside it, blobs by id
|
|
563
|
+
(see [Maintenance](#maintenance)).
|
|
424
564
|
|
|
425
565
|
**Metrics** (`copilotz/exporters`): what the runtime and plugins do, measured. There's no plugin to
|
|
426
566
|
add: each plugin instruments itself.
|
|
@@ -494,7 +634,163 @@ one conformance suite (`stores/tests/`). [`stores/README.md`](stores/README.md)
|
|
|
494
634
|
and lists exactly which parts of the MongoDB collection API they support, and how. A PostgreSQL
|
|
495
635
|
store holds one tenant (an org): many share a schema, each kept apart by the store itself, and an
|
|
496
636
|
org's rows copy elsewhere unchanged (`copyTenant`). Blobs (strings over 16 KiB, files people send)
|
|
497
|
-
live in the store by default, or as files (`fileBlobs`)
|
|
637
|
+
live in the store by default, or as files (`fileBlobs`), in a bucket (`httpBlobs`), or in Google
|
|
638
|
+
Cloud Storage (`gcsBlobs`).
|
|
639
|
+
|
|
640
|
+
## Maintenance
|
|
641
|
+
|
|
642
|
+
When an app's operators can't reach its database (a client's network that keeps their database user
|
|
643
|
+
out), the `maintenance` plugin (`copilotz/plugins/interfaces`) answers for it over HTTP, under
|
|
644
|
+
`/maintenance/`, with a key the app gives it:
|
|
645
|
+
`resources: { maintenance: { key: process.env.MAINTENANCE_KEY } }`. It's the one place an app runs
|
|
646
|
+
SQL of its own: plugin code never does.
|
|
647
|
+
|
|
648
|
+
```sh
|
|
649
|
+
curl https://app.example.com/maintenance/sql -H "authorization: Bearer $KEY" \
|
|
650
|
+
-d '{"sql": "SELECT _id, text FROM message WHERE thread = $1", "params": ["t1"]}'
|
|
651
|
+
```
|
|
652
|
+
|
|
653
|
+
| Endpoint | What it does |
|
|
654
|
+
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
|
|
655
|
+
| `GET /maintenance/` | What's here: whether the store runs SQL, the collections, the limits |
|
|
656
|
+
| `POST /maintenance/sql` | `{ sql, params?, limit?, timeout? }`: one read-only statement: `{ rows, count, truncated, ms }` |
|
|
657
|
+
| `POST /maintenance/sql/write` | `{ sql, params?, limit?, timeout? }`: one that writes, in the owner: `{ changed, rows, event }` |
|
|
658
|
+
| `POST /maintenance/collections/<collection>/<op>` | `insertOne` `{ doc }`… `deleteMany` `{ filter }`, and `find`, `findOne`, `countDocuments`, `aggregate` |
|
|
659
|
+
| `POST /maintenance/queries/<collection>.<name>` | A collection's named query (`booking.stats`), the body its params: `{ result, ms }` |
|
|
660
|
+
| `GET /maintenance/blobs/<sha256-…>` | A blob's bytes and type, as a download |
|
|
661
|
+
|
|
662
|
+
- **Keys:** `key`, or several in `keys` while one rotates (add the new, move clients, drop the old).
|
|
663
|
+
Each is at least 32 random characters: a short one, or one plainly not random, stops the app from
|
|
664
|
+
starting. Every request shows one (`Authorization: Bearer <key>`), compared in constant time;
|
|
665
|
+
without a key configured, every request is unauthorized, the same answer as a wrong key.
|
|
666
|
+
- **Who:** a request acts as the maintenance actor
|
|
667
|
+
(`{ kind: "maintenance", id: "maintenance", by }`, `by` from `X-Maintenance-By`, as said). Its
|
|
668
|
+
Actions let only it call them, and run as the system on the record (`ctx.as()`): no rule keeps it
|
|
669
|
+
from a document, and every event says `via` it. Writes take an `Idempotency-Key`: sent again, one
|
|
670
|
+
answers what it did the first time.
|
|
671
|
+
- **On record twice:** before it runs, each request writes a line (`log`, by default JSON on
|
|
672
|
+
standard output, which Cloud Run keeps): who, what (a statement's SHA-256, its params' count; an
|
|
673
|
+
operation, a query, a blob), which key, when. A SQL write also records a `maintenance.sql` event
|
|
674
|
+
in the same commit. The line is the record the key's holder can't rewrite.
|
|
675
|
+
- **Limits:** `limit` rows (1,000), `timeout` ms (30 s) and `bytes` of rows in an answer (8 MB; past
|
|
676
|
+
it the rows are cut, and `truncated` says so). A request may ask for less. A pipeline stops at the
|
|
677
|
+
limit too.
|
|
678
|
+
- **Operations go through the owner's write path:** checked against the collection's schema,
|
|
679
|
+
recorded as its events, cached and heard by Processors like any write. Prefer them. Named queries
|
|
680
|
+
run as the system does them (`runtime.query` with no actor), and check their own params.
|
|
681
|
+
- **Read SQL** is one statement (a `;` outside its strings and comments ends it; PostgreSQL's line
|
|
682
|
+
comments end at a CR too, and maintenance reads strings with `standard_conforming_strings` on) in
|
|
683
|
+
a read-only transaction, always rolled back, stopped at its limit and cut off at its timeout.
|
|
684
|
+
- **Raw SQL writes run inside the owner** (`runtime.maintenance.write`, see `runtime/maintain.ts`),
|
|
685
|
+
for what operations can't do: alone among its writes (those running end first, the next wait for
|
|
686
|
+
it), in a transaction fenced by its epoch, so an owner that lost the store can't run one, with its
|
|
687
|
+
`maintenance.sql` event in the same commit (the statement, its params, the rows it changed in any
|
|
688
|
+
table, who). It bypasses schemas and per-document events, so the owner then forgets what it
|
|
689
|
+
derived from documents: its cache empties, observed Views run again, and the clock reads the
|
|
690
|
+
timers again. A statement that ends or nests its transaction (`COMMIT`, `SAVEPOINT`…) or changes
|
|
691
|
+
its connection (`SET`, `PREPARE`, `LISTEN`, SQLite's `ATTACH`, `PRAGMA`…) doesn't run, and in
|
|
692
|
+
PostgreSQL neither does one that reaches past the statement: `ALTER ROLE` (a role may set its own
|
|
693
|
+
password and settings, which outlive the key), `DO` (a block runs statements nothing reads first)
|
|
694
|
+
and `LOCK` (it would hold the store's tables against the app's own writes). A write still holds
|
|
695
|
+
the row locks it takes (the rows an `UPDATE` changes) until it commits: app writes to those rows
|
|
696
|
+
wait, at most its `timeout`, and with at most 2 maintenance statements at once. One that changes
|
|
697
|
+
the store's own state (`meta`: the fencing epoch, Processors' positions), or what the role holds
|
|
698
|
+
(a large object, a setting), or, in SQLite, leaves a temporary object, is rolled back. The record
|
|
699
|
+
keeps a password literal as `PASSWORD '***'`.
|
|
700
|
+
- **Nothing outlives its statement:** on a PostgreSQL server each statement runs on a connection of
|
|
701
|
+
its own, closed after, so what it sets on its session (a setting, a session lock, a prepared
|
|
702
|
+
statement) goes with it; and it goes over the extended protocol, where the server refuses a second
|
|
703
|
+
statement whatever the check said. PGlite has one session: it forgets what maintenance left there
|
|
704
|
+
(`DISCARD ALL`). A SQLite read runs apart, in a process of this runtime of its own on a read-only
|
|
705
|
+
connection, killed at its timeout: a statement that never ends doesn't hold the app, a core or the
|
|
706
|
+
WAL. The process is `deno`, `node` or `bun` itself (never a compiled app, which would be the app
|
|
707
|
+
again), with an empty environment, and on Deno and Node allowed to read the database's files and
|
|
708
|
+
nothing else; on Deno it's started only with permission to run already granted, so nothing ever
|
|
709
|
+
asks mid-request. Where none can start (a database opened another way, `:memory:`, a compiled app,
|
|
710
|
+
no permission), reads run on the store's reading connection, one at a time, with no timeout, a
|
|
711
|
+
pragma only from those that only read: the store says so once, with why, and each such answer says
|
|
712
|
+
`inline: true`. SQLite writes name the store's tables in `main`, so nothing temporary stands in
|
|
713
|
+
for them. Each store runs at most 2 maintenance statements at once
|
|
714
|
+
(`maintenance: { connections }`): another answers busy (503).
|
|
715
|
+
- **Where:** SQL needs a SQL store. On a PostgreSQL server only as a role of its own (below), never
|
|
716
|
+
in a schema other tenants share; PGlite, in the app's process, runs it as its one session where it
|
|
717
|
+
reaches no other schema. An orgs host's orgs don't get the plugin at all (one key would reach
|
|
718
|
+
every org). Operations, named queries and blobs work everywhere, the memory store too, and need no
|
|
719
|
+
role.
|
|
720
|
+
|
|
721
|
+
### A role of its own
|
|
722
|
+
|
|
723
|
+
On a PostgreSQL server, raw SQL runs only as a role of its own, named by the store:
|
|
724
|
+
`postgresStore({ url, schema, maintenance: { url: process.env.MAINTENANCE_DATABASE_URL } })`.
|
|
725
|
+
Without one it's refused. The store's role owns the tables, may stop the app's connections and is
|
|
726
|
+
whatever the deployment made it (a superuser, even): nothing that runs at a key's word should be it.
|
|
727
|
+
|
|
728
|
+
Before each statement, on the connection that runs it, and again after a write in its transaction,
|
|
729
|
+
maintenance checks that the role holds exactly what the SQL below grants, and refuses it otherwise
|
|
730
|
+
(rolling a write back), saying what's more: an attribute beyond `LOGIN` (superuser, `CREATEROLE`…);
|
|
731
|
+
membership in any role at all, predefined (`pg_*`) or not, and whatever its `INHERIT` or `SET`
|
|
732
|
+
options (a member could `SET ROLE` to it); settings of its own (`ALTER ROLE … SET`); anything it
|
|
733
|
+
owns, a large object too (what it makes for its own session, a temporary table, goes with its
|
|
734
|
+
connection); anything granted to it outside the store's schema and database; `CREATE` on any schema
|
|
735
|
+
(`public` too) or on the database; any privilege on a table or a column of another schema; on the
|
|
736
|
+
store's own tables, anything beyond the grants below (no `TRIGGER`, `TRUNCATE` or `REFERENCES`; on
|
|
737
|
+
`events` only `INSERT`); a large object it may read (`lo_compat_privileges`, or one granted to
|
|
738
|
+
`PUBLIC`); a `SECURITY DEFINER` function it may run (one runs as its owner); `dblink` or
|
|
739
|
+
`postgres_fdw` in the database; and a trigger on the store's tables, which the store never makes.
|
|
740
|
+
The checks name every catalog they read as `pg_catalog`'s, after setting the search path back to it,
|
|
741
|
+
so nothing a statement made stands in for them.
|
|
742
|
+
|
|
743
|
+
Prefer a role with no password at all, signed in by the platform: Cloud SQL's IAM database
|
|
744
|
+
authentication, or a client certificate. A password is a second key, valid for as long as nobody
|
|
745
|
+
changes it. On Cloud SQL, with a service account of its own for maintenance:
|
|
746
|
+
|
|
747
|
+
```sh
|
|
748
|
+
gcloud sql users create maintenance@PROJECT.iam --instance=INSTANCE --type=cloud_iam_service_account
|
|
749
|
+
gcloud projects add-iam-policy-binding PROJECT \
|
|
750
|
+
--member=serviceAccount:maintenance@PROJECT.iam.gserviceaccount.com \
|
|
751
|
+
--role=roles/cloudsql.instanceUser # and roles/cloudsql.client, to connect
|
|
752
|
+
# The app reaches it through the Cloud SQL Auth Proxy, which signs it in (no password):
|
|
753
|
+
# cloud-sql-proxy --auto-iam-authn --impersonate-service-account=maintenance@PROJECT.iam.gserviceaccount.com \
|
|
754
|
+
# --port 5433 PROJECT:REGION:INSTANCE
|
|
755
|
+
# MAINTENANCE_DATABASE_URL=postgres://maintenance%40PROJECT.iam@127.0.0.1:5433/DATABASE
|
|
756
|
+
```
|
|
757
|
+
|
|
758
|
+
Cloud SQL makes such a role a member of its own marker role (`cloudsqliamserviceaccount`, or
|
|
759
|
+
`cloudsqliamuser` for a person): that one membership is allowed, without ADMIN OPTION. Every IAM
|
|
760
|
+
user is a member of the marker too, so the marker may hold nothing at all: grant it nothing, not
|
|
761
|
+
even the grants below (maintenance refuses a marker that holds anything). Then the grants below,
|
|
762
|
+
naming `"maintenance@PROJECT.iam"`.
|
|
763
|
+
|
|
764
|
+
Elsewhere, as the store's role (the schema's owner), with the schema made (the app has started
|
|
765
|
+
once), and as a role that may create roles for the first line:
|
|
766
|
+
|
|
767
|
+
```sql
|
|
768
|
+
-- LOGIN and nothing else; never grant it a role. (On Cloud SQL with IAM, gcloud makes it.)
|
|
769
|
+
CREATE ROLE copilotz_maintenance LOGIN PASSWORD '…' NOINHERIT;
|
|
770
|
+
GRANT USAGE ON SCHEMA copilotz TO copilotz_maintenance;
|
|
771
|
+
-- Reading everything there, the collections' views too, now and later.
|
|
772
|
+
GRANT SELECT ON ALL TABLES IN SCHEMA copilotz TO copilotz_maintenance;
|
|
773
|
+
ALTER DEFAULT PRIVILEGES IN SCHEMA copilotz GRANT SELECT ON TABLES TO copilotz_maintenance;
|
|
774
|
+
-- Changing documents, edges, vectors and blobs.
|
|
775
|
+
GRANT INSERT, UPDATE, DELETE ON copilotz.nodes, copilotz.edges, copilotz.vectors, copilotz.blobs
|
|
776
|
+
TO copilotz_maintenance;
|
|
777
|
+
-- Appending to the log (its own audit events), never changing it.
|
|
778
|
+
GRANT INSERT ON copilotz.events TO copilotz_maintenance;
|
|
779
|
+
-- Holding the fence while it writes (FOR SHARE needs it); a statement that changes meta is rolled back.
|
|
780
|
+
GRANT UPDATE (value) ON copilotz.meta TO copilotz_maintenance;
|
|
781
|
+
-- PostgreSQL 14 and earlier let everyone create in public.
|
|
782
|
+
REVOKE CREATE ON SCHEMA public FROM PUBLIC;
|
|
783
|
+
```
|
|
784
|
+
|
|
785
|
+
Replace `copilotz` with the store's schema. `PUBLIC` keeps `CONNECT` on the database, `TEMPORARY`,
|
|
786
|
+
and `USAGE` on `public`; those are allowed. A `SECURITY DEFINER` function can be run by everyone
|
|
787
|
+
(`PUBLIC`) unless revoked: find them, and revoke it from each (or maintenance refuses, naming them):
|
|
788
|
+
|
|
789
|
+
```sql
|
|
790
|
+
SELECT p.oid::regprocedure FROM pg_proc p WHERE p.prosecdef
|
|
791
|
+
AND p.pronamespace NOT IN ('pg_catalog'::regnamespace, 'information_schema'::regnamespace);
|
|
792
|
+
REVOKE EXECUTE ON FUNCTION some_schema.some_function(…) FROM PUBLIC;
|
|
793
|
+
```
|
|
498
794
|
|
|
499
795
|
## The example app
|
|
500
796
|
|
|
@@ -533,7 +829,7 @@ connects a computer to it; `/approve once|thread|always|no` answers what agents
|
|
|
533
829
|
|
|
534
830
|
Inside the chat: `/new`, `/threads`, `/open <n>`, `/history`, `/memories`, `/usage [all]`,
|
|
535
831
|
`/metrics [name]` (with `OTEL_EXPORTER_OTLP_ENDPOINT` set, metrics also go to that collector),
|
|
536
|
-
`/prompt [agent]`, `/fork`, `/retry`, `/events [n]`, `/stats`, `/sql <query>` (
|
|
832
|
+
`/prompt [agent]`, `/fork`, `/retry`, `/events [n]`, `/stats`, `/sql <query>` (a SQL store),
|
|
537
833
|
`/quit`. Every turn prints its time, its database round trips, the jobs sent to executors and the
|
|
538
834
|
calls they made back to the owner.
|
|
539
835
|
|
|
@@ -575,6 +871,14 @@ The log records what happened, with no bookkeeping tables beside it:
|
|
|
575
871
|
completion is the only extra commit.
|
|
576
872
|
- `started` records the call's own `startedAt`; `completed` and `failed` record its duration in
|
|
577
873
|
`ms`. An event's `at` is its commit time. An action opts out with `record: false`.
|
|
874
|
+
- **Private fields** (`private: ["buyer", "passengers"]` on an Action, dot paths as a
|
|
875
|
+
collection's): its calls are recorded without them, in `started`'s input and `completed`'s
|
|
876
|
+
result alike, so personal data a call is given stays out of the log while the call is still
|
|
877
|
+
recorded and retried. Its `inputHash` (and a nested call's id) still covers the whole input: a
|
|
878
|
+
retry with the same input finds the call, and a changed one is a new call. That hash is in the
|
|
879
|
+
log: whoever knows the rest of an input could check a guess of a field easy to guess alone (a
|
|
880
|
+
CPF) against it. A result that had any is kept whole in `sys.results`, with the completion
|
|
881
|
+
(`private: true` there), so a retry answers with all of it.
|
|
578
882
|
- **Retries.** The log is the receipt store; no other table holds them.
|
|
579
883
|
- `runtime.call(action, input, { id })` makes a call retryable. If that id already completed, the
|
|
580
884
|
call returns its recorded result without running; if it's still running, the call joins it;
|
|
@@ -592,6 +896,10 @@ The log records what happened, with no bookkeeping tables beside it:
|
|
|
592
896
|
- **Processor deliveries:** every failed attempt records `processor.retried`
|
|
593
897
|
`{ attempt, after, error }` before the next one. After the last attempt, `processor.failed`
|
|
594
898
|
`{ attempts, error }` is the dead letter.
|
|
899
|
+
- **Closing:** `runtime.close()` starts no more deliveries or timer occurrences, and gives the
|
|
900
|
+
running ones `drain` ms to finish (`close({ drain })`, 5 s by default); what's still running
|
|
901
|
+
then stops where it is. A delivery that didn't finish keeps its Processor's cursor before its
|
|
902
|
+
event, so the next owner delivers it again, with `retry`: a deploy never drops one.
|
|
595
903
|
- **Outside effects (payments, emails, outside APIs):** write the intent first, call out with its
|
|
596
904
|
id as the idempotency key, then write the result. The intent's commit carries the call's start,
|
|
597
905
|
so the attempt is on record before anything leaves the system.
|
|
@@ -602,7 +910,12 @@ The log records what happened, with no bookkeeping tables beside it:
|
|
|
602
910
|
any event back to the request that started it.
|
|
603
911
|
- **Blobs.** Strings over 16 KiB (configurable) are stored once, named by the hash of their content
|
|
604
912
|
(`sha256-…`). Documents and events hold `{ $blob, size, type }` in their place. The owner moves
|
|
605
|
-
values out on write and back in on read, so plugin code never sees a reference.
|
|
913
|
+
values out on write and back in on read, so plugin code never sees a reference. Only the owner
|
|
914
|
+
makes them: a `$blob` key anywhere in what plugin code writes, or in what an Action is called
|
|
915
|
+
with, is refused (`invalid`), and so is any part of an update's field path that starts with `$` or
|
|
916
|
+
is `__proto__` (an aggregate's `$group` names no `$…` field either). A path ends at a reference as
|
|
917
|
+
at a string. On read, only an exact reference (those three keys, a `sha256-<64 hex>` id) loads a
|
|
918
|
+
blob; any other object is data. Blob stores take no other id.
|
|
606
919
|
|
|
607
920
|
## Schedules
|
|
608
921
|
|
|
@@ -658,6 +971,8 @@ changed, a limited result lost a member, or an existing document newly matched a
|
|
|
658
971
|
differs between stores); reads inside a transaction, which see the transaction's own writes.
|
|
659
972
|
- **Freshness:** a read that raced a commit to its collection doesn't fill the cache, and a
|
|
660
973
|
transaction's changes reach the cache only once committed, before its events go out.
|
|
974
|
+
- **Maintenance SQL** (see [Maintenance](#maintenance)) changes what the cache can't follow: the
|
|
975
|
+
owner empties it after one commits, and a read in flight across that fills nothing.
|
|
661
976
|
|
|
662
977
|
`runtime/tests/cache.test.ts` checks every cached query against a direct store read after each of
|
|
663
978
|
900 random writes, on every store. `createRuntime({ cache: false })` turns the cache off; `stats()`
|
|
@@ -754,8 +1069,8 @@ Copilotz runs on Node (first), Deno and Bun, and is built for Cloudflare Workers
|
|
|
754
1069
|
beside the runtime, which declares the `socket` transport). A browser reads a collection directly
|
|
755
1070
|
only when a rule speaks for it; anything else, through queries that let its person. Writes are
|
|
756
1071
|
Actions. Plugins answer their own HTTP through the `routes` resource (a webhook, an OAuth
|
|
757
|
-
callback, an API, a download), and files people sent are served at
|
|
758
|
-
read them, with ranges.
|
|
1072
|
+
callback, an API, a download, a socket of their own), and files people sent are served at
|
|
1073
|
+
`/files/<id>` to whoever may read them, with ranges.
|
|
759
1074
|
- **The design system** (`design/views.md`, "The design system"): the web host owns a token
|
|
760
1075
|
vocabulary (shadcn's names) and its defaults, which are Copilotz's look (navy, the logo's cyan and
|
|
761
1076
|
blue, Manrope and Space Grotesk, its logo and icon), and an app rebrands with a `theme` resource
|
|
@@ -800,7 +1115,8 @@ Copilotz runs on Node (first), Deno and Bun, and is built for Cloudflare Workers
|
|
|
800
1115
|
system, which no rule restricts; its events say `via` whom.
|
|
801
1116
|
- Remote executors prove the deployment key, compared in constant time.
|
|
802
1117
|
- **Private fields** (`private: ["token"]` on a collection): what an actor's queries and Views
|
|
803
|
-
read comes without them; Actions and Processors acting for them still read them.
|
|
1118
|
+
read comes without them; Actions and Processors acting for them still read them. No event holds
|
|
1119
|
+
them, on any store, and none holds an Action's (`private: ["buyer"]`) either.
|
|
804
1120
|
- **Processors:** per-key ordering, a durable cursor, at-least-once delivery, made idempotent by
|
|
805
1121
|
deterministic ids. A `where` MongoDB filter on event data keeps unwanted events from being
|
|
806
1122
|
dispatched at all.
|
|
@@ -821,18 +1137,18 @@ runtime/ the engine and its ports (Store, Blobs, Exporter, Transport, Clo
|
|
|
821
1137
|
executor, ops, wire, collection, mongo, the in-memory store; tests/
|
|
822
1138
|
stores/ where the runtime keeps things: the Store port's implementations (memory, sql/
|
|
823
1139
|
sqlite and postgres with a shared translation, the latency wrapper) and Blobs'
|
|
824
|
-
(blobs/files, blobs/http); tests/ (conformance)
|
|
1140
|
+
(blobs/files, blobs/http, blobs/gcs); tests/ (conformance)
|
|
825
1141
|
exporters/ where measurements go: the Exporter port's implementations (OTLP, Prometheus)
|
|
826
1142
|
plugins/ the features, by theme
|
|
827
1143
|
models/ one plugin: llm, embeddings, transcription; shared/ (providers, model choice,
|
|
828
1144
|
models.dev catalog)
|
|
829
|
-
agents/ chat, history, memory, team, skills, routines
|
|
1145
|
+
agents/ chat, history, memory, team, skills, routines, tiers
|
|
830
1146
|
billing/ usage (the ledger)
|
|
831
1147
|
access/ spaces (members, reach, rules), identity, Google sign-in, connected accounts, the
|
|
832
1148
|
directory of orgs
|
|
833
1149
|
compute/ computers: desks per space, agents' tools, approvals; program/, the computer program
|
|
834
1150
|
interfaces/ terminal (where each person is, the shell View), web (the web shell), the developer
|
|
835
|
-
API and
|
|
1151
|
+
API, WhatsApp, voice (phone calls), MCP and maintenance; features'
|
|
836
1152
|
own front ends live with them (chat/terminal.ts, chat/web.tsx…), gathered by theme
|
|
837
1153
|
hosts/ the media the app is used through: terminal (the Ink host and its toolkit); web
|
|
838
1154
|
(the React host in the browser: theme/, the tokens and their defaults, Copilotz's
|
package/hosts/orgs/mod.d.ts
CHANGED
|
@@ -26,7 +26,24 @@
|
|
|
26
26
|
* `{ suspended?, name? }`; `POST …/<id>/move` `{ schema }` (its rows to
|
|
27
27
|
* another schema); `GET …/<id>/export` (its rows, as SQL); `POST
|
|
28
28
|
* …/<id>/delete` `{ confirm: <its name> }`. The app does the rows'
|
|
29
|
-
* part (`operations`). Staff enter any org with `/orgs/enter
|
|
29
|
+
* part (`operations`). Staff enter any org with `/orgs/enter` `{ org, staff:
|
|
30
|
+
* true }`, their own too; without it, they go into theirs as its people. Gift codes:
|
|
31
|
+
* `GET /console/codes`; `POST /console/codes` `{ amount, expires?, until?,
|
|
32
|
+
* note? }` (the code, shown this once); `POST /console/codes/revoke` `{ id }`.
|
|
33
|
+
* - Hosts orgs claimed (`claimHost` in an org's `directory` resource: a
|
|
34
|
+
* preview's `<id>-preview.copilotz.app`, an app's): with the app's own
|
|
35
|
+
* hosts named (`hosts`), a request to any other host is the org's that
|
|
36
|
+
* claimed it, answered by its runtime's routes by host alone (never its
|
|
37
|
+
* page or socket); a host nobody claimed is a 404. Which org a host is
|
|
38
|
+
* kept a minute, forgotten here as soon as an org claims or releases it.
|
|
39
|
+
* - `GET /__copilotz/hosts/resolve?host=<h>`: whose a host is, `{ org,
|
|
40
|
+
* target? }` (or 404), for the app's front only (it carries `front`'s
|
|
41
|
+
* secret): the front sends a host with a target (an app's service)
|
|
42
|
+
* straight there.
|
|
43
|
+
*
|
|
44
|
+
* Behind a front (a Cloudflare worker), `front: { secret }`: a request
|
|
45
|
+
* carrying the secret (`x-copilotz-front`) is for the host it forwards
|
|
46
|
+
* (`x-forwarded-host`); any other's forwarded headers are ignored.
|
|
30
47
|
*
|
|
31
48
|
* The app says how to open an org: its store (at the org's placement, as
|
|
32
49
|
* its tenant), its plugins with the host's `here` (the org's name, and how
|
|
@@ -43,7 +60,13 @@ export type OrgInfo = {
|
|
|
43
60
|
schema: string;
|
|
44
61
|
};
|
|
45
62
|
};
|
|
46
|
-
export type OrgsHostOptions = Pick<WebServerOptions, "title" | "theme" | "google" | "dev" | "assets"> & {
|
|
63
|
+
export type OrgsHostOptions = Pick<WebServerOptions, "title" | "theme" | "google" | "dev" | "assets" | "front"> & {
|
|
64
|
+
/**
|
|
65
|
+
* The app's own hosts (`compass.copilotz.com`; patterns as routes' are,
|
|
66
|
+
* `*.run.app`): a request to any other is for a host an org claimed.
|
|
67
|
+
* Unset, every host is the app's, and claims route nothing.
|
|
68
|
+
*/
|
|
69
|
+
hosts?: string[];
|
|
47
70
|
/** The directory's runtime: identity, a sign-in method, and the directory plugin. */
|
|
48
71
|
directory: Runtime;
|
|
49
72
|
/**
|
|
@@ -77,6 +100,9 @@ export type OrgsHost = {
|
|
|
77
100
|
serve(request: Request): Promise<Response>;
|
|
78
101
|
openRuntime(request: Request): Runtime | undefined;
|
|
79
102
|
runtime(org: string): Promise<Runtime | undefined>;
|
|
80
|
-
close
|
|
103
|
+
/** Closes every open org, each giving its running work `drain` ms (see `Runtime.close`). */
|
|
104
|
+
close(options?: {
|
|
105
|
+
drain?: number;
|
|
106
|
+
}): Promise<void>;
|
|
81
107
|
};
|
|
82
108
|
export declare function orgsHost(options: OrgsHostOptions): OrgsHost;
|