@stigmer/react 3.1.0 → 3.1.2

package/src/environment/index.ts

@@ -1,52 +1,52 @@
-export { useCreateEnvironment } from "./useCreateEnvironment";
-export type { UseCreateEnvironmentReturn } from "./useCreateEnvironment";
-export { useEnvironment } from "./useEnvironment";
-export type { UseEnvironmentReturn } from "./useEnvironment";
-export { useEnvironmentList } from "./useEnvironmentList";
-export type { UseEnvironmentListReturn } from "./useEnvironmentList";
-export { usePersonalEnvironment } from "./usePersonalEnvironment";
-export type { UsePersonalEnvironmentReturn } from "./usePersonalEnvironment";
-export { useRevealSecretValue } from "./useRevealSecretValue";
+export { useCreateEnvironment } from "./useCreateEnvironment.js";
+export type { UseCreateEnvironmentReturn } from "./useCreateEnvironment.js";
+export { useEnvironment } from "./useEnvironment.js";
+export type { UseEnvironmentReturn } from "./useEnvironment.js";
+export { useEnvironmentList } from "./useEnvironmentList.js";
+export type { UseEnvironmentListReturn } from "./useEnvironmentList.js";
+export { usePersonalEnvironment } from "./usePersonalEnvironment.js";
+export type { UsePersonalEnvironmentReturn } from "./usePersonalEnvironment.js";
+export { useRevealSecretValue } from "./useRevealSecretValue.js";
 export type {
   UseRevealSecretValueOptions,
   UseRevealSecretValueReturn,
-} from "./useRevealSecretValue";
-export { useRemoveEnvironmentVariables } from "./useRemoveEnvironmentVariables";
+} from "./useRevealSecretValue.js";
+export { useRemoveEnvironmentVariables } from "./useRemoveEnvironmentVariables.js";
 export type {
   RemoveEnvironmentVariablesInput,
   UseRemoveEnvironmentVariablesReturn,
-} from "./useRemoveEnvironmentVariables";
-export { useUpdateEnvironment } from "./useUpdateEnvironment";
-export type { UseUpdateEnvironmentReturn } from "./useUpdateEnvironment";
-export { useUpdateEnvironmentVariables } from "./useUpdateEnvironmentVariables";
+} from "./useRemoveEnvironmentVariables.js";
+export { useUpdateEnvironment } from "./useUpdateEnvironment.js";
+export type { UseUpdateEnvironmentReturn } from "./useUpdateEnvironment.js";
+export { useUpdateEnvironmentVariables } from "./useUpdateEnvironmentVariables.js";
 export type {
   UpdateEnvironmentVariablesInput,
   UseUpdateEnvironmentVariablesReturn,
-} from "./useUpdateEnvironmentVariables";
-export { EnvironmentVariableEditor } from "./EnvironmentVariableEditor";
-export type { EnvironmentVariableEditorProps } from "./EnvironmentVariableEditor";
-export { EnvironmentListPanel } from "./EnvironmentListPanel";
-export type { EnvironmentListPanelProps } from "./EnvironmentListPanel";
-export { CreateEnvironmentForm } from "./CreateEnvironmentForm";
-export type { CreateEnvironmentFormProps } from "./CreateEnvironmentForm";
-export { EnvVarForm } from "./EnvVarForm";
+} from "./useUpdateEnvironmentVariables.js";
+export { EnvironmentVariableEditor } from "./EnvironmentVariableEditor.js";
+export type { EnvironmentVariableEditorProps } from "./EnvironmentVariableEditor.js";
+export { EnvironmentListPanel } from "./EnvironmentListPanel.js";
+export type { EnvironmentListPanelProps } from "./EnvironmentListPanel.js";
+export { CreateEnvironmentForm } from "./CreateEnvironmentForm.js";
+export type { CreateEnvironmentFormProps } from "./CreateEnvironmentForm.js";
+export { EnvVarForm } from "./EnvVarForm.js";
 export type {
   EnvVarFormProps,
   EnvVarFormVariable,
   EnvVarFormSubmitOptions,
-} from "./EnvVarForm";
-export { diffEnv } from "./diffEnv";
-export { useSessionEnvPool } from "./useSessionEnvPool";
+} from "./EnvVarForm.js";
+export { diffEnv } from "./diffEnv.js";
+export { useSessionEnvPool } from "./useSessionEnvPool.js";
 export type {
   SessionEnvPoolInput,
   UseSessionEnvPoolReturn,
-} from "./useSessionEnvPool";
+} from "./useSessionEnvPool.js";
 export {
   SYSTEM_ENV_VAR_KEYS,
   toGrpcAddress,
   buildSystemEnvVars,
   resolveSystemEnvVarValues,
   resolveDeclaredSystemEnvVars,
-} from "./systemEnvVars";
-export { EnvironmentPicker } from "./EnvironmentPicker";
-export type { EnvironmentPickerProps } from "./EnvironmentPicker";
+} from "./systemEnvVars.js";
+export { EnvironmentPicker } from "./EnvironmentPicker.js";
+export type { EnvironmentPickerProps } from "./EnvironmentPicker.js";

