@notis_ai/cli 0.2.0-beta.32.1 → 0.2.0-beta.35.1

package/src/runtime/transport.js

@@ -51,8 +51,8 @@ function normalizeBackendError(status, payload) {
       exitCode: EXIT_CODES.auth,
       hints: [
         {
-          command: 'notis auth login --jwt <token>',
-          reason: 'Refresh the stored JWT for this profile',
+          command: 'Open the Notis desktop app and sign in',
+          reason: 'Open the Notis desktop app to refresh CLI auth, or set NOTIS_JWT',
         },
       ],
       details: payload || {},

package/template/.harness/index.html.tmpl

@@ -107,8 +107,7 @@
       return {
         app: descriptor.app,
         route: descriptor.route,
-        databases: descriptor.databases || [],
-        context: descriptor.context || { collectionItem: null },
+        context: descriptor.context || {},
         navigate: (args) => record('navigate', args),
         registerTopBarSearch: () => {},
         setTopBarSearchValue: () => {},
@@ -121,34 +120,6 @@
           record('callTool', { name, arguments: args || {} });
           return { ok: true, result: null };
         },
-        queryDatabase: async (args) => {
-          record('queryDatabase', args || {});
-          return { documents: [], next_offset: null };
-        },
-        getDocument: async (args) => {
-          record('getDocument', args || {});
-          return null;
-        },
-        upsertDocument: async (args) => {
-          record('upsertDocument', args || {});
-          return {
-            status: 'ok',
-            document: {
-              id: (args && args.documentId) || 'mock-doc',
-              title: (args && args.title) || '',
-              properties: (args && args.properties) || {},
-              databaseSlug: args && args.databaseSlug,
-            },
-          };
-        },
-        listCollectionItems: async (args) => {
-          record('listCollectionItems', args || {});
-          return { items: [] };
-        },
-        listCollectionTree: async (args) => {
-          record('listCollectionTree', args || {});
-          return { items: [] };
-        },
         request: async (path, options) => {
           record('request', { path, options });
           return null;
@@ -168,26 +139,6 @@
           record('callTool', { name, arguments: args || {} });
           return runtimeQuery({ method: 'tools/call', name, arguments: args || {} });
         },
-        queryDatabase: async (args) => {
-          record('queryDatabase', args || {});
-          const result = await runtimeQuery({ method: 'tools/call', name: 'notis_query_database', arguments: args || {} });
-          return result.result || result;
-        },
-        getDocument: async (args) => {
-          record('getDocument', args || {});
-          const result = await runtimeQuery({ method: 'tools/call', name: 'notis_get_document', arguments: args || {} });
-          return result.result || result;
-        },
-        upsertDocument: async (args) => {
-          record('upsertDocument', args || {});
-          const result = await runtimeQuery({ method: 'tools/call', name: 'notis_upsert_document', arguments: args || {} });
-          return result.result || result;
-        },
-        listCollectionItems: async (args) => {
-          record('listCollectionItems', args || {});
-          const result = await runtimeQuery({ method: 'tools/call', name: 'notis_list_collection_items', arguments: args || {} });
-          return result.result || result;
-        },
         request: async (path, options) => {
           record('request', { path, options });
           const response = await fetch(`${String(apiBase).replace(/\/$/, '')}${path}`, {

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}/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/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/sdk/src/hooks/useNotis.ts

@@ -0,0 +1,30 @@
+'use client';
+
+import { useNotisRuntime } from '../provider';
+import type { AppDescriptor, NotisRuntimeContext, RouteDescriptor } from '../runtime';
+
+interface NotisContext {
+  /** App metadata (id, name, icon, description). Null before runtime loads. */
+  app: AppDescriptor | null;
+  /** Current route descriptor. Null before runtime loads. */
+  route: RouteDescriptor | null;
+  /** Generic route/app context supplied by the portal. */
+  context: NotisRuntimeContext;
+  /** Whether the runtime is loaded and available. */
+  ready: boolean;
+}
+
+/**
+ * Access app-level metadata, the current route, and generic portal context.
+ * Returns safe defaults when the portal runtime is not available.
+ */
+export function useNotis(): NotisContext {
+  const runtime = useNotisRuntime();
+
+  return {
+    app: runtime?.app ?? null,
+    route: runtime?.route ?? null,
+    context: runtime?.context ?? {},
+    ready: runtime !== null,
+  };
+}

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/index.ts

@@ -7,20 +7,16 @@
  */
 
 // Provider
-export { NotisProvider, useNotisRuntime } from './provider';
+export { NotisProvider } 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,29 +35,12 @@ 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,
-  CollectionItem,
-  CollectionItemDetail,
-  DatabaseDescriptor,
-  DatabaseProperty,
-  DocumentRecord,
   NotisRuntime,
   NotisRuntimeContext,
-  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/sdk/src/runtime.ts

@@ -0,0 +1,80 @@
+/**
+ * NotisRuntime is the bridge between app code running in the browser and the
+ * Notis platform. The portal owns the runtime and injects it through
+ * `NotisProvider` when the app is rendered.
+ *
+ * App code should never reach for globals. Use the hooks from `@notis/sdk`
+ * (useTool, useNotis, etc.) which read from the NotisProvider context.
+ */
+
+// ---------------------------------------------------------------------------
+// Tool types
+// ---------------------------------------------------------------------------
+
+export type ToolInputSchema = Record<string, unknown>;
+
+export interface ToolDescriptor {
+  name: string;
+  description?: string;
+  inputSchema?: ToolInputSchema;
+}
+
+// ---------------------------------------------------------------------------
+// Route types
+// ---------------------------------------------------------------------------
+
+export interface RouteDescriptor {
+  slug: string;
+  path: string;
+  name: string;
+  icon?: string | null;
+  parentSlug?: string | null;
+  default?: boolean;
+  collection?: Record<string, unknown> | null;
+}
+
+// ---------------------------------------------------------------------------
+// App descriptor
+// ---------------------------------------------------------------------------
+
+export interface AppDescriptor {
+  id: string;
+  name: string;
+  icon?: string | null;
+  description?: string | null;
+}
+
+export type NotisRuntimeContext = Record<string, unknown>;
+
+// ---------------------------------------------------------------------------
+// NotisRuntime
+// ---------------------------------------------------------------------------
+
+export interface NotisRuntime {
+  app: AppDescriptor;
+  route: RouteDescriptor;
+  context: NotisRuntimeContext;
+
+  navigate?: (payload: { kind: string; [key: string]: unknown }) => void;
+
+  registerTopBarSearch?: (
+    config:
+      | {
+          onChange: (value: string) => void;
+          placeholder?: string;
+          onSubmit?: () => void | Promise<void>;
+        }
+      | null,
+  ) => void;
+  setTopBarSearchValue?: (value: string) => void;
+  setTopBarSearchLoading?: (loading: boolean) => void;
+
+  listTools(): Promise<ToolDescriptor[]>;
+  callTool<TResult = unknown>(name: string, args?: Record<string, unknown>): Promise<TResult>;
+
+  request(path: string, options?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+  }): Promise<unknown>;
+}