@yuriai/web 0.2.27-beta.8 → 0.2.27

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 (196) hide show
  1. package/dist/assets/{AgentAvatar-BJ42lGZD.js → AgentAvatar-DNm_jMna.js} +1 -1
  2. package/dist/assets/AssistantContactStatus-BPRpgMFh.js +3 -0
  3. package/dist/assets/{AssistantUnreadBadge-QwhBfXpC.js → AssistantUnreadBadge-BssH-RvV.js} +1 -1
  4. package/dist/assets/{AssistantView-D7ryIKL0.js → AssistantView-CxQv-9Ms.js} +1 -1
  5. package/dist/assets/{DiagramView-ERrGEBDp.js → DiagramView-DPpG0fwx.js} +1 -1
  6. package/dist/assets/{FadeInOnReveal-Bu2GvaM9.js → FadeInOnReveal-S6UbimjB.js} +1 -1
  7. package/dist/assets/{GuiPluginSurface-MzQgEZNr.js → GuiPluginSurface-BOf0JA1T.js} +1 -1
  8. package/dist/assets/{GuiPluginWindow-DZMmlQzx.js → GuiPluginWindow-OrYkfQ4m.js} +1 -1
  9. package/dist/assets/{Icon-Dj4CCqCP.js → Icon-BE4mEwzV.js} +1 -1
  10. package/dist/assets/{ImageLoadingPlaceholder-BnFXgUuO.js → ImageLoadingPlaceholder-CBFJC_KD.js} +1 -1
  11. package/dist/assets/{LoadingImage-PBnivDKv.js → LoadingImage-NLq7_P-i.js} +1 -1
  12. package/dist/assets/MarkdownRenderer-BaMotAOQ.js +2 -0
  13. package/dist/assets/{MarkdownRendererImpl-CfyXL4rg.js → MarkdownRendererImpl-Cv6UnGG7.js} +1 -1
  14. package/dist/assets/{MarkstreamRendererImpl-BGadklK1.js → MarkstreamRendererImpl-Rb9O6wkW.js} +1 -1
  15. package/dist/assets/{MobileDetailNavigation-DqajQdB4.js → MobileDetailNavigation-CK4KbkeS.js} +1 -1
  16. package/dist/assets/{MobileResizableSheet-BvdUgwA3.js → MobileResizableSheet-Deidw1br.js} +1 -1
  17. package/dist/assets/{MobileShareBridge-3oPoYnry.js → MobileShareBridge-CO_OWEfq.js} +2 -2
  18. package/dist/assets/MobileTabPageHeader-DbC8L6A4.js +2 -0
  19. package/dist/assets/{MultiRunWindow-yhs0Ih5_.js → MultiRunWindow-DtVW9NTV.js} +1 -1
  20. package/dist/assets/{OnboardingScreen-Bi1VWFQC.js → OnboardingScreen-C8ld4wO7.js} +1 -1
  21. package/dist/assets/{OverlayScrollbar-BBDwGvGO.js → OverlayScrollbar-B3auC2WH.js} +1 -1
  22. package/dist/assets/{SettingsView-BSf-SJUA.js → SettingsView-Cm7woZWl.js} +14 -14
  23. package/dist/assets/{SettingsWindow-BvSXVMTm.js → SettingsWindow-CdL4PFxW.js} +1 -1
  24. package/dist/assets/{TerminalView-DhL01N7e.js → TerminalView-CwRB6Yyr.js} +1 -1
  25. package/dist/assets/{ToolOutputDialog-C8lnH4Ky.js → ToolOutputDialog-B4BfmoVH.js} +1 -1
  26. package/dist/assets/{YuriLogo-D8asj1CS.js → YuriLogo-BOx0s0Ue.js} +1 -1
  27. package/dist/assets/{appThemeRegistry-C-maYSdv.js → appThemeRegistry-B6woJIX5.js} +1 -1
  28. package/dist/assets/{button-vXOdzd8x.js → button-BXxwtxsG.js} +1 -1
  29. package/dist/assets/{capgoAdapter-DJ_h2x5D.js → capgoAdapter-C5HFS-rx.js} +1 -1
  30. package/dist/assets/{collapsible-DwDQs3Wa.js → collapsible-BEm0787p.js} +1 -1
  31. package/dist/assets/{context-menu-BabBujQ-.js → context-menu-DUwvVUDY.js} +1 -1
  32. package/dist/assets/device-BcRP6Tjd.js +2 -0
  33. package/dist/assets/{diagram-HwgrQxY5.js → diagram-DyY8dxjZ.js} +1 -1
  34. package/dist/assets/{dialog-Dnf626tb.js → dialog-CLca6ojn.js} +1 -1
  35. package/dist/assets/{dropdown-menu.styles-CBc_a-Nv.js → dropdown-menu.styles-DGaALKP0.js} +1 -1
  36. package/dist/assets/{es-BQkO-Odr.js → es-CrsHvgue.js} +2 -2
  37. package/dist/assets/fileMentionAutocompleteState-BZJqfgae.js +2 -0
  38. package/dist/assets/{fileMentionTouchSelection-CKPnEetl.js → fileMentionTouchSelection-C4dvP8GY.js} +2 -2
  39. package/dist/assets/{fileReferenceActions-g7KZLi_G.js → fileReferenceActions-CrIAce3K.js} +1 -1
  40. package/dist/assets/{fr-C852roK5.js → fr-CEgiRlfa.js} +2 -2
  41. package/dist/assets/{gitApi-CVq5oKCd.js → gitApi-D2G9ny2O.js} +1 -1
  42. package/dist/assets/{gitApiHttp-BYOIbYIh.js → gitApiHttp-B7vYwgBh.js} +4 -4
  43. package/dist/assets/{gui-M_Rbwkyu.js → gui-CJjEj3l4.js} +1 -1
  44. package/dist/assets/host-CnVx34Dh.js +1 -0
  45. package/dist/assets/{input-BtM712b1.js → input-D59Q2pm8.js} +1 -1
  46. package/dist/assets/insertionBoundaries-CedfTSM5.js +1 -0
  47. package/dist/assets/{ja-BqC39qK6.js → ja-CX-_p9jZ.js} +2 -2
  48. package/dist/assets/{ko-BMaChAWh.js → ko-D5xlLYJM.js} +2 -2
  49. package/dist/assets/main-CxpUooVS.js +2 -0
  50. package/dist/assets/{main-Mey7bCWf.js → main-Dpm4KxWX.js} +12 -12
  51. package/dist/assets/{markdownHeightCache-Bf8iisO4.js → markdownHeightCache-D2VWb_4E.js} +1 -1
  52. package/dist/assets/{mcpQueries-DpXqegX5.js → mcpQueries-DQ3KthDF.js} +1 -1
  53. package/dist/assets/miniChat-CTdj8Ug9.js +2 -0
  54. package/dist/assets/mobile-ChbA3Q8j.js +2 -0
  55. package/dist/assets/{mobileBackNavigation-DZcI7aZg.js → mobileBackNavigation-BJqt3oHk.js} +1 -1
  56. package/dist/assets/{multirun-hzspPepd.js → multirun-BILeETbd.js} +1 -1
  57. package/dist/assets/{native-H7K64Ulc.js → native-BYMhr-xH.js} +1 -1
  58. package/dist/assets/{native-config-CddZtLQ1.js → native-config-BIY0Cr-l.js} +1 -1
  59. package/dist/assets/{persistence-BT8045Ue.js → persistence-CWuLIq1J.js} +2 -2
  60. package/dist/assets/{pl-Ubs8p28T.js → pl-BjH81A_q.js} +2 -2
  61. package/dist/assets/{projectMeta-CEf0QPmD.js → projectMeta-B9_Uh8YH.js} +1 -1
  62. package/dist/assets/{pt-BR-8rAOjJrs.js → pt-BR-Dp5oK2x3.js} +2 -2
  63. package/dist/assets/queue-abort-optimistic-CS5jTJq-.js +1 -0
  64. package/dist/assets/{readiness-Dyr7314z.js → readiness-BNIgH81X.js} +1 -1
  65. package/dist/assets/renderElectronMiniChatApp-asOqV7FB.js +2 -0
  66. package/dist/assets/renderMobileApp-DAfque7-.js +28 -0
  67. package/dist/assets/{runtimeConfig-B8VHHNxj.js → runtimeConfig-BX8JirIc.js} +1 -1
  68. package/dist/assets/runtimeEndpointReset-CFQgUiUr.js +149 -0
  69. package/dist/assets/{scheduledTaskNavigation-Zm87Nydi.js → scheduledTaskNavigation-EomDNVu2.js} +1 -1
  70. package/dist/assets/sessionLookup-BxAaxPOw.js +1 -0
  71. package/dist/assets/{sortable-tabs-strip-D4pVoodN.js → sortable-tabs-strip-DpbW5MqX.js} +1 -1
  72. package/dist/assets/{speechSettingsQueries-RlCLMBtr.js → speechSettingsQueries-CC0fusUo.js} +2 -2
  73. package/dist/assets/src-BMKjN2ip.css +2 -0
  74. package/dist/assets/{store-ME7oHni1.js → store-CkIHVrmT.js} +4 -3
  75. package/dist/assets/{terminalApi-BSaclMDJ.js → terminalApi-rl9mZAlB.js} +1 -1
  76. package/dist/assets/{textarea-B98rsLs7.js → textarea-7eTptEtD.js} +1 -1
  77. package/dist/assets/{tooltip-B9810jbK.js → tooltip-BPwoSTzO.js} +1 -1
  78. package/dist/assets/types-CUtSV1V8.js +2 -0
  79. package/dist/assets/{uk-LzwzUApL.js → uk-BEfkaLtM.js} +2 -2
  80. package/dist/assets/{useAppFontEffects-D2C1sBYM.js → useAppFontEffects-Ck2PdQRx.js} +37 -37
  81. package/dist/assets/{useAssistantUIStore-TUN_ycy5.js → useAssistantUIStore-CfaQV3ID.js} +1 -1
  82. package/dist/assets/useDesktopWindowControlsLayout-DxxOUZj1.js +1 -0
  83. package/dist/assets/useEffectiveDirectory-CNCQfN_x.js +1 -0
  84. package/dist/assets/{useFontPreferences-BlhlCJCX.js → useFontPreferences-DeqW9nRx.js} +1 -1
  85. package/dist/assets/useMobileNavigationStore-BmVr5a5c.js +17 -0
  86. package/dist/assets/{useUIStore-DRx6OgCp.js → useUIStore-C6CE42oh.js} +1 -1
  87. package/dist/assets/{useWorkerHighlightedLines-D093jNsH.js → useWorkerHighlightedLines-CN_RGaSw.js} +1 -1
  88. package/dist/assets/{vendor-effect-DV9F8PTZ.js → vendor-effect-X1Hqc7ba.js} +13 -13
  89. package/dist/assets/vendor-opencode-client-cQ47ywrT.js +23 -0
  90. package/dist/assets/{vendor-opencode-plugin-BBOP6WNx.js → vendor-opencode-plugin-BmdTE4Te.js} +1 -1
  91. package/dist/assets/vendor-opencode-schema-DWT45VBX.js +1 -0
  92. package/dist/assets/vendor-solid-js-D98iXT7C.js +1 -0
  93. package/dist/assets/vendor-zod-DZzbCm1s.js +55 -0
  94. package/dist/assets/{zh-CN-D-FVCeks.js → zh-CN-DipfA56P.js} +2 -2
  95. package/dist/assets/{zh-TW-B9iH_NXL.js → zh-TW-B7pXMVjt.js} +2 -2
  96. package/dist/index.html +12 -12
  97. package/dist/mini-chat.html +12 -12
  98. package/dist/mobile.html +12 -12
  99. package/package.json +1 -1
  100. package/server/index.js +2 -145
  101. package/server/lib/assistants/DOCUMENTATION.md +56 -10
  102. package/server/lib/assistants/cards.js +1 -1
  103. package/server/lib/assistants/channel-image.js +92 -0
  104. package/server/lib/assistants/channel-image.test.js +76 -0
  105. package/server/lib/assistants/channel-output-store.test.js +41 -0
  106. package/server/lib/assistants/channel-output.integration.test.js +114 -0
  107. package/server/lib/assistants/channel-output.js +90 -0
  108. package/server/lib/assistants/channel-output.test.js +79 -0
  109. package/server/lib/assistants/channels/DOCUMENTATION.md +52 -14
  110. package/server/lib/assistants/channels/PROTOCOLS.md +23 -1
  111. package/server/lib/assistants/channels/dingtalk-chat-adapter.js +19 -7
  112. package/server/lib/assistants/channels/dingtalk-chat-adapter.test.js +8 -0
  113. package/server/lib/assistants/channels/routes.js +12 -0
  114. package/server/lib/assistants/channels/routes.test.js +34 -0
  115. package/server/lib/assistants/channels/runtime.js +117 -26
  116. package/server/lib/assistants/channels/runtime.test.js +179 -5
  117. package/server/lib/assistants/channels/sdk-adapters.js +15 -3
  118. package/server/lib/assistants/channels/sdk-adapters.test.js +17 -0
  119. package/server/lib/assistants/channels/store.js +9 -6
  120. package/server/lib/assistants/channels/store.test.js +21 -11
  121. package/server/lib/assistants/channels/transport.js +2 -1
  122. package/server/lib/assistants/channels/wecom-chat-adapter.js +16 -2
  123. package/server/lib/assistants/channels/wecom-chat-adapter.test.js +21 -0
  124. package/server/lib/assistants/contact-store.js +9 -3
  125. package/server/lib/assistants/contact-store.test.js +27 -0
  126. package/server/lib/assistants/contact-tools.js +65 -75
  127. package/server/lib/assistants/contact-tools.test.js +114 -22
  128. package/server/lib/assistants/harness.js +79 -34
  129. package/server/lib/assistants/harness.test.js +52 -20
  130. package/server/lib/assistants/resource-reference.integration.test.js +284 -0
  131. package/server/lib/assistants/routes.js +0 -3
  132. package/server/lib/assistants/service.js +116 -69
  133. package/server/lib/assistants/service.test.js +31 -17
  134. package/server/lib/assistants/weixin/DOCUMENTATION.md +34 -9
  135. package/server/lib/assistants/weixin/api.js +43 -1
  136. package/server/lib/assistants/weixin/api.test.js +28 -0
  137. package/server/lib/assistants/weixin/chat-adapter.js +8 -2
  138. package/server/lib/assistants/weixin/inbound.js +5 -3
  139. package/server/lib/assistants/weixin/inbound.test.js +20 -0
  140. package/server/lib/assistants/weixin/runtime.js +27 -18
  141. package/server/lib/assistants/weixin/runtime.test.js +36 -0
  142. package/server/lib/assistants/weixin/store.js +8 -4
  143. package/server/lib/assistants/weixin/store.test.js +21 -0
  144. package/server/lib/assistants/yuri-project.http.test.js +9 -3
  145. package/server/lib/notifications/DOCUMENTATION.md +6 -0
  146. package/server/lib/notifications/runtime.js +26 -15
  147. package/server/lib/notifications/runtime.test.js +14 -13
  148. package/server/lib/opencode/DOCUMENTATION.md +9 -0
  149. package/server/lib/opencode/auth.d.ts +6 -2
  150. package/server/lib/opencode/core-routes.js +0 -1
  151. package/server/lib/opencode/feature-routes-runtime.js +0 -24
  152. package/server/lib/opencode/location-release.d.ts +5 -1
  153. package/server/lib/opencode/managed-capabilities/scheduled-task.js +1 -1
  154. package/server/lib/opencode/managed-capabilities-runtime.test.js +1 -1
  155. package/server/lib/opencode/native-goal.js +15 -0
  156. package/server/lib/opencode/native-goal.test.js +17 -0
  157. package/server/lib/opencode/settings-helpers.js +0 -6
  158. package/server/lib/opencode/shutdown-runtime.js +0 -2
  159. package/server/lib/projects/project-config.js +3 -6
  160. package/server/lib/scheduled-tasks/DOCUMENTATION.md +10 -35
  161. package/server/lib/scheduled-tasks/managed-tool-route.js +1 -30
  162. package/server/lib/scheduled-tasks/routes.js +0 -26
  163. package/server/lib/scheduled-tasks/runtime.js +33 -257
  164. package/server/lib/scheduled-tasks/runtime.test.js +24 -65
  165. package/server/lib/session-metadata/DOCUMENTATION.md +9 -12
  166. package/server/lib/session-metadata/routes.js +4 -38
  167. package/server/lib/session-metadata/routes.test.js +2 -2
  168. package/dist/assets/AssistantContactStatus-dtkObamV.js +0 -3
  169. package/dist/assets/MarkdownRenderer-BajF4gUU.js +0 -2
  170. package/dist/assets/MobileTabPageHeader-B6cRyIRH.js +0 -2
  171. package/dist/assets/device-BjRYYXNT.js +0 -2
  172. package/dist/assets/host-BW3FEJdU.js +0 -1
  173. package/dist/assets/insertionBoundaries-Dx3WAY6i.js +0 -1
  174. package/dist/assets/main-9uP2z1qT.js +0 -2
  175. package/dist/assets/miniChat-DqZvVkme.js +0 -2
  176. package/dist/assets/mobile-DXAWjYcN.js +0 -2
  177. package/dist/assets/renderElectronMiniChatApp-DoOq8Cuo.js +0 -2
  178. package/dist/assets/renderMobileApp-TTxtOb8b.js +0 -28
  179. package/dist/assets/runtimeEndpointReset-BC6XWntz.js +0 -149
  180. package/dist/assets/sessionLookup-De53jDwM.js +0 -1
  181. package/dist/assets/src-lE4uqaHS.css +0 -2
  182. package/dist/assets/types-DFf9vd1b.js +0 -2
  183. package/dist/assets/useDesktopWindowControlsLayout-BjKaHN0x.js +0 -1
  184. package/dist/assets/useEffectiveDirectory-TEvyiQSC.js +0 -1
  185. package/dist/assets/useMobileNavigationStore-DTvJV9s-.js +0 -23
  186. package/dist/assets/vendor-opencode-client-ZeOZ4Efz.js +0 -23
  187. package/dist/assets/vendor-solid-js-9wmPZH9g.js +0 -1
  188. package/dist/assets/vendor-zod-Dzk5kdUU.js +0 -39
  189. package/server/lib/session-goal/DOCUMENTATION.md +0 -371
  190. package/server/lib/session-goal/capability.js +0 -57
  191. package/server/lib/session-goal/capability.test.js +0 -33
  192. package/server/lib/session-goal/objectives.js +0 -61
  193. package/server/lib/session-goal/routes.js +0 -274
  194. package/server/lib/session-goal/routes.test.js +0 -211
  195. package/server/lib/session-goal/runtime.js +0 -2452
  196. package/server/lib/session-goal/runtime.test.js +0 -2125
