@streamoid/agent 0.6.38 → 0.6.39

package/dist/index.d.ts

@@ -152,6 +152,76 @@ 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, and the
+   * scope bar reads "All apps" at CXO level — 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`: land where clicking that tile and choosing that outcome
+   *   would; return `true` when handled, else the instruction is typed in.
+   */
+  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;
+  onSuggestion?: (suggestion: AgentScopeSuggestion) => boolean | void;
 }
 
 export interface HostCanvasContextValue {