@notis_ai/cli 0.2.0-beta.16.1

package/src/runtime/profiles.js

@@ -0,0 +1,202 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { CliError, EXIT_CODES } from './errors.js';
+
+export const CONFIG_DIR = join(homedir(), '.notis');
+export const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+export const WORKSPACE_DIR = join(CONFIG_DIR, 'workspace');
+export const DEFAULT_API_BASE = 'https://api.notis.ai';
+export const DEFAULT_PROFILE = 'default';
+const LOCAL_DEFAULT_API_BASES = new Set([
+  'http://localhost:3001',
+  'http://127.0.0.1:3001',
+]);
+
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+export function normalizeConfig(rawConfig = {}) {
+  const raw = rawConfig && typeof rawConfig === 'object' ? clone(rawConfig) : {};
+
+  if (raw.profiles && typeof raw.profiles === 'object') {
+    const profiles = {};
+    for (const [name, profile] of Object.entries(raw.profiles)) {
+      if (!profile || typeof profile !== 'object') {
+        continue;
+      }
+      profiles[name] = {
+        jwt: typeof profile.jwt === 'string' ? profile.jwt : undefined,
+        api_base: typeof profile.api_base === 'string' ? profile.api_base : undefined,
+      };
+    }
+
+    if (!profiles[DEFAULT_PROFILE]) {
+      profiles[DEFAULT_PROFILE] = {};
+    }
+
+    return {
+      current_profile:
+        typeof raw.current_profile === 'string' && raw.current_profile in profiles
+          ? raw.current_profile
+          : DEFAULT_PROFILE,
+      profiles,
+    };
+  }
+
+  return {
+    current_profile: DEFAULT_PROFILE,
+    profiles: {
+      [DEFAULT_PROFILE]: {
+        jwt: typeof raw.jwt === 'string' ? raw.jwt : undefined,
+        api_base: typeof raw.api_base === 'string' ? raw.api_base : undefined,
+      },
+    },
+  };
+}
+
+export function loadConfig() {
+  if (!existsSync(CONFIG_FILE)) {
+    return normalizeConfig({});
+  }
+
+  return normalizeConfig(JSON.parse(readFileSync(CONFIG_FILE, 'utf-8')));
+}
+
+export function saveConfig(config) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(normalizeConfig(config), null, 2));
+}
+
+export function getProfile(config, profileName) {
+  const normalized = normalizeConfig(config);
+  return normalized.profiles[profileName] || {};
+}
+
+export function getCurrentProfileName(config, preferredName) {
+  const normalized = normalizeConfig(config);
+  if (preferredName && normalized.profiles[preferredName]) {
+    return preferredName;
+  }
+  return normalized.current_profile || DEFAULT_PROFILE;
+}
+
+export function ensureProfile(config, profileName) {
+  const normalized = normalizeConfig(config);
+  if (!normalized.profiles[profileName]) {
+    normalized.profiles[profileName] = {};
+  }
+  return normalized;
+}
+
+export function getApiBase(config, profileName, override) {
+  if (override) {
+    return override;
+  }
+  const env = process.env.NOTIS_API_BASE;
+  if (env) {
+    return env;
+  }
+  const profile = getProfile(config, profileName);
+  const profileApiBase = profile.api_base;
+  const conductorPort = Number.parseInt(process.env.CONDUCTOR_PORT || '', 10);
+
+  // Conductor assigns dynamic local ports. When a workspace is running under
+  // Conductor, treat the legacy localhost:3001 profile value as stale and
+  // transparently retarget the CLI at the active backend port.
+  if (
+    Number.isInteger(conductorPort) &&
+    conductorPort > 0 &&
+    (!profileApiBase || LOCAL_DEFAULT_API_BASES.has(profileApiBase))
+  ) {
+    return `http://localhost:${conductorPort + 1}`;
+  }
+
+  return profileApiBase || DEFAULT_API_BASE;
+}
+
+export function getJwt(config, profileName) {
+  const env = process.env.NOTIS_JWT;
+  if (env) {
+    return env;
+  }
+  const profile = getProfile(config, profileName);
+  return profile.jwt;
+}
+
+export function isAgentMode(globalOptions = {}) {
+  return process.env.NOTIS_AGENT === '1' || Boolean(globalOptions.agentMode);
+}
+
+export function isNonInteractive(globalOptions = {}) {
+  if (process.env.NOTIS_NON_INTERACTIVE === '1') {
+    return true;
+  }
+  if (globalOptions.nonInteractive) {
+    return true;
+  }
+  return isAgentMode(globalOptions);
+}
+
+export function resolveOutputMode(globalOptions = {}) {
+  if (globalOptions.json) {
+    return 'json';
+  }
+  if (globalOptions.output) {
+    return globalOptions.output;
+  }
+  if (process.env.NOTIS_OUTPUT) {
+    return process.env.NOTIS_OUTPUT;
+  }
+  return !process.stdout.isTTY || isAgentMode(globalOptions) ? 'json' : 'table';
+}
+
+export function resolveTimeoutMs(globalOptions = {}) {
+  const raw = globalOptions.timeoutMs || process.env.NOTIS_TIMEOUT_MS;
+  if (!raw) {
+    return 30000;
+  }
+  const parsed = Number.parseInt(raw, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 30000;
+}
+
+export function resolveRuntimeProfile(globalOptions = {}, { requireAuth = true } = {}) {
+  const config = loadConfig();
+  const profileName = getCurrentProfileName(config, globalOptions.profile);
+  const apiBase = getApiBase(config, profileName, globalOptions.apiBase);
+  const jwt = getJwt(config, profileName);
+  const agentMode = isAgentMode(globalOptions);
+  const nonInteractive = isNonInteractive(globalOptions);
+  const outputMode = resolveOutputMode(globalOptions);
+  const timeoutMs = resolveTimeoutMs(globalOptions);
+
+  if (requireAuth && !jwt) {
+    throw new CliError({
+      code: 'auth_missing',
+      message: `No JWT configured for profile ${profileName}`,
+      exitCode: EXIT_CODES.auth,
+      hints: [
+        {
+          command: 'notis auth login --jwt <token>',
+          reason: 'Configure a token for non-interactive use',
+        },
+      ],
+    });
+  }
+
+  return {
+    config,
+    profileName,
+    apiBase,
+    jwt,
+    agentMode,
+    nonInteractive,
+    outputMode,
+    timeoutMs,
+  };
+}
+
+export function workspacePath(appId) {
+  return join(WORKSPACE_DIR, appId);
+}

package/src/runtime/transport.js

@@ -0,0 +1,198 @@
+import { randomUUID } from 'node:crypto';
+import { CliError, EXIT_CODES } from './errors.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;
+  }
+
+  if (META_TOOL_NAMES.has(toolName) || toolName.startsWith('notis-default-')) {
+    return toolName;
+  }
+
+  if (toolName.startsWith('notis_')) {
+    return `notis-default-${toolName.slice('notis_'.length)}`;
+  }
+
+  if (toolName.includes('_notis_')) {
+    return `notis-default-${toolName.replace(/_notis_/g, '_')}`;
+  }
+
+  return toolName;
+}
+
+function normalizeBackendError(status, payload) {
+  const backendError = payload?.error;
+  const message =
+    backendError?.message ||
+    backendError ||
+    payload?.message ||
+    payload?.error ||
+    `Request failed with status ${status}`;
+
+  if (status === 401) {
+    return new CliError({
+      code: 'auth_invalid',
+      message,
+      exitCode: EXIT_CODES.auth,
+      hints: [
+        {
+          command: 'notis auth login --jwt <token>',
+          reason: 'Refresh the stored JWT for this profile',
+        },
+      ],
+      details: payload || {},
+    });
+  }
+
+  if (status === 409) {
+    return new CliError({
+      code: 'conflict',
+      message,
+      exitCode: EXIT_CODES.conflict,
+      retryable: false,
+      hints: payload?.hints || [],
+      details: payload || {},
+    });
+  }
+
+  if (status === 403) {
+    return new CliError({
+      code: 'forbidden',
+      message,
+      exitCode: EXIT_CODES.auth,
+      details: payload || {},
+      hints: [
+        { command: 'notis tools toolkits', reason: 'Check which toolkits are available' },
+        { command: 'notis whoami', reason: 'Verify your active profile and permissions' },
+        ...(payload?.hints || []),
+      ],
+    });
+  }
+
+  if (status >= 400 && status < 500) {
+    return new CliError({
+      code: 'usage_error',
+      message,
+      exitCode: EXIT_CODES.usage,
+      details: payload || {},
+      hints: payload?.hints || [],
+    });
+  }
+
+  return new CliError({
+    code: 'backend_error',
+    message,
+    exitCode: EXIT_CODES.backend,
+    retryable: status >= 500,
+    details: payload || {},
+    hints: payload?.hints || [],
+  });
+}
+
+export async function httpRequest({
+  runtime,
+  method = 'POST',
+  path,
+  body,
+  requireAuth = true,
+}) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), runtime.timeoutMs);
+  const requestId = `req_${randomUUID().replace(/-/g, '')}`;
+
+  const headers = {
+    'Content-Type': 'application/json',
+    'X-Notis-CLI-Version': runtime.cliVersion,
+    'X-Notis-Request-Id': requestId,
+  };
+
+  if (requireAuth && runtime.jwt) {
+    headers.Authorization = `Bearer ${runtime.jwt}`;
+  }
+
+  try {
+    const response = await fetch(`${runtime.apiBase}${path}`, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+      signal: controller.signal,
+    });
+    clearTimeout(timeout);
+
+    let payload = null;
+    try {
+      payload = await response.json();
+    } catch {
+      payload = null;
+    }
+
+    if (!response.ok) {
+      throw normalizeBackendError(response.status, payload);
+    }
+
+    return {
+      requestId,
+      payload: payload || {},
+    };
+  } catch (error) {
+    clearTimeout(timeout);
+
+    if (error instanceof CliError) {
+      throw error;
+    }
+
+    if (error?.name === 'AbortError') {
+      throw new CliError({
+        code: 'network_timeout',
+        message: `Request timed out after ${runtime.timeoutMs}ms`,
+        exitCode: EXIT_CODES.network,
+        retryable: true,
+        hints: [
+          { command: 'notis doctor', reason: 'Check API reachability' },
+          { command: `--timeout-ms ${runtime.timeoutMs * 2}`, reason: 'Retry with a longer timeout' },
+        ],
+      });
+    }
+
+    throw new CliError({
+      code: 'network_error',
+      message: error instanceof Error ? error.message : String(error),
+      exitCode: EXIT_CODES.network,
+      retryable: true,
+      cause: error,
+    });
+  }
+}
+
+export async function callTool({
+  runtime,
+  toolName,
+  arguments_: argumentsPayload = {},
+  idempotencyKey,
+}) {
+  const requestId = idempotencyKey || (runtime.mutating ? randomUUID() : null);
+  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,
+      },
+    },
+  });
+}

