@notis_ai/cli 0.2.13 → 0.2.15

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

@@ -25,7 +25,21 @@ export type DatabasePropertyType =
   | 'status'
   | 'relation'
   | 'formula'
-  | 'files';
+  | 'files'
+  | 'secret';
+
+/**
+ * The value of a `secret` property. The platform stores a pointer to a
+ * credential held elsewhere and never the credential itself, so there is
+ * deliberately nothing here to read the secret material from — only whether
+ * one is attached, which credential it is, and its lifecycle state.
+ */
+export interface SecretPropertyValue {
+  present: boolean;
+  reference: string | null;
+  status: string | null;
+  metadata: Record<string, unknown> | null;
+}
 
 export interface DatabasePropertyOption {
   id?: string | null;
@@ -57,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;
@@ -72,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;
 }
@@ -88,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
 // ---------------------------------------------------------------------------
@@ -155,6 +180,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
 // ---------------------------------------------------------------------------
@@ -175,6 +231,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
@@ -182,12 +270,91 @@ export interface NotisDocumentEditorProps {
  */
 export interface NotisRuntimeUI {
   DocumentEditor?: ComponentType<NotisDocumentEditorProps>;
+  MarkdownEditor?: ComponentType<NotisMarkdownEditorProps>;
 }
 
 // ---------------------------------------------------------------------------
 // NotisRuntime
 // ---------------------------------------------------------------------------
 
+/**
+ * Options for `NotisRuntime.subscribeDatabase`.
+ */
+export interface SubscribeDatabaseOptions {
+  /**
+   * Called with `true` once a live change feed is attached, and with `false`
+   * when it drops or is torn down. Hosts without a change feed (dev harness,
+   * screenshot stub, vite preview) never call it, so `live` stays false there.
+   */
+  onStatusChange?: (live: boolean) => void;
+}
+
+/**
+ * Work an app hands to the Notis manager chat through `NotisRuntime.handover`.
+ */
+export interface HandoverPayload {
+  /** 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.
+   */
+  skill?: string;
+  /**
+   * Accepted for forward compatibility. The portal never submits a composer on
+   * the user's behalf today, so every handover resolves `drafted`; `sent` is
+   * reserved for a host that can genuinely dispatch the run.
+   */
+  autoSend?: boolean;
+}
+
+export interface HandoverResult {
+  /** `drafted` when the user still has to press send, `sent` when it went straight through. */
+  status: 'drafted' | 'sent';
+}
+
+/**
+ * The user's cloud computer, as far as an app may see it.
+ *
+ * `exists` is false when the user has never had a sandbox provisioned. A
+ * `status` of anything other than `'running'` means the VM is asleep; reading
+ * these facts never wakes it.
+ */
+export interface CloudComputerSandboxFacts {
+  exists: boolean;
+  status: string | null;
+  provider: string | null;
+  created_at: string | null;
+  updated_at: string | null;
+}
+
+/**
+ * Whether a CLI inside the cloud computer is signed in.
+ *
+ * `authenticated: null` means *unknown*, never *signed out*: the sandbox was
+ * not running, or the probe could not answer. `reason` says which
+ * (`'sandbox_not_running'`, `'no_sandbox'`, `'sandbox_status_unknown'`,
+ * `'probe_failed'`, `'not_signed_in'`).
+ */
+export interface CloudComputerCliAuthFacts {
+  authenticated: boolean | null;
+  account: string | null;
+  checked_at: string | null;
+  reason: string | null;
+}
+
+export interface CloudComputerFacts {
+  /**
+   * False when this host cannot answer at all — no cloud computer on the user's
+   * plan, or the platform could not resolve the facts. Render whatever the app
+   * did before rather than an error.
+   */
+  available: boolean;
+  reason?: string | null;
+  sandbox: CloudComputerSandboxFacts | null;
+  cli_auth: { gh: CloudComputerCliAuthFacts };
+}
+
 export interface NotisRuntime {
   app: AppDescriptor;
   route: RouteDescriptor;
@@ -195,6 +362,51 @@ 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.
+   *
+   * The change notification is only a signal — it carries no rows. Consumers
+   * react by refetching through the normal tool path, so app scoping,
+   * permissions and billing are unchanged. Use the `useDatabaseSubscription`
+   * hook rather than calling this directly.
+   */
+  subscribeDatabase?(
+    slug: string,
+    onChange: () => void,
+    options?: SubscribeDatabaseOptions,
+  ): () => void;
+
+  /**
+   * Hand a piece of work to the Notis manager chat. The app cannot run an
+   * agent itself: it describes the job, and the manager surface owns progress,
+   * billing, cancellation and the transcript. Results come back to the app
+   * through its own databases (see `useDatabaseSubscription`).
+   *
+   * Use the `useHandover` hook rather than calling this directly. Hosts
+   * without a manager chat (the dev harness, the vite preview) leave it
+   * undefined, so keep whatever fallback the app already offers.
+   */
+  handover?(payload: HandoverPayload): Promise<HandoverResult>;
+
+  /**
+   * Read-only facts about the user's cloud computer. Requires
+   * `capabilities.cloudComputer: 'read'` in `notis.config.ts` plus the user's
+   * approval; resolving it never creates, resumes or commands a sandbox.
+   *
+   * Use the `useCloudComputer` hook rather than calling this directly. Hosts
+   * without a cloud computer (the dev harness, the vite preview) answer
+   * `{ available: false }`, so keep whatever fallback the app already has.
+   * `{ refresh: true }` bypasses the host's short answer cache — the hook's
+   * refresh() sends it so a just-completed sign-in becomes visible.
+   */
+  cloudComputerFacts?(options?: { refresh?: boolean }): Promise<CloudComputerFacts>;
+
   navigate?: (payload: { kind: string; [key: string]: unknown }) => void;
 
   registerTopBarSearch?: (
@@ -210,7 +422,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;
-}