@@ -1,7 +1,6 @@
1
1
  import { AssistantError, createAssistantsService } from './service.js';
2
2
  import { isSafeInlineImageMime } from './contact-attachments.js';
3
3
  import { createChatCompletion } from '../llm/completions.js';
4
- import { setAssignedSessionSettleHandler } from '../session-goal/runtime.js';
5
4
  import { makeOpenCodeV2Client } from '../opencode/v2-client.js';
6
5
  import path from 'node:path';
7
6
  import { createWeixinRuntime } from './weixin/runtime.js';
@@ -58,7 +57,6 @@ export const registerAssistantRoutes = (app, dependencies) => {
58
57
  onSystemSessionPersisted: dependencies.onSystemSessionPersisted,
59
58
  createChatCompletion: boundCompletion,
60
59
  });
61
- setAssignedSessionSettleHandler(({ sessionId, status }) => service.reportAssignedSessionSettle(sessionId, status));
62
60
  const unsubscribeTaskResults = dependencies.setTaskResultHandler?.((run) => service.reportScheduledTaskResult(run));
63
61
  app.use('/api/yuri/assistants', (req, res, next) => Promise.resolve(dependencies.refreshAllowedRoots?.()).then(next).catch((error) => respond(res, () => { throw error; })));
64
62
  app.get('/api/yuri/assistants/capability', (_req, res) => respond(res, () => service.capability()));
