@stigmer/react 0.0.36 → 0.0.40

package/composer/SessionComposer.d.ts

@@ -0,0 +1,269 @@
+import { type AttachmentInput, type EnvVarInput, type McpServerUsageInput, type ResourceRef } from "@stigmer/sdk";
+import { type AgentResolution } from "../agent/useAgentSetup";
+import type { UseSessionVariablesReturn } from "../execution/useSessionVariables";
+import type { UseWorkspaceEntriesReturn } from "../workspace/useWorkspaceEntries";
+import type { UseGitHubConnectionReturn } from "../github/useGitHubConnection";
+/**
+ * Context provided to `onSubmit` at the moment of submission.
+ *
+ * Contains aggregated one-time environment variables from all setup
+ * flows managed by the composer (agent, MCP servers, manual secrets).
+ * The consumer passes `context.runtimeEnv` directly to execution
+ * creation without needing to understand the individual sources.
+ */
+export interface SessionComposerSubmitContext {
+    /**
+     * Aggregated one-time environment variables from all setup flows.
+     *
+     * Merged from (in precedence order, last-write-wins):
+     * 1. Agent one-time env vars (when agent resolution mode is `"oneTime"`)
+     * 2. MCP server one-time env vars (collected with `saveForFuture: false`)
+     * 3. Manual session variables (from {@link SessionVariablesInput})
+     *
+     * `undefined` when no runtime env vars were collected from any source.
+     * Pass directly to execution creation as `runtimeEnv`.
+     */
+    readonly runtimeEnv?: Record<string, EnvVarInput>;
+    /**
+     * Pre-uploaded file attachments for the execution.
+     *
+     * Each entry contains a `storageKey` obtained from
+     * `agentExecution.uploadAttachment()`. Only successfully uploaded
+     * attachments are included. Pass directly to execution creation
+     * as `attachments`.
+     *
+     * `undefined` when no files were attached.
+     */
+    readonly attachments?: AttachmentInput[];
+}
+export interface SessionComposerProps {
+    /**
+     * Called when the user submits a message.
+     *
+     * The optional `context` parameter carries aggregated runtime data
+     * collected by the composer's setup flows. When present,
+     * `context.runtimeEnv` should be passed to execution creation.
+     */
+    readonly onSubmit: (message: string, modelName?: string, context?: SessionComposerSubmitContext) => void;
+    /** Shows loading indicator on the send button. */
+    readonly isSubmitting?: boolean;
+    /** Disables the entire composer (e.g., while an execution streams). */
+    readonly disabled?: boolean;
+    /** Initial model ID for the model selector. */
+    readonly defaultModelId?: string;
+    /** Called when the user changes the selected model. */
+    readonly onModelChange?: (modelId: string) => void;
+    /** Show the model selector. @default true */
+    readonly showModelSelector?: boolean;
+    /**
+     * Workspace state managed by {@link useWorkspaceEntries}.
+     * When provided, renders a workspace trigger in the toolbar
+     * that opens a popover with the workspace editor.
+     */
+    readonly workspace?: UseWorkspaceEntriesReturn;
+    /** GitHub connection state for the repo picker. */
+    readonly gitHubConnection?: UseGitHubConnectionReturn;
+    /** Show the GitHub Repo source button. @default true */
+    readonly enableGitHub?: boolean;
+    /** Show the Local Folder source button. @default false */
+    readonly enableLocal?: boolean;
+    /** Use the visual folder browser instead of a text input. @default false */
+    readonly enableFolderBrowser?: boolean;
+    /**
+     * Organization slug for agent, MCP server, and skill searches.
+     * Required when agent, MCP, or skill pickers are enabled.
+     */
+    readonly org?: string;
+    /**
+     * Currently selected agent reference, or null if none.
+     * When `onAgentRefChange` is provided, an agent trigger
+     * appears in the toolbar (single-select).
+     */
+    readonly agentRef?: ResourceRef | null;
+    /** Called when the agent selection changes. Providing this enables the agent trigger. */
+    readonly onAgentRefChange?: (ref: ResourceRef | null) => void;
+    /**
+     * Called when the agent setup flow resolves how the agent should
+     * be used for session creation.
+     *
+     * The {@link AgentResolution} discriminated union tells the caller
+     * which session creation path to use:
+     * - `"saved"` — use `agentInstanceId`
+     * - `"oneTime"` — use `agentRef` + pass `runtimeEnv` to execution
+     * - `"direct"` — use `agentRef` (no secrets needed)
+     *
+     * Set to `null` when the agent is deselected.
+     */
+    readonly onAgentResolutionChange?: (resolution: AgentResolution | null) => void;
+    /**
+     * Agent to auto-select when the composer mounts.
+     *
+     * When provided, the composer runs the full agent resolution flow
+     * on mount — exactly as if the user had picked this agent in the
+     * {@link AgentPicker}. If the agent requires credentials, the
+     * environment form appears automatically.
+     *
+     * One-time: consumed on mount; subsequent changes are ignored.
+     * To change the agent after mount, use the picker or
+     * `onAgentRefChange` externally.
+     *
+     * Requires `org` and `onAgentRefChange` to be set (same
+     * prerequisites as the agent picker).
+     *
+     * @example
+     * ```tsx
+     * <SessionComposer
+     *   onSubmit={handleCreate}
+     *   org="acme"
+     *   agentRef={agentRef}
+     *   onAgentRefChange={setAgentRef}
+     *   onAgentResolutionChange={setResolution}
+     *   initialAgentRef={{ org: "stigmer", slug: "agent-creator" }}
+     * />
+     * ```
+     */
+    readonly initialAgentRef?: ResourceRef;
+    /**
+     * Currently selected MCP server usages.
+     * When `onMcpServerUsagesChange` is provided, a MCP server trigger
+     * appears in the toolbar.
+     */
+    readonly mcpServerUsages?: McpServerUsageInput[];
+    /** Called when the MCP server selection changes. Providing this enables the MCP trigger. */
+    readonly onMcpServerUsagesChange?: (usages: McpServerUsageInput[]) => void;
+    /**
+     * Currently selected skill references.
+     * When `onSkillRefsChange` is provided, a skill trigger
+     * appears in the toolbar.
+     */
+    readonly skillRefs?: ResourceRef[];
+    /** Called when the skill selection changes. Providing this enables the skill trigger. */
+    readonly onSkillRefsChange?: (refs: ResourceRef[]) => void;
+    /**
+     * Session variables state managed by {@link useSessionVariables}.
+     * When provided, renders a "Session Variables" trigger in the toolbar
+     * that opens a key-value editor for environment variables.
+     *
+     * Variables are ephemeral by default (single execution). Individual
+     * entries can be marked `saveForFuture: true` to persist them to
+     * the user's personal environment. The consumer should call
+     * `sessionVariables.clear()` after submission.
+     */
+    readonly sessionVariables?: UseSessionVariablesReturn;
+    /**
+     * Enable file attachment support in the composer.
+     *
+     * When `true`, renders an attach button in the toolbar and enables
+     * drag-and-drop file upload on the textarea. Attachments are uploaded
+     * immediately via `agentExecution.uploadAttachment()` and included
+     * in `context.attachments` on submit.
+     *
+     * @default true
+     */
+    readonly enableAttachments?: boolean;
+    /**
+     * Called when a file is rejected (e.g., exceeds the 10 MB limit).
+     * Consumers can use this for toast notifications.
+     */
+    readonly onAttachmentValidationError?: (message: string) => void;
+    /**
+     * Files to attach programmatically when the composer mounts.
+     *
+     * When provided, the composer uploads these files via the same
+     * attachment pipeline as user-selected files. Attachment chips
+     * appear in the UI so the user sees what is attached.
+     *
+     * One-time: consumed when the value first becomes truthy.
+     * Subsequent changes are ignored. This allows async resource
+     * fetching — the effect waits for the files to be ready.
+     *
+     * Requires `enableAttachments` to be `true` (default).
+     *
+     * @example
+     * ```tsx
+     * const yaml = serializeAgentYaml(agent);
+     * const file = new File([yaml], "my-agent.yaml", { type: "text/yaml" });
+     *
+     * <SessionComposer
+     *   onSubmit={handleSubmit}
+     *   initialAttachments={[file]}
+     *   initialAgentRef={{ org: "stigmer", slug: "agent-creator" }}
+     * />
+     * ```
+     */
+    readonly initialAttachments?: File[];
+    /** Placeholder text for the textarea. @default "Reply\u2026" */
+    readonly placeholder?: string;
+    /** Initial number of visible rows. @default 1 */
+    readonly initialRows?: number;
+    /** Auto-focus the textarea on mount. @default false */
+    readonly autoFocus?: boolean;
+    /** ARIA label for the composer region. @default "Send message" */
+    readonly ariaLabel?: string;
+    readonly className?: string;
+}
+/**
+ * Unified message composer for Stigmer sessions.
+ *
+ * Combines a self-resizing textarea, model selector, and context pickers
+ * (agent, workspace, MCP servers, skills) into a single input card.
+ *
+ * The toolbar uses a two-tier layout:
+ * - **Tier 1** (always visible): Attach, Workspace, Model Selector
+ * - **Tier 2** (behind Configure menu): Agent, MCP, Skills, Secrets
+ *
+ * Selected items render as removable chips between the textarea and toolbar.
+ *
+ * Used for both new session creation (launcher) and follow-up messages
+ * within an existing session. Layout positioning is the consumer's
+ * responsibility.
+ *
+ * Uses `<div role="form">` instead of `<form>` so it can be embedded
+ * inside host application forms without nesting violations.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ *
+ * @example
+ * ```tsx
+ * // Launcher with all context types
+ * <SessionComposer
+ *   onSubmit={handleCreate}
+ *   org={org}
+ *   agentRef={agentRef}
+ *   onAgentRefChange={setAgentRef}
+ *   onAgentResolutionChange={setResolution}
+ *   workspace={workspace}
+ *   enableGitHub
+ *   mcpServerUsages={mcpUsages}
+ *   onMcpServerUsagesChange={setMcpUsages}
+ *   skillRefs={skillRefs}
+ *   onSkillRefsChange={setSkillRefs}
+ *   initialRows={3}
+ *   placeholder="Describe what you need help with..."
+ *   autoFocus
+ * />
+ *
+ * // Pre-filled launcher (auto-selects agent on mount)
+ * <SessionComposer
+ *   onSubmit={handleCreate}
+ *   org={org}
+ *   agentRef={agentRef}
+ *   onAgentRefChange={setAgentRef}
+ *   onAgentResolutionChange={setResolution}
+ *   initialAgentRef={{ org: "stigmer", slug: "agent-creator" }}
+ *   placeholder="Describe the agent you want to create..."
+ *   initialRows={3}
+ *   autoFocus
+ * />
+ *
+ * // Follow-up (compact, workspace only)
+ * <SessionComposer
+ *   onSubmit={(msg, model) => conv.sendFollowUp(msg, { modelName: model })}
+ *   disabled={!conv.canSendFollowUp}
+ *   isSubmitting={conv.isSending}
+ *   workspace={workspace}
+ * />
+ * ```
+ */
+export declare function SessionComposer({ onSubmit, isSubmitting, disabled, defaultModelId, onModelChange, showModelSelector, workspace, gitHubConnection, enableGitHub, enableLocal, enableFolderBrowser, org, agentRef, onAgentRefChange, onAgentResolutionChange, initialAgentRef, mcpServerUsages, onMcpServerUsagesChange, skillRefs, onSkillRefsChange, sessionVariables, enableAttachments, onAttachmentValidationError, initialAttachments, placeholder, initialRows, autoFocus, ariaLabel, className, }: SessionComposerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SessionComposer.d.ts.map

package/composer/SessionComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionComposer.d.ts","sourceRoot":"","sources":["../../src/composer/SessionComposer.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAQlI,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO7E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAc/E;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,4BAA4B,KACnC,IAAI,CAAC;IACV,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,uDAAuD;IACvD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,6CAA6C;IAC7C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,yBAAyB,CAAC;IAC/C,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IACtD,wDAAwD;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,yFAAyF;IACzF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjD,4FAA4F;IAC5F,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IAE3E;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IACnC,yFAAyF;IACzF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAE3D;;;;;;;;;OASG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAEtD;;;;;;;;;OASG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC;IAErC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAoB,EACpB,QAAgB,EAChB,cAAc,EACd,aAAa,EACb,iBAAwB,EACxB,SAAS,EACT,gBAAgB,EAChB,YAAmB,EACnB,WAAmB,EACnB,mBAA2B,EAC3B,GAAG,EACH,QAAQ,EACR,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,iBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,WAA2B,EAC3B,WAAe,EACf,SAAiB,EACjB,SAA0B,EAC1B,SAAS,GACV,EAAE,oBAAoB,2CA6yBtB"}