@notis_ai/cli 0.2.18 → 0.2.20

package/src/runtime/store-screenshot.js

@@ -1,143 +0,0 @@
-import { fileURLToPath } from 'node:url';
-
-const STORE_SCREENSHOT_ASPECT = 16 / 10;
-const SHARED_BACKDROP_PATH = fileURLToPath(
-  new URL('./assets/store-screenshot-dark.png', import.meta.url),
-);
-
-const ACCENT_PALETTES = {
-  blue: { glow: '#4f7cff', glow2: '#274690' },
-  violet: { glow: '#9b87f5', glow2: '#5038a1' },
-  emerald: { glow: '#34d399', glow2: '#176b55' },
-  amber: { glow: '#f2a94a', glow2: '#8b4f20' },
-  rose: { glow: '#fb7185', glow2: '#8f3048' },
-  sky: { glow: '#38bdf8', glow2: '#176887' },
-  fuchsia: { glow: '#d946ef', glow2: '#772786' },
-  teal: { glow: '#2dd4bf', glow2: '#176e68' },
-};
-
-const ACCENT_NAMES = Object.keys(ACCENT_PALETTES);
-
-async function loadSharp() {
-  return (await import('sharp')).default;
-}
-
-function stableHash(value) {
-  let hash = 2166136261;
-  for (const character of String(value || 'notis-app')) {
-    hash ^= character.codePointAt(0);
-    hash = Math.imul(hash, 16777619);
-  }
-  return hash >>> 0;
-}
-
-export function resolveStoreScreenshotAccent(accent, seed = 'notis-app') {
-  if (accent && ACCENT_PALETTES[accent]) {
-    return accent;
-  }
-  return ACCENT_NAMES[stableHash(seed) % ACCENT_NAMES.length];
-}
-
-export function storeScreenshotLayout(width = 2000, height = 1250) {
-  const horizontalInset = Math.max(48, Math.round(width * 0.06));
-  const verticalInset = Math.max(40, Math.round(height * 0.06));
-  let cardWidth = width - horizontalInset * 2;
-  let cardHeight = Math.round(cardWidth / STORE_SCREENSHOT_ASPECT);
-  const maximumCardHeight = height - verticalInset * 2;
-  if (cardHeight > maximumCardHeight) {
-    cardHeight = maximumCardHeight;
-    cardWidth = Math.round(cardHeight * STORE_SCREENSHOT_ASPECT);
-  }
-  const cardLeft = Math.round((width - cardWidth) / 2);
-  const cardTop = Math.round((height - cardHeight) / 2) - Math.round(height * 0.008);
-  return {
-    width,
-    height,
-    cardWidth,
-    cardHeight,
-    cardLeft,
-    cardTop,
-    radius: Math.max(18, Math.round(width * 0.016)),
-  };
-}
-
-async function backdropImage(layout) {
-  const sharp = await loadSharp();
-  return sharp(SHARED_BACKDROP_PATH)
-    .resize(layout.width, layout.height, { fit: 'cover', position: 'centre' })
-    .png()
-    .toBuffer();
-}
-
-function roundedRectSvg(width, height, radius, { fill = '#ffffff', stroke = null } = {}) {
-  const strokeAttribute = stroke
-    ? ` fill="none" stroke="${stroke}" stroke-width="2"`
-    : ` fill="${fill}"`;
-  return Buffer.from(
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"><rect x="1" y="1" width="${width - 2}" height="${height - 2}" rx="${radius}" ry="${radius}"${strokeAttribute}/></svg>`,
-  );
-}
-
-/**
- * Composite a truthful browser capture into the deterministic Store frame.
- * The source pixels are only resized/cropped; the app UI is never redrawn.
- */
-export async function composeStoreScreenshot({
-  inputPath,
-  outputPath,
-  width = 2000,
-  height = 1250,
-  accent = null,
-  seed = 'notis-app',
-  focused = false,
-  theme = 'light',
-}) {
-  const sharp = await loadSharp();
-  const resolvedTheme = theme === 'dark' ? 'dark' : 'light';
-  const layout = storeScreenshotLayout(width, height);
-  const resolvedAccent = resolveStoreScreenshotAccent(accent, seed);
-
-  const roundedCapture = await sharp(inputPath)
-    .resize(layout.cardWidth, layout.cardHeight, {
-      fit: 'cover',
-      position: focused ? 'top' : 'centre',
-    })
-    .composite([{
-      input: roundedRectSvg(layout.cardWidth, layout.cardHeight, layout.radius),
-      blend: 'dest-in',
-    }])
-    .png()
-    .toBuffer();
-
-  const border = roundedRectSvg(
-    layout.cardWidth,
-    layout.cardHeight,
-    layout.radius,
-    { stroke: resolvedTheme === 'dark' ? '#FFFFFF2A' : '#0F172A22' },
-  );
-
-  await sharp(await backdropImage(layout))
-    .composite([
-      { input: roundedCapture, left: layout.cardLeft, top: layout.cardTop },
-      { input: border, left: layout.cardLeft, top: layout.cardTop },
-    ])
-    .png({
-      compressionLevel: 9,
-      adaptiveFiltering: true,
-    })
-    .toFile(outputPath);
-
-  return {
-    mode: 'framed',
-    accent: resolvedAccent,
-    focused: Boolean(focused),
-    theme: resolvedTheme,
-    card: {
-      left: layout.cardLeft,
-      top: layout.cardTop,
-      width: layout.cardWidth,
-      height: layout.cardHeight,
-      radius: layout.radius,
-    },
-  };
-}

