@stigmer/react 0.0.36 → 0.0.40

package/execution/artifact-utils.js

@@ -0,0 +1,123 @@
+import { ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * File extensions recognized as human-readable text content.
+ *
+ * Used by {@link isTextArtifact} to determine whether an artifact's
+ * content can be fetched and displayed as text (YAML preview, resource
+ * detection, syntax-highlighted preview).
+ *
+ * Covers configuration formats, documentation, and common source code
+ * extensions that Stigmer agents typically produce.
+ */
+const TEXT_EXTENSIONS = new Set([
+    "yaml",
+    "yml",
+    "json",
+    "md",
+    "txt",
+    "toml",
+    "xml",
+    "csv",
+    "log",
+    "sh",
+    "bash",
+    "py",
+    "ts",
+    "js",
+    "go",
+    "rs",
+    "html",
+    "css",
+    "sql",
+    "env",
+    "cfg",
+    "ini",
+    "conf",
+]);
+/**
+ * Extracts the lowercase file extension from an artifact's name.
+ *
+ * Returns `null` when the name has no extension or is empty.
+ *
+ * @example
+ * ```ts
+ * getArtifactExtension(artifact); // "yaml"
+ * getArtifactExtension(noExtArtifact); // null
+ * ```
+ */
+export function getArtifactExtension(artifact) {
+    const name = artifact.name;
+    const lastDot = name.lastIndexOf(".");
+    if (lastDot === -1 || lastDot === name.length - 1)
+        return null;
+    return name.slice(lastDot + 1).toLowerCase();
+}
+/**
+ * Determines whether an artifact likely contains human-readable text.
+ *
+ * Returns `false` for directory artifacts (which are stored as ZIP files)
+ * regardless of name. For file artifacts, checks whether the file
+ * extension is in the {@link TEXT_EXTENSIONS} set.
+ *
+ * Use this to decide whether to call {@link useArtifactContent} for
+ * a given artifact. Binary or unknown-extension artifacts should use
+ * the download URL instead.
+ *
+ * @example
+ * ```ts
+ * const shouldFetch = isTextArtifact(artifact) && Number(artifact.sizeBytes) < MAX_SIZE;
+ * ```
+ */
+export function isTextArtifact(artifact) {
+    if (artifact.kind === ExecutionArtifactKind.DIRECTORY)
+        return false;
+    const ext = getArtifactExtension(artifact);
+    if (ext === null)
+        return false;
+    return TEXT_EXTENSIONS.has(ext);
+}
+/**
+ * Checks whether an artifact's pre-signed download URL has expired.
+ *
+ * Returns `true` when:
+ * - `expiresAt` is empty or cannot be parsed as a valid date
+ * - The current time is past the expiration timestamp
+ *
+ * Expired URLs can be refreshed via `stigmer.agentExecution.getArtifactDownloadUrl()`.
+ */
+export function isArtifactExpired(artifact) {
+    if (!artifact.expiresAt)
+        return true;
+    const expiresMs = Date.parse(artifact.expiresAt);
+    if (Number.isNaN(expiresMs))
+        return true;
+    return Date.now() >= expiresMs;
+}
+const SIZE_UNITS = ["B", "KB", "MB", "GB", "TB"];
+/**
+ * Formats a byte count as a human-readable file size string.
+ *
+ * Accepts both `bigint` (from protobuf `int64` fields like
+ * `ExecutionArtifact.sizeBytes`) and `number`.
+ *
+ * Uses base-1024 (binary) units with one decimal place.
+ *
+ * @example
+ * ```ts
+ * formatArtifactSize(0n);       // "0 B"
+ * formatArtifactSize(1024);     // "1.0 KB"
+ * formatArtifactSize(1536n);    // "1.5 KB"
+ * formatArtifactSize(2621440n); // "2.5 MB"
+ * ```
+ */
+export function formatArtifactSize(sizeBytes) {
+    const bytes = typeof sizeBytes === "bigint" ? Number(sizeBytes) : sizeBytes;
+    if (bytes === 0)
+        return "0 B";
+    const unitIndex = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), SIZE_UNITS.length - 1);
+    const value = bytes / Math.pow(1024, unitIndex);
+    return unitIndex === 0
+        ? `${bytes} B`
+        : `${value.toFixed(1)} ${SIZE_UNITS[unitIndex]}`;
+}
+//# sourceMappingURL=artifact-utils.js.map