@@ -141,7 +139,6 @@ export const registerAssistantRoutes = (app, dependencies) => {
141
139
  registerAssistantChannelRoutes(app, channels);
142
140
  return { service, close: async () => {
143
141
  unsubscribeTaskResults?.();
144
- setAssignedSessionSettleHandler(null);
145
142
  await Promise.all([weixin.close(), channels.close()]);
146
143
  service.close();
147
144
  } };
@@ -3,11 +3,13 @@ import fs from 'node:fs';
3
3
  import { createRequire } from 'node:module';
4
4
  import path from 'node:path';
5
5
  import { makeOpenCodeV2Client } from '../opencode/v2-client.js';
6
+ import { getNativeSessionGoal } from '../opencode/native-goal.js';
6
7
  import { validAssistantDeliveryParts } from '../assistant-delivery-parts.js';
7
8
  import { createContactMemoryReader } from './memory.js';
8
9
  import { getContactGreeting } from './contact-greeting.js';
10
+ import { loadChannelImage } from './channel-image.js';
9
11
  import { getWorktrees as defaultListWorktrees } from '../git/service.js';
10
- import { contactCardIdentity, parseContactCard, parseContactPart } from './cards.js';
12
+ import { contactCardIdentity, createAssistantCardPart, createScheduleCardPart, createSessionCardPart, parseContactCard, parseContactPart } from './cards.js';
11
13
  import { ensureContactSummary } from './summary.js';
12
14
  import {
13
15
  CONTACT_PAGE_DEFAULT_LIMIT,
@@ -47,6 +49,7 @@ import {
47
49
  canonicalDescriptorFromRow,
48
50
  ensureContactAttachmentSchema,
49
51
  getContactAttachmentRow,
52
+ getContactAttachmentByUploadID,
50
53
  ingestDataUrlFilePart,
51
54
  isSafeInlineImageMime,
52
55
  materializeContactHistory,
@@ -152,8 +155,8 @@ const isMissingError = (error) => {
152
155
  };
153
156
  const ASSISTANT_SUCCESS_FINISH = new Set(['stop']);
154
157
  const ASSISTANT_ERROR_FINISH = new Set(['error', 'length', 'content-filter']);
155
- const GOAL_ACTIVE_STATUSES = new Set(['active', 'paused']);
156
- const GOAL_ERROR_STATUSES = new Set(['blocked', 'budgetLimited']);
158
+ const GOAL_ACTIVE_STATUSES = new Set(['active']);
159
+ const GOAL_ERROR_STATUSES = new Set(['paused']);
157
160
  const isTransientMessagesFailure = (result, error) => {
158
161
  if (error) {
159
162
  if (error instanceof AssistantError) return false;
@@ -626,7 +629,6 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
626
629
  return null;
627
630
  };
628
631
  // Stash assign delivery message IDs until the session card watch is written.
629
- const pendingAssignMessageIDs = new Map();
630
632
  // Assigned-session complete/error/cancelled resumes the contact LLM (no canned settle bubble).
631
633
  // Assigned after inContactTurnLane exists; reportAssignedSession only schedules via this ref.
632
634
  const assignedSessionResumeRef = { schedule: null };
@@ -795,12 +797,6 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
795
797
  void assignedCompletion.observe({ kind: 'complete', sessionId: sessionID }, { sessionID, options });
796
798
  return true;
797
799
  };
798
- const goalOfSession = (session) => {
799
- const goal = session?.metadata?.yuri?.goal;
800
- if (!goal || typeof goal !== 'object') return null;
801
- const status = typeof goal.status === 'string' ? goal.status.trim() : '';
802
- return status ? { status } : null;
803
- };
804
800
  /** Messages that belong to this delivery watermark (assign prompt messageID). */
805
801
  const messagesOwnedByDelivery = (messages, deliveryMessageID) => {
806
802
  if (!Array.isArray(messages)) return [];
@@ -865,7 +861,7 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
865
861
  if (!finish && !assistantInfo.time?.completed) return null;
866
862
  return null;
867
863
  };
868
- const inferAssignedSessionSettleStatus = (getResult, messagesResult, { deliveryMessageID = null, activeBusy = null } = {}) => {
864
+ const inferAssignedSessionSettleStatus = (getResult, messagesResult, { deliveryMessageID = null, activeBusy = null, goal = null } = {}) => {
869
865
  // Another Host may share this watch store but use a different OpenCode database.
870
866
  // Absence there is not an authoritative terminal result for the owning worker.
871
867
  if (isMissing(getResult)) return null;
@@ -874,8 +870,7 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
874
870
  if (activeBusy === true) return null;
875
871
  const session = sessionRecord(getResult);
876
872
  if (session?.error) return isUserAbort(session.error) ? 'cancelled' : 'error';
877
- const goal = goalOfSession(session);
878
- // Goal settle is owned by the session-goal reporter — never invent success.
873
+ // Goal completion comes only from OpenCode's native plugin state.
879
874
  if (goal && GOAL_ACTIVE_STATUSES.has(goal.status)) return null;
880
875
  if (goal && GOAL_ERROR_STATUSES.has(goal.status)) return 'error';
881
876
  if (goal && goal.status === 'complete') return 'complete';
@@ -952,9 +947,11 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
952
947
  else messagesResult = null;
953
948
  }
954
949
  if (closed) return;
950
+ const goal = await getNativeSessionGoal(client(), watch.sessionID, directory);
955
951
  const status = inferAssignedSessionSettleStatus(getResult, messagesResult, {
956
952
  deliveryMessageID: watch.messageID,
957
953
  activeBusy,
954
+ goal,
958
955
  });
959
956
  if (status) reportAssignedSession(watch.sessionID, status);
960
957
  } catch {
@@ -972,6 +969,11 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
972
969
  payload,
973
970
  );
974
971
  const body = eventBody(payload);
972
+ if (payload.type === 'rpc.opencode.goal.changed' && nonEmptyString(body?.sessionID)) {
973
+ if (body.goal?.status === 'complete') return reportAssignedSession(body.sessionID, 'complete');
974
+ if (body.goal?.status === 'paused') return reportAssignedSession(body.sessionID, 'error');
975
+ return false;
976
+ }
975
977
  // Message lifecycle still requires a body; execution/status may carry sessionID on body only.
976
978
  if (payload.type === 'message.updated') {
977
979
  if (!plainObject(body)) return false;
@@ -1705,14 +1707,18 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
1705
1707
 
1706
1708
  const persistPublishedContactCard = (assistantID, { userMessageID, turnID, index, card: cardInput }) => {
1707
1709
  const card = parseContactCard({ type: 'card', cardType: cardInput?.cardType || 'session', ...cardInput });
1708
- if (!card) return false;
1710
+ if (!card) throw new AssignError(ASSIGN_CODES.VALIDATION, 'Invalid resource reference.');
1709
1711
  const cardID = contactCardMessageID(userMessageID, index);
1710
- if (getContactMessage(db, cardID)) return false;
1711
1712
  db.exec('BEGIN IMMEDIATE');
1712
1713
  try {
1713
- if (getContactMessage(db, cardID)) {
1714
+ editable(assistantID);
1715
+ if (!getContactMessage(db, userMessageID)) throw new AssignError(ASSIGN_CODES.VALIDATION, 'This turn no longer belongs to the transcript.');
1716
+ const existing = getContactMessage(db, cardID);
1717
+ if (existing) {
1718
+ const published = existing.parts.find((part) => part.type === 'card');
1719
+ if (!published || contactCardIdentity(published) !== contactCardIdentity(card)) throw new AssignError(ASSIGN_CODES.VALIDATION, 'Reference slot already belongs to another resource.');
1714
1720
  db.exec('COMMIT');
1715
- return false;
1721
+ return published;
1716
1722
  }
1717
1723
  insertContactMessage(db, {
1718
1724
  messageID: cardID,
@@ -1725,23 +1731,9 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
1725
1731
  status: 'complete',
1726
1732
  parts: [card],
1727
1733
  });
1728
- if (card.cardType === 'session' && card.sessionID) {
1729
- const deliveryMessageID = pendingAssignMessageIDs.get(card.sessionID)
1730
- || (nonEmptyString(card.messageID) ? card.messageID : null);
1731
- if (pendingAssignMessageIDs.has(card.sessionID)) pendingAssignMessageIDs.delete(card.sessionID);
1732
- upsertContactWatch(db, {
1733
- assistantID,
1734
- sessionID: card.sessionID,
1735
- directory: card.directory,
1736
- status: card.status === 'error' || card.status === 'question' || card.status === 'complete' ? card.status : 'busy',
1737
- updatedAt: now(),
1738
- messageID: deliveryMessageID || null,
1739
- });
1740
- if (deliveryMessageID) void assignedCompletion.observe({ kind: 'running', sessionId: card.sessionID });
1741
- }
1742
1734
  bump();
1743
1735
  db.exec('COMMIT');
1744
- return true;
1736
+ return card;
1745
1737
  } catch (error) {
1746
1738
  db.exec('ROLLBACK');
1747
1739
  throw error;
@@ -1775,17 +1767,12 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
1775
1767
  };
1776
1768
 
1777
1769
  const rememberPublishedContactCard = (assistantID, { userMessageID, turnID, assignedCards, card }) => {
1778
- assignedCards.push(card);
1779
- try {
1780
- persistPublishedContactCard(assistantID, {
1781
- userMessageID,
1782
- turnID,
1783
- index: assignedCards.length - 1,
1784
- card,
1785
- });
1786
- } catch {
1787
- // Publishing a card must not abort the live turn.
1788
- }
1770
+ const index = assignedCards.findIndex((item) => contactCardIdentity(item) === contactCardIdentity(card));
1771
+ const published = persistPublishedContactCard(assistantID, {
1772
+ userMessageID, turnID, index: index < 0 ? assignedCards.length : index, card,
1773
+ });
1774
+ if (index < 0) assignedCards.push(published);
1775
+ return published;
1789
1776
  };
1790
1777
 
1791
1778
  /** Persist remaining assistant bubbles/cards for an already-admitted user turn (no user row). */
@@ -1833,20 +1820,6 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
1833
1820
  parts: [card],
1834
1821
  });
1835
1822
  ordinal += 1;
1836
- if (card.cardType === 'session' && card.sessionID) {
1837
- const deliveryMessageID = pendingAssignMessageIDs.get(card.sessionID)
1838
- || (nonEmptyString(card.messageID) ? card.messageID : null);
1839
- if (pendingAssignMessageIDs.has(card.sessionID)) pendingAssignMessageIDs.delete(card.sessionID);
1840
- upsertContactWatch(db, {
1841
- assistantID,
1842
- sessionID: card.sessionID,
1843
- directory: card.directory,
1844
- status: card.status === 'error' || card.status === 'question' || card.status === 'complete' ? card.status : 'busy',
1845
- updatedAt: now(),
1846
- messageID: deliveryMessageID || null,
1847
- });
1848
- if (deliveryMessageID) void assignedCompletion.observe({ kind: 'running', sessionId: card.sessionID });
1849
- }
1850
1823
  });
1851
1824
  bump();
1852
1825
  db.exec('COMMIT');
@@ -2459,14 +2432,26 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
2459
2432
  lookupMessage: (lookup) => lookupAssignMessage({ ...lookup, signal }),
2460
2433
  messageID: params?.messageID || `msg_assign_${id()}`,
2461
2434
  });
