@kortix/sdk 0.9.98

package/dist/react/use-opencode-mcp.js

@@ -0,0 +1,190 @@
+'use client';
+/**
+ * useOpenCodeMcp — React Query hooks for MCP (Model Context Protocol) server management.
+ *
+ * Wraps the SDK's `client.mcp.*` namespace:
+ * - status()         — list all servers + their statuses
+ * - add()            — register a new MCP server
+ * - connect()        — connect a server by name
+ * - disconnect()     — disconnect a server by name
+ * - auth.start()     — start OAuth flow (returns authorization URL)
+ * - auth.callback()  — complete OAuth with authorization code
+ * - auth.remove()    — remove OAuth credentials
+ */
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { getClient } from '../opencode/client.js';
+import { opencodeKeys, useOpenCodeMcpStatus } from './use-opencode-sessions/index.js';
+// ============================================================================
+// Re-export the existing status query hook for convenience
+// ============================================================================
+export { useOpenCodeMcpStatus };
+// ============================================================================
+// Helper: unwrap SDK response
+// ============================================================================
+function unwrap(result) {
+    if (result.error) {
+        // `error`'s shape varies per endpoint's typed error union — duck-type
+        // defensively via `unknown` rather than assume a shape.
+        const err = result.error;
+        const status = result.response?.status;
+        const errRec = err && typeof err === 'object' ? err : undefined;
+        const dataRec = errRec?.data && typeof errRec.data === 'object' ? errRec.data : undefined;
+        const msg = dataRec?.message ||
+            errRec?.message ||
+            errRec?.error ||
+            (typeof err === 'string' ? err : null) ||
+            (typeof err === 'object' ? JSON.stringify(err) : null) ||
+            (status ? `Server returned ${status}` : 'SDK request failed');
+        throw new Error(String(msg));
+    }
+    return result.data;
+}
+export function useAddMcpServer() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (params) => {
+            const client = getClient();
+            const config = params.type === 'local'
+                ? {
+                    type: 'local',
+                    command: params.command ?? [],
+                    ...(params.env && Object.keys(params.env).length > 0
+                        ? { environment: params.env }
+                        : {}),
+                }
+                : {
+                    type: 'remote',
+                    url: params.url ?? '',
+                    ...(params.headers && Object.keys(params.headers).length > 0
+                        ? { headers: params.headers }
+                        : {}),
+                };
+            const result = await client.mcp.add({
+                name: params.name,
+                config,
+            });
+            return unwrap(result);
+        },
+        onSuccess: (data) => {
+            // Optimistically set the full status map returned by add()
+            queryClient.setQueryData(opencodeKeys.mcpStatus(), data);
+            // Also refresh tool IDs since new server may expose tools
+            queryClient.refetchQueries({ queryKey: opencodeKeys.toolIds(), type: 'active' });
+        },
+    });
+}
+// ============================================================================
+// Connect MCP Server
+// ============================================================================
+export function useConnectMcpServer() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (name) => {
+            const client = getClient();
+            const result = await client.mcp.connect({ name });
+            return unwrap(result);
+        },
+        onMutate: async (name) => {
+            // Optimistic update: set status to "connected"
+            await queryClient.cancelQueries({ queryKey: opencodeKeys.mcpStatus() });
+            const prev = queryClient.getQueryData(opencodeKeys.mcpStatus());
+            if (prev) {
+                queryClient.setQueryData(opencodeKeys.mcpStatus(), {
+                    ...prev,
+                    [name]: { status: 'connected' },
+                });
+            }
+            return { prev };
+        },
+        onError: (_err, _name, context) => {
+            // Rollback on error
+            if (context?.prev) {
+                queryClient.setQueryData(opencodeKeys.mcpStatus(), context.prev);
+            }
+        },
+        onSettled: () => {
+            queryClient.refetchQueries({ queryKey: opencodeKeys.mcpStatus(), type: 'active' });
+            queryClient.refetchQueries({ queryKey: opencodeKeys.toolIds(), type: 'active' });
+        },
+    });
+}
+// ============================================================================
+// Disconnect MCP Server
+// ============================================================================
+export function useDisconnectMcpServer() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (name) => {
+            const client = getClient();
+            const result = await client.mcp.disconnect({ name });
+            return unwrap(result);
+        },
+        onMutate: async (name) => {
+            // Optimistic update: set status to "disabled"
+            await queryClient.cancelQueries({ queryKey: opencodeKeys.mcpStatus() });
+            const prev = queryClient.getQueryData(opencodeKeys.mcpStatus());
+            if (prev) {
+                queryClient.setQueryData(opencodeKeys.mcpStatus(), {
+                    ...prev,
+                    [name]: { status: 'disabled' },
+                });
+            }
+            return { prev };
+        },
+        onError: (_err, _name, context) => {
+            if (context?.prev) {
+                queryClient.setQueryData(opencodeKeys.mcpStatus(), context.prev);
+            }
+        },
+        onSettled: () => {
+            queryClient.refetchQueries({ queryKey: opencodeKeys.mcpStatus(), type: 'active' });
+            queryClient.refetchQueries({ queryKey: opencodeKeys.toolIds(), type: 'active' });
+        },
+    });
+}
+// ============================================================================
+// MCP OAuth: Start
+// ============================================================================
+export function useMcpAuthStart() {
+    return useMutation({
+        mutationFn: async (name) => {
+            const client = getClient();
+            const result = await client.mcp.auth.start({ name });
+            return unwrap(result);
+        },
+    });
+}
+// ============================================================================
+// MCP OAuth: Callback
+// ============================================================================
+export function useMcpAuthCallback() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ name, code }) => {
+            const client = getClient();
+            const result = await client.mcp.auth.callback({ name, code });
+            return unwrap(result);
+        },
+        onSuccess: () => {
+            queryClient.refetchQueries({ queryKey: opencodeKeys.mcpStatus(), type: 'active' });
+            queryClient.refetchQueries({ queryKey: opencodeKeys.toolIds(), type: 'active' });
+        },
+    });
+}
+// ============================================================================
+// MCP OAuth: Remove
+// ============================================================================
+export function useMcpAuthRemove() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (name) => {
+            const client = getClient();
+            const result = await client.mcp.auth.remove({ name });
+            return unwrap(result);
+        },
+        onSuccess: () => {
+            queryClient.refetchQueries({ queryKey: opencodeKeys.mcpStatus(), type: 'active' });
+        },
+    });
+}
+//# sourceMappingURL=use-opencode-mcp.js.map