package/execution/artifact-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-utils.js","sourceRoot":"","sources":["../../src/execution/artifact-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AAErG;;;;;;;;;GASG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;CACP,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA2B;IAE3B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,OAAO,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,QAA2B;IACxD,IAAI,QAAQ,CAAC,IAAI,KAAK,qBAAqB,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAEpE,MAAM,GAAG,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAE/B,OAAO,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAA2B;IAC3D,IAAI,CAAC,QAAQ,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA0B;IAC3D,MAAM,KAAK,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAC5C,UAAU,CAAC,MAAM,GAAG,CAAC,CACtB,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAEhD,OAAO,SAAS,KAAK,CAAC;QACpB,CAAC,CAAC,GAAG,KAAK,IAAI;QACd,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/execution/execution-phases.d.ts

@@ -0,0 +1,7 @@
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * Returns `true` when the given phase represents a final, immutable
+ * execution state — no further updates will arrive from the server.
+ */
+export declare function isTerminalPhase(phase: ExecutionPhase): boolean;
+//# sourceMappingURL=execution-phases.d.ts.map

package/execution/execution-phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-phases.d.ts","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAS9F;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE9D"}

package/execution/execution-phases.js

@@ -0,0 +1,15 @@
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+const TERMINAL_PHASES = new Set([
+    ExecutionPhase.EXECUTION_COMPLETED,
+    ExecutionPhase.EXECUTION_FAILED,
+    ExecutionPhase.EXECUTION_CANCELLED,
+    ExecutionPhase.EXECUTION_TERMINATED,
+]);
+/**
+ * Returns `true` when the given phase represents a final, immutable
+ * execution state — no further updates will arrive from the server.
+ */
+export function isTerminalPhase(phase) {
+    return TERMINAL_PHASES.has(phase);
+}
+//# sourceMappingURL=execution-phases.js.map

package/execution/execution-phases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-phases.js","sourceRoot":"","sources":["../../src/execution/execution-phases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,MAAM,eAAe,GAAgC,IAAI,GAAG,CAAC;IAC3D,cAAc,CAAC,mBAAmB;IAClC,cAAc,CAAC,gBAAgB;IAC/B,cAAc,CAAC,mBAAmB;IAClC,cAAc,CAAC,oBAAoB;CACpC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/execution/file-path-resolver.d.ts

