@streamoid/agent 0.6.38 → 0.6.40

package/dist/index.d.ts

@@ -152,6 +152,84 @@ export interface AgentChatShellAdapters {
    * Omit this and the iframe path runs unchanged; it is purely additive.
    */
   canvas?: HostCanvasContextValue;
+  /**
+   * Scope the pane to the host app. The scope itself comes from
+   * `hostContext.app` — the pane is scoped to wherever it was opened — so
+   * every field here is optional:
+   *
+   * - `sections`: the app's outcome table. One suggestion per section, from
+   *   its first sample's primary outcome. Change the samples and the
+   *   suggestions follow. Omit it for the catalog briefs this app can run alone.
+   * - `selection`: what was selected when the pane opened — a removable chip
+   *   in the composer, and the subject suggestions name.
+   * - `onSuggestion`: DEPRECATED AND NOT CALLED. Picking a suggestion always
+   *   puts the instruction in the composer, like every other card in the row.
+   *
+   * There is no scope picker in the pane. A task that needs another app is
+   * offered the widening by the run that needs it.
+   */
+  scope?: AgentScopeAdapter | null;
+}
+
+export interface AgentScopeOutcome {
+  key: string;
+  label: string;
+  /** "Remix {subject} — show me three"; `{subject}` is filled by the pane. */
+  instruction?: string;
+  /** A ceiling, not an estimate. */
+  ceilingMinutes?: number;
+  deliverable?: string;
+  kinds?: string[];
+}
+
+export interface AgentScopeSample {
+  id: string;
+  /** What the tile's hover says about it. */
+  title: string;
+  /** How an instruction names it; defaults to `title`. */
+  subject?: string;
+  imageUrl?: string | null;
+  kind?: string;
+  primaryOutcomeKey?: string;
+}
+
+export interface AgentScopeSection {
+  key: string;
+  title: string;
+  outcomes: AgentScopeOutcome[];
+  samples: AgentScopeSample[];
+}
+
+export interface AgentScopeSelection {
+  /** "6 products on this board". */
+  label: string;
+  /** "these six"; defaults to `label`. */
+  subject?: string;
+  kind?: string;
+  ids?: string[];
+}
+
+export interface AgentScopeSuggestion {
+  id: string;
+  sectionKey: string;
+  outcomeKey: string;
+  sampleId?: string;
+  subject: 'sample' | 'selection';
+  text: string;
+  ceilingMinutes?: number;
+  deliverable?: string;
+  imageUrl?: string | null;
+}
+
+export interface AgentScopeAdapter {
+  sections?: AgentScopeSection[] | null;
+  selection?: AgentScopeSelection | null;
+  /**
+   * @deprecated NOT CALLED. A suggestion always fills the composer. Kept so
+   * hosts that still pass it keep compiling; remove it from the host, then
+   * from here.
+   */
+  onSuggestion?: (suggestion: AgentScopeSuggestion) => boolean | void;
 }
 
 export interface HostCanvasContextValue {