package/dist/react/use-opencode-mcp.js.map

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

package/dist/react/use-opencode-pty.d.ts

@@ -0,0 +1,30 @@
+import type { Pty } from '@opencode-ai/sdk/v2/client';
+export type { Pty };
+export declare const ptyKeys: {
+    all: readonly ["pty"];
+    list: (serverUrl: string) => readonly ["pty", string, "list"];
+    listPrefix: () => readonly ["pty"];
+    detail: (id: string) => readonly ["pty", string];
+};
+export declare function useOpenCodePtyList(options?: {
+    enabled?: boolean;
+    serverUrl?: string;
+}): import("@tanstack/react-query").UseQueryResult<NoInfer<Pty[]>, Error>;
+export declare function useCreatePty(): import("@tanstack/react-query").UseMutationResult<Pty, Error, {
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    title?: string;
+    env?: Record<string, string>;
+} | undefined, unknown>;
+export declare function useRemovePty(): import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+export declare function useUpdatePty(): import("@tanstack/react-query").UseMutationResult<Pty, Error, {
+    id: string;
+    title?: string;
+    size?: {
+        rows: number;
+        cols: number;
+    };
+}, unknown>;
+export declare function getPtyWebSocketUrl(ptyId: string, serverUrl?: string): Promise<string>;
+//# sourceMappingURL=use-opencode-pty.d.ts.map