@@ -0,0 +1,63 @@
+import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+/**
+ * Result of classifying a tool-call file path against the virtual
+ * platform mount (`.stigmer/`) namespace.
+ */
+export type PathClassification = {
+    readonly kind: "workspace";
+    readonly remainder: string;
+} | {
+    readonly kind: "platform";
+    readonly subpath: string;
+};
+/**
+ * Classifies whether a path targets the virtual platform mount
+ * (`.stigmer/skills/`, `.stigmer/inputs/`, etc.) or the workspace.
+ *
+ * Mirrors the Python `classify_platform_path` in
+ * `graphton.core.backends.platform_mount` — same semantics, same
+ * edge-case handling (leading-slash stripping, bare `.stigmer`).
+ */
+export declare function classifyPath(path: string): PathClassification;
+/**
+ * Constructs a browsable GitHub blob URL from a git clone URL.
+ *
+ * Returns `null` for non-GitHub hosts (graceful degradation — the
+ * caller falls back to copy-to-clipboard).
+ *
+ * @param gitUrl   HTTPS clone URL (e.g. `https://github.com/acme/app.git`)
+ * @param branch   Branch name (may be empty for default branch)
+ * @param commit   Commit SHA (takes precedence over branch when set)
+ * @param relPath  Workspace-relative file path
+ */
+export declare function resolveGitBrowseUrl(gitUrl: string, branch: string, commit: string, relPath: string): string | null;
+/**
+ * Resolved action for a file path. Consumed by {@link FilePathLink}
+ * to decide rendering (anchor vs. copy button).
+ */
+export type ResolvedPathAction = {
+    readonly action: "link";
+    readonly url: string;
+    readonly tooltip: string;
+} | {
+    readonly action: "copy";
+    readonly value: string;
+    readonly tooltip: string;
+};
+/**
+ * Resolves a tool-call file path to a user action.
+ *
+ * Resolution strategy (mirrors the CLI's `buildHyperlinkedPath`):
+ *
+ * 1. **Platform paths** (`.stigmer/` prefix) → copy raw path.
+ * 2. **Workspace paths** → match against workspace entries:
+ *    - Single entry: treat path as relative to that entry.
+ *    - Multiple entries: match first path segment against entry names.
+ *      Unmatched segments fall back to the first entry (optimistic —
+ *      single-workspace sessions are the common case).
+ * 3. **Git source** → construct GitHub blob URL.
+ * 4. **Local source** → join with absolute local path for copy.
+ * 5. **Fallback** → copy the raw path.
+ */
+export declare function resolvePathAction(path: string, workspaceEntries: readonly WorkspaceEntry[]): ResolvedPathAction;
+//# sourceMappingURL=file-path-resolver.d.ts.map

package/execution/file-path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-path-resolver.d.ts","sourceRoot":"","sources":["../../src/execution/file-path-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAKjG;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAU7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAkBf;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,SAAS,cAAc,EAAE,GAC1C,kBAAkB,CAqCpB"}

package/execution/file-path-resolver.js