2462
- // Stash until the session card watch is written so reuse cannot settle on an old tail.
2435
+ // Watch admission belongs to assignment, independently of whether a card is sent.
2463
2436
  if (nonEmptyString(assigned?.sessionID) && nonEmptyString(assigned?.messageID)) {
2464
- pendingAssignMessageIDs.set(assigned.sessionID, assigned.messageID);
2437
+ try {
2438
+ db.transaction(() => {
2439
+ upsertContactWatch(db, {
2440
+ assistantID: row.assistant_id, sessionID: assigned.sessionID,
2441
+ directory: assigned.directory, status: assigned.status || 'busy',
2442
+ updatedAt: now(), messageID: assigned.messageID,
2443
+ });
2444
+ bump();
2445
+ }).immediate();
2446
+ } catch {
2447
+ return { ...assigned, watchError: 'watch_registration_failed' };
2448
+ }
2449
+ void assignedCompletion.observe({ kind: 'running', sessionId: assigned.sessionID });
2465
2450
  }
2466
2451
  return assigned;
2467
2452
  };
2468
2453
  /** Watch an existing session only — no prompt. Baseline status avoids false settle resume. */
2469
- const watchSessionWork = async (_row, params = {}) => {
2454
+ const watchSessionWork = async (row, params = {}) => {
2470
2455
  const sessionID = typeof params.sessionID === 'string' ? params.sessionID.trim() : '';
2471
2456
  if (!sessionID) {
2472
2457
  throw new AssignError(ASSIGN_CODES.VALIDATION, 'watch_session requires sessionID.');
@@ -2488,6 +2473,14 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
2488
2473
  status = 'busy';
2489
2474
  }
2490
2475
  }
2476
+ params.signal?.throwIfAborted();
2477
+ db.transaction(() => {
2478
+ upsertContactWatch(db, {
2479
+ assistantID: row.assistant_id, sessionID: resolved.sessionID,
2480
+ directory: resolved.directory, status, updatedAt: now(), messageID: null,
2481
+ });
2482
+ bump();
2483
+ }).immediate();
2491
2484
  return {
2492
2485
  sessionID: resolved.sessionID,
2493
2486
  directory: resolved.directory,
@@ -2779,6 +2772,33 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
2779
2772
  }
2780
2773
  return { tasks, ...(failed.length > 0 ? { partial: true, failed } : {}) };
2781
2774
  };
