@opengeni/react 0.1.0

package/src/index.ts

@@ -0,0 +1,115 @@
+// @opengeni/react — hooks + styled components on @opengeni/sdk.
+//
+// Import the styles once in your Tailwind entry CSS:
+//   @import "@opengeni/react/styles.css";
+//   @source "../node_modules/@opengeni/react/src";
+
+export type { SessionClientLike } from "./client";
+export { OpenGeniProvider, useOpenGeni, useOpenGeniClient } from "./provider";
+export type { ClientOverride, OpenGeniContextValue, OpenGeniProviderProps } from "./provider";
+
+// Hooks
+export { useSession } from "./hooks/use-session";
+export type { UseSessionOptions, UseSessionResult } from "./hooks/use-session";
+export { useSessionEvents } from "./hooks/use-session-events";
+export type { SessionEventsConnectionState, UseSessionEventsOptions, UseSessionEventsResult } from "./hooks/use-session-events";
+export { useComposer, composeSendInput, shouldSubmitOnKey } from "./hooks/use-composer";
+export type { ComposerMode, ComposerSendExtras, ComposerState, UseComposerOptions } from "./hooks/use-composer";
+export { useFileAttachments } from "./hooks/use-file-attachments";
+export type { FileAttachment, UseFileAttachmentsOptions, UseFileAttachmentsResult } from "./hooks/use-file-attachments";
+export {
+  useTurnQueue,
+  isTurnQueueEvent,
+  queueFromTurns,
+  activeTurnFromTurns,
+  applyTurnEdit,
+  applyTurnReorder,
+  applyTurnRemoval,
+} from "./hooks/use-turn-queue";
+export type { UseTurnQueueOptions, UseTurnQueueResult } from "./hooks/use-turn-queue";
+export { useGoal, isGoalEvent } from "./hooks/use-goal";
+export type { UseGoalOptions, UseGoalResult } from "./hooks/use-goal";
+export { useSessionControl } from "./hooks/use-session-control";
+export type { UseSessionControlOptions, UseSessionControlResult } from "./hooks/use-session-control";
+export { useScheduledTasks } from "./hooks/use-scheduled-tasks";
+export type { UseScheduledTasksOptions, UseScheduledTasksResult } from "./hooks/use-scheduled-tasks";
+export { useWorkspaceSessions } from "./hooks/use-workspace-sessions";
+export type { UseWorkspaceSessionsOptions, UseWorkspaceSessionsResult } from "./hooks/use-workspace-sessions";
+export { useEnvironments } from "./hooks/use-environments";
+export type { UseEnvironmentsOptions, UseEnvironmentsResult } from "./hooks/use-environments";
+export { usePacks } from "./hooks/use-packs";
+export type { UsePacksOptions, UsePacksResult } from "./hooks/use-packs";
+export { useWorkspaces } from "./hooks/use-workspaces";
+export type { UseWorkspacesOptions, UseWorkspacesResult } from "./hooks/use-workspaces";
+export { useBillingUsage } from "./hooks/use-billing-usage";
+export type { UseBillingUsageOptions, UseBillingUsageResult } from "./hooks/use-billing-usage";
+
+// Pending-approvals projection
+export { approvalsFromRequiresAction, projectPendingApprovals } from "./approvals";
+export type { PendingApproval } from "./approvals";
+
+// Timeline projection
+export {
+  buildTimeline,
+  compactPayloadPreview,
+  extractSessionRef,
+  groupTimeline,
+  sessionStatusFromEvents,
+  toolDisplayName,
+} from "./timeline";
+export type {
+  AgentMessageItem,
+  GoalItem,
+  NoticeItem,
+  ReasoningItem,
+  SandboxItem,
+  SessionStatusItem,
+  TimelineGroup,
+  TimelineItem,
+  ToolCallItem,
+  UserMessageItem,
+  WorkerItem,
+} from "./timeline";
+
+// Slash-command palette (registry + UI + hook)
+export {
+  argHint,
+  defaultCommands,
+  filterCommands,
+  firstMissingRequiredArg,
+  hasPermission,
+  matchCommand,
+  parseCommandLine,
+} from "./commands/registry";
+export type { ParsedCommandLine } from "./commands/registry";
+export type {
+  CommandContext,
+  CommandResult,
+  Notice,
+  SlashArg,
+  SlashCommand,
+} from "./commands/types";
+export { useSlashCommands } from "./hooks/use-slash-commands";
+export type {
+  ConfirmState,
+  SlashCommandContext,
+  SlashCommandHandlers,
+  UseSlashCommandsOptions,
+  UseSlashCommandsResult,
+} from "./hooks/use-slash-commands";
+export { CommandPalette } from "./components/command-palette";
+export type { CommandPaletteProps } from "./components/command-palette";
+
+// Components
+export { ChatComposer } from "./components/chat-composer";
+export type { ChatComposerProps } from "./components/chat-composer";
+export { MessageTimeline } from "./components/message-timeline";
+export type { MessageTimelineProps } from "./components/message-timeline";
+export { SessionStatus, StatusDot, SESSION_STATUS_META } from "./components/session-status";
+export type { SessionStatusProps, StatusDotProps, SessionStatusMeta } from "./components/session-status";
+export { FleetTile, sessionDisplayTitle } from "./components/fleet-tile";
+export type { FleetTileProps } from "./components/fleet-tile";
+
+// Utilities
+export { cn } from "./lib/cn";
+export { formatBytes, formatRelativeTime, stringifyPayload, truncate, tryParseJson } from "./lib/format";

