@streamoid/agent 0.6.44 → 0.6.46

package/README.md

@@ -32,3 +32,31 @@ import "@streamoid/agent/style.css";
 > bump PR in every consumer. So the one thing a change to the chat needs is a new
 > version in this directory's `package.json`; merging it ships everything else.
 > The `agent-version` check on each PR fails if that has been forgotten.
+
+
+### Panel context and suggestion copy
+
+The panel header shows the current app and location directly beneath its title
+using `ScPanelHeading` from `@streamoid/ui` (muted 12px text). Supply
+`hostContext.breadcrumbs: ['Home', 'Explore']` to display
+`Artifax · Home › Explore`; older hosts fall back to `hostContext.page`.
+Context is hidden when a task widens beyond the host app, and it is not repeated
+above the composer. Hosts that hide the built-in header own their header context.
+
+Author scope outcome instructions and deliverables in sentence case. A sample's
+`subject` is a running-prose noun phrase (for example, `the violet halter crop
+tank`); `title` keeps its original identity. Preserve proper names, acronyms and
+“T-shirt”. The agent renders supplied text without a CSS case transformation.
+
+
+### Composer and suggestion presentation
+
+Embedded and standalone chat use `ScComposerSurface` and `ScSuggestionRow` from
+`@streamoid/ui` 0.6.86+. An empty composer starts with three 20px text lines and
+grows to 170px before scrolling. Suggestions are native buttons in flat rows
+with hairline separators, and fill the composer without navigating or sending.
+
+The secondary line shows `meta.outcome_summary` (falling back to
+`meta.expected_output`), optionally followed by authored `meta.ceiling_minutes`
+and `meta.estimated_credits`. Unknown estimates are omitted. Scoped suggestions
+use `deliverable` and `ceilingMinutes` from the host's outcome catalogue.

package/dist/index.d.ts

@@ -40,6 +40,8 @@ export interface AgentHostContext {
   app?: string;
   /** Human name of the current page, e.g. `Boards`. */
   page?: string;
+  /** Header location hierarchy, e.g. ["Home", "Explore"]. Falls back to page. */
+  breadcrumbs?: string[];
   /** Route pattern rather than the filled path, e.g. `/dashboard/:workspaceId/home`. */
   route?: string;
   /** Absolute URL of the host page. */
@@ -187,6 +189,7 @@ export interface AgentScopeSample {
   /** What the tile's hover says about it. */
   title: string;
   /** How an instruction names it; defaults to `title`. */
+  /** Sentence-case noun phrase; preserve proper names and acronyms. */
   subject?: string;
   imageUrl?: string | null;
   kind?: string;
@@ -204,6 +207,7 @@ export interface AgentScopeSelection {
   /** "6 products on this board". */
   label: string;
   /** "these six"; defaults to `label`. */
+  /** Sentence-case noun phrase; preserve proper names and acronyms. */
   subject?: string;
   kind?: string;
   ids?: string[];