@notis_ai/cli 0.2.18 → 0.2.19

package/template/packages/sdk/src/hooks/useCloudComputer.ts

@@ -1,97 +0,0 @@
-'use client';
-
-import { useCallback, useEffect, useRef, useState } from 'react';
-import { useNotisRuntime } from '../provider';
-import type { CloudComputerFacts } from '../runtime';
-
-export interface UseCloudComputerResult {
-  /**
-   * The facts, or null while the first read is in flight. `facts.available`
-   * is false when this host cannot answer — render the app's own fallback.
-   */
-  facts: CloudComputerFacts | null;
-  loading: boolean;
-  error: Error | null;
-  /** Re-read the facts. The platform caches them for a few minutes. */
-  refresh: () => Promise<void>;
-}
-
-const UNAVAILABLE: CloudComputerFacts = {
-  available: false,
-  reason: 'unsupported_host',
-  sandbox: null,
-  cli_auth: {
-    gh: { authenticated: null, account: null, checked_at: null, reason: 'unsupported_host' },
-  },
-};
-
-/**
- * Read-only facts about the user's cloud computer.
- *
- * ```tsx
- * const { facts } = useCloudComputer();
- * const gh = facts?.available ? facts.cli_auth.gh : null;
- *
- * return gh?.authenticated
- *   ? <p>Signed in as {gh.account}</p>
- *   : <GithubConnect />;
- * ```
- *
- * Requires `capabilities.cloudComputer: 'read'` in `notis.config.ts` and the
- * user's approval at install time. It answers with state the platform already
- * holds: reading it never creates, resumes or commands a sandbox, and the GitHub
- * probe only runs when the sandbox is already awake. `authenticated: null`
- * therefore means *unknown*, not *signed out* — keep the app's own fallback for
- * that case and for hosts that answer `{ available: false }` (the dev harness,
- * the vite preview).
- */
-export function useCloudComputer(): UseCloudComputerResult {
-  const runtime = useNotisRuntime();
-  const [facts, setFacts] = useState<CloudComputerFacts | null>(null);
-  // True from the first committed render: the initial read is already queued
-  // in an effect, and `{ loading: false, facts: null }` would flash a
-  // consumer's fallback branch before the answer arrives.
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<Error | null>(null);
-  const mounted = useRef(true);
-
-  useEffect(() => {
-    mounted.current = true;
-    return () => {
-      mounted.current = false;
-    };
-  }, []);
-
-  const read = useCallback(async (options?: { refresh?: boolean }) => {
-    if (!runtime?.cloudComputerFacts) {
-      setFacts(UNAVAILABLE);
-      setLoading(false);
-      return;
-    }
-
-    setLoading(true);
-    setError(null);
-    try {
-      const next = await runtime.cloudComputerFacts(options);
-      if (mounted.current) setFacts(next);
-    } catch (err) {
-      const e = err instanceof Error ? err : new Error(String(err));
-      if (mounted.current) {
-        setError(e);
-        // A refused or failed read is the same product state as a host that
-        // cannot answer: the app shows its fallback instead of an error.
-        setFacts(UNAVAILABLE);
-      }
-    } finally {
-      if (mounted.current) setLoading(false);
-    }
-  }, [runtime]);
-
-  useEffect(() => {
-    void read();
-  }, [read]);
-
-  const refresh = useCallback(() => read({ refresh: true }), [read]);
-
-  return { facts, loading, error, refresh };
-}

package/template/packages/sdk/src/hooks/useDatabaseSchema.ts

