@notis_ai/cli 0.2.14 → 0.2.16

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

@@ -71,7 +71,7 @@ export interface DatabaseDescriptor {
  * (pdf, xlsx, pptx, ...). Future content types (canvas, ...) extend this
  * union without changing the component contracts.
  */
-export type DocumentContentType = 'markdown' | 'file';
+export type DocumentContentType = 'markdown' | 'file' | 'view';
 
 export interface DocumentRecord {
   id: string;
@@ -86,6 +86,9 @@ export interface DocumentRecord {
   contentBlocknote?: Array<Record<string, unknown>> | null;
   contentMarkdown?: string | null;
   plainText?: string | null;
+  viewType?: string | null;
+  viewState?: Record<string, unknown> | null;
+  viewRevision?: number | null;
   createdAt?: string | null;
   lastEditedTime?: string | null;
 }
@@ -102,6 +105,14 @@ export interface ToolDescriptor {
   inputSchema?: ToolInputSchema;
 }
 
+export interface ToolCallOptions {
+  /**
+   * Coalesce an identical in-flight call. Only opt in for idempotent reads;
+   * mutations must execute once per invocation.
+   */
+  dedupe?: boolean;
+}
+
 // ---------------------------------------------------------------------------
 // Route types
 // ---------------------------------------------------------------------------
@@ -113,6 +124,7 @@ export interface RouteDescriptor {
   icon?: string | null;
   parentSlug?: string | null;
   default?: boolean;
+  resourceDeepLinks?: boolean;
   collection?: {
     database: string;
     titleProperty: string;
@@ -161,6 +173,8 @@ export interface QueryFilter {
 
 export interface NotisRuntimeContext {
   collectionItem?: CollectionItemDetail | null;
+  /** App-owned resource requested through the route's `?resource=<id>` link. */
+  resourceId?: string | null;
   /**
    * Set when the app is being rendered by the screenshot harness (`notis apps
    * screenshot`) for the named listing scenario. Lets apps and SDK components
@@ -169,6 +183,37 @@ export interface NotisRuntimeContext {
   screenshotScenario?: string | null;
 }
 
+// ---------------------------------------------------------------------------
+// App context shared with Notis
+// ---------------------------------------------------------------------------
+
+export type ContextAttributeValue = string | number | boolean | null;
+
+/**
+ * The specific thing currently in focus inside an app view. The host stamps
+ * app/view provenance onto this value before it reaches chat, so apps only
+ * describe their own resource rather than impersonating another surface.
+ */
+export interface ContextResource {
+  id: string;
+  kind: string;
+  label: string;
+  url?: string | null;
+  revision?: string | null;
+  attributes?: Record<string, ContextAttributeValue>;
+  snapshot?: {
+    format: 'text' | 'markdown';
+    content: string;
+  } | null;
+}
+
+/** A quote copied from an app, kept separate from the user's prompt. */
+export interface ContextSelection {
+  id: string;
+  text: string;
+  resource?: ContextResource | null;
+}
+
 // ---------------------------------------------------------------------------
 // Host-provided UI
 // ---------------------------------------------------------------------------
@@ -189,6 +234,38 @@ export interface NotisDocumentEditorProps {
   onSavingChange?: (saving: boolean) => void;
 }
 
+export interface NotisMarkdownEditorSavePayload {
+  markdown: string;
+  expectedRevision?: string | null;
+}
+
+export interface NotisMarkdownEditorSaveResult {
+  revision?: string | null;
+}
+
+/**
+ * Storage-neutral host markdown editor. The app owns persistence through
+ * `onSave`; the host only supplies Notis' editing experience.
+ */
+export interface NotisMarkdownEditorProps {
+  /** Stable identity of the edited resource. Changing it starts a fresh editor. */
+  resourceKey?: string;
+  value: string;
+  revision?: string | null;
+  readOnly?: boolean;
+  autosaveMs?: number;
+  placeholder?: string;
+  className?: string;
+  onChange?: (markdown: string) => void;
+  /** Persist an uploaded media/file block and return its durable URL. */
+  onUploadFile?: (file: File) => Promise<string>;
+  onSave?: (
+    payload: NotisMarkdownEditorSavePayload,
+  ) => Promise<NotisMarkdownEditorSaveResult | void>;
+  onDirtyChange?: (dirty: boolean) => void;
+  onSavingChange?: (saving: boolean) => void;
+}
+
 /**
  * Components the host (portal) injects through the runtime. Apps consume them
  * via the SDK wrappers (e.g. `DocumentEditor`), which fall back gracefully
@@ -196,6 +273,7 @@ export interface NotisDocumentEditorProps {
  */
 export interface NotisRuntimeUI {
   DocumentEditor?: ComponentType<NotisDocumentEditorProps>;
+  MarkdownEditor?: ComponentType<NotisMarkdownEditorProps>;
 }
 
 // ---------------------------------------------------------------------------
@@ -218,8 +296,8 @@ export interface SubscribeDatabaseOptions {
  * Work an app hands to the Notis manager chat through `NotisRuntime.handover`.
  */
 export interface HandoverPayload {
-  /** The message the manager should act on. */
-  prompt: string;
+  /** Optional starter message. Omit it to open a context-only composer. */
+  prompt?: string;
   /**
    * Key of a skill declared in `notis.config.ts` -> `skills[].key`. The host
    * rejects a key this app does not declare. Omit to hand over plain work.
@@ -287,6 +365,12 @@ export interface NotisRuntime {
   context: NotisRuntimeContext;
   ui?: NotisRuntimeUI;
 
+  /** Publish or clear the focused resource inside the current app view. */
+  publishActiveResource?(resource: ContextResource | null): void;
+
+  /** Remember a copied quote so the host can recover it across iframe paste. */
+  captureContextSelection?(selection: ContextSelection): void;
+
   /**
    * Subscribe to changes on an app-owned database. Returns an unsubscribe.
    *
@@ -341,7 +425,11 @@ export interface NotisRuntime {
   setTopBarSearchLoading?: (loading: boolean) => void;
 
   listTools(): Promise<ToolDescriptor[]>;
-  callTool<TResult = unknown>(name: string, args?: Record<string, unknown>): Promise<TResult>;
+  callTool<TResult = unknown>(
+    name: string,
+    args?: Record<string, unknown>,
+    options?: ToolCallOptions,
+  ): Promise<TResult>;
 
   request(path: string, options?: {
     method?: string;

package/dist/scaffolds/notis-database/CHANGELOG.md

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

package/dist/scaffolds/notis-database/app/globals.css

@@ -1,44 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-/*
- * The portal mounts the app inside [data-notis-app-root] (display: block,
- * min-height: 100% from @notis/sdk/styles.css). Width 100% ensures the
- * two-pane layout can stretch to the full content area; height stays on
- * the SDK's min-height: 100% default so the page can grow with content.
- * The page itself uses `h-screen` to guarantee a fixed viewport height
- * for the two-pane divider and centered empty states.
- */
-[data-notis-app-root] {
-  width: 100%;
-}
-
-/*
- * Dev-preview fallback tokens. Active only when the dev entrypoint sets the
- * data-dev-preview attribute. Production bundle runs inside the portal
- * shadow root where the host injects real theme tokens, so this rule is
- * scoped narrowly enough to never collide with portal-provided values.
- */
-[data-dev-preview] {
-  --background: 0 0% 100%;
-  --foreground: 0 0% 4%;
-  --card: 0 0% 100%;
-  --card-foreground: 0 0% 4%;
-  --popover: 0 0% 100%;
-  --popover-foreground: 0 0% 4%;
-  --primary: 0 0% 9%;
-  --primary-foreground: 0 0% 98%;
-  --secondary: 240 5% 96%;
-  --secondary-foreground: 0 0% 9%;
-  --muted: 240 5% 96%;
-  --muted-foreground: 240 4% 46%;
-  --accent: 240 5% 96%;
-  --accent-foreground: 0 0% 9%;
-  --destructive: 0 84% 60%;
-  --destructive-foreground: 0 0% 98%;
-  --border: 240 6% 90%;
-  --input: 240 6% 90%;
-  --ring: 0 0% 4%;
-  --radius: 0.5rem;
-}

package/dist/scaffolds/notis-database/app/layout.tsx

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