eve 0.86.0 → 0.88.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +25 -0
- package/README.md +1 -1
- package/dist/src/acp/adapter.d.ts +2 -26
- package/dist/src/acp/adapter.js +1 -1
- package/dist/src/acp/server.d.ts +0 -3
- package/dist/src/ai/decision-adapter.d.ts +5 -3
- package/dist/src/ai/decision-adapter.js +1 -1
- package/dist/src/ai/decision-types.d.ts +4 -3
- package/dist/src/channel/adapter.d.ts +0 -14
- package/dist/src/channel/auth/definitions.d.ts +0 -4
- package/dist/src/channel/channel-address.d.ts +1 -1
- package/dist/src/channel/channel-address.js +1 -1
- package/dist/src/channel/channel-operations.d.ts +2 -2
- package/dist/src/channel/channel-operations.js +1 -1
- package/dist/src/channel/prompt-queue.d.ts +0 -2
- package/dist/src/channel/session-not-active-error.d.ts +10 -5
- package/dist/src/channel/session-not-active-error.js +1 -1
- package/dist/src/channel/session-stranded-error.d.ts +1 -1
- package/dist/src/channel/session.d.ts +3 -4
- package/dist/src/channel/session.js +1 -1
- package/dist/src/channel/types.d.ts +5 -14
- package/dist/src/chunks/{use-eve-agent-B2jCfcnG.js → use-eve-agent-BExXjBv6.js} +82 -72
- package/dist/src/chunks/{use-eve-agent-DCLFi26P.js → use-eve-agent-C0KHCyb9.js} +82 -72
- package/dist/src/cli/dev/command-options.d.ts +4 -4
- package/dist/src/cli/dev/command.js +1 -1
- package/dist/src/cli/dev/tui/runner.js +1 -1
- package/dist/src/cli/dev/tui/test/fake-eve-server.js +1 -1
- package/dist/src/cli/dev/tui/tool-format.d.ts +2 -2
- package/dist/src/cli/dev/ui-options.d.ts +4 -4
- package/dist/src/cli/dev/ui-options.js +1 -1
- package/dist/src/client/agent-info-error.d.ts +4 -1
- package/dist/src/client/agent-info-error.js +1 -1
- package/dist/src/client/agent-session.d.ts +1 -4
- package/dist/src/client/agent-session.js +1 -1
- package/dist/src/client/agent-stream-follower.js +1 -1
- package/dist/src/client/client-error.d.ts +13 -4
- package/dist/src/client/client-error.js +1 -1
- package/dist/src/client/delivery.d.ts +2 -17
- package/dist/src/client/health-response-error.d.ts +4 -1
- package/dist/src/client/health-response-error.js +1 -1
- package/dist/src/client/index.d.ts +5 -3
- package/dist/src/client/index.js +1 -1
- package/dist/src/client/open-stream.d.ts +7 -12
- package/dist/src/client/open-stream.js +1 -1
- package/dist/src/client/session-controls.d.ts +2 -2
- package/dist/src/client/session-controls.js +1 -1
- package/dist/src/client/session-event-stream.d.ts +2 -2
- package/dist/src/client/session-event-stream.js +1 -1
- package/dist/src/client/session-store.d.ts +2 -6
- package/dist/src/client/session-store.js +1 -1
- package/dist/src/client/session.d.ts +4 -13
- package/dist/src/client/session.js +1 -1
- package/dist/src/client/sessions.d.ts +3 -6
- package/dist/src/client/types.d.ts +23 -32
- package/dist/src/compiled/.vendor-stamp.json +3 -3
- package/dist/src/compiled/@vercel/agent-runs/LICENSE +202 -0
- package/dist/src/compiler/manifest.js +1 -1
- package/dist/src/compiler/normalize-agent-config.js +1 -1
- package/dist/src/compiler/normalize-connection.d.ts +1 -1
- package/dist/src/compiler/normalize-connection.js +1 -1
- package/dist/src/compiler/normalize-instructions.js +1 -1
- package/dist/src/compiler/normalize-skill.js +1 -1
- package/dist/src/compiler/resolve-workspace-subagent.js +1 -1
- package/dist/src/context/memory-tools.d.ts +9 -5
- package/dist/src/discover/sandbox.js +1 -1
- package/dist/src/dynamic/definition.d.ts +11 -5
- package/dist/src/dynamic/definition.js +1 -1
- package/dist/src/evals/mock-model.d.ts +1 -1
- package/dist/src/evals/session-manager.d.ts +0 -2
- package/dist/src/evals/session.d.ts +1 -11
- package/dist/src/evals/session.js +1 -1
- package/dist/src/eve-channel/index.js +1 -1
- package/dist/src/eve-channel/support.js +1 -1
- package/dist/src/execution/dynamic-workflow/tool.js +1 -1
- package/dist/src/execution/effective-agent-config.js +1 -1
- package/dist/src/execution/sandbox/bindings/just-bash-runtime.d.ts +1 -2
- package/dist/src/execution/sandbox/bindings/just-bash-runtime.js +1 -1
- package/dist/src/execution/sandbox/bindings/just-bash.js +1 -1
- package/dist/src/execution/tools/agent-router-workflow.js +1 -1
- package/dist/src/extensions/git/extension/extension.d.ts +5 -2
- package/dist/src/extensions/git/extension/extension.js +1 -1
- package/dist/src/extensions/git/extension/instructions/github.js +1 -1
- package/dist/src/extensions/git/extension/lib/connect-user-auth.d.ts +15 -0
- package/dist/src/extensions/git/extension/lib/connect-user-auth.js +1 -0
- package/dist/src/extensions/git/extension/lib/gh-tool.d.ts +8 -1
- package/dist/src/extensions/git/extension/lib/gh-tool.js +1 -1
- package/dist/src/extensions/git/extension/lib/github-guidance.d.ts +2 -1
- package/dist/src/extensions/git/extension/lib/github-guidance.js +14 -1
- package/dist/src/extensions/git/extension/lib/github-shell.d.ts +12 -4
- package/dist/src/extensions/git/extension/lib/github-shell.js +1 -1
- package/dist/src/instrumentation/ai-sdk-telemetry.d.ts +0 -2
- package/dist/src/instrumentation/providers.d.ts +1 -38
- package/dist/src/instrumentation/providers.js +1 -1
- package/dist/src/instrumentation/setup-context.d.ts +1 -7
- package/dist/src/internal/application/package.d.ts +1 -0
- package/dist/src/internal/application/package.js +1 -1
- package/dist/src/internal/application/stamped-package-version.js +1 -1
- package/dist/src/internal/authored-definition/core.js +1 -1
- package/dist/src/internal/authored-definition/schema-backed.js +1 -1
- package/dist/src/internal/classify-model-routing.d.ts +2 -3
- package/dist/src/internal/nitro/host/create-application-nitro.js +1 -1
- package/dist/src/internal/runtime-model.d.ts +9 -4
- package/dist/src/internal/runtime-model.js +1 -1
- package/dist/src/internal/workflow-bundle/authored-workflow-directives.js +1 -1
- package/dist/src/internal/workflow-bundle/builder-support.d.ts +1 -1
- package/dist/src/internal/workflow-bundle/builder-support.js +1 -1
- package/dist/src/internal/workflow-bundle/workflow-transformer.js +1 -1
- package/dist/src/models/auto.js +1 -1
- package/dist/src/protocol/delivery.d.ts +1 -0
- package/dist/src/protocol/reset-session.d.ts +0 -2
- package/dist/src/protocol/routes.d.ts +9 -2
- package/dist/src/protocol/routes.js +1 -1
- package/dist/src/public/channels/chat-sdk/chatSdkChannel.d.ts +1 -22
- package/dist/src/public/channels/discord/discordChannel.d.ts +3 -12
- package/dist/src/public/channels/discord/gateway/{index.d.ts → relay.d.ts} +2 -2
- package/dist/src/public/channels/discord/gateway/relay.js +1 -0
- package/dist/src/public/channels/discord/messages.d.ts +4 -4
- package/dist/src/public/channels/github/state.d.ts +0 -2
- package/dist/src/public/channels/index.d.ts +1 -2
- package/dist/src/public/channels/index.js +1 -1
- package/dist/src/public/channels/linear/index.d.ts +1 -1
- package/dist/src/public/channels/linear/index.js +1 -1
- package/dist/src/public/channels/linear/linearChannel.d.ts +0 -5
- package/dist/src/public/channels/linq/index.d.ts +1 -1
- package/dist/src/public/channels/linq/linqChannel.d.ts +7 -5
- package/dist/src/public/channels/photon/index.d.ts +1 -1
- package/dist/src/public/channels/photon/photonIMessageChannel.d.ts +15 -4
- package/dist/src/public/channels/slack/api.d.ts +1 -1
- package/dist/src/public/channels/slack/api.js +1 -1
- package/dist/src/public/channels/slack/app-manifest.d.ts +4 -0
- package/dist/src/public/channels/slack/app-manifest.js +1 -1
- package/dist/src/public/channels/slack/auth.d.ts +1 -0
- package/dist/src/public/channels/slack/auth.js +1 -1
- package/dist/src/public/channels/slack/blocks.d.ts +1 -1
- package/dist/src/public/channels/slack/blocks.js +2 -2
- package/dist/src/public/channels/slack/cards.d.ts +2 -297
- package/dist/src/public/channels/slack/cards.js +1 -1
- package/dist/src/public/channels/slack/defaults.js +1 -1
- package/dist/src/public/channels/slack/inbound.d.ts +7 -0
- package/dist/src/public/channels/slack/index.d.ts +3 -2
- package/dist/src/public/channels/slack/index.js +1 -1
- package/dist/src/public/channels/slack/model-context.d.ts +3 -2
- package/dist/src/public/channels/slack/model-context.js +3 -3
- package/dist/src/public/channels/slack/session-operations.d.ts +2 -2
- package/dist/src/public/channels/slack/session-operations.js +1 -1
- package/dist/src/public/channels/slack/slackChannel.d.ts +37 -72
- package/dist/src/public/channels/slack/slackChannel.js +1 -1
- package/dist/src/public/channels/slack/user-info.d.ts +64 -0
- package/dist/src/public/channels/slack/user-info.js +1 -0
- package/dist/src/public/channels/teams/teamsChannel.d.ts +4 -3
- package/dist/src/public/channels/telegram/hitl.d.ts +2 -9
- package/dist/src/public/channels/telegram/index.d.ts +1 -1
- package/dist/src/public/channels/telegram/telegramChannel.d.ts +0 -2
- package/dist/src/public/channels/twilio/twilioChannel.d.ts +0 -2
- package/dist/src/public/channels/undelivered-reply.d.ts +0 -5
- package/dist/src/public/definitions/agent.d.ts +15 -7
- package/dist/src/public/definitions/agent.js +1 -1
- package/dist/src/public/definitions/channel.d.ts +7 -5
- package/dist/src/public/definitions/channel.js +1 -1
- package/dist/src/public/definitions/connections/protocol.d.ts +1 -7
- package/dist/src/public/definitions/connections/protocol.js +1 -1
- package/dist/src/public/experimental/channels/discord/gateway.d.ts +1 -0
- package/dist/src/public/experimental/channels/discord/gateway.js +1 -0
- package/dist/src/public/experimental/sandbox/just-bash.d.ts +1 -0
- package/dist/src/public/experimental/sandbox/just-bash.js +1 -0
- package/dist/src/public/experimental/workspace/index.d.ts +1 -0
- package/dist/src/public/experimental/workspace/index.js +1 -0
- package/dist/src/public/index.d.ts +2 -2
- package/dist/src/public/index.js +1 -1
- package/dist/src/public/instrumentation/otel.d.ts +1 -1
- package/dist/src/public/instrumentation/provider.d.ts +1 -1
- package/dist/src/public/instrumentation/provider.js +1 -1
- package/dist/src/public/memory/file/backend.d.ts +1 -1
- package/dist/src/public/memory/file/backends/in-memory.js +1 -1
- package/dist/src/public/memory/file/backends/vercel-blob.js +1 -1
- package/dist/src/public/memory/file/provider.js +1 -1
- package/dist/src/public/memory/index.d.ts +3 -11
- package/dist/src/public/models/anthropic/index.d.ts +1 -1
- package/dist/src/public/models/index.d.ts +1 -0
- package/dist/src/public/models/openai/index.d.ts +2 -2
- package/dist/src/public/next/index.d.ts +2 -2
- package/dist/src/public/sandbox/just-bash-sandbox.d.ts +27 -20
- package/dist/src/public/sandbox/just-bash.d.ts +0 -1
- package/dist/src/public/sessions/index.d.ts +1 -0
- package/dist/src/public/sessions/index.js +1 -1
- package/dist/src/public/tools/index.d.ts +1 -1
- package/dist/src/public/tools/index.js +1 -1
- package/dist/src/public/workflow/api.d.ts +25 -0
- package/dist/src/public/workflow/api.js +1 -0
- package/dist/src/public/workflow/index.d.ts +76 -0
- package/dist/src/public/workflow/index.js +1 -0
- package/dist/src/public/workflow-modules.d.ts +2 -17
- package/dist/src/react/use-eve-agent.d.ts +3 -2
- package/dist/src/react/use-eve-agent.js +1 -1
- package/dist/src/reactions/kinds/model.js +1 -1
- package/dist/src/runtime/agent/resolve-model.js +1 -1
- package/dist/src/runtime/resolve-agent.js +1 -1
- package/dist/src/runtime/resolve-dynamic.js +1 -1
- package/dist/src/runtime/subagents/dynamic-agent-config.js +1 -1
- package/dist/src/runtime/subagents/workflow.js +1 -1
- package/dist/src/sandbox/providers/default.js +1 -1
- package/dist/src/self-modification/extension/subagents/agent/agent.d.ts +2 -2
- package/dist/src/self-modification/sandbox.js +1 -1
- package/dist/src/setup/integrations/discord/daemon.js +2 -2
- package/dist/src/setup/scaffold/create/project.js +2 -2
- package/dist/src/setup/scaffold/create/web-template.d.ts +2 -2
- package/dist/src/setup/scaffold/create/web-template.js +2 -2
- package/dist/src/setup/verified-remote-agent.d.ts +1 -3
- package/dist/src/shared/agent-definition.d.ts +18 -9
- package/dist/src/shared/eve-error.d.ts +22 -0
- package/dist/src/shared/eve-error.js +1 -0
- package/dist/src/shared/session.d.ts +2 -2
- package/dist/src/shared/token-usage.d.ts +7 -1
- package/dist/src/svelte/index.js +1 -1
- package/dist/src/svelte/use-eve-agent.d.ts +2 -1
- package/dist/src/svelte/use-eve-agent.js +1 -1
- package/dist/src/tools/definition.d.ts +7 -5
- package/dist/src/tools/definition.js +1 -1
- package/dist/src/tools/provided/ask-question-workflow.js +1 -1
- package/dist/src/tools/provided/sleep-workflow.js +1 -1
- package/dist/src/tracing/eve/batch-span-processor.d.ts +1 -1
- package/dist/src/tracing/eve/content-span-processor.d.ts +1 -19
- package/dist/src/tracing/eve/otel-configuration.d.ts +6 -0
- package/dist/src/tracing/eve/otel-declaration.d.ts +6 -19
- package/dist/src/tracing/eve/span-export-policy.d.ts +0 -2
- package/dist/src/tracing/local/instrumentation-runtime.d.ts +0 -3
- package/dist/src/tracing/local/traces.d.ts +0 -13
- package/dist/src/vue/index.js +1 -1
- package/dist/src/vue/use-eve-agent.d.ts +3 -2
- package/dist/src/vue/use-eve-agent.js +1 -1
- package/docs/agent-config.md +15 -11
- package/docs/channels/custom.mdx +26 -10
- package/docs/channels/discord.mdx +10 -10
- package/docs/channels/eve.mdx +14 -8
- package/docs/channels/linear.mdx +11 -0
- package/docs/channels/linq.mdx +5 -1
- package/docs/channels/photon.mdx +6 -1
- package/docs/channels/slack.mdx +141 -15
- package/docs/channels/telegram.mdx +6 -0
- package/docs/code-extension.mdx +76 -12
- package/docs/concepts/default-harness.md +2 -2
- package/docs/concepts/execution-model-and-durability.mdx +11 -11
- package/docs/concepts/security-model.md +2 -2
- package/docs/concepts/sessions-runs-and-streaming.md +23 -10
- package/docs/concepts/upgrade-to-v27-events.md +2 -1
- package/docs/connections/overview.mdx +4 -0
- package/docs/evals/reporters.mdx +21 -0
- package/docs/extensions.md +12 -0
- package/docs/getting-started.mdx +5 -1
- package/docs/guides/auth-and-route-protection.md +1 -1
- package/docs/guides/client/continuations.mdx +12 -10
- package/docs/guides/client/messages.mdx +24 -1
- package/docs/guides/client/overview.mdx +8 -6
- package/docs/guides/client/streaming.mdx +24 -6
- package/docs/guides/decide.md +3 -3
- package/docs/guides/deployment/vercel.mdx +1 -1
- package/docs/guides/dev-tui.md +2 -2
- package/docs/guides/frontend/overview.mdx +1 -1
- package/docs/guides/frontend/use-eve-agent-svelte.mdx +13 -11
- package/docs/guides/frontend/use-eve-agent-vue.mdx +13 -11
- package/docs/guides/frontend/use-eve-agent.mdx +4 -4
- package/docs/guides/instrumentation/otel.mdx +3 -1
- package/docs/guides/prepare-for-1-0.md +255 -0
- package/docs/guides/remote-agents.md +22 -20
- package/docs/instructions.mdx +1 -1
- package/docs/memory/custom-provider.md +1 -1
- package/docs/memory/file.md +11 -2
- package/docs/meta.json +1 -0
- package/docs/reference/agent-files.md +17 -17
- package/docs/reference/cli.md +14 -9
- package/docs/reference/typescript-api.md +46 -20
- package/docs/sandbox/custom-providers.mdx +2 -0
- package/docs/sandbox/default.mdx +6 -6
- package/docs/sandbox/index.mdx +5 -5
- package/docs/sandbox/just-bash.mdx +30 -21
- package/docs/subagents/index.mdx +4 -4
- package/docs/tools/human-in-the-loop.md +1 -1
- package/docs/tools/workflows.mdx +52 -8
- package/docs/tutorial/first-agent.mdx +1 -1
- package/package.json +36 -9
- package/dist/CHANGELOG.md +0 -38
- package/dist/src/public/channels/discord/gateway/index.js +0 -1
|
@@ -4,6 +4,7 @@ export type { SlackAttachment, SlackAuthor, SlackEvent, SlackEventEnvelope, Slac
|
|
|
4
4
|
export { callSlackApi, resolveSlackBotToken, slackCodeChannelContinuationToken, slackContinuationToken, type SlackPostInput, type SlackPostedMessage, type SlackBotTokenContext, type SlackThreadMessage, type SlackUploadFilesOptions, type SlackUploadFilesResult, } from "#public/channels/slack/api.js";
|
|
5
5
|
export { type SlackFetch, type SlackTransportOptions } from "#public/channels/slack/transport.js";
|
|
6
6
|
export { defaultSlackAuth } from "#public/channels/slack/defaults.js";
|
|
7
|
+
export { type SlackUserInfo } from "#public/channels/slack/user-info.js";
|
|
7
8
|
export { postCompletedSlackReply, type SlackCompletedReply, } from "#public/channels/slack/reply-delivery.js";
|
|
8
9
|
export { defineSlackRenderer, type SlackCardMessage, type SlackInteractionCard, type SlackInteractionCardParts, type SlackRenderer, type SlackRendererEvents, type SlackRenderHandler, type SlackRenderNext, } from "#public/channels/slack/renderers.js";
|
|
9
10
|
export type { TaskCard } from "#channel/task-card.js";
|
|
@@ -17,5 +18,5 @@ export { answerFromSlackAction, ANSWER_ACTION_PREFIX, renderInteractionBlocks, t
|
|
|
17
18
|
* The chat SDK runtime (`Chat`, `Thread`, `Adapter`, etc.) is not
|
|
18
19
|
* imported and not reachable through this entry point.
|
|
19
20
|
*/
|
|
20
|
-
export { Actions, Button, Card, CardLink, CardText, Divider,
|
|
21
|
-
export type { ActionsElement, ButtonElement, ButtonOptions,
|
|
21
|
+
export { Actions, Button, Card, CardLink, CardText, Divider, Field, Fields, Image, LinkButton, RadioSelect, Section, Select, SelectOption, Table, } from "#public/channels/slack/cards.js";
|
|
22
|
+
export type { ActionsElement, ButtonElement, ButtonOptions, ButtonStyle, CardChild, CardElement, CardOptions, DividerElement, FieldElement, FieldsElement, FileUpload, ImageElement, LinkButtonElement, LinkButtonOptions, LinkElement, PostableCard, RadioSelectElement, RadioSelectOptions, SectionElement, SelectElement, SelectOptionElement, SelectOptions, TableAlignment, TableElement, TableOptions, TextElement, TextStyle, } from "#public/channels/slack/cards.js";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{callSlackApi,resolveSlackBotToken,slackCodeChannelContinuationToken,slackContinuationToken}from"#public/channels/slack/api.js";import{
|
|
1
|
+
import{callSlackApi,resolveSlackBotToken,slackCodeChannelContinuationToken,slackContinuationToken}from"#public/channels/slack/api.js";import{cardToBlocks,cardToFallbackText}from"#public/channels/slack/blocks.js";import{postCompletedSlackReply}from"#public/channels/slack/reply-delivery.js";import{openCodeChannel}from"#public/channels/slack/open-code-channel.js";import{slackChannel}from"#public/channels/slack/slackChannel.js";import{defaultSlackAuth}from"#public/channels/slack/defaults.js";import{defineSlackRenderer}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{ANSWER_ACTION_PREFIX,answerFromSlackAction,renderInteractionBlocks}from"#public/channels/slack/hitl.js";import{Actions,Button,Card,CardLink,CardText,Divider,Field,Fields,Image,LinkButton,RadioSelect,Section,Select,SelectOption,Table}from"#public/channels/slack/cards.js";export{ANSWER_ACTION_PREFIX,Actions,Button,Card,CardLink,CardText,Divider,Field,Fields,Image,LinkButton,RadioSelect,Section,Select,SelectOption,Table,answerFromSlackAction,callSlackApi,cardToBlocks,cardToFallbackText,defaultSlackAuth,defineSlackRenderer,loadThreadContextMessages,openCodeChannel,postCompletedSlackReply,renderInteractionBlocks,resolveSlackBotToken,slackChannel,slackCodeChannelContinuationToken,slackContinuationToken};
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { SlackThreadMessage } from "#public/channels/slack/api.js";
|
|
2
2
|
import type { SlackInboundContext } from "#public/channels/slack/inbound.js";
|
|
3
|
+
import type { SlackUserInfo } from "#public/channels/slack/user-info.js";
|
|
3
4
|
import type { SessionHistoryMessage } from "#shared/session-history.js";
|
|
4
5
|
/** Renders the triggering inbound Slack message as one attributed block. */
|
|
5
6
|
export declare function formatSlackInboundMessage(context: SlackInboundContext, message: {
|
|
@@ -10,10 +11,10 @@ export declare function formatSlackInboundMessage(context: SlackInboundContext,
|
|
|
10
11
|
* Renders fetched Slack replies as explicitly attributed background context.
|
|
11
12
|
* Returns `undefined` when there are no messages to add to the turn.
|
|
12
13
|
*/
|
|
13
|
-
export declare function formatSlackThreadContext(messages: readonly SlackThreadMessage[]): string | undefined;
|
|
14
|
+
export declare function formatSlackThreadContext(messages: readonly SlackThreadMessage[], users?: ReadonlyMap<string, SlackUserInfo>): string | undefined;
|
|
14
15
|
/**
|
|
15
16
|
* Maps fetched thread replies to seeded session history. This app's own replies become assistant
|
|
16
17
|
* turns; everyone else stays an attributed user message. Slack shows rendered output, so assistant
|
|
17
18
|
* turns approximate what the model said.
|
|
18
19
|
*/
|
|
19
|
-
export declare function slackThreadSessionHistory(messages: readonly SlackThreadMessage[]): SessionHistoryMessage[];
|
|
20
|
+
export declare function slackThreadSessionHistory(messages: readonly SlackThreadMessage[], users?: ReadonlyMap<string, SlackUserInfo>): SessionHistoryMessage[];
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{slackMrkdwnToGfm}from"#public/channels/slack/mrkdwn.js";function formatSlackModelMessage(e){return[`<slack_message>`,`
|
|
2
|
-
`)}function formatSlackInboundMessage(e,t){return formatSlackModelMessage({botUserId:e.botUserId,channelId:e.channelId,content:slackModelContent(t.text),isMentioned:e.isMentioned,senderId:e.userId||void 0,senderType:e.userId?`user`:`unknown`,teamId:e.teamId,threadTs:e.threadTs,ts:t.ts})}function slackModelContent(e){let t=[],n=`eve_slack_user_mention_`;for(;e.includes(n);)n+=`_`;let r=e.replace(/<@[A-Z0-9_]+(?:\|[^>\r\n]+)?>/giu,e=>{let r=`${n}${t.length}\uE001`;return t.push(e),r}),i=slackMrkdwnToGfm(r);for(let[e,r]of t.entries())i=i.replaceAll(`${n}${e}\uE001`,r);return i}function formatSlackThreadContext(e){if(e.length!==0)return[`<slack_thread_context>`,...e.map(e=>
|
|
3
|
-
`)}function slackThreadSenderType(e){return e.isMe?`agent`:e.botId?`bot`:e.user?`user`:`unknown`}function slackThreadSessionHistory(e){return e.flatMap(e=>slackThreadHistoryMessage(e)??[])}function slackThreadHistoryMessage(e){if(e.markdown.trim().length!==0)return e.isMe?{id:e.ts,role:`assistant`,text:e.markdown}:{id:e.ts,role:`user`,text:
|
|
1
|
+
import{slackMrkdwnToGfm}from"#public/channels/slack/mrkdwn.js";function formatSlackModelMessage(e){let t=e.senderInfo,n=[...e.botUserId?[`id: ${e.botUserId}`]:[],...e.isMentioned===void 0?[]:[`mentioned: ${e.isMentioned}`]];return[`<slack_message>`,`<sender>`,`type: ${e.senderType}`,...e.senderId?[`id: ${e.senderId}`]:[],...t?.displayName?[`display_name: ${oneLine(t.displayName)}`]:[],...t?.realName?[`real_name: ${oneLine(t.realName)}`]:[],...t?.email?[`email: ${oneLine(t.email)}`]:[],`</sender>`,...n.length>0?[`<bot>`,...n,`</bot>`]:[],`<thread>`,...e.teamId?[`team_id: ${e.teamId}`]:[],...e.channelId?[`channel_id: ${e.channelId}`]:[],`thread_ts: ${e.threadTs}`,`message_ts: ${e.ts}`,`</thread>`,`<content>`,e.content,`</content>`,`</slack_message>`].join(`
|
|
2
|
+
`)}function oneLine(e){return e.replace(/[\r\n]+/gu,` `)}function formatSlackInboundMessage(e,t){let n={...e.displayName&&{displayName:e.displayName},...e.fullName&&{realName:e.fullName},...e.email&&{email:e.email}};return formatSlackModelMessage({botUserId:e.botUserId,channelId:e.channelId,content:slackModelContent(t.text),isMentioned:e.isMentioned,senderId:e.userId||void 0,senderInfo:n,senderType:e.userId?`user`:`unknown`,teamId:e.teamId,threadTs:e.threadTs,ts:t.ts})}function slackModelContent(e){let t=[],n=`eve_slack_user_mention_`;for(;e.includes(n);)n+=`_`;let r=e.replace(/<@[A-Z0-9_]+(?:\|[^>\r\n]+)?>/giu,e=>{let r=`${n}${t.length}\uE001`;return t.push(e),r}),i=slackMrkdwnToGfm(r);for(let[e,r]of t.entries())i=i.replaceAll(`${n}${e}\uE001`,r);return i}function formatSlackThreadContext(e,t){if(e.length!==0)return[`<slack_thread_context>`,...e.map(e=>formatSlackThreadMessage(e,t)),`</slack_thread_context>`].join(`
|
|
3
|
+
`)}function formatSlackThreadMessage(e,t){return formatSlackModelMessage({content:e.markdown,senderId:e.user??e.botId,senderInfo:e.user?t?.get(e.user):void 0,senderType:slackThreadSenderType(e),threadTs:e.threadTs,ts:e.ts})}function slackThreadSenderType(e){return e.isMe?`agent`:e.botId?`bot`:e.user?`user`:`unknown`}function slackThreadSessionHistory(e,t){return e.flatMap(e=>slackThreadHistoryMessage(e,t)??[])}function slackThreadHistoryMessage(e,t){if(e.markdown.trim().length!==0)return e.isMe?{id:e.ts,role:`assistant`,text:e.markdown}:{id:e.ts,role:`user`,text:formatSlackThreadMessage(e,t)}}export{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory};
|
|
@@ -21,9 +21,9 @@ export interface SlackSessionOperations {
|
|
|
21
21
|
}): ReturnType<SlackSource["cancel"]>;
|
|
22
22
|
compact(): ReturnType<SlackSource["compact"]>;
|
|
23
23
|
clear(): ReturnType<SlackSource["clear"]>;
|
|
24
|
-
|
|
24
|
+
end(options?: {
|
|
25
25
|
readonly reason?: string;
|
|
26
|
-
}): ReturnType<SlackSource["
|
|
26
|
+
}): ReturnType<SlackSource["end"]>;
|
|
27
27
|
resolveSession(): ReturnType<ChannelResolveSession>;
|
|
28
28
|
}
|
|
29
29
|
/** Binds Slack state and default auth needed only when a message creates a session. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
function bindSlackSessionOperations(e){let t=e.from(e.address),auth=t=>t===void 0?e.defaultAuth:t;return{async send(n,r={}){return await t.send(n,{...r,auth:auth(r.auth),state:e.state})},async respond(n,r={}){return await t.respond(n,{...r,auth:auth(r.auth),state:withSlackResponder(r.state,e.state.triggeringUserId)})},async cancel(e){return await t.cancel(e)},async compact(){return await t.compact()},async clear(){return await t.clear()},async
|
|
1
|
+
function bindSlackSessionOperations(e){let t=e.from(e.address),auth=t=>t===void 0?e.defaultAuth:t;return{async send(n,r={}){return await t.send(n,{...r,auth:auth(r.auth),state:e.state})},async respond(n,r={}){return await t.respond(n,{...r,auth:auth(r.auth),state:withSlackResponder(r.state,e.state.triggeringUserId)})},async cancel(e){return await t.cancel(e)},async compact(){return await t.compact()},async clear(){return await t.clear()},async end(e){return await t.end(e)},async resolveSession(){return await e.resolveSession(e.address)}}}function withSlackResponder(e,t){return t?{...e,triggeringUserId:t}:e}export{bindSlackSessionOperations,withSlackResponder};
|
|
@@ -6,7 +6,6 @@ import type { ChannelResolveSession, ChannelSource } from "#channel/channel-oper
|
|
|
6
6
|
import type { Delivery } from "#shared/delivery.js";
|
|
7
7
|
import type { SessionAuthContext, TurnPolicy } from "#channel/types.js";
|
|
8
8
|
import type { VercelConnectMetadata } from "#shared/vercel-connect-metadata.js";
|
|
9
|
-
import type { CardElement } from "#public/channels/slack/cards.js";
|
|
10
9
|
import type { BlockKitBlock } from "#public/channels/slack/blocks.js";
|
|
11
10
|
import type { SlackHitlRoute } from "#public/channels/slack/hitl.js";
|
|
12
11
|
import type { SessionContext } from "#public/definitions/callback-context.js";
|
|
@@ -14,12 +13,11 @@ import type { SessionHistoryMessage } from "#shared/session-history.js";
|
|
|
14
13
|
import type { ChannelContinuationOps } from "#public/definitions/channel.js";
|
|
15
14
|
import type { Answer, StrictAnswers, ValidatedAnswer } from "#shared/input.js";
|
|
16
15
|
import type { Interaction } from "#channel/interaction-prompts.js";
|
|
17
|
-
import { type SlackBotToken, type SlackHandle, type SlackThread, type SlackWorkspaceHandle } from "#public/channels/slack/api.js";
|
|
16
|
+
import { type SlackBotToken, type SlackHandle, type SlackThread, type SlackPostInput, type SlackWorkspaceHandle } from "#public/channels/slack/api.js";
|
|
18
17
|
import { type SlackTransportOptions } from "#public/channels/slack/transport.js";
|
|
19
18
|
import { type SlackRenderedEvent, type SlackRenderer } from "#public/channels/slack/renderers.js";
|
|
20
|
-
import { type SlackTaskCardState } from "#public/channels/slack/task-card.js";
|
|
21
|
-
import type { SlackThreadStatus } from "#public/channels/slack/thread-status.js";
|
|
22
19
|
import { type SlackEvent, type SlackEventEnvelope, type SlackMessage } from "#public/channels/slack/inbound.js";
|
|
20
|
+
import { type SlackUsersOption } from "#public/channels/slack/user-info.js";
|
|
23
21
|
import { type LoadThreadContextMessagesOptions } from "#public/channels/slack/thread.js";
|
|
24
22
|
import { type SlackSessionOperations } from "#public/channels/slack/session-operations.js";
|
|
25
23
|
import { type UploadPolicyInput } from "#public/channels/upload-policy.js";
|
|
@@ -125,18 +123,6 @@ export interface SlackChannelState extends UndeliveredReplyState {
|
|
|
125
123
|
threadTs: string | null;
|
|
126
124
|
/** Whether this session serves a Slack code channel. */
|
|
127
125
|
codeChannel?: boolean;
|
|
128
|
-
/**
|
|
129
|
-
* In a code channel, the thread of the message the current turn answers;
|
|
130
|
-
* `null` posts top-level.
|
|
131
|
-
* @internal
|
|
132
|
-
*/
|
|
133
|
-
replyThreadTs?: string | null;
|
|
134
|
-
/**
|
|
135
|
-
* In a code channel, the thread of the latest delivered message, which the
|
|
136
|
-
* next turn replies in.
|
|
137
|
-
* @internal
|
|
138
|
-
*/
|
|
139
|
-
pendingReplyThreadTs?: string | null;
|
|
140
126
|
/** Slack team id, when the inbound event carried one. */
|
|
141
127
|
teamId: string | null;
|
|
142
128
|
/** Slack message ts that triggered the active turn. */
|
|
@@ -149,59 +135,12 @@ export interface SlackChannelState extends UndeliveredReplyState {
|
|
|
149
135
|
* recipients through `slackUsersByPrincipal` instead.
|
|
150
136
|
*/
|
|
151
137
|
triggeringUserId?: string | null;
|
|
152
|
-
/**
|
|
153
|
-
* Buffered narration from a `content.completed` event (`phase: "narration"`). The default `call.requested` handler uses the
|
|
154
|
-
* first non-empty line as the next typing indicator, surfacing the
|
|
155
|
-
* model's pre-tool narration instead of the action label. Cleared at
|
|
156
|
-
* `turn.started` and after use.
|
|
157
|
-
*/
|
|
158
|
-
pendingToolCallMessage?: string | null;
|
|
159
|
-
/**
|
|
160
|
-
* The thread status the default renderer last set. A later model step shows
|
|
161
|
-
* it again, as does a new task card, which Slack clears the status for.
|
|
162
|
-
*/
|
|
163
|
-
threadStatus?: SlackThreadStatus | null;
|
|
164
|
-
/**
|
|
165
|
-
* Connection name to Slack message ts. Each entry is the public
|
|
166
|
-
* link-free status post created by the default
|
|
167
|
-
* sign-in `interaction.opened` handler; the matching
|
|
168
|
-
* sign-in `interaction.settled` handler edits it in place to surface the
|
|
169
|
-
* resolution outcome.
|
|
170
|
-
*/
|
|
171
|
-
pendingAuthMessageTs?: Record<string, string>;
|
|
172
|
-
/**
|
|
173
|
-
* The messages holding open or recently answered approvals, questions, and budget prompts.
|
|
174
|
-
* Each is updated as its requests change and forgotten once all of them settle. eve ignores
|
|
175
|
-
* the `pendingApprovalCards` field that earlier versions wrote, so cards posted before an
|
|
176
|
-
* upgrade keep their buttons.
|
|
177
|
-
*/
|
|
178
|
-
interactionCards?: readonly SlackInteractionCardRecord[];
|
|
179
|
-
/**
|
|
180
|
-
* Each recent turn's tool calls and the task card eve last wrote for it, by
|
|
181
|
-
* turn id. The default `turn.paused` handler names the working tasks.
|
|
182
|
-
*/
|
|
183
|
-
taskCards?: Record<string, SlackTaskCardState> | null;
|
|
184
|
-
/**
|
|
185
|
-
* Tasks that settled since the turn's last model step: each named agent, or
|
|
186
|
-
* `null` for another task. The default `step.started` handler shows
|
|
187
|
-
* `Reviewing results...` for the step that reads them.
|
|
188
|
-
*/
|
|
189
|
-
pendingTaskResults?: {
|
|
190
|
-
readonly names: readonly (string | null)[];
|
|
191
|
-
readonly turnId: string;
|
|
192
|
-
} | null;
|
|
193
138
|
/**
|
|
194
139
|
* Principal id to Slack user id, recorded as each message or input response
|
|
195
140
|
* is delivered. Default handlers use it to address the principal named on
|
|
196
141
|
* sign-in `interaction.opened` and approval events.
|
|
197
142
|
*/
|
|
198
143
|
slackUsersByPrincipal?: Record<string, string>;
|
|
199
|
-
/**
|
|
200
|
-
* Whether eve has posted in this thread. Once it has, deleting the root
|
|
201
|
-
* leaves a tombstone that keeps the thread, so the final reply skips the
|
|
202
|
-
* deleted-root check.
|
|
203
|
-
*/
|
|
204
|
-
postedInThread?: boolean;
|
|
205
144
|
}
|
|
206
145
|
/**
|
|
207
146
|
* Per-session metadata attached to tracing spans, projected by the
|
|
@@ -285,13 +224,14 @@ export interface SlackCodeChannelTarget {
|
|
|
285
224
|
}
|
|
286
225
|
/**
|
|
287
226
|
* Pre-agent post issued by `slackChannel().receive` when the caller
|
|
288
|
-
* provides `target.initialMessage`.
|
|
289
|
-
*
|
|
227
|
+
* provides `target.initialMessage`. Accepts the same explicit message forms
|
|
228
|
+
* as `ctx.thread.post`: Markdown, text, blocks, or a card, plus optional files.
|
|
229
|
+
*
|
|
230
|
+
* Unlike `thread.post({ text, files })`, which sends one message with the files
|
|
231
|
+
* attached, this posts the root message first and then uploads files as a
|
|
232
|
+
* threaded reply. Upload failures are logged, not thrown, so the run still starts.
|
|
290
233
|
*/
|
|
291
|
-
export
|
|
292
|
-
readonly card: CardElement;
|
|
293
|
-
readonly fallbackText?: string;
|
|
294
|
-
}
|
|
234
|
+
export type SlackInitialMessage = SlackPostInput;
|
|
295
235
|
/**
|
|
296
236
|
* Options for one turn requested by a generic Slack event handler.
|
|
297
237
|
*/
|
|
@@ -347,11 +287,11 @@ export interface SlackInboundEventContext {
|
|
|
347
287
|
clear(input: {
|
|
348
288
|
readonly target: SlackSessionTarget;
|
|
349
289
|
}): ReturnType<ChannelSource<SlackChannelState>["clear"]>;
|
|
350
|
-
/**
|
|
351
|
-
|
|
290
|
+
/** Retires the current session for one Slack thread without creating a replacement. */
|
|
291
|
+
end(input: {
|
|
352
292
|
readonly reason?: string;
|
|
353
293
|
readonly target: SlackSessionTarget;
|
|
354
|
-
}): ReturnType<ChannelSource<SlackChannelState>["
|
|
294
|
+
}): ReturnType<ChannelSource<SlackChannelState>["end"]>;
|
|
355
295
|
/** Resolves the current session for one Slack thread. */
|
|
356
296
|
resolveSession(input: {
|
|
357
297
|
readonly target: SlackSessionTarget;
|
|
@@ -592,6 +532,31 @@ export interface SlackChannelConfig {
|
|
|
592
532
|
* option to avoid fetching thread history.
|
|
593
533
|
*/
|
|
594
534
|
readonly threadContext?: LoadThreadContextMessagesOptions;
|
|
535
|
+
/**
|
|
536
|
+
* Adds to what eve attaches to each model-visible `<slack_message>`.
|
|
537
|
+
*/
|
|
538
|
+
readonly messageContext?: {
|
|
539
|
+
/**
|
|
540
|
+
* Looks up each human sender with `users.info` and adds `display_name`
|
|
541
|
+
* and `real_name` to their `<sender>` block, plus `email` with
|
|
542
|
+
* `email: true` (`name: false` leaves names out), including
|
|
543
|
+
* `threadContext` replies. The triggering author
|
|
544
|
+
* is also written to `message.author` (`fullName`, `displayName`,
|
|
545
|
+
* `email`) and to the default Slack auth attributes: before
|
|
546
|
+
* `onAppMention` and `onDirectMessage` run, and for other channel
|
|
547
|
+
* messages only once a hook delivers them.
|
|
548
|
+
*
|
|
549
|
+
* `true` caches results in memory per workspace and user for an hour.
|
|
550
|
+
* `resolve(user, next)` owns caching instead; `next()` is the uncached
|
|
551
|
+
* `users.info` call. A lookup that fails or takes over two seconds is
|
|
552
|
+
* left out, and the message is still delivered.
|
|
553
|
+
*
|
|
554
|
+
* Adds the `users:read` scope to the app manifest, and `users:read.email`
|
|
555
|
+
* with `email: true`. Off by default: names and emails then reach model
|
|
556
|
+
* context, session history, and traces.
|
|
557
|
+
*/
|
|
558
|
+
readonly users?: SlackUsersOption;
|
|
559
|
+
};
|
|
595
560
|
/**
|
|
596
561
|
* Handles human-authored Slack messages. Specialized `onAppMention` and
|
|
597
562
|
* `onDirectMessage` handlers take precedence for their event types. Other
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{markEventHandled}from"./utils.js";import{createHash}from"node:crypto";import{toSessionSendOptions}from"#channel/session.js";import{attachInputText}from"#internal/input-text.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{setChannelBuildMetadata}from"#channel/compiled-channel.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{withUndeliveredReplyNote}from"#public/channels/undelivered-reply.js";import{buildSlackBinding,buildSlackWorkspaceHandle,fetchSlackThreadWindow,slackCodeChannelContinuationToken,slackContinuationToken,slackSessionToken}from"#public/channels/slack/api.js";import{buildSlackAuthContext,slackUserIdFromAuthContext}from"#public/channels/slack/auth.js";import{createSlackCodeChannel,isSlackCodeChannel,isSlackCodeChannelOriginContext,setSlackCodeChannelStatus}from"#public/channels/slack/code-channel.js";import{resolveSlackTransportOptions}from"#public/channels/slack/transport.js";import{parseMessageEvent,parseSlackEventEnvelope,slackEventBotUserId,slackEventInstallationTeamId,slackEventReceivingBotUserId,slackMessageFromWebhookPayload}from"#public/channels/slack/inbound.js";import{withFinalReplyDelivery}from"#public/channels/slack/reply-delivery.js";import{defaultEvents,defaultInteractionEvents,defaultOnMessage,defaultReceived}from"#public/channels/slack/defaults.js";import{composeInteractionCards,composeSlackRenderers}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{parseSlackWebhookBody}from"#compiled/@chat-adapter/slack/webhook.js";import{bindSlackSessionOperations,withSlackResponder}from"#public/channels/slack/session-operations.js";import{buildSlackTurnMessage,collectInboundFileParts,createSlackFetchFile}from"#public/channels/slack/attachments.js";import{renderDefaultSlackTaskCard,withTaskCards}from"#public/channels/slack/task-card.js";import{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory}from"#public/channels/slack/model-context.js";import{isPrivateSlackConversation}from"#public/channels/slack/privacy.js";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#public/channels/slack/constants.js";import{defineSlackAppManifest}from"#public/channels/slack/app-manifest.js";import{handleInteractionPost}from"#public/channels/slack/interactions.js";import{verifySlackRequest as verifySlackRequest$1}from"#public/channels/slack/verify.js";const log=createLogger(`slack.channel`);function rebuildSlackContext(e,t,n,r){let{thread:i,slack:a}=buildSlackBinding({api:n,botToken:r?.botToken,channelId:e.channelId??``,threadTs:e.threadTs??``,codeChannel:e.codeChannel===!0,replyThreadTs:()=>e.replyThreadTs??void 0,installationTeamId:e.installationTeamId??void 0,teamId:e.teamId??void 0,onThreadTsChanged(n){e.threadTs=n,e.channelId&&t.continuation?.alias(slackContinuationToken({channelId:e.channelId,threadTs:n}))},onPosted(){e.postedInThread=!0}});return{thread:i,slack:a,state:e}}function slackChannel(e={}){let t=resolveSlackTransportOptions(e.api),n=mergeUploadPolicy(e.uploadPolicy),r=createSlackFetchFile({api:t,botToken:e.credentials?.botToken,maxBytes:maxBytesOf(n)}),i=e.onAnswers??defaultOnAnswers,a=composeInteractionCards(e.renderers??[]),o=composeSlackRenderers(e.renderers??[],{events:{...defaultEvents,...defaultInteractionEvents(e.approvalChannel,a)},received:defaultReceived,taskCard:renderDefaultSlackTaskCard}),s=o.events[`turn.started`],c=withTaskCards({...o.events,"content.completed":withFinalReplyDelivery(o.events[`content.completed`]),async"turn.started"(e,t){let{channel:n}=t,r=slackUserIdFromAuthContext(t.session.auth.current);r!==void 0&&(n.state.triggeringUserId=r),n.state.pendingReplyThreadTs!==void 0&&(n.state.replyThreadTs=n.state.pendingReplyThreadTs,n.state.pendingReplyThreadTs=void 0),await s?.(e,t)}},o.taskCard),l=new Set,u=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:{channelId:null,threadTs:null,teamId:null,installationTeamId:null,triggeringUserId:null,triggeringMessageTs:null,pendingToolCallMessage:null,pendingAuthMessageTs:{},interactionCards:[],slackUsersByPrincipal:{}},fetchFile:r,metadata(e){return{channelId:e.channelId,teamId:e.teamId,threadTs:e.threadTs,triggeringUserId:e.triggeringUserId??null,installationTeamId:e.installationTeamId??null,triggeringMessageTs:e.triggeringMessageTs??null,...e.codeChannel===!0&&{codeChannel:!0}}},audience:({state:e})=>e.audience??`unknown`,context(n,r){return rebuildSlackContext(n,r,t,e.credentials)},deliver(e,t){return recordSlackPrincipal(t.state,t.session.auth.current,e),followReplyThread(t.state,e),followTriggeringMessage(t.state,e),withUndeliveredReplyNote(t.state,e,`Slack`)},routes:[POST(e.route??SLACK_CHANNEL_DEFAULT_ROUTE,async(r,a)=>{let{waitUntil:s}=a,{from:c,resolveSession:u}=a,d=await verifyInbound(r,e.credentials);return d===null?new Response(`unauthorized`,{status:401}):shouldDropSlackHttpTimeoutRetry(r.headers)?new Response(`ok`):(r.headers.get(`content-type`)??``).includes(`application/x-www-form-urlencoded`)?handleInteractionPost(d,{from:c,resolveSession:u,waitUntil:s},{api:t,config:e,onAnswers:i}):handleEventPost({api:t,body:d,from:c,resolveSession:u,waitUntil:s,config:e,received:o.received,uploadPolicy:n,handledEvents:l,headers:r.headers})})],receive(n,{from:r}){return receiveOnSlack(n,{from:r,api:t,codeChannels:e.codeChannels===!0,credentials:e.credentials})},events:c}),d=e.credentials,f=defineSlackAppManifest({botName:e.botName,codeChannels:e.codeChannels===!0});return setChannelBuildMetadata(u,e=>({externalCredentials:d?.vercelConnect,manifest:f.build(e)})),u}function defaultOnAnswers(e){return{auth:e.defaultAuth}}async function receiveOnSlack(e,t){let{message:n,target:r,...i}=e,a=r,o=a.channelId;if(!o||typeof o!=`string`)throw Error(`slackChannel().receive requires target.channelId.`);let s=typeof a.threadTs==`string`?a.threadTs:``,c=typeof a.installationTeamId==`string`?a.installationTeamId:t.installationTeamId,l=a.initialMessage;if(l&&s.length>0)throw Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");if(a.codeChannel!==void 0){if(!t.codeChannels)throw Error("slackChannel().receive: set `codeChannels: true` on slackChannel() to open code channels.");if(l||s.length>0)throw Error("slackChannel().receive: `codeChannel` can't be combined with `threadTs` or `initialMessage`.");return await receiveInNewCodeChannel(e,t,{codeChannel:a.codeChannel,installationTeamId:c,originChannelId:o})}let u=s;if(l){let{thread:e}=buildSlackBinding({api:t.api,botToken:t.credentials?.botToken,channelId:o,threadTs:``,installationTeamId:c,teamId:t.teamId}),n={card:l.card};l.fallbackText!==void 0&&(n.fallbackText=l.fallbackText),u=(await e.post(n)).id}let d=u||(i.idempotencyKey===void 0?crypto.randomUUID():threadlessIdentityFromKey(i.idempotencyKey)),f=a.audience===void 0?void 0:normalizeChannelAudience(a.audience),p={channelId:o,installationTeamId:c??null,threadTs:u||null,teamId:t.teamId??null,triggeringUserId:t.triggeringUserId??null};return f!==void 0&&(p.audience=f),t.from(slackContinuationToken({channelId:o,threadTs:d})).send(n,{...i,state:p})}function threadlessIdentityFromKey(e){return`key-${createHash(`sha256`).update(e).digest(`hex`).slice(0,32)}`}async function receiveInNewCodeChannel(e,t,n){let{codeChannel:r,installationTeamId:i,originChannelId:a}=n,{request:o}=buildSlackWorkspaceHandle({api:t.api,botToken:t.credentials?.botToken,installationTeamId:i,teamId:t.teamId}),s=await openSlackCodeChannel({auth:e.auth,installationTeamId:i,name:r.name,originChannelId:a,originTs:r.originTs,request:o,teamId:t.teamId,triggeringUserId:t.triggeringUserId??slackUserIdFromAuthContext(e.auth)}),{message:c,target:l,...u}=e;return await t.from(s.address).send(c,{...u,auth:s.auth,state:s.state})}async function openSlackCodeChannel(e){let{channelId:t,isPrivate:n}=await createSlackCodeChannel({name:e.name??``,originChannelId:e.originChannelId,originTs:e.originTs,requester:e.auth?.principalId??`anonymous`,request:e.request});return{address:slackCodeChannelContinuationToken(t),auth:codeChannelAuth(e.auth,t),channelId:t,state:{audience:n?`private`:`public`,channelId:t,codeChannel:!0,installationTeamId:e.installationTeamId??null,replyThreadTs:null,teamId:e.teamId??null,threadTs:null,triggeringUserId:e.triggeringUserId??null}}}function codeChannelAuth(e,t){if(e?.authenticator!==`slack-webhook`)return e;let{thread_ts:n,...r}=e.attributes;return{...e,attributes:{...r,channel_id:t}}}function shouldDropSlackHttpTimeoutRetry(e){return Number(e.get(`x-slack-retry-num`)??`0`)>=1&&e.get(`x-slack-retry-reason`)===`http_timeout`}async function handleEventPost(e){let{config:t}=e,n,r;try{n=parseSlackWebhookBody(e.body,{headers:e.headers}),r=parseSlackEventEnvelope(e.body)}catch(e){return log.warn(`inbound webhook body is not valid JSON`,{error:e}),new Response(`ok`)}if(n.kind===`url_verification`)return new Response(n.challenge,{status:200,headers:{"content-type":`text/plain`}});if(r===null)return new Response(`ok`);let i=typeof r.api_app_id==`string`?r.api_app_id:void 0,a=slackEventBotUserId(r),o=slackEventReceivingBotUserId(r),s=slackEventInstallationTeamId(r),c=r.event,l=c.channel;if(t.codeChannels===!0&&c.type===`agent_session_stopped`&&typeof l==`string`){if(isDuplicateEvent(r,n.retry,e.handledEvents))return new Response(`ok`);let i=buildSlackWorkspaceHandle({api:e.api,botToken:t.credentials?.botToken,installationTeamId:s,teamId:typeof r.team_id==`string`?r.team_id:void 0}).request,a=t.onEvent;return e.waitUntil((async()=>{if(c.thread_ts!==void 0&&!await isSlackCodeChannel(l,i)){if(a===void 0)return;await dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,codeChannels:!0,credentials:t.credentials,envelope:r,handler:a,installationTeamId:s});return}await cancelledARunningTurn(e.from,l)||await setSlackCodeChannelStatus(i,l,`active`)})().catch(e=>{logError(log,`agent_session_stopped handling failed`,e,{channelId:l})})),new Response(`ok`)}let u=null,d=null,dispatchMessage=(n,r,c,l)=>()=>dispatchSlackMessage({api:e.api,appId:i,botUserId:a,codeChannelOnly:l,detectCodeChannels:t.codeChannels===!0,receivingBotUserId:o,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,handler:c,installationTeamId:s,kind:n,message:r,received:e.received,resolvesTypedInput:t.onAnswers===void 0&&t.approvalChannel===void 0,threadContext:t.threadContext,uploadPolicy:e.uploadPolicy});if(n.kind===`app_mention`||n.kind===`direct_message`){let e=n.kind,r=slackMessageFromWebhookPayload(n,s);if(r!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},r)){let n=(e===`app_mention`?t.onAppMention:t.onDirectMessage)??t.onMessage;n===void 0?d=dispatchMessage(e,r,defaultOnMessage):u=dispatchMessage(e,r,n)}}let f=t.onMessage;if(u===null&&f!==void 0){let e=parseMessageEvent(r);e!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&(a===void 0||!e.text.includes(`<@${a}`))&&(u=dispatchMessage(`channel_message`,e,f))}let p=t.onEvent,m=p===void 0?void 0:()=>dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,codeChannels:t.codeChannels===!0,envelope:r,handler:p,installationTeamId:s});if(u===null&&d===null&&t.codeChannels===!0){let e=parseMessageEvent(r);if(e!==null&&e.author?.isBot===!1&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&!isSlackCodeChannelOriginContext(e.raw)&&(a===void 0||!e.text.includes(`<@${a}`))){let n=t.onAppMention;n===void 0?d=dispatchMessage(`channel_message`,e,defaultOnMessage,{}):u=dispatchMessage(`channel_message`,e,n,{otherwise:m})}}return u??=m??d,u===null||isDuplicateEvent(r,n.retry,e.handledEvents)||e.waitUntil(u()),new Response(`ok`)}function isDuplicateEvent(e,t,n){let r=e.event_id;return r?n.has(r)?(log.warn(`received a duplicate event`,{event_id:r,event_time:e.event_time,retry_num:t?.num??`(null)`,retry_reason:t?.reason??`(null)`}),!0):(markEventHandled(r,n),!1):!1}function isSelfAuthoredSlackMessage(e,t){return e.botUserId!==void 0&&t.author?.userId===e.botUserId||e.appId!==void 0&&t.raw.app_id===e.appId}async function dispatchSlackMessage(e){let t=e.message.author,n=buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:e.message.teamId}).request,r,conversationRequest=(e,t)=>e===`conversations.info`?r??=n(e,t):n(e,t),i=e.detectCodeChannels&&e.kind!==`direct_message`&&await isSlackCodeChannel(e.message.channelId,conversationRequest);if(!i&&e.codeChannelOnly!==void 0){await e.codeChannelOnly.otherwise?.();return}let a=i?``:e.message.threadTs,o=e.message.threadTs!==e.message.ts,s=i&&o?e.message.threadTs:null,c=i?slackCodeChannelContinuationToken(e.message.channelId):slackContinuationToken({channelId:e.message.channelId,threadTs:a}),{thread:l,slack:u}=buildSlackBinding({api:e.api,appId:e.appId,botToken:e.credentials?.botToken,botUserId:e.botUserId,channelId:e.message.channelId,threadTs:a,codeChannel:i,replyThreadTs:()=>s??void 0,threadHasReplies:o,installationTeamId:e.installationTeamId,teamId:e.message.teamId}),d={channelId:e.message.channelId,installationTeamId:e.installationTeamId??null,teamId:e.message.teamId??null,threadTs:a||null,triggeringMessageTs:e.message.ts,triggeringUserId:t?.userId??null,...i&&{codeChannel:!0,replyThreadTs:s}},f=t===void 0?null:buildSlackAuthContext({channelId:e.message.channelId,fullName:t.fullName,installationTeamId:e.installationTeamId,isBot:t.isBot,teamId:e.message.teamId,threadTs:a,userId:t.userId,userName:t.userName}),p=bindSlackSessionOperations({address:c,defaultAuth:f,from:e.from,resolveSession:e.resolveSession,state:d}),m,isDMOrPrivateChannel=()=>m??=isPrivateSlackConversation({channelId:e.message.channelId,raw:e.message.raw,request:conversationRequest}),openCodeChannel=async(t={})=>{if(!e.detectCodeChannels)throw Error("ctx.openCodeChannel(): set `codeChannels: true` on slackChannel() to open code channels.");if(i)throw Error(`ctx.openCodeChannel(): this message is already in a code channel.`);return await openCodeChannelFromMessage({defaultAuth:f,from:e.from,installationTeamId:e.installationTeamId,message:e.message,name:t.name,request:n,resolveSession:e.resolveSession})},h=e.kind===`app_mention`||e.botUserId!==void 0&&e.message.text.includes(`<@${e.botUserId}`),g={...p,isBotMentioned:()=>h,isDMOrPrivateChannel,isSubscribed:async()=>await p.resolveSession()!==void 0,openCodeChannel,slack:u,thread:l},_=e.kind!==`channel_message`&&!i?acknowledgeMessage(e.received,e.message,{slack:u,thread:l}):void 0,v;try{v=await e.handler(g,e.message)}catch(t){logError(log,`${e.kind} handler failed`,t,{channelId:e.message.channelId})}if(v==null){_!==void 0&&(await _,await l.startTyping());return}await(_??acknowledgeMessage(e.received,e.message,{slack:u,thread:l}));let y=await isDMOrPrivateChannel();d.audience=e.kind===`direct_message`||y?`private`:`public`,await deliverSlackMessage({botUserId:e.receivingBotUserId,credentials:e.credentials,kind:e.kind,isPrivateConversation:y,isMentioned:h,message:e.message,resolvesTypedInput:e.resolvesTypedInput,result:v,sessionOperations:p,thread:l,threadContext:e.threadContext,uploadPolicy:e.uploadPolicy})}async function openCodeChannelFromMessage(e){let t=await openSlackCodeChannel({auth:e.defaultAuth,installationTeamId:e.installationTeamId,name:e.name,originChannelId:e.message.channelId,originTs:e.message.ts,request:e.request,teamId:e.message.teamId,triggeringUserId:e.message.author?.userId}),n=bindSlackSessionOperations({address:t.address,defaultAuth:t.auth,from:e.from,resolveSession:e.resolveSession,state:t.state}),moved=e=>e?.auth?{...e,auth:codeChannelAuth(e.auth,t.channelId)}:e;return{...n,channelId:t.channelId,send:(e,t)=>n.send(e,moved(t)),respond:(e,t)=>n.respond(e,moved(t))}}async function acknowledgeMessage(e,t,n){try{await e(t,n)}catch(e){logError(log,`received renderer failed`,e,{channelId:t.channelId})}}async function dispatchSlackEvent(e){let t=e.envelope.event.team_id,n=typeof t==`string`?t:typeof e.envelope.team_id==`string`?e.envelope.team_id:void 0,r=[],sourceFor=t=>e.from(slackSessionToken(t)),i={cancel:({target:e,turnId:t})=>sourceFor(e).cancel({turnId:t}),clear:({target:e})=>sourceFor(e).clear(),compact:({target:e})=>sourceFor(e).compact(),envelope:e.envelope,reset:({reason:e,target:t})=>sourceFor(t).reset({reason:e}),resolveSession:({target:t})=>e.resolveSession(slackSessionToken(t)),respond:(t,{auth:n,target:r})=>sourceFor(r).respond(t,{auth:n,state:withSlackResponder(void 0,typeof e.envelope.event.user==`string`?e.envelope.event.user:void 0)}),send:async(t,r)=>await receiveOnSlack({...toSessionSendOptions(r),target:r.target,message:t},{from:e.from,api:e.api,codeChannels:e.codeChannels,credentials:e.credentials,installationTeamId:e.installationTeamId,teamId:n,...typeof e.envelope.event.user==`string`?{triggeringUserId:e.envelope.event.user}:{}}),slack:buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:n}),waitUntil(e){r.push(e)}};try{await e.handler(i,e.envelope.event)}catch(t){logError(log,`event handler failed`,t,{eventId:e.envelope.event_id,eventType:e.envelope.event.type})}await Promise.allSettled(r)}async function verifyInbound(e,t){try{return await verifySlackRequest$1(e,{signingSecret:t?.signingSecret??(t?.webhookVerifier?void 0:process.env.SLACK_SIGNING_SECRET),webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`slack inbound verification failed`,{error:e}),null}}async function deliverSlackMessage(e){let{message:t,thread:n}=e;try{let r=e.threadContext===void 0?[]:await loadThreadContextMessages(n,t,e.threadContext),i=r.length>0&&e.result.history===void 0&&await e.sessionOperations.resolveSession()===void 0,a=i?void 0:formatSlackThreadContext(r),o=e.result.history??(i?slackThreadSessionHistory(r):void 0),s=await collectInboundFileParts({botUserId:e.botUserId,fetchThreadWindow:(e,t)=>fetchSlackThreadWindow(n,e,t),isMentioned:e.kind===`app_mention`,mention:t,thread:n,policy:e.uploadPolicy}),c={botUserId:e.botUserId,channelId:t.channelId,fullName:t.author?.fullName,isMentioned:e.isMentioned,teamId:t.teamId,threadTs:t.threadTs,userId:t.author?.userId??``,userName:t.author?.userName},l=formatSlackInboundMessage(c,t),u=buildSlackTurnMessage(a===void 0?l:`${a}\n\n${l}`,s),d=e.result.context??[],f=e.isPrivateConversation?`Private message`:e.result.title??t.markdown,p=e.resolvesTypedInput?slackTypedText(t.text,e.botUserId):``,m=attachInputText({auth:e.result.auth,title:f,...d.length>0&&{context:d},...o!==void 0&&{history:o}},s.length===0?p:void 0);await e.sessionOperations.send(u,m)}catch(n){logError(log,`${e.kind} delivery failed`,n,{channelId:t.channelId})}}function slackTypedText(e,t){return t===void 0?e:e.replace(RegExp(`<@${t}(?:\\|[^>]*)?>`,`gu`),``).trim()}async function cancelledARunningTurn(e,t){try{let{outcome:n}=await(await e(slackCodeChannelContinuationToken(t)).cancel()).result({signal:AbortSignal.timeout(1e4)});return n!==`ignored`}catch(e){if(e instanceof SessionNotActiveError)return!1;throw e}}function followReplyThread(e,t){t.message!==void 0&&e.codeChannel===!0&&(e.pendingReplyThreadTs=t.state?.replyThreadTs??null)}function followTriggeringMessage(e,t){if(t.message===void 0)return;let n=t.state?.triggeringMessageTs;typeof n==`string`&&(e.triggeringMessageTs=n)}function recordSlackPrincipal(e,t,n){if(t===null)return;let r=n.state?.triggeringUserId,i=slackUserIdFromAuthContext(t)??(typeof r==`string`?r:void 0);i!==void 0&&(e.slackUsersByPrincipal={...e.slackUsersByPrincipal,[t.principalId]:i})}export{slackChannel};
|
|
1
|
+
import{markEventHandled}from"./utils.js";import{createHash}from"node:crypto";import{toSessionSendOptions}from"#channel/session.js";import{attachInputText}from"#internal/input-text.js";import{createLogger,logError}from"#internal/logging.js";import{normalizeChannelAudience}from"#shared/channel-audience.js";import{SessionNotActiveError}from"#channel/session-not-active-error.js";import{setChannelBuildMetadata}from"#channel/compiled-channel.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{maxBytesOf}from"#internal/attachments/limited-read.js";import{withUndeliveredReplyNote}from"#public/channels/undelivered-reply.js";import{buildSlackBinding,buildSlackWorkspaceHandle,fetchSlackThreadWindow,slackCodeChannelContinuationToken,slackContinuationToken,slackSessionToken}from"#public/channels/slack/api.js";import{buildSlackAuthContext,slackUserIdFromAuthContext}from"#public/channels/slack/auth.js";import{createSlackCodeChannel,isSlackCodeChannel,isSlackCodeChannelOriginContext,setSlackCodeChannelStatus}from"#public/channels/slack/code-channel.js";import{resolveSlackTransportOptions}from"#public/channels/slack/transport.js";import{parseMessageEvent,parseSlackEventEnvelope,slackEventBotUserId,slackEventInstallationTeamId,slackEventReceivingBotUserId,slackMessageFromWebhookPayload}from"#public/channels/slack/inbound.js";import{withFinalReplyDelivery}from"#public/channels/slack/reply-delivery.js";import{defaultEvents,defaultInteractionEvents,defaultOnMessage,defaultReceived}from"#public/channels/slack/defaults.js";import{composeInteractionCards,composeSlackRenderers}from"#public/channels/slack/renderers.js";import{loadThreadContextMessages}from"#public/channels/slack/thread.js";import{parseSlackWebhookBody}from"#compiled/@chat-adapter/slack/webhook.js";import{bindSlackSessionOperations,withSlackResponder}from"#public/channels/slack/session-operations.js";import{buildSlackTurnMessage,collectInboundFileParts,createSlackFetchFile}from"#public/channels/slack/attachments.js";import{renderDefaultSlackTaskCard,withTaskCards}from"#public/channels/slack/task-card.js";import{formatSlackInboundMessage,formatSlackThreadContext,slackThreadSessionHistory}from"#public/channels/slack/model-context.js";import{isPrivateSlackConversation}from"#public/channels/slack/privacy.js";import{createSlackUserResolver,resolveSlackUsers,withSlackUserInfo}from"#public/channels/slack/user-info.js";import{SLACK_CHANNEL_DEFAULT_ROUTE}from"#public/channels/slack/constants.js";import{defineSlackAppManifest}from"#public/channels/slack/app-manifest.js";import{handleInteractionPost}from"#public/channels/slack/interactions.js";import{verifySlackRequest as verifySlackRequest$1}from"#public/channels/slack/verify.js";const log=createLogger(`slack.channel`);function rebuildSlackContext(e,t,n,r){let{thread:i,slack:a}=buildSlackBinding({api:n,botToken:r?.botToken,channelId:e.channelId??``,threadTs:e.threadTs??``,codeChannel:e.codeChannel===!0,replyThreadTs:()=>e.replyThreadTs??void 0,installationTeamId:e.installationTeamId??void 0,teamId:e.teamId??void 0,onThreadTsChanged(n){e.threadTs=n,e.channelId&&t.continuation?.alias(slackContinuationToken({channelId:e.channelId,threadTs:n}))},onPosted(){e.postedInThread=!0}});return{thread:i,slack:a,state:e}}function slackChannel(e={}){let t=resolveSlackTransportOptions(e.api),n=mergeUploadPolicy(e.uploadPolicy),r=e.messageContext?.users,i=createSlackUserResolver(r),a=createSlackFetchFile({api:t,botToken:e.credentials?.botToken,maxBytes:maxBytesOf(n)}),o=e.onAnswers??defaultOnAnswers,s=composeInteractionCards(e.renderers??[]),c=composeSlackRenderers(e.renderers??[],{events:{...defaultEvents,...defaultInteractionEvents(e.approvalChannel,s)},received:defaultReceived,taskCard:renderDefaultSlackTaskCard}),l=c.events[`turn.started`],u=withTaskCards({...c.events,"content.completed":withFinalReplyDelivery(c.events[`content.completed`]),async"turn.started"(e,t){let{channel:n}=t,r=slackUserIdFromAuthContext(t.session.auth.current);r!==void 0&&(n.state.triggeringUserId=r),n.state.pendingReplyThreadTs!==void 0&&(n.state.replyThreadTs=n.state.pendingReplyThreadTs,n.state.pendingReplyThreadTs=void 0),await l?.(e,t)}},c.taskCard),d=new Set,f=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:{channelId:null,threadTs:null,teamId:null,installationTeamId:null,triggeringUserId:null,triggeringMessageTs:null,pendingToolCallMessage:null,pendingAuthMessageTs:{},interactionCards:[],slackUsersByPrincipal:{}},fetchFile:a,metadata(e){return{channelId:e.channelId,teamId:e.teamId,threadTs:e.threadTs,triggeringUserId:e.triggeringUserId??null,installationTeamId:e.installationTeamId??null,triggeringMessageTs:e.triggeringMessageTs??null,...e.codeChannel===!0&&{codeChannel:!0}}},audience:({state:e})=>e.audience??`unknown`,context(n,r){return rebuildSlackContext(n,r,t,e.credentials)},deliver(e,t){return recordSlackPrincipal(t.state,t.session.auth.current,e),followReplyThread(t.state,e),followTriggeringMessage(t.state,e),withUndeliveredReplyNote(t.state,e,`Slack`)},routes:[POST(e.route??SLACK_CHANNEL_DEFAULT_ROUTE,async(r,a)=>{let{waitUntil:s}=a,{from:l,resolveSession:u}=a,f=await verifyInbound(r,e.credentials);return f===null?new Response(`unauthorized`,{status:401}):shouldDropSlackHttpTimeoutRetry(r.headers)?new Response(`ok`):(r.headers.get(`content-type`)??``).includes(`application/x-www-form-urlencoded`)?handleInteractionPost(f,{from:l,resolveSession:u,waitUntil:s},{api:t,config:e,onAnswers:o}):handleEventPost({api:t,body:f,from:l,resolveSession:u,waitUntil:s,config:e,received:c.received,userResolver:i,uploadPolicy:n,handledEvents:d,headers:r.headers})})],receive(n,{from:r}){return receiveOnSlack(n,{from:r,api:t,codeChannels:e.codeChannels===!0,credentials:e.credentials})},events:u}),p=e.credentials,m=defineSlackAppManifest({botName:e.botName,codeChannels:e.codeChannels===!0,users:i!==void 0,userEmails:typeof r==`object`&&r.email===!0});return setChannelBuildMetadata(f,e=>({externalCredentials:p?.vercelConnect,manifest:m.build(e)})),f}function defaultOnAnswers(e){return{auth:e.defaultAuth}}async function receiveOnSlack(e,t){let{message:n,target:r,...i}=e,a=r,o=a.channelId;if(!o||typeof o!=`string`)throw Error(`slackChannel().receive requires target.channelId.`);let s=typeof a.threadTs==`string`?a.threadTs:``,c=typeof a.installationTeamId==`string`?a.installationTeamId:t.installationTeamId,l=a.initialMessage;if(l&&s.length>0)throw Error("slackChannel().receive: `threadTs` and `initialMessage` are mutually exclusive.");if(a.codeChannel!==void 0){if(!t.codeChannels)throw Error("slackChannel().receive: set `codeChannels: true` on slackChannel() to open code channels.");if(l||s.length>0)throw Error("slackChannel().receive: `codeChannel` can't be combined with `threadTs` or `initialMessage`.");return await receiveInNewCodeChannel(e,t,{codeChannel:a.codeChannel,installationTeamId:c,originChannelId:o})}let u=s;if(l){let{thread:e,slack:n}=buildSlackBinding({api:t.api,botToken:t.credentials?.botToken,channelId:o,threadTs:``,installationTeamId:c,teamId:t.teamId}),{files:r,...i}=l;if(u=(await e.post(i)).id,r?.length)try{await n.uploadFiles(r)}catch(e){log.warn(`file upload after initial message post failed`,{error:e})}}let d=u||(i.idempotencyKey===void 0?crypto.randomUUID():threadlessIdentityFromKey(i.idempotencyKey)),f=a.audience===void 0?void 0:normalizeChannelAudience(a.audience),p={channelId:o,installationTeamId:c??null,threadTs:u||null,teamId:t.teamId??null,triggeringUserId:t.triggeringUserId??null};return f!==void 0&&(p.audience=f),t.from(slackContinuationToken({channelId:o,threadTs:d})).send(n,{...i,state:p})}function threadlessIdentityFromKey(e){return`key-${createHash(`sha256`).update(e).digest(`hex`).slice(0,32)}`}async function receiveInNewCodeChannel(e,t,n){let{codeChannel:r,installationTeamId:i,originChannelId:a}=n,{request:o}=buildSlackWorkspaceHandle({api:t.api,botToken:t.credentials?.botToken,installationTeamId:i,teamId:t.teamId}),s=await openSlackCodeChannel({auth:e.auth,installationTeamId:i,name:r.name,originChannelId:a,originTs:r.originTs,request:o,teamId:t.teamId,triggeringUserId:t.triggeringUserId??slackUserIdFromAuthContext(e.auth)}),{message:c,target:l,...u}=e;return await t.from(s.address).send(c,{...u,auth:s.auth,state:s.state})}async function openSlackCodeChannel(e){let{channelId:t,isPrivate:n}=await createSlackCodeChannel({name:e.name??``,originChannelId:e.originChannelId,originTs:e.originTs,requester:e.auth?.principalId??`anonymous`,request:e.request});return{address:slackCodeChannelContinuationToken(t),auth:codeChannelAuth(e.auth,t),channelId:t,state:{audience:n?`private`:`public`,channelId:t,codeChannel:!0,installationTeamId:e.installationTeamId??null,replyThreadTs:null,teamId:e.teamId??null,threadTs:null,triggeringUserId:e.triggeringUserId??null}}}function codeChannelAuth(e,t){if(e?.authenticator!==`slack-webhook`)return e;let{thread_ts:n,...r}=e.attributes;return{...e,attributes:{...r,channel_id:t}}}function shouldDropSlackHttpTimeoutRetry(e){return Number(e.get(`x-slack-retry-num`)??`0`)>=1&&e.get(`x-slack-retry-reason`)===`http_timeout`}async function handleEventPost(e){let{config:t}=e,n,r;try{n=parseSlackWebhookBody(e.body,{headers:e.headers}),r=parseSlackEventEnvelope(e.body)}catch(e){return log.warn(`inbound webhook body is not valid JSON`,{error:e}),new Response(`ok`)}if(n.kind===`url_verification`)return new Response(n.challenge,{status:200,headers:{"content-type":`text/plain`}});if(r===null)return new Response(`ok`);let i=typeof r.api_app_id==`string`?r.api_app_id:void 0,a=slackEventBotUserId(r),o=slackEventReceivingBotUserId(r),s=slackEventInstallationTeamId(r),c=r.event,l=c.channel;if(t.codeChannels===!0&&c.type===`agent_session_stopped`&&typeof l==`string`){if(isDuplicateEvent(r,n.retry,e.handledEvents))return new Response(`ok`);let i=buildSlackWorkspaceHandle({api:e.api,botToken:t.credentials?.botToken,installationTeamId:s,teamId:typeof r.team_id==`string`?r.team_id:void 0}).request,a=t.onEvent;return e.waitUntil((async()=>{if(c.thread_ts!==void 0&&!await isSlackCodeChannel(l,i)){if(a===void 0)return;await dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,codeChannels:!0,credentials:t.credentials,envelope:r,handler:a,installationTeamId:s});return}await cancelledARunningTurn(e.from,l)||await setSlackCodeChannelStatus(i,l,`active`)})().catch(e=>{logError(log,`agent_session_stopped handling failed`,e,{channelId:l})})),new Response(`ok`)}let u=null,d=null,dispatchMessage=(n,r,c,l)=>()=>dispatchSlackMessage({api:e.api,appId:i,botUserId:a,codeChannelOnly:l,detectCodeChannels:t.codeChannels===!0,receivingBotUserId:o,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,handler:c,installationTeamId:s,kind:n,message:r,received:e.received,resolvesTypedInput:t.onAnswers===void 0&&t.approvalChannel===void 0,threadContext:t.threadContext,uploadPolicy:e.uploadPolicy,userResolver:e.userResolver});if(n.kind===`app_mention`||n.kind===`direct_message`){let e=n.kind,r=slackMessageFromWebhookPayload(n,s);if(r!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},r)){let n=(e===`app_mention`?t.onAppMention:t.onDirectMessage)??t.onMessage;n===void 0?d=dispatchMessage(e,r,defaultOnMessage):u=dispatchMessage(e,r,n)}}let f=t.onMessage;if(u===null&&f!==void 0){let e=parseMessageEvent(r);e!==null&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&(a===void 0||!e.text.includes(`<@${a}`))&&(u=dispatchMessage(`channel_message`,e,f))}let p=t.onEvent,m=p===void 0?void 0:()=>dispatchSlackEvent({api:e.api,from:e.from,resolveSession:e.resolveSession,credentials:t.credentials,codeChannels:t.codeChannels===!0,envelope:r,handler:p,installationTeamId:s});if(u===null&&d===null&&t.codeChannels===!0){let e=parseMessageEvent(r);if(e!==null&&e.author?.isBot===!1&&!isSelfAuthoredSlackMessage({appId:i,botUserId:a},e)&&!isSlackCodeChannelOriginContext(e.raw)&&(a===void 0||!e.text.includes(`<@${a}`))){let n=t.onAppMention;n===void 0?d=dispatchMessage(`channel_message`,e,defaultOnMessage,{}):u=dispatchMessage(`channel_message`,e,n,{otherwise:m})}}return u??=m??d,u===null||isDuplicateEvent(r,n.retry,e.handledEvents)||e.waitUntil(u()),new Response(`ok`)}function isDuplicateEvent(e,t,n){let r=e.event_id;return r?n.has(r)?(log.warn(`received a duplicate event`,{event_id:r,event_time:e.event_time,retry_num:t?.num??`(null)`,retry_reason:t?.reason??`(null)`}),!0):(markEventHandled(r,n),!1):!1}function isSelfAuthoredSlackMessage(e,t){return e.botUserId!==void 0&&t.author?.userId===e.botUserId||e.appId!==void 0&&t.raw.app_id===e.appId}async function dispatchSlackMessage(e){let t=buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:e.message.teamId}).request,n={request:t,teamId:e.installationTeamId??e.message.teamId},r,resolveMessage=()=>r??=e.userResolver===void 0?Promise.resolve(e.message):withSlackUserInfo(e.message,e.userResolver,n),i=e.kind===`channel_message`?e.message:await resolveMessage(),a=i.author,o,conversationRequest=(e,n)=>e===`conversations.info`?o??=t(e,n):t(e,n),s=e.detectCodeChannels&&e.kind!==`direct_message`&&await isSlackCodeChannel(e.message.channelId,conversationRequest);if(!s&&e.codeChannelOnly!==void 0){await e.codeChannelOnly.otherwise?.();return}let c=s?``:e.message.threadTs,l=e.message.threadTs!==e.message.ts,u=s&&l?e.message.threadTs:null,d=s?slackCodeChannelContinuationToken(e.message.channelId):slackContinuationToken({channelId:e.message.channelId,threadTs:c}),{thread:f,slack:p}=buildSlackBinding({api:e.api,appId:e.appId,botToken:e.credentials?.botToken,botUserId:e.botUserId,channelId:e.message.channelId,threadTs:c,codeChannel:s,replyThreadTs:()=>u??void 0,threadHasReplies:l,installationTeamId:e.installationTeamId,teamId:e.message.teamId}),m={channelId:e.message.channelId,installationTeamId:e.installationTeamId??null,teamId:e.message.teamId??null,threadTs:c||null,triggeringMessageTs:e.message.ts,triggeringUserId:a?.userId??null,...s&&{codeChannel:!0,replyThreadTs:u}},h=a===void 0?null:buildSlackAuthContext({channelId:e.message.channelId,email:a.email,fullName:a.fullName,installationTeamId:e.installationTeamId,isBot:a.isBot,teamId:e.message.teamId,threadTs:c,userId:a.userId,userName:a.userName}),g=bindSlackSessionOperations({address:d,defaultAuth:h,from:e.from,resolveSession:e.resolveSession,state:m}),_,isDMOrPrivateChannel=()=>_??=isPrivateSlackConversation({channelId:e.message.channelId,raw:e.message.raw,request:conversationRequest}),openCodeChannel=async(n={})=>{if(!e.detectCodeChannels)throw Error("ctx.openCodeChannel(): set `codeChannels: true` on slackChannel() to open code channels.");if(s)throw Error(`ctx.openCodeChannel(): this message is already in a code channel.`);return await openCodeChannelFromMessage({defaultAuth:h,from:e.from,installationTeamId:e.installationTeamId,message:e.message,name:n.name,request:t,resolveSession:e.resolveSession})},v=e.kind===`app_mention`||e.botUserId!==void 0&&e.message.text.includes(`<@${e.botUserId}`),y={...g,isBotMentioned:()=>v,isDMOrPrivateChannel,isSubscribed:async()=>await g.resolveSession()!==void 0,openCodeChannel,slack:p,thread:f},b=e.kind!==`channel_message`&&!s?acknowledgeMessage(e.received,e.message,{slack:p,thread:f}):void 0,x;try{x=await e.handler(y,i)}catch(t){logError(log,`${e.kind} handler failed`,t,{channelId:e.message.channelId})}if(x==null){b!==void 0&&(await b,await f.startTyping());return}await(b??acknowledgeMessage(e.received,e.message,{slack:p,thread:f}));let S=await isDMOrPrivateChannel();m.audience=e.kind===`direct_message`||S?`private`:`public`,await deliverSlackMessage({botUserId:e.receivingBotUserId,credentials:e.credentials,kind:e.kind,isPrivateConversation:S,isMentioned:v,message:await resolveMessage(),resolvesTypedInput:e.resolvesTypedInput,result:x,sessionOperations:g,thread:f,threadContext:e.threadContext,uploadPolicy:e.uploadPolicy,users:e.userResolver&&{resolver:e.userResolver,...n}})}async function openCodeChannelFromMessage(e){let t=await openSlackCodeChannel({auth:e.defaultAuth,installationTeamId:e.installationTeamId,name:e.name,originChannelId:e.message.channelId,originTs:e.message.ts,request:e.request,teamId:e.message.teamId,triggeringUserId:e.message.author?.userId}),n=bindSlackSessionOperations({address:t.address,defaultAuth:t.auth,from:e.from,resolveSession:e.resolveSession,state:t.state}),moved=e=>e?.auth?{...e,auth:codeChannelAuth(e.auth,t.channelId)}:e;return{...n,channelId:t.channelId,send:(e,t)=>n.send(e,moved(t)),respond:(e,t)=>n.respond(e,moved(t))}}async function acknowledgeMessage(e,t,n){try{await e(t,n)}catch(e){logError(log,`received renderer failed`,e,{channelId:t.channelId})}}async function dispatchSlackEvent(e){let t=e.envelope.event.team_id,n=typeof t==`string`?t:typeof e.envelope.team_id==`string`?e.envelope.team_id:void 0,r=[],sourceFor=t=>e.from(slackSessionToken(t)),i={cancel:({target:e,turnId:t})=>sourceFor(e).cancel({turnId:t}),clear:({target:e})=>sourceFor(e).clear(),compact:({target:e})=>sourceFor(e).compact(),envelope:e.envelope,end:({reason:e,target:t})=>sourceFor(t).end({reason:e}),resolveSession:({target:t})=>e.resolveSession(slackSessionToken(t)),respond:(t,{auth:n,target:r})=>sourceFor(r).respond(t,{auth:n,state:withSlackResponder(void 0,typeof e.envelope.event.user==`string`?e.envelope.event.user:void 0)}),send:async(t,r)=>await receiveOnSlack({...toSessionSendOptions(r),target:r.target,message:t},{from:e.from,api:e.api,codeChannels:e.codeChannels,credentials:e.credentials,installationTeamId:e.installationTeamId,teamId:n,...typeof e.envelope.event.user==`string`?{triggeringUserId:e.envelope.event.user}:{}}),slack:buildSlackWorkspaceHandle({api:e.api,botToken:e.credentials?.botToken,installationTeamId:e.installationTeamId,teamId:n}),waitUntil(e){r.push(e)}};try{await e.handler(i,e.envelope.event)}catch(t){logError(log,`event handler failed`,t,{eventId:e.envelope.event_id,eventType:e.envelope.event.type})}await Promise.allSettled(r)}async function verifyInbound(e,t){try{return await verifySlackRequest$1(e,{signingSecret:t?.signingSecret??(t?.webhookVerifier?void 0:process.env.SLACK_SIGNING_SECRET),webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`slack inbound verification failed`,{error:e}),null}}async function deliverSlackMessage(e){let{message:t,thread:n}=e;try{let r=e.threadContext===void 0?[]:await loadThreadContextMessages(n,t,e.threadContext),i=r.length>0&&e.result.history===void 0&&await e.sessionOperations.resolveSession()===void 0,a=e.users===void 0?void 0:await resolveSlackUsers(e.users.resolver,{request:e.users.request,teamId:e.users.teamId,userIds:r.flatMap(e=>e.user?[e.user]:[])}),o=i?void 0:formatSlackThreadContext(r,a),s=e.result.history??(i?slackThreadSessionHistory(r,a):void 0),c=await collectInboundFileParts({botUserId:e.botUserId,fetchThreadWindow:(e,t)=>fetchSlackThreadWindow(n,e,t),isMentioned:e.kind===`app_mention`,mention:t,thread:n,policy:e.uploadPolicy}),l={botUserId:e.botUserId,channelId:t.channelId,displayName:t.author?.displayName,email:t.author?.email,fullName:t.author?.fullName,isMentioned:e.isMentioned,teamId:t.teamId,threadTs:t.threadTs,userId:t.author?.userId??``,userName:t.author?.userName},u=formatSlackInboundMessage(l,t),d=buildSlackTurnMessage(o===void 0?u:`${o}\n\n${u}`,c),f=e.result.context??[],p=e.isPrivateConversation?`Private message`:e.result.title??t.markdown,m=e.resolvesTypedInput?slackTypedText(t.text,e.botUserId):``,h=attachInputText({auth:e.result.auth,title:p,...f.length>0&&{context:f},...s!==void 0&&{history:s}},c.length===0?m:void 0);await e.sessionOperations.send(d,h)}catch(n){logError(log,`${e.kind} delivery failed`,n,{channelId:t.channelId})}}function slackTypedText(e,t){return t===void 0?e:e.replace(RegExp(`<@${t}(?:\\|[^>]*)?>`,`gu`),``).trim()}async function cancelledARunningTurn(e,t){try{let{outcome:n}=await(await e(slackCodeChannelContinuationToken(t)).cancel()).result({signal:AbortSignal.timeout(1e4)});return n!==`ignored`}catch(e){if(e instanceof SessionNotActiveError)return!1;throw e}}function followReplyThread(e,t){t.message!==void 0&&e.codeChannel===!0&&(e.pendingReplyThreadTs=t.state?.replyThreadTs??null)}function followTriggeringMessage(e,t){if(t.message===void 0)return;let n=t.state?.triggeringMessageTs;typeof n==`string`&&(e.triggeringMessageTs=n)}function recordSlackPrincipal(e,t,n){if(t===null)return;let r=n.state?.triggeringUserId,i=slackUserIdFromAuthContext(t)??(typeof r==`string`?r:void 0);i!==void 0&&(e.slackUsersByPrincipal={...e.slackUsersByPrincipal,[t.principalId]:i})}export{slackChannel};
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import type { SlackRequest } from "#public/channels/slack/code-channel.js";
|
|
2
|
+
import type { SlackMessage } from "#public/channels/slack/inbound.js";
|
|
3
|
+
/** Slack profile fields `messageContext.users` adds to a message's sender. */
|
|
4
|
+
export interface SlackUserInfo {
|
|
5
|
+
/** Rendered as the sender's `display_name`. Kept unless `messageContext.users.name` is `false`. */
|
|
6
|
+
readonly displayName?: string;
|
|
7
|
+
/** Rendered as the sender's `real_name`, and set as `message.author.fullName`. Kept unless `name` is `false`. */
|
|
8
|
+
readonly realName?: string;
|
|
9
|
+
/** Rendered as the sender's `email`. Kept only with `messageContext.users.email`. */
|
|
10
|
+
readonly email?: string;
|
|
11
|
+
}
|
|
12
|
+
/** The `messageContext.users` option of `slackChannel()`. */
|
|
13
|
+
export type SlackUsersOption = boolean | {
|
|
14
|
+
/**
|
|
15
|
+
* Adds each sender's display and real names. Defaults to `true`; set
|
|
16
|
+
* `false` with `email: true` to add emails only.
|
|
17
|
+
*/
|
|
18
|
+
readonly name?: boolean;
|
|
19
|
+
/** Adds each sender's email. Needs the `users:read.email` scope. */
|
|
20
|
+
readonly email?: boolean;
|
|
21
|
+
/**
|
|
22
|
+
* Resolves one user, for example from your own cache. `next()` is eve's
|
|
23
|
+
* uncached `users.info` call and throws when Slack rejects it. Return
|
|
24
|
+
* `undefined` to leave the user's profile fields out.
|
|
25
|
+
*/
|
|
26
|
+
readonly resolve?: (user: {
|
|
27
|
+
readonly userId: string;
|
|
28
|
+
/**
|
|
29
|
+
* Workspace whose app installation received the message, falling
|
|
30
|
+
* back to the message's team: `message.installationTeamId ??
|
|
31
|
+
* message.teamId`. Slack user ids are scoped to it, so key caches on
|
|
32
|
+
* it rather than on `message.teamId`.
|
|
33
|
+
*/
|
|
34
|
+
readonly teamId: string | undefined;
|
|
35
|
+
}, next: () => Promise<SlackUserInfo>) => Promise<SlackUserInfo | undefined>;
|
|
36
|
+
};
|
|
37
|
+
/** Looks up Slack users for one channel. Never throws; a failure resolves to `undefined`. */
|
|
38
|
+
export type SlackUserResolver = (input: {
|
|
39
|
+
readonly userId: string;
|
|
40
|
+
readonly teamId: string | undefined;
|
|
41
|
+
readonly request: SlackRequest;
|
|
42
|
+
}) => Promise<SlackUserInfo | undefined>;
|
|
43
|
+
/**
|
|
44
|
+
* Builds the resolver for `messageContext.users`, or `undefined` when it adds
|
|
45
|
+
* no fields. Without an authored `resolve`, `users.info` results are cached in
|
|
46
|
+
* memory per workspace and user for an hour, and failures for a minute. Each
|
|
47
|
+
* Slack channel builds its own, so a profile fetched with one app's scopes
|
|
48
|
+
* never reaches another app in the same process.
|
|
49
|
+
*/
|
|
50
|
+
export declare function createSlackUserResolver(option: SlackUsersOption | undefined, now?: () => number): SlackUserResolver | undefined;
|
|
51
|
+
/**
|
|
52
|
+
* Resolves each distinct user, the first {@link MAX_LOOKUPS_PER_MESSAGE} only.
|
|
53
|
+
* A failed or empty lookup leaves that user out of the map.
|
|
54
|
+
*/
|
|
55
|
+
export declare function resolveSlackUsers(resolver: SlackUserResolver, input: {
|
|
56
|
+
readonly userIds: readonly string[];
|
|
57
|
+
readonly teamId: string | undefined;
|
|
58
|
+
readonly request: SlackRequest;
|
|
59
|
+
}): Promise<ReadonlyMap<string, SlackUserInfo>>;
|
|
60
|
+
/** Returns `message` with its human author's resolved profile fields, or unchanged. */
|
|
61
|
+
export declare function withSlackUserInfo(message: SlackMessage, resolver: SlackUserResolver, input: {
|
|
62
|
+
readonly teamId: string | undefined;
|
|
63
|
+
readonly request: SlackRequest;
|
|
64
|
+
}): Promise<SlackMessage>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{createLogger,logError}from"#internal/logging.js";const log=createLogger(`slack.user-info`);function createSlackUserResolver(e,t=Date.now){if(e===void 0||e===!1)return;let n=e===!0||e.name!==!1,r=e!==!0&&e.email===!0;if(!n&&!r)return;let i=e===!0?void 0:e.resolve,a=new Map,o=i===void 0?({userId:e,teamId:n,request:r})=>{let i=`${n??``}:${e}`,o=a.get(i);if(o!==void 0&&o.expiresAt>t())return o.profile;if(a.delete(i),a.size>=1e3){let e=a.keys().next().value;e!==void 0&&a.delete(e)}let s=t(),c=fetchSlackUserInfo(e,r).catch(t=>{logError(log,`Slack user lookup failed; omitting it`,t,{userId:e}),a.get(i)?.profile===c&&a.set(i,{expiresAt:s+6e4,profile:c})});return a.set(i,{expiresAt:s+36e5,profile:c}),c}:({userId:e,teamId:t,request:n})=>i({userId:e,teamId:t},()=>fetchSlackUserInfo(e,n));return async e=>{let t;try{let i=await Promise.race([o(e),new Promise(n=>{t=setTimeout(()=>{log.warn(`Slack user lookup timed out; omitting it`,{userId:e.userId}),n(void 0)},2e3)})]);if(i===void 0)return;let{displayName:a,realName:s,email:c}=i;return{...n&&a&&{displayName:a},...n&&s&&{realName:s},...r&&c&&{email:c}}}catch(t){logError(log,`Slack user lookup threw; omitting it`,t,{userId:e.userId});return}finally{clearTimeout(t)}}}async function resolveSlackUsers(e,t){let n=[...new Set(t.userIds)].slice(0,20),r=await Promise.all(n.map(async n=>{let r=await e({userId:n,teamId:t.teamId,request:t.request});return r===void 0?[]:[[n,r]]}));return new Map(r.flat())}async function withSlackUserInfo(e,t,n){let r=e.author;if(r===void 0||r.isBot)return e;let i=await t({userId:r.userId,...n});return i===void 0?e:{...e,author:{...r,fullName:i.realName??r.fullName,...i.displayName&&{displayName:i.displayName},...i.email&&{email:i.email}}}}async function fetchSlackUserInfo(e,t){let n=await t(`users.info`,{user:e});if(n.ok!==!0){let e=typeof n.error==`string`?n.error:`unknown_error`;throw Error(e===`missing_scope`?`Slack users.info failed with missing_scope: add the users:read scope (and users:read.email for emails), then reinstall the Slack app.`:`Slack users.info failed with ${e}.`)}return userInfoFromSlack(n.user)}function userInfoFromSlack(e){if(typeof e!=`object`||!e)return{};let t=e,n=typeof t.profile==`object`&&t.profile!==null?t.profile:{},r=nonEmpty(n.display_name),i=nonEmpty(n.real_name)??nonEmpty(t.real_name),a=nonEmpty(n.email);return{...r&&{displayName:r},...i&&{realName:i},...a&&{email:a}}}function nonEmpty(e){return typeof e==`string`&&e.trim().length>0?e.trim():void 0}export{createSlackUserResolver,resolveSlackUsers,withSlackUserInfo};
|
|
@@ -52,9 +52,10 @@ export interface TeamsChannelState {
|
|
|
52
52
|
tenantId: string | null;
|
|
53
53
|
/** User account that triggered the latest turn/session. */
|
|
54
54
|
triggeringUser: TeamsChannelAccount | null;
|
|
55
|
-
/**
|
|
56
|
-
|
|
57
|
-
|
|
55
|
+
/**
|
|
56
|
+
* Teams account behind each principal that sent a message or answer. The
|
|
57
|
+
* default handlers name who decided an approval and whom a sign-in is for.
|
|
58
|
+
*/
|
|
58
59
|
approvalResponderAccounts?: Record<string, TeamsChannelAccount>;
|
|
59
60
|
}
|
|
60
61
|
/** Teams channel credentials. */
|
|
@@ -17,17 +17,10 @@ export declare const TELEGRAM_CALLBACK_RESPONSE_PREFIX = "telegram_callback:";
|
|
|
17
17
|
/** Synthetic request id prefix the deliver hook uses for replies to ForceReply prompts. */
|
|
18
18
|
export declare const TELEGRAM_REPLY_RESPONSE_PREFIX = "telegram_reply:";
|
|
19
19
|
/**
|
|
20
|
-
* Durable
|
|
21
|
-
*
|
|
22
|
-
* `pendingFreeformReplies` maps a posted prompt's message id to the awaiting
|
|
23
|
-
* requestId.
|
|
20
|
+
* Durable state the Telegram channel keeps for posted input requests. Telegram
|
|
21
|
+
* caps `callback_data` at 64 bytes, so buttons carry compact ids instead of answers.
|
|
24
22
|
*/
|
|
25
23
|
export interface TelegramHitlState {
|
|
26
|
-
hitlCallbacks?: Record<string, Answer>;
|
|
27
|
-
nextHitlCallbackId?: number;
|
|
28
|
-
pendingFreeformReplies?: Record<string, string>;
|
|
29
|
-
/** Posted prompts with inline keyboards, keyed by requestId, until eve resolves them. */
|
|
30
|
-
hitlPrompts?: Record<string, TelegramHitlPrompt>;
|
|
31
24
|
}
|
|
32
25
|
/** What a posted prompt needs so its message can be edited once eve resolves it. */
|
|
33
26
|
export interface TelegramHitlPrompt {
|
|
@@ -12,6 +12,6 @@ export interface TelegramInstrumentationMetadata extends Record<string, unknown>
|
|
|
12
12
|
export { telegramChannel, type TelegramChannel, type TelegramChannelConfig, type TelegramChannelContext, type TelegramChannelCredentials, type TelegramChannelEvents, type TelegramChannelState, type TelegramContext, type TelegramEventContext, type TelegramHandle, type TelegramInboundResult, type TelegramReceiveTarget, } from "#public/channels/telegram/telegramChannel.js";
|
|
13
13
|
export { telegramContinuationToken, type TelegramApiOptions, type TelegramApiResponse, type TelegramBotToken, type TelegramEphemeralMessageParameters, type TelegramFetch, type TelegramMessageBody, type TelegramMessageResult, } from "#public/channels/telegram/api.js";
|
|
14
14
|
export { type TelegramAttachment, type TelegramCallbackQuery, type TelegramChat, type TelegramChatType, type TelegramInboundContext, type TelegramMessage, type TelegramMessageReference, type TelegramUpdate, type TelegramUser, } from "#public/channels/telegram/inbound.js";
|
|
15
|
-
export { type
|
|
15
|
+
export { type TelegramInteractionMessage } from "#public/channels/telegram/hitl.js";
|
|
16
16
|
export { defaultTelegramAuth } from "#public/channels/telegram/defaults.js";
|
|
17
17
|
export { type TelegramWebhookSecretToken, type TelegramWebhookVerifier, } from "#public/channels/telegram/verify.js";
|
|
@@ -42,8 +42,6 @@ export interface TelegramChannelState extends TelegramHitlState {
|
|
|
42
42
|
* reads it from delivery state to answer a pending ForceReply prompt.
|
|
43
43
|
*/
|
|
44
44
|
replyToBotMessageId?: string | null;
|
|
45
|
-
/** Public authorization status messages, keyed by connection name. */
|
|
46
|
-
pendingAuthMessageIds?: Record<string, string>;
|
|
47
45
|
}
|
|
48
46
|
/** Telegram channel credentials. `webhookVerifier` is a custom inbound webhook verifier for forwarded webhooks. */
|
|
49
47
|
/** Target for `receive(telegram, { target })` proactive sessions. `chatId` is required. `conversationId` resumes an existing thread; `initialMessage` posts a seed message and starts a new thread from it. The two are mutually exclusive: supplying both throws. */
|
|
@@ -30,8 +30,6 @@ export interface TwilioChannelState extends PromptQueueState {
|
|
|
30
30
|
lastMessageSid?: string | null;
|
|
31
31
|
/** Most recent inbound Call SID when this session was started by voice. */
|
|
32
32
|
lastCallSid?: string | null;
|
|
33
|
-
/** The sign-ins the default flow sent a prompt for, by connection name. */
|
|
34
|
-
pendingSignIns?: Record<string, string>;
|
|
35
33
|
}
|
|
36
34
|
/** Per-session instrumentation snapshot for Twilio runtime telemetry. Reports the active phone-number pair and the most recent message and call SIDs. */
|
|
37
35
|
export interface TwilioInstrumentationMetadata extends Record<string, unknown> {
|
|
@@ -2,11 +2,6 @@ import type { ChannelDelivery } from "#shared/channel-delivery.js";
|
|
|
2
2
|
import { type Logger } from "#internal/logging.js";
|
|
3
3
|
/** Channel state that remembers a final reply the user never saw. */
|
|
4
4
|
export interface UndeliveredReplyState {
|
|
5
|
-
/**
|
|
6
|
-
* Error id of a final reply that never reached the user. The next delivered
|
|
7
|
-
* message tells the model the reply was not seen, then clears it.
|
|
8
|
-
*/
|
|
9
|
-
undeliveredReplyErrorId?: string | null;
|
|
10
5
|
}
|
|
11
6
|
/** Where a channel's final reply failed, and how to post a notice there. */
|
|
12
7
|
export interface UndeliveredReplySurface {
|
|
@@ -2,6 +2,12 @@ import type { PublicAgentDefinition, PublicAgentStaticModelDefinition } from "#s
|
|
|
2
2
|
import type { ExactDefinition } from "#public/definitions/exact.js";
|
|
3
3
|
import type { RemoteAgentDefinition } from "#public/definitions/remote-agent.js";
|
|
4
4
|
import { defineDynamic as defineDynamicBase } from "#dynamic/definition.js";
|
|
5
|
+
/**
|
|
6
|
+
* Cross-instance brand stamped by {@link defineAgent}. The compiler rejects an `agent.ts` export
|
|
7
|
+
* without it, so a plain object can't pass for an agent definition. `Symbol.for` lets the
|
|
8
|
+
* compiler's module copy and the author's import share the key; a symbol key stays out of the
|
|
9
|
+
* `Object.keys`-based shape validators.
|
|
10
|
+
*/
|
|
5
11
|
declare const DEFINED_AGENT: unique symbol;
|
|
6
12
|
export type { AgentModelOptionsDefinition, AgentReasoningDefinition, AgentBuildDefinition, AgentExperimentalDefinition, AgentLimitsDefinition, SessionUsageLimit, PublicAgentModelSelectionDefinition as AgentModelSelectionDefinition, AgentWorkflowDefinition, AgentWorkflowRetentionDefinition, AgentWorkflowWorldDefinition, PublicAgentModelDefinition as AgentModelDefinition, PublicAgentStaticModelDefinition as AgentStaticModelDefinition, PublicAgentCompactionDefinition as AgentCompactionDefinition, } from "#shared/agent-definition.js";
|
|
7
13
|
/**
|
|
@@ -15,19 +21,19 @@ export type { AgentModelOptionsDefinition, AgentReasoningDefinition, AgentBuildD
|
|
|
15
21
|
* channel uses to gate its `fetch` handler.
|
|
16
22
|
*/
|
|
17
23
|
export type AgentDefinition = PublicAgentDefinition;
|
|
18
|
-
/** Literal-preserving value returned by {@link defineAgent}. */
|
|
24
|
+
/** Literal-preserving value returned by {@link defineAgent}, carrying its brand. */
|
|
19
25
|
export type DefinedAgent<TAgent extends AgentDefinition = AgentDefinition> = TAgent & {
|
|
20
26
|
readonly [DEFINED_AGENT]: true;
|
|
21
27
|
};
|
|
22
28
|
/**
|
|
23
|
-
* Agent configuration returned by a dynamic subagent resolver
|
|
24
|
-
* tells the parent agent when to delegate.
|
|
29
|
+
* Agent configuration returned by a dynamic subagent resolver: `defineAgent({ description, model })`.
|
|
30
|
+
* The description tells the parent agent when to delegate.
|
|
25
31
|
*/
|
|
26
|
-
export type DynamicLocalSubagentDefinition = Extract<AgentDefinition, {
|
|
32
|
+
export type DynamicLocalSubagentDefinition = DefinedAgent<Extract<AgentDefinition, {
|
|
27
33
|
readonly model: PublicAgentStaticModelDefinition;
|
|
28
34
|
}> & {
|
|
29
35
|
readonly description: string;
|
|
30
|
-
}
|
|
36
|
+
}>;
|
|
31
37
|
/** Definition a dynamic subagent resolver may select at runtime. */
|
|
32
38
|
export type DynamicSubagentDefinition = DynamicLocalSubagentDefinition | RemoteAgentDefinition;
|
|
33
39
|
/** What a dynamic subagent resolves to: the subagent, or `null` to omit it. */
|
|
@@ -48,8 +54,8 @@ export type DynamicSubagentResult = DynamicSubagentDefinition | null;
|
|
|
48
54
|
*/
|
|
49
55
|
export declare const defineDynamic: typeof defineDynamicBase;
|
|
50
56
|
/**
|
|
51
|
-
* Defines the agent configuration authored in `agent.ts
|
|
52
|
-
*
|
|
57
|
+
* Defines the agent configuration authored in `agent.ts`. Returns the same object, preserving its
|
|
58
|
+
* literal type, stamped with the brand the compiler requires: a plain object export is rejected.
|
|
53
59
|
*
|
|
54
60
|
* TypeScript checks the argument against {@link AgentDefinition}: any key outside
|
|
55
61
|
* that shape is a compile error. The compiler derives identity (the agent name)
|
|
@@ -57,3 +63,5 @@ export declare const defineDynamic: typeof defineDynamicBase;
|
|
|
57
63
|
* basename), so do not author a `name` field.
|
|
58
64
|
*/
|
|
59
65
|
export declare function defineAgent<TAgent extends AgentDefinition>(definition: ExactDefinition<TAgent, AgentDefinition>): DefinedAgent<TAgent>;
|
|
66
|
+
/** Whether `value` came from {@link defineAgent}. */
|
|
67
|
+
export declare function isDefinedAgent(value: unknown): value is DefinedAgent;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{defineDynamic as defineDynamic$1}from"#dynamic/definition.js";const defineDynamic=defineDynamic$1;function defineAgent(e){return e}export{defineAgent,defineDynamic};
|
|
1
|
+
import{defineDynamic as defineDynamic$1}from"#dynamic/definition.js";const DEFINED_AGENT=Symbol.for(`eve.defined-agent`),defineDynamic=defineDynamic$1;function defineAgent(e){return Object.defineProperty(e,DEFINED_AGENT,{configurable:!0,value:!0}),e}function isDefinedAgent(e){return typeof e==`object`&&!!e&&Reflect.get(e,DEFINED_AGENT)===!0}export{defineAgent,defineDynamic,isDefinedAgent};
|
|
@@ -18,7 +18,7 @@ import type { FactPosition } from "#protocol/session-events/envelope.js";
|
|
|
18
18
|
import { type SessionView } from "#protocol/session-projection/session-view.js";
|
|
19
19
|
import type { GenericChannelDefinition, GenericReceiveInput } from "#shared/channel-definition.js";
|
|
20
20
|
declare const CHANNEL_METADATA_TYPE: unique symbol;
|
|
21
|
-
export type { CancelTurnResult, ClearSessionResult, CompactSessionResult,
|
|
21
|
+
export type { CancelTurnResult, ClearSessionResult, CompactSessionResult, EndSessionResult, SessionCallback, TurnPolicy, } from "#channel/types.js";
|
|
22
22
|
export { SessionStrandedError } from "#channel/session-stranded-error.js";
|
|
23
23
|
export type { Session } from "#channel/session.js";
|
|
24
24
|
export type { ChannelAudience } from "#shared/channel-audience.js";
|
|
@@ -77,16 +77,18 @@ export interface RouteContext {
|
|
|
77
77
|
readonly requestIp: string | null;
|
|
78
78
|
}
|
|
79
79
|
/**
|
|
80
|
-
*
|
|
80
|
+
* Cross-instance brand on a {@link DisabledRouteSentinel}. `Symbol.for` lets the compiler's module
|
|
81
|
+
* copy and the author's import share the key; keeping it unexported makes the sentinel opaque, so
|
|
82
|
+
* only {@link disableRoute} produces one.
|
|
81
83
|
*/
|
|
82
|
-
declare const
|
|
84
|
+
declare const DISABLED_ROUTE: unique symbol;
|
|
83
85
|
/**
|
|
84
|
-
*
|
|
86
|
+
* Opaque value returned from {@link disableRoute}. Export this as the
|
|
85
87
|
* default export of a file in `agent/channels/` to remove the framework
|
|
86
88
|
* default route whose logical name matches the file's slug path.
|
|
87
89
|
*/
|
|
88
90
|
export interface DisabledRouteSentinel {
|
|
89
|
-
readonly
|
|
91
|
+
readonly [DISABLED_ROUTE]: true;
|
|
90
92
|
}
|
|
91
93
|
/**
|
|
92
94
|
* Returns a sentinel that disables the framework route whose logical name
|