@notis_ai/cli 0.2.14 → 0.2.15

package/dist/scaffolds/notis-journal/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/dist/scaffolds/notis-journal/packages/sdk/src/hooks/useDatabaseSubscription.ts

@@ -1,76 +0,0 @@
-'use client';
-
-import { useEffect, useRef, useState } from 'react';
-import { useNotisRuntime } from '../provider';
-import { useDocuments, type UseDocumentsOptions, type UseDocumentsResult } from './useDocuments';
-import type { DocumentRecord } from '../runtime';
-
-export interface UseDatabaseSubscriptionOptions extends UseDocumentsOptions {
-  /** Set to false to keep the query but skip the change feed. */
-  subscribe?: boolean;
-}
-
-export interface UseDatabaseSubscriptionResult extends UseDocumentsResult {
-  /** Alias of `documents`, for views that think in rows. */
-  rows: DocumentRecord[];
-  /** True while a live change feed is attached to this database. */
-  live: boolean;
-}
-
-/**
- * Query a Notis database and keep it fresh without polling.
- *
- * ```tsx
- * const { rows, live, refetch } = useDatabaseSubscription('workspaces');
- * ```
- *
- * A change on the database wakes the hook, which then refetches through the
- * usual `LOCAL_NOTIS_DATABASE_QUERY` path — the change feed is a signal only
- * and never carries row data. Hosts without a change feed (the dev harness,
- * the screenshot stub, the vite preview) still return rows; `live` is false
- * there and the app should keep offering its manual refresh.
- */
-export function useDatabaseSubscription(
-  databaseSlug: string,
-  options: UseDatabaseSubscriptionOptions = {},
-): UseDatabaseSubscriptionResult {
-  const runtime = useNotisRuntime();
-  const { subscribe = true, ...documentOptions } = options;
-  const { documents, loading, error, refetch } = useDocuments(databaseSlug, documentOptions);
-  const [live, setLive] = useState(false);
-
-  const refetchRef = useRef(refetch);
-  useEffect(() => {
-    refetchRef.current = refetch;
-  }, [refetch]);
-
-  const enabled = options.enabled !== false && subscribe;
-
-  useEffect(() => {
-    if (!runtime?.subscribeDatabase || !enabled || !databaseSlug) {
-      setLive(false);
-      return;
-    }
-
-    let cancelled = false;
-    const unsubscribe = runtime.subscribeDatabase(
-      databaseSlug,
-      () => {
-        refetchRef.current();
-      },
-      {
-        onStatusChange: (isLive) => {
-          if (!cancelled) setLive(isLive);
-        },
-      },
-    );
-
-    return () => {
-      cancelled = true;
-      setLive(false);
-      unsubscribe?.();
-    };
-  }, [runtime, databaseSlug, enabled]);
-
-  return { documents, rows: documents, loading, error, refetch, live };
-}

package/dist/scaffolds/notis-journal/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/dist/scaffolds/notis-journal/packages/sdk/src/hooks/useDocuments.ts