package/dist/react/use-opencode-pty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-opencode-pty.d.ts","sourceRoot":"","sources":["../../src/react/use-opencode-pty.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAGtD,YAAY,EAAE,GAAG,EAAE,CAAC;AAQpB,eAAO,MAAM,OAAO;;sBAEA,MAAM;;iBAEX,MAAM;CACpB,CAAC;AAwBF,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,yEAgBrF;AAED,wBAAgB,YAAY;cAKZ,MAAM;WACT,MAAM,EAAE;UACT,MAAM;YACJ,MAAM;UACR,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;wBAWjC;AAED,wBAAgB,YAAY,oFAc3B;AAED,wBAAgB,YAAY;QAOlB,MAAM;YACF,MAAM;WACP;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;YAO1C;AAMD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B3F"}

package/dist/react/use-opencode-pty.js

@@ -0,0 +1,126 @@
+'use client';
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { stripTrailingSlashes } from '../platform/strings.js';
+import { getClient } from '../opencode/client.js';
+import { getActiveOpenCodeUrl } from '../state/server-store.js';
+import { getAuthToken } from '../platform/auth.js';
+import { useOpenCodeRuntimeReady } from './use-opencode-sessions/keys.js';
+// ============================================================================
+// Query Keys
+// ============================================================================
+// Keys intentionally NOT under 'opencode' so they survive server-switch cache nukes.
+// Scoped by serverUrl so each instance keeps its own cached list.
+export const ptyKeys = {
+    all: ['pty'],
+    list: (serverUrl) => ['pty', serverUrl, 'list'],
+    listPrefix: () => ['pty'],
+    detail: (id) => ['pty', id],
+};
+// ============================================================================
+// Helper: unwrap SDK response
+// ============================================================================
+function unwrap(result) {
+    if (result.error) {
+        // `error`'s shape varies per endpoint's typed error union — duck-type
+        // defensively via `unknown` rather than assume a shape.
+        const err = result.error;
+        const errRec = err && typeof err === 'object' ? err : undefined;
+        const dataRec = errRec?.data && typeof errRec.data === 'object' ? errRec.data : undefined;
+        const message = dataRec?.message ?? errRec?.message;
+        throw new Error(typeof message === 'string' ? message : 'SDK request failed');
+    }
+    return result.data;
+}
+// ============================================================================
+// Hooks
+// ============================================================================
+export function useOpenCodePtyList(options) {
+    const activeUrl = getActiveOpenCodeUrl();
+    const serverUrl = options?.serverUrl ?? activeUrl;
+    const runtimeReady = useOpenCodeRuntimeReady();
+    return useQuery({
+        queryKey: ptyKeys.list(serverUrl),
+        queryFn: async () => {
+            const client = getClient();
+            const result = await client.pty.list();
+            return unwrap(result);
+        },
+        staleTime: Infinity, // SSE pty.* events trigger refetch
+        gcTime: 5 * 60 * 1000,
+        refetchOnWindowFocus: false,
+        enabled: runtimeReady && (options?.enabled ?? true),
+    });
+}
+export function useCreatePty() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (options) => {
+            const client = getClient();
+            const result = await client.pty.create(options);
+            return unwrap(result);
+        },
+        onSuccess: () => {
+            // SSE pty.created will also fire; this is instant feedback
+            queryClient.refetchQueries({ queryKey: ptyKeys.listPrefix(), type: 'active' });
+        },
+    });
+}
+export function useRemovePty() {
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async (id) => {
+            const client = getClient();
+            const result = await client.pty.remove({ ptyID: id });
+            unwrap(result);
+        },
+        onSuccess: () => {
+            // SSE pty.deleted will also fire
+            queryClient.refetchQueries({ queryKey: ptyKeys.listPrefix(), type: 'active' });
+        },
+    });
+}
+export function useUpdatePty() {
+    return useMutation({
+        mutationFn: async ({ id, title, size, }) => {
+            const client = getClient();
+            const result = await client.pty.update({ ptyID: id, title, size });
+            return unwrap(result);
+        },
+    });
+}
+// ============================================================================
+// WebSocket URL helper
+// ============================================================================
+export async function getPtyWebSocketUrl(ptyId, serverUrl) {
+    const baseUrl = serverUrl || getActiveOpenCodeUrl();
+    const wsUrl = (() => {
+        try {
+            const parsed = new URL(baseUrl);
+            if (parsed.protocol === 'https:') {
+                parsed.protocol = 'wss:';
+            }
+            else if (parsed.protocol === 'http:') {
+                parsed.protocol = 'ws:';
+            }
+            // Browsers block ws:// from an https page (mixed content).
+            // Force secure WS in that scenario to avoid deployment-only failures.
+            if (typeof window !== 'undefined' && window.location.protocol === 'https:' && parsed.protocol === 'ws:') {
+                parsed.protocol = 'wss:';
+            }
+            return stripTrailingSlashes(parsed.toString());
+        }
+        catch {
+            return baseUrl.replace('https://', 'wss://').replace('http://', 'ws://');
+        }
+    })();
+    const url = `${wsUrl}/pty/${ptyId}/connect`;
+    // Browser WebSocket API doesn't support custom headers, so inject the
+    // auth token as a query parameter for the backend proxy to authenticate.
+    const token = await getAuthToken();
+    if (token) {
+        const sep = url.includes('?') ? '&' : '?';
+        return `${url}${sep}token=${encodeURIComponent(token)}`;
+    }
+    return url;
+}
+//# sourceMappingURL=use-opencode-pty.js.map

