@mastra/factory 0.28.0-alpha.10 → 0.28.0-alpha.11
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/README.md +2 -0
- package/dist/capabilities/version-control.d.ts +6 -1
- package/dist/capabilities/version-control.d.ts.map +1 -1
- package/dist/environment/build-schedule.js +1 -1
- package/dist/environment/build-schedule.js.map +1 -1
- package/dist/environment/build.d.ts +3 -3
- package/dist/environment/build.d.ts.map +1 -1
- package/dist/environment/build.js +3 -1
- package/dist/environment/build.js.map +1 -1
- package/dist/environment/heads.d.ts +1 -1
- package/dist/environment/heads.d.ts.map +1 -1
- package/dist/environment/heads.js +4 -1
- package/dist/environment/heads.js.map +1 -1
- package/dist/environment/repository-access.d.ts +13 -0
- package/dist/environment/repository-access.d.ts.map +1 -0
- package/dist/environment/repository-access.js +55 -0
- package/dist/environment/repository-access.js.map +1 -0
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +18 -12
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/slack/integration.d.ts.map +1 -1
- package/dist/integrations/slack/integration.js +7 -4
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/routes/board-snapshot.d.ts +6 -0
- package/dist/routes/board-snapshot.d.ts.map +1 -1
- package/dist/routes/board-snapshot.js +23 -6
- package/dist/routes/board-snapshot.js.map +1 -1
- package/dist/routes/contracts.d.ts +6 -0
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +11 -0
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +60 -6
- package/dist/routes/work-items.js.map +1 -1
- package/dist/session/live-sessions.d.ts +1 -1
- package/dist/session/live-sessions.d.ts.map +1 -1
- package/dist/session/live-sessions.js +12 -2
- package/dist/session/live-sessions.js.map +1 -1
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +15 -2
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +1 -1
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/work-items/related-cards.d.ts +21 -0
- package/dist/work-items/related-cards.d.ts.map +1 -0
- package/dist/work-items/related-cards.js +45 -0
- package/dist/work-items/related-cards.js.map +1 -0
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +7 -14
- package/dist/workspace.js.map +1 -1
- package/factory-skills/factory-build/SKILL.md +1 -1
- package/factory-skills/factory-self-review/SKILL.md +1 -1
- package/package.json +8 -8
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"integration.js","names":[],"sources":["../../../src/integrations/slack/integration.ts"],"sourcesContent":["/**\n * `SlackIntegration` — Slack as a `FactoryIntegration`.\n *\n * Slack contributes two things to a factory: the chat channels that carry\n * inbound messages into agent runs (`channels()`), and the browser-facing\n * account-link routes that bind a Slack sender to a Mastra tenant (`routes()`).\n * Both used to be assembled by hand in the deploy entry, which had to reach\n * into the prepared agent controller by string key, resolve storage domains\n * itself, mint its own state signer, and splice routes onto the factory's\n * assembled server config. Implementing the integration interface instead means\n * the factory does all of that the same way it already does for GitHub and\n * Linear, and the entry's job shrinks to reading Slack's env vars once.\n *\n * Slack ships as a factory built-in alongside GitHub and Linear (it originally\n * lived in `mastracode/web` to keep `@mastra/slack`/`chat` out of this package;\n * the team reversed that so `create-factory` consumers get Slack channels out\n * of the box). The integration interface remains open — third parties still add\n * capabilities by implementing `FactoryIntegration` from outside the package.\n */\n\nimport type { AgentChannels, TypingStatusFn } from '@mastra/core/channels';\nimport type { InputProcessor, OutputProcessor } from '@mastra/core/processors';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { ApiRoute } from '@mastra/core/server';\nimport type { SlackAdapterChannelConfig } from '@mastra/slack';\n\n\nimport type { FactoryChannelsConfig, FactoryIntegration, IntegrationContext, IntegrationTools } from '../base.js';\nimport { announcePullRequest } from '../channel-thread-announcements.js';\nimport { parseCreatedPullRequest } from '../github/session-subscriptions.js';\nimport { FactoryChannelReplyProcessor } from './channel-reply-processor.js';\nimport { FactoryChannelSessionLinkProcessor } from './channel-session-link-processor.js';\nimport { createSlackChatTools } from './chat-tools.js';\nimport { createSlackConnectRoutes } from './connect-route.js';\nimport { FactoryReplyReminderProcessor } from './reply-reminder-processor.js';\nimport { createReplyTool, FactoryReplyStreamProcessor, REPLY_TOOL_NAME } from './reply-tool.js';\nimport { createShareFileTool, isSlackThread, slackThreadOf } from './share-file-tool.js';\nimport type { ShareFileToolDeps } from './share-file-tool.js';\nimport { createSlackChannelsConfig } from './slack.js';\nimport { DEFAULT_SLACK_TOOL_SETTINGS, slackToolSettingsSchema } from './tool-settings.js';\nimport type { SlackToolSettings } from './tool-settings.js';\n\n/** Slack app credentials, read from env ONCE by the deploy entry. */\nexport interface SlackIntegrationConfig {\n /** Slack event transport. Defaults to webhook mode. */\n mode?: 'webhook' | 'socket';\n /** Verifies inbound Slack request signatures. Required in webhook mode. */\n signingSecret?: string;\n /** App-level token used to connect to Slack. Required in socket mode. */\n appToken?: string;\n /** Bot token used to post replies and ephemeral cards. */\n botToken?: string;\n /**\n * OAuth client credentials. Required for account linking: \"Sign in with\n * Slack\" (OIDC) is the only flow that writes a link, so without these the\n * settings surface reports `canConnect: false` and no sender can link.\n */\n clientId?: string;\n clientSecret?: string;\n /**\n * HTTPS origin Slack redirects back to. Slack requires HTTPS, so locally this\n * is the tunnel origin rather than the app's own public URL.\n */\n oidcRedirectBaseUrl?: string;\n /** SPA origin the post-connect redirect returns to. */\n uiOrigin?: string;\n /**\n * Overrides for the Slack channel adapter entry.\n *\n * @example\n * ```ts\n * new SlackIntegration({\n * signingSecret,\n * adapterOptions: {\n * streaming: true,\n * toolDisplay: 'grouped',\n * },\n * });\n * ```\n */\n adapterOptions?: SlackAdapterChannelConfig;\n /**\n * What sessions started from Slack may do with the Slack tools. By default a\n * session can read and post only in its own channel, and can't send DMs.\n *\n * @example\n * ```ts\n * new SlackIntegration({\n * signingSecret,\n * // Any channel the app is in, and DMs to anyone in the workspace.\n * tools: { channels: 'all', directMessages: 'anyone' },\n * });\n * ```\n */\n tools?: Partial<SlackToolSettings>;\n}\n\n/** Slack renders the status inline next to the app name; keep it to one short line. */\nconst MAX_STATUS_LENGTH = 80;\n\n/**\n * Turns a tool's `description` arg (\"Listing the repo root\") into a status\n * line that reads after the app name (\"<App> is listing the repo root…\").\n * Only the first line counts: issue/PR creators carry whole bodies there.\n */\nfunction describeToolCall(args: unknown): string | undefined {\n if (!args || typeof args !== 'object') return undefined;\n const { description } = args as { description?: unknown };\n if (typeof description !== 'string') return undefined;\n const line = description\n .split('\\n')\n .map(part => part.replace(/\\s+/g, ' ').trim())\n .find(Boolean);\n if (!line) return undefined;\n const text = line.length > MAX_STATUS_LENGTH ? `${line.slice(0, MAX_STATUS_LENGTH - 1)}…` : line;\n // Drop the sentence-case capital (\"Listing\" → \"listing\") but leave acronyms\n // and identifiers (\"PR lookup\", \"CI status\") alone.\n return `is ${/^[A-Z][a-z]/.test(text) ? text.charAt(0).toLowerCase() + text.slice(1) : text}`;\n}\n\n/**\n * With reply text hidden, streamed text never reaches the thread, so it gets\n * no status: an \"is typing...\" set after the reply tool's post would sit on\n * the thread with nothing coming, and race the clear at the end of the run.\n */\nconst factoryTypingStatus =\n (textDisplay: SlackAdapterChannelConfig['textDisplay']): TypingStatusFn =>\n chunk => {\n switch (chunk.type) {\n case 'reasoning-delta':\n return 'is thinking...';\n case 'text-delta':\n return textDisplay === 'hidden' ? undefined : 'is typing...';\n // The reply tool's text streams into the thread as the model writes it.\n case 'tool-call-input-streaming-start':\n return chunk.payload.toolName === REPLY_TOOL_NAME ? 'is typing...' : undefined;\n case 'tool-call':\n // Still finishing the streamed reply; don't flip to \"is working...\".\n if (chunk.payload.toolName === REPLY_TOOL_NAME) return 'is typing...';\n return describeToolCall(chunk.payload.args) ?? 'is working...';\n default:\n return undefined;\n }\n};\n\n/**\n * Drops keys the caller set to `undefined` so spreading the overrides cannot\n * erase the Factory defaults they sit on top of.\n */\nfunction adapterOverrides(options: SlackAdapterChannelConfig | undefined): SlackAdapterChannelConfig {\n return Object.fromEntries(\n Object.entries(options ?? {}).filter(([, value]) => value !== undefined),\n ) as SlackAdapterChannelConfig;\n}\n\n/**\n * Factory defaults under the caller's overrides. Tool calls stay out of the\n * thread: a Factory session runs hundreds of them, and a row per call (or a\n * card per call) buries the reply. Progress shows through the typing status\n * instead, which names the tool's current step; the session link carries the\n * full trace. `grouped` remains available via `adapterOptions` for callers\n * who want Slack's \"Thinking Steps\" widget.\n */\nfunction factoryAdapterOptions(overrides: SlackAdapterChannelConfig): SlackAdapterChannelConfig {\n const textDisplay = overrides.textDisplay ?? 'hidden';\n return { typingStatus: factoryTypingStatus(textDisplay), toolDisplay: 'hidden', textDisplay, ...overrides };\n}\n\nexport class SlackIntegration implements FactoryIntegration {\n readonly id = 'slack';\n /**\n * The OIDC connect flow round-trips a signed `state` through Slack, so the\n * replica handling the callback must be able to verify a state a different\n * replica signed.\n */\n readonly requiresStableStateSigner = true;\n\n readonly #config: SlackIntegrationConfig;\n readonly #toolSettings: SlackToolSettings;\n readonly #adapterOptions: SlackAdapterChannelConfig;\n /** Bound in `initialize()`; the controller mounts after integrations are built. */\n #channels: ShareFileToolDeps['channels'];\n readonly #deps: ShareFileToolDeps = { channels: () => this.#channels?.() };\n /**\n * With reply text hidden (the Factory default) the agent speaks through\n * `reply_in_thread`, so the prompt, reminder and live streaming for that\n * tool come with it. The setting is fixed for the deployment, so it is\n * decided once here rather than on every run.\n */\n readonly processors: { input: InputProcessor[]; output: OutputProcessor[] };\n /**\n * Whether `channels()` found a source-control owner on the context and wired\n * repo-backed sessions. Set at the channels() attach path, which runs once at\n * boot before diagnostics are served.\n */\n #repoBackedSessions = false;\n\n constructor(config: SlackIntegrationConfig) {\n const mode = config.mode ?? 'webhook';\n if (mode === 'webhook' && !config.signingSecret) {\n throw new Error(\n \"SlackIntegration: 'signingSecret' is required in webhook mode — Slack cannot verify inbound requests without it.\",\n );\n }\n if (mode === 'socket' && !config.appToken) {\n throw new Error(\"SlackIntegration: 'appToken' is required in socket mode — Slack cannot open a Socket Mode connection without it.\");\n }\n if (mode === 'socket' && !config.botToken) {\n throw new Error(\"SlackIntegration: 'botToken' is required in socket mode — Factory cannot reply without it.\");\n }\n this.#config = config;\n // An explicit `undefined` means \"use the default\", not \"unset it\".\n const granted = Object.fromEntries(Object.entries(config.tools ?? {}).filter(([, value]) => value !== undefined));\n this.#toolSettings = slackToolSettingsSchema.parse({ ...DEFAULT_SLACK_TOOL_SETTINGS, ...granted });\n this.#adapterOptions = factoryAdapterOptions(adapterOverrides(config.adapterOptions));\n const textHidden = this.#textHidden;\n this.processors = {\n input: [\n new FactoryChannelReplyProcessor(),\n ...(textHidden ? [new FactoryReplyReminderProcessor()] : []),\n ],\n output: [\n new FactoryChannelSessionLinkProcessor(),\n ...(textHidden ? [new FactoryReplyStreamProcessor(this.#deps)] : []),\n ],\n };\n }\n\n get #textHidden(): boolean {\n return this.#adapterOptions.textDisplay === 'hidden';\n }\n\n initialize(args: { channels?: () => AgentChannels | null | undefined }): void {\n this.#channels = args.channels;\n }\n\n /**\n * On runs whose session is linked to a Slack thread: `attach_file`,\n * `reply_in_thread` when reply text is hidden, and the Slack read, post,\n * search, lookup and DM tools. The tools find the thread to post into when\n * they are called.\n */\n async agentTools({ requestContext }: { requestContext: RequestContext }): Promise<IntegrationTools> {\n const slackThread = await slackThreadOf(requestContext, this.#deps);\n if (!slackThread) return {};\n const chat = this.#channels?.()?.sdk;\n const sessionThreadId = slackThread.threadId;\n return {\n ...createShareFileTool(requestContext, this.#deps),\n ...(this.#textHidden ? createReplyTool(requestContext, this.#deps) : {}),\n ...(chat && sessionThreadId ? createSlackChatTools({ chat, sessionThreadId, settings: this.#toolSettings }) : {}),\n };\n }\n\n /**\n * When a run opens a pull request, post its link into the session's Slack\n * thread.\n */\n async postToolObserver({\n toolContext,\n requestContext,\n }: Parameters<NonNullable<FactoryIntegration['postToolObserver']>>[0]): Promise<void> {\n const url = parseCreatedPullRequest(toolContext);\n const threadId = (requestContext?.get('controller') as { threadId?: string } | undefined)?.threadId;\n if (!url || !requestContext || !threadId || !(await isSlackThread(requestContext, this.#deps))) return;\n // Not awaited: the tool call must not wait on Slack.\n void announcePullRequest(this.#channels?.(), threadId, 'opened', url).catch(error =>\n console.warn('[slack] pull request opened announcement failed', error),\n );\n }\n\n channels(ctx: IntegrationContext): FactoryChannelsConfig {\n // Repo-backed sessions select the source-control provider from the linked\n // repository on each Factory project.\n const sourceControls =\n ctx.storage.sourceControls ?? (ctx.storage.sourceControlOwner ? [ctx.storage.sourceControlOwner] : []);\n this.#repoBackedSessions = sourceControls.length > 0;\n const mode = this.#config.mode ?? 'webhook';\n return createSlackChannelsConfig({\n slack: {\n mode: this.#config.mode,\n ...(mode === 'webhook'\n ? { clientId: this.#config.clientId, clientSecret: this.#config.clientSecret }\n : {}),\n signingSecret: this.#config.signingSecret,\n appToken: this.#config.appToken,\n botToken: this.#config.botToken,\n },\n accountLinks: ctx.storage.channelIdentity,\n projects: ctx.storage.projects,\n sourceControls,\n modelDefaults: ctx.storage.modelDefaults,\n modelCredentials: ctx.storage.modelCredentials,\n voiceSettings: ctx.storage.voiceSettings,\n workItems: ctx.runtime?.workItems,\n adapterOptions: this.#adapterOptions,\n });\n }\n\n routes(ctx: IntegrationContext): ApiRoute[] {\n const { clientId, clientSecret, oidcRedirectBaseUrl, uiOrigin } = this.#config;\n return createSlackConnectRoutes({\n auth: ctx.auth,\n accountLinks: ctx.storage.channelIdentity,\n tenantStateSigner: ctx.stateSigner,\n oidc:\n clientId && clientSecret && oidcRedirectBaseUrl\n ? { clientId, clientSecret, redirectBaseUrl: oidcRedirectBaseUrl, uiOrigin }\n : undefined,\n projects: ctx.storage.projects,\n });\n }\n\n diagnostics(): Record<string, unknown> {\n const { clientId, clientSecret, botToken, oidcRedirectBaseUrl } = this.#config;\n return {\n configured: true,\n botTokenConfigured: Boolean(botToken),\n oidcConfigured: Boolean(clientId && clientSecret && oidcRedirectBaseUrl),\n repoBackedSessions: this.#repoBackedSessions,\n };\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"integration.js","names":[],"sources":["../../../src/integrations/slack/integration.ts"],"sourcesContent":["/**\n * `SlackIntegration` — Slack as a `FactoryIntegration`.\n *\n * Slack contributes two things to a factory: the chat channels that carry\n * inbound messages into agent runs (`channels()`), and the browser-facing\n * account-link routes that bind a Slack sender to a Mastra tenant (`routes()`).\n * Both used to be assembled by hand in the deploy entry, which had to reach\n * into the prepared agent controller by string key, resolve storage domains\n * itself, mint its own state signer, and splice routes onto the factory's\n * assembled server config. Implementing the integration interface instead means\n * the factory does all of that the same way it already does for GitHub and\n * Linear, and the entry's job shrinks to reading Slack's env vars once.\n *\n * Slack ships as a factory built-in alongside GitHub and Linear (it originally\n * lived in `mastracode/web` to keep `@mastra/slack`/`chat` out of this package;\n * the team reversed that so `create-factory` consumers get Slack channels out\n * of the box). The integration interface remains open — third parties still add\n * capabilities by implementing `FactoryIntegration` from outside the package.\n */\n\nimport type { AgentChannels, TypingStatusFn } from '@mastra/core/channels';\nimport type { InputProcessor, OutputProcessor } from '@mastra/core/processors';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { ApiRoute } from '@mastra/core/server';\nimport type { SlackAdapterChannelConfig } from '@mastra/slack';\n\n\nimport type { FactoryChannelsConfig, FactoryIntegration, IntegrationContext, IntegrationTools } from '../base.js';\nimport { announcePullRequest } from '../channel-thread-announcements.js';\nimport { parseCreatedPullRequest } from '../github/session-subscriptions.js';\nimport { FactoryChannelReplyProcessor } from './channel-reply-processor.js';\nimport { FactoryChannelSessionLinkProcessor } from './channel-session-link-processor.js';\nimport { createSlackChatTools } from './chat-tools.js';\nimport { createSlackConnectRoutes } from './connect-route.js';\nimport { FactoryReplyReminderProcessor } from './reply-reminder-processor.js';\nimport { createReplyTool, FactoryReplyStreamProcessor, REPLY_TOOL_NAME } from './reply-tool.js';\nimport { createShareFileTool, isSlackThread, slackThreadOf } from './share-file-tool.js';\nimport type { ShareFileToolDeps } from './share-file-tool.js';\nimport { createSlackChannelsConfig } from './slack.js';\nimport { DEFAULT_SLACK_TOOL_SETTINGS, slackToolSettingsSchema } from './tool-settings.js';\nimport type { SlackToolSettings } from './tool-settings.js';\n\n/** Slack app credentials, read from env ONCE by the deploy entry. */\nexport interface SlackIntegrationConfig {\n /** Slack event transport. Defaults to webhook mode. */\n mode?: 'webhook' | 'socket';\n /** Verifies inbound Slack request signatures. Required in webhook mode. */\n signingSecret?: string;\n /** App-level token used to connect to Slack. Required in socket mode. */\n appToken?: string;\n /** Bot token used to post replies and ephemeral cards. */\n botToken?: string;\n /**\n * OAuth client credentials. Required for account linking: \"Sign in with\n * Slack\" (OIDC) is the only flow that writes a link, so without these the\n * settings surface reports `canConnect: false` and no sender can link.\n */\n clientId?: string;\n clientSecret?: string;\n /**\n * HTTPS origin Slack redirects back to. Slack requires HTTPS, so locally this\n * is the tunnel origin rather than the app's own public URL.\n */\n oidcRedirectBaseUrl?: string;\n /** SPA origin the post-connect redirect returns to. */\n uiOrigin?: string;\n /**\n * Overrides for the Slack channel adapter entry.\n *\n * @example\n * ```ts\n * new SlackIntegration({\n * signingSecret,\n * adapterOptions: {\n * streaming: true,\n * toolDisplay: 'grouped',\n * },\n * });\n * ```\n */\n adapterOptions?: SlackAdapterChannelConfig;\n /**\n * What sessions started from Slack may do with the Slack tools. By default a\n * session can read and post only in its own channel, and can't send DMs.\n *\n * @example\n * ```ts\n * new SlackIntegration({\n * signingSecret,\n * // Any channel the app is in, and DMs to anyone in the workspace.\n * tools: { channels: 'all', directMessages: 'anyone' },\n * });\n * ```\n */\n tools?: Partial<SlackToolSettings>;\n}\n\n/**\n * Slack renders the status inline next to the app name, and rejects a status\n * (sent as its loading message) of 51 characters or more.\n */\nconst MAX_STATUS_LENGTH = 50;\n\n/**\n * Turns a tool's `description` arg (\"Listing the repo root\") into a status\n * line that reads after the app name (\"<App> is listing the repo root…\").\n * Only the first line counts: issue/PR creators carry whole bodies there.\n */\nfunction describeToolCall(args: unknown): string | undefined {\n if (!args || typeof args !== 'object') return undefined;\n const { description } = args as { description?: unknown };\n if (typeof description !== 'string') return undefined;\n const line = description\n .split('\\n')\n .map(part => part.replace(/\\s+/g, ' ').trim())\n .find(Boolean);\n if (!line) return undefined;\n // Drop the sentence-case capital (\"Listing\" → \"listing\") but leave acronyms\n // and identifiers (\"PR lookup\", \"CI status\") alone.\n const status = `is ${/^[A-Z][a-z]/.test(line) ? line.charAt(0).toLowerCase() + line.slice(1) : line}`;\n return status.length > MAX_STATUS_LENGTH ? `${status.slice(0, MAX_STATUS_LENGTH - 1)}…` : status;\n}\n\n/**\n * With reply text hidden, streamed text never reaches the thread, so it gets\n * no status: an \"is typing...\" set after the reply tool's post would sit on\n * the thread with nothing coming, and race the clear at the end of the run.\n */\nconst factoryTypingStatus =\n (textDisplay: SlackAdapterChannelConfig['textDisplay']): TypingStatusFn =>\n chunk => {\n switch (chunk.type) {\n case 'reasoning-delta':\n return 'is thinking...';\n case 'text-delta':\n return textDisplay === 'hidden' ? undefined : 'is typing...';\n // The reply tool's text streams into the thread as the model writes it.\n case 'tool-call-input-streaming-start':\n return chunk.payload.toolName === REPLY_TOOL_NAME ? 'is typing...' : undefined;\n case 'tool-call':\n // Still finishing the streamed reply; don't flip to \"is working...\".\n if (chunk.payload.toolName === REPLY_TOOL_NAME) return 'is typing...';\n return describeToolCall(chunk.payload.args) ?? 'is working...';\n default:\n return undefined;\n }\n};\n\n/**\n * Drops keys the caller set to `undefined` so spreading the overrides cannot\n * erase the Factory defaults they sit on top of.\n */\nfunction adapterOverrides(options: SlackAdapterChannelConfig | undefined): SlackAdapterChannelConfig {\n return Object.fromEntries(\n Object.entries(options ?? {}).filter(([, value]) => value !== undefined),\n ) as SlackAdapterChannelConfig;\n}\n\n/**\n * Factory defaults under the caller's overrides. Tool calls stay out of the\n * thread: a Factory session runs hundreds of them, and a row per call (or a\n * card per call) buries the reply. Progress shows through the typing status\n * instead, which names the tool's current step; the session link carries the\n * full trace. `grouped` remains available via `adapterOptions` for callers\n * who want Slack's \"Thinking Steps\" widget.\n */\nfunction factoryAdapterOptions(overrides: SlackAdapterChannelConfig): SlackAdapterChannelConfig {\n const textDisplay = overrides.textDisplay ?? 'hidden';\n return { typingStatus: factoryTypingStatus(textDisplay), toolDisplay: 'hidden', textDisplay, ...overrides };\n}\n\nexport class SlackIntegration implements FactoryIntegration {\n readonly id = 'slack';\n /**\n * The OIDC connect flow round-trips a signed `state` through Slack, so the\n * replica handling the callback must be able to verify a state a different\n * replica signed.\n */\n readonly requiresStableStateSigner = true;\n\n readonly #config: SlackIntegrationConfig;\n readonly #toolSettings: SlackToolSettings;\n readonly #adapterOptions: SlackAdapterChannelConfig;\n /** Bound in `initialize()`; the controller mounts after integrations are built. */\n #channels: ShareFileToolDeps['channels'];\n readonly #deps: ShareFileToolDeps = { channels: () => this.#channels?.() };\n /**\n * With reply text hidden (the Factory default) the agent speaks through\n * `reply_in_thread`, so the prompt, reminder and live streaming for that\n * tool come with it. The setting is fixed for the deployment, so it is\n * decided once here rather than on every run.\n */\n readonly processors: { input: InputProcessor[]; output: OutputProcessor[] };\n /**\n * Whether `channels()` found a source-control owner on the context and wired\n * repo-backed sessions. Set at the channels() attach path, which runs once at\n * boot before diagnostics are served.\n */\n #repoBackedSessions = false;\n\n constructor(config: SlackIntegrationConfig) {\n const mode = config.mode ?? 'webhook';\n if (mode === 'webhook' && !config.signingSecret) {\n throw new Error(\n \"SlackIntegration: 'signingSecret' is required in webhook mode — Slack cannot verify inbound requests without it.\",\n );\n }\n if (mode === 'socket' && !config.appToken) {\n throw new Error(\"SlackIntegration: 'appToken' is required in socket mode — Slack cannot open a Socket Mode connection without it.\");\n }\n if (mode === 'socket' && !config.botToken) {\n throw new Error(\"SlackIntegration: 'botToken' is required in socket mode — Factory cannot reply without it.\");\n }\n this.#config = config;\n // An explicit `undefined` means \"use the default\", not \"unset it\".\n const granted = Object.fromEntries(Object.entries(config.tools ?? {}).filter(([, value]) => value !== undefined));\n this.#toolSettings = slackToolSettingsSchema.parse({ ...DEFAULT_SLACK_TOOL_SETTINGS, ...granted });\n this.#adapterOptions = factoryAdapterOptions(adapterOverrides(config.adapterOptions));\n const textHidden = this.#textHidden;\n this.processors = {\n input: [\n new FactoryChannelReplyProcessor(),\n ...(textHidden ? [new FactoryReplyReminderProcessor()] : []),\n ],\n output: [\n new FactoryChannelSessionLinkProcessor(),\n ...(textHidden ? [new FactoryReplyStreamProcessor(this.#deps)] : []),\n ],\n };\n }\n\n get #textHidden(): boolean {\n return this.#adapterOptions.textDisplay === 'hidden';\n }\n\n initialize(args: { channels?: () => AgentChannels | null | undefined }): void {\n this.#channels = args.channels;\n }\n\n /**\n * On runs whose session is linked to a Slack thread: `attach_file`,\n * `reply_in_thread` when reply text is hidden, and the Slack read, post,\n * search, lookup and DM tools. The tools find the thread to post into when\n * they are called.\n */\n async agentTools({ requestContext }: { requestContext: RequestContext }): Promise<IntegrationTools> {\n const slackThread = await slackThreadOf(requestContext, this.#deps);\n if (!slackThread) return {};\n const chat = this.#channels?.()?.sdk;\n const sessionThreadId = slackThread.threadId;\n return {\n ...createShareFileTool(requestContext, this.#deps),\n ...(this.#textHidden ? createReplyTool(requestContext, this.#deps) : {}),\n ...(chat && sessionThreadId ? createSlackChatTools({ chat, sessionThreadId, settings: this.#toolSettings }) : {}),\n };\n }\n\n /**\n * When a run opens a pull request, post its link into the session's Slack\n * thread.\n */\n async postToolObserver({\n toolContext,\n requestContext,\n }: Parameters<NonNullable<FactoryIntegration['postToolObserver']>>[0]): Promise<void> {\n const url = parseCreatedPullRequest(toolContext);\n const threadId = (requestContext?.get('controller') as { threadId?: string } | undefined)?.threadId;\n if (!url || !requestContext || !threadId || !(await isSlackThread(requestContext, this.#deps))) return;\n // Not awaited: the tool call must not wait on Slack.\n void announcePullRequest(this.#channels?.(), threadId, 'opened', url).catch(error =>\n console.warn('[slack] pull request opened announcement failed', error),\n );\n }\n\n channels(ctx: IntegrationContext): FactoryChannelsConfig {\n // Repo-backed sessions select the source-control provider from the linked\n // repository on each Factory project.\n const sourceControls =\n ctx.storage.sourceControls ?? (ctx.storage.sourceControlOwner ? [ctx.storage.sourceControlOwner] : []);\n this.#repoBackedSessions = sourceControls.length > 0;\n const mode = this.#config.mode ?? 'webhook';\n return createSlackChannelsConfig({\n slack: {\n mode: this.#config.mode,\n ...(mode === 'webhook'\n ? { clientId: this.#config.clientId, clientSecret: this.#config.clientSecret }\n : {}),\n signingSecret: this.#config.signingSecret,\n appToken: this.#config.appToken,\n botToken: this.#config.botToken,\n },\n accountLinks: ctx.storage.channelIdentity,\n projects: ctx.storage.projects,\n sourceControls,\n modelDefaults: ctx.storage.modelDefaults,\n modelCredentials: ctx.storage.modelCredentials,\n voiceSettings: ctx.storage.voiceSettings,\n workItems: ctx.runtime?.workItems,\n adapterOptions: this.#adapterOptions,\n });\n }\n\n routes(ctx: IntegrationContext): ApiRoute[] {\n const { clientId, clientSecret, oidcRedirectBaseUrl, uiOrigin } = this.#config;\n return createSlackConnectRoutes({\n auth: ctx.auth,\n accountLinks: ctx.storage.channelIdentity,\n tenantStateSigner: ctx.stateSigner,\n oidc:\n clientId && clientSecret && oidcRedirectBaseUrl\n ? { clientId, clientSecret, redirectBaseUrl: oidcRedirectBaseUrl, uiOrigin }\n : undefined,\n projects: ctx.storage.projects,\n });\n }\n\n diagnostics(): Record<string, unknown> {\n const { clientId, clientSecret, botToken, oidcRedirectBaseUrl } = this.#config;\n return {\n configured: true,\n botTokenConfigured: Boolean(botToken),\n oidcConfigured: Boolean(clientId && clientSecret && oidcRedirectBaseUrl),\n repoBackedSessions: this.#repoBackedSessions,\n };\n }\n}\n"],"mappings":"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"}
|
|
@@ -10,6 +10,12 @@ export interface BoardSnapshot {
|
|
|
10
10
|
* ETag lets the browser revalidate instead of downloading the board again.
|
|
11
11
|
*/
|
|
12
12
|
export declare function boardSnapshot(items: readonly Card[], toWire: (item: Card) => unknown, runningSessionIds: readonly string[], parkedSessionIds: readonly string[]): BoardSnapshot;
|
|
13
|
+
/**
|
|
14
|
+
* The wire body for the cards a scoped listing picked. Its ETag names the cards by a hash of
|
|
15
|
+
* their body, not by the board version: a write to a card outside the scope leaves it unchanged,
|
|
16
|
+
* so the tab gets a 304. A caller that passes the same list again shares its serialization.
|
|
17
|
+
*/
|
|
18
|
+
export declare function scopedSnapshot(items: readonly Card[], toWire: (item: Card) => unknown, runningSessionIds: readonly string[], parkedSessionIds: readonly string[]): BoardSnapshot;
|
|
13
19
|
/** Whether an `If-None-Match` header names this ETag (weak comparison, as for GET). */
|
|
14
20
|
export declare function matchesEtag(ifNoneMatch: string | undefined, etag: string): boolean;
|
|
15
21
|
//# sourceMappingURL=board-snapshot.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"board-snapshot.d.ts","sourceRoot":"","sources":["../../src/routes/board-snapshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAWlE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAC/B,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,aAAa,
|
|
1
|
+
{"version":3,"file":"board-snapshot.d.ts","sourceRoot":"","sources":["../../src/routes/board-snapshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uCAAuC,CAAC;AAWlE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAC/B,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,aAAa,CAGf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAC/B,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,aAAa,CAEf;AAiCD,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIlF"}
|
|
@@ -10,18 +10,29 @@ const cardsJson = /* @__PURE__ */ new WeakMap();
|
|
|
10
10
|
* ETag lets the browser revalidate instead of downloading the board again.
|
|
11
11
|
*/
|
|
12
12
|
function boardSnapshot(items, toWire, runningSessionIds, parkedSessionIds) {
|
|
13
|
+
return snapshot(items, toWire, runningSessionIds, parkedSessionIds, () => randomUUID());
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* The wire body for the cards a scoped listing picked. Its ETag names the cards by a hash of
|
|
17
|
+
* their body, not by the board version: a write to a card outside the scope leaves it unchanged,
|
|
18
|
+
* so the tab gets a 304. A caller that passes the same list again shares its serialization.
|
|
19
|
+
*/
|
|
20
|
+
function scopedSnapshot(items, toWire, runningSessionIds, parkedSessionIds) {
|
|
21
|
+
return snapshot(items, toWire, runningSessionIds, parkedSessionIds, sha1);
|
|
22
|
+
}
|
|
23
|
+
function snapshot(items, toWire, runningSessionIds, parkedSessionIds, cardsId) {
|
|
13
24
|
let cards = cardsJson.get(items);
|
|
14
25
|
if (!cards) {
|
|
26
|
+
const json = JSON.stringify(items.map(toWire));
|
|
15
27
|
cards = {
|
|
16
|
-
id:
|
|
17
|
-
json
|
|
28
|
+
id: cardsId(json),
|
|
29
|
+
json
|
|
18
30
|
};
|
|
19
31
|
cardsJson.set(items, cards);
|
|
20
32
|
}
|
|
21
|
-
const
|
|
22
|
-
const etag = `W/"${cards.id}.${createHash("sha1").update(activity).digest("base64url")}"`;
|
|
33
|
+
const etag = `W/"${cards.id}.${sha1(JSON.stringify([runningSessionIds, parkedSessionIds]))}"`;
|
|
23
34
|
if (cards.latest?.etag === etag) return cards.latest;
|
|
24
|
-
const json =
|
|
35
|
+
const json = listingJson(cards.json, runningSessionIds, parkedSessionIds);
|
|
25
36
|
let gzipped;
|
|
26
37
|
cards.latest = {
|
|
27
38
|
etag,
|
|
@@ -30,12 +41,18 @@ function boardSnapshot(items, toWire, runningSessionIds, parkedSessionIds) {
|
|
|
30
41
|
};
|
|
31
42
|
return cards.latest;
|
|
32
43
|
}
|
|
44
|
+
function sha1(text) {
|
|
45
|
+
return createHash("sha1").update(text).digest("base64url");
|
|
46
|
+
}
|
|
47
|
+
function listingJson(cards, runningSessionIds, parkedSessionIds) {
|
|
48
|
+
return `{"workItems":${cards},"runningSessionIds":${JSON.stringify(runningSessionIds)},"parkedSessionIds":${JSON.stringify(parkedSessionIds)}}`;
|
|
49
|
+
}
|
|
33
50
|
/** Whether an `If-None-Match` header names this ETag (weak comparison, as for GET). */
|
|
34
51
|
function matchesEtag(ifNoneMatch, etag) {
|
|
35
52
|
if (!ifNoneMatch) return false;
|
|
36
53
|
const bare = (tag) => tag.trim().replace(/^W\//, "");
|
|
37
54
|
return ifNoneMatch.split(",").some((tag) => tag.trim() === "*" || bare(tag) === bare(etag));
|
|
38
55
|
}
|
|
39
|
-
export { boardSnapshot, matchesEtag };
|
|
56
|
+
export { boardSnapshot, matchesEtag, scopedSnapshot };
|
|
40
57
|
|
|
41
58
|
//# sourceMappingURL=board-snapshot.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"board-snapshot.js","names":["gzip","gzipCallback"],"sources":["../../src/routes/board-snapshot.ts"],"sourcesContent":["import { createHash, randomUUID } from 'node:crypto';\nimport { promisify } from 'node:util';\nimport { gzip as gzipCallback } from 'node:zlib';\n\nimport type { Card } from '../storage/domains/work-items/base.js';\n\nconst gzip = promisify(gzipCallback);\n\ninterface CardsJson {\n /**
|
|
1
|
+
{"version":3,"file":"board-snapshot.js","names":["gzip","gzipCallback"],"sources":["../../src/routes/board-snapshot.ts"],"sourcesContent":["import { createHash, randomUUID } from 'node:crypto';\nimport { promisify } from 'node:util';\nimport { gzip as gzipCallback } from 'node:zlib';\n\nimport type { Card } from '../storage/domains/work-items/base.js';\n\nconst gzip = promisify(gzipCallback);\n\ninterface CardsJson {\n /** Names the cards in the ETag. */\n id: string;\n json: string;\n latest?: BoardSnapshot;\n}\n\nexport interface BoardSnapshot {\n etag: string;\n json: string;\n gzipped(): Promise<Buffer>;\n}\n\n// Keyed on the list a caller keeps per board version: `listShared` returns one frozen array until\n// a card changes, so a new version or an evicted list drops its entry with it.\nconst cardsJson = new WeakMap<readonly Card[], CardsJson>();\n\n/**\n * The listing's wire body for one board version and its run activity. Every tab\n * polling an unchanged board shares one serialization and one gzip, and its\n * ETag lets the browser revalidate instead of downloading the board again.\n */\nexport function boardSnapshot(\n items: readonly Card[],\n toWire: (item: Card) => unknown,\n runningSessionIds: readonly string[],\n parkedSessionIds: readonly string[],\n): BoardSnapshot {\n // Random per cached list, so an ETag from before a restart never matches a different board.\n return snapshot(items, toWire, runningSessionIds, parkedSessionIds, () => randomUUID());\n}\n\n/**\n * The wire body for the cards a scoped listing picked. Its ETag names the cards by a hash of\n * their body, not by the board version: a write to a card outside the scope leaves it unchanged,\n * so the tab gets a 304. A caller that passes the same list again shares its serialization.\n */\nexport function scopedSnapshot(\n items: readonly Card[],\n toWire: (item: Card) => unknown,\n runningSessionIds: readonly string[],\n parkedSessionIds: readonly string[],\n): BoardSnapshot {\n return snapshot(items, toWire, runningSessionIds, parkedSessionIds, sha1);\n}\n\nfunction snapshot(\n items: readonly Card[],\n toWire: (item: Card) => unknown,\n runningSessionIds: readonly string[],\n parkedSessionIds: readonly string[],\n cardsId: (json: string) => string,\n): BoardSnapshot {\n let cards = cardsJson.get(items);\n if (!cards) {\n const json = JSON.stringify(items.map(toWire));\n cards = { id: cardsId(json), json };\n cardsJson.set(items, cards);\n }\n const etag = `W/\"${cards.id}.${sha1(JSON.stringify([runningSessionIds, parkedSessionIds]))}\"`;\n if (cards.latest?.etag === etag) return cards.latest;\n\n const json = listingJson(cards.json, runningSessionIds, parkedSessionIds);\n let gzipped: Promise<Buffer> | undefined;\n // zlib runs on the libuv pool, off the event loop.\n cards.latest = { etag, json, gzipped: () => (gzipped ??= gzip(json)) };\n return cards.latest;\n}\n\nfunction sha1(text: string): string {\n return createHash('sha1').update(text).digest('base64url');\n}\n\nfunction listingJson(cards: string, runningSessionIds: readonly string[], parkedSessionIds: readonly string[]): string {\n return `{\"workItems\":${cards},\"runningSessionIds\":${JSON.stringify(runningSessionIds)},\"parkedSessionIds\":${JSON.stringify(parkedSessionIds)}}`;\n}\n\n/** Whether an `If-None-Match` header names this ETag (weak comparison, as for GET). */\nexport function matchesEtag(ifNoneMatch: string | undefined, etag: string): boolean {\n if (!ifNoneMatch) return false;\n const bare = (tag: string) => tag.trim().replace(/^W\\//, '');\n return ifNoneMatch.split(',').some(tag => tag.trim() === '*' || bare(tag) === bare(etag));\n}\n"],"mappings":";;;;AAMA,MAAMA,SAAO,UAAUC,IAAY;AAiBnC,MAAM,4BAAY,IAAI,QAAoC;;;;;;AAO1D,SAAgB,cACd,OACA,QACA,mBACA,kBACe;CAEf,OAAO,SAAS,OAAO,QAAQ,mBAAmB,wBAAwB,WAAW,CAAC;AACxF;;;;;;AAOA,SAAgB,eACd,OACA,QACA,mBACA,kBACe;CACf,OAAO,SAAS,OAAO,QAAQ,mBAAmB,kBAAkB,IAAI;AAC1E;AAEA,SAAS,SACP,OACA,QACA,mBACA,kBACA,SACe;CACf,IAAI,QAAQ,UAAU,IAAI,KAAK;CAC/B,IAAI,CAAC,OAAO;EACV,MAAM,OAAO,KAAK,UAAU,MAAM,IAAI,MAAM,CAAC;EAC7C,QAAQ;GAAE,IAAI,QAAQ,IAAI;GAAG;EAAK;EAClC,UAAU,IAAI,OAAO,KAAK;CAC5B;CACA,MAAM,OAAO,MAAM,MAAM,GAAG,GAAG,KAAK,KAAK,UAAU,CAAC,mBAAmB,gBAAgB,CAAC,CAAC,EAAE;CAC3F,IAAI,MAAM,QAAQ,SAAS,MAAM,OAAO,MAAM;CAE9C,MAAM,OAAO,YAAY,MAAM,MAAM,mBAAmB,gBAAgB;CACxE,IAAI;CAEJ,MAAM,SAAS;EAAE;EAAM;EAAM,eAAgB,YAAYD,OAAK,IAAI;CAAG;CACrE,OAAO,MAAM;AACf;AAEA,SAAS,KAAK,MAAsB;CAClC,OAAO,WAAW,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,WAAW;AAC3D;AAEA,SAAS,YAAY,OAAe,mBAAsC,kBAA6C;CACrH,OAAO,gBAAgB,MAAM,uBAAuB,KAAK,UAAU,iBAAiB,EAAE,sBAAsB,KAAK,UAAU,gBAAgB,EAAE;AAC/I;;AAGA,SAAgB,YAAY,aAAiC,MAAuB;CAClF,IAAI,CAAC,aAAa,OAAO;CACzB,MAAM,QAAQ,QAAgB,IAAI,KAAK,CAAC,CAAC,QAAQ,QAAQ,EAAE;CAC3D,OAAO,YAAY,MAAM,GAAG,CAAC,CAAC,MAAK,QAAO,IAAI,KAAK,MAAM,OAAO,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC;AAC1F"}
|
|
@@ -1570,6 +1570,12 @@ export declare const FACTORY_ROUTE_CONTRACTS: {
|
|
|
1570
1570
|
readonly pathSchema: z.ZodObject<{
|
|
1571
1571
|
id: z.ZodString;
|
|
1572
1572
|
}, z.core.$strip>;
|
|
1573
|
+
readonly querySchema: z.ZodObject<{
|
|
1574
|
+
sessionId: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
1575
|
+
scope: z.ZodOptional<z.ZodEnum<{
|
|
1576
|
+
sessions: "sessions";
|
|
1577
|
+
}>>;
|
|
1578
|
+
}, z.core.$strip>;
|
|
1573
1579
|
readonly responseSchema: z.ZodObject<{
|
|
1574
1580
|
workItems: z.ZodArray<z.ZodObject<{
|
|
1575
1581
|
workItem: z.ZodOptional<z.ZodObject<{
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/routes/contracts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,eAAe,EAA4B,CAAC,oBAAoB,EAAE,GAAG,oBAAoB,EAAE,CAAC,CAAC;AAE1G,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,YAAY,kFAAkF,CAAC;AA8B5G,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB;;iBAAsD,CAAC;AACxF,kGAAkG;AAClG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAgF,CAAC;AACpH,eAAO,MAAM,sBAAsB;;iBAAiE,CAAC;AAgErG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;kBAQxB,CAAC;AACZ,sGAAsG;AACtG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;kBAY/B,CAAC;AACL,eAAO,MAAM,4BAA4B;;kBAS9B,CAAC;AA+BZ;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAYtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAsBhF,eAAO,MAAM,uBAAuB;;;;;;;;iBAIlC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;iBAgBoE,CAAC;AAkBzG,qHAAqH;AACrH,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAOnC,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,8BAA8B;;;;;;;;;;;iBASzC,CAAC;AAEH,qGAAqG;AACrG,eAAO,MAAM,0BAA0B;;;iBAAwE,CAAC;AAEhH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAIvD,CAAC;AACF,eAAO,MAAM,4BAA4B,QAAY,CAAC;AACtD,eAAO,MAAM,oBAAoB,aAQsD,CAAC;AACxF,eAAO,MAAM,yBAAyB;;;;EAAuC,CAAC;AAE9E,eAAO,MAAM,uBAAuB;;;;;;;iBAOlC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;;;iBAAqD,CAAC;AAe7F,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAa3C,CAAC;AAIH,eAAO,MAAM,mCAAmC;;;;;;;;;;iBAK9C,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBAQjC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;iBAAwD,CAAC;AACrG,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;iBAA8C,CAAC;AAY1F,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;iBAmD6D,CAAC;
|
|
1
|
+
{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/routes/contracts.ts"],"names":[],"mappings":"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"}
|
package/dist/routes/contracts.js
CHANGED
|
@@ -380,6 +380,16 @@ const sessionSchema = z.object({
|
|
|
380
380
|
branch: z.string().min(1).max(512),
|
|
381
381
|
threadId: z.string().min(1).max(512)
|
|
382
382
|
});
|
|
383
|
+
/** Without `sessionId` or `scope`, the list is the whole board. */
|
|
384
|
+
const workItemListQuerySchema = z.object({
|
|
385
|
+
/** Repeatable. Narrows the list to the cards that hold these sessions and the cards related to them. */
|
|
386
|
+
sessionId: z.array(sessionSchema.shape.sessionId).optional(),
|
|
387
|
+
/** `sessions` narrows the list to the cards that hold any session and the cards related to them. */
|
|
388
|
+
scope: z.enum(["sessions"]).optional()
|
|
389
|
+
}).refine((query) => !(query.scope && query.sessionId), {
|
|
390
|
+
path: ["scope"],
|
|
391
|
+
message: "Send scope or sessionId, not both"
|
|
392
|
+
});
|
|
383
393
|
const sessionsSchema = z.record(z.string().min(1).max(64), sessionSchema);
|
|
384
394
|
const metadataSchema = z.union([z.record(z.string(), z.unknown()), z.null()]).refine((value) => {
|
|
385
395
|
try {
|
|
@@ -890,6 +900,7 @@ const FACTORY_ROUTE_CONTRACTS = {
|
|
|
890
900
|
path: "/web/factory/projects/:id/work-items",
|
|
891
901
|
description: "List Factory work items and running sessions",
|
|
892
902
|
pathSchema: projectPathSchema,
|
|
903
|
+
querySchema: workItemListQuerySchema,
|
|
893
904
|
responseSchema: z.object({
|
|
894
905
|
workItems: z.array(cardSchema),
|
|
895
906
|
runningSessionIds: z.array(z.string()),
|