@beeuni/sdk 0.2.0 → 0.3.0

package/README.md

@@ -81,7 +81,7 @@ One connector as a handle: `run` returns the output itself and throws
 `upstreamStatus`, `retryAfterSeconds`) or `ConnectorApprovalPendingError`;
 `paginate` follows a cursor and throws `ConnectorPageLimitError` (with
 `nextArgs`) past `maxPages`; `useConnectorQuery` (`@beeuni/sdk/react`) caches a
-read. Guide: `/docs/sdk/connectors`; runnable: `examples/13-connectors-as-code.ts`.
+read. Guide: [Connectors](https://beeuni.ai/docs/connect/connectors#typed-calls-from-code); runnable: `examples/13-connectors-as-code.ts`.
 
 ```ts
 const linear = beeuni.project(projectId).connector('linear');
@@ -91,8 +91,8 @@ await linear.accounts();
 ```
 
 An action outside the file accepts any object and returns `output: unknown`.
-Connectors without a declared output schema return
-`output` stays `unknown`. `ConnectorArgs<'linear', 'list_issues'>` and
+For connectors without a declared output schema, `output` stays `unknown`.
+`ConnectorArgs<'linear', 'list_issues'>` and
 `ConnectorResult<'linear', 'list_issues'>` name the same types.
 
 #### Choose which account a call runs as
@@ -148,7 +148,7 @@ The browser path needs the App's viewer scope set to `api`
 `403 insufficient_scope`. A service account answers `403` until a person
 grants it a project role (`beeuni access grant --service-account <id> --role
 member --project <id>`). Never put a provider API key in an App or a Convex
-deployment when a connector exists. Guide: `/docs/sdk/connectors`.
+deployment when a connector exists. Guide: [Connectors](https://beeuni.ai/docs/connect/connectors).
 
 ### Upload prompt attachments before Send
 
@@ -210,12 +210,19 @@ cannot retry: `retry` throws, and the item error carries code
 resolves at once. It deletes unbound storage best-effort and never rejects; a
 failed or refused DELETE leaves the object to the 24-hour expiry.
 `abort(localId)` cancels unfinished work. `dispose()` aborts listed work and
-deletes its uploads best-effort: no send holds them, and drafts keep no handle.
-Call it on non-React cleanup; the hook handles unmount and project changes.
-Unused uploads expire after 24 hours.
-
-Selections live in memory only. Never persist a File, blob URL, signed URL, or
-upload handle in a draft.
+deletes its uploads best-effort: no send holds them. Call it on non-React
+cleanup; the hook handles unmount and project changes. Unused uploads expire
+after 24 hours.
+
+A draft may keep a finished upload, so a reload or another composer brings the
+file back. Store its metadata (`item.attachment`: `attachment_id`, `filename`,
+`mime`, `size`, `expires_at`) and call `forget(ids)` before `dispose()`, so the
+upload is not deleted. Later, `restore([{ attachment, file? }])` lists it again
+as `ready` with no request, and returns its new id (`undefined` for an expired or
+invalid one). Send uses it like any ready upload. The server binds an attachment
+only for its own account, project and person, so the id grants nothing to
+anyone else. Never persist a File, a blob URL, or a signed URL: an unfinished
+upload cannot be kept.
 
 For non-composer uploads, call `beeuni.project(projectId).attachments.upload(file,
 { signal, onProgress, onUpload, resume })`. The server selects the transport in the
@@ -782,6 +789,8 @@ the root import — offers the same agents and models and sends the same pick.
 | `modelInDefaultView(model, { search, isStoreVisible, selected })` | → whether the empty-search picker shows the model |
 | `resolveModelDefault(modelDefaults, agentName)` | `/model-defaults` → agent → project → account → platform default |
 | `resolveComposerModel({ models, picks, serverDefault, globalDefault, agentModel, configModel, recent, providers })` | → `{ model, explicit, fallback }` |
+| `sessionModelCandidates({ session, lastPromptModel, gatewayEnabled })` | session row + last prompt's model → the models the session already runs, most trusted first: a chosen pin (`explicit`, `repointed`), the last prompt's model, a default pin. Put them in `picks` after this composer's own pick for the session |
+| `latestPromptModel(messages)` | transcript → the model of the newest user message that records one |
 
 The root barrel reads catalog helpers from `@beeuni/llm-catalog/lite`, which
 never includes the ~7.6 MB models.dev snapshot, so a bundler that does not