@stigmer/react 2.0.0 → 3.0.0

package/src/agent-instance/AgentInstanceDetailPanel.tsx

@@ -0,0 +1,359 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { cn } from "@stigmer/theme";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import type { AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import type { ResourceRef } from "@stigmer/sdk";
+import { getUserMessage } from "@stigmer/sdk";
+import { useUpdateAgentInstance } from "./useUpdateAgentInstance";
+import { useDeleteAgentInstance } from "./useDeleteAgentInstance";
+import { useUpdateVisibility } from "../library/useUpdateVisibility";
+import { InstanceVisibilitySelector } from "../library/InstanceVisibilitySelector";
+import { PermissionGate } from "../iam-policy/PermissionGate";
+import { SharePanel } from "../iam-policy/SharePanel";
+import { EnvironmentPicker } from "../environment/EnvironmentPicker";
+import { useEnvironmentList } from "../environment/useEnvironmentList";
+
+/** Props for {@link AgentInstanceDetailPanel}. */
+export interface AgentInstanceDetailPanelProps {
+  /** The instance to display. */
+  readonly instance: AgentInstance;
+  /** Organization slug. */
+  readonly org: string;
+  /** Called when the panel should close. */
+  readonly onClose: () => void;
+  /** Called after successful deletion. */
+  readonly onDeleted?: () => void;
+  /** Called when the user clicks "Start session" for this instance. */
+  readonly onStartSessionClick?: (instance: AgentInstance) => void;
+  /** Called when instance data changes (for parent refetch). */
+  readonly onUpdated?: () => void;
+}
+
+/**
+ * Expandable detail panel for a single AgentInstance.
+ *
+ * Shows metadata, description, environment bindings (editable), visibility
+ * control, share panel (FGA-gated), and a delete action. The agent analog
+ * of `WorkflowInstanceDetailPanel`; deletion does not cascade to sessions,
+ * so the delete copy reflects that.
+ */
+export function AgentInstanceDetailPanel({
+  instance,
+  org,
+  onClose,
+  onDeleted,
+  onStartSessionClick,
+  onUpdated,
+}: AgentInstanceDetailPanelProps) {
+  const meta = instance.metadata;
+  const id = meta?.id ?? "";
+  const spec = instance.spec;
+
+  const { update, isUpdating } = useUpdateAgentInstance();
+  const { deleteInstance, isDeleting } = useDeleteAgentInstance();
+  const { updateVisibility, isPending: isVisibilityPending } = useUpdateVisibility("agentInstance", id || null);
+  const { environments } = useEnvironmentList(org);
+
+  const [isEditingEnvs, setIsEditingEnvs] = useState(false);
+  const [editEnvRefs, setEditEnvRefs] = useState<ResourceRef[]>([]);
+  const [showSharePanel, setShowSharePanel] = useState(false);
+  const [showDeleteConfirm, setShowDeleteConfirm] = useState(false);
+  const [deleteError, setDeleteError] = useState<Error | null>(null);
+
+  const handleVisibilityChange = useCallback(
+    async (v: ApiResourceVisibility) => {
+      await updateVisibility(v);
+      onUpdated?.();
+    },
+    [updateVisibility, onUpdated],
+  );
+
+  const handleStartEditEnvs = useCallback(() => {
+    const currentRefs: ResourceRef[] = (spec?.environmentRefs ?? []).map((ref) => ({
+      org: ref.org || org,
+      slug: ref.slug,
+    }));
+    setEditEnvRefs(currentRefs);
+    setIsEditingEnvs(true);
+  }, [spec?.environmentRefs, org]);
+
+  const handleSaveEnvs = useCallback(async () => {
+    try {
+      await update({
+        name: meta?.name ?? "",
+        org: meta?.org ?? org,
+        agentId: spec?.agentId ?? "",
+        description: spec?.description,
+        environmentRefs: editEnvRefs,
+        visibility: meta?.visibility,
+      });
+      setIsEditingEnvs(false);
+      onUpdated?.();
+    } catch {
+      // error displayed by hook
+    }
+  }, [update, meta, spec, org, editEnvRefs, onUpdated]);
+
+  const handleDelete = useCallback(async () => {
+    setDeleteError(null);
+    try {
+      await deleteInstance(id);
+      onDeleted?.();
+    } catch (err) {
+      setDeleteError(err instanceof Error ? err : new Error("Failed to delete instance"));
+    }
+  }, [deleteInstance, id, onDeleted]);
+
+  const resolveEnvName = useCallback(
+    (slug: string): string => {
+      const env = environments.find((e) => e.metadata?.slug === slug);
+      return env?.metadata?.name ?? slug;
+    },
+    [environments],
+  );
+
+  const audit = instance.status?.audit?.specAudit;
+  const createdAt = audit?.createdAt ? timestampDate(audit.createdAt) : null;
+  const updatedAt = audit?.updatedAt ? timestampDate(audit.updatedAt) : null;
+
+  return (
+    <div className="border border-border rounded-lg bg-background overflow-hidden">
+      {/* Header */}
+      <div className="flex items-center justify-between border-b border-border px-4 py-3">
+        <div>
+          <h3 className="text-sm font-semibold text-foreground">
+            {meta?.name || meta?.slug || "Instance"}
+          </h3>
+          <p className="text-[0.65rem] text-muted-foreground">
+            {createdAt && `Created ${createdAt.toLocaleDateString()}`}
+            {updatedAt && ` \u00B7 Updated ${updatedAt.toLocaleDateString()}`}
+          </p>
+        </div>
+        <div className="flex items-center gap-2">
+          {onStartSessionClick && (
+            <button
+              type="button"
+              onClick={() => onStartSessionClick(instance)}
+              className={cn(
+                "rounded-md px-2.5 py-1 text-xs font-medium",
+                "bg-primary text-primary-foreground hover:bg-primary/90",
+                "focus:outline-none focus:ring-2 focus:ring-ring",
+              )}
+            >
+              Start session
+            </button>
+          )}
+          <PermissionGate resource={{ kind: "agent_instance", id }} relation="can_grant_access">
+            <button
+              type="button"
+              onClick={() => setShowSharePanel((v) => !v)}
+              className={cn(
+                "rounded-md px-2.5 py-1 text-xs font-medium",
+                "border border-border text-foreground hover:bg-accent-hover",
+                "focus:outline-none focus:ring-2 focus:ring-ring",
+              )}
+            >
+              Share
+            </button>
+          </PermissionGate>
+          <button
+            type="button"
+            onClick={onClose}
+            aria-label="Close panel"
+            className={cn(
+              "rounded-md p-1 text-muted-foreground",
+              "hover:text-foreground hover:bg-accent-hover",
+            )}
+          >
+            <CloseIcon />
+          </button>
+        </div>
+      </div>
+
+      <div className="divide-y divide-border">
+        {/* Description */}
+        {spec?.description && (
+          <div className="px-4 py-3">
+            <h4 className="text-xs font-medium text-muted-foreground mb-1">Description</h4>
+            <p className="text-sm text-foreground">{spec.description}</p>
+          </div>
+        )}
+
+        {/* Environments */}
+        <div className="px-4 py-3">
+          <div className="flex items-center justify-between mb-2">
+            <h4 className="text-xs font-medium text-muted-foreground">
+              Environments ({spec?.environmentRefs?.length ?? 0})
+            </h4>
+            {!isEditingEnvs && (
+              <PermissionGate resource={{ kind: "agent_instance", id }} relation="can_edit">
+                <button
+                  type="button"
+                  onClick={handleStartEditEnvs}
+                  className="text-[0.65rem] text-primary hover:underline"
+                >
+                  Edit
+                </button>
+              </PermissionGate>
+            )}
+          </div>
+
+          {isEditingEnvs ? (
+            <div className="space-y-2">
+              <EnvironmentPicker
+                org={org}
+                value={editEnvRefs}
+                onChange={setEditEnvRefs}
+                disabled={isUpdating}
+              />
+              <div className="flex items-center gap-2">
+                <button
+                  type="button"
+                  onClick={handleSaveEnvs}
+                  disabled={isUpdating}
+                  className={cn(
+                    "rounded-md px-2.5 py-1 text-xs font-medium",
+                    "bg-primary text-primary-foreground hover:bg-primary/90",
+                    "disabled:opacity-50",
+                  )}
+                >
+                  {isUpdating ? "Saving..." : "Save"}
+                </button>
+                <button
+                  type="button"
+                  onClick={() => setIsEditingEnvs(false)}
+                  disabled={isUpdating}
+                  className="rounded-md px-2.5 py-1 text-xs font-medium text-foreground hover:bg-accent-hover"
+                >
+                  Cancel
+                </button>
+              </div>
+            </div>
+          ) : (
+            <div>
+              {(spec?.environmentRefs?.length ?? 0) === 0 ? (
+                <p className="text-xs text-muted-foreground">No environments bound.</p>
+              ) : (
+                <ol className="space-y-1">
+                  {spec!.environmentRefs.map((ref, idx) => (
+                    <li key={`${ref.slug}-${idx}`} className="flex items-center gap-2 text-sm">
+                      <span className="text-xs text-muted-foreground w-4 text-right">{idx + 1}.</span>
+                      <span className="text-foreground">{resolveEnvName(ref.slug)}</span>
+                    </li>
+                  ))}
+                </ol>
+              )}
+            </div>
+          )}
+        </div>
+
+        {/* Visibility */}
+        <div className="px-4 py-3">
+          <h4 className="text-xs font-medium text-muted-foreground mb-2">Visibility</h4>
+          <PermissionGate
+            resource={{ kind: "agent_instance", id }}
+            relation="can_edit"
+            fallback={
+              <span className="text-sm text-foreground">
+                {VISIBILITY_LABELS[meta?.visibility ?? 0] ?? "Private"}
+              </span>
+            }
+          >
+            <InstanceVisibilitySelector
+              visibility={meta?.visibility ?? ApiResourceVisibility.visibility_private}
+              onVisibilityChange={handleVisibilityChange}
+              isPending={isVisibilityPending}
+            />
+          </PermissionGate>
+        </div>
+
+        {/* Share Panel */}
+        {showSharePanel && (
+          <div className="px-4 py-3">
+            <SharePanel
+              resource={{ kind: "agent_instance", id, resourceKind: ApiResourceKind.agent_instance }}
+              resourceKindString="agent_instance"
+              resourceKind={ApiResourceKind.agent_instance}
+              onClose={() => setShowSharePanel(false)}
+            />
+          </div>
+        )}
+
+        {/* Delete */}
+        <PermissionGate resource={{ kind: "agent_instance", id }} relation="can_delete">
+          <div className="px-4 py-3">
+            <h4 className="text-xs font-medium text-destructive mb-2">Danger Zone</h4>
+            {!showDeleteConfirm ? (
+              <button
+                type="button"
+                onClick={() => setShowDeleteConfirm(true)}
+                className={cn(
+                  "rounded-md px-3 py-1.5 text-xs font-medium",
+                  "border border-destructive/30 text-destructive",
+                  "hover:bg-destructive/10",
+                  "focus:outline-none focus:ring-2 focus:ring-destructive",
+                )}
+              >
+                Delete Instance
+              </button>
+            ) : (
+              <div className="space-y-2 rounded-md border border-destructive/30 p-3 bg-destructive/5">
+                <p className="text-xs text-destructive font-medium">
+                  This permanently removes this instance and its environment
+                  bindings. Sessions already started against it and their
+                  history are preserved. This action cannot be undone.
+                </p>
+                {deleteError && (
+                  <p className="text-xs text-destructive" role="alert">
+                    {getUserMessage(deleteError)}
+                  </p>
+                )}
+                <div className="flex items-center gap-2">
+                  <button
+                    type="button"
+                    onClick={handleDelete}
+                    disabled={isDeleting}
+                    className={cn(
+                      "rounded-md px-3 py-1.5 text-xs font-medium",
+                      "bg-destructive text-destructive-foreground",
+                      "hover:bg-destructive/90",
+                      "disabled:opacity-50",
+                    )}
+                  >
+                    {isDeleting ? "Deleting..." : "Confirm Delete"}
+                  </button>
+                  <button
+                    type="button"
+                    onClick={() => setShowDeleteConfirm(false)}
+                    disabled={isDeleting}
+                    className="rounded-md px-3 py-1.5 text-xs font-medium text-foreground hover:bg-accent-hover"
+                  >
+                    Cancel
+                  </button>
+                </div>
+              </div>
+            )}
+          </div>
+        </PermissionGate>
+      </div>
+    </div>
+  );
+}
+
+const VISIBILITY_LABELS: Record<number, string> = {
+  [ApiResourceVisibility.visibility_private]: "Private",
+  [ApiResourceVisibility.visibility_org]: "Organization",
+  [ApiResourceVisibility.visibility_public]: "Public",
+};
+
+function CloseIcon() {
+  return (
+    <svg width="14" height="14" viewBox="0 0 14 14" fill="none" aria-hidden="true">
+      <path d="M3 3l8 8M11 3l-8 8" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+    </svg>
+  );
+}

package/src/agent-instance/AgentInstanceEmptyState.tsx

@@ -0,0 +1,87 @@
+"use client";
+
+import { cn } from "@stigmer/theme";
+
+/** Props for {@link AgentInstanceEmptyState}. */
+export interface AgentInstanceEmptyStateProps {
+  /** Called when the user clicks "Create Instance". */
+  readonly onCreateClick?: () => void;
+  /** Additional CSS class names. */
+  readonly className?: string;
+}
+
+/**
+ * Empty state shown in the Instances tab when no user-created instances exist.
+ *
+ * Communicates the value proposition of agent instances without mentioning
+ * the platform-managed default instance (an implementation detail). For
+ * agents, an instance is a reusable, environment-bound deployment you can
+ * start sessions against — and share with your team.
+ */
+export function AgentInstanceEmptyState({
+  onCreateClick,
+  className,
+}: AgentInstanceEmptyStateProps) {
+  return (
+    <div
+      className={cn(
+        "flex flex-col items-center justify-center py-12 px-6 text-center",
+        className,
+      )}
+    >
+      <div className="mb-4 rounded-full bg-muted p-3">
+        <LayersIcon />
+      </div>
+
+      <h3 className="text-sm font-semibold text-foreground mb-1">
+        No instances yet
+      </h3>
+
+      <p className="text-sm text-muted-foreground max-w-sm mb-6">
+        Create instances to start sessions with this agent using different
+        credentials and settings. Each instance binds environments (secrets,
+        configuration) and can be shared with your team independently.
+      </p>
+
+      {onCreateClick && (
+        <button
+          type="button"
+          onClick={onCreateClick}
+          className={cn(
+            "inline-flex items-center gap-1.5 rounded-md px-3 py-1.5",
+            "text-sm font-medium",
+            "bg-primary text-primary-foreground",
+            "hover:bg-primary/90",
+            "focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",
+          )}
+        >
+          <PlusIcon />
+          Create Instance
+        </button>
+      )}
+    </div>
+  );
+}
+
+function LayersIcon() {
+  return (
+    <svg width="20" height="20" viewBox="0 0 20 20" fill="none" aria-hidden="true">
+      <path
+        d="M10 2L2 6l8 4 8-4-8-4zM2 10l8 4 8-4M2 14l8 4 8-4"
+        stroke="currentColor"
+        strokeWidth="1.5"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+        className="text-muted-foreground"
+      />
+    </svg>
+  );
+}
+
+function PlusIcon() {
+  return (
+    <svg width="14" height="14" viewBox="0 0 14 14" fill="none" aria-hidden="true">
+      <path d="M7 2v10M2 7h10" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+    </svg>
+  );
+}