crewly 1.20.179 → 1.20.181

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.
Files changed (166) hide show
  1. package/config/roles/team-leader/prompt.md +2 -2
  2. package/config/roles/team-leader/tl-addon.md +2 -2
  3. package/config/skills/agent/core/ask-owner/SKILL.md +79 -0
  4. package/config/skills/agent/core/ask-owner/execute.sh +66 -0
  5. package/config/skills/agent/core/ask-owner/execute.test.sh +62 -0
  6. package/config/skills/agent/core/project-tickets/SKILL.md +21 -9
  7. package/config/skills/agent/core/project-tickets/execute.sh +28 -9
  8. package/config/skills/agent/core/project-tickets/execute.test.sh +12 -4
  9. package/config/skills/agent/core/reply/SKILL.md +22 -5
  10. package/config/skills/agent/core/reply/execute.sh +12 -5
  11. package/config/skills/agent/core/reply/execute.test.sh +8 -0
  12. package/config/skills/agent/core/schedule-followup/SKILL.md +8 -0
  13. package/config/skills/agent/core/schedule-followup/execute.sh +7 -0
  14. package/config/skills/agent/remote-browser/SKILL.md +28 -8
  15. package/config/slack-app-manifest.json +5 -1
  16. package/config/slack-master-app-manifest.json +7 -2
  17. package/dist/backend/backend/src/constants.d.ts +99 -5
  18. package/dist/backend/backend/src/constants.d.ts.map +1 -1
  19. package/dist/backend/backend/src/constants.js +106 -5
  20. package/dist/backend/backend/src/constants.js.map +1 -1
  21. package/dist/backend/backend/src/controllers/browser/browser.controller.d.ts +2 -1
  22. package/dist/backend/backend/src/controllers/browser/browser.controller.d.ts.map +1 -1
  23. package/dist/backend/backend/src/controllers/browser/browser.controller.js +15 -1
  24. package/dist/backend/backend/src/controllers/browser/browser.controller.js.map +1 -1
  25. package/dist/backend/backend/src/controllers/chat/agent-reply.controller.d.ts +3 -0
  26. package/dist/backend/backend/src/controllers/chat/agent-reply.controller.d.ts.map +1 -1
  27. package/dist/backend/backend/src/controllers/chat/agent-reply.controller.js +54 -1
  28. package/dist/backend/backend/src/controllers/chat/agent-reply.controller.js.map +1 -1
  29. package/dist/backend/backend/src/controllers/decisions/decisions.controller.d.ts +67 -0
  30. package/dist/backend/backend/src/controllers/decisions/decisions.controller.d.ts.map +1 -0
  31. package/dist/backend/backend/src/controllers/decisions/decisions.controller.js +215 -0
  32. package/dist/backend/backend/src/controllers/decisions/decisions.controller.js.map +1 -0
  33. package/dist/backend/backend/src/controllers/project-tickets/project-tickets.controller.d.ts +8 -5
  34. package/dist/backend/backend/src/controllers/project-tickets/project-tickets.controller.d.ts.map +1 -1
  35. package/dist/backend/backend/src/controllers/project-tickets/project-tickets.controller.js +51 -12
  36. package/dist/backend/backend/src/controllers/project-tickets/project-tickets.controller.js.map +1 -1
  37. package/dist/backend/backend/src/index.d.ts +4 -0
  38. package/dist/backend/backend/src/index.d.ts.map +1 -1
  39. package/dist/backend/backend/src/index.js +135 -2
  40. package/dist/backend/backend/src/index.js.map +1 -1
  41. package/dist/backend/backend/src/routes/api.routes.d.ts.map +1 -1
  42. package/dist/backend/backend/src/routes/api.routes.js +6 -0
  43. package/dist/backend/backend/src/routes/api.routes.js.map +1 -1
  44. package/dist/backend/backend/src/services/boot/boot-announce.service.d.ts +1 -1
  45. package/dist/backend/backend/src/services/boot/boot-announce.service.js +13 -13
  46. package/dist/backend/backend/src/services/boot/boot-announce.service.js.map +1 -1
  47. package/dist/backend/backend/src/services/browser/browser-approval.service.d.ts +202 -0
  48. package/dist/backend/backend/src/services/browser/browser-approval.service.d.ts.map +1 -0
  49. package/dist/backend/backend/src/services/browser/browser-approval.service.js +533 -0
  50. package/dist/backend/backend/src/services/browser/browser-approval.service.js.map +1 -0
  51. package/dist/backend/backend/src/services/browser/browser-bridge.service.d.ts +24 -0
  52. package/dist/backend/backend/src/services/browser/browser-bridge.service.d.ts.map +1 -1
  53. package/dist/backend/backend/src/services/browser/browser-bridge.service.js +55 -0
  54. package/dist/backend/backend/src/services/browser/browser-bridge.service.js.map +1 -1
  55. package/dist/backend/backend/src/services/browser/browser-session.service.d.ts +51 -0
  56. package/dist/backend/backend/src/services/browser/browser-session.service.d.ts.map +1 -1
  57. package/dist/backend/backend/src/services/browser/browser-session.service.js +82 -3
  58. package/dist/backend/backend/src/services/browser/browser-session.service.js.map +1 -1
  59. package/dist/backend/backend/src/services/browser/held-action-store.d.ts +125 -0
  60. package/dist/backend/backend/src/services/browser/held-action-store.d.ts.map +1 -0
  61. package/dist/backend/backend/src/services/browser/held-action-store.js +141 -0
  62. package/dist/backend/backend/src/services/browser/held-action-store.js.map +1 -0
  63. package/dist/backend/backend/src/services/cloud/cloud-disconnect-notice.service.js +6 -6
  64. package/dist/backend/backend/src/services/cloud/cloud-disconnect-notice.service.js.map +1 -1
  65. package/dist/backend/backend/src/services/cloud/cloud-disconnect-notice.utils.d.ts +3 -3
  66. package/dist/backend/backend/src/services/cloud/cloud-disconnect-notice.utils.d.ts.map +1 -1
  67. package/dist/backend/backend/src/services/cloud/cloud-disconnect-notice.utils.js +14 -13
  68. package/dist/backend/backend/src/services/cloud/cloud-disconnect-notice.utils.js.map +1 -1
  69. package/dist/backend/backend/src/services/decisions/decision-card.d.ts +155 -0
  70. package/dist/backend/backend/src/services/decisions/decision-card.d.ts.map +1 -0
  71. package/dist/backend/backend/src/services/decisions/decision-card.js +337 -0
  72. package/dist/backend/backend/src/services/decisions/decision-card.js.map +1 -0
  73. package/dist/backend/backend/src/services/decisions/decision-contract.d.ts +83 -0
  74. package/dist/backend/backend/src/services/decisions/decision-contract.d.ts.map +1 -0
  75. package/dist/backend/backend/src/services/decisions/decision-contract.js +226 -0
  76. package/dist/backend/backend/src/services/decisions/decision-contract.js.map +1 -0
  77. package/dist/backend/backend/src/services/decisions/decision-routing.d.ts +34 -0
  78. package/dist/backend/backend/src/services/decisions/decision-routing.d.ts.map +1 -0
  79. package/dist/backend/backend/src/services/decisions/decision-routing.js +64 -0
  80. package/dist/backend/backend/src/services/decisions/decision-routing.js.map +1 -0
  81. package/dist/backend/backend/src/services/decisions/decision-store.d.ts +80 -0
  82. package/dist/backend/backend/src/services/decisions/decision-store.d.ts.map +1 -0
  83. package/dist/backend/backend/src/services/decisions/decision-store.js +151 -0
  84. package/dist/backend/backend/src/services/decisions/decision-store.js.map +1 -0
  85. package/dist/backend/backend/src/services/decisions/decision.service.d.ts +338 -0
  86. package/dist/backend/backend/src/services/decisions/decision.service.d.ts.map +1 -0
  87. package/dist/backend/backend/src/services/decisions/decision.service.js +729 -0
  88. package/dist/backend/backend/src/services/decisions/decision.service.js.map +1 -0
  89. package/dist/backend/backend/src/services/decisions/decision.wiring.d.ts +70 -0
  90. package/dist/backend/backend/src/services/decisions/decision.wiring.d.ts.map +1 -0
  91. package/dist/backend/backend/src/services/decisions/decision.wiring.js +172 -0
  92. package/dist/backend/backend/src/services/decisions/decision.wiring.js.map +1 -0
  93. package/dist/backend/backend/src/services/decisions/ticket-thread-store.d.ts +97 -0
  94. package/dist/backend/backend/src/services/decisions/ticket-thread-store.d.ts.map +1 -0
  95. package/dist/backend/backend/src/services/decisions/ticket-thread-store.js +137 -0
  96. package/dist/backend/backend/src/services/decisions/ticket-thread-store.js.map +1 -0
  97. package/dist/backend/backend/src/services/orc/work-item-destination.d.ts +165 -0
  98. package/dist/backend/backend/src/services/orc/work-item-destination.d.ts.map +1 -0
  99. package/dist/backend/backend/src/services/orc/work-item-destination.js +239 -0
  100. package/dist/backend/backend/src/services/orc/work-item-destination.js.map +1 -0
  101. package/dist/backend/backend/src/services/orc/work-item-destination.wiring.d.ts +134 -0
  102. package/dist/backend/backend/src/services/orc/work-item-destination.wiring.d.ts.map +1 -0
  103. package/dist/backend/backend/src/services/orc/work-item-destination.wiring.js +217 -0
  104. package/dist/backend/backend/src/services/orc/work-item-destination.wiring.js.map +1 -0
  105. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-decision.d.ts +1 -30
  106. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-decision.d.ts.map +1 -1
  107. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-decision.js +1 -22
  108. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-decision.js.map +1 -1
  109. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-messages.d.ts +2 -15
  110. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-messages.d.ts.map +1 -1
  111. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-messages.js +8 -22
  112. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot-messages.js.map +1 -1
  113. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot.service.d.ts +11 -12
  114. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot.service.d.ts.map +1 -1
  115. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot.service.js +27 -52
  116. package/dist/backend/backend/src/services/project-tickets/ticket-autopilot.service.js.map +1 -1
  117. package/dist/backend/backend/src/services/slack/slack-agent-post.service.d.ts +6 -0
  118. package/dist/backend/backend/src/services/slack/slack-agent-post.service.d.ts.map +1 -1
  119. package/dist/backend/backend/src/services/slack/slack-agent-post.service.js +3 -1
  120. package/dist/backend/backend/src/services/slack/slack-agent-post.service.js.map +1 -1
  121. package/dist/backend/backend/src/services/slack/slack-team-channel.service.js +12 -12
  122. package/dist/backend/backend/src/services/slack/slack-team-channel.service.js.map +1 -1
  123. package/dist/backend/backend/src/services/slack/slack.service.d.ts +16 -1
  124. package/dist/backend/backend/src/services/slack/slack.service.d.ts.map +1 -1
  125. package/dist/backend/backend/src/services/slack/slack.service.js +56 -2
  126. package/dist/backend/backend/src/services/slack/slack.service.js.map +1 -1
  127. package/dist/backend/backend/src/services/system/auto-update.service.js +2 -2
  128. package/dist/backend/backend/src/services/system/auto-update.service.js.map +1 -1
  129. package/dist/backend/backend/src/services/system/auto-update.utils.js +2 -2
  130. package/dist/backend/backend/src/services/system/auto-update.utils.js.map +1 -1
  131. package/dist/backend/backend/src/types/decision.types.d.ts +168 -0
  132. package/dist/backend/backend/src/types/decision.types.d.ts.map +1 -0
  133. package/dist/backend/backend/src/types/decision.types.js +13 -0
  134. package/dist/backend/backend/src/types/decision.types.js.map +1 -0
  135. package/dist/backend/backend/src/types/slack.types.d.ts +30 -0
  136. package/dist/backend/backend/src/types/slack.types.d.ts.map +1 -1
  137. package/dist/backend/backend/src/types/slack.types.js.map +1 -1
  138. package/dist/backend/backend/src/types/v2/trigger.types.d.ts +17 -0
  139. package/dist/backend/backend/src/types/v2/trigger.types.d.ts.map +1 -1
  140. package/dist/backend/backend/src/types/v2/trigger.types.js +17 -0
  141. package/dist/backend/backend/src/types/v2/trigger.types.js.map +1 -1
  142. package/dist/backend/build-info.json +2 -2
  143. package/dist/cli/backend/src/constants.d.ts +99 -5
  144. package/dist/cli/backend/src/constants.d.ts.map +1 -1
  145. package/dist/cli/backend/src/constants.js +106 -5
  146. package/dist/cli/backend/src/constants.js.map +1 -1
  147. package/dist/cli/backend/src/services/slack/slack-team-channel.service.js +12 -12
  148. package/dist/cli/backend/src/services/slack/slack-team-channel.service.js.map +1 -1
  149. package/dist/cli/backend/src/services/slack/slack.service.d.ts +16 -1
  150. package/dist/cli/backend/src/services/slack/slack.service.d.ts.map +1 -1
  151. package/dist/cli/backend/src/services/slack/slack.service.js +56 -2
  152. package/dist/cli/backend/src/services/slack/slack.service.js.map +1 -1
  153. package/dist/cli/backend/src/services/system/auto-update.utils.js +2 -2
  154. package/dist/cli/backend/src/services/system/auto-update.utils.js.map +1 -1
  155. package/dist/cli/backend/src/types/slack.types.d.ts +30 -0
  156. package/dist/cli/backend/src/types/slack.types.d.ts.map +1 -1
  157. package/dist/cli/backend/src/types/slack.types.js.map +1 -1
  158. package/dist/cli/backend/src/types/v2/trigger.types.d.ts +17 -0
  159. package/dist/cli/backend/src/types/v2/trigger.types.d.ts.map +1 -1
  160. package/dist/cli/backend/src/types/v2/trigger.types.js +17 -0
  161. package/dist/cli/backend/src/types/v2/trigger.types.js.map +1 -1
  162. package/frontend/dist/assets/index-04d192f8.css +42 -0
  163. package/frontend/dist/assets/{index-69af46c3.js → index-4271e95e.js} +259 -259
  164. package/frontend/dist/index.html +2 -2
  165. package/package.json +1 -1
  166. package/frontend/dist/assets/index-cdc52122.css +0 -42