2775
+ const resolveContactResource = async (input, signal) => {
2776
+ signal?.throwIfAborted();
2777
+ if (input.cardType === 'session') {
2778
+ const resolved = await resolveReferencedSession({ sessionID: input.sessionID, signal, includeMessages: false });
2779
+ return createSessionCardPart(resolved);
2780
+ }
2781
+ if (input.cardType === 'assistant') {
2782
+ const target = output(editable(input.assistantID));
2783
+ return createAssistantCardPart({ ...target, assistantID: target.id });
2784
+ }
2785
+ const projects = await listProjects();
2786
+ if (!Array.isArray(projects)) throw new AssignError(ASSIGN_CODES.UPSTREAM, 'Project lookup failed.');
2787
+ if (!normalizeRegisteredProjects(projects).some((project) => project.id === input.projectID)) throw new AssignError(ASSIGN_CODES.PROJECT_REQUIRED, 'The task project is not registered.');
2788
+ if (typeof listScheduledTasks !== 'function') throw new AssignError(ASSIGN_CODES.UPSTREAM, 'Task lookup is unavailable.');
2789
+ const tasks = await listScheduledTasks(input.projectID);
2790
+ signal?.throwIfAborted();
2791
+ if (!Array.isArray(tasks)) throw new AssignError(ASSIGN_CODES.UPSTREAM, 'Task lookup failed.');
2792
+ const task = tasks.find((task) => task?.id === input.taskID);
2793
+ if (!task) throw new AssignError(ASSIGN_CODES.NOT_FOUND, 'The scheduled task no longer exists.');
2794
+ return createScheduleCardPart({
2795
+ taskID: task.id, projectID: input.projectID, name: task.name,
2796
+ kind: task.schedule?.kind, time: task.schedule?.time || task.schedule?.times?.[0],
2797
+ timezone: task.schedule?.timezone, prompt: task.execution?.prompt,
2798
+ cron: task.schedule?.cron ?? null, date: task.schedule?.date ?? null,
2799
+ times: task.schedule?.times ?? null, weekdays: task.schedule?.weekdays ?? null,
2800
+ });
2801
+ };
2782
2802
  const updateScheduledTaskWork = async (row, params, signal) => {
2783
2803
  signal?.throwIfAborted();
2784
2804
  if (typeof patchScheduledTask !== 'function') throw new AssignError(ASSIGN_CODES.UPSTREAM, 'Updating a scheduled task is unavailable.');
@@ -3224,9 +3244,12 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
3224
3244
  return output(editable(targetID));
3225
3245
  },
3226
3246
  currentAssistant: assistantSnapshot,
