@notis_ai/cli 0.2.14 → 0.2.16

package/template/packages/sdk/src/components/MultiSelectDragOverlay.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { type CSSProperties, type ReactElement } from 'react';
+import React, { type CSSProperties, type ReactElement } from 'react';
 import type { DragRect } from '../hooks/useMultiSelect';
 
 export interface MultiSelectDragOverlayProps {

package/template/packages/sdk/src/components/NotisSelectionBoundary.tsx

@@ -0,0 +1,55 @@
+import type { CSSProperties, ClipboardEvent, ReactNode } from 'react';
+import { useCallback } from 'react';
+import { useNotisRuntime } from '../provider';
+import type { ContextResource, ContextSelection } from '../runtime';
+
+export const NOTIS_CONTEXT_CLIPBOARD_TYPE = 'application/x-notis-context+json';
+
+export interface NotisSelectionBoundaryProps {
+  resource?: ContextResource | null;
+  children: ReactNode;
+  className?: string;
+  style?: CSSProperties;
+}
+
+function selectionId(): string {
+  return typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
+    ? crypto.randomUUID()
+    : `selection-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+
+/**
+ * Adds structured provenance to ordinary copied text. Pasting still works in
+ * every app because `text/plain` is preserved; Notis chat additionally reads
+ * the custom MIME payload and renders a separate quote pill.
+ */
+export function NotisSelectionBoundary({
+  resource,
+  children,
+  className,
+  style,
+}: NotisSelectionBoundaryProps) {
+  const runtime = useNotisRuntime();
+  const onCopy = useCallback((event: ClipboardEvent<HTMLDivElement>) => {
+    const selection = window.getSelection();
+    const text = selection?.toString().trim() ?? '';
+    if (
+      !text
+      || !selection
+      || !event.currentTarget.contains(selection.anchorNode)
+      || !event.currentTarget.contains(selection.focusNode)
+    ) return;
+
+    const payload: ContextSelection = {
+      id: selectionId(),
+      text: text.slice(0, 12_000),
+      ...(resource ? { resource: { ...resource, snapshot: undefined } } : {}),
+    };
+    event.clipboardData.setData('text/plain', text);
+    event.clipboardData.setData(NOTIS_CONTEXT_CLIPBOARD_TYPE, JSON.stringify(payload));
+    event.preventDefault();
+    runtime?.captureContextSelection?.(payload);
+  }, [resource, runtime]);
+
+  return <div className={className} style={style} onCopy={onCopy}>{children}</div>;
+}

package/template/packages/sdk/src/components/ShortcutHints.tsx

@@ -0,0 +1,56 @@
+'use client';
+
+import React, { type CSSProperties, type ReactElement } from 'react';
+import { shortcutDisplay } from '../interactions/shortcuts';
+
+export interface ShortcutHint {
+  id: string;
+  keys: string;
+  label: string;
+}
+
+export interface ShortcutHintsProps {
+  shortcuts: ShortcutHint[];
+  className?: string;
+  style?: CSSProperties;
+}
+
+const listStyle: CSSProperties = {
+  display: 'flex',
+  flexWrap: 'wrap',
+  alignItems: 'center',
+  gap: '0.75rem',
+  color: 'hsl(var(--muted-foreground))',
+  fontSize: '12px',
+};
+
+const hintStyle: CSSProperties = {
+  display: 'inline-flex',
+  alignItems: 'center',
+  gap: '0.35rem',
+};
+
+const keyStyle: CSSProperties = {
+  minWidth: '20px',
+  border: '1px solid hsl(var(--border))',
+  borderRadius: '4px',
+  background: 'hsl(var(--muted))',
+  color: 'hsl(var(--foreground))',
+  padding: '1px 5px',
+  textAlign: 'center',
+  font: 'inherit',
+};
+
+export function ShortcutHints({ shortcuts, className, style }: ShortcutHintsProps): ReactElement | null {
+  if (shortcuts.length === 0) return null;
+  return (
+    <div aria-label="Keyboard shortcuts" className={className} style={{ ...listStyle, ...style }}>
+      {shortcuts.map((shortcut) => (
+        <span key={shortcut.id} style={hintStyle}>
+          <kbd style={keyStyle}>{shortcutDisplay(shortcut.keys)}</kbd>
+          <span>{shortcut.label}</span>
+        </span>
+      ))}
+    </div>
+  );
+}

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

@@ -40,6 +40,12 @@ export interface NotisRouteConfig {
   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;
@@ -174,9 +180,26 @@ export interface NotisAppCapabilities {
   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;
@@ -218,6 +241,8 @@ export interface NotisAppConfig {
    * 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. */

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

@@ -107,7 +107,7 @@ export function normalizePropertyValue(value: unknown): unknown {
 }
 
 function normalizeContentType(value: unknown): DocumentContentType | null {
-  return value === 'markdown' || value === 'file' ? value : null;
+  return value === 'markdown' || value === 'file' || value === 'view' ? value : null;
 }
 
 /**
@@ -140,6 +140,12 @@ export function normalizeDocumentRecord(value: unknown): DocumentRecord {
         : null,
     contentMarkdown: optionalString(record.contentMarkdown) ?? optionalString(record.content_markdown),
     plainText: optionalString(record.plainText) ?? optionalString(record.plain_text),
+    viewType: optionalString(record.viewType) ?? optionalString(record.view_type),
+    viewState: asRecord(record.viewState) ?? asRecord(record.view_state),
+    viewRevision:
+      typeof (record.viewRevision ?? record.view_revision) === 'number'
+        ? Number(record.viewRevision ?? record.view_revision)
+        : null,
     createdAt:
       optionalString(record.createdAt)
       ?? optionalString(record.created_at)

package/template/packages/sdk/src/hooks/useActiveResource.ts

@@ -0,0 +1,19 @@
+import { useEffect, useMemo } from 'react';
+import { useNotisRuntime } from '../provider';
+import type { ContextResource } from '../runtime';
+
+function stableResource(resource: ContextResource | null): string {
+  return JSON.stringify(resource);
+}
+
+/** Keep Notis aware of the resource currently open inside an app view. */
+export function useActiveResource(resource: ContextResource | null): void {
+  const runtime = useNotisRuntime();
+  const signature = stableResource(resource);
+  const stable = useMemo(() => resource, [signature]);
+
+  useEffect(() => {
+    runtime?.publishActiveResource?.(stable);
+    return () => runtime?.publishActiveResource?.(null);
+  }, [runtime, stable]);
+}