@stigmer/react 0.0.36 → 0.0.40

package/api-key/useApiKeyList.js

@@ -0,0 +1,52 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches all {@link ApiKey} entries for the
+ * authenticated identity.
+ *
+ * API keys are identity-scoped — the server returns every key owned
+ * by the identity in the auth header, regardless of organization.
+ * Call `refetch()` to re-query after mutations (create / delete).
+ *
+ * The raw key value is never returned by `findAll` — only the
+ * `fingerprint` (last 6 characters) is available for display.
+ *
+ * @example
+ * ```tsx
+ * const { apiKeys, isLoading, error, refetch } = useApiKeyList();
+ *
+ * if (isLoading) return <Spinner />;
+ * apiKeys.map((k) => k.metadata?.name);
+ * ```
+ */
+export function useApiKeyList() {
+    const stigmer = useStigmer();
+    const [apiKeys, setApiKeys] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.apiKey.findAll().then((result) => {
+            if (cancelled.current)
+                return;
+            setApiKeys([...result.entries]);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [stigmer, fetchKey]);
+    return { apiKeys, isLoading, error, refetch };
+}
+//# sourceMappingURL=useApiKeyList.js.map

package/api-key/useApiKeyList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApiKeyList.js","sourceRoot":"","sources":["../../src/api-key/useApiKeyList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAS9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAErC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAC3B,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAChC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEF,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAExB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/api-key/useCreateApiKey.d.ts

@@ -0,0 +1,40 @@
+import type { ApiKeyInput } from "@stigmer/sdk";
+import type { ApiKey } from "@stigmer/protos/ai/stigmer/iam/apikey/v1/api_pb";
+export interface UseCreateApiKeyReturn {
+    readonly create: (input: ApiKeyInput) => Promise<ApiKey>;
+    readonly isCreating: boolean;
+    readonly error: Error | null;
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `apiKey.create()` with loading and error
+ * state.
+ *
+ * Creates an API key resource. The caller provides an
+ * {@link ApiKeyInput} with `name`, `org`, and optionally `expiresAt`
+ * or `neverExpires`.
+ *
+ * **Critical**: The returned {@link ApiKey} is the *only* time the
+ * raw key value is available — it is returned in `spec.keyHash` of
+ * the create response. After creation the server stores only the
+ * hash; subsequent queries return an empty `keyHash` and only the
+ * `fingerprint` (last 6 characters) for display.
+ *
+ * Callers must capture the raw key from the resolved promise and
+ * present it to the user immediately (e.g. via
+ * {@link ApiKeyCreatedAlert}).
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error } = useCreateApiKey();
+ *
+ * const apiKey = await create({
+ *   name: "ci-deploy-key",
+ *   org: "acme",
+ *   neverExpires: true,
+ * });
+ * // apiKey.spec?.keyHash contains the raw key — show it once
+ * ```
+ */
+export declare function useCreateApiKey(): UseCreateApiKeyReturn;
+//# sourceMappingURL=useCreateApiKey.d.ts.map

package/api-key/useCreateApiKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateApiKey.d.ts","sourceRoot":"","sources":["../../src/api-key/useCreateApiKey.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iDAAiD,CAAC;AAI9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAyBvD"}

package/api-key/useCreateApiKey.js

@@ -0,0 +1,56 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `apiKey.create()` with loading and error
+ * state.
+ *
+ * Creates an API key resource. The caller provides an
+ * {@link ApiKeyInput} with `name`, `org`, and optionally `expiresAt`
+ * or `neverExpires`.
+ *
+ * **Critical**: The returned {@link ApiKey} is the *only* time the
+ * raw key value is available — it is returned in `spec.keyHash` of
+ * the create response. After creation the server stores only the
+ * hash; subsequent queries return an empty `keyHash` and only the
+ * `fingerprint` (last 6 characters) for display.
+ *
+ * Callers must capture the raw key from the resolved promise and
+ * present it to the user immediately (e.g. via
+ * {@link ApiKeyCreatedAlert}).
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error } = useCreateApiKey();
+ *
+ * const apiKey = await create({
+ *   name: "ci-deploy-key",
+ *   org: "acme",
+ *   neverExpires: true,
+ * });
+ * // apiKey.spec?.keyHash contains the raw key — show it once
+ * ```
+ */
+export function useCreateApiKey() {
+    const stigmer = useStigmer();
+    const [isCreating, setIsCreating] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const create = useCallback(async (input) => {
+        setIsCreating(true);
+        setError(null);
+        try {
+            return await stigmer.apiKey.create(input);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsCreating(false);
+        }
+    }, [stigmer]);
+    return { create, isCreating, error, clearError };
+}
+//# sourceMappingURL=useCreateApiKey.js.map

package/api-key/useCreateApiKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateApiKey.js","sourceRoot":"","sources":["../../src/api-key/useCreateApiKey.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAS9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAkB,EAAmB,EAAE;QAC5C,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/api-key/useDeleteApiKey.d.ts

@@ -0,0 +1,26 @@
+import type { ApiKey } from "@stigmer/protos/ai/stigmer/iam/apikey/v1/api_pb";
+export interface UseDeleteApiKeyReturn {
+    readonly deleteKey: (id: string) => Promise<ApiKey>;
+    readonly isDeleting: boolean;
+    readonly error: Error | null;
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `apiKey.delete()` with loading and error
+ * state.
+ *
+ * Deletes an API key by its resource ID. Returns the deleted
+ * {@link ApiKey} on success so callers can confirm which key was
+ * removed. The deletion is permanent — the key can no longer be
+ * used for authentication.
+ *
+ * @example
+ * ```tsx
+ * const { deleteKey, isDeleting, error } = useDeleteApiKey();
+ *
+ * await deleteKey("key-id-abc123");
+ * refetch(); // refresh the list after deletion
+ * ```
+ */
+export declare function useDeleteApiKey(): UseDeleteApiKeyReturn;
+//# sourceMappingURL=useDeleteApiKey.d.ts.map

package/api-key/useDeleteApiKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteApiKey.d.ts","sourceRoot":"","sources":["../../src/api-key/useDeleteApiKey.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iDAAiD,CAAC;AAI9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAyBvD"}

package/api-key/useDeleteApiKey.js

@@ -0,0 +1,43 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `apiKey.delete()` with loading and error
+ * state.
+ *
+ * Deletes an API key by its resource ID. Returns the deleted
+ * {@link ApiKey} on success so callers can confirm which key was
+ * removed. The deletion is permanent — the key can no longer be
+ * used for authentication.
+ *
+ * @example
+ * ```tsx
+ * const { deleteKey, isDeleting, error } = useDeleteApiKey();
+ *
+ * await deleteKey("key-id-abc123");
+ * refetch(); // refresh the list after deletion
+ * ```
+ */
+export function useDeleteApiKey() {
+    const stigmer = useStigmer();
+    const [isDeleting, setIsDeleting] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const deleteKey = useCallback(async (id) => {
+        setIsDeleting(true);
+        setError(null);
+        try {
+            return await stigmer.apiKey.delete(id);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsDeleting(false);
+        }
+    }, [stigmer]);
+    return { deleteKey, isDeleting, error, clearError };
+}
+//# sourceMappingURL=useDeleteApiKey.js.map

package/api-key/useDeleteApiKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteApiKey.js","sourceRoot":"","sources":["../../src/api-key/useDeleteApiKey.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAS9C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,WAAW,CAC3B,KAAK,EAAE,EAAU,EAAmB,EAAE;QACpC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACtD,CAAC"}

package/attachment/AttachmentChipList.d.ts

@@ -0,0 +1,24 @@
+import type { AttachmentEntry } from "./useAttachments";
+export interface AttachmentChipListProps {
+    /** Attachment entries from {@link useAttachments}. */
+    readonly entries: readonly AttachmentEntry[];
+    /** Remove callback (by entry ID). */
+    readonly onRemove: (id: string) => void;
+    /** Retry callback for failed uploads (by entry ID). */
+    readonly onRetry: (id: string) => void;
+    /** Disables remove and retry actions. */
+    readonly disabled?: boolean;
+    readonly className?: string;
+}
+/**
+ * Renders a horizontal list of compact attachment chips showing
+ * filename, size, upload status, and remove/retry actions.
+ *
+ * Designed to sit between the context chips and toolbar in
+ * {@link SessionComposer}, but usable standalone by platform builders
+ * who compose their own attachment UI.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ */
+export declare function AttachmentChipList({ entries, onRemove, onRetry, disabled, className, }: AttachmentChipListProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=AttachmentChipList.d.ts.map

package/attachment/AttachmentChipList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentChipList.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentChipList.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,GACV,EAAE,uBAAuB,kDAoBzB"}

package/attachment/AttachmentChipList.js

@@ -0,0 +1,45 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { formatFileSize } from "./attachment-utils";
+/**
+ * Renders a horizontal list of compact attachment chips showing
+ * filename, size, upload status, and remove/retry actions.
+ *
+ * Designed to sit between the context chips and toolbar in
+ * {@link SessionComposer}, but usable standalone by platform builders
+ * who compose their own attachment UI.
+ *
+ * All visual properties flow through `--stgm-*` tokens.
+ */
+export function AttachmentChipList({ entries, onRemove, onRetry, disabled, className, }) {
+    if (entries.length === 0)
+        return null;
+    return (_jsx("div", { className: cn("flex flex-wrap gap-1.5", className), role: "list", "aria-label": "Attached files", children: entries.map((entry) => (_jsx(AttachmentChip, { entry: entry, onRemove: () => onRemove(entry.id), onRetry: () => onRetry(entry.id), disabled: disabled }, entry.id))) }));
+}
+// ---------------------------------------------------------------------------
+// Individual chip
+// ---------------------------------------------------------------------------
+function AttachmentChip({ entry, onRemove, onRetry, disabled, }) {
+    const isError = entry.phase === "error";
+    const isUploading = entry.phase === "uploading";
+    return (_jsxs("span", { role: "listitem", "aria-label": `${entry.file.name}, ${formatFileSize(entry.file.size)}${isUploading ? ", uploading" : ""}${isError ? ", upload failed" : ""}`, className: cn("inline-flex max-w-[200px] items-center gap-1 rounded-md px-2 py-0.5 text-xs", isError
+            ? "border border-destructive/30 bg-destructive/10 text-destructive"
+            : "bg-muted/50 text-foreground", isUploading && "opacity-70"), children: [isUploading && _jsx(ChipSpinner, {}), isError && _jsx(ErrorDot, {}), !isUploading && !isError && _jsx(FileIcon, {}), _jsx("span", { className: "truncate", children: entry.file.name }), _jsx("span", { className: "shrink-0 text-[0.6rem] tabular-nums text-muted-foreground", children: formatFileSize(entry.file.size) }), isError && (_jsx("button", { type: "button", onClick: onRetry, disabled: disabled, className: "shrink-0 text-[0.6rem] font-medium text-destructive underline hover:text-destructive/80 disabled:pointer-events-none", "aria-label": `Retry uploading ${entry.file.name}`, children: "Retry" })), _jsx("button", { type: "button", onClick: onRemove, disabled: disabled, className: "ml-0.5 shrink-0 text-muted-foreground hover:text-destructive disabled:pointer-events-none", "aria-label": `Remove ${entry.file.name}`, children: _jsx(XIcon, {}) })] }));
+}
+// ---------------------------------------------------------------------------
+// Inline SVG icons — kept minimal and consistent with SessionComposer icons
+// ---------------------------------------------------------------------------
+function ChipSpinner() {
+    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", className: "shrink-0 animate-spin text-muted-foreground", "aria-hidden": "true", children: _jsx("path", { d: "M8 2a6 6 0 1 0 6 6" }) }));
+}
+function ErrorDot() {
+    return (_jsx("span", { className: "inline-block h-1.5 w-1.5 shrink-0 rounded-full bg-destructive", "aria-hidden": "true" }));
+}
+function FileIcon() {
+    return (_jsxs("svg", { width: "10", height: "10", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", className: "shrink-0 text-muted-foreground", "aria-hidden": "true", children: [_jsx("path", { d: "M8 1H4C3.45 1 3 1.45 3 2V12C3 12.55 3.45 13 4 13H10C10.55 13 11 12.55 11 12V4L8 1Z" }), _jsx("path", { d: "M8 1V4H11" })] }));
+}
+function XIcon() {
+    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M4 4L10 10M10 4L4 10" }) }));
+}
+//# sourceMappingURL=AttachmentChipList.js.map

package/attachment/AttachmentChipList.js.map

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

package/attachment/attachment-utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Maximum attachment size in bytes (10 MB).
+ *
+ * Matches the CLI's `maxAttachmentSize` and the gRPC server's
+ * `MaxRecvMsgSize`. Files exceeding this limit are rejected before
+ * upload to avoid wasting bandwidth on requests that will fail.
+ */
+export declare const MAX_ATTACHMENT_BYTES: number;
+/**
+ * Detects the MIME content type for a file.
+ *
+ * Prefers the browser-provided `File.type` when available and
+ * non-empty. Falls back to extension-based detection mirroring the
+ * CLI's `detectContentType` function. Returns
+ * `"application/octet-stream"` when neither source yields a result.
+ */
+export declare function detectContentType(file: File): string;
+/**
+ * Formats a byte count as a human-readable string (e.g., `"2.3 MB"`).
+ *
+ * Uses base-1024 (binary) units with one decimal place, consistent
+ * with {@link formatArtifactSize} in the artifact utilities.
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Validates a file against the attachment size limit.
+ *
+ * Returns `null` when valid, or an error message string when the
+ * file exceeds {@link MAX_ATTACHMENT_BYTES}.
+ */
+export declare function validateAttachmentSize(file: File): string | null;
+//# sourceMappingURL=attachment-utils.d.ts.map

package/attachment/attachment-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-utils.d.ts","sourceRoot":"","sources":["../../src/attachment/attachment-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAiDrD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAapD;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAapD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAKhE"}

package/attachment/attachment-utils.js

@@ -0,0 +1,104 @@
+/**
+ * Maximum attachment size in bytes (10 MB).
+ *
+ * Matches the CLI's `maxAttachmentSize` and the gRPC server's
+ * `MaxRecvMsgSize`. Files exceeding this limit are rejected before
+ * upload to avoid wasting bandwidth on requests that will fail.
+ */
+export const MAX_ATTACHMENT_BYTES = 10 * 1024 * 1024;
+/**
+ * Extension-to-MIME-type mapping for common file types.
+ *
+ * Used as a fallback when `File.type` is empty or generic. Mirrors
+ * the CLI's `detectContentType` to ensure consistent behavior.
+ */
+const EXTENSION_MIME_MAP = {
+    ".md": "text/markdown",
+    ".markdown": "text/markdown",
+    ".yaml": "application/x-yaml",
+    ".yml": "application/x-yaml",
+    ".json": "application/json",
+    ".csv": "text/csv",
+    ".tsv": "text/tab-separated-values",
+    ".xml": "application/xml",
+    ".html": "text/html",
+    ".htm": "text/html",
+    ".css": "text/css",
+    ".js": "application/javascript",
+    ".ts": "application/typescript",
+    ".py": "text/x-python",
+    ".go": "text/x-go",
+    ".rs": "text/x-rust",
+    ".java": "text/x-java",
+    ".rb": "text/x-ruby",
+    ".sh": "application/x-sh",
+    ".bash": "application/x-sh",
+    ".sql": "application/sql",
+    ".toml": "application/toml",
+    ".ini": "text/plain",
+    ".cfg": "text/plain",
+    ".conf": "text/plain",
+    ".env": "text/plain",
+    ".txt": "text/plain",
+    ".log": "text/plain",
+    ".pdf": "application/pdf",
+    ".zip": "application/zip",
+    ".gz": "application/gzip",
+    ".tar": "application/x-tar",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".webp": "image/webp",
+};
+/**
+ * Detects the MIME content type for a file.
+ *
+ * Prefers the browser-provided `File.type` when available and
+ * non-empty. Falls back to extension-based detection mirroring the
+ * CLI's `detectContentType` function. Returns
+ * `"application/octet-stream"` when neither source yields a result.
+ */
+export function detectContentType(file) {
+    if (file.type && file.type !== "application/octet-stream") {
+        return file.type;
+    }
+    const dotIndex = file.name.lastIndexOf(".");
+    if (dotIndex !== -1) {
+        const ext = file.name.slice(dotIndex).toLowerCase();
+        const mapped = EXTENSION_MIME_MAP[ext];
+        if (mapped)
+            return mapped;
+    }
+    return "application/octet-stream";
+}
+const SIZE_UNITS = ["B", "KB", "MB", "GB"];
+/**
+ * Formats a byte count as a human-readable string (e.g., `"2.3 MB"`).
+ *
+ * Uses base-1024 (binary) units with one decimal place, consistent
+ * with {@link formatArtifactSize} in the artifact utilities.
+ */
+export function formatFileSize(bytes) {
+    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]}`;
+}
+/**
+ * Validates a file against the attachment size limit.
+ *
+ * Returns `null` when valid, or an error message string when the
+ * file exceeds {@link MAX_ATTACHMENT_BYTES}.
+ */
+export function validateAttachmentSize(file) {
+    if (file.size > MAX_ATTACHMENT_BYTES) {
+        return `${file.name} exceeds the 10 MB attachment limit (${formatFileSize(file.size)})`;
+    }
+    return null;
+}
+//# sourceMappingURL=attachment-utils.js.map

package/attachment/attachment-utils.js.map

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

package/attachment/index.d.ts

@@ -0,0 +1,6 @@
+export { useAttachments } from "./useAttachments";
+export type { AttachmentPhase, AttachmentEntry, UseAttachmentsOptions, UseAttachmentsReturn, } from "./useAttachments";
+export { AttachmentChipList } from "./AttachmentChipList";
+export type { AttachmentChipListProps } from "./AttachmentChipList";
+export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment-utils";
+//# sourceMappingURL=index.d.ts.map

package/attachment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/attachment/index.js

@@ -0,0 +1,4 @@
+export { useAttachments } from "./useAttachments";
+export { AttachmentChipList } from "./AttachmentChipList";
+export { MAX_ATTACHMENT_BYTES, detectContentType, formatFileSize, validateAttachmentSize, } from "./attachment-utils";
+//# sourceMappingURL=index.js.map

package/attachment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/attachment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/attachment/useAttachments.d.ts

@@ -0,0 +1,113 @@
+import type { AttachmentInput } from "@stigmer/sdk";
+/**
+ * Lifecycle phase of a single attachment managed by {@link useAttachments}.
+ *
+ * - `uploading` — bytes are being sent to the server
+ * - `ready` — upload succeeded, `storageKey` is available
+ * - `error` — upload failed, `error` describes the failure
+ */
+export type AttachmentPhase = "uploading" | "ready" | "error";
+/**
+ * State for a single file being managed by the hook.
+ *
+ * The `id` is a stable string generated at add-time, used as a React
+ * key and for removal. The same `File` added twice produces two
+ * independent entries with distinct IDs.
+ */
+export interface AttachmentEntry {
+    readonly id: string;
+    readonly file: File;
+    readonly phase: AttachmentPhase;
+    readonly contentType: string;
+    /** Set when `phase` is `"ready"`. */
+    readonly storageKey: string | null;
+    /** Set when `phase` is `"error"`. */
+    readonly error: string | null;
+}
+export interface UseAttachmentsOptions {
+    /**
+     * Called when a file is rejected during `addFiles` (e.g., exceeds
+     * the size limit). Consumers can use this for toast notifications.
+     */
+    readonly onValidationError?: (message: string) => void;
+}
+export interface UseAttachmentsReturn {
+    /** Current attachment entries (uploading, ready, or errored). */
+    readonly entries: readonly AttachmentEntry[];
+    /** True when at least one entry is in the `"uploading"` phase. */
+    readonly isUploading: boolean;
+    /** Number of entries that are ready for submission. */
+    readonly readyCount: number;
+    /** True when there are entries and all are ready (none uploading or errored). */
+    readonly allReady: boolean;
+    /** True when there is at least one entry (in any phase). */
+    readonly hasEntries: boolean;
+    /**
+     * Add one or more files. Each file is validated and uploaded
+     * immediately. Invalid files (e.g., too large) are rejected via
+     * `onValidationError` and not added.
+     */
+    readonly addFiles: (files: FileList | File[]) => void;
+    /** Remove an entry by its stable ID. Aborts in-flight uploads. */
+    readonly removeEntry: (id: string) => void;
+    /** Retry a failed upload. */
+    readonly retryEntry: (id: string) => void;
+    /** Clear all entries and abort any in-flight uploads. */
+    readonly clear: () => void;
+    /**
+     * Produces the `AttachmentInput[]` suitable for execution creation.
+     * Only includes entries in the `"ready"` phase.
+     */
+    readonly toAttachmentInputs: () => AttachmentInput[];
+}
+/**
+ * Behavior hook that manages file attachments for agent executions.
+ *
+ * Handles the full lifecycle: file validation, upload via
+ * `stigmer.agentExecution.uploadAttachment()`, progress tracking,
+ * error handling, and retry. Produces `AttachmentInput[]` ready
+ * for execution creation.
+ *
+ * Files are uploaded immediately on selection so the `storageKey`
+ * is available by the time the user submits their message.
+ *
+ * Platform builders who want custom attachment UI import this hook
+ * directly. The {@link SessionComposer} styled component uses it
+ * internally.
+ *
+ * @example
+ * ```tsx
+ * function CustomComposer() {
+ *   const attachments = useAttachments({
+ *     onValidationError: (msg) => toast.error(msg),
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         type="file"
+ *         multiple
+ *         onChange={(e) => {
+ *           if (e.target.files) attachments.addFiles(e.target.files);
+ *         }}
+ *       />
+ *       {attachments.entries.map((entry) => (
+ *         <div key={entry.id}>
+ *           {entry.file.name} — {entry.phase}
+ *           {entry.phase === "error" && (
+ *             <button onClick={() => attachments.retryEntry(entry.id)}>
+ *               Retry
+ *             </button>
+ *           )}
+ *           <button onClick={() => attachments.removeEntry(entry.id)}>
+ *             Remove
+ *           </button>
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAttachments(options?: UseAttachmentsOptions): UseAttachmentsReturn;
+//# sourceMappingURL=useAttachments.d.ts.map

package/attachment/useAttachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachments.d.ts","sourceRoot":"","sources":["../../src/attachment/useAttachments.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAapD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC;IACtD,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,eAAe,EAAE,CAAC;CACtD;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAqJtB"}