@@ -0,0 +1,121 @@
+const PLATFORM_PREFIX = ".stigmer/";
+const PLATFORM_DIR_NAME = ".stigmer";
+/**
+ * Classifies whether a path targets the virtual platform mount
+ * (`.stigmer/skills/`, `.stigmer/inputs/`, etc.) or the workspace.
+ *
+ * Mirrors the Python `classify_platform_path` in
+ * `graphton.core.backends.platform_mount` — same semantics, same
+ * edge-case handling (leading-slash stripping, bare `.stigmer`).
+ */
+export function classifyPath(path) {
+    const clean = path.replace(/^\/+/, "");
+    if (clean.startsWith(PLATFORM_PREFIX)) {
+        return { kind: "platform", subpath: clean.slice(PLATFORM_PREFIX.length) };
+    }
+    if (clean === PLATFORM_DIR_NAME) {
+        return { kind: "platform", subpath: "" };
+    }
+    return { kind: "workspace", remainder: clean };
+}
+/**
+ * Constructs a browsable GitHub blob URL from a git clone URL.
+ *
+ * Returns `null` for non-GitHub hosts (graceful degradation — the
+ * caller falls back to copy-to-clipboard).
+ *
+ * @param gitUrl   HTTPS clone URL (e.g. `https://github.com/acme/app.git`)
+ * @param branch   Branch name (may be empty for default branch)
+ * @param commit   Commit SHA (takes precedence over branch when set)
+ * @param relPath  Workspace-relative file path
+ */
+export function resolveGitBrowseUrl(gitUrl, branch, commit, relPath) {
+    let url;
+    try {
+        url = new URL(gitUrl);
+    }
+    catch {
+        return null;
+    }
+    if (url.hostname !== "github.com")
+        return null;
+    // Strip trailing `.git` and leading/trailing slashes from pathname
+    const repoPath = url.pathname.replace(/\.git$/, "").replace(/^\/|\/$/g, "");
+    if (!repoPath)
+        return null;
+    const ref = commit || branch || "HEAD";
+    const cleanRelPath = relPath.replace(/^\/+/, "");
+    return `https://github.com/${repoPath}/blob/${ref}/${cleanRelPath}`;
+}
+/**
+ * Resolves a tool-call file path to a user action.
+ *
+ * Resolution strategy (mirrors the CLI's `buildHyperlinkedPath`):
+ *
+ * 1. **Platform paths** (`.stigmer/` prefix) → copy raw path.
+ * 2. **Workspace paths** → match against workspace entries:
+ *    - Single entry: treat path as relative to that entry.
+ *    - Multiple entries: match first path segment against entry names.
+ *      Unmatched segments fall back to the first entry (optimistic —
+ *      single-workspace sessions are the common case).
+ * 3. **Git source** → construct GitHub blob URL.
+ * 4. **Local source** → join with absolute local path for copy.
+ * 5. **Fallback** → copy the raw path.
+ */
+export function resolvePathAction(path, workspaceEntries) {
+    if (!path) {
+        return { action: "copy", value: path, tooltip: "Copy path" };
+    }
+    const classification = classifyPath(path);
+    if (classification.kind === "platform") {
+        return { action: "copy", value: path, tooltip: "Copy path" };
+    }
+    const { remainder } = classification;
+    if (workspaceEntries.length === 0) {
+        return { action: "copy", value: path, tooltip: "Copy path" };
+    }
+    const { entry, relPath } = matchWorkspaceEntry(remainder, workspaceEntries);
+    const source = entry.source?.source;
+    if (source?.case === "gitRepo") {
+        const url = resolveGitBrowseUrl(source.value.url, source.value.branch, source.value.commit, relPath);
+        if (url) {
+            return { action: "link", url, tooltip: "Open on GitHub" };
+        }
+    }
+    if (source?.case === "localPath") {
+        const abs = joinLocalPath(source.value.path, relPath);
+        return { action: "copy", value: abs, tooltip: "Copy path" };
+    }
+    return { action: "copy", value: path, tooltip: "Copy path" };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Matches a workspace-relative path against entries. With a single
+ * entry the path is used as-is. With multiple entries the first path
+ * segment is tested against entry names; unmatched paths fall back to
+ * the first entry (same strategy as the CLI).
+ */
+function matchWorkspaceEntry(relPath, entries) {
+    if (entries.length === 1) {
+        return { entry: entries[0], relPath };
+    }
+    const slashIdx = relPath.indexOf("/");
+    const firstSegment = slashIdx >= 0 ? relPath.slice(0, slashIdx) : relPath;
+    for (const entry of entries) {
+        if (entry.name === firstSegment) {
+            const rest = slashIdx >= 0 ? relPath.slice(slashIdx + 1) : "";
+            return { entry, relPath: rest };
+        }
+    }
+    return { entry: entries[0], relPath };
+}
+function joinLocalPath(base, rel) {
+    if (!rel)
+        return base;
+    const cleanBase = base.replace(/\/+$/, "");
+    const cleanRel = rel.replace(/^\/+/, "");
+    return `${cleanBase}/${cleanRel}`;
+}
+//# sourceMappingURL=file-path-resolver.js.map

package/execution/file-path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-path-resolver.js","sourceRoot":"","sources":["../../src/execution/file-path-resolver.ts"],"names":[],"mappings":"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"}

package/execution/index.d.ts

@@ -0,0 +1,55 @@
+export { useCreateAgentExecution } from "./useCreateAgentExecution";
+export type { CreateAgentExecutionInput, CreateAgentExecutionResult, UseCreateAgentExecutionReturn, } from "./useCreateAgentExecution";
+export { isTerminalPhase } from "./execution-phases";
+export { useExecutionStream } from "./useExecutionStream";
+export type { UseExecutionStreamReturn } from "./useExecutionStream";
+export { useExecutionUsage, aggregateUsage } from "./useExecutionUsage";
+export type { UseExecutionUsageReturn } from "./useExecutionUsage";
+export { useExecutionArtifacts } from "./useExecutionArtifacts";
+export type { UseExecutionArtifactsReturn } from "./useExecutionArtifacts";
+export { useArtifactContent } from "./useArtifactContent";
+export type { UseArtifactContentReturn } from "./useArtifactContent";
+export { isTextArtifact, isArtifactExpired, formatArtifactSize, getArtifactExtension, } from "./artifact-utils";
+export { ExecutionPhaseBadge } from "./ExecutionPhaseBadge";
+export type { ExecutionPhaseBadgeProps } from "./ExecutionPhaseBadge";
+export { ToolCallGroup } from "./ToolCallGroup";
+export type { ToolCallGroupProps } from "./ToolCallGroup";
+export { ToolCallDetail, formatDuration } from "./ToolCallDetail";
+export type { ToolCallDetailProps } from "./ToolCallDetail";
+export { ToolCallItem } from "./ToolCallItem";
+export type { ToolCallItemProps } from "./ToolCallItem";
+export { SubAgentSection } from "./SubAgentSection";
+export type { SubAgentSectionProps } from "./SubAgentSection";
+export { MessageEntry } from "./MessageEntry";
+export type { MessageEntryProps } from "./MessageEntry";
+export { MessageThread } from "./MessageThread";
+export type { MessageThreadProps } from "./MessageThread";
+export { FollowUpInput } from "./FollowUpInput";
+export type { FollowUpInputProps } from "./FollowUpInput";
+export { ExecutionProgress } from "./ExecutionProgress";
+export type { ExecutionProgressProps } from "./ExecutionProgress";
+export { ExecutionCostSummary, formatCost, formatTokenCount } from "./ExecutionCostSummary";
+export type { ExecutionCostSummaryProps } from "./ExecutionCostSummary";
+export { useSubmitApproval } from "./useSubmitApproval";
+export type { UseSubmitApprovalReturn } from "./useSubmitApproval";
+export { ApprovalCard } from "./ApprovalCard";
+export type { ApprovalCardProps } from "./ApprovalCard";
+export { ArtifactCard } from "./ArtifactCard";
+export type { ArtifactCardProps } from "./ArtifactCard";
+export { ArtifactPreviewModal } from "./ArtifactPreviewModal";
+export type { ArtifactPreviewModalProps } from "./ArtifactPreviewModal";
+export { ArtifactsWidget } from "./ArtifactsWidget";
+export type { ArtifactsWidgetProps } from "./ArtifactsWidget";
+export { resolveToolCategory, extractPrimaryArg, extractPrimaryArgFromPreview, } from "./tool-categories";
+export type { ToolCategory, ToolCategoryInfo } from "./tool-categories";
+export { FilePathLink } from "./FilePathLink";
+export type { FilePathLinkProps } from "./FilePathLink";
+export { FilePathContext } from "./FilePathContext";
+export type { FilePathContextValue } from "./FilePathContext";
+export { classifyPath, resolveGitBrowseUrl, resolvePathAction } from "./file-path-resolver";
+export type { PathClassification, ResolvedPathAction } from "./file-path-resolver";
+export { useSessionVariables } from "./useSessionVariables";
+export type { SessionVariableEntry, UseSessionVariablesReturn, } from "./useSessionVariables";
+export { SessionVariablesInput } from "./SessionVariablesInput";
+export type { SessionVariablesInputProps } from "./SessionVariablesInput";
+//# sourceMappingURL=index.d.ts.map

package/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"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"}

