@notis_ai/cli 0.2.1 → 0.2.3

package/src/runtime/transport.js

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+import { createReadStream } from 'node:fs';
 import { CliError, EXIT_CODES } from './errors.js';
 import {
   DEFAULT_PROFILE,
@@ -8,31 +9,71 @@ import {
   saveConfig,
 } from './profiles.js';
 
-const META_TOOL_NAMES = new Set([
-  'notis_find_toolkits',
-  'notis_find_tools',
-  'notis_execute_tool',
-  'notis_find_additional_tools',
-]);
-
-function canonicalizeToolName(toolName) {
-  if (typeof toolName !== 'string' || !toolName.length) {
-    return toolName;
-  }
+function escapeMultipartHeaderValue(value) {
+  return String(value ?? '')
+    .replace(/"/g, '%22')
+    .replace(/\r/g, '%0D')
+    .replace(/\n/g, '%0A');
+}
 
-  if (META_TOOL_NAMES.has(toolName) || toolName.startsWith('notis-default-')) {
-    return toolName;
-  }
+function multipartTextPart(boundary, name, value) {
+  return [
+    `--${boundary}`,
+    `Content-Disposition: form-data; name="${escapeMultipartHeaderValue(name)}"`,
+    '',
+    value,
+    '',
+  ].join('\r\n');
+}
 
-  if (toolName.startsWith('notis_')) {
-    return `notis-default-${toolName.slice('notis_'.length)}`;
-  }
+function multipartFileHeader(boundary, binding) {
+  const filename = escapeMultipartHeaderValue(binding.basename || binding.field_name);
+  return [
+    `--${boundary}`,
+    `Content-Disposition: form-data; name="${escapeMultipartHeaderValue(binding.field_name)}"; filename="${filename}"`,
+    `Content-Type: ${binding.contentType || 'application/octet-stream'}`,
+    '',
+    '',
+  ].join('\r\n');
+}
 
-  if (toolName.includes('_notis_')) {
-    return `notis-default-${toolName.replace(/_notis_/g, '_')}`;
+async function* multipartFileBody(boundary, payload, bindingMetadata, fileBindings) {
+  yield Buffer.from(multipartTextPart(boundary, 'payload', JSON.stringify(payload)));
+  yield Buffer.from(multipartTextPart(boundary, 'file_bindings', JSON.stringify(bindingMetadata)));
+  for (const binding of fileBindings) {
+    yield Buffer.from(multipartFileHeader(boundary, binding));
+    for await (const chunk of createReadStream(binding.localPath)) {
+      yield chunk;
+    }
+    yield Buffer.from('\r\n');
   }
+  yield Buffer.from(`--${boundary}--\r\n`);
+}
 
-  return toolName;
+function createMultipartFileUpload(payload, bindingMetadata, fileBindings) {
+  const boundary = `----notis-cli-${randomUUID().replace(/-/g, '')}`;
+  const textParts = [
+    multipartTextPart(boundary, 'payload', JSON.stringify(payload)),
+    multipartTextPart(boundary, 'file_bindings', JSON.stringify(bindingMetadata)),
+  ];
+  const fileHeaderParts = fileBindings.map((binding) => multipartFileHeader(boundary, binding));
+  const closingPart = `--${boundary}--\r\n`;
+  const contentLength = [
+    ...textParts,
+    ...fileHeaderParts,
+    ...fileBindings.map(() => '\r\n'),
+    closingPart,
+  ].reduce((total, part) => total + Buffer.byteLength(part), 0)
+    + fileBindings.reduce((total, binding) => total + binding.size, 0);
+
+  return {
+    body: multipartFileBody(boundary, payload, bindingMetadata, fileBindings),
+    headers: {
+      'Content-Type': `multipart/form-data; boundary=${boundary}`,
+      'Content-Length': String(contentLength),
+    },
+    duplex: 'half',
+  };
 }
 
 function normalizeBackendError(status, payload) {
@@ -51,8 +92,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 || {},
@@ -197,6 +238,7 @@ export async function httpRequest({
   method = 'POST',
   path,
   body,
+  multipart = false,
   requireAuth = true,
 }) {
   await maybeRefreshDevPortalAuth(runtime);
@@ -211,21 +253,41 @@ export async function httpRequest({
   };
 
   const headers = {
-    'Content-Type': 'application/json',
     'X-Notis-CLI-Version': runtime.cliVersion,
     'X-Notis-Request-Id': requestId,
   };
+  if (!multipart) {
+    headers['Content-Type'] = 'application/json';
+  }
 
   if (requireAuth && runtime.jwt) {
     headers.Authorization = `Bearer ${runtime.jwt}`;
   }
 
+  const resolveBody = () => {
+    if (!multipart) {
+      return {
+        body: body ? JSON.stringify(body) : undefined,
+        headers: {},
+      };
+    }
+    if (typeof body === 'function') {
+      return body();
+    }
+    return {
+      body,
+      headers: {},
+    };
+  };
+
   try {
+    let requestBody = resolveBody();
     let response = await fetch(`${runtime.apiBase}${path}`, {
       method,
-      headers,
-      body: body ? JSON.stringify(body) : undefined,
+      headers: { ...headers, ...requestBody.headers },
+      body: requestBody.body,
       signal: controller.signal,
+      ...(requestBody.duplex ? { duplex: requestBody.duplex } : {}),
     });
 
     let payload = null;
@@ -243,11 +305,13 @@ export async function httpRequest({
           headers.Authorization = `Bearer ${runtime.jwt}`;
         }
         resetTimeout();
+        requestBody = resolveBody();
         response = await fetch(`${runtime.apiBase}${path}`, {
           method,
-          headers,
-          body: body ? JSON.stringify(body) : undefined,
+          headers: { ...headers, ...requestBody.headers },
+          body: requestBody.body,
           signal: controller.signal,
+          ...(requestBody.duplex ? { duplex: requestBody.duplex } : {}),
         });
         try {
           payload = await response.json();
@@ -302,22 +366,43 @@ export async function callTool({
   toolName,
   arguments_: argumentsPayload = {},
   idempotencyKey,
+  fileBindings = [],
 }) {
   const requestId = idempotencyKey || (runtime.mutating ? randomUUID() : null);
+  const payload = {
+    tool_name: toolName,
+    arguments: argumentsPayload,
+    idempotency_key: requestId,
+    cli_context: {
+      output_mode: runtime.outputMode,
+      profile: runtime.profileName,
+      cwd: process.cwd(),
+      agent_mode: runtime.agentMode,
+      cli_version: runtime.cliVersion,
+    },
+  };
+
+  if (Array.isArray(fileBindings) && fileBindings.length) {
+    const bindingMetadata = fileBindings.map((binding) => {
+      const {
+        contentType,
+        localPath,
+        ...metadata
+      } = binding;
+      return metadata;
+    });
+
+    return httpRequest({
+      runtime,
+      path: '/cli_tools',
+      body: () => createMultipartFileUpload(payload, bindingMetadata, fileBindings),
+      multipart: true,
+    });
+  }
+
   return httpRequest({
     runtime,
     path: '/cli_tools',
-    body: {
-      tool_name: canonicalizeToolName(toolName),
-      arguments: argumentsPayload,
-      idempotency_key: requestId,
-      cli_context: {
-        output_mode: runtime.outputMode,
-        profile: runtime.profileName,
-        cwd: process.cwd(),
-        agent_mode: runtime.agentMode,
-        cli_version: runtime.cliVersion,
-      },
-    },
+    body: 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>('LOCAL_NOTIS_DATABASE_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',
+    'LOCAL_NOTIS_DATABASE_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]);