@opengeni/react 0.23.0 → 0.25.5

package/dist/session-Db00TRwl.d.ts

@@ -1,446 +0,0 @@
-import { E as EmbeddedSessionClientOverride, e as EmbeddedSessionMcpApprovalPolicyClientOverride, f as EmbeddedHumanInputClientOverride } from './session-context-rgrfElMl.js';
-import { ToolAuthNeededPayload, ResourceRef, ToolRef, SessionStatus, SessionEvent, StreamConnectionState, SessionQueueSnapshot, SessionTurn, EffectiveSessionControl, ComposerDraft, SessionControlResponse, SessionMcpServerMetadata, SessionMcpApprovalPolicy, UpdateSessionMcpApprovalPolicyResponse, HumanInputQuestion, SessionHumanInputRequest, SubmitHumanInputResponseRequest } from '@opengeni/sdk';
-import { S as SessionEventFeedOptions } from './use-composer-By1wn3MM.js';
-
-type UserMessageItem = {
-    kind: "user-message";
-    id: string;
-    text: string;
-    /** Resources attached to this message (file uploads, repositories). */
-    resources: ResourceRef[];
-    /** Tools requested for the turn this message starts. */
-    tools: ToolRef[];
-    occurredAt: string;
-};
-type AgentMessageItem = {
-    kind: "agent-message";
-    id: string;
-    turnId: string | null;
-    text: string;
-    /** Still receiving deltas (no completed/turn-end seen yet). */
-    streaming: boolean;
-    occurredAt: string;
-};
-type ReasoningItem = {
-    kind: "reasoning";
-    id: string;
-    turnId: string | null;
-    text: string;
-    streaming: boolean;
-    occurredAt: string;
-};
-type ToolCallItem = {
-    kind: "tool-call";
-    id: string;
-    turnId: string | null;
-    callId: string | null;
-    name: string;
-    arguments: unknown;
-    output: unknown;
-    /**
-     * The provider-native tool item (`agent.toolCall.created.payload.raw`). Carries
-     * `type` (e.g. `apply_patch_call`, `computer_call`, `hosted_tool_call`) and the
-     * tool-specific fields the per-tool renderers read (`operation`, `action`,
-     * `providerData`, …). `undefined` for first-party MCP tools, which carry their
-     * payload in `arguments`/`output` instead.
-     */
-    raw: unknown;
-    status: "running" | "complete" | "failed" | "cancelled";
-    occurredAt: string;
-};
-/**
- * An orchestration call against another session — the manager spawning or
- * messaging a worker. Rendered as a first-class "worker" row, not a generic
- * tool call.
- */
-type WorkerItem = {
-    kind: "worker";
-    id: string;
-    turnId: string | null;
-    callId: string | null;
-    action: "spawn" | "message";
-    /** The worker's initial message / the message sent to it, when parseable. */
-    prompt: string | null;
-    /** The target/spawned worker session id, when parseable from args/output. */
-    workerSessionId: string | null;
-    status: "running" | "complete" | "failed" | "cancelled";
-    occurredAt: string;
-};
-type WorkerCompletionItem = {
-    kind: "worker-completion";
-    id: string;
-    turnId: string | null;
-    occurredAt: string;
-    childSessionId: string;
-    childStatus: string;
-    goalStatus: string | null;
-    goalText: string | null;
-    evidence: string | null;
-    pausedReason: string | null;
-    text: string;
-};
-type SandboxItem = {
-    kind: "sandbox";
-    id: string;
-    turnId: string | null;
-    name: string;
-    command: string | null;
-    output: string;
-    origin?: "created" | "restored" | "resumed" | null;
-    status: "running" | "complete" | "failed" | "cancelled";
-    occurredAt: string;
-};
-/**
- * A first-party workspace-memory write the agent made mid-turn — a `memory.saved`
- * (it committed a new preference / fact / procedure / decision / history) or a
- * `memory.corrected` (it updated or archived an existing one). A settled save is
- * ordinary progress, not an exceptional state, so it renders as a calm NEUTRAL
- * step on the rail (never accent/color). When the host app supplies an
- * `onMemoryClick` handler the row also deep-links to the record in its memory
- * pane; without one it is non-interactive rich content.
- */
-type MemoryItem = {
-    kind: "memory";
-    id: string;
-    turnId: string | null;
-    variant: "saved" | "corrected";
-    /** The memory's kind enum (`"preference" | "semantic" | …`); mapped to a human label at render. */
-    memoryKind: string;
-    /** The memory text, ellipsized to ≤120 chars server-side. For a supersede this is the OLD text. */
-    preview: string;
-    /** The save collapsed into an existing memory (no new row was written). Saved variant only. */
-    deduped?: boolean;
-    /** The NEW text when a correction superseded the memory with a replacement; absent = updated-in-place or archived. */
-    replacementPreview?: string;
-    /**
-     * What a `memory.corrected` did: `"superseded"` (replaced by a new record, see
-     * `replacementPreview`), `"updated"` (edited in place — the record lives on), or
-     * `"archived"` (retired). Distinguishes updated-in-place from archived when there
-     * is no replacement. Corrected variant only; read defensively (may be absent).
-     */
-    action?: string;
-    /** The saved / corrected memory's id — the deep-link target for a save. */
-    memoryId: string;
-    /** The replacement memory's id when a correction produced one — the LIVE record the deep-link targets. */
-    replacementMemoryId?: string;
-    occurredAt: string;
-};
-type SessionStatusItem = {
-    kind: "session-status";
-    id: string;
-    status: SessionStatus;
-    occurredAt: string;
-};
-type GoalItem = {
-    kind: "goal";
-    id: string;
-    action: "set" | "updated" | "completed" | "paused" | "resumed" | "cleared" | "continuation";
-    text: string | null;
-    occurredAt: string;
-};
-type NoticeItem = {
-    kind: "notice";
-    id: string;
-    tone: "waiting" | "cancelled" | "failed";
-    text: string;
-    /** Optional evidence kept inspectable without overwhelming the main rail. */
-    details?: {
-        label: string;
-        value: unknown;
-    };
-    action?: {
-        label: string;
-        url: string;
-    };
-    occurredAt: string;
-};
-/**
- * A tool call hit a missing or lapsed connection. The broker reports that
- * condition as a tool error and the turn continues; reconnecting never resumes
- * or replays the original call. Carries the structured `tool.auth_needed`
- * payload so the renderer can draw a clean inline recovery affordance (provider
- * logo + one human line + a Connect/Reconnect button) and the app can start the
- * right flow (OAuth reconnect for the surviving connection, or credential
- * re-entry for an api-key one). The `reason` shapes the human copy but is never
- * shown raw.
- */
-type AuthNeededItem = {
-    kind: "auth-needed";
-    id: string;
-    turnId: string | null;
-    /** The connection's registrable domain, e.g. "linear.app". */
-    providerDomain: string;
-    /** The lapsed connection to reconnect, when the row survived. */
-    connectionId: string | null;
-    reason: ToolAuthNeededPayload["reason"] | null;
-    /** Scopes the provider now needs; may inform the copy, never shown as a raw label. */
-    scopes: string[];
-    /** The OAuth `resource` (RFC 8707) the reconnect should target, when supplied. */
-    resource: string | null;
-    /** The tool whose call triggered the reauth, for context. */
-    toolName: string | null;
-    /** A pre-minted authorization URL, when the broker already produced one. */
-    authorizationUrl: string | null;
-    occurredAt: string;
-};
-type TurnOutcome = "complete" | "failed" | "cancelled";
-type TurnEndItem = {
-    kind: "turn-end";
-    id: string;
-    turnId: string | null;
-    outcome: TurnOutcome;
-    failureText: string | null;
-    occurredAt: string;
-};
-type TimelineItem = UserMessageItem | AgentMessageItem | ReasoningItem | ToolCallItem | WorkerItem | WorkerCompletionItem | SandboxItem | SessionStatusItem | GoalItem | NoticeItem | AuthNeededItem | MemoryItem | TurnEndItem;
-/** Activity items cluster between chat messages (reasoning, tools, workers, sandbox, memory). */
-type ActivityItem = ReasoningItem | ToolCallItem | WorkerItem | SandboxItem | MemoryItem;
-type TimelineGroup = {
-    kind: "item";
-    item: TimelineItem;
-} | {
-    kind: "activity";
-    id: string;
-    items: ActivityItem[];
-    outcome?: TurnOutcome;
-    failureText?: string;
-} | {
-    kind: "turn";
-    id: string;
-    outcome: TurnOutcome;
-    failureText?: string;
-    startedAt: string;
-    endedAt: string;
-    groups: TimelineGroup[];
-};
-
-type SessionEventsConnectionState = StreamConnectionState | "idle" | "ended" | "error";
-type UseSessionEventsOptions = EmbeddedSessionClientOverride & {
-    /** Resume after this sequence (exclusive). Nonzero keeps full replay/resume semantics. */
-    after?: number | undefined;
-    /** Load a bounded tail by default, or opt back into full replay from `after`. */
-    replay?: "windowed" | "full" | undefined;
-    /** Pause the stream without unmounting (e.g. hidden tab). Defaults to true. */
-    enabled?: boolean | undefined;
-};
-type UseSessionEventsResult = {
-    /** Replayed + live events, ordered by sequence, no gaps, no duplicates. */
-    events: SessionEvent[];
-    /** Projected, renderable timeline (memoized over `events`). */
-    timeline: TimelineItem[];
-    /** Latest session status observed in the event log, if any. */
-    sessionStatus: SessionStatus | null;
-    connectionState: SessionEventsConnectionState;
-    /** Highest sequence seen so far (0 before the first event). */
-    lastSequence: number;
-    /** Exact serialized bytes retained in the current browser event window. */
-    windowBytes: number;
-    /** Whether older delivered events were evicted from the browser window. */
-    windowTruncated: boolean;
-    /** True until the initial tail window has been applied (windowed mode). */
-    initialLoading: boolean;
-    /** Whether older durable events are available before the current window. */
-    hasOlder: boolean;
-    /** True while an older window is being fetched. */
-    loadingOlder: boolean;
-    /** Prepend an older density-bounded window; resolves true when more remain. */
-    loadOlder: () => Promise<boolean>;
-    error: Error | null;
-};
-declare const SESSION_EVENT_BROWSER_MAX_BYTES: number;
-declare const SESSION_EVENT_BROWSER_MAX_COUNT = 10000;
-declare const SESSION_EVENT_BROWSER_SINGLE_EVENT_MAX_BYTES: number;
-declare const SESSION_EVENT_BROWSER_PENDING_MAX_BYTES: number;
-declare const SESSION_EVENT_BROWSER_PENDING_MAX_COUNT = 256;
-type BrowserSessionEventWindow = {
-    events: SessionEvent[];
-    bytes: number;
-    truncated: boolean;
-};
-/**
- * Live-stream a session's event log with replay-by-sequence, reconnect, and
- * batched React updates. Fresh loads default to a bounded tail window; pass
- * `replay: "full"` or a nonzero `after` for the previous full replay path.
- */
-declare function useSessionEvents(sessionId: string | null | undefined, options?: UseSessionEventsOptions): UseSessionEventsResult;
-/**
- * Keep one direction-aware count+byte-bounded browser window. Live/default
- * accumulation retains the newest suffix; backward paging retains the oldest
- * prefix so newly fetched history cannot be immediately evicted. This is
- * deliberately separate from durable history and transport paging: when a
- * backward page evicts the live tail, the hook reconnects from the retained
- * high-water mark while preserving the highest-ever-observed sequence
- * separately. The source event remains durable in PostgreSQL throughout.
- */
-declare function boundBrowserSessionEventWindow(events: readonly SessionEvent[], options?: {
-    maxBytes?: number;
-    maxCount?: number;
-    direction?: "newest" | "oldest";
-}): BrowserSessionEventWindow;
-
-/** Events that can change the authoritative prompt queue or effective control. */
-declare function isTurnQueueEvent(event: Pick<SessionEvent, "type">): boolean;
-type QueueMutationKind = "move" | "edit" | "steer" | "delete";
-type UseTurnQueueOptions = EmbeddedSessionClientOverride & SessionEventFeedOptions & {
-    pollIntervalMs?: number | undefined;
-};
-type UseTurnQueueResult = {
-    snapshot: SessionQueueSnapshot | null;
-    /** Human/API prompts exactly in server execution order. Never client-sorted. */
-    queue: SessionTurn[];
-    effectiveControl: EffectiveSessionControl | null;
-    /** The latest interrupted attempt has not yet durably proved physical quiescence. */
-    stoppingPreviousAttempt: boolean;
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    moveTurn: (turnId: string, beforeTurnId: string | null) => Promise<boolean>;
-    /** Atomically withdraw a waiting prompt into the private durable composer draft. */
-    editTurn: (turnId: string, options: {
-        expectedDraftRevision: number;
-        replaceDraft: boolean;
-    }) => Promise<ComposerDraft | null>;
-    /** Advance the same durable waiting prompt; no duplicate prompt is created. */
-    steerTurn: (turnId: string) => Promise<boolean>;
-    removeTurn: (turnId: string) => Promise<boolean>;
-    pendingByTurn: Readonly<Record<string, QueueMutationKind>>;
-    mutationFor: (turnId: string) => QueueMutationKind | null;
-    mutating: boolean;
-    mutationError: Error | null;
-    clearMutationError: () => void;
-};
-/**
- * The one authoritative human prompt queue. Every mutation carries the exact
- * server versions the operator saw and accepts only monotonic snapshots. A
- * conflict immediately reloads server truth; the client never invents order.
- */
-declare function useTurnQueue(sessionId: string | null | undefined, options?: UseTurnQueueOptions): UseTurnQueueResult;
-
-type UseSessionControlOptions = EmbeddedSessionClientOverride;
-type UseSessionControlResult = {
-    pause: (reason?: string) => Promise<SessionControlResponse | null>;
-    resume: (reason?: string) => Promise<SessionControlResponse | null>;
-    controlling: boolean;
-    /** Approve a pending `requires_action` approval. */
-    approve: (approvalId: string, message?: string) => Promise<SessionEvent | null>;
-    /** Reject a pending `requires_action` approval. */
-    reject: (approvalId: string, message?: string) => Promise<SessionEvent | null>;
-    /** True while an approval decision is in flight. */
-    responding: boolean;
-    error: Error | null;
-    clearError: () => void;
-};
-/**
- * Session pause/resume and approval decisions. Pair with
- * `useSessionEvents` (for `session.requiresAction` payloads carrying the
- * `approvalId`) to render an approval bar.
- */
-declare function useSessionControl(sessionId: string | null | undefined, options?: UseSessionControlOptions): UseSessionControlResult;
-
-declare function isSessionMcpApprovalPolicyEvent(event: Pick<SessionEvent, "type" | "payload">, serverId?: string): boolean;
-type UseSessionMcpApprovalPolicyOptions = EmbeddedSessionMcpApprovalPolicyClientOverride & SessionEventFeedOptions & {
-    /** Optional safety-net polling (ms). Off by default; policy events drive refreshes. */
-    pollIntervalMs?: number | undefined;
-};
-type UseSessionMcpApprovalPolicyResult = {
-    server: SessionMcpServerMetadata | null;
-    policy: SessionMcpApprovalPolicy | null;
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    update: (policy: SessionMcpApprovalPolicy) => Promise<UpdateSessionMcpApprovalPolicyResponse | null>;
-    updating: boolean;
-    clearError: () => void;
-};
-/**
- * Read and update one existing session MCP server's approval policy. Updates
- * become effective for the next claimed attempt; current work is unchanged.
- */
-declare function useSessionMcpApprovalPolicy(sessionId: string | null | undefined, serverId: string | null | undefined, options?: UseSessionMcpApprovalPolicyOptions): UseSessionMcpApprovalPolicyResult;
-
-type PendingApproval = {
-    /** The id to send back via `user.approvalDecision` (`approvalId`). */
-    id: string;
-    /** Tool/function name awaiting the decision. */
-    name: string;
-    arguments?: unknown;
-    /** The raw approval entry from the `session.requiresAction` payload. */
-    raw?: unknown;
-};
-/** The approvals carried by one `session.requiresAction` payload. */
-declare function approvalsFromRequiresAction(payload: unknown): PendingApproval[];
-/** The approvals still awaiting a decision after replaying `events` in order. */
-declare function projectPendingApprovals(events: SessionEvent[]): PendingApproval[];
-
-/** Minimal actionable request shape available from the durable event log. */
-type PendingHumanInputRequest = {
-    id: string;
-    turnId: string | null;
-    questions: HumanInputQuestion[];
-    allowSkip: boolean;
-    expiresAt: string | null;
-};
-/** Parse one generic `session.humanInput.requested` event defensively. */
-declare function humanInputRequestFromEvent(event: Pick<SessionEvent, "type" | "payload" | "turnId">): PendingHumanInputRequest | null;
-/**
- * Fold a durable event log into the structured requests that are actionable
- * now. Responses remove one request; a terminal owning turn clears any
- * unresolved requests that died with it. Replaying history cannot resurrect a
- * previously answered card.
- */
-declare function projectPendingHumanInputRequests(events: SessionEvent[]): PendingHumanInputRequest[];
-
-/** Events that can create, settle, or invalidate an actionable request. */
-declare function isHumanInputEvent(event: Pick<SessionEvent, "type">): boolean;
-type UseHumanInputRequestsOptions = EmbeddedHumanInputClientOverride & SessionEventFeedOptions & {
-    /** Optional safety-net polling. Durable events drive refresh by default. */
-    pollIntervalMs?: number | undefined;
-};
-type UseHumanInputRequestsResult = {
-    requests: SessionHumanInputRequest[];
-    loading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    respond: (requestId: string, response: SubmitHumanInputResponseRequest) => Promise<SessionEvent | null>;
-    respondingRequestId: string | null;
-    mutationError: Error | null;
-    clearMutationError: () => void;
-};
-/**
- * Authoritative structured-human-input hook. The server's pending-request
- * table is the read model; events only trigger reconciliation. This lets an
- * embedded host use the same primitive with a shared event feed or its own SDK
- * proxy without rebuilding request lifecycle logic.
- */
-declare function useHumanInputRequests(sessionId: string | null | undefined, options?: UseHumanInputRequestsOptions): UseHumanInputRequestsResult;
-
-declare function buildTimeline(events: SessionEvent[]): TimelineItem[];
-/**
- * Whether the session's most recent turn ended in credit exhaustion — the
- * terminal credit state apps key their "add credits" affordances on. Derived
- * from the LAST turn-end event (completed/failed/cancelled): a later turn that
- * settles any other way (someone topped up and kept working) clears it.
- */
-declare function creditExhaustedFromEvents(events: SessionEvent[]): boolean;
-/** The latest session status carried in the event log, if any. */
-declare function sessionStatusFromEvents(events: SessionEvent[]): SessionStatus | null;
-declare function groupTimeline(items: TimelineItem[]): TimelineGroup[];
-/**
- * Find a session id in orchestration tool arguments or output. Handles raw
- * objects, JSON strings, and MCP tool results (`{ content: [{ type: "text",
- * text: "{...}" }], structuredContent? }`).
- */
-declare function extractSessionRef(value: unknown, depth?: number): string | null;
-/**
- * Readable label for a tool call ("session_create" -> "session create").
- *
- * MCP tools are namespaced `<serverId>__<toolName>` (see prefixedMcpToolName),
- * and for catalog-imported servers that serverId is an opaque slug+hash
- * ("mcp-integrations-sh-supabase-com-34ed9dcf1390-0i6tcf8"). De-slugging the
- * whole thing leaked that id into the timeline; strip the server prefix and show
- * just the tool ("list organizations"). Names without the `__` boundary (plain
- * built-ins like "session_create") are unaffected.
- */
-declare function toolDisplayName(name: string): string;
-
-export { useTurnQueue as $, type ActivityItem as A, type BrowserSessionEventWindow as B, buildTimeline as C, creditExhaustedFromEvents as D, extractSessionRef as E, groupTimeline as F, type GoalItem as G, humanInputRequestFromEvent as H, isHumanInputEvent as I, isSessionMcpApprovalPolicyEvent as J, isTurnQueueEvent as K, projectPendingApprovals as L, projectPendingHumanInputRequests as M, type NoticeItem as N, sessionStatusFromEvents as O, type PendingApproval as P, type QueueMutationKind as Q, type ReasoningItem as R, SESSION_EVENT_BROWSER_MAX_BYTES as S, type ToolCallItem as T, type UseTurnQueueResult as U, toolDisplayName as V, type WorkerItem as W, useHumanInputRequests as X, useSessionControl as Y, useSessionEvents as Z, useSessionMcpApprovalPolicy as _, type TurnOutcome as a, type MemoryItem as a0, type WorkerCompletionItem as a1, type TimelineItem as b, type AgentMessageItem as c, type UserMessageItem as d, type AuthNeededItem as e, type PendingHumanInputRequest as f, SESSION_EVENT_BROWSER_MAX_COUNT as g, SESSION_EVENT_BROWSER_PENDING_MAX_BYTES as h, SESSION_EVENT_BROWSER_PENDING_MAX_COUNT as i, SESSION_EVENT_BROWSER_SINGLE_EVENT_MAX_BYTES as j, type SandboxItem as k, type SessionEventsConnectionState as l, type SessionStatusItem as m, type TimelineGroup as n, type TurnEndItem as o, type UseHumanInputRequestsOptions as p, type UseHumanInputRequestsResult as q, type UseSessionControlOptions as r, type UseSessionControlResult as s, type UseSessionEventsOptions as t, type UseSessionEventsResult as u, type UseSessionMcpApprovalPolicyOptions as v, type UseSessionMcpApprovalPolicyResult as w, type UseTurnQueueOptions as x, approvalsFromRequiresAction as y, boundBrowserSessionEventWindow as z };