package/execution/index.js

@@ -0,0 +1,29 @@
+export { useCreateAgentExecution } from "./useCreateAgentExecution";
+export { isTerminalPhase } from "./execution-phases";
+export { useExecutionStream } from "./useExecutionStream";
+export { useExecutionUsage, aggregateUsage } from "./useExecutionUsage";
+export { useExecutionArtifacts } from "./useExecutionArtifacts";
+export { useArtifactContent } from "./useArtifactContent";
+export { isTextArtifact, isArtifactExpired, formatArtifactSize, getArtifactExtension, } from "./artifact-utils";
+export { ExecutionPhaseBadge } from "./ExecutionPhaseBadge";
+export { ToolCallGroup } from "./ToolCallGroup";
+export { ToolCallDetail, formatDuration } from "./ToolCallDetail";
+export { ToolCallItem } from "./ToolCallItem";
+export { SubAgentSection } from "./SubAgentSection";
+export { MessageEntry } from "./MessageEntry";
+export { MessageThread } from "./MessageThread";
+export { FollowUpInput } from "./FollowUpInput";
+export { ExecutionProgress } from "./ExecutionProgress";
+export { ExecutionCostSummary, formatCost, formatTokenCount } from "./ExecutionCostSummary";
+export { useSubmitApproval } from "./useSubmitApproval";
+export { ApprovalCard } from "./ApprovalCard";
+export { ArtifactCard } from "./ArtifactCard";
+export { ArtifactPreviewModal } from "./ArtifactPreviewModal";
+export { ArtifactsWidget } from "./ArtifactsWidget";
+export { resolveToolCategory, extractPrimaryArg, extractPrimaryArgFromPreview, } from "./tool-categories";
+export { FilePathLink } from "./FilePathLink";
+export { FilePathContext } from "./FilePathContext";
+export { classifyPath, resolveGitBrowseUrl, resolvePathAction } from "./file-path-resolver";
+export { useSessionVariables } from "./useSessionVariables";
+export { SessionVariablesInput } from "./SessionVariablesInput";
+//# sourceMappingURL=index.js.map

