@athenaintel/react 0.57.2 → 0.60.0

package/dist/composer/composer-handoff.js

@@ -4,6 +4,7 @@ import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
 import { AthenaSdkError } from "../diagnostics/errors.js";
 import { useStatewireSessionLanePending } from "../runtime/statewire-session-lane.js";
 import { useAthenaStatewireThreadList } from "../threads/statewire-thread-list.js";
+import { autoComposerSendOptions } from "../agent-runtime/src/run-send.js";
 function createComposerHandoffStore() {
   return {
     pending: [],
@@ -74,7 +75,7 @@ function applyComposerWrite({
   store,
   write
 }) {
-  var _a;
+  var _a, _b;
   const current = target.composer.getState().text ?? "";
   const next = mergeComposerDraft({ current, write });
   target.composer.setText(next);
@@ -87,7 +88,10 @@ function applyComposerWrite({
     data: { phase: "applied", send: write.send, focus: write.focus, chars: next.length }
   });
   if (write.send) {
-    return Promise.resolve(target.composer.send({ steer: false })).then(() => void 0);
+    const isRunning = ((_b = target.thread) == null ? void 0 : _b.call(target).getState().isRunning) ?? false;
+    return Promise.resolve(target.composer.send(autoComposerSendOptions(isRunning))).then(
+      () => void 0
+    );
   }
   return void 0;
 }

package/dist/composer/composer-handoff.js.map

@@ -1 +1 @@
-{"version":3,"file":"composer-handoff.js","sources":["../../src/composer/composer-handoff.ts"],"sourcesContent":["/**\n * Composer handoff: writes to the chat composer from host UI that lives\n * outside `<AthenaChat>` (a sidebar, an agenda card, a workflow button).\n *\n * Two problems it solves for `useAppendToComposer` / `useSendMessage`:\n *\n * 1. A write before the chat is ready is lost. While the thread list is still\n *    resolving the active thread, or the thread's history is still loading,\n *    the composer the hooks write to belongs to a mount that is about to be\n *    replaced (thread-list mode keys the statewire subtree by thread), and\n *    the draft goes with it. The store below lives ABOVE that mount, so a\n *    write made too early waits here and the ready mount drains it.\n * 2. A prefilled draft should put the caret after the text so the user can\n *    keep typing or dictating. The Tiptap editor mirrors runtime text on a\n *    later tick; the `focusOnNextMirror` flag asks it to focus at the end\n *    right after that mirror lands, instead of the host guessing a delay.\n *\n * Every queued write is bound to the statewire thread it was made for and\n * drains only into that thread's mount; a thread switch, an identity change\n * or a provider unmount drops what waits with a `composer_write_dropped`\n * error, never into another user's or another thread's composer.\n */\nimport { createContext, useCallback, useContext } from 'react';\nimport { useAuiState } from '@assistant-ui/react';\nimport type { ChatOutboxAttachment } from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport { useStatewireSessionLanePending } from '../runtime/statewire-session-lane';\nimport { useAthenaStatewireThreadList } from '../threads/statewire-thread-list';\n\n/** The slice of the assistant-ui client the handoff writes to. */\nexport interface ComposerTarget {\n  composer: {\n    getState: () => { text: string };\n    setText: (text: string) => void;\n    send: (options?: { steer?: boolean }) => unknown;\n  };\n}\n\nexport interface ComposerWrite {\n  text: string;\n  /** Replace the draft instead of appending on a new line. */\n  replace: boolean;\n  /** Submit right after writing. */\n  send: boolean;\n  /** Put the caret at the end of the draft once the editor shows it. */\n  focus: boolean;\n  /** The statewire thread the write was made for; it drains only into that thread's mount. */\n  threadId: string | null;\n  /** Settled once the write has been applied (and, for `send`, with the send's outcome). */\n  resolve?: (outcome: Promise<void> | void) => void;\n  /** Settled with `composer_write_dropped` when the write can no longer land. */\n  reject?: (error: AthenaSdkError) => void;\n}\n\nexport interface ComposerHandoffStore {\n  /** Writes waiting for a ready composer, oldest first. Adjacent plain appends fold together. */\n  pending: ComposerWrite[];\n  /** Set by a `focus` write; the editor consumes it after mirroring the draft. */\n  focusOnNextMirror: boolean;\n  /** Registered by the mounted editor: place the caret at the end of the draft. */\n  focusEnd: (() => void) | null;\n  /** Set by `useFocusComposer` before the editor mounted; the editor consumes it when it does. */\n  focusOnMount: boolean;\n  /**\n   * Per thread, the attachments of messages the chat outbox gave back to the composer (Cancel, or\n   * Edit on one that couldn't be sent): files already in Athena, back in the draft as mentions. A\n   * message held again from that draft names those still in it, so the outbox asks Athena about\n   * them again before it goes ({@link rememberRestoredAttachments}, {@link takeRestoredAttachments}).\n   */\n  restoredAttachments?: Map<string, ChatOutboxAttachment[]>;\n}\n\nexport function createComposerHandoffStore(): ComposerHandoffStore {\n  return {\n    pending: [],\n    focusOnNextMirror: false,\n    focusEnd: null,\n    focusOnMount: false,\n    restoredAttachments: new Map(),\n  };\n}\n\n/** A held message given back to `threadId`'s composer: remember the attachments it carried. */\nexport function rememberRestoredAttachments({\n  store,\n  threadId,\n  attachments,\n}: {\n  store: ComposerHandoffStore;\n  threadId: string;\n  attachments: readonly ChatOutboxAttachment[];\n}): void {\n  if (attachments.length === 0) return;\n  store.restoredAttachments ??= new Map();\n  const kept = store.restoredAttachments.get(threadId) ?? [];\n  const known = new Set(kept.map((attachment) => attachment.assetId));\n  store.restoredAttachments.set(threadId, [\n    ...kept,\n    ...attachments.filter((attachment) => !known.has(attachment.assetId)),\n  ]);\n}\n\n/**\n * The remembered attachments of `threadId`'s draft whose mentions it still holds, for the message\n * leaving it now; the composer forgets them all (sent, held again, or removed from the draft).\n */\nexport function takeRestoredAttachments({\n  store,\n  threadId,\n  assetIdsInDraft,\n}: {\n  store: ComposerHandoffStore | null;\n  threadId: string;\n  assetIdsInDraft: ReadonlySet<string>;\n}): ChatOutboxAttachment[] {\n  const kept = store?.restoredAttachments?.get(threadId);\n  if (!kept) return [];\n  store?.restoredAttachments?.delete(threadId);\n  return kept.filter((attachment) => assetIdsInDraft.has(attachment.assetId));\n}\n\nexport const ComposerHandoffContext = createContext<ComposerHandoffStore | null>(null);\n\n/** The provider's handoff store, or null outside `AthenaProvider`. */\nexport function useComposerHandoffStore(): ComposerHandoffStore | null {\n  return useContext(ComposerHandoffContext);\n}\n\n/**\n * Puts the caret at the end of the composer's draft and leaves the draft as it is; asked before the\n * editor has mounted, it focuses the editor as it mounts. For a host that shows the chat again and\n * wants typing to land in it (a launcher window a shortcut brings back).\n */\nexport function useFocusComposer(): () => void {\n  const store = useComposerHandoffStore();\n  return useCallback(() => {\n    if (store) focusComposer({ store });\n  }, [store]);\n}\n\n/** The caret to the end of the draft now, or, with no editor mounted yet, as one mounts. */\nexport function focusComposer({ store }: { store: ComposerHandoffStore }): void {\n  if (store.focusEnd) store.focusEnd();\n  else store.focusOnMount = true;\n}\n\n/**\n * Whether a composer write lands now: in thread-list mode the list has\n * resolved which thread is active, that thread's history has loaded, and the\n * chat's session lane is known (the sign-in provider above has resolved who is\n * signed in; see `StatewireSessionLane`). Until then the composer the hooks\n * write to is the one of a mount that is about to be replaced, and the draft\n * goes with it, or a send would go into a parked lane that refuses it unsent.\n *\n * Deliberately not the socket status: a never-started chat sits in\n * `standby` until its first send and must still take a prefill.\n */\nexport function useComposerReady(): boolean {\n  const list = useAthenaStatewireThreadList();\n  const threadLoading = useAuiState((s) => s.optional.thread?.isLoading ?? false);\n  const lanePending = useStatewireSessionLanePending();\n  return !(list?.isLoading ?? false) && !threadLoading && !lanePending;\n}\n\n/** The draft after `write`: `replace` (or an empty draft) takes the text as is. */\nexport function mergeComposerDraft({\n  current,\n  write,\n}: {\n  current: string;\n  write: Pick<ComposerWrite, 'text' | 'replace'>;\n}): string {\n  if (write.replace || !current) return write.text;\n  return `${current}\\n${write.text}`;\n}\n\n/**\n * Write into the live composer. Returns the send's outcome for a `send`\n * write so callers can await it.\n */\nexport function applyComposerWrite({\n  target,\n  store,\n  write,\n}: {\n  target: ComposerTarget;\n  store: ComposerHandoffStore | null;\n  write: ComposerWrite;\n}): Promise<void> | void {\n  const current = target.composer.getState().text ?? '';\n  const next = mergeComposerDraft({ current, write });\n  target.composer.setText(next);\n  if (write.focus && store) {\n    // An unchanged draft never re-mirrors, so focus at once; otherwise the\n    // editor focuses itself right after it has shown the new text.\n    if (next === current) store.focusEnd?.();\n    else store.focusOnNextMirror = true;\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'applied', send: write.send, focus: write.focus, chars: next.length },\n  });\n  if (write.send) {\n    return Promise.resolve(target.composer.send({ steer: false })).then(() => undefined);\n  }\n  return undefined;\n}\n\n/**\n * Hold a write until the composer is ready. Writes keep their order; a plain\n * append folds into a directly preceding plain append for the same thread\n * (one draft, not two), while a replace or a send is kept as its own step so\n * no message is lost and every send settles on its own.\n */\nexport function queueComposerWrite({\n  store,\n  write,\n}: {\n  store: ComposerHandoffStore;\n  write: ComposerWrite;\n}): void {\n  const last = store.pending[store.pending.length - 1];\n  const foldable =\n    last !== undefined &&\n    !last.send &&\n    !write.send &&\n    !write.replace &&\n    last.threadId === write.threadId &&\n    last.resolve === undefined &&\n    write.resolve === undefined;\n  if (foldable) {\n    last.text = mergeComposerDraft({ current: last.text, write });\n    last.focus = last.focus || write.focus;\n  } else {\n    store.pending.push(write);\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'deferred', send: write.send, focus: write.focus, queued: store.pending.length },\n  });\n}\n\nfunction dropWrite({ write, reason }: { write: ComposerWrite; reason: string }): void {\n  const error = new AthenaSdkError({\n    code: 'composer_write_dropped',\n    message: `A composer ${write.send ? 'send' : 'draft'} queued before the chat was ready was dropped: ${reason}.`,\n    hint: 'Make the write again from the chat that is active now.',\n    context: { threadId: write.threadId, send: write.send },\n  });\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'warn',\n    error,\n    data: { phase: 'dropped', send: write.send, reason, threadId: write.threadId },\n  });\n  write.reject?.(error);\n}\n\n/**\n * Deliver the pending writes, in order, into a now-ready composer. A write\n * made for another thread is dropped (rejected), never applied here.\n */\nexport function drainComposerHandoff({\n  store,\n  target,\n  threadId,\n}: {\n  store: ComposerHandoffStore;\n  target: ComposerTarget;\n  /** The statewire thread of the mount that is draining. */\n  threadId: string | null;\n}): void {\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) {\n    if (write.threadId !== null && threadId !== null && write.threadId !== threadId) {\n      dropWrite({ write, reason: `it was made for thread ${write.threadId}, thread ${threadId} is active` });\n      continue;\n    }\n    const outcome = applyComposerWrite({ target, store, write });\n    write.resolve?.(outcome);\n  }\n}\n\n/** Drop every pending write (identity changed, provider unmounted). */\nexport function clearComposerHandoff({\n  store,\n  reason,\n}: {\n  store: ComposerHandoffStore;\n  reason: string;\n}): void {\n  // Another identity, or no provider: the attachments given back belong to drafts that are gone.\n  store.restoredAttachments?.clear();\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) dropWrite({ write, reason });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"composer-handoff.js","sources":["../../src/composer/composer-handoff.ts"],"sourcesContent":["/**\n * Composer handoff: writes to the chat composer from host UI that lives\n * outside `<AthenaChat>` (a sidebar, an agenda card, a workflow button).\n *\n * Two problems it solves for `useAppendToComposer` / `useSendMessage`:\n *\n * 1. A write before the chat is ready is lost. While the thread list is still\n *    resolving the active thread, or the thread's history is still loading,\n *    the composer the hooks write to belongs to a mount that is about to be\n *    replaced (thread-list mode keys the statewire subtree by thread), and\n *    the draft goes with it. The store below lives ABOVE that mount, so a\n *    write made too early waits here and the ready mount drains it.\n * 2. A prefilled draft should put the caret after the text so the user can\n *    keep typing or dictating. The Tiptap editor mirrors runtime text on a\n *    later tick; the `focusOnNextMirror` flag asks it to focus at the end\n *    right after that mirror lands, instead of the host guessing a delay.\n *\n * Every queued write is bound to the statewire thread it was made for and\n * drains only into that thread's mount; a thread switch, an identity change\n * or a provider unmount drops what waits with a `composer_write_dropped`\n * error, never into another user's or another thread's composer.\n */\nimport { createContext, useCallback, useContext } from 'react';\nimport { useAuiState } from '@assistant-ui/react';\nimport { autoComposerSendOptions, type ChatOutboxAttachment } from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport { useStatewireSessionLanePending } from '../runtime/statewire-session-lane';\nimport { useAthenaStatewireThreadList } from '../threads/statewire-thread-list';\n\n/** The slice of the assistant-ui client the handoff writes to. */\nexport interface ComposerTarget {\n  composer: {\n    getState: () => { text: string };\n    setText: (text: string) => void;\n    send: (options?: { steer?: boolean }) => unknown;\n  };\n  /** The thread the composer sends into; its running state picks the `auto` send. */\n  thread?: () => { getState: () => { isRunning: boolean } };\n}\n\nexport interface ComposerWrite {\n  text: string;\n  /** Replace the draft instead of appending on a new line. */\n  replace: boolean;\n  /** Submit right after writing. */\n  send: boolean;\n  /** Put the caret at the end of the draft once the editor shows it. */\n  focus: boolean;\n  /** The statewire thread the write was made for; it drains only into that thread's mount. */\n  threadId: string | null;\n  /** Settled once the write has been applied (and, for `send`, with the send's outcome). */\n  resolve?: (outcome: Promise<void> | void) => void;\n  /** Settled with `composer_write_dropped` when the write can no longer land. */\n  reject?: (error: AthenaSdkError) => void;\n}\n\nexport interface ComposerHandoffStore {\n  /** Writes waiting for a ready composer, oldest first. Adjacent plain appends fold together. */\n  pending: ComposerWrite[];\n  /** Set by a `focus` write; the editor consumes it after mirroring the draft. */\n  focusOnNextMirror: boolean;\n  /** Registered by the mounted editor: place the caret at the end of the draft. */\n  focusEnd: (() => void) | null;\n  /** Set by `useFocusComposer` before the editor mounted; the editor consumes it when it does. */\n  focusOnMount: boolean;\n  /**\n   * Per thread, the attachments of messages the chat outbox gave back to the composer (Cancel, or\n   * Edit on one that couldn't be sent): files already in Athena, back in the draft as mentions. A\n   * message held again from that draft names those still in it, so the outbox asks Athena about\n   * them again before it goes ({@link rememberRestoredAttachments}, {@link takeRestoredAttachments}).\n   */\n  restoredAttachments?: Map<string, ChatOutboxAttachment[]>;\n}\n\nexport function createComposerHandoffStore(): ComposerHandoffStore {\n  return {\n    pending: [],\n    focusOnNextMirror: false,\n    focusEnd: null,\n    focusOnMount: false,\n    restoredAttachments: new Map(),\n  };\n}\n\n/** A held message given back to `threadId`'s composer: remember the attachments it carried. */\nexport function rememberRestoredAttachments({\n  store,\n  threadId,\n  attachments,\n}: {\n  store: ComposerHandoffStore;\n  threadId: string;\n  attachments: readonly ChatOutboxAttachment[];\n}): void {\n  if (attachments.length === 0) return;\n  store.restoredAttachments ??= new Map();\n  const kept = store.restoredAttachments.get(threadId) ?? [];\n  const known = new Set(kept.map((attachment) => attachment.assetId));\n  store.restoredAttachments.set(threadId, [\n    ...kept,\n    ...attachments.filter((attachment) => !known.has(attachment.assetId)),\n  ]);\n}\n\n/**\n * The remembered attachments of `threadId`'s draft whose mentions it still holds, for the message\n * leaving it now; the composer forgets them all (sent, held again, or removed from the draft).\n */\nexport function takeRestoredAttachments({\n  store,\n  threadId,\n  assetIdsInDraft,\n}: {\n  store: ComposerHandoffStore | null;\n  threadId: string;\n  assetIdsInDraft: ReadonlySet<string>;\n}): ChatOutboxAttachment[] {\n  const kept = store?.restoredAttachments?.get(threadId);\n  if (!kept) return [];\n  store?.restoredAttachments?.delete(threadId);\n  return kept.filter((attachment) => assetIdsInDraft.has(attachment.assetId));\n}\n\nexport const ComposerHandoffContext = createContext<ComposerHandoffStore | null>(null);\n\n/** The provider's handoff store, or null outside `AthenaProvider`. */\nexport function useComposerHandoffStore(): ComposerHandoffStore | null {\n  return useContext(ComposerHandoffContext);\n}\n\n/**\n * Puts the caret at the end of the composer's draft and leaves the draft as it is; asked before the\n * editor has mounted, it focuses the editor as it mounts. For a host that shows the chat again and\n * wants typing to land in it (a launcher window a shortcut brings back).\n */\nexport function useFocusComposer(): () => void {\n  const store = useComposerHandoffStore();\n  return useCallback(() => {\n    if (store) focusComposer({ store });\n  }, [store]);\n}\n\n/** The caret to the end of the draft now, or, with no editor mounted yet, as one mounts. */\nexport function focusComposer({ store }: { store: ComposerHandoffStore }): void {\n  if (store.focusEnd) store.focusEnd();\n  else store.focusOnMount = true;\n}\n\n/**\n * Whether a composer write lands now: in thread-list mode the list has\n * resolved which thread is active, that thread's history has loaded, and the\n * chat's session lane is known (the sign-in provider above has resolved who is\n * signed in; see `StatewireSessionLane`). Until then the composer the hooks\n * write to is the one of a mount that is about to be replaced, and the draft\n * goes with it, or a send would go into a parked lane that refuses it unsent.\n *\n * Deliberately not the socket status: a never-started chat sits in\n * `standby` until its first send and must still take a prefill.\n */\nexport function useComposerReady(): boolean {\n  const list = useAthenaStatewireThreadList();\n  const threadLoading = useAuiState((s) => s.optional.thread?.isLoading ?? false);\n  const lanePending = useStatewireSessionLanePending();\n  return !(list?.isLoading ?? false) && !threadLoading && !lanePending;\n}\n\n/** The draft after `write`: `replace` (or an empty draft) takes the text as is. */\nexport function mergeComposerDraft({\n  current,\n  write,\n}: {\n  current: string;\n  write: Pick<ComposerWrite, 'text' | 'replace'>;\n}): string {\n  if (write.replace || !current) return write.text;\n  return `${current}\\n${write.text}`;\n}\n\n/**\n * Write into the live composer. Returns the send's outcome for a `send`\n * write so callers can await it.\n */\nexport function applyComposerWrite({\n  target,\n  store,\n  write,\n}: {\n  target: ComposerTarget;\n  store: ComposerHandoffStore | null;\n  write: ComposerWrite;\n}): Promise<void> | void {\n  const current = target.composer.getState().text ?? '';\n  const next = mergeComposerDraft({ current, write });\n  target.composer.setText(next);\n  if (write.focus && store) {\n    // An unchanged draft never re-mirrors, so focus at once; otherwise the\n    // editor focuses itself right after it has shown the new text.\n    if (next === current) store.focusEnd?.();\n    else store.focusOnNextMirror = true;\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'applied', send: write.send, focus: write.focus, chars: next.length },\n  });\n  if (write.send) {\n    const isRunning = target.thread?.().getState().isRunning ?? false;\n    return Promise.resolve(target.composer.send(autoComposerSendOptions(isRunning))).then(\n      () => undefined,\n    );\n  }\n  return undefined;\n}\n\n/**\n * Hold a write until the composer is ready. Writes keep their order; a plain\n * append folds into a directly preceding plain append for the same thread\n * (one draft, not two), while a replace or a send is kept as its own step so\n * no message is lost and every send settles on its own.\n */\nexport function queueComposerWrite({\n  store,\n  write,\n}: {\n  store: ComposerHandoffStore;\n  write: ComposerWrite;\n}): void {\n  const last = store.pending[store.pending.length - 1];\n  const foldable =\n    last !== undefined &&\n    !last.send &&\n    !write.send &&\n    !write.replace &&\n    last.threadId === write.threadId &&\n    last.resolve === undefined &&\n    write.resolve === undefined;\n  if (foldable) {\n    last.text = mergeComposerDraft({ current: last.text, write });\n    last.focus = last.focus || write.focus;\n  } else {\n    store.pending.push(write);\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'deferred', send: write.send, focus: write.focus, queued: store.pending.length },\n  });\n}\n\nfunction dropWrite({ write, reason }: { write: ComposerWrite; reason: string }): void {\n  const error = new AthenaSdkError({\n    code: 'composer_write_dropped',\n    message: `A composer ${write.send ? 'send' : 'draft'} queued before the chat was ready was dropped: ${reason}.`,\n    hint: 'Make the write again from the chat that is active now.',\n    context: { threadId: write.threadId, send: write.send },\n  });\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'warn',\n    error,\n    data: { phase: 'dropped', send: write.send, reason, threadId: write.threadId },\n  });\n  write.reject?.(error);\n}\n\n/**\n * Deliver the pending writes, in order, into a now-ready composer. A write\n * made for another thread is dropped (rejected), never applied here.\n */\nexport function drainComposerHandoff({\n  store,\n  target,\n  threadId,\n}: {\n  store: ComposerHandoffStore;\n  target: ComposerTarget;\n  /** The statewire thread of the mount that is draining. */\n  threadId: string | null;\n}): void {\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) {\n    if (write.threadId !== null && threadId !== null && write.threadId !== threadId) {\n      dropWrite({ write, reason: `it was made for thread ${write.threadId}, thread ${threadId} is active` });\n      continue;\n    }\n    const outcome = applyComposerWrite({ target, store, write });\n    write.resolve?.(outcome);\n  }\n}\n\n/** Drop every pending write (identity changed, provider unmounted). */\nexport function clearComposerHandoff({\n  store,\n  reason,\n}: {\n  store: ComposerHandoffStore;\n  reason: string;\n}): void {\n  // Another identity, or no provider: the attachments given back belong to drafts that are gone.\n  store.restoredAttachments?.clear();\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) dropWrite({ write, reason });\n}\n"],"names":[],"mappings":"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"}

package/dist/composer/folder-upload.cjs

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const apiClient = require("../chat-ui/mentions/suggestions/data/api-client.cjs");
+const FOLDER_UPLOAD_PATH = "/api/upload/async";
+const FOLDER_UPLOAD_DEADLINE_MS = 15 * 60 * 1e3;
+const FOLDER_UPLOAD_POLL_MIN_MS = 250;
+const FOLDER_UPLOAD_POLL_MAX_MS = 2e3;
+const ASYNC_UPLOAD_TASK_QUERY = `
+  query AthenaAsyncUploadTask($taskId: String!) {
+    asyncUploadTask(taskId: $taskId) {
+      taskId
+      status
+      requestedCount
+      processedCount
+      uploadedCount
+      failedCount
+      message
+      results {
+        fileIndex
+        filename
+        status
+        message
+        assetId
+      }
+    }
+  }
+`;
+const ENDED = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
+function folderUploadPollDelayMs(attempt) {
+  return Math.min(FOLDER_UPLOAD_POLL_MIN_MS * 2 ** attempt, FOLDER_UPLOAD_POLL_MAX_MS);
+}
+function folderUploadForm({
+  files,
+  parentFolderId
+}) {
+  const form = new FormData();
+  for (const file of files) form.append("files", file, file.name);
+  form.append("parent_folder_id", parentFolderId);
+  return form;
+}
+function taskIdOf(body) {
+  const camel = Reflect.get(Object(body), "taskId");
+  if (typeof camel === "string" && camel) return camel;
+  const snake = Reflect.get(Object(body), "task_id");
+  return typeof snake === "string" && snake ? snake : null;
+}
+async function refusalDetail(response) {
+  const body = await response.json().catch(() => null);
+  const detail = Reflect.get(Object(body), "detail");
+  return typeof detail === "string" && detail ? detail : null;
+}
+function folderUploadResultOf({
+  task,
+  files
+}) {
+  const uploaded = [];
+  const failed = [];
+  const answered = /* @__PURE__ */ new Set();
+  for (const result of task.results) {
+    answered.add(result.fileIndex);
+    const file = files[result.fileIndex];
+    if (result.status === "uploaded" && result.assetId) {
+      uploaded.push({
+        id: result.assetId,
+        title: result.filename,
+        fileName: result.filename,
+        fileSize: (file == null ? void 0 : file.size) ?? 0,
+        mediaType: (file == null ? void 0 : file.type) || "application/octet-stream",
+        fileIndex: result.fileIndex
+      });
+    } else {
+      failed.push({ fileName: result.filename, error: result.message || "Upload failed" });
+    }
+  }
+  files.forEach((file, index) => {
+    if (answered.has(index)) return;
+    failed.push({ fileName: file.name, error: task.message || `Upload ${task.status}` });
+  });
+  return { uploaded, failed };
+}
+function wait(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal == null ? void 0 : signal.aborted) {
+      reject(new DOMException("Upload cancelled", "AbortError"));
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(new DOMException("Upload cancelled", "AbortError"));
+    };
+    signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function waitForFolderUploadTask({
+  auth,
+  taskId,
+  signal,
+  deadlineMs = FOLDER_UPLOAD_DEADLINE_MS,
+  now = Date.now,
+  sleep = (ms) => wait(ms, signal)
+}) {
+  const startedAt = now();
+  for (let attempt = 0; ; attempt += 1) {
+    const data = await apiClient.fetchGraphQL(
+      auth,
+      ASYNC_UPLOAD_TASK_QUERY,
+      { taskId },
+      { signal }
+    );
+    const task = data.asyncUploadTask;
+    if (!task) throw new Error("Athena no longer knows this upload.");
+    if (ENDED.has(task.status)) return task;
+    if (now() - startedAt >= deadlineMs) {
+      throw new Error("The upload is taking too long; it may still finish in Athena.");
+    }
+    await sleep(folderUploadPollDelayMs(attempt));
+  }
+}
+async function startFolderUpload({
+  send,
+  files,
+  parentFolderId
+}) {
+  const response = await send(folderUploadForm({ files, parentFolderId }));
+  if (!response.ok) {
+    const detail = await refusalDetail(response);
+    if (response.status === 401 || response.status === 403) {
+      throw new Error(detail ?? "You can’t add files to this folder.");
+    }
+    if (response.status === 404) throw new Error(detail ?? "That folder is no longer there.");
+    throw new Error(detail ?? `Upload failed with status ${response.status}`);
+  }
+  const taskId = taskIdOf(await response.json().catch(() => null));
+  if (!taskId) throw new Error("Athena did not start the upload.");
+  return taskId;
+}
+exports.ASYNC_UPLOAD_TASK_QUERY = ASYNC_UPLOAD_TASK_QUERY;
+exports.FOLDER_UPLOAD_DEADLINE_MS = FOLDER_UPLOAD_DEADLINE_MS;
+exports.FOLDER_UPLOAD_PATH = FOLDER_UPLOAD_PATH;
+exports.folderUploadForm = folderUploadForm;
+exports.folderUploadPollDelayMs = folderUploadPollDelayMs;
+exports.folderUploadResultOf = folderUploadResultOf;
+exports.startFolderUpload = startFolderUpload;
+exports.waitForFolderUploadTask = waitForFolderUploadTask;
+//# sourceMappingURL=folder-upload.cjs.map

package/dist/composer/folder-upload.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-upload.cjs","sources":["../../src/composer/folder-upload.ts"],"sourcesContent":["/**\n * Uploading files into a folder. agora's quick upload (`POST /api/upload/`) files what it takes at\n * the workspace's root; its async upload (`POST /api/upload/async`) takes a destination,\n * `parent_folder_id`, and authorizes EDIT on that folder before it stages a byte\n * (`_require_upload_destination`: the folder's permission check, then its ABAC edit gate), so a\n * folder the person may only view, or may not open, refuses the whole upload. The task it starts is\n * then read through GraphQL (`asyncUploadTask`, answered only for the caller's current workspace)\n * until it ends, at most `FOLDER_UPLOAD_DEADLINE_MS`.\n */\nimport {\n  fetchGraphQL,\n  type MentionAuthContext,\n} from '../chat-ui/mentions/suggestions/data/api-client';\nimport type { UploadedAsset } from './useFileUpload';\n\n/** agora's async upload route, under the API base. */\nexport const FOLDER_UPLOAD_PATH = '/api/upload/async';\n\n/** How long an upload's task is read before the upload gives up on it (it may still finish). */\nexport const FOLDER_UPLOAD_DEADLINE_MS = 15 * 60 * 1000;\n/** The first wait before the task is read again, doubling to `FOLDER_UPLOAD_POLL_MAX_MS`. */\nconst FOLDER_UPLOAD_POLL_MIN_MS = 250;\nconst FOLDER_UPLOAD_POLL_MAX_MS = 2_000;\n\nexport const ASYNC_UPLOAD_TASK_QUERY = `\n  query AthenaAsyncUploadTask($taskId: String!) {\n    asyncUploadTask(taskId: $taskId) {\n      taskId\n      status\n      requestedCount\n      processedCount\n      uploadedCount\n      failedCount\n      message\n      results {\n        fileIndex\n        filename\n        status\n        message\n        assetId\n      }\n    }\n  }\n`;\n\n/** The states an upload task ends in. */\nconst ENDED: ReadonlySet<string> = new Set(['completed', 'failed', 'cancelled']);\n\nexport interface FolderUploadTask {\n  taskId: string;\n  status: string;\n  requestedCount: number;\n  processedCount: number;\n  uploadedCount: number;\n  failedCount: number;\n  message: string | null;\n  results: Array<{\n    fileIndex: number;\n    filename: string;\n    status: string;\n    message: string;\n    assetId: string | null;\n  }>;\n}\n\n/** What an upload into a folder made, and what it could not. */\nexport interface FolderUploadResult {\n  uploaded: UploadedAsset[];\n  failed: Array<{ fileName: string; error: string }>;\n}\n\n/** The wait before the `attempt`th read of the task (0-indexed), doubling to its cap. */\nexport function folderUploadPollDelayMs(attempt: number): number {\n  return Math.min(FOLDER_UPLOAD_POLL_MIN_MS * 2 ** attempt, FOLDER_UPLOAD_POLL_MAX_MS);\n}\n\n/** The upload's form: every file, and the folder they go into. */\nexport function folderUploadForm({\n  files,\n  parentFolderId,\n}: {\n  files: readonly File[];\n  parentFolderId: string;\n}): FormData {\n  const form = new FormData();\n  for (const file of files) form.append('files', file, file.name);\n  form.append('parent_folder_id', parentFolderId);\n  return form;\n}\n\n/** The task id agora's answer names (`taskId`; `task_id` from an agora that answers snake_case). */\nfunction taskIdOf(body: unknown): string | null {\n  const camel: unknown = Reflect.get(Object(body), 'taskId');\n  if (typeof camel === 'string' && camel) return camel;\n  const snake: unknown = Reflect.get(Object(body), 'task_id');\n  return typeof snake === 'string' && snake ? snake : null;\n}\n\n/** agora's `detail` for a refused upload, when it gave one. */\nasync function refusalDetail(response: Response): Promise<string | null> {\n  const body: unknown = await response.json().catch(() => null);\n  const detail: unknown = Reflect.get(Object(body), 'detail');\n  return typeof detail === 'string' && detail ? detail : null;\n}\n\n/**\n * What the task made, file by file: each uploaded file as the asset it became (named and sized\n * from the file sent), each failed one with agora's reason, and a task that ended without a result\n * for a file (cancelled, or failed as a whole) with the task's message.\n */\nexport function folderUploadResultOf({\n  task,\n  files,\n}: {\n  task: FolderUploadTask;\n  files: readonly File[];\n}): FolderUploadResult {\n  const uploaded: UploadedAsset[] = [];\n  const failed: FolderUploadResult['failed'] = [];\n  const answered = new Set<number>();\n  for (const result of task.results) {\n    answered.add(result.fileIndex);\n    const file = files[result.fileIndex];\n    if (result.status === 'uploaded' && result.assetId) {\n      uploaded.push({\n        id: result.assetId,\n        title: result.filename,\n        fileName: result.filename,\n        fileSize: file?.size ?? 0,\n        mediaType: file?.type || 'application/octet-stream',\n        fileIndex: result.fileIndex,\n      });\n    } else {\n      failed.push({ fileName: result.filename, error: result.message || 'Upload failed' });\n    }\n  }\n  files.forEach((file, index) => {\n    if (answered.has(index)) return;\n    failed.push({ fileName: file.name, error: task.message || `Upload ${task.status}` });\n  });\n  return { uploaded, failed };\n}\n\n/** Waits `ms`, or rejects at once when `signal` aborts. */\nfunction wait(ms: number, signal: AbortSignal | undefined): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new DOMException('Upload cancelled', 'AbortError'));\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new DOMException('Upload cancelled', 'AbortError'));\n    };\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\n/**\n * Reads the task until it ends: at once, then after waits that double from 250 ms to 2 s. A task\n * agora no longer names (another workspace, or gone) and one that has not ended by the deadline\n * fail the upload; what the task did by then stays done.\n */\nexport async function waitForFolderUploadTask({\n  auth,\n  taskId,\n  signal,\n  deadlineMs = FOLDER_UPLOAD_DEADLINE_MS,\n  now = Date.now,\n  sleep = (ms) => wait(ms, signal),\n}: {\n  auth: MentionAuthContext;\n  taskId: string;\n  signal?: AbortSignal;\n  deadlineMs?: number;\n  now?: () => number;\n  sleep?: (ms: number) => Promise<void>;\n}): Promise<FolderUploadTask> {\n  const startedAt = now();\n  for (let attempt = 0; ; attempt += 1) {\n    const data = await fetchGraphQL<{ asyncUploadTask: FolderUploadTask | null }>(\n      auth,\n      ASYNC_UPLOAD_TASK_QUERY,\n      { taskId },\n      { signal },\n    );\n    const task = data.asyncUploadTask;\n    if (!task) throw new Error('Athena no longer knows this upload.');\n    if (ENDED.has(task.status)) return task;\n    if (now() - startedAt >= deadlineMs) {\n      throw new Error('The upload is taking too long; it may still finish in Athena.');\n    }\n    await sleep(folderUploadPollDelayMs(attempt));\n  }\n}\n\n/**\n * Starts an upload of `files` into `parentFolderId` (agora's async upload, which refuses a folder\n * the caller may not edit before it takes any file), as `send` posts it, and answers its task id.\n */\nexport async function startFolderUpload({\n  send,\n  files,\n  parentFolderId,\n}: {\n  /** Posts the form to `FOLDER_UPLOAD_PATH` with the credential (and the byte progress). */\n  send: (form: FormData) => Promise<Response>;\n  files: readonly File[];\n  parentFolderId: string;\n}): Promise<string> {\n  const response = await send(folderUploadForm({ files, parentFolderId }));\n  if (!response.ok) {\n    const detail = await refusalDetail(response);\n    if (response.status === 401 || response.status === 403) {\n      throw new Error(detail ?? 'You can’t add files to this folder.');\n    }\n    if (response.status === 404) throw new Error(detail ?? 'That folder is no longer there.');\n    throw new Error(detail ?? `Upload failed with status ${response.status}`);\n  }\n  const taskId = taskIdOf(await response.json().catch(() => null));\n  if (!taskId) throw new Error('Athena did not start the upload.');\n  return taskId;\n}\n"],"names":["fetchGraphQL"],"mappings":"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"}

package/dist/composer/folder-upload.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Uploading files into a folder. agora's quick upload (`POST /api/upload/`) files what it takes at
+ * the workspace's root; its async upload (`POST /api/upload/async`) takes a destination,
+ * `parent_folder_id`, and authorizes EDIT on that folder before it stages a byte
+ * (`_require_upload_destination`: the folder's permission check, then its ABAC edit gate), so a
+ * folder the person may only view, or may not open, refuses the whole upload. The task it starts is
+ * then read through GraphQL (`asyncUploadTask`, answered only for the caller's current workspace)
+ * until it ends, at most `FOLDER_UPLOAD_DEADLINE_MS`.
+ */
+import { type MentionAuthContext } from '../chat-ui/mentions/suggestions/data/api-client';
+import type { UploadedAsset } from './useFileUpload';
+/** agora's async upload route, under the API base. */
+export declare const FOLDER_UPLOAD_PATH = "/api/upload/async";
+/** How long an upload's task is read before the upload gives up on it (it may still finish). */
+export declare const FOLDER_UPLOAD_DEADLINE_MS: number;
+export declare const ASYNC_UPLOAD_TASK_QUERY = "\n  query AthenaAsyncUploadTask($taskId: String!) {\n    asyncUploadTask(taskId: $taskId) {\n      taskId\n      status\n      requestedCount\n      processedCount\n      uploadedCount\n      failedCount\n      message\n      results {\n        fileIndex\n        filename\n        status\n        message\n        assetId\n      }\n    }\n  }\n";
+export interface FolderUploadTask {
+    taskId: string;
+    status: string;
+    requestedCount: number;
+    processedCount: number;
+    uploadedCount: number;
+    failedCount: number;
+    message: string | null;
+    results: Array<{
+        fileIndex: number;
+        filename: string;
+        status: string;
+        message: string;
+        assetId: string | null;
+    }>;
+}
+/** What an upload into a folder made, and what it could not. */
+export interface FolderUploadResult {
+    uploaded: UploadedAsset[];
+    failed: Array<{
+        fileName: string;
+        error: string;
+    }>;
+}
+/** The wait before the `attempt`th read of the task (0-indexed), doubling to its cap. */
+export declare function folderUploadPollDelayMs(attempt: number): number;
+/** The upload's form: every file, and the folder they go into. */
+export declare function folderUploadForm({ files, parentFolderId, }: {
+    files: readonly File[];
+    parentFolderId: string;
+}): FormData;
+/**
+ * What the task made, file by file: each uploaded file as the asset it became (named and sized
+ * from the file sent), each failed one with agora's reason, and a task that ended without a result
+ * for a file (cancelled, or failed as a whole) with the task's message.
+ */
+export declare function folderUploadResultOf({ task, files, }: {
+    task: FolderUploadTask;
+    files: readonly File[];
+}): FolderUploadResult;
+/**
+ * Reads the task until it ends: at once, then after waits that double from 250 ms to 2 s. A task
+ * agora no longer names (another workspace, or gone) and one that has not ended by the deadline
+ * fail the upload; what the task did by then stays done.
+ */
+export declare function waitForFolderUploadTask({ auth, taskId, signal, deadlineMs, now, sleep, }: {
+    auth: MentionAuthContext;
+    taskId: string;
+    signal?: AbortSignal;
+    deadlineMs?: number;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<FolderUploadTask>;
+/**
+ * Starts an upload of `files` into `parentFolderId` (agora's async upload, which refuses a folder
+ * the caller may not edit before it takes any file), as `send` posts it, and answers its task id.
+ */
+export declare function startFolderUpload({ send, files, parentFolderId, }: {
+    /** Posts the form to `FOLDER_UPLOAD_PATH` with the credential (and the byte progress). */
+    send: (form: FormData) => Promise<Response>;
+    files: readonly File[];
+    parentFolderId: string;
+}): Promise<string>;

package/dist/composer/folder-upload.js

@@ -0,0 +1,149 @@
+import { fetchGraphQL } from "../chat-ui/mentions/suggestions/data/api-client.js";
+const FOLDER_UPLOAD_PATH = "/api/upload/async";
+const FOLDER_UPLOAD_DEADLINE_MS = 15 * 60 * 1e3;
+const FOLDER_UPLOAD_POLL_MIN_MS = 250;
+const FOLDER_UPLOAD_POLL_MAX_MS = 2e3;
+const ASYNC_UPLOAD_TASK_QUERY = `
+  query AthenaAsyncUploadTask($taskId: String!) {
+    asyncUploadTask(taskId: $taskId) {
+      taskId
+      status
+      requestedCount
+      processedCount
+      uploadedCount
+      failedCount
+      message
+      results {
+        fileIndex
+        filename
+        status
+        message
+        assetId
+      }
+    }
+  }
+`;
+const ENDED = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
+function folderUploadPollDelayMs(attempt) {
+  return Math.min(FOLDER_UPLOAD_POLL_MIN_MS * 2 ** attempt, FOLDER_UPLOAD_POLL_MAX_MS);
+}
+function folderUploadForm({
+  files,
+  parentFolderId
+}) {
+  const form = new FormData();
+  for (const file of files) form.append("files", file, file.name);
+  form.append("parent_folder_id", parentFolderId);
+  return form;
+}
+function taskIdOf(body) {
+  const camel = Reflect.get(Object(body), "taskId");
+  if (typeof camel === "string" && camel) return camel;
+  const snake = Reflect.get(Object(body), "task_id");
+  return typeof snake === "string" && snake ? snake : null;
+}
+async function refusalDetail(response) {
+  const body = await response.json().catch(() => null);
+  const detail = Reflect.get(Object(body), "detail");
+  return typeof detail === "string" && detail ? detail : null;
+}
+function folderUploadResultOf({
+  task,
+  files
+}) {
+  const uploaded = [];
+  const failed = [];
+  const answered = /* @__PURE__ */ new Set();
+  for (const result of task.results) {
+    answered.add(result.fileIndex);
+    const file = files[result.fileIndex];
+    if (result.status === "uploaded" && result.assetId) {
+      uploaded.push({
+        id: result.assetId,
+        title: result.filename,
+        fileName: result.filename,
+        fileSize: (file == null ? void 0 : file.size) ?? 0,
+        mediaType: (file == null ? void 0 : file.type) || "application/octet-stream",
+        fileIndex: result.fileIndex
+      });
+    } else {
+      failed.push({ fileName: result.filename, error: result.message || "Upload failed" });
+    }
+  }
+  files.forEach((file, index) => {
+    if (answered.has(index)) return;
+    failed.push({ fileName: file.name, error: task.message || `Upload ${task.status}` });
+  });
+  return { uploaded, failed };
+}
+function wait(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal == null ? void 0 : signal.aborted) {
+      reject(new DOMException("Upload cancelled", "AbortError"));
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(new DOMException("Upload cancelled", "AbortError"));
+    };
+    signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function waitForFolderUploadTask({
+  auth,
+  taskId,
+  signal,
+  deadlineMs = FOLDER_UPLOAD_DEADLINE_MS,
+  now = Date.now,
+  sleep = (ms) => wait(ms, signal)
+}) {
+  const startedAt = now();
+  for (let attempt = 0; ; attempt += 1) {
+    const data = await fetchGraphQL(
+      auth,
+      ASYNC_UPLOAD_TASK_QUERY,
+      { taskId },
+      { signal }
+    );
+    const task = data.asyncUploadTask;
+    if (!task) throw new Error("Athena no longer knows this upload.");
+    if (ENDED.has(task.status)) return task;
+    if (now() - startedAt >= deadlineMs) {
+      throw new Error("The upload is taking too long; it may still finish in Athena.");
+    }
+    await sleep(folderUploadPollDelayMs(attempt));
+  }
+}
+async function startFolderUpload({
+  send,
+  files,
+  parentFolderId
+}) {
+  const response = await send(folderUploadForm({ files, parentFolderId }));
+  if (!response.ok) {
+    const detail = await refusalDetail(response);
+    if (response.status === 401 || response.status === 403) {
+      throw new Error(detail ?? "You can’t add files to this folder.");
+    }
+    if (response.status === 404) throw new Error(detail ?? "That folder is no longer there.");
+    throw new Error(detail ?? `Upload failed with status ${response.status}`);
+  }
+  const taskId = taskIdOf(await response.json().catch(() => null));
+  if (!taskId) throw new Error("Athena did not start the upload.");
+  return taskId;
+}
+export {
+  ASYNC_UPLOAD_TASK_QUERY,
+  FOLDER_UPLOAD_DEADLINE_MS,
+  FOLDER_UPLOAD_PATH,
+  folderUploadForm,
+  folderUploadPollDelayMs,
+  folderUploadResultOf,
+  startFolderUpload,
+  waitForFolderUploadTask
+};
+//# sourceMappingURL=folder-upload.js.map

package/dist/composer/folder-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-upload.js","sources":["../../src/composer/folder-upload.ts"],"sourcesContent":["/**\n * Uploading files into a folder. agora's quick upload (`POST /api/upload/`) files what it takes at\n * the workspace's root; its async upload (`POST /api/upload/async`) takes a destination,\n * `parent_folder_id`, and authorizes EDIT on that folder before it stages a byte\n * (`_require_upload_destination`: the folder's permission check, then its ABAC edit gate), so a\n * folder the person may only view, or may not open, refuses the whole upload. The task it starts is\n * then read through GraphQL (`asyncUploadTask`, answered only for the caller's current workspace)\n * until it ends, at most `FOLDER_UPLOAD_DEADLINE_MS`.\n */\nimport {\n  fetchGraphQL,\n  type MentionAuthContext,\n} from '../chat-ui/mentions/suggestions/data/api-client';\nimport type { UploadedAsset } from './useFileUpload';\n\n/** agora's async upload route, under the API base. */\nexport const FOLDER_UPLOAD_PATH = '/api/upload/async';\n\n/** How long an upload's task is read before the upload gives up on it (it may still finish). */\nexport const FOLDER_UPLOAD_DEADLINE_MS = 15 * 60 * 1000;\n/** The first wait before the task is read again, doubling to `FOLDER_UPLOAD_POLL_MAX_MS`. */\nconst FOLDER_UPLOAD_POLL_MIN_MS = 250;\nconst FOLDER_UPLOAD_POLL_MAX_MS = 2_000;\n\nexport const ASYNC_UPLOAD_TASK_QUERY = `\n  query AthenaAsyncUploadTask($taskId: String!) {\n    asyncUploadTask(taskId: $taskId) {\n      taskId\n      status\n      requestedCount\n      processedCount\n      uploadedCount\n      failedCount\n      message\n      results {\n        fileIndex\n        filename\n        status\n        message\n        assetId\n      }\n    }\n  }\n`;\n\n/** The states an upload task ends in. */\nconst ENDED: ReadonlySet<string> = new Set(['completed', 'failed', 'cancelled']);\n\nexport interface FolderUploadTask {\n  taskId: string;\n  status: string;\n  requestedCount: number;\n  processedCount: number;\n  uploadedCount: number;\n  failedCount: number;\n  message: string | null;\n  results: Array<{\n    fileIndex: number;\n    filename: string;\n    status: string;\n    message: string;\n    assetId: string | null;\n  }>;\n}\n\n/** What an upload into a folder made, and what it could not. */\nexport interface FolderUploadResult {\n  uploaded: UploadedAsset[];\n  failed: Array<{ fileName: string; error: string }>;\n}\n\n/** The wait before the `attempt`th read of the task (0-indexed), doubling to its cap. */\nexport function folderUploadPollDelayMs(attempt: number): number {\n  return Math.min(FOLDER_UPLOAD_POLL_MIN_MS * 2 ** attempt, FOLDER_UPLOAD_POLL_MAX_MS);\n}\n\n/** The upload's form: every file, and the folder they go into. */\nexport function folderUploadForm({\n  files,\n  parentFolderId,\n}: {\n  files: readonly File[];\n  parentFolderId: string;\n}): FormData {\n  const form = new FormData();\n  for (const file of files) form.append('files', file, file.name);\n  form.append('parent_folder_id', parentFolderId);\n  return form;\n}\n\n/** The task id agora's answer names (`taskId`; `task_id` from an agora that answers snake_case). */\nfunction taskIdOf(body: unknown): string | null {\n  const camel: unknown = Reflect.get(Object(body), 'taskId');\n  if (typeof camel === 'string' && camel) return camel;\n  const snake: unknown = Reflect.get(Object(body), 'task_id');\n  return typeof snake === 'string' && snake ? snake : null;\n}\n\n/** agora's `detail` for a refused upload, when it gave one. */\nasync function refusalDetail(response: Response): Promise<string | null> {\n  const body: unknown = await response.json().catch(() => null);\n  const detail: unknown = Reflect.get(Object(body), 'detail');\n  return typeof detail === 'string' && detail ? detail : null;\n}\n\n/**\n * What the task made, file by file: each uploaded file as the asset it became (named and sized\n * from the file sent), each failed one with agora's reason, and a task that ended without a result\n * for a file (cancelled, or failed as a whole) with the task's message.\n */\nexport function folderUploadResultOf({\n  task,\n  files,\n}: {\n  task: FolderUploadTask;\n  files: readonly File[];\n}): FolderUploadResult {\n  const uploaded: UploadedAsset[] = [];\n  const failed: FolderUploadResult['failed'] = [];\n  const answered = new Set<number>();\n  for (const result of task.results) {\n    answered.add(result.fileIndex);\n    const file = files[result.fileIndex];\n    if (result.status === 'uploaded' && result.assetId) {\n      uploaded.push({\n        id: result.assetId,\n        title: result.filename,\n        fileName: result.filename,\n        fileSize: file?.size ?? 0,\n        mediaType: file?.type || 'application/octet-stream',\n        fileIndex: result.fileIndex,\n      });\n    } else {\n      failed.push({ fileName: result.filename, error: result.message || 'Upload failed' });\n    }\n  }\n  files.forEach((file, index) => {\n    if (answered.has(index)) return;\n    failed.push({ fileName: file.name, error: task.message || `Upload ${task.status}` });\n  });\n  return { uploaded, failed };\n}\n\n/** Waits `ms`, or rejects at once when `signal` aborts. */\nfunction wait(ms: number, signal: AbortSignal | undefined): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new DOMException('Upload cancelled', 'AbortError'));\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new DOMException('Upload cancelled', 'AbortError'));\n    };\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\n/**\n * Reads the task until it ends: at once, then after waits that double from 250 ms to 2 s. A task\n * agora no longer names (another workspace, or gone) and one that has not ended by the deadline\n * fail the upload; what the task did by then stays done.\n */\nexport async function waitForFolderUploadTask({\n  auth,\n  taskId,\n  signal,\n  deadlineMs = FOLDER_UPLOAD_DEADLINE_MS,\n  now = Date.now,\n  sleep = (ms) => wait(ms, signal),\n}: {\n  auth: MentionAuthContext;\n  taskId: string;\n  signal?: AbortSignal;\n  deadlineMs?: number;\n  now?: () => number;\n  sleep?: (ms: number) => Promise<void>;\n}): Promise<FolderUploadTask> {\n  const startedAt = now();\n  for (let attempt = 0; ; attempt += 1) {\n    const data = await fetchGraphQL<{ asyncUploadTask: FolderUploadTask | null }>(\n      auth,\n      ASYNC_UPLOAD_TASK_QUERY,\n      { taskId },\n      { signal },\n    );\n    const task = data.asyncUploadTask;\n    if (!task) throw new Error('Athena no longer knows this upload.');\n    if (ENDED.has(task.status)) return task;\n    if (now() - startedAt >= deadlineMs) {\n      throw new Error('The upload is taking too long; it may still finish in Athena.');\n    }\n    await sleep(folderUploadPollDelayMs(attempt));\n  }\n}\n\n/**\n * Starts an upload of `files` into `parentFolderId` (agora's async upload, which refuses a folder\n * the caller may not edit before it takes any file), as `send` posts it, and answers its task id.\n */\nexport async function startFolderUpload({\n  send,\n  files,\n  parentFolderId,\n}: {\n  /** Posts the form to `FOLDER_UPLOAD_PATH` with the credential (and the byte progress). */\n  send: (form: FormData) => Promise<Response>;\n  files: readonly File[];\n  parentFolderId: string;\n}): Promise<string> {\n  const response = await send(folderUploadForm({ files, parentFolderId }));\n  if (!response.ok) {\n    const detail = await refusalDetail(response);\n    if (response.status === 401 || response.status === 403) {\n      throw new Error(detail ?? 'You can’t add files to this folder.');\n    }\n    if (response.status === 404) throw new Error(detail ?? 'That folder is no longer there.');\n    throw new Error(detail ?? `Upload failed with status ${response.status}`);\n  }\n  const taskId = taskIdOf(await response.json().catch(() => null));\n  if (!taskId) throw new Error('Athena did not start the upload.');\n  return taskId;\n}\n"],"names":[],"mappings":"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"}

package/dist/composer/index.d.ts

@@ -6,7 +6,7 @@ export { useComposerReady, useFocusComposer } from './composer-handoff';
 export { useReadComposerDraft, useTryReadComposerDraft } from './useReadComposerDraft';
 export { useComposerAttachment } from './useComposerAttachment';
 export { useFileUpload } from './useFileUpload';
-export type { UploadedAsset, UploadProgress, UseFileUploadReturn } from './useFileUpload';
+export type { UploadedAsset, UploadOptions, UploadProgress, UploadRefusal, UseFileUploadReturn, } from './useFileUpload';
 export { FileUploadButton } from './FileUploadButton';
 export type { FileUploadButtonProps } from './FileUploadButton';
 export { ComposerQuotePreview } from './ComposerQuotePreview';

package/dist/composer/staged-message-metadata.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const namedAgents = require("../agent-runtime/src/named-agents.cjs");
+const attachedReferences = require("./attached-references.cjs");
+const composerMarkdown = require("../agent-runtime/src/composer-markdown.cjs");
+function takeStagedMessageMetadata(threadId) {
+  const metadata = attachedReferences.withStagedAttachedReferences(threadId, namedAgents.stagedNamedAgentsMessageMetadata(threadId));
+  const markdown = composerMarkdown.takeStagedComposerMarkdownMetadata(threadId);
+  return markdown === void 0 ? metadata : { ...metadata, ...markdown };
+}
+exports.takeStagedMessageMetadata = takeStagedMessageMetadata;
+//# sourceMappingURL=staged-message-metadata.cjs.map

package/dist/composer/staged-message-metadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-message-metadata.cjs","sources":["../../src/composer/staged-message-metadata.ts"],"sourcesContent":["import { takeStagedComposerMarkdownMetadata } from '@athenaintel/agent-runtime';\nimport { stagedNamedAgentsMessageMetadata } from '@athenaintel/agent-runtime/named-agents';\nimport { withStagedAttachedReferences } from './attached-references';\n\n/**\n * The metadata the message `threadId` sends now carries, taking every slot a composer staged for\n * it right before it sent: the agents it names (`addressedAgents`), what an app attached to it\n * (`attachedReferences`) and the draft its text came from (`composer_markdown`). `undefined` when\n * nothing was staged.\n *\n * Two readers, one taking each message's slots once:\n * - the runtime's `getMessageMetadata` (`useAthenaStatewireRuntime`), for a send the composer\n *   runtime makes. That option exists only in the monorepo's patch of\n *   `@assistant-ui/react-statewire`; the stock package an app installs with the SDK from npm\n *   ignores it.\n * - a send that puts the metadata on its message itself (`AthenaChat`'s composed send of a message\n *   with attachments), which the stock package forwards as the message's metadata.\n */\nexport function takeStagedMessageMetadata(threadId: string): Record<string, unknown> | undefined {\n  const metadata = withStagedAttachedReferences(threadId, stagedNamedAgentsMessageMetadata(threadId));\n  const markdown = takeStagedComposerMarkdownMetadata(threadId);\n  return markdown === undefined ? metadata : { ...metadata, ...markdown };\n}\n"],"names":["withStagedAttachedReferences","stagedNamedAgentsMessageMetadata","takeStagedComposerMarkdownMetadata"],"mappings":";;;;;AAkBO,SAAS,0BAA0B,UAAuD;AAC/F,QAAM,WAAWA,mBAAAA,6BAA6B,UAAUC,YAAAA,iCAAiC,QAAQ,CAAC;AAClG,QAAM,WAAWC,iBAAAA,mCAAmC,QAAQ;AAC5D,SAAO,aAAa,SAAY,WAAW,EAAE,GAAG,UAAU,GAAG,SAAA;AAC/D;;"}

package/dist/composer/staged-message-metadata.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The metadata the message `threadId` sends now carries, taking every slot a composer staged for
+ * it right before it sent: the agents it names (`addressedAgents`), what an app attached to it
+ * (`attachedReferences`) and the draft its text came from (`composer_markdown`). `undefined` when
+ * nothing was staged.
+ *
+ * Two readers, one taking each message's slots once:
+ * - the runtime's `getMessageMetadata` (`useAthenaStatewireRuntime`), for a send the composer
+ *   runtime makes. That option exists only in the monorepo's patch of
+ *   `@assistant-ui/react-statewire`; the stock package an app installs with the SDK from npm
+ *   ignores it.
+ * - a send that puts the metadata on its message itself (`AthenaChat`'s composed send of a message
+ *   with attachments), which the stock package forwards as the message's metadata.
+ */
+export declare function takeStagedMessageMetadata(threadId: string): Record<string, unknown> | undefined;

package/dist/composer/staged-message-metadata.js

@@ -0,0 +1,12 @@
+import { stagedNamedAgentsMessageMetadata } from "../agent-runtime/src/named-agents.js";
+import { withStagedAttachedReferences } from "./attached-references.js";
+import { takeStagedComposerMarkdownMetadata } from "../agent-runtime/src/composer-markdown.js";
+function takeStagedMessageMetadata(threadId) {
+  const metadata = withStagedAttachedReferences(threadId, stagedNamedAgentsMessageMetadata(threadId));
+  const markdown = takeStagedComposerMarkdownMetadata(threadId);
+  return markdown === void 0 ? metadata : { ...metadata, ...markdown };
+}
+export {
+  takeStagedMessageMetadata
+};
+//# sourceMappingURL=staged-message-metadata.js.map

package/dist/composer/staged-message-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staged-message-metadata.js","sources":["../../src/composer/staged-message-metadata.ts"],"sourcesContent":["import { takeStagedComposerMarkdownMetadata } from '@athenaintel/agent-runtime';\nimport { stagedNamedAgentsMessageMetadata } from '@athenaintel/agent-runtime/named-agents';\nimport { withStagedAttachedReferences } from './attached-references';\n\n/**\n * The metadata the message `threadId` sends now carries, taking every slot a composer staged for\n * it right before it sent: the agents it names (`addressedAgents`), what an app attached to it\n * (`attachedReferences`) and the draft its text came from (`composer_markdown`). `undefined` when\n * nothing was staged.\n *\n * Two readers, one taking each message's slots once:\n * - the runtime's `getMessageMetadata` (`useAthenaStatewireRuntime`), for a send the composer\n *   runtime makes. That option exists only in the monorepo's patch of\n *   `@assistant-ui/react-statewire`; the stock package an app installs with the SDK from npm\n *   ignores it.\n * - a send that puts the metadata on its message itself (`AthenaChat`'s composed send of a message\n *   with attachments), which the stock package forwards as the message's metadata.\n */\nexport function takeStagedMessageMetadata(threadId: string): Record<string, unknown> | undefined {\n  const metadata = withStagedAttachedReferences(threadId, stagedNamedAgentsMessageMetadata(threadId));\n  const markdown = takeStagedComposerMarkdownMetadata(threadId);\n  return markdown === undefined ? metadata : { ...metadata, ...markdown };\n}\n"],"names":[],"mappings":";;;AAkBO,SAAS,0BAA0B,UAAuD;AAC/F,QAAM,WAAW,6BAA6B,UAAU,iCAAiC,QAAQ,CAAC;AAClG,QAAM,WAAW,mCAAmC,QAAQ;AAC5D,SAAO,aAAa,SAAY,WAAW,EAAE,GAAG,UAAU,GAAG,SAAA;AAC/D;"}

package/dist/composer/useAttachToChat.cjs

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const threadIdContext = require("../threads/thread-id-context.cjs");
+const attachedReferences = require("./attached-references.cjs");
+const composerHandoff = require("./composer-handoff.cjs");
+const useAppendToComposer = require("./useAppendToComposer.cjs");
+function useAttachToChat() {
+  const threadId = require$$0.useContext(threadIdContext.AthenaStatewireThreadIdContext);
+  const references = attachedReferences.usePendingAttachedReferences(threadId);
+  const appendToComposer = useAppendToComposer.useAppendToComposer();
+  const focusComposer = composerHandoff.useFocusComposer();
+  const attach = require$$0.useCallback(
+    (reference, options) => {
+      const result = attachedReferences.attachReferenceToThread({ threadId, reference });
+      if (!result.attached) return result;
+      const prompt = options == null ? void 0 : options.prompt;
+      if (prompt) appendToComposer(prompt, { focus: (options == null ? void 0 : options.open) ?? false });
+      else if (options == null ? void 0 : options.open) focusComposer();
+      return result;
+    },
+    [appendToComposer, focusComposer, threadId]
+  );
+  const detach = require$$0.useCallback(
+    (reference) => attachedReferences.detachReferenceFromThread({ threadId, reference }),
+    [threadId]
+  );
+  const clear = require$$0.useCallback(() => attachedReferences.clearAttachedReferences(threadId), [threadId]);
+  return require$$0.useMemo(
+    () => ({ attach, detach, clear, references }),
+    [attach, clear, detach, references]
+  );
+}
+exports.useAttachToChat = useAttachToChat;
+//# sourceMappingURL=useAttachToChat.cjs.map