@notis_ai/cli 0.2.1 → 0.2.2

package/template/app/page.tsx

@@ -1,12 +1,47 @@
 'use client';
 
-import { useNotis, useDatabase } from '@notis/sdk';
+import { useEffect, useState } from 'react';
+import { useNotis, useTool } from '@notis/sdk';
 import { Badge } from '@/components/ui/badge';
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
 
+type ItemDocument = {
+  id?: string;
+  document_id?: string;
+  title?: string;
+  properties?: Record<string, unknown>;
+};
+
+type QueryItemsArgs = {
+  database_slug: string;
+  query: {
+    page_size?: number;
+  };
+};
+
+type QueryItemsResult = {
+  documents?: ItemDocument[];
+};
+
 export default function HomePage() {
   const { app, ready } = useNotis();
-  const { documents, loading } = useDatabase('items');
+  const queryItems = useTool<QueryItemsArgs, QueryItemsResult>('notis-default-query');
+  const [documents, setDocuments] = useState<ItemDocument[]>([]);
+
+  useEffect(() => {
+    let cancelled = false;
+    queryItems
+      .call({ database_slug: 'items', query: { page_size: 25 } })
+      .then((result) => {
+        if (!cancelled) setDocuments(result.documents || []);
+      })
+      .catch(() => {
+        if (!cancelled) setDocuments([]);
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [queryItems.call]);
 
   return (
     <main className="notis-app-shell space-y-6">
@@ -28,7 +63,7 @@ export default function HomePage() {
           <CardDescription>Use shadcn surfaces and portal tokens so the app feels native inside Notis.</CardDescription>
         </CardHeader>
         <CardContent>
-          {loading ? (
+          {queryItems.loading ? (
             <p className="text-sm text-muted-foreground">Loading...</p>
           ) : documents.length === 0 ? (
             <div className="rounded-xl border border-dashed border-border px-4 py-10 text-center text-sm text-muted-foreground">
@@ -37,10 +72,10 @@ export default function HomePage() {
           ) : (
             <div className="space-y-3">
               {documents.map((doc) => (
-                <div key={doc.id} className="rounded-xl border border-border bg-background px-4 py-3">
+                <div key={doc.id || doc.document_id || doc.title} className="rounded-xl border border-border bg-background px-4 py-3">
                   <div className="flex items-center justify-between gap-3">
-                    <p className="font-medium">{doc.title}</p>
-                    {doc.properties.status ? (
+                    <p className="font-medium">{doc.title || 'Untitled'}</p>
+                    {doc.properties?.status ? (
                       <Badge variant="outline">{String(doc.properties.status)}</Badge>
                     ) : null}
                   </div>

package/template/notis.config.ts

@@ -1,14 +1,19 @@
 import { defineNotisApp } from '@notis/sdk/config';
 
 export default defineNotisApp({
-  name: 'My Notis App',
-  description: 'A new Notis app',
-  icon: 'lucide:layout-dashboard',
+  name: 'my-notis-app',
+  title: 'My Notis App',
+  description: 'A focused Notis app with one route and one database-backed workflow.',
+  icon: 'phosphor:squares-four',
+  author: { name: 'Notis User' },
+  categories: ['Productivity'],
+  tagline: 'A clean starting point for a focused workflow.',
+  versionNotes: 'Initial release.',
 
   databases: ['items'],
 
   routes: [
-    { path: '/', slug: 'home', name: 'Home', icon: 'lucide:home', default: true },
+    { path: '/', slug: 'home', name: 'Home', icon: 'phosphor:house', default: true },
     // Example collection tree route:
     // {
     //   path: '/notes',
@@ -27,7 +32,6 @@ export default defineNotisApp({
   ],
 
   tools: [
-    'notis_query_database',
-    'notis_upsert_document',
+    'notis-default-query',
   ],
 });

package/template/package.json

@@ -8,11 +8,11 @@
     "build": "vite build"
   },
   "dependencies": {
-    "@notis/sdk": "file:./packages/notis-sdk",
+    "@notis/sdk": "file:./packages/sdk",
+    "@phosphor-icons/react": "^2.1.10",
     "@radix-ui/react-slot": "^1.1.0",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.1.1",
-    "lucide-react": "^0.474.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tailwind-merge": "^2.6.0",

package/template/packages/{notis-sdk → sdk}/package.json

@@ -14,6 +14,9 @@
     "src",
     "template"
   ],
+  "scripts": {
+    "type-check": "tsc --noEmit"
+  },
   "peerDependencies": {
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
@@ -21,6 +24,9 @@
     "@vitejs/plugin-react": ">=4.0.0"
   },
   "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
     "typescript": "^5.0.0"
   }
 }

package/template/packages/{notis-sdk → sdk}/src/components/MultiSelectActionBar.tsx

@@ -6,6 +6,7 @@ import {
   useRef,
   useState,
   type CSSProperties,
+  type ReactElement,
   type ReactNode,
 } from 'react';
 
@@ -174,7 +175,7 @@ export function MultiSelectActionBar({
   itemLabel,
   className,
   style,
-}: MultiSelectActionBarProps): JSX.Element | null {
+}: MultiSelectActionBarProps): ReactElement | null {
   const actionsRef = useRef(actions);
   actionsRef.current = actions;
 

package/template/packages/{notis-sdk → sdk}/src/components/MultiSelectCheckbox.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { type CSSProperties, type MouseEvent as ReactMouseEvent } from 'react';
+import { type CSSProperties, type MouseEvent as ReactMouseEvent, type ReactElement } from 'react';
 
 export interface MultiSelectCheckboxProps {
   isSelected: boolean;
@@ -44,7 +44,7 @@ export function MultiSelectCheckbox({
   ariaLabel,
   className,
   style,
-}: MultiSelectCheckboxProps): JSX.Element {
+}: MultiSelectCheckboxProps): ReactElement {
   const merged: CSSProperties = {
     ...baseStyle,
     ...(isSelected ? selectedStyle : null),

package/template/packages/{notis-sdk → sdk}/src/components/MultiSelectDragOverlay.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { type CSSProperties } from 'react';
+import { type CSSProperties, type ReactElement } from 'react';
 import type { DragRect } from '../hooks/useMultiSelect';
 
 export interface MultiSelectDragOverlayProps {
@@ -22,7 +22,7 @@ export function MultiSelectDragOverlay({
   rect,
   className,
   style,
-}: MultiSelectDragOverlayProps): JSX.Element | null {
+}: MultiSelectDragOverlayProps): ReactElement | null {
   if (!rect) return null;
   if (rect.width === 0 && rect.height === 0) return null;
 

package/template/packages/{notis-sdk → sdk}/src/config.ts

@@ -9,7 +9,7 @@
  * export default defineNotisApp({
  *   name: 'My App',
  *   description: 'Does things',
- *   icon: 'lucide:layout-dashboard',
+ *   icon: 'phosphor:squares-four',
  *   databases: ['tasks'],
  *   routes: [
  *     {

package/template/packages/{notis-sdk → sdk}/src/hooks/useDatabase.ts

@@ -8,7 +8,6 @@ interface UseDatabaseOptions {
   filter?: QueryFilter;
   pageSize?: number;
   offset?: number;
-  /** Set to false to skip the initial fetch. */
   enabled?: boolean;
 }
 
@@ -19,16 +18,6 @@ interface UseDatabaseResult {
   refetch: () => void;
 }
 
-/**
- * Query documents from a Notis database owned by this app.
- *
- * ```tsx
- * const { documents, loading } = useDatabase('transactions', {
- *   filter: { sorts: [{ property: 'date', direction: 'desc' }] },
- *   pageSize: 20,
- * });
- * ```
- */
 export function useDatabase(
   databaseSlug: string,
   options: UseDatabaseOptions = {},
@@ -43,7 +32,7 @@ export function useDatabase(
   const filterKey = JSON.stringify(options.filter ?? null);
 
   const refetch = useCallback(() => {
-    setFetchKey((k) => k + 1);
+    setFetchKey((key) => key + 1);
   }, []);
 
   useEffect(() => {
@@ -81,7 +70,6 @@ export function useDatabase(
     return () => {
       cancelled = true;
     };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [runtime, databaseSlug, fetchKey, enabled, filterKey, options.offset, options.pageSize]);
 
   return { documents, loading, error, refetch };

package/template/packages/{notis-sdk → sdk}/src/hooks/useMultiSelect.ts

@@ -149,7 +149,7 @@ export function useMultiSelect<T>(opts: UseMultiSelectOptions<T>): MultiSelectCo
 
   const select = useCallback((ids: string[]) => {
     setSelectedIds(new Set(ids));
-    setLastClickedId(ids.length > 0 ? ids[ids.length - 1] : null);
+    setLastClickedId(ids.length > 0 ? ids[ids.length - 1] ?? null : null);
   }, []);
 
   const clear = useCallback(() => {
@@ -159,7 +159,7 @@ export function useMultiSelect<T>(opts: UseMultiSelectOptions<T>): MultiSelectCo
   const selectAll = useCallback(() => {
     const all = orderedIdsRef.current;
     setSelectedIds(new Set(all));
-    setLastClickedId(all.length > 0 ? all[all.length - 1] : null);
+    setLastClickedId(all.length > 0 ? all[all.length - 1] ?? null : null);
   }, []);
 
   const selectRange = useCallback((anchorId: string, targetId: string) => {
@@ -346,7 +346,7 @@ export function useMultiSelect<T>(opts: UseMultiSelectOptions<T>): MultiSelectCo
         bottom: rect.top + rect.height,
       });
       setSelectedIds(new Set(ids));
-      setLastClickedId(ids.length > 0 ? ids[ids.length - 1] : null);
+      setLastClickedId(ids.length > 0 ? ids[ids.length - 1] ?? null : null);
     };
 
     const handleMouseUp = () => {
@@ -447,6 +447,7 @@ export function useMultiSelect<T>(opts: UseMultiSelectOptions<T>): MultiSelectCo
             : Math.min(all.length - 1, Math.max(0, currentIdx + direction));
         if (newIdx === currentIdx) return;
         const newHead = all[newIdx];
+        if (!newHead) return;
         const anchorId = lastClickedIdRef.current ?? currentHead ?? newHead;
         const anchorIdx = all.indexOf(anchorId);
         if (anchorIdx === -1) {

package/template/packages/{notis-sdk → sdk}/src/hooks/useNotis.ts

@@ -1,7 +1,7 @@
 'use client';
 
 import { useNotisRuntime } from '../provider';
-import type { AppDescriptor, RouteDescriptor, DatabaseDescriptor, CollectionItemDetail } from '../runtime';
+import type { AppDescriptor, CollectionItemDetail, DatabaseDescriptor, RouteDescriptor } from '../runtime';
 
 interface NotisContext {
   /** App metadata (id, name, icon, description). Null before runtime loads. */
@@ -17,8 +17,9 @@ interface NotisContext {
 }
 
 /**
- * Access app-level metadata: the app descriptor, current route, and declared
- * databases. Returns safe defaults when the portal runtime is not available.
+ * Access app-level metadata, the current route, declared databases, and the
+ * selected collection item. Returns safe defaults when the portal runtime is
+ * not available.
  */
 export function useNotis(): NotisContext {
   const runtime = useNotisRuntime();

package/template/packages/{notis-sdk → sdk}/src/hooks/useNotisNavigation.ts

@@ -7,7 +7,7 @@ interface NavigationActions {
   /** Navigate to a route within the app by its path. */
   toRoute: (path: string) => void;
   /** Navigate to a document detail view. */
-  toDocument: (documentId: string) => void;
+  toDocument: (documentId: string, title?: string | null) => void;
   /** Navigate to the app's default route. */
   toApp: () => void;
 }
@@ -33,9 +33,9 @@ export function useNotisNavigation(): NavigationActions {
     }
   }, [runtime]);
 
-  const toDocument = useCallback((documentId: string) => {
+  const toDocument = useCallback((documentId: string, title?: string | null) => {
     if (runtime?.navigate) {
-      runtime.navigate({ kind: 'document', documentId });
+      runtime.navigate({ kind: 'document', documentId, title: title ?? undefined });
     }
   }, [runtime]);
 

package/template/packages/{notis-sdk → sdk}/src/hooks/useTool.ts

@@ -3,27 +3,42 @@
 import { useCallback, useState } from 'react';
 import { useNotisRuntime } from '../provider';
 
-interface UseToolResult {
-  call: (args?: Record<string, unknown>) => Promise<unknown>;
+type ToolArguments = Record<string, unknown>;
+
+type ToolCall<TArgs extends ToolArguments | undefined, TResult> = undefined extends TArgs
+  ? (args?: Exclude<TArgs, undefined>) => Promise<TResult>
+  : (args: TArgs) => Promise<TResult>;
+
+export interface ToolCallState {
   loading: boolean;
   error: Error | null;
 }
 
+export interface UseToolResult<
+  TArgs extends ToolArguments | undefined = ToolArguments | undefined,
+  TResult = unknown,
+> extends ToolCallState {
+  call: ToolCall<TArgs, TResult>;
+}
+
 /**
  * Call a specific Notis tool by name.
  *
  * ```tsx
- * const { call, loading } = useTool('notis_web_search');
+ * const { call, loading } = useTool('notis-default-web_search');
  * const result = await call({ query: 'latest news' });
  * ```
  */
-export function useTool(toolName: string): UseToolResult {
+export function useTool<
+  TArgs extends ToolArguments | undefined = ToolArguments | undefined,
+  TResult = unknown,
+>(toolName: string): UseToolResult<TArgs, TResult> {
   const runtime = useNotisRuntime();
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<Error | null>(null);
 
   const call = useCallback(
-    async (args?: Record<string, unknown>): Promise<unknown> => {
+    async (args?: ToolArguments): Promise<TResult> => {
       if (!runtime) {
         throw new Error('Notis runtime not available. Ensure NotisProvider is mounted.');
       }
@@ -32,7 +47,7 @@ export function useTool(toolName: string): UseToolResult {
       setError(null);
 
       try {
-        const result = await runtime.callTool(toolName, args);
+        const result = await runtime.callTool<TResult>(toolName, args);
         return result;
       } catch (err) {
         const e = err instanceof Error ? err : new Error(String(err));
@@ -43,7 +58,7 @@ export function useTool(toolName: string): UseToolResult {
       }
     },
     [runtime, toolName],
-  );
+  ) as ToolCall<TArgs, TResult>;
 
   return { call, loading, error };
 }

package/template/packages/{notis-sdk → sdk}/src/hooks/useUpsertDocument.ts

@@ -18,14 +18,6 @@ interface UseUpsertDocumentResult {
   error: Error | null;
 }
 
-/**
- * Create or update a document in a Notis database.
- *
- * ```tsx
- * const { upsert, loading } = useUpsertDocument();
- * await upsert({ databaseSlug: 'tasks', title: 'New task', properties: { status: 'Open' } });
- * ```
- */
 export function useUpsertDocument(): UseUpsertDocumentResult {
   const runtime = useNotisRuntime();
   const [loading, setLoading] = useState(false);

package/template/packages/{notis-sdk → sdk}/src/index.ts

@@ -12,15 +12,13 @@ export { NotisProvider, useNotisRuntime } from './provider';
 // Hooks
 export { useNotis } from './hooks/useNotis';
 export { useDatabase } from './hooks/useDatabase';
-export { useDocument } from './hooks/useDocument';
 export { useUpsertDocument } from './hooks/useUpsertDocument';
 export { useTool } from './hooks/useTool';
+export type { ToolCallState, UseToolResult } from './hooks/useTool';
 export { useTools } from './hooks/useTools';
-export { useCollectionItems } from './hooks/useCollectionItem';
 export { useNotisNavigation } from './hooks/useNotisNavigation';
 export { useTopBarSearch } from './hooks/useTopBarSearch';
 export { useBackend } from './hooks/useBackend';
-export { useAppState } from './hooks/useAppState';
 export { useMultiSelect } from './hooks/useMultiSelect';
 
 // Multi-select components
@@ -39,18 +37,6 @@ export type {
 export type { MultiSelectCheckboxProps } from './components/MultiSelectCheckbox';
 export type { MultiSelectDragOverlayProps } from './components/MultiSelectDragOverlay';
 
-// Property extraction helpers
-export {
-  extractText,
-  extractSelect,
-  extractDate,
-  extractNumber,
-  extractCheckbox,
-  extractMultiSelect,
-  extractRelation,
-  docTitle,
-} from './helpers';
-
 // Types (re-exported for convenience)
 export type {
   AppDescriptor,
@@ -64,4 +50,5 @@ export type {
   QueryFilter,
   RouteDescriptor,
   ToolDescriptor,
+  ToolInputSchema,
 } from './runtime';

package/template/packages/{notis-sdk → sdk}/src/provider.tsx

@@ -36,7 +36,7 @@ export function NotisProvider({ children, runtime }: { children: ReactNode; runt
 
 /**
  * Returns the raw NotisRuntime or null if not yet available.
- * Prefer the typed hooks (useDatabase, useTool, etc.) over this.
+ * Prefer the typed hooks (useTool, useNotis, etc.) over this.
  */
 export function useNotisRuntime(): NotisRuntime | null {
   return useContext(NotisContext);

package/template/packages/{notis-sdk → sdk}/src/runtime.ts

@@ -4,7 +4,7 @@
  * `NotisProvider` when the app is rendered.
  *
  * App code should never reach for globals. Use the hooks from `@notis/sdk`
- * (useDatabase, useTool, etc.) which read from the NotisProvider context.
+ * (useTool, useNotis, etc.) which read from the NotisProvider context.
  */
 
 // ---------------------------------------------------------------------------
@@ -44,10 +44,12 @@ export interface DocumentRecord {
 // Tool types
 // ---------------------------------------------------------------------------
 
+export type ToolInputSchema = Record<string, unknown>;
+
 export interface ToolDescriptor {
   name: string;
   description?: string;
-  input_schema?: Record<string, unknown>;
+  inputSchema?: ToolInputSchema;
 }
 
 // ---------------------------------------------------------------------------
@@ -82,11 +84,6 @@ export interface CollectionItemDetail extends CollectionItem {
   properties: Record<string, unknown>;
 }
 
-export interface CollectionTreeItem extends CollectionItem {
-  parent_id: string | null;
-  has_children: boolean;
-}
-
 // ---------------------------------------------------------------------------
 // App descriptor
 // ---------------------------------------------------------------------------
@@ -98,10 +95,6 @@ export interface AppDescriptor {
   description?: string | null;
 }
 
-// ---------------------------------------------------------------------------
-// Query types
-// ---------------------------------------------------------------------------
-
 export interface QueryFilter {
   filters?: Array<{
     property: string;
@@ -144,7 +137,7 @@ export interface NotisRuntime {
   setTopBarSearchLoading?: (loading: boolean) => void;
 
   listTools(): Promise<ToolDescriptor[]>;
-  callTool(name: string, args?: Record<string, unknown>): Promise<unknown>;
+  callTool<TResult = unknown>(name: string, args?: Record<string, unknown>): Promise<TResult>;
 
   queryDatabase(args: {
     databaseSlug: string;
@@ -152,10 +145,6 @@ export interface NotisRuntime {
     offset?: number;
   }): Promise<{ documents: DocumentRecord[] }>;
 
-  getDocument(args: {
-    documentId: string;
-  }): Promise<DocumentRecord>;
-
   upsertDocument(args: {
     databaseSlug: string;
     documentId?: string;
@@ -164,16 +153,6 @@ export interface NotisRuntime {
     contentBlocknote?: Array<Record<string, unknown>> | null;
   }): Promise<{ status: string; document: DocumentRecord }>;
 
-  listCollectionItems(args?: {
-    databaseSlug?: string;
-    pageSize?: number;
-  }): Promise<{ items: CollectionItem[] }>;
-
-  listCollectionTree?(args?: {
-    databaseSlug?: string;
-    pageSize?: number;
-  }): Promise<{ items: CollectionTreeItem[] }>;
-
   request(path: string, options?: {
     method?: string;
     headers?: Record<string, string>;