package/src/environment/useCreateEnvironment.ts

@@ -3,8 +3,8 @@
 import { useCallback, useState } from "react";
 import type { EnvironmentInput } from "@stigmer/sdk";
 import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
-import { useStigmer } from "../hooks";
-import { toError } from "../internal/toError";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
 
 /** Return value of {@link useCreateEnvironment}. */
 export interface UseCreateEnvironmentReturn {

package/src/environment/useEnvironment.ts

@@ -2,8 +2,8 @@
 
 import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
 import type { ResourceRef } from "@stigmer/sdk";
-import { useStigmer } from "../hooks";
-import { useFetch } from "../internal/useFetch";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
 
 /** Return value of {@link useEnvironment}. */
 export interface UseEnvironmentReturn {

package/src/environment/useEnvironmentList.ts

@@ -4,8 +4,8 @@ import { useRef } from "react";
 import { create } from "@bufbuild/protobuf";
 import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
 import { ListEnvironmentsRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
-import { useStigmer } from "../hooks";
-import { useFetch } from "../internal/useFetch";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
 
 /** Return value of {@link useEnvironmentList}. */
 export interface UseEnvironmentListReturn {

package/src/environment/usePersonalEnvironment.ts

@@ -9,10 +9,10 @@ import {
   RemoveEnvironmentVariablesRequestSchema,
 } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
 import { EnvironmentValueSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/spec_pb";
-import { useStigmer } from "../hooks";
-import { generateSlugSuffix } from "../internal/slug";
-import { toError } from "../internal/toError";
-import { useEnvironmentList } from "./useEnvironmentList";
+import { useStigmer } from "../hooks.js";
+import { generateSlugSuffix } from "../internal/slug.js";
+import { toError } from "../internal/toError.js";
+import { useEnvironmentList } from "./useEnvironmentList.js";
 
 const PERSONAL_LABELS: Record<string, string> = {
   "stigmer.ai/personal": "true",

package/src/environment/useRemoveEnvironmentVariables.ts

@@ -4,8 +4,8 @@ import { useCallback, useState } from "react";
 import { create } from "@bufbuild/protobuf";
 import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
 import { RemoveEnvironmentVariablesRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
-import { useStigmer } from "../hooks";
-import { toError } from "../internal/toError";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
 
 /**
  * Input for removing specific variables from an environment by key.

package/src/environment/useRevealSecretValue.ts

@@ -3,8 +3,8 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 import { create } from "@bufbuild/protobuf";
 import { EnvironmentSecretValueInputSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
-import { useStigmer } from "../hooks";
-import { toError } from "../internal/toError";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
 
 /** Options for {@link useRevealSecretValue}. */
 export interface UseRevealSecretValueOptions {

package/src/environment/useSessionEnvPool.ts

@@ -2,7 +2,7 @@
 
 import { useMemo } from "react";
 import type { EnvVarInput } from "@stigmer/sdk";
-import type { SessionVariableEntry } from "../execution/useSessionVariables";
+import type { SessionVariableEntry } from "../execution/useSessionVariables.js";
 
 /**
  * Inputs to the session env pool from all env-var sources.

package/src/environment/useUpdateEnvironment.ts

@@ -3,8 +3,8 @@
 import { useCallback, useState } from "react";
 import type { EnvironmentInput } from "@stigmer/sdk";
 import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
-import { useStigmer } from "../hooks";
-import { toError } from "../internal/toError";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
 
 /** Return value of {@link useUpdateEnvironment}. */
 export interface UseUpdateEnvironmentReturn {

package/src/environment/useUpdateEnvironmentVariables.ts

@@ -6,8 +6,8 @@ import type { EnvVarInput } from "@stigmer/sdk";
 import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
 import { UpdateEnvironmentVariablesRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
 import { EnvironmentValueSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/spec_pb";
-import { useStigmer } from "../hooks";
-import { toError } from "../internal/toError";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
 
 /**
  * Input for adding or updating specific variables in an environment.

package/src/error/index.ts

@@ -1,5 +1,5 @@
-export { ErrorMessage } from "./ErrorMessage";
-export type { ErrorMessageProps } from "./ErrorMessage";
+export { ErrorMessage } from "./ErrorMessage.js";
+export type { ErrorMessageProps } from "./ErrorMessage.js";
 
-export { SecretFlowErrorGuide, isSecretFlowError } from "./SecretFlowErrorGuide";
-export type { SecretFlowErrorGuideProps } from "./SecretFlowErrorGuide";
+export { SecretFlowErrorGuide, isSecretFlowError } from "./SecretFlowErrorGuide.js";
+export type { SecretFlowErrorGuideProps } from "./SecretFlowErrorGuide.js";

package/src/execution/ApprovalCard.tsx

@@ -8,21 +8,21 @@ import { cn } from "@stigmer/theme";
 import {
   describeApprovalPolicySource,
   isInformativePolicySource,
-} from "./approval-provenance";
+} from "./approval-provenance.js";
 import {
   resolveToolCategoryFromKind,
   extractPrimaryArgFromPreview,
   extractWriteContentFromPreview,
   isFileCategory,
   type ToolCategory,
-} from "./tool-categories";
-import { CATEGORY_ICON } from "./ToolCallItem";
-import { ToolArgsView } from "./ToolArgsView";
-import { EmptyChangeNotice } from "./EmptyChangeNotice";
-import { FilePathLink } from "./FilePathLink";
-import { DecisionButton } from "../internal/DecisionButton";
-import { InCardDecisionError } from "../internal/InCardDecisionError";
-import { useElapsedSince, formatElapsed } from "../internal/useElapsedSince";
+} from "./tool-categories.js";
+import { CATEGORY_ICON } from "./ToolCallItem.js";
+import { ToolArgsView } from "./ToolArgsView.js";
+import { EmptyChangeNotice } from "./EmptyChangeNotice.js";
+import { FilePathLink } from "./FilePathLink.js";
+import { DecisionButton } from "../internal/DecisionButton.js";
+import { InCardDecisionError } from "../internal/InCardDecisionError.js";
+import { useElapsedSince, formatElapsed } from "../internal/useElapsedSince.js";
 
 /** Props for {@link ApprovalCard}. */
 export interface ApprovalCardProps {

package/src/execution/ArtifactCard.tsx

@@ -3,11 +3,11 @@
 import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
 import { ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { cn } from "@stigmer/theme";
-import { useArtifactContent } from "./useArtifactContent";
-import { useArtifactDownload } from "./useArtifactDownload";
-import { isTextArtifact, formatArtifactSize } from "./artifact-utils";
-import { useDetectStigmerResource } from "../library/useDetectStigmerResource";
-import { useDetectSkillPackage } from "../library/useDetectSkillPackage";
+import { useArtifactContent } from "./useArtifactContent.js";
+import { useArtifactDownload } from "./useArtifactDownload.js";
+import { isTextArtifact, formatArtifactSize } from "./artifact-utils.js";
+import { useDetectStigmerResource } from "../library/useDetectStigmerResource.js";
+import { useDetectSkillPackage } from "../library/useDetectSkillPackage.js";
 
 /**
  * Artifacts larger than this threshold skip the content fetch used for

package/src/execution/ArtifactContentRenderer.tsx

@@ -1,17 +1,18 @@
 "use client";
 
-import { useMemo, useState, type ReactNode } from "react";
+import { useEffect, useMemo, useState, type ReactNode } from "react";
 import Markdown from "react-markdown";
 import { cn } from "@stigmer/theme";
 import {
   MARKDOWN_COMPONENTS,
   REMARK_PLUGINS,
   unwrapEnclosingMarkdownFence,
-} from "../internal/markdown-components";
+} from "../internal/markdown-components.js";
+import { useRevealLine, type RevealTarget } from "../internal/useRevealLine.js";
 import {
   getArtifactRenderMode,
   type ArtifactRenderMode,
-} from "./artifact-utils";
+} from "./artifact-utils.js";
 
 /** Props for {@link ArtifactContentRenderer}. */
 export interface ArtifactContentRendererProps {
@@ -29,6 +30,15 @@ export interface ArtifactContentRendererProps {
   readonly contentType?: string | null;
   /** When `true`, shows a truncation warning below the content. */
   readonly isTruncated?: boolean;
+  /**
+   * Optional jump-to-line request. When set, the content is rendered
+   * **line-faithfully** so the line number maps to the file's real rows —
+   * Markdown defaults to its Source view (a line only exists in source) and
+   * JSON renders raw rather than pretty-printed (reformatting would shift line
+   * numbers) — and the target line is scrolled into view and highlighted. Absent
+   * (the default), rendering is unchanged. See {@link RevealTarget}.
+   */
+  readonly reveal?: RevealTarget;
   /** Additional CSS classes for the root element. */
   readonly className?: string;
 }
@@ -76,6 +86,7 @@ export function ArtifactContentRenderer({
   fileName,
   contentType,
   isTruncated = false,
+  reveal,
   className,
 }: ArtifactContentRendererProps) {
   const mode = getArtifactRenderMode(fileName, contentType);
@@ -83,13 +94,19 @@ export function ArtifactContentRenderer({
   return (
     <div className={cn(className)}>
       {mode === "markdown" ? (
-        <MarkdownView content={content} />
+        <MarkdownView content={content} reveal={reveal} />
       ) : mode === "yaml" ? (
-        <YamlView content={content} />
+        <YamlView content={content} reveal={reveal} />
       ) : mode === "json" ? (
-        <JsonView content={content} />
+        // A reveal needs raw, line-faithful JSON: pretty-printing reformats the
+        // file and would shift the target line off its real row.
+        reveal ? (
+          <LineNumberedPre content={content} reveal={reveal} />
+        ) : (
+          <JsonView content={content} />
+        )
       ) : (
-        <PlainTextView content={content} />
+        <PlainTextView content={content} reveal={reveal} />
       )}
 
       {isTruncated && <TruncationWarning />}
@@ -103,8 +120,21 @@ export function ArtifactContentRenderer({
 
 type MarkdownTab = "rendered" | "source";
 
-function MarkdownView({ content }: { readonly content: string }) {
-  const [tab, setTab] = useState<MarkdownTab>("rendered");
+function MarkdownView({
+  content,
+  reveal,
+}: {
+  readonly content: string;
+  readonly reveal?: RevealTarget;
+}) {
+  // A reveal targets a source line (the rendered HTML has no line concept), so
+  // default to — and, on every new reveal, return to — the Source view.
+  const [tab, setTab] = useState<MarkdownTab>(reveal ? "source" : "rendered");
+  // Keyed on the reveal nonce: each fresh jump-to-line returns to Source (where
+  // the line exists); switching to Rendered afterward sticks until the next hit.
+  useEffect(() => {
+    if (reveal) setTab("source");
+  }, [reveal?.nonce]);
 
   // A `.md` whose entire body is one ```markdown fence (e.g. a model-wrapped
   // plan) would render flat. Unwrap for the Rendered view only — Source stays
@@ -145,7 +175,7 @@ function MarkdownView({ content }: { readonly content: string }) {
           </Markdown>
         </div>
       ) : (
-        <LineNumberedPre content={content} />
+        <LineNumberedPre content={content} reveal={reveal} />
       )}
     </div>
   );
@@ -197,15 +227,6 @@ function TabButton({
  *
  * Values and block scalar content render in the default `text-foreground`.
  */
-function highlightYaml(content: string): ReactNode {
-  return content.split("\n").map((line, i) => (
-    <span key={i}>
-      {i > 0 && "\n"}
-      {highlightYamlLine(line)}
-    </span>
-  ));
-}
-
 function highlightYamlLine(line: string): ReactNode {
   if (!line.trim()) return line;
 
@@ -253,10 +274,38 @@ function highlightYamlValue(value: string): ReactNode {
   return <>{value}</>;
 }
 
-function YamlView({ content }: { readonly content: string }) {
+function YamlView({
+  content,
+  reveal,
+}: {
+  readonly content: string;
+  readonly reveal?: RevealTarget;
+}) {
+  const { containerRef, isRevealed } = useRevealLine(reveal);
+  const lines = content.split("\n");
+
   return (
     <pre className="overflow-x-auto p-4 font-mono text-xs leading-relaxed text-foreground">
-      <code>{highlightYaml(content)}</code>
+      <code ref={containerRef}>
+        {lines.map((line, i) => (
+          <span
+            key={i}
+            data-line={i + 1}
+            className={cn(
+              // Transparent left border by default so revealing a line only
+              // changes its color — never shifts the text (no layout jump).
+              "block border-l-2 border-transparent",
+              isRevealed(i + 1) && "border-primary bg-primary-subtle",
+            )}
+          >
+            {/* whitespace-pre inner + `\n` fallback preserves indentation and
+                the height of blank lines, mirroring LineNumberedPre. */}
+            <span className="whitespace-pre">
+              {line.trim() ? highlightYamlLine(line) : "\n"}
+            </span>
+          </span>
+        ))}
+      </code>
     </pre>
   );
 }
@@ -345,19 +394,47 @@ function JsonView({ content }: { readonly content: string }) {
 // Plain text view (monospace + line numbers)
 // ---------------------------------------------------------------------------
 
-function PlainTextView({ content }: { readonly content: string }) {
-  return <LineNumberedPre content={content} />;
+function PlainTextView({
+  content,
+  reveal,
+}: {
+  readonly content: string;
+  readonly reveal?: RevealTarget;
+}) {
+  return <LineNumberedPre content={content} reveal={reveal} />;
 }
 
-function LineNumberedPre({ content }: { readonly content: string }) {
+/**
+ * Line-numbered monospace view. The single line-faithful primitive behind plain
+ * text, Markdown Source, and reveal-mode JSON: every row is addressable
+ * (`data-line`), so a {@link RevealTarget} can scroll to and highlight a line
+ * (via {@link useRevealLine}). Absent a reveal it renders exactly as before.
+ */
+function LineNumberedPre({
+  content,
+  reveal,
+}: {
+  readonly content: string;
+  readonly reveal?: RevealTarget;
+}) {
+  const { containerRef, isRevealed } = useRevealLine(reveal);
   const lines = content.split("\n");
   const gutterWidth = String(lines.length).length;
 
   return (
     <pre className="overflow-x-auto font-mono text-xs leading-relaxed text-foreground">
-      <code>
+      <code ref={containerRef}>
         {lines.map((line, i) => (
-          <span key={i} className="flex">
+          <span
+            key={i}
+            data-line={i + 1}
+            className={cn(
+              // Transparent left border by default so a reveal only recolors the
+              // row — never shifts its text (no layout jump).
+              "flex border-l-2 border-transparent",
+              isRevealed(i + 1) && "border-primary bg-primary-subtle",
+            )}
+          >
             <span
               className="sticky left-0 select-none bg-background pr-4 text-right text-muted-foreground"
               style={{ minWidth: `${gutterWidth + 2}ch` }}

package/src/execution/ArtifactPreviewModal.tsx

@@ -4,17 +4,17 @@ import { useCallback, useEffect, useRef, useState } from "react";
 import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
 import { ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { cn } from "@stigmer/theme";
-import { useArtifactContent } from "./useArtifactContent";
-import { useArtifactDownload } from "./useArtifactDownload";
-import { isTextArtifact, formatArtifactSize } from "./artifact-utils";
-import { ArtifactContentRenderer } from "./ArtifactContentRenderer";
-import { useDetectStigmerResource } from "../library/useDetectStigmerResource";
-import { useDetectSkillPackage } from "../library/useDetectSkillPackage";
-import type { SkillPackageDetection } from "../library/detect-skill-package";
+import { useArtifactContent } from "./useArtifactContent.js";
+import { useArtifactDownload } from "./useArtifactDownload.js";
+import { isTextArtifact, formatArtifactSize } from "./artifact-utils.js";
+import { ArtifactContentRenderer } from "./ArtifactContentRenderer.js";
+import { useDetectStigmerResource } from "../library/useDetectStigmerResource.js";
+import { useDetectSkillPackage } from "../library/useDetectSkillPackage.js";
+import type { SkillPackageDetection } from "../library/detect-skill-package.js";
 import {
   useApplyResource,
   type ApplyResourceResult,
-} from "../library/useApplyResource";
+} from "../library/useApplyResource.js";
 
 const COPIED_FEEDBACK_MS = 2000;
 

package/src/execution/ArtifactsWidget.tsx

@@ -6,10 +6,10 @@ import { cn } from "@stigmer/theme";
 import {
   useSessionArtifacts,
   type SessionArtifactEntry,
-} from "../session/useSessionArtifacts";
-import { ArtifactCard } from "./ArtifactCard";
-import { ArtifactPreviewModal } from "./ArtifactPreviewModal";
-import type { ApplyResourceResult } from "../library/useApplyResource";
+} from "../session/useSessionArtifacts.js";
+import { ArtifactCard } from "./ArtifactCard.js";
+import { ArtifactPreviewModal } from "./ArtifactPreviewModal.js";
+import type { ApplyResourceResult } from "../library/useApplyResource.js";
 
 /** Props for {@link ArtifactsWidget}. */
 export interface ArtifactsWidgetProps {

package/src/execution/ContextGauge.tsx

@@ -7,8 +7,8 @@ import {
   useContextWindow,
   type ContextHealth,
   type UseContextWindowReturn,
-} from "./useContextWindow";
-import { formatTokenCount } from "./UsageWidget";
+} from "./useContextWindow.js";
+import { formatTokenCount } from "./UsageWidget.js";
 
 /** Props for {@link ContextGauge}. */
 export interface ContextGaugeProps {

package/src/execution/ExecutionProgress.tsx

@@ -2,8 +2,8 @@
 
 import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
 import { cn } from "@stigmer/theme";
-import { ExecutionPhaseBadge } from "./ExecutionPhaseBadge";
-import { TodoList } from "./TodoList";
+import { ExecutionPhaseBadge } from "./ExecutionPhaseBadge.js";
+import { TodoList } from "./TodoList.js";
 
 /** Props for {@link ExecutionProgress}. */
 export interface ExecutionProgressProps {

package/src/execution/FileChangesView.tsx

@@ -7,16 +7,16 @@ import {
   FileChangeType,
 } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { cn } from "@stigmer/theme";
-import { BoundedContent } from "../internal/BoundedContent";
-import { computeDiff } from "../version-history/computeDiff";
-import { DiffViewer } from "../version-history/DiffViewer";
-import { DiffFileList } from "../version-history/DiffFileList";
-import { DiffSummary } from "../version-history/DiffSummary";
-import { UnifiedDiffView } from "../version-history/UnifiedDiffView";
-import type { DiffHunk, FileDiffEntry } from "../version-history/types";
-import { FilePathLink } from "./FilePathLink";
-import { EmptyChangeNotice } from "./EmptyChangeNotice";
-import { useFileChangeContent } from "./useFileChangeContent";
+import { BoundedContent } from "../internal/BoundedContent.js";
+import { computeDiff } from "../version-history/computeDiff.js";
+import { DiffViewer } from "../version-history/DiffViewer.js";
+import { DiffFileList } from "../version-history/DiffFileList.js";
+import { DiffSummary } from "../version-history/DiffSummary.js";
+import { UnifiedDiffView } from "../version-history/UnifiedDiffView.js";
+import type { DiffHunk, FileDiffEntry } from "../version-history/types.js";
+import { FilePathLink } from "./FilePathLink.js";
+import { EmptyChangeNotice } from "./EmptyChangeNotice.js";
+import { useFileChangeContent } from "./useFileChangeContent.js";
 
 /** Props for {@link FileChangesView}. */
 export interface FileChangesViewProps {

package/src/execution/FilePathContext.tsx

@@ -1,6 +1,6 @@
 import { createContext } from "react";
 import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
-import type { ResolvedPathAction } from "./file-path-resolver";
+import type { ResolvedPathAction } from "./file-path-resolver.js";
 
 /**
  * Context value that carries workspace entries and an optional click
@@ -18,11 +18,18 @@ export interface FilePathContextValue {
    * `FilePathLink` delegates to this callback instead of opening
    * a URL or copying to clipboard. Platform builders use this to
    * integrate their own file viewer or navigation.
+   *
+   * Return `false` to **decline** a specific path — `FilePathLink` then falls
+   * back to its default action (open the GitHub link / copy the path), so a
+   * handler that can only open *some* paths (e.g. resolvable workspace files)
+   * leaves the rest behaving as before. Returning `true` or `void` means the
+   * click was fully handled and the default is suppressed — preserving the
+   * behavior of existing `void`-returning handlers.
    */
   readonly onFilePathClick?: (
     path: string,
     resolved: ResolvedPathAction,
-  ) => void;
+  ) => boolean | void;
 }
 
 const DEFAULT_VALUE: FilePathContextValue = {