package/src/lib/cn.ts

@@ -0,0 +1,7 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/** Merge class names with Tailwind-aware conflict resolution. */
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(inputs));
+}

package/src/lib/format.ts

@@ -0,0 +1,84 @@
+/** Compact relative time: "now", "42s", "7m", "3h", "2d", then a date. */
+export function formatRelativeTime(iso: string, now: Date = new Date()): string {
+  const then = new Date(iso).getTime();
+  if (Number.isNaN(then)) {
+    return "";
+  }
+  const seconds = Math.max(0, Math.floor((now.getTime() - then) / 1000));
+  if (seconds < 10) {
+    return "now";
+  }
+  if (seconds < 60) {
+    return `${seconds}s`;
+  }
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) {
+    return `${minutes}m`;
+  }
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) {
+    return `${hours}h`;
+  }
+  const days = Math.floor(hours / 24);
+  if (days < 14) {
+    return `${days}d`;
+  }
+  return new Date(iso).toLocaleDateString();
+}
+
+/** Human-readable byte size: "512 B", "8.0 KB", "1.4 MB", "3 GB". */
+export function formatBytes(bytes: number): string {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+  const units = ["KB", "MB", "GB"] as const;
+  let value = bytes / 1024;
+  for (const unit of units) {
+    if (value < 1024 || unit === "GB") {
+      return `${value.toFixed(value < 10 ? 1 : 0)} ${unit}`;
+    }
+    value /= 1024;
+  }
+  return `${bytes} B`;
+}
+
+/** Single-line preview of arbitrary text, for tiles and collapsed rows. */
+export function truncate(text: string, maxLength: number): string {
+  const collapsed = text.replace(/\s+/g, " ").trim();
+  if (collapsed.length <= maxLength) {
+    return collapsed;
+  }
+  return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;
+}
+
+/** Render an unknown payload as readable text (pretty JSON when possible). */
+export function stringifyPayload(value: unknown): string {
+  if (value === null || value === undefined) {
+    return "";
+  }
+  if (typeof value === "string") {
+    const parsed = tryParseJson(value);
+    if (parsed !== undefined && typeof parsed === "object") {
+      return stringifyPayload(parsed);
+    }
+    return value;
+  }
+  try {
+    return JSON.stringify(value, null, 2) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+
+/** JSON.parse that returns `undefined` instead of throwing. */
+export function tryParseJson(text: string): unknown {
+  const trimmed = text.trim();
+  if (!trimmed.startsWith("{") && !trimmed.startsWith("[") && !trimmed.startsWith('"')) {
+    return undefined;
+  }
+  try {
+    return JSON.parse(trimmed) as unknown;
+  } catch {
+    return undefined;
+  }
+}

package/src/provider.tsx

@@ -0,0 +1,57 @@
+import { createContext, useContext, useMemo, type ReactNode } from "react";
+import type { SessionClientLike } from "./client";
+
+export type OpenGeniContextValue = {
+  client: SessionClientLike;
+  workspaceId: string;
+};
+
+const OpenGeniContext = createContext<OpenGeniContextValue | null>(null);
+
+export type OpenGeniProviderProps = {
+  client: SessionClientLike;
+  workspaceId: string;
+  children?: ReactNode;
+};
+
+/**
+ * Supplies the OpenGeni client + workspace to all hooks below it. Hooks also
+ * accept `{ client, workspaceId }` overrides per call for multi-workspace UIs.
+ */
+export function OpenGeniProvider({ client, workspaceId, children }: OpenGeniProviderProps) {
+  const value = useMemo(() => ({ client, workspaceId }), [client, workspaceId]);
+  return <OpenGeniContext.Provider value={value}>{children}</OpenGeniContext.Provider>;
+}
+
+export type ClientOverride = {
+  client?: SessionClientLike | undefined;
+  workspaceId?: string | undefined;
+};
+
+/** Resolve client + workspace from explicit overrides or the provider. */
+export function useOpenGeni(override: ClientOverride = {}): OpenGeniContextValue {
+  const context = useContext(OpenGeniContext);
+  const client = override.client ?? context?.client;
+  const workspaceId = override.workspaceId ?? context?.workspaceId;
+  if (!client || !workspaceId) {
+    throw new Error(
+      "@opengeni/react: no OpenGeni client/workspace available. Wrap the tree in <OpenGeniProvider> or pass { client, workspaceId } to the hook.",
+    );
+  }
+  return { client, workspaceId };
+}
+
+/**
+ * Resolve the client only — for hooks that are not workspace-scoped
+ * (`useWorkspaces`, `useBillingUsage`).
+ */
+export function useOpenGeniClient(override: Pick<ClientOverride, "client"> = {}): SessionClientLike {
+  const context = useContext(OpenGeniContext);
+  const client = override.client ?? context?.client;
+  if (!client) {
+    throw new Error(
+      "@opengeni/react: no OpenGeni client available. Wrap the tree in <OpenGeniProvider> or pass { client } to the hook.",
+    );
+  }
+  return client;
+}