3247
+ resolveResource: resolveContactResource,
3227
3248
  onCard: (card) => {
3228
- if (contactResetThisTurn) return;
3229
- rememberPublishedContactCard(assistantID, {
3249
+ controller.signal.throwIfAborted();
3250
+ if (contactResetThisTurn) throw new AssignError(ASSIGN_CODES.VALIDATION, 'This turn reset its context.');
3251
+ editable(assistantID);
3252
+ return rememberPublishedContactCard(assistantID, {
3230
3253
  userMessageID: messageID, turnID, assignedCards, card,
3231
3254
  });
3232
3255
  },
@@ -3568,9 +3591,13 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
3568
3591
  },
3569
3592
  updateAssistantSettings: (patch) => updateContactSettings(row.assistant_id, patch),
3570
3593
  currentAssistant: assistantSnapshot,
3594
+ resolveResource: resolveContactResource,
3571
3595
  onCard: (card) => {
3572
- if (contactResetThisTurn) return;
3573
- rememberPublishedContactCard(row.assistant_id, {
3596
+ controller.signal.throwIfAborted();
3597
+ if (contactResetThisTurn) throw new AssignError(ASSIGN_CODES.VALIDATION, 'This turn reset its context.');
3598
+ editable(row.assistant_id);
3599
+ if (!getContactMessage(db, messageID)) throw new AssignError(ASSIGN_CODES.VALIDATION, 'This turn no longer belongs to the transcript.');
3600
+ return rememberPublishedContactCard(row.assistant_id, {
3574
3601
  userMessageID: messageID, turnID, assignedCards, card,
3575
3602
  });
3576
3603
  },
@@ -3862,9 +3889,7 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
3862
3889
  parts: [card],
3863
3890
  });
3864
3891
  if (card.cardType === 'session' && card.sessionID) {
3865
- const deliveryMessageID = pendingAssignMessageIDs.get(card.sessionID)
3866
- || (nonEmptyString(card.messageID) ? card.messageID : null);
3867
- if (pendingAssignMessageIDs.has(card.sessionID)) pendingAssignMessageIDs.delete(card.sessionID);
3892
+ const deliveryMessageID = nonEmptyString(card.messageID) ? card.messageID : null;
3868
3893
  upsertContactWatch(db, {
3869
3894
  assistantID: row.assistant_id,
3870
3895
  sessionID: card.sessionID,
@@ -4108,11 +4133,33 @@ export const createAssistantsService = ({ dbPath, dataDir, buildOpenCodeUrl, get
4108
4133
  active(assistantID);
4109
4134
  return readContactChannelPage(db, assistantID, options);
4110
4135
  };
4111
- return { capability: async () => ({ supported: true, enabled: enabled(), revision: revision(), serverInstanceID: await getServerId(), sharingAvailable: false, archiveMetadataAvailable: typeof archiveSessionHost === 'function', sessionMetadataAvailable: false }), snapshot, channelPage, ensureDefaultAssistant, createAssistant, updateAssistant, setEnabled: (input) => { if (!plainObject(input) || typeof input.enabled !== 'boolean' || input.expectedRevision !== revision()) fail('revision_conflict'); return { enabled: true, revision: revision() }; }, removeAssistant, ensure, createNew, compact, send, whenContactTurnSettled, abort, captureQueueDeliveryTarget, sendWithCapturedConfig, share, shareOperation, historicalMessages, contactMessages, clearContactMemory, resetContact, markContactRead, appendContactCard, deliverPeerMessage, listAssistantScheduledTasks, reportScheduledTaskResult, putAssistantContactAttachment, getAssistantContactAttachment, migrateContactAttachments, processEvent, reportAssignedSessionSettle: reportAssignedSession, reconcile, close: () => {
4136
+ const prepareChannelImage = async (assistantID, source, { generation, uploadID, signal }) => {
4137
+ const row = active(assistantID);
4138
+ const assertGeneration = () => {
4139
+ signal?.throwIfAborted();
4140
+ if (channelPage(assistantID, { tipOnly: true }).generation !== generation) fail('cancelled');
4141
+ };
4142
+ assertGeneration();
4143
+ const existing = getContactAttachmentByUploadID(db, assistantID, uploadID);
4144
+ if (existing && existing.generation === generation) return canonicalDescriptorFromRow(existing);
4145
+ const { buffer, mime, filename } = await loadChannelImage(source, {
4146
+ cwd: resolveAssistantCwd({ workspacePath: row.workspace_path, effectiveWorkspacePath: effectiveWorkspace(row) }),
4147
+ allowedRoots: getAllowedRoots(), signal,
4148
+ readAttachment: (attachmentID) => getAssistantContactAttachment(assistantID, attachmentID),
4149
+ });
4150
+ assertGeneration();
4151
+ const image = await putAssistantContactAttachment(assistantID, uploadID, {
4152
+ stream: { body: buffer }, signal,
4153
+ headers: { 'content-type': mime, 'x-attachment-filename': filename,
4154
+ 'x-content-size': String(buffer.length), 'x-content-sha256': crypto.createHash('sha256').update(buffer).digest('hex') },
4155
+ });
4156
+ assertGeneration();
4157
+ return image;
4158
+ };
4159
+ return { capability: async () => ({ supported: true, enabled: enabled(), revision: revision(), serverInstanceID: await getServerId(), sharingAvailable: false, archiveMetadataAvailable: typeof archiveSessionHost === 'function', sessionMetadataAvailable: false }), snapshot, channelPage, prepareChannelImage, ensureDefaultAssistant, createAssistant, updateAssistant, setEnabled: (input) => { if (!plainObject(input) || typeof input.enabled !== 'boolean' || input.expectedRevision !== revision()) fail('revision_conflict'); return { enabled: true, revision: revision() }; }, removeAssistant, ensure, createNew, compact, send, whenContactTurnSettled, abort, captureQueueDeliveryTarget, sendWithCapturedConfig, share, shareOperation, historicalMessages, contactMessages, clearContactMemory, resetContact, markContactRead, appendContactCard, deliverPeerMessage, listAssistantScheduledTasks, reportScheduledTaskResult, putAssistantContactAttachment, getAssistantContactAttachment, migrateContactAttachments, processEvent, reportAssignedSessionSettle: reportAssignedSession, reconcile, close: () => {
4112
4160
  assignedCompletion.dispose();
4113
4161
  cancelAssignedResumes({});
4114
4162
  sessionAbortInflight.clear();
4115
- pendingAssignMessageIDs.clear();
4116
4163
  for (const turn of contactControllers.values()) turn.controller.abort();
4117
4164
  if (!closed) {
4118
4165
  closed = true;
@@ -2,7 +2,7 @@ import fs from 'node:fs';
2
2
  import os from 'node:os';
3
3
  import path from 'node:path';
4
4
  import crypto from 'node:crypto';
5
- import { describe, expect, it, vi } from 'vitest';
5
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
6
6
  import { createRequire } from 'node:module';
7
7
  import { assignedSessionResumeMessageID, createAssistantsService } from './service.js';
8
8
  import { assistantContractFixtures } from './contracts.js';
@@ -12,6 +12,9 @@ import {
12
12
  } from './contact-tools.js';
13
13
  import { runContactTurn as realRunContactTurn } from './harness.js';
14
14
  import { AVATAR_COLORS, resolveAssistantAvatar } from '../../../../ui/src/lib/assistant-avatar/recipe.ts';
15
+ vi.mock('../opencode/native-goal.js', () => ({ getNativeSessionGoal: vi.fn(async () => null) }));
16
+ import { getNativeSessionGoal } from '../opencode/native-goal.js';
17
+ beforeEach(() => { getNativeSessionGoal.mockReset().mockResolvedValue(null); });
15
18
 
16
19
  const require = createRequire(import.meta.url);
17
20
  const root = () => fs.mkdtempSync(path.join(os.tmpdir(), 'assistants-'));
@@ -121,6 +124,11 @@ const assistantInput = { name: 'A', providerID: 'p', modelID: 'm' };
121
124
  const greetingText = "Hi, I'm A. How can I help you?";
122
125
  const toolBatch = (calls, content = '') => ({ completion: { choices: [{ message: { content, tool_calls: calls.map(([name, args, id = `call_${name}`]) => ({ id, type: 'function', function: { name, arguments: JSON.stringify(args) } })) } }] } });
123
126
  const sayThen = (text, name, args) => toolBatch([['notify_user', { text }], [name, args]]);
127
+ const referenceResult = async (tools, result) => {
128
+ const reference = await tools.find((tool) => tool.name === 'reference_resource').execute('reference', JSON.parse(result.content[0].text).reference);
129
+ expect(reference.isError).not.toBe(true);
130
+ return reference.details.card;
131
+ };
124
132
 
125
133
  describe('assistants service', () => {
126
134
  it('persists pins across clients and restarts without changing catalog, session or share-default order', async () => {
@@ -2771,9 +2779,11 @@ describe('assistants service', () => {
2771
2779
  toolBatch([['load_tools', { domain: 'yuri.projects' }]]),
2772
2780
  toolBatch([['register_project', { path: workspace }]]),
2773
2781
  toolBatch([['assign_session', { projectPath: workspace, prompt: 'hello' }]]),
2782
+ toolBatch([['reference_resource', { cardType: 'session', sessionID: 'ses_registered' }]]),
2774
2783
  ];
2775
2784
  const service = setup(directory, {
2776
2785
  create: async (input) => { creates.push(input); return { id: 'ses_registered' }; },
2786
+ get: async ({ sessionID }) => ({ id: sessionID, directory: workspace, title: 'Hello', status: { type: 'busy' } }),
2777
2787
  prompt: async (input) => { prompts.push(input); return { id: 'inbox_hello', type: 'user' }; },
2778
2788
  }, {
2779
2789
  getAllowedRoots: () => projects.map((project) => project.path),
@@ -2827,6 +2837,7 @@ describe('assistants service', () => {
2827
2837
  const prompts = [];
2828
2838
  const archives = [];
2829
2839
  const service = setup(directory, {
2840
+ get: async ({ sessionID }) => ({ id: sessionID, directory: project, title: 'Login', status: { type: 'busy' } }),
2830
2841
  create: async (input) => {
2831
2842
  creates.push(input);
2832
2843
  return { data: { id: `ses_${creates.length}` } };
@@ -2846,7 +2857,7 @@ describe('assistants service', () => {
2846
2857
  return {
2847
2858
  text: 'Opened the login session.',
2848
2859
  bubbles: ['Opened the login session.'],
2849
- cards: result.details.card ? [result.details.card] : [],
2860
+ cards: [await referenceResult(tools, result)],
2850
2861
  tools,
2851
2862
  };
2852
2863
  },
@@ -2889,6 +2900,7 @@ describe('assistants service', () => {
2889
2900
  fs.mkdirSync(project, { recursive: true });
2890
2901
  const creates = [];
2891
2902
  const service = setup(directory, {
2903
+ get: async ({ sessionID }) => ({ id: sessionID, directory: project, title: 'Once', status: { type: 'busy' } }),
2892
2904
  create: async (input) => {
2893
2905
  creates.push(input);
2894
2906
  return { data: { id: `ses_${creates.length}` } };
@@ -2908,7 +2920,7 @@ describe('assistants service', () => {
2908
2920
  return {
2909
2921
  text: first.content[0].text,
2910
2922
  bubbles: [first.content[0].text],
2911
- cards: first.details.card ? [first.details.card, second.details.card].filter(Boolean) : [],
2923
+ cards: [await referenceResult(tools, first), await referenceResult(tools, second)],
2912
2924
  tools,
2913
2925
  };
2914
2926
  },
@@ -3449,7 +3461,7 @@ describe('assistants service', () => {
3449
3461
  return {
3450
3462
  text: '在听',
3451
3463
  bubbles: ['在听'],
3452
- cards: result.details.card ? [result.details.card] : [],
3464
+ cards: [await referenceResult(tools, result)],
3453
3465
  };
3454
3466
  },
3455
3467
  });
@@ -3493,7 +3505,7 @@ describe('assistants service', () => {
3493
3505
  return {
3494
3506
  text: '盯着',
3495
3507
  bubbles: ['盯着'],
3496
- cards: result.details.card ? [result.details.card] : [],
3508
+ cards: [await referenceResult(tools, result)],
3497
3509
  };
3498
3510
  },
3499
3511
  });
@@ -3532,7 +3544,7 @@ describe('assistants service', () => {
3532
3544
  }
3533
3545
  const result = await tools.find((tool) => tool.name === 'watch_session').execute('watch', { sessionID: 'ses_once' });
3534
3546
  expect(result.isError).not.toBe(true);
3535
- return { text: '在听', bubbles: ['在听'], cards: [result.details.card] };
3547
+ return { text: '在听', bubbles: ['在听'], cards: [await referenceResult(tools, result)] };
3536
3548
  },
3537
3549
  };
3538
3550
  const client = { get: async ({ sessionID }) => ({ data: { id: sessionID, directory, status: { type: 'busy' } } }) };
@@ -3796,7 +3808,7 @@ describe('assistants service', () => {
3796
3808
  return {
3797
3809
  text: 'Created FlowQA.',
3798
3810
  bubbles: ['Created FlowQA.'],
3799
- cards: result.details.card ? [result.details.card] : [],
3811
+ cards: [await referenceResult(tools, result)],
3800
3812
  tools,
3801
3813
  };
3802
3814
  },
@@ -4061,7 +4073,8 @@ describe('assistants service', () => {
4061
4073
  expect(missing.details.error).toBe('model_not_found');
4062
4074
  expect(patches).toEqual([{ projectID: 'proj_a', taskID: 'task_a', patch: { execution: { providerID: 'new-provider', modelID: 'new-model' } } }]);
4063
4075
  expect(synced).toEqual(['proj_a']);
4064
- expect(updated.details.card).toMatchObject({ taskID: 'task_a' });
4076
+ expect(updated.details.card).toBeUndefined();
4077
+ expect(JSON.parse(updated.content[0].text).reference).toEqual({ cardType: 'schedule', projectID: 'proj_a', taskID: 'task_a' });
4065
4078
  service.close();
4066
4079
  });
4067
4080
 
@@ -4070,6 +4083,7 @@ describe('assistants service', () => {
4070
4083
  const upserts = [];
4071
4084
  const service = setup(directory, {}, {
4072
4085
  listProjects: async () => [{ id: 'proj_app', path: directory }],
4086
+ listScheduledTasks: async () => upserts.map(({ task }) => ({ ...task, id: 'task_ping' })),
4073
4087
  upsertScheduledTask: async (projectID, task) => {
4074
4088
  upserts.push({ projectID, task });
4075
4089
  return {
@@ -4095,7 +4109,7 @@ describe('assistants service', () => {
4095
4109
  return {
4096
4110
  text: 'Scheduled the ping.',
4097
4111
  bubbles: ['Scheduled the ping.'],
4098
- cards: result.details.card ? [result.details.card] : [],
4112
+ cards: [await referenceResult(tools, result)],
4099
4113
  tools,
4100
4114
  };
4101
4115
  },
@@ -4132,7 +4146,7 @@ describe('assistants service', () => {
4132
4146
  assistantID: host.id,
4133
4147
  projectID: 'proj_app',
4134
4148
  taskID: 'task_ping',
4135
- task: null,
4149
+ task: expect.objectContaining({ id: 'task_ping' }),
4136
4150
  })]);
4137
4151
  service.close();
4138
4152
  });
@@ -6644,12 +6658,12 @@ describe('read_session referenced conversation', () => {
6644
6658
  if (userText === 'watch') {
6645
6659
  const watch = tools.find((tool) => tool.name === 'watch_session');
6646
6660
  const result = await watch.execute('call_w', { sessionID: 'ses_abort_race' });
6647
- return { text: '盯着', bubbles: ['盯着'], cards: result.details.card ? [result.details.card] : [] };
6661
+ return { text: '盯着', bubbles: ['盯着'], cards: [await referenceResult(tools, result)] };
6648
6662
  }
6649
6663
  if (userText === 'peer watch') {
6650
6664
  const watch = tools.find((tool) => tool.name === 'watch_session');
6651
6665
  const result = await watch.execute('call_peer_w', { sessionID: 'ses_abort_race' });
6652
- return { text: 'peer盯', bubbles: ['peer盯'], cards: result.details.card ? [result.details.card] : [] };
6666
+ return { text: 'peer盯', bubbles: ['peer盯'], cards: [await referenceResult(tools, result)] };
6653
6667
  }
6654
6668
  const stop = tools.find((tool) => tool.name === 'stop_session');
6655
6669
  const stopPromise = stop.execute('call_s', { sessionID: 'ses_abort_race' });
@@ -6721,13 +6735,13 @@ describe('read_session referenced conversation', () => {
6721
6735
  }
6722
6736
  if (userText === 'watch both') {
6723
6737
  const watch = tools.find((tool) => tool.name === 'watch_session');
6724
- await watch.execute('w1', { sessionID: 'ses_fail_abort' });
6725
- await watch.execute('w2', { sessionID: 'ses_other_worker' });
6738
+ await referenceResult(tools, await watch.execute('w1', { sessionID: 'ses_fail_abort' }));
6739
+ await referenceResult(tools, await watch.execute('w2', { sessionID: 'ses_other_worker' }));
6726
6740
  return { text: '双盯', bubbles: ['双盯'], cards: [] };
6727
6741
  }
6728
6742
  if (userText === 'peer watch fail') {
6729
6743
  const watch = tools.find((tool) => tool.name === 'watch_session');
6730
- await watch.execute('peer_w', { sessionID: 'ses_fail_abort' });
6744
+ await referenceResult(tools, await watch.execute('peer_w', { sessionID: 'ses_fail_abort' }));
6731
6745
  return { text: 'peer盯', bubbles: ['peer盯'], cards: [] };
6732
6746
  }
6733
6747
  const stop = tools.find((tool) => tool.name === 'stop_session');
@@ -6797,12 +6811,12 @@ describe('read_session referenced conversation', () => {
6797
6811
  if (userText === 'watch') {
6798
6812
  const watch = tools.find((tool) => tool.name === 'watch_session');
6799
6813
  const result = await watch.execute('w', { sessionID: 'ses_silent' });
6800
- return { text: '盯', bubbles: ['盯'], cards: result.details.card ? [result.details.card] : [] };
6814
+ return { text: '盯', bubbles: ['盯'], cards: [await referenceResult(tools, result)] };
6801
6815
  }
6802
6816
  if (userText === 'peer silent watch') {
6803
6817
  const watch = tools.find((tool) => tool.name === 'watch_session');
6804
6818
  const result = await watch.execute('peer_silent', { sessionID: 'ses_silent' });
6805
- return { text: 'peer盯', bubbles: ['peer盯'], cards: result.details.card ? [result.details.card] : [] };
6819
+ return { text: 'peer盯', bubbles: ['peer盯'], cards: [await referenceResult(tools, result)] };
6806
6820
  }
6807
6821
  const stop = tools.find((tool) => tool.name === 'stop_session');
6808
6822
  const result = await stop.execute('s', { sessionID: 'ses_silent' });
@@ -28,6 +28,9 @@ service protocol. No OpenClaw runtime or new dependency is installed.
28
28
  and MIME identification; no arbitrary URL fetch or credential forwarding.
29
29
  - `toon.js`: local JSON-only TOON encoder (objects, lists, primitive/tabular
30
30
  arrays); no new dependency, key folding, raw-string emission or decoding API.
31
+ - `../channel-output.js` / `../channel-image.js`: shared published-image projection
32
+ and bounded image materialization for all four channels; no WeChat-only output
33
+ parser or second attachment store.
31
34
  - `assistants/service.channelPage()` is an internal bounded, ascending durable
32
35
  output seam. It validates the Bot and uses the contact-store generation. It does
33
36
  not expose credentials or replace the contact execution engine.
@@ -132,17 +135,36 @@ data directory cannot steal a live account. After any network wait, epoch/lease
132
135
  checks fence stale writes. Cross-machine copies of credentials/data are unsupported.
133
136
 
134
137
  Binding starts at the current contact tip, so existing history/greetings are not
135
- sent. Subsequent **public assistant replies**, including App-initiated and background
136
- task replies, sync to the paired owner. Plain text is sent as text; current cards
137
- become title/name text, not interactive WeChat cards or deeplinks. Internal settle
138
+ sent. Subsequent **public assistant replies eligible for external delivery**,
139
+ including background task replies, sync to the paired owner. Built-in Yuri IM
140
+ replies are excluded by the shared contact feed and stay in their conversation.
141
+ Plain text is sent as text; internal cards
142
+ are unsupported output and silently skipped, with no title/link/deeplink fallback,
143
+ error notice or retry. They remain visible in Yuri. Internal settle
138
144
  markers are omitted and failures use a safe generic message, never raw tool errors.
145
+ Published Markdown images and image file parts are sent as native images, in order
146
+ with surrounding text, subject to the same original-channel routing. Images are
147
+ snapshotted to owned contact attachments before the feed watermark commits; the
148
+ additive outbox `image` column stores only opaque descriptors (legacy rows remain
149
+ text). Restart/retry reads immutable snapshot bytes, not a possibly deleted source
150
+ file. `api.sendImage()` obtains upload parameters, AES-128-ECB/PKCS#7 encrypts the
151
+ bytes, and POSTs only to the fixed official `/c2c/upload` CDN without bot credentials.
152
+ Only HTTP 200 plus `x-encrypted-param` permits the final `type: 2` image send with
153
+ the stable delivery client ID and reply context. Upload failure is not an ambiguous
154
+ chat send; a failed final send keeps the existing blocked/unknown semantics. A
155
+ definite failure produces a safe text notice and does not discard later output.
156
+ The adapter rechecks generation/ownership after upload before sending. Source,
157
+ size, SSRF and format bounds are documented in `../DOCUMENTATION.md`.
139
158
  Generation reset drops queued output from the previous transcript. An already submitted HTTP request
140
159
  cannot be recalled, including during disconnect/reset.
141
160
 
142
161
  ### Rich inbound content
143
162
 
144
163
  - Plain text retains the ordinary text path. Item protocol IDs (`msg_id`) and
145
- envelope fields such as timestamps do not create a separate TOON text part.
164
+ envelope fields such as timestamps, completion/routing fields, root/parent IDs,
165
+ and empty button lists do not create a separate TOON text part. Private-only
166
+ extensions are omitted after projection; actual share fields, quotes and
167
+ nonempty buttons still retain their content.
146
168
  Every recognized image, voice, file
147
169
  and video item is represented; mixed items no longer silently lose media. An
148
170
  item-level `msg_id` is accepted when the top-level message ID is absent, matching
@@ -197,10 +219,12 @@ expiry or transcript reset. Successfully staged attachments follow the existing
197
219
  contact attachment lifecycle, including its normal unreferenced-object behavior.
198
220
 
199
221
  Replies are split by Unicode code points into at most 3500-character segments;
200
- stable client IDs and ordered outbox rows survive restart. This is not a server-side
201
- exactly-once guarantee. An uncertain HTTP result is marked **delivery unknown** and
202
- blocks later output until the owner explicitly retries. New inbound context may
203
- unblock a known rejected reply but never automatically retries an unknown send.
222
+ stable client IDs and ordered pending outbox rows survive restart. This is not a server-side
223
+ exactly-once guarantee. An uncertain HTTP result is marked **delivery unknown**;
224
+ it and definitively blocked replies remain durable but do not block later pending
225
+ output, Bot execution or receiving. Later successful sends do not hide unresolved
226
+ delivery errors. New inbound context may unblock a known rejected reply but never
227
+ automatically retries an unknown send.
204
228
  Authentication expiry stays expired until new authorization; receiver network errors
205
229
  retry with 1–30 second capped backoff. Users can manually retry other blocked sends.
206
230
  The platform's reply-context lifetime and active-push quota are not specified here.
@@ -222,7 +246,8 @@ content and stale runtime mutations cannot overwrite a new Host's cache.
222
246
  ### Typing presence
223
247
 
224
248
  Only live `yuri:contact-turn-start/end` events drive typing, including App-initiated
225
- or background contact turns without a channel source, which may push to WeChat.
249
+ or background contact turns. Presence is separate from output routing: built-in
250
+ Yuri IM replies are never pushed to WeChat.
226
251
  Replies to channel-originated turns require an exact receipt in this binding:
227
252
  WeChat inputs reply only here, and enterprise-channel inputs never broadcast here.
228
253
  The persisted contact turn ID identifies the original admitted input across restart.