@@ -1,121 +0,0 @@
-'use client';
-
-import { useCallback, useEffect, useState } from 'react';
-import { useNotisRuntime } from '../provider';
-import { normalizeDocumentRecord } from '../documents';
-import type { DocumentRecord, QueryFilter } from '../runtime';
-
-interface QueryDatabaseResult {
-  documents?: unknown[];
-  has_more?: boolean;
-  next_offset?: number | null;
-  message?: string;
-  error?: string;
-}
-
-export interface UseDocumentsOptions {
-  filter?: QueryFilter;
-  pageSize?: number;
-  offset?: number;
-  /** Fetch every page, starting at offset, instead of returning only one page. */
-  fetchAll?: boolean;
-  enabled?: boolean;
-}
-
-export interface UseDocumentsResult {
-  documents: DocumentRecord[];
-  loading: boolean;
-  error: Error | null;
-  refetch: () => void;
-}
-
-/**
- * Query a Notis database and get normalized `DocumentRecord`s.
- *
- * ```tsx
- * const { documents, loading, refetch } = useDocuments('notes', {
- *   filter: { filters: [{ property: 'Folder', operator: 'contains', type: 'relation', value: folderId }] },
- *   pageSize: 250,
- * });
- * ```
- */
-export function useDocuments(
-  databaseSlug: string,
-  options: UseDocumentsOptions = {},
-): UseDocumentsResult {
-  const runtime = useNotisRuntime();
-  const [documents, setDocuments] = useState<DocumentRecord[]>([]);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<Error | null>(null);
-  const [fetchKey, setFetchKey] = useState(0);
-
-  const enabled = options.enabled !== false;
-  const filterKey = JSON.stringify(options.filter ?? null);
-
-  const refetch = useCallback(() => {
-    setFetchKey((key) => key + 1);
-  }, []);
-
-  useEffect(() => {
-    if (!runtime || !enabled) {
-      setLoading(false);
-      return;
-    }
-
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-
-    const filter = filterKey === 'null' ? null : (JSON.parse(filterKey) as QueryFilter);
-
-    const fetchDocuments = async (): Promise<unknown[]> => {
-      const allDocuments: unknown[] = [];
-      let offset = options.offset ?? 0;
-
-      while (true) {
-        const result = await runtime.callTool<QueryDatabaseResult>('LOCAL_NOTIS_DATABASE_QUERY', {
-          database_slug: databaseSlug,
-          query: {
-            ...(filter ?? {}),
-            ...(options.pageSize !== undefined ? { page_size: options.pageSize } : {}),
-          },
-          ...(offset > 0 ? { offset } : {}),
-        });
-        const message = result.error ?? result.message;
-        if (!result.documents && message) {
-          throw new Error(message);
-        }
-        allDocuments.push(...(result.documents ?? []));
-        if (!options.fetchAll || !result.has_more) return allDocuments;
-
-        const nextOffset = result.next_offset;
-        if (typeof nextOffset !== 'number' || nextOffset <= offset) {
-          throw new Error('Database query returned an invalid pagination offset');
-        }
-        offset = nextOffset;
-      }
-    };
-
-    fetchDocuments()
-      .then((result) => {
-        if (cancelled) return;
-        setDocuments(
-          result
-            .map(normalizeDocumentRecord)
-            .filter((document) => document.id),
-        );
-        setLoading(false);
-      })
-      .catch((err) => {
-        if (cancelled) return;
-        setError(err instanceof Error ? err : new Error(String(err)));
-        setLoading(false);
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, [runtime, databaseSlug, enabled, fetchKey, filterKey, options.fetchAll, options.offset, options.pageSize]);
-
-  return { documents, loading, error, refetch };
-}

package/dist/scaffolds/notis-journal/packages/sdk/src/hooks/useHandover.ts

@@ -1,75 +0,0 @@
-'use client';
-
-import { useCallback, useState } from 'react';
-import { useNotisRuntime } from '../provider';
-import type { HandoverPayload, HandoverResult } from '../runtime';
-
-export interface UseHandoverResult {
-  /** Hand the work over. Rejects when the host has no manager chat. */
-  handover: (payload: HandoverPayload) => Promise<HandoverResult>;
-  /** True while the manager chat is being prepared. */
-  pending: boolean;
-  error: Error | null;
-  /**
-   * False when the host cannot hand work over (dev harness, vite preview).
-   * Render the app's own fallback — a copyable prompt, say — when it is false.
-   */
-  available: boolean;
-}
-
-/**
- * Hand a piece of work from app code to the Notis manager chat.
- *
- * An app displays work; the manager runs it. `handover` puts the message in
- * the chat surface that already owns streaming progress, billing, cancellation
- * and the transcript, and the app watches its own databases for the result.
- *
- * ```tsx
- * const { handover, pending, available } = useHandover();
- *
- * return available ? (
- *   <Button
- *     disabled={pending}
- *     onClick={() => { void handover({ prompt: 'Create a workspace on notis to ...' }); }}
- *   >
- *     Send to Notis
- *   </Button>
- * ) : (
- *   <CopyablePrompt prompt="Create a workspace on notis to ..." />
- * );
- * ```
- *
- * Pass `skill` to bind the work to a skill declared in `notis.config.ts`; the
- * host rejects a key the app does not declare. `autoSend` is accepted for
- * forward compatibility; today's hosts always return `drafted` and let the
- * user press send.
- */
-export function useHandover(): UseHandoverResult {
-  const runtime = useNotisRuntime();
-  const [pending, setPending] = useState(false);
-  const [error, setError] = useState<Error | null>(null);
-
-  const handover = useCallback(
-    async (payload: HandoverPayload): Promise<HandoverResult> => {
-      if (!runtime?.handover) {
-        throw new Error('This Notis host cannot hand work to the manager chat.');
-      }
-
-      setPending(true);
-      setError(null);
-
-      try {
-        return await runtime.handover(payload);
-      } catch (err) {
-        const e = err instanceof Error ? err : new Error(String(err));
-        setError(e);
-        throw e;
-      } finally {
-        setPending(false);
-      }
-    },
-    [runtime],
-  );
-
-  return { handover, pending, error, available: Boolean(runtime?.handover) };
-}