@@ -1,85 +0,0 @@
-'use client';
-
-import { useCallback, useEffect, useState } from 'react';
-import { useNotisRuntime } from '../provider';
-import { normalizeDatabaseProperty, optionalString } from '../documents';
-import type { DatabaseProperty } from '../runtime';
-
-interface GetDatabaseResult {
-  database?: {
-    name?: string;
-    description?: string | null;
-    schema?: {
-      properties?: unknown[];
-    };
-  };
-  message?: string;
-  error?: string;
-}
-
-export interface UseDatabaseSchemaResult {
-  name: string | null;
-  description: string | null;
-  properties: DatabaseProperty[];
-  loading: boolean;
-  error: Error | null;
-  refetch: () => void;
-}
-
-/** Fetch a database's schema (normalized properties + metadata). */
-export function useDatabaseSchema(databaseSlug: string): UseDatabaseSchemaResult {
-  const runtime = useNotisRuntime();
-  const [name, setName] = useState<string | null>(null);
-  const [description, setDescription] = useState<string | null>(null);
-  const [properties, setProperties] = useState<DatabaseProperty[]>([]);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<Error | null>(null);
-  const [fetchKey, setFetchKey] = useState(0);
-
-  const refetch = useCallback(() => {
-    setFetchKey((key) => key + 1);
-  }, []);
-
-  useEffect(() => {
-    if (!runtime) {
-      setLoading(false);
-      return;
-    }
-
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-
-    runtime
-      .callTool<GetDatabaseResult>('LOCAL_NOTIS_DATABASE_GET_DATABASE', {
-        database_slug: databaseSlug,
-      })
-      .then((result) => {
-        if (cancelled) return;
-        const message = result.error ?? result.message;
-        if (!result.database && message) {
-          throw new Error(message);
-        }
-        setName(optionalString(result.database?.name));
-        setDescription(optionalString(result.database?.description));
-        const rawProperties = result.database?.schema?.properties ?? [];
-        setProperties(
-          rawProperties
-            .map(normalizeDatabaseProperty)
-            .filter((property): property is DatabaseProperty => Boolean(property)),
-        );
-        setLoading(false);
-      })
-      .catch((err) => {
-        if (cancelled) return;
-        setError(err instanceof Error ? err : new Error(String(err)));
-        setLoading(false);
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, [runtime, databaseSlug, fetchKey]);
-
-  return { name, description, properties, loading, error, refetch };
-}

package/template/packages/sdk/src/hooks/useDocument.ts

@@ -1,78 +0,0 @@
-'use client';
-
-import { useCallback, useEffect, useState } from 'react';
-import { useNotisRuntime } from '../provider';
-import { normalizeDocumentRecord } from '../documents';
-import type { DocumentRecord } from '../runtime';
-
-interface GetDocumentResult {
-  status?: string;
-  document?: unknown;
-  message?: string;
-  error?: string;
-}
-
-export interface UseDocumentOptions {
-  enabled?: boolean;
-}
-
-export interface UseDocumentResult {
-  document: DocumentRecord | null;
-  loading: boolean;
-  error: Error | null;
-  refetch: () => void;
-}
-
-/** Fetch a single document (with content) by id, normalized. */
-export function useDocument(
-  documentId: string | null | undefined,
-  options: UseDocumentOptions = {},
-): UseDocumentResult {
-  const runtime = useNotisRuntime();
-  const [document, setDocument] = useState<DocumentRecord | null>(null);
-  const [loading, setLoading] = useState(Boolean(documentId));
-  const [error, setError] = useState<Error | null>(null);
-  const [fetchKey, setFetchKey] = useState(0);
-
-  const enabled = options.enabled !== false && Boolean(documentId);
-
-  const refetch = useCallback(() => {
-    setFetchKey((key) => key + 1);
-  }, []);
-
-  useEffect(() => {
-    if (!runtime || !enabled || !documentId) {
-      setDocument(null);
-      setLoading(false);
-      return;
-    }
-
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-
-    runtime
-      .callTool<GetDocumentResult>('LOCAL_NOTIS_DATABASE_GET_DOCUMENT', {
-        document_id: documentId,
-      })
-      .then((result) => {
-        if (cancelled) return;
-        if (!result.document) {
-          throw new Error(result.error ?? result.message ?? 'Document not found');
-        }
-        setDocument(normalizeDocumentRecord(result.document));
-        setLoading(false);
-      })
-      .catch((err) => {
-        if (cancelled) return;
-        setError(err instanceof Error ? err : new Error(String(err)));
-        setLoading(false);
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, [runtime, documentId, enabled, fetchKey]);
-
-  return { document, loading, error, refetch };
-}

package/template/packages/sdk/src/hooks/useNotisNavigation.ts

@@ -1,52 +0,0 @@
-'use client';
-
-import { useCallback } from 'react';
-import { useNotisRuntime } from '../provider';
-
-interface NavigationActions {
-  /** Navigate to a route within the app by its path. */
-  toRoute: (path: string, options?: { resourceId?: string | null }) => void;
-  /** Navigate to a document detail view. */
-  toDocument: (documentId: string, title?: string | null) => void;
-  /** Navigate to the app's default route. */
-  toApp: () => void;
-}
-
-/**
- * Navigation helpers for moving between routes and documents within the app.
- * When rendered inside the portal, uses the runtime.navigate() bridge.
- * Without a portal runtime, falls back to window.location for route navigation.
- *
- * ```tsx
- * const nav = useNotisNavigation();
- * nav.toRoute('/settings');
- * ```
- */
-export function useNotisNavigation(): NavigationActions {
-  const runtime = useNotisRuntime();
-
-  const toRoute = useCallback((path: string, options?: { resourceId?: string | null }) => {
-    if (runtime?.navigate) {
-      runtime.navigate({ kind: 'route', path, resourceId: options?.resourceId ?? null });
-    } else if (typeof window !== 'undefined') {
-      const url = new URL(path, window.location.href);
-      if (options?.resourceId) url.searchParams.set('resource', options.resourceId);
-      else url.searchParams.delete('resource');
-      window.location.href = url.toString();
-    }
-  }, [runtime]);
-
-  const toDocument = useCallback((documentId: string, title?: string | null) => {
-    if (runtime?.navigate) {
-      runtime.navigate({ kind: 'document', documentId, title: title ?? undefined });
-    }
-  }, [runtime]);
-
-  const toApp = useCallback(() => {
-    if (runtime?.navigate) {
-      runtime.navigate({ kind: 'app' });
-    }
-  }, [runtime]);
-
-  return { toRoute, toDocument, toApp };
-}

package/template/packages/sdk/src/hooks/useTopBarSearch.ts

@@ -1,73 +0,0 @@
-'use client';
-
-import { useCallback, useEffect } from 'react';
-import { useNotisRuntime } from '../provider';
-
-interface TopBarSearchOptions {
-  /** Current value shown in the top bar search input. */
-  value: string;
-  /** Called when the user types in the top bar. */
-  onChange: (value: string) => void;
-  /** Placeholder text for the input. Defaults to 'Search…'. */
-  placeholder?: string;
-  /** Called when the user presses Enter. May return a Promise. */
-  onSubmit?: () => void | Promise<void>;
-}
-
-interface TopBarSearchActions {
-  /** Toggle the loader that replaces the search icon in the top bar. */
-  setLoading: (loading: boolean) => void;
-}
-
-/**
- * Registers this view's search binding with the portal's top bar search input.
- * While the component is mounted, typing in the top bar calls `onChange`,
- * pressing Enter calls `onSubmit`, and the `value` prop drives the input.
- *
- * Call `setLoading(true)` to show the standard spinner in the top bar while a
- * query is running; `setLoading(false)` restores the search icon.
- *
- * Without a portal runtime, this hook is a safe no-op.
- *
- * ```tsx
- * const [q, setQ] = useState('');
- * const { setLoading } = useTopBarSearch({
- *   value: q,
- *   onChange: setQ,
- *   placeholder: 'Search notes…',
- *   onSubmit: async () => {
- *     setLoading(true);
- *     try { await runSearch(q); } finally { setLoading(false); }
- *   },
- * });
- * ```
- *
- * Stabilize `onChange` and `onSubmit` with `useCallback` to avoid re-registering
- * on every render.
- */
-export function useTopBarSearch(opts: TopBarSearchOptions): TopBarSearchActions {
-  const runtime = useNotisRuntime();
-  const { value, onChange, placeholder, onSubmit } = opts;
-
-  useEffect(() => {
-    const register = runtime?.registerTopBarSearch;
-    if (!register) return;
-    register({ onChange, placeholder, onSubmit });
-    return () => {
-      register(null);
-    };
-  }, [runtime, onChange, placeholder, onSubmit]);
-
-  useEffect(() => {
-    runtime?.setTopBarSearchValue?.(value);
-  }, [runtime, value]);
-
-  const setLoading = useCallback(
-    (loading: boolean) => {
-      runtime?.setTopBarSearchLoading?.(loading);
-    },
-    [runtime],
-  );
-
-  return { setLoading };
-}