package/template/CHANGELOG.md

@@ -1,5 +0,0 @@
-# App Changelog
-
-## [Initial Release] - {PR_MERGE_DATE}
-
-- First Store release.

package/template/app/page.tsx

@@ -1,60 +0,0 @@
-'use client';
-
-import { getDocumentPreview, useDocuments, useNotis } 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();
-  // Documents come back normalized: plain property values, camelCase fields,
-  // and typed content (contentMarkdown / contentBlocknote / plainText).
-  const { documents, loading } = useDocuments('items', { pageSize: 25 });
-
-  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 || 'Untitled'}</p>
-                    {typeof doc.properties.status === 'string' ? (
-                      <Badge variant="outline">{doc.properties.status}</Badge>
-                    ) : null}
-                  </div>
-                  <p className="mt-1 line-clamp-1 text-xs text-muted-foreground">
-                    {getDocumentPreview(doc)}
-                  </p>
-                </div>
-              ))}
-            </div>
-          )}
-        </CardContent>
-      </Card>
-    </main>
-  );
-}

package/template/components/ui/card.tsx

@@ -1,56 +0,0 @@
-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/packages/sdk/src/components/DocumentEditor.tsx

@@ -1,103 +0,0 @@
-'use client';
-
-import type { CSSProperties, ReactElement } from 'react';
-import { useNotisRuntime } from '../provider';
-import { useDocument } from '../hooks/useDocument';
-import { Markdown } from './Markdown';
-import type { NotisDocumentEditorProps } from '../runtime';
-
-const fallbackNoticeStyle: CSSProperties = {
-  marginTop: '0.75rem',
-  fontSize: '12px',
-  color: 'hsl(var(--muted-foreground))',
-};
-
-const fallbackFrameStyle: CSSProperties = {
-  borderRadius: '0.5rem',
-  border: '1px dashed hsl(var(--border))',
-  padding: '1rem',
-  fontSize: '13px',
-  color: 'hsl(var(--muted-foreground))',
-};
-
-const fallbackTitleStyle: CSSProperties = {
-  margin: '0 0 0.75rem',
-  fontSize: '1.5rem',
-  fontWeight: 700,
-  letterSpacing: '-0.01em',
-  color: 'hsl(var(--foreground))',
-};
-
-/**
- * Read-only stand-in used when no host editor is available (standalone dev
- * harness, snapshots). Markdown content renders via `Markdown`; other content
- * types get a typed placeholder.
- */
-function DocumentEditorFallback({ documentId, variant = 'full', className }: NotisDocumentEditorProps) {
-  const runtime = useNotisRuntime();
-  const { document, loading, error } = useDocument(documentId);
-  // Listing screenshots should show the app as it looks in the portal, so the
-  // harness-only editing notice stays out of scenario captures.
-  const isScreenshot = Boolean(runtime?.context?.screenshotScenario);
-
-  if (loading) {
-    return <div className={className} style={fallbackFrameStyle}>Loading document…</div>;
-  }
-  if (error || !document) {
-    return (
-      <div className={className} style={fallbackFrameStyle}>
-        {error?.message ?? 'Document not found.'}
-      </div>
-    );
-  }
-
-  const isMarkdown = document.contentType === 'markdown' || !document.contentType;
-  return (
-    <div className={className}>
-      {variant === 'full' ? <h1 style={fallbackTitleStyle}>{document.title}</h1> : null}
-      {isMarkdown ? (
-        <>
-          <Markdown value={document.contentMarkdown ?? ''} />
-          {isScreenshot ? null : (
-            <p style={fallbackNoticeStyle}>Read-only preview — editing is available inside the Notis portal.</p>
-          )}
-        </>
-      ) : document.contentType === 'view' ? (
-        <div style={fallbackFrameStyle}>
-          {document.viewType === 'report'
-            ? 'Interactive report'
-            : document.viewType === 'html'
-              ? 'Interactive HTML document'
-              : 'View document'} — open it in Notis Documents for
-          the full native experience.
-        </div>
-      ) : (
-        <div style={fallbackFrameStyle}>
-          {document.fileType ? `${document.fileType.toUpperCase()} document` : 'File document'} — open it in
-          the Notis portal to view.
-        </div>
-      )}
-    </div>
-  );
-}
-
-/**
- * Embeds the document editor for a document anywhere in an app view. The host
- * (portal) provides the implementation through `runtime.ui.DocumentEditor` and
- * dispatches on the document's content type (markdown -> rich text editor,
- * files -> matching viewer, views -> their trusted native Documents surface).
- * Outside the portal this falls back to a read-only preview or an explicit
- * open-in-Documents notice for native views.
- *
- * ```tsx
- * <DocumentEditor documentId={entry.id} variant="body" className="min-h-[320px]" />
- * ```
- */
-export function DocumentEditor(props: NotisDocumentEditorProps): ReactElement {
-  const runtime = useNotisRuntime();
-  const HostEditor = runtime?.ui?.DocumentEditor;
-  if (HostEditor) {
-    return <HostEditor {...props} />;
-  }
-  return <DocumentEditorFallback {...props} />;
-}

