@stigmer/react 3.1.3 → 3.1.4

package/src/session/useSessionPanel.ts

@@ -2,6 +2,7 @@
 
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import type { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
 import { isTerminalPhase } from "../execution/execution-phases.js";
 import type { SelectedThreadItem } from "../internal/store/selection-store.js";
 import {
@@ -10,6 +11,8 @@ import {
   type WorkspaceEditorsStore,
 } from "../internal/store/index.js";
 import { PLAN_DOCUMENT_ENTRY_ID, PLAN_DOCUMENT_PATH } from "./plan-document.js";
+import { ARTIFACT_DOCUMENT_ENTRY_ID } from "./artifact-document.js";
+import { artifactKey } from "./useSessionArtifacts.js";
 
 /** Options for {@link useSessionPanel}. */
 export interface UseSessionPanelOptions {
@@ -118,6 +121,25 @@ export interface SessionPanelController {
    * both when a plan STARTS STREAMING and when it publishes (see `planKey`).
    */
   readonly openPlanDocument: () => void;
+  /**
+   * Open (or focus) an artifact as an editor-pane document tab and expand the
+   * panel. Uses the PREVIEW slot — like files and content-search hits, casual
+   * artifact browsing reuses one tab (single-click), and double-clicking the
+   * tab pins it. Distinct from `openPlanDocument`, which pins its single tab: a
+   * plan is the turn's deliverable, artifacts are browsable outputs. The
+   * artifact's {@link artifactKey} is the tab identity, shared with the
+   * `SurfaceVirtualDocument` the viewer builds for the open tab.
+   */
+  readonly openArtifact: (artifact: ExecutionArtifact) => void;
+  /**
+   * Pin an artifact's tab (clear its preview state) — the double-click half of
+   * the open/activate split, the encapsulated sibling of {@link openArtifact}.
+   * Delegates to the editors store's generic `pin`, exactly as the file tree
+   * pins via `pinEditor`: the leading single-click of the double-click has
+   * already opened the preview tab, so this promotes it to a persistent tab. A
+   * no-op if the artifact is not open.
+   */
+  readonly pinArtifact: (artifact: ExecutionArtifact) => void;
   /**
    * Report the current thread-item selection. Called from an effect inside the
    * panel subtree (the level that subscribes to the selection store), keeping
@@ -224,6 +246,21 @@ export function useSessionPanel({
     [editorsStore],
   );
 
+  const openArtifact = useCallback(
+    (artifact: ExecutionArtifact) => {
+      editorsStore.openPreview(ARTIFACT_DOCUMENT_ENTRY_ID, artifactKey(artifact));
+      setIsOpen(true);
+    },
+    [editorsStore],
+  );
+
+  const pinArtifact = useCallback(
+    (artifact: ExecutionArtifact) => {
+      editorsStore.pin(ARTIFACT_DOCUMENT_ENTRY_ID, artifactKey(artifact));
+    },
+    [editorsStore],
+  );
+
   const activateEditor = useCallback(
     (entryId: string, path: string) => editorsStore.activate(entryId, path),
     [editorsStore],
@@ -268,6 +305,8 @@ export function useSessionPanel({
       pinEditor,
       closeEditor,
       openPlanDocument,
+      openArtifact,
+      pinArtifact,
       notifySelection,
     }),
     [
@@ -282,6 +321,8 @@ export function useSessionPanel({
       pinEditor,
       closeEditor,
       openPlanDocument,
+      openArtifact,
+      pinArtifact,
       notifySelection,
     ],
   );

package/src/session/useSessionRailViews.tsx

@@ -6,7 +6,10 @@ import type { SurfaceRailView } from "../workspace/WorkspaceSurface.js";
 import type { SelectedThreadItem } from "../internal/store/selection-store.js";
 import type { ApplyResourceResult } from "../library/useApplyResource.js";
 import { useSessionWriteBacks } from "./useSessionWriteBacks.js";
-import { useSessionArtifacts } from "./useSessionArtifacts.js";
+import {
+  useSessionArtifacts,
+  type SessionArtifactEntry,
+} from "./useSessionArtifacts.js";
 import { SetupTab, type SetupTabProps } from "./facets/SetupTab.js";
 import { ChangesTab } from "./facets/ChangesTab.js";
 import { ArtifactsTab } from "./facets/ArtifactsTab.js";
@@ -33,6 +36,17 @@ export interface UseSessionRailViewsOptions {
    * of the preview modal.
    */
   readonly onOpenPlan?: (executionId: string) => void;
+  /**
+   * Open a (non-plan) artifact as an editor-pane document tab. Routed to the
+   * Artifacts facet so clicking an artifact opens it in the editor area (VS
+   * Code "each file is a tab") instead of the preview modal.
+   */
+  readonly onOpenArtifact?: (entry: SessionArtifactEntry) => void;
+  /**
+   * Pin a (non-plan) artifact's document tab — the double-click half of the
+   * Artifacts facet's open/activate split. Routed through to the facet's rows.
+   */
+  readonly onActivateArtifact?: (entry: SessionArtifactEntry) => void;
   /**
    * Whether to offer the execution-derived facets (Changes / Artifacts /
    * Usage). The launcher passes `false` — before a session exists there are no
@@ -60,6 +74,8 @@ export function useSessionRailViews({
   onApplied,
   onImplementPlan,
   onOpenPlan,
+  onOpenArtifact,
+  onActivateArtifact,
   includeExecutionFacets = true,
 }: UseSessionRailViewsOptions): readonly SurfaceRailView[] {
   const { hasWriteBacks, writeBackCount } = useSessionWriteBacks(allExecutions);
@@ -101,6 +117,8 @@ export function useSessionRailViews({
               onApplied={onApplied}
               onImplementPlan={onImplementPlan}
               onOpenPlan={onOpenPlan}
+              onOpenArtifact={onOpenArtifact}
+              onActivateArtifact={onActivateArtifact}
             />
           ),
         });
@@ -136,6 +154,8 @@ export function useSessionRailViews({
     onApplied,
     onImplementPlan,
     onOpenPlan,
+    onOpenArtifact,
+    onActivateArtifact,
     selectedItem,
   ]);
 }