package/template/app/globals.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/template/app/layout.tsx

@@ -0,0 +1,7 @@
+import { NotisProvider } from '@notis/sdk';
+import '@notis/sdk/styles.css';
+import './globals.css';
+
+export default function AppShell({ children }: { children: React.ReactNode }) {
+  return <NotisProvider>{children}</NotisProvider>;
+}

package/template/app/page.tsx

@@ -0,0 +1,55 @@
+'use client';
+
+import { useNotis, useDatabase } from '@notis/sdk';
+import { Badge } from '@/components/ui/badge';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
+
+export default function HomePage() {
+  const { app, ready } = useNotis();
+  const { documents, loading } = useDatabase('items');
+
+  return (
+    <main className="notis-app-shell space-y-6">
+      <Card>
+        <CardHeader className="space-y-3">
+          <Badge variant="secondary" className="w-fit">Installed app</Badge>
+          <div className="space-y-2">
+            <CardTitle>{ready ? app?.name : 'Loading...'}</CardTitle>
+            <CardDescription>
+              {ready ? app?.description : 'Loading app metadata...'}
+            </CardDescription>
+          </div>
+        </CardHeader>
+      </Card>
+
+      <Card>
+        <CardHeader>
+          <CardTitle>Items</CardTitle>
+          <CardDescription>Use shadcn surfaces and portal tokens so the app feels native inside Notis.</CardDescription>
+        </CardHeader>
+        <CardContent>
+          {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">
+              No items yet. Deploy the app and create some.
+            </div>
+          ) : (
+            <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 className="flex items-center justify-between gap-3">
+                    <p className="font-medium">{doc.title}</p>
+                    {doc.properties.status ? (
+                      <Badge variant="outline">{String(doc.properties.status)}</Badge>
+                    ) : null}
+                  </div>
+                </div>
+              ))}
+            </div>
+          )}
+        </CardContent>
+      </Card>
+    </main>
+  );
+}