package/dist/react/use-opencode-pty.js.map

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

package/dist/react/use-opencode-sessions/agents.d.ts

@@ -0,0 +1,14 @@
+import type { Agent } from '@opencode-ai/sdk/v2/client';
+export { useVisibleAgents } from '../use-visible-agents.js';
+/**
+ * Load agents. With `projectId`, the server-side project config is source of
+ * truth: it returns declarative `kortix.toml [[agents]]` entries for adopted
+ * projects and OpenCode file discovery for legacy projects. Without `projectId`,
+ * this falls back to the sandbox OpenCode runtime.
+ */
+export declare function useOpenCodeAgents(options?: {
+    directory?: string;
+    projectId?: string | null;
+}): import("@tanstack/react-query").UseQueryResult<NoInfer<Agent[]>, Error>;
+export declare function useOpenCodeAgent(agentName: string): import("@tanstack/react-query").UseQueryResult<NoInfer<Agent | undefined>, Error>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/react/use-opencode-sessions/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/agents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AASxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,2EAwC5F;AAcD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,qFAajD"}

package/dist/react/use-opencode-sessions/agents.js

@@ -0,0 +1,82 @@
+'use client';
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../../opencode/client.js';
+import { opencodeKeys, useOpenCodeRuntimeReady } from './keys.js';
+import { unwrap, getLSCache, setLSCache, LS_AGENTS, CACHE_SCOPE_GLOBAL } from './shared.js';
+import { getProjectDetail, } from '../../platform/projects-client/index.js';
+// Re-export filtered agents hook for UI agent selectors
+export { useVisibleAgents } from '../use-visible-agents.js';
+// ============================================================================
+// Agent Hooks
+// ============================================================================
+/**
+ * Load agents. With `projectId`, the server-side project config is source of
+ * truth: it returns declarative `kortix.toml [[agents]]` entries for adopted
+ * projects and OpenCode file discovery for legacy projects. Without `projectId`,
+ * this falls back to the sandbox OpenCode runtime.
+ */
+export function useOpenCodeAgents(options) {
+    const directory = options?.directory;
+    const projectId = options?.projectId ?? null;
+    const runtimeReady = useOpenCodeRuntimeReady();
+    const cacheScope = projectId
+        ? `project:${projectId}`
+        : directory
+            ? `dir:${directory}`
+            : CACHE_SCOPE_GLOBAL;
+    return useQuery({
+        queryKey: projectId
+            ? ['project-detail', projectId, 'agents']
+            : directory
+                ? [...opencodeKeys.agents(), 'dir', directory]
+                : opencodeKeys.agents(),
+        queryFn: async () => {
+            if (projectId) {
+                const detail = await getProjectDetail(projectId);
+                const agents = detail.config.agents.map(projectConfigAgentToOpenCodeAgent);
+                setLSCache(LS_AGENTS, agents, cacheScope);
+                return agents;
+            }
+            const client = getClient();
+            const result = await client.app.agents(directory ? { directory } : undefined);
+            const data = unwrap(result);
+            const agents = Array.isArray(data) ? data : Object.values(data);
+            // Agents are defined in the project repo (.kortix/opencode/agents), so the
+            // roster is stable across every session that shares a working directory.
+            // Cache under a directory-scoped (or global) STABLE key — not the
+            // ephemeral per-sandbox server id — so a new session's picker paints from
+            // cache instead of waiting on sandbox boot + the in-box /app/agents call.
+            // (Previously the directory case cached nothing at all → guaranteed pop-in.)
+            setLSCache(LS_AGENTS, agents, cacheScope);
+            return agents;
+        },
+        placeholderData: () => getLSCache(LS_AGENTS, cacheScope),
+        enabled: projectId ? true : runtimeReady,
+        staleTime: projectId ? 30_000 : Infinity,
+        gcTime: 10 * 60 * 1000,
+    });
+}
+function projectConfigAgentToOpenCodeAgent(agent) {
+    return {
+        name: agent.name,
+        description: agent.description ?? undefined,
+        mode: agent.mode ?? undefined,
+        source: agent.source,
+        hidden: agent.enabled === false,
+    };
+}
+export function useOpenCodeAgent(agentName) {
+    const runtimeReady = useOpenCodeRuntimeReady();
+    return useQuery({
+        queryKey: [...opencodeKeys.agents(), agentName],
+        queryFn: async () => {
+            const client = getClient();
+            const result = await client.app.agents();
+            const agents = unwrap(result);
+            return agents.find((a) => a.name === agentName);
+        },
+        enabled: runtimeReady && !!agentName,
+        staleTime: Infinity,
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/react/use-opencode-sessions/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/agents.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EACL,gBAAgB,GAEjB,MAAM,gCAAgC,CAAC;AAExC,wDAAwD;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2D;IAC3F,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC;IAC7C,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,WAAW,SAAS,EAAE;QACxB,CAAC,CAAC,SAAS;YACT,CAAC,CAAC,OAAO,SAAS,EAAE;YACpB,CAAC,CAAC,kBAAkB,CAAC;IACzB,OAAO,QAAQ,CAAU;QACvB,QAAQ,EAAE,SAAS;YACjB,CAAC,CAAC,CAAC,gBAAgB,EAAE,SAAS,EAAE,QAAQ,CAAC;YACzC,CAAC,CAAC,SAAS;gBACT,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC;gBAC9C,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE;QAC3B,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;gBACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;gBAC3E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;gBAC1C,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAY,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAA6B,CAAC,CAAC;YAClG,2EAA2E;YAC3E,yEAAyE;YACzE,kEAAkE;YAClE,0EAA0E;YAC1E,0EAA0E;YAC1E,6EAA6E;YAC7E,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,eAAe,EAAE,GAAG,EAAE,CAAC,UAAU,CAAU,SAAS,EAAE,UAAU,CAAC;QACjE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;QACxC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QACxC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;KACvB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iCAAiC,CACxC,KAA6C;IAE7C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS;QAC3C,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,OAAO,KAAK,KAAK;KACZ,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAC;IAC/C,OAAO,QAAQ,CAAoB;QACjC,QAAQ,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC;QAC/C,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,EAAE,YAAY,IAAI,CAAC,CAAC,SAAS;QACpC,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/react/use-opencode-sessions/commands.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from '@opencode-ai/sdk/v2/client';
+export declare function useOpenCodeCommands(): import("@tanstack/react-query").UseQueryResult<NoInfer<Command[]>, Error>;
+export declare function useExecuteOpenCodeCommand(): import("@tanstack/react-query").UseMutationResult<void, Error, {
+    sessionId: string;
+    command: string;
+    args?: string;
+}, unknown>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/react/use-opencode-sessions/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/commands.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAQ1D,wBAAgB,mBAAmB,8EAgBlC;AAED,wBAAgB,yBAAyB;eAOxB,MAAM;aACR,MAAM;WACR,MAAM;YAkBlB"}

package/dist/react/use-opencode-sessions/commands.js

@@ -0,0 +1,46 @@
+'use client';
+import { useQuery, useMutation } from '@tanstack/react-query';
+import { getClient } from '../../opencode/client.js';
+import { opencodeKeys, useOpenCodeRuntimeReady } from './keys.js';
+import { unwrap, getLSCache, setLSCache, LS_COMMANDS } from './shared.js';
+// ============================================================================
+// Command Hooks
+// ============================================================================
+export function useOpenCodeCommands() {
+    const runtimeReady = useOpenCodeRuntimeReady();
+    return useQuery({
+        queryKey: opencodeKeys.commands(),
+        queryFn: async () => {
+            const client = getClient();
+            const result = await client.command.list();
+            const commands = unwrap(result);
+            setLSCache(LS_COMMANDS, commands);
+            return commands;
+        },
+        placeholderData: () => getLSCache(LS_COMMANDS),
+        enabled: runtimeReady,
+        staleTime: Infinity,
+        gcTime: 10 * 60 * 1000,
+    });
+}
+export function useExecuteOpenCodeCommand() {
+    return useMutation({
+        mutationFn: async ({ sessionId, command, args, }) => {
+            const client = getClient();
+            const result = await client.session.command({
+                sessionID: sessionId,
+                command,
+                arguments: args || '',
+            });
+            unwrap(result);
+        },
+        // CRITICAL: Disable retry for commands. The /command endpoint blocks until
+        // the agent finishes, which can take minutes (e.g. onboarding). If a proxy
+        // timeout or network error kills the connection, TanStack Query's default
+        // global retry would re-POST the command, causing it to execute twice on
+        // the server. Commands are non-idempotent — each POST creates a new
+        // execution. Never retry them.
+        retry: false,
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/react/use-opencode-sessions/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/commands.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvE,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,UAAU,mBAAmB;IACjC,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAC;IAC/C,OAAO,QAAQ,CAAY;QACzB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE;QACjC,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAClC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,eAAe,EAAE,GAAG,EAAE,CAAC,UAAU,CAAY,WAAW,CAAC;QACzD,OAAO,EAAE,YAAY;QACrB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;KACvB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,EACjB,SAAS,EACT,OAAO,EACP,IAAI,GAKL,EAAE,EAAE;YACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC1C,SAAS,EAAE,SAAS;gBACpB,OAAO;gBACP,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,CAAC;QACjB,CAAC;QACD,2EAA2E;QAC3E,2EAA2E;QAC3E,0EAA0E;QAC1E,yEAAyE;QACzE,oEAAoE;QACpE,+BAA+B;QAC/B,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/react/use-opencode-sessions/files.d.ts

@@ -0,0 +1,2 @@
+export declare function findOpenCodeFiles(query: string): Promise<string[]>;
+//# sourceMappingURL=files.d.ts.map

package/dist/react/use-opencode-sessions/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/files.ts"],"names":[],"mappings":"AAqBA,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoLxE"}