package/template/packages/sdk/src/config.ts

@@ -1,259 +0,0 @@
-/**
- * Configuration utilities for notis.config.ts.
- *
- * Usage:
- * ```ts
- * // notis.config.ts
- * import { defineNotisApp } from '@notis/sdk/config';
- *
- * export default defineNotisApp({
- *   name: 'My App',
- *   description: 'Does things',
- *   icon: 'phosphor:squares-four',
- *   databases: ['tasks'],
- *   routes: [
- *     {
- *       path: '/',
- *       slug: 'notes',
- *       name: 'Notes',
- *       default: true,
- *       collection: {
- *         database: 'notes',
- *         titleProperty: 'Name',
- *         parentProperty: 'Parent',
- *         sidebar: {
- *           mode: 'tree',
- *           allowCreate: true,
- *         },
- *       },
- *     },
- *   ],
- *   tools: [...],
- * });
- * ```
- */
-
-export interface NotisRouteConfig {
-  path: string;
-  slug: string;
-  name: string;
-  icon?: string;
-  parentSlug?: string | null;
-  default?: boolean;
-  /**
-   * Allow the host to address an app-owned resource on this route through the
-   * canonical `?resource=<id>` deep link. Read the incoming id with
-   * `useNotis().resourceId`.
-   */
-  resourceDeepLinks?: boolean;
-  exportName?: string;
-  collection?: {
-    database: string;
-    titleProperty: string;
-    parentProperty?: string | null;
-    sidebar?: {
-      mode: 'flat-list' | 'tree';
-      allowCreate: boolean;
-    };
-  };
-}
-
-export const NOTIS_APP_CATEGORIES = [
-  'Productivity',
-  'Sales & Marketing',
-  'Operations',
-  'Product & Engineering',
-  'Personal',
-] as const;
-
-export type NotisAppCategory = typeof NOTIS_APP_CATEGORIES[number];
-
-export interface NotisAppDatabaseConfig {
-  /** Database slug, as declared by the app. */
-  slug: string;
-  /**
-   * Ship this database's rows to everyone who installs the app.
-   *
-   * Off by default: declaring a database publishes its STRUCTURE, never its
-   * content. Turn it on only for starter content that every installer should
-   * receive - a default folder tree, a set of templates - and never for a
-   * database that accumulates the author's own data.
-   */
-  seedDocuments?: boolean;
-}
-
-export interface NotisAppAuthor {
-  name: string;
-  handle?: string;
-  url?: string;
-}
-
-export interface NotisAppSkillConfig {
-  /** Stable source-owned key used by other app declarations. */
-  key: string;
-  /**
-   * Path to the skill, relative to notis.config.ts. Either a Markdown file
-   * (`./skills/onboarding.md`) or a directory holding SKILL.md plus its
-   * supporting files (`./skills/onboarding/`), which are packaged on deploy
-   * and materialized next to SKILL.md in the sandbox.
-   */
-  path: string;
-  /** User-facing name used for the installed skill. */
-  name: string;
-  description?: string;
-}
-
-export interface NotisAppOnboardingConfig {
-  /** Key of a skill declared in `skills`. */
-  skill: string;
-  /** Editable message placed in Notis when onboarding is opened. */
-  prompt: string;
-}
-
-export interface NotisAppScreenshotConfig {
-  /** Conventional metadata/screenshot-N.png source path. */
-  path: string;
-  /** Meaningful description used by the Store gallery and assistive technology. */
-  alt: string;
-  /** Route slug captured by `notis apps screenshot`. */
-  route?: string;
-  /**
-   * Named scenario from metadata/screenshot-fixtures.json. Its `tools` and
-   * `requests` override the file-level ones key by key for this capture, and
-   * its `actions` run once the route has mounted -- so one route can be shown
-   * in several states (populated, empty, a panel opened) without the states
-   * leaking into each other.
-   */
-  scenario?: string;
-  /** Optional CSS selector captured as the truthful focal region for this Store image. */
-  focus?: string;
-  /** Portal color scheme used while rendering this screenshot. Defaults to light. */
-  theme?: 'light' | 'dark';
-}
-
-/**
- * Named accent tokens for an app's avatar. Keep in sync with the portal
- * `ACCENT_NAMES` and the server `ACCENT_TOKENS`.
- */
-export const NOTIS_APP_ACCENTS = [
-  'blue',
-  'violet',
-  'emerald',
-  'amber',
-  'rose',
-  'sky',
-  'fuchsia',
-  'teal',
-] as const;
-
-export type NotisAppAccent = typeof NOTIS_APP_ACCENTS[number];
-
-export interface NotisAppCapabilities {
-  /**
-   * Read every database in the workspace, not only the ones this app declares
-   * in `databases` or created itself.
-   *
-   * An app runtime is otherwise sandboxed to its own databases, so a catalog or
-   * explorer app sees an empty list without this. `'read'` is the only accepted
-   * value and it never grants writes: `LOCAL_NOTIS_DATABASE_UPSERT_*` stays
-   * bound to the app's own databases.
-   */
-  workspaceDatabases?: 'read';
-
-  /**
-   * Read a few facts about the user's cloud computer: whether a sandbox exists
-   * and is running, and whether the GitHub CLI is signed in there.
-   *
-   * Without this an app has to infer them — the Workspaces app treated a
-   * configured repository as proof that `gh auth login` had happened, which
-   * cannot show an account name and cannot notice a revoked credential.
-   * `'read'` never creates, resumes or commands a sandbox. Read it with
-   * `useCloudComputer()`.
-   *
-   * `'shell'` additionally asks to command the cloud computer: it unlocks
-   * `LOCAL_NOTIS_RUN_SANDBOX_SHELL` and the sandbox file tools from this app's
-   * views (they are denied to every view otherwise), and implies the read
-   * facts. This is the same authority the user's own agent has on the sandbox,
-   * so the user is asked for it explicitly at install or in the Store grant
-   * step; declare it only when the app's core actions genuinely run there.
-   */
-  cloudComputer?: 'read' | 'shell';
-}
-
-/**
- * Execution hint for a tool whose public name is generated by a provider.
- *
- * MCP public names may be truncated or deduplicated, so the upstream action
- * cannot always be reconstructed from the final `LOCAL_MCP_*` name. Binding
- * the two lets the host skip provider schema discovery on direct calls while
- * the public name remains the user-approved permission boundary.
- */
-export interface NotisAppToolBinding {
-  /** Exact final name also present in `tools`. */
-  name: string;
-  /** Exact upstream MCP action name, for example `execute_sql`. */
-  providerToolName: string;
-}
-
-export interface NotisAppConfig {
-  /** URL-safe app slug. Existing apps may still use a display name here. */
-  name: string;
-  /** Stable local-development slug. Defaults to a slug derived from `name`. */
-  devSlug?: string;
-  /** Human display title, Raycast-style. Falls back to `name`. */
-  title?: string;
-  description?: string;
-  /**
-   * App icon. A `phosphor:<name>` value (e.g. `phosphor:dice-five`) or
-   * `metadata/icon.png`. When unset, the app shows its two-letter initials.
-   */
-  icon?: string;
-  /**
-   * Optional accent color for the app avatar. One of {@link NOTIS_APP_ACCENTS}.
-   * When unset, a stable accent is derived automatically from the app id.
-   */
-  accent?: NotisAppAccent;
-  author?: NotisAppAuthor;
-  categories?: NotisAppCategory[];
-  tagline?: string;
-  /** @deprecated Add release entries to the root CHANGELOG.md instead. */
-  versionNotes?: string;
-  /** Editorial screenshot order and capture scenarios for the Store listing. */
-  screenshots?: NotisAppScreenshotConfig[];
-  /**
-   * Databases this app owns. A bare string publishes structure only; use the
-   * object form to opt a database into shipping its rows to installers.
-   */
-  databases?: (string | NotisAppDatabaseConfig)[];
-  /**
-   * Extra permissions the app asks for at install time. Everything here widens
-   * what the app can reach beyond its own data, so each one is surfaced to the
-   * user before they install.
-   */
-  capabilities?: NotisAppCapabilities;
-  routes?: NotisRouteConfig[];
-  /**
-   * Final tool names this app can call at runtime, enforced server-side. Use
-   * names returned by shared discovery, including native `LOCAL_NOTIS_*`,
-   * connected-service names such as `GMAIL_SEND_EMAIL`,
-   * `LOCAL_POSTFORME_*`, and `LOCAL_MCP_<SERVER>_<TOOL>`. App code calls
-   * each declared name directly with `useTool`; metered calls use the shared
-   * credit-cap and usage-billing path.
-   */
-  tools?: string[];
-  /** Optional execution bindings for provider-generated tool names. */
-  toolBindings?: NotisAppToolBinding[];
-  /** Skills shipped from this app's source tree. */
-  skills?: NotisAppSkillConfig[];
-  /** Optional onboarding entrypoint exposed from the app sidebar. */
-  onboarding?: NotisAppOnboardingConfig;
-}
-
-/**
- * Identity function that provides type checking and autocomplete for the
- * Notis app configuration. The returned object is read at build time by
- * `notis apps build` to generate the manifest.
- */
-export function defineNotisApp(config: NotisAppConfig): NotisAppConfig {
-  return config;
-}