package/template/components/ui/badge.tsx

@@ -0,0 +1,28 @@
+import * as React from 'react';
+import { cva, type VariantProps } from 'class-variance-authority';
+
+import { cn } from '@/lib/utils';
+
+const badgeVariants = cva(
+  'inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-medium transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2',
+  {
+    variants: {
+      variant: {
+        default: 'border-transparent bg-primary/10 text-primary',
+        secondary: 'border-transparent bg-secondary text-secondary-foreground',
+        outline: 'text-foreground',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+    },
+  },
+);
+
+export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {}
+
+function Badge({ className, variant, ...props }: BadgeProps) {
+  return <div className={cn(badgeVariants({ variant }), className)} {...props} />;
+}
+
+export { Badge, badgeVariants };

package/template/components/ui/button.tsx

@@ -0,0 +1,53 @@
+import * as React from 'react';
+import { Slot } from '@radix-ui/react-slot';
+import { cva, type VariantProps } from 'class-variance-authority';
+
+import { cn } from '@/lib/utils';
+
+const buttonVariants = cva(
+  'inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',
+  {
+    variants: {
+      variant: {
+        default: 'bg-primary text-primary-foreground hover:bg-primary/90',
+        destructive: 'bg-destructive text-destructive-foreground hover:bg-destructive/90',
+        outline: 'border border-input bg-background hover:bg-accent hover:text-accent-foreground',
+        secondary: 'bg-secondary text-secondary-foreground hover:bg-secondary/80',
+        ghost: 'hover:bg-accent hover:text-accent-foreground',
+        link: 'text-primary underline-offset-4 hover:underline',
+      },
+      size: {
+        default: 'h-10 px-4 py-2',
+        sm: 'h-9 rounded-md px-3',
+        lg: 'h-11 rounded-md px-8',
+        icon: 'h-10 w-10',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+      size: 'default',
+    },
+  },
+);
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean;
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : 'button';
+    return (
+      <Comp
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    );
+  },
+);
+Button.displayName = 'Button';
+
+export { Button, buttonVariants };