@@ -0,0 +1,338 @@
1
+ /**
2
+ * Decision cards (specs/2026-10-01-decision-cards.md).
3
+ *
4
+ * The responsible agent asks the owner ONE structured question; its own
5
+ * Slack bot posts a Block Kit card in the team channel (the ticket's thread,
6
+ * or a new thread), and the owner answers with a button, a reaction, a
7
+ * thread reply or the dashboard. The answer updates the card in place, goes
8
+ * into the ticket log, is delivered to the asking agent and clears the
9
+ * owner-message watchdog for that thread. At the deadline the default is
10
+ * applied — except for sensitive asks, which are re-asked once and parked.
11
+ *
12
+ * Every collaborator is injected ({@link DecisionServiceDeps}); the wiring
13
+ * with the real Slack / tickets / agents lives in `decision.wiring.ts`.
14
+ *
15
+ * @module services/decisions/decision.service
16
+ */
17
+ import { type ComponentLogger } from '../core/logger.service.js';
18
+ import type { SlackBlock, SlackIncomingMessage, SlackOutgoingMessage } from '../../types/slack.types.js';
19
+ import type { AskOwnerInput, DecisionKind, DecisionOption, DecisionSensitiveKind, OwnerDecision } from '../../types/decision.types.js';
20
+ import { formatWhen } from './decision-card.js';
21
+ import { DecisionStore } from './decision-store.js';
22
+ import type { TicketThreadStore } from './ticket-thread-store.js';
23
+ /** Thrown for requests the caller must fix (HTTP 4xx). */
24
+ export declare class DecisionError extends Error {
25
+ readonly status: number;
26
+ constructor(status: number, message: string);
27
+ }
28
+ /** The slice of SlackService used here. */
29
+ export interface DecisionSlackApi {
30
+ isConnected(): boolean;
31
+ sendMessage(message: SlackOutgoingMessage): Promise<string>;
32
+ updateMessage(channelId: string, messageTs: string, text: string, blocks?: SlackBlock[], botToken?: string): Promise<void>;
33
+ }
34
+ /** How an agent posts: its own bot token, else the shared bot with its name/icon. */
35
+ export interface DecisionPostIdentity {
36
+ botToken?: string;
37
+ username?: string;
38
+ iconEmoji?: string;
39
+ iconUrl?: string;
40
+ }
41
+ /** A ticket the question is about, resolved by the wiring. */
42
+ export interface DecisionTicketContext {
43
+ projectId: string;
44
+ projectPath: string;
45
+ projectName?: string;
46
+ id: string;
47
+ title: string;
48
+ /** Session that owns the question: the assignee, else the team's lead */
49
+ asker: string;
50
+ /** Team whose channel carries the card */
51
+ teamId?: string;
52
+ }
53
+ /** A Slack place to post into. */
54
+ export interface DecisionSlackPlace {
55
+ slackChannelId: string;
56
+ threadTs?: string;
57
+ teamId?: string;
58
+ }
59
+ /** Collaborators. */
60
+ export interface DecisionServiceDeps {
61
+ store: DecisionStore;
62
+ threads: TicketThreadStore;
63
+ slack: () => DecisionSlackApi | null;
64
+ /** This instance (button values carry it; Cloud routes clicks by it) */
65
+ instanceId: () => string;
66
+ /** Whether a Slack user may answer (the owner) */
67
+ isOwner: (slackUserId: string) => boolean;
68
+ /** The owner's Slack user id, for mentions in reminders */
69
+ ownerUserId?: () => string | null;
70
+ /** Display name of a Slack user ("Steve") */
71
+ userName?: (slackUserId: string) => Promise<string | undefined>;
72
+ /** How an agent posts */
73
+ identityOf: (session: string) => Promise<DecisionPostIdentity>;
74
+ /** Slack channel of a team */
75
+ teamChannelOf: (teamId: string) => Promise<string | null>;
76
+ /** The team an agent belongs to */
77
+ teamOf: (session: string) => Promise<string | undefined>;
78
+ /** Resolve a ticket ask (access-checked); throws DecisionError */
79
+ resolveTicket: (project: string, ticketId: string, callerSession: string | undefined) => Promise<DecisionTicketContext>;
80
+ /** Mark the ticket as waiting on the owner (label + log line) */
81
+ markTicketAsked: (ctx: DecisionTicketContext, question: string, decisionId: string) => Promise<void>;
82
+ /** Append a ticket log line; `clearNeedsOwner` removes the needs-owner label */
83
+ logTicket: (ticket: NonNullable<OwnerDecision['ticket']>, line: string, clearNeedsOwner: boolean) => Promise<void>;
84
+ /** The Slack destination of the agent's current work, when it is a Slack place */
85
+ workDestination?: (session: string) => Promise<DecisionSlackPlace | null>;
86
+ /** The work item the agent is on */
87
+ currentWorkItemId?: (session: string) => Promise<string | undefined>;
88
+ /** Deliver a message to an agent (wakes a stopped one); false when it could not */
89
+ deliverToAgent: (session: string, text: string) => Promise<boolean>;
90
+ /** Close the owner-message watchdog entries this agent owes in the thread */
91
+ closeWatchdog?: (session: string, slackChannelId: string, threadTs: string) => void;
92
+ now?: () => Date;
93
+ logger?: ComponentLogger;
94
+ }
95
+ /** What a Slack interaction did. */
96
+ export interface InteractionOutcome {
97
+ handled: boolean;
98
+ reason: string;
99
+ decision?: OwnerDecision;
100
+ }
101
+ /** A Slack `block_actions` payload (the fields used). */
102
+ export interface BlockActionsPayload {
103
+ type?: string;
104
+ user?: {
105
+ id?: string;
106
+ name?: string;
107
+ username?: string;
108
+ };
109
+ actions?: Array<{
110
+ action_id?: string;
111
+ value?: string;
112
+ action_ts?: string;
113
+ }>;
114
+ container?: {
115
+ channel_id?: string;
116
+ message_ts?: string;
117
+ thread_ts?: string;
118
+ };
119
+ channel?: {
120
+ id?: string;
121
+ };
122
+ message?: {
123
+ ts?: string;
124
+ thread_ts?: string;
125
+ };
126
+ }
127
+ /** A `reaction_added` event (the fields used). */
128
+ export interface ReactionEvent {
129
+ user?: string;
130
+ reaction?: string;
131
+ item?: {
132
+ type?: string;
133
+ channel?: string;
134
+ ts?: string;
135
+ };
136
+ }
137
+ /**
138
+ * Acts on the outcome of a decision Crewly asked itself ({@link DecisionKind}).
139
+ */
140
+ export interface DecisionKindHandler {
141
+ /**
142
+ * Called once when such a decision settles (resolved, defaulted at the
143
+ * deadline, cancelled or expired). Does the kind's work (e.g. lets a held
144
+ * browser click through) and returns the note for the asking agent, which
145
+ * replaces the generic `[DECISION]` note; null sends nothing.
146
+ *
147
+ * @param decision - The settled decision
148
+ * @returns Note for the asker, or null
149
+ */
150
+ onSettled(decision: OwnerDecision): Promise<string | null>;
151
+ }
152
+ /** A question Crewly builds itself (no ask-owner contract parsing). */
153
+ export interface PrebuiltAsk {
154
+ kind: DecisionKind;
155
+ /** Agent the question is about — its bot posts the card and it gets the answer */
156
+ asker: string;
157
+ question: string;
158
+ options: DecisionOption[];
159
+ defaultKey: string;
160
+ yesKey?: string;
161
+ deadline: Date;
162
+ sensitive?: DecisionSensitiveKind;
163
+ browser?: OwnerDecision['browser'];
164
+ }
165
+ /**
166
+ * Decision cards service.
167
+ */
168
+ export declare class DecisionService {
169
+ private static instance;
170
+ private readonly deps;
171
+ private readonly logger;
172
+ private readonly now;
173
+ private timer;
174
+ private ticking;
175
+ /**
176
+ * @param deps - Collaborators
177
+ */
178
+ constructor(deps: DecisionServiceDeps);
179
+ /** @returns The process-wide instance, or null before wiring */
180
+ static getInstance(): DecisionService | null;
181
+ /** @param service - Instance to install (null clears) */
182
+ static setInstance(service: DecisionService | null): void;
183
+ /**
184
+ * Register the handler of a decision kind.
185
+ *
186
+ * @param kind - Decision kind
187
+ * @param handler - Handler (null removes it)
188
+ */
189
+ static registerKindHandler(kind: DecisionKind, handler: DecisionKindHandler | null): void;
190
+ /** Start the deadline / reminder tick. */
191
+ start(): void;
192
+ /** Stop the tick. */
193
+ stop(): void;
194
+ /**
195
+ * Ask the owner. Validates the contract, stores the decision and posts the
196
+ * card as the responsible agent's own bot.
197
+ *
198
+ * @param callerSession - Agent calling ask-owner (undefined = owner / dashboard)
199
+ * @param input - The ask
200
+ * @returns The stored decision (with `card`, or `postError` when Slack refused; retried on the tick)
201
+ * @throws DecisionError(400) for a contract violation, other 4xx from ticket resolution
202
+ */
203
+ ask(callerSession: string | undefined, input: AskOwnerInput): Promise<OwnerDecision>;
204
+ /**
205
+ * Ask a question Crewly built itself (e.g. a held browser action). The card
206
+ * goes where an ask-owner card without a ticket goes: the thread of the
207
+ * agent's current work item, else its team channel — from its own bot.
208
+ *
209
+ * @param ask - The prebuilt question
210
+ * @returns The stored decision (with `card`, or `postError`; retried on the tick)
211
+ */
212
+ askPrebuilt(ask: PrebuiltAsk): Promise<OwnerDecision>;
213
+ /**
214
+ * Mark an open decision as expired: what it asked about is gone. The card
215
+ * says so, and the kind's handler tells the agent.
216
+ *
217
+ * @param id - Decision id
218
+ * @returns The expired decision, or null when it was not pending
219
+ */
220
+ expire(id: string): Promise<OwnerDecision | null>;
221
+ /**
222
+ * Post (or re-try posting) the card of an open decision.
223
+ *
224
+ * @param decision - Decision without a card
225
+ * @returns The decision with `card` or `postError`
226
+ */
227
+ postCard(decision: OwnerDecision): Promise<OwnerDecision>;
228
+ /**
229
+ * Where the card goes: the ticket's thread (created on first use), else the
230
+ * asker's current work destination, else a new thread in its team channel.
231
+ */
232
+ private placeFor;
233
+ /**
234
+ * Send as the agent's own bot; when Slack refuses that bot (not in the
235
+ * channel, revoked), fall back to the shared bot with the agent's name.
236
+ */
237
+ private send;
238
+ /**
239
+ * A Slack `block_actions` payload (Cloud relay, Socket Mode or the HTTP
240
+ * endpoint). Ignores anything that is not one of this instance's cards.
241
+ *
242
+ * @param payload - Slack payload
243
+ * @returns What happened
244
+ */
245
+ handleInteraction(payload: BlockActionsPayload): Promise<InteractionOutcome>;
246
+ /**
247
+ * A reaction on a card: ✅ default/first, ❌ the "no" option, ⏰ remind.
248
+ *
249
+ * @param event - `reaction_added` event
250
+ * @returns What happened
251
+ */
252
+ handleReaction(event: ReactionEvent): Promise<InteractionOutcome>;
253
+ /**
254
+ * An owner reply in a card's thread. The newest open card in that thread
255
+ * takes it; words that match no option are passed to the asker verbatim.
256
+ *
257
+ * @param message - Inbound Slack message
258
+ * @returns What happened
259
+ */
260
+ handleThreadReply(message: Pick<SlackIncomingMessage, 'channelId' | 'threadTs' | 'ts' | 'text' | 'userId' | 'authorAgentSession'>): Promise<InteractionOutcome>;
261
+ /**
262
+ * The owner answered from the dashboard.
263
+ *
264
+ * @param id - Decision id
265
+ * @param optionKey - Option key (or label / number)
266
+ * @returns The resolved decision
267
+ * @throws DecisionError(404/409/400)
268
+ */
269
+ chooseFromDashboard(id: string, optionKey: string): Promise<OwnerDecision>;
270
+ /**
271
+ * "Remind me tomorrow" from the dashboard.
272
+ *
273
+ * @param id - Decision id
274
+ * @returns The snoozed decision
275
+ */
276
+ remindFromDashboard(id: string): Promise<OwnerDecision>;
277
+ /**
278
+ * Withdraw open decisions (the asker no longer needs an answer, or the
279
+ * ticket's mark was cleared).
280
+ *
281
+ * @param filter - Which decisions
282
+ * @param note - Why (ticket log)
283
+ * @returns How many were withdrawn
284
+ */
285
+ cancelWhere(filter: (d: OwnerDecision) => boolean, note?: string): Promise<number>;
286
+ /**
287
+ * List decisions.
288
+ *
289
+ * @param which - `open` (open + parked) or `all`
290
+ * @returns Decisions, newest first
291
+ */
292
+ list(which?: 'open' | 'all'): Promise<OwnerDecision[]>;
293
+ /**
294
+ * One decision.
295
+ *
296
+ * @param id - Decision id
297
+ * @returns Decision or null
298
+ */
299
+ get(id: string): Promise<OwnerDecision | null>;
300
+ private requirePending;
301
+ /**
302
+ * Apply a choice: resolve (or snooze), update the card, log the ticket,
303
+ * tell the asker, close the watchdog entry.
304
+ */
305
+ private apply;
306
+ /** The note the asker receives when the owner answered. */
307
+ private answerNote;
308
+ /** Where the asker's follow-up belongs. */
309
+ private whereLine;
310
+ /**
311
+ * One pass: retry unposted cards, post due reminders, apply defaults at
312
+ * the deadline, re-ask / park sensitive asks, prune old decisions.
313
+ *
314
+ * @returns Ids acted on
315
+ */
316
+ tick(): Promise<string[]>;
317
+ /** Post the "Remind me tomorrow" reminder in the card's thread. */
318
+ private remindNow;
319
+ /** Non-sensitive deadline: apply the default (or say it keeps waiting). */
320
+ private applyDefault;
321
+ /** Sensitive deadline: re-ask once after 24 h, then park. Never auto-applied. */
322
+ private sensitiveStep;
323
+ /** Re-render the card for the decision's current state (with the posting bot's token). */
324
+ private refreshCard;
325
+ /** Post a line in the card's thread, as the asker. */
326
+ private postInThread;
327
+ private logTicket;
328
+ /**
329
+ * Tell the asker how a decision settled: through its kind's handler when
330
+ * it has one (which also acts on the answer), else with `fallback`.
331
+ */
332
+ private notifyAsker;
333
+ private tellAsker;
334
+ private closeWatchdog;
335
+ }
336
+ /** Re-exported for the deadline line in the dashboard/API. */
337
+ export { formatWhen };
338
+ //# sourceMappingURL=decision.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decision.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/decisions/decision.service.ts"],"names":[],"mappings":"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"}