package/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAOpE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/execution/tool-categories.d.ts

@@ -0,0 +1,36 @@
+import type { ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+/**
+ * Discriminated tool categories for type-aware rendering.
+ *
+ * Mirrors the CLI's `toolDisplayMap` in
+ * `client-apps/cli/pkg/toolrender/render.go`.
+ */
+export type ToolCategory = "shell" | "read" | "write" | "edit" | "delete" | "search" | "list" | "think" | "sub-agent" | "unknown";
+export interface ToolCategoryInfo {
+    readonly category: ToolCategory;
+    readonly label: string;
+    readonly primaryArgField: string;
+    readonly fallbackArgFields: readonly string[];
+}
+/**
+ * Resolves a tool name to its category metadata for type-aware
+ * rendering. Returns a stable `"unknown"` entry for unrecognized
+ * tools using the raw tool name as the label.
+ */
+export declare function resolveToolCategory(toolName: string): ToolCategoryInfo;
+/**
+ * Extracts the most relevant argument value from a tool call
+ * based on its category (command for shell tools, path for file
+ * tools, pattern for search tools, etc.).
+ *
+ * Returns `null` when the tool is unknown and has no arguments,
+ * or when the expected argument fields are missing.
+ */
+export declare function extractPrimaryArg(toolCall: ToolCall): string | null;
+/**
+ * Extracts the primary argument value from a JSON string
+ * (typically `PendingApproval.argsPreview`). Returns `null` if
+ * parsing fails or the expected field is not found.
+ */
+export declare function extractPrimaryArgFromPreview(toolName: string, argsPreview: string): string | null;
+//# sourceMappingURL=tool-categories.d.ts.map

package/execution/tool-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-categories.d.ts","sourceRoot":"","sources":["../../src/execution/tool-categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAGhG;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AA0CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAgBtE;AA4BD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAmBnE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAgBf"}

package/execution/tool-categories.js

@@ -0,0 +1,110 @@
+const TOOL_DISPLAY_MAP = new Map([
+    ["shell", { category: "shell", label: "Shell", primaryField: "command" }],
+    ["bash", { category: "shell", label: "Shell", primaryField: "command" }],
+    ["execute", { category: "shell", label: "Execute", primaryField: "command" }],
+    ["execute_command", { category: "shell", label: "Shell", primaryField: "command" }],
+    ["run_command", { category: "shell", label: "Shell", primaryField: "command" }],
+    ["terminal", { category: "shell", label: "Shell", primaryField: "command" }],
+    ["read", { category: "read", label: "Read", primaryField: "path", fallbackFields: ["file_path", "file"] }],
+    ["read_file", { category: "read", label: "Read", primaryField: "path", fallbackFields: ["file_path", "file"] }],
+    ["write", { category: "write", label: "Write", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["write_file", { category: "write", label: "Write", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["create_file", { category: "write", label: "Create", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["overwrite_file", { category: "write", label: "Write", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["edit", { category: "edit", label: "Edit", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["edit_file", { category: "edit", label: "Edit", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["delete_file", { category: "delete", label: "Delete", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["remove_file", { category: "delete", label: "Delete", primaryField: "path", fallbackFields: ["file_path", "file", "filename"] }],
+    ["glob", { category: "search", label: "Find", primaryField: "pattern" }],
+    ["grep", { category: "search", label: "Search", primaryField: "pattern" }],
+    ["list_directory", { category: "list", label: "List", primaryField: "path" }],
+    ["ls", { category: "list", label: "List", primaryField: "path" }],
+    ["think", { category: "think", label: "Thinking", primaryField: "thought" }],
+    ["task", { category: "sub-agent", label: "Sub-agent", primaryField: "description", fallbackFields: ["prompt"] }],
+]);
+/**
+ * Resolves a tool name to its category metadata for type-aware
+ * rendering. Returns a stable `"unknown"` entry for unrecognized
+ * tools using the raw tool name as the label.
+ */
+export function resolveToolCategory(toolName) {
+    const entry = TOOL_DISPLAY_MAP.get(toolName);
+    if (entry) {
+        return {
+            category: entry.category,
+            label: entry.label,
+            primaryArgField: entry.primaryField,
+            fallbackArgFields: entry.fallbackFields ?? [],
+        };
+    }
+    return {
+        category: "unknown",
+        label: toolName,
+        primaryArgField: "",
+        fallbackArgFields: [],
+    };
+}
+function extractArgValue(args, primary, fallbacks) {
+    if (!args)
+        return null;
+    const tryField = (field) => {
+        const val = args[field];
+        if (typeof val === "string" && val.length > 0)
+            return val;
+        return null;
+    };
+    if (primary) {
+        const v = tryField(primary);
+        if (v)
+            return v;
+    }
+    for (const fb of fallbacks) {
+        const v = tryField(fb);
+        if (v)
+            return v;
+    }
+    return null;
+}
+/**
+ * Extracts the most relevant argument value from a tool call
+ * based on its category (command for shell tools, path for file
+ * tools, pattern for search tools, etc.).
+ *
+ * Returns `null` when the tool is unknown and has no arguments,
+ * or when the expected argument fields are missing.
+ */
+export function extractPrimaryArg(toolCall) {
+    const info = resolveToolCategory(toolCall.name);
+    const result = extractArgValue(toolCall.args, info.primaryArgField, info.fallbackArgFields);
+    if (result)
+        return result;
+    if (info.category === "unknown" && toolCall.args) {
+        const keys = Object.keys(toolCall.args);
+        if (keys.length > 0) {
+            const val = toolCall.args[keys[0]];
+            if (typeof val === "string")
+                return val;
+        }
+    }
+    return null;
+}
+/**
+ * Extracts the primary argument value from a JSON string
+ * (typically `PendingApproval.argsPreview`). Returns `null` if
+ * parsing fails or the expected field is not found.
+ */
+export function extractPrimaryArgFromPreview(toolName, argsPreview) {
+    if (!argsPreview)
+        return null;
+    try {
+        const parsed = JSON.parse(argsPreview);
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        const info = resolveToolCategory(toolName);
+        return extractArgValue(parsed, info.primaryArgField, info.fallbackArgFields);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=tool-categories.js.map

package/execution/tool-categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-categories.js","sourceRoot":"","sources":["../../src/execution/tool-categories.ts"],"names":[],"mappings":"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"}