package/template/components/ui/card.tsx

@@ -0,0 +1,56 @@
+import * as React from 'react';
+
+import { cn } from '@/lib/utils';
+
+const Card = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn('rounded-2xl border bg-card text-card-foreground shadow-sm', className)}
+      {...props}
+    />
+  ),
+);
+Card.displayName = 'Card';
+
+const CardHeader = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn('flex flex-col space-y-1.5 p-6', className)} {...props} />
+  ),
+);
+CardHeader.displayName = 'CardHeader';
+
+const CardTitle = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLHeadingElement>>(
+  ({ className, ...props }, ref) => (
+    <h3
+      ref={ref}
+      className={cn('text-xl font-semibold leading-none tracking-tight', className)}
+      {...props}
+    />
+  ),
+);
+CardTitle.displayName = 'CardTitle';
+
+const CardDescription = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, ...props }, ref) => (
+  <p ref={ref} className={cn('text-sm text-muted-foreground', className)} {...props} />
+));
+CardDescription.displayName = 'CardDescription';
+
+const CardContent = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn('p-6 pt-0', className)} {...props} />
+  ),
+);
+CardContent.displayName = 'CardContent';
+
+const CardFooter = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
+  ({ className, ...props }, ref) => (
+    <div ref={ref} className={cn('flex items-center p-6 pt-0', className)} {...props} />
+  ),
+);
+CardFooter.displayName = 'CardFooter';
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent };

package/template/components.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.ts",
+    "css": "app/globals.css",
+    "baseColor": "zinc",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/template/lib/utils.ts

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/template/notis.config.ts

@@ -0,0 +1,18 @@
+import { defineNotisApp } from '@notis/sdk/config';
+
+export default defineNotisApp({
+  name: 'My Notis App',
+  description: 'A new Notis app',
+  icon: 'lucide:layout-dashboard',
+
+  databases: ['items'],
+
+  routes: [
+    { path: '/', name: 'Home', icon: 'lucide:home', default: true },
+  ],
+
+  tools: [
+    'notis_query_database',
+    'notis_upsert_document',
+  ],
+});

package/template/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "my-notis-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@notis/sdk": "file:./packages/notis-sdk",
+    "@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",
+    "tailwindcss-animate": "^1.0.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "postcss": "^8.0.0",
+    "tailwindcss": "^3.4.0",
+    "typescript": "^5.0.0",
+    "vite": "^6.0.0"
+  }
+}