@xnetjs/plugins 1.0.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,10 +1,10 @@
1
1
  import * as _xnetjs_data from '@xnetjs/data';
2
2
  import { SchemaIRI, NodeStore, NodeState, NodeQueryDescriptor, NodeQueryResult } from '@xnetjs/data';
3
- import { Extension } from '@tiptap/core';
4
3
  import { ComponentType } from 'react';
5
4
  import { PublicWriteBudgetPolicy, AbuseSurface, AISignalProvenanceInput } from '@xnetjs/abuse';
6
5
  import { InstallProvenance, TrustTier } from '@xnetjs/trust';
7
6
  export { InstallProvenance, TrustTier as PluginTrustTier, SandboxKind, deriveTrustTier, requiresCapabilityReprompt, sandboxForTier } from '@xnetjs/trust';
7
+ import * as Y from 'yjs';
8
8
 
9
9
  /**
10
10
  * Core types for the plugin system
@@ -366,30 +366,31 @@ interface SlashCommandContext {
366
366
  };
367
367
  }
368
368
  /**
369
- * Toolbar button contribution for the editor
369
+ * Editor contribution (re-typed for the BlockNote editor, 0312).
370
+ *
371
+ * Plugins contribute BlockNote specs — `createReactBlockSpec` /
372
+ * `createReactInlineContentSpec` / `createReactStyleSpec` results keyed by
373
+ * spec name — plus behavior-only slash menu items. Spec values are opaque
374
+ * here so this package needs no editor dependency.
375
+ *
376
+ * SCHEMA-SKEW WARNING (0205): block/inline/style specs define the
377
+ * PERSISTED document schema. Under Yjs collaboration every peer must run
378
+ * the identical schema; a spec only some peers have silently drops
379
+ * content. `editor-schema-safety.ts` flags specs that aren't statically
380
+ * bundled in @xnetjs/editor's schema.
370
381
  */
371
- interface ToolbarContribution {
372
- /** Icon name (Lucide) or React component */
373
- icon: string | ComponentType;
374
- /** Tooltip/title text */
375
- title: string;
376
- /** Toolbar section: format, insert, block, or custom */
377
- group?: 'format' | 'insert' | 'block' | 'custom';
378
- /** Check if button should appear active */
379
- isActive?: (editor: unknown) => boolean;
380
- /** Button click handler */
381
- action: (editor: unknown) => void;
382
- /** Keyboard shortcut display (e.g., 'Mod-Shift-H') */
383
- shortcut?: string;
384
- }
385
382
  interface EditorContribution {
386
- /** Unique extension ID */
383
+ /** Unique contribution ID */
387
384
  id: string;
388
- /** TipTap extension (Extension, Node, or Mark) */
389
- extension: Extension;
390
- /** Optional toolbar button for this extension */
391
- toolbar?: ToolbarContribution;
392
- /** Priority for extension ordering (lower = earlier, default: 100) */
385
+ /** BlockNote block specs, keyed by block type name (skew-sensitive) */
386
+ blockSpecs?: Record<string, unknown>;
387
+ /** BlockNote inline content specs, keyed by type name (skew-sensitive) */
388
+ inlineContentSpecs?: Record<string, unknown>;
389
+ /** BlockNote style specs, keyed by style name (skew-sensitive) */
390
+ styleSpecs?: Record<string, unknown>;
391
+ /** Behavior-only slash menu items (skew-safe) */
392
+ slashMenuItems?: SlashCommandContribution[];
393
+ /** Priority for ordering (lower = earlier, default: 100) */
393
394
  priority?: number;
394
395
  }
395
396
  /**
@@ -1654,42 +1655,44 @@ declare function getCommandRegistry(): CommandRegistry;
1654
1655
  declare function installCommandHandler(): () => void;
1655
1656
 
1656
1657
  /**
1657
- * Editor schema-skew guard for plugin contributions (exploration 0205).
1658
+ * Editor schema-skew guard for plugin contributions (exploration 0205,
1659
+ * re-based on BlockNote specs in 0312).
1658
1660
  *
1659
- * A plugin editor contribution whose TipTap extension is a Node or Mark changes
1660
- * the PERSISTED document schema. Under Yjs collaboration, if some collaborators
1661
- * have the plugin and others don't, ProseMirror silently drops the unknown
1662
- * content and the corruption syncs without any error. Behavior-only extensions
1663
- * (commands, keymaps, decorations, slash items) are skew-safe.
1661
+ * A plugin editor contribution that registers block/inline/style SPECS
1662
+ * changes the PERSISTED document schema. Under Yjs collaboration, if some
1663
+ * collaborators have the plugin and others don't, the unknown content is
1664
+ * silently dropped and the corruption syncs without any error.
1665
+ * Behavior-only contributions (slash menu items) are skew-safe.
1664
1666
  *
1665
- * This module classifies a plugin's editor contributions so the registry can
1666
- * warn loudly in development. It mirrors `@xnetjs/editor`'s extension-tiers
1667
- * classifier but lives here so the plugins package needs no editor dependency.
1667
+ * The rule since 0312: schema specs must be statically bundled in
1668
+ * @xnetjs/editor's schema (its `XNET_SCHEMA_SPEC_NAMES` lists them). A
1669
+ * plugin may contribute a spec only when it's one of those bundled names
1670
+ * (gating the UI affordance, not the schema); anything else is flagged.
1668
1671
  */
1669
1672
 
1670
1673
  interface EditorSchemaRisk {
1671
1674
  /** The contribution id. */
1672
1675
  id: string;
1673
- /** 'node' | 'mark' (the skew-sensitive kinds). */
1676
+ /** 'block' | 'inlineContent' | 'style' (the skew-sensitive kinds). */
1674
1677
  kind: string;
1675
- /** The TipTap extension name. */
1678
+ /** The spec name. */
1676
1679
  name: string;
1677
1680
  }
1678
- /** True if the extension defines persisted document schema (a Node or Mark). */
1679
- declare function isSchemaDefiningExtension(ext: {
1680
- type?: string;
1681
- }): boolean;
1681
+ /** True if the contribution registers any persisted-schema specs. */
1682
+ declare function isSchemaDefiningContribution(contribution: EditorContribution): boolean;
1682
1683
  /**
1683
- * Of a plugin's editor contributions, return those that add persisted schema
1684
- * and therefore risk silent Yjs content loss across version skew. Empty array
1685
- * means the contributions are skew-safe.
1684
+ * Of a plugin's editor contributions, return the specs that add persisted
1685
+ * schema NOT statically bundled by the host editor (`bundledSpecNames`),
1686
+ * and therefore risk silent Yjs content loss across version skew. Empty
1687
+ * array means the contributions are skew-safe.
1686
1688
  */
1687
- declare function findEditorSchemaRisks(contributions: readonly EditorContribution[]): EditorSchemaRisk[];
1689
+ declare function findEditorSchemaRisks(contributions: readonly EditorContribution[], bundledSpecNames?: readonly string[]): EditorSchemaRisk[];
1688
1690
  /**
1689
- * Warn (in development) when a plugin's editor contributions add schema. Returns
1690
- * the detected risks so callers can also gate or surface them.
1691
+ * Warn (in development) when a plugin's editor contributions add schema
1692
+ * beyond the host's bundled specs. Returns the detected risks so callers
1693
+ * can also gate or surface them.
1691
1694
  */
1692
- declare function warnOnEditorSchemaRisks(pluginId: string, contributions: readonly EditorContribution[]): EditorSchemaRisk[];
1695
+ declare function warnOnEditorSchemaRisks(pluginId: string, contributions: readonly EditorContribution[], bundledSpecNames?: readonly string[]): EditorSchemaRisk[];
1693
1696
 
1694
1697
  /**
1695
1698
  * @xnetjs/plugins — the Connector primitive (exploration 0196).
@@ -1999,7 +2002,12 @@ type AiPageMarkdownApplyAdapterInput = {
1999
2002
  operation: AiOperation;
2000
2003
  };
2001
2004
  type AiPageMarkdownApplyAdapterResult = {
2002
- mode: 'tiptap-yjs' | 'yjs' | 'custom';
2005
+ /**
2006
+ * `blocknote-yjs` = applied into the BlockNote `content-v4` fragment
2007
+ * (see `createBlockNotePageMarkdownAdapter`); `yjs` = another Yjs-backed
2008
+ * document shape; `custom` = host-specific.
2009
+ */
2010
+ mode: 'blocknote-yjs' | 'yjs' | 'custom';
2003
2011
  yjsField?: string;
2004
2012
  documentUpdate?: unknown;
2005
2013
  warnings?: string[];
@@ -2011,7 +2019,7 @@ type AiPageMarkdownApplyResult = {
2011
2019
  applied: boolean;
2012
2020
  pageId: string;
2013
2021
  planId: string;
2014
- mode: 'tiptap-yjs' | 'yjs' | 'custom' | 'node-property';
2022
+ mode: 'blocknote-yjs' | 'yjs' | 'custom' | 'node-property';
2015
2023
  baseRevision: string;
2016
2024
  liveRevision: string;
2017
2025
  markdownHash: string;
@@ -2281,6 +2289,77 @@ declare function stripXNetPageFrontmatter(markdown: string): string;
2281
2289
  declare function renderMarkdownLineDiff(before: string, after: string): string;
2282
2290
  declare function renderMarkdownReviewDiff(before: string, after: string): XNetMarkdownReviewDiff;
2283
2291
 
2292
+ /**
2293
+ * Yjs-fragment ↔ markdown conversion for AI page projections (0312).
2294
+ *
2295
+ * v4 pages persist BlockNote's ProseMirror schema in the Y.XmlFragment
2296
+ * `content-v4`: the fragment holds one `blockGroup`, each block is a
2297
+ * `blockContainer` (with a unique `id` attribute) wrapping one blockContent
2298
+ * element (paragraph/heading/…) plus an optional nested `blockGroup` of
2299
+ * child blocks. v3 and earlier documents live in the legacy `content`
2300
+ * fragment (TipTap schema) and are read-only here.
2301
+ *
2302
+ * Both directions walk the Yjs XML tree directly — no editor, DOM, or
2303
+ * BlockNote dependency — mirroring the dependency-light approach of the
2304
+ * editor package's lazy legacy importer. The write path covers the markdown
2305
+ * subset AI agents emit (paragraphs, headings, bullet/numbered/check lists,
2306
+ * fenced code, quotes, callouts, wikilinks); reading is broader and degrades
2307
+ * unknown blocks to text, like the legacy importer.
2308
+ */
2309
+
2310
+ /** The Y.XmlFragment field that holds v4 (BlockNote) page documents. */
2311
+ declare const XNET_PAGE_FRAGMENT_FIELD = "content-v4";
2312
+ /** The legacy (TipTap, v3 and below) fragment field, read as a fallback. */
2313
+ declare const XNET_PAGE_LEGACY_FRAGMENT_FIELD = "content";
2314
+ type XNetPageFragmentReadOptions = {
2315
+ /** BlockNote fragment field. Defaults to `content-v4`. */
2316
+ field?: string;
2317
+ /** Legacy TipTap fragment field read when the v4 fragment is empty. */
2318
+ legacyField?: string;
2319
+ };
2320
+ /** Convert a BlockNote (`content-v4`) fragment to markdown. */
2321
+ declare function blockNoteFragmentToMarkdown(fragment: Y.XmlFragment): string;
2322
+ /** Convert a legacy TipTap (`content`) fragment to markdown (lossy). */
2323
+ declare function legacyFragmentToMarkdown(fragment: Y.XmlFragment): string;
2324
+ /**
2325
+ * Read a page Y.Doc as markdown: the BlockNote `content-v4` fragment when it
2326
+ * has content, otherwise the legacy TipTap `content` fragment.
2327
+ */
2328
+ declare function xnetPageFragmentToMarkdown(doc: Y.Doc, options?: XNetPageFragmentReadOptions): string;
2329
+ type XNetPageFragmentWriteOptions = {
2330
+ /** BlockNote fragment field. Defaults to `content-v4`. */
2331
+ field?: string;
2332
+ /** Block id factory (BlockNote requires a unique `id` per blockContainer). */
2333
+ generateBlockId?: () => string;
2334
+ };
2335
+ /**
2336
+ * Replace a page's BlockNote fragment with the given markdown (the AI apply
2337
+ * path). Runs in a single Yjs transaction; every blockContainer gets a fresh
2338
+ * unique id. Covers the AI markdown subset: paragraphs, headings,
2339
+ * bullet/numbered/check lists (2-space nesting), fenced code, quotes,
2340
+ * `> [!kind]` callouts, and `[[wikilinks]]`. Anything else lands as
2341
+ * paragraph text — never dropped.
2342
+ */
2343
+ declare function replaceXNetPageFragmentWithMarkdown(doc: Y.Doc, markdown: string, options?: XNetPageFragmentWriteOptions): void;
2344
+ /** Resolves the live (or loaded) Y.Doc for a page node id. */
2345
+ type XNetPageDocResolver = (pageId: string) => Promise<Y.Doc | null> | Y.Doc | null;
2346
+ type BlockNotePageMarkdownAdapterOptions = {
2347
+ resolveDoc: XNetPageDocResolver;
2348
+ /** BlockNote fragment field. Defaults to `content-v4`. */
2349
+ field?: string;
2350
+ generateBlockId?: () => string;
2351
+ };
2352
+ /**
2353
+ * The BlockNote/Yjs `AiPageMarkdownApplyAdapter` (replaces the TipTap-era
2354
+ * document bridge): applies validated AI markdown plans into the page's
2355
+ * `content-v4` fragment, and reads pages back out of it. Hosts wire
2356
+ * `resolveDoc` to their document store; without an adapter the AI surface
2357
+ * falls back to the `markdown` node property.
2358
+ */
2359
+ declare function createBlockNotePageMarkdownAdapter(options: BlockNotePageMarkdownAdapterOptions): AiPageMarkdownApplyAdapter & {
2360
+ readMarkdown: (pageId: string) => Promise<string | null>;
2361
+ };
2362
+
2284
2363
  /**
2285
2364
  * Write guardrail for the MCP server (exploration 0175, "boundary hardening").
2286
2365
  *
@@ -6056,4 +6135,4 @@ declare function leaveWithEverything(ports: RightToLeavePorts, opts: {
6056
6135
  */
6057
6136
  declare function deleteDay(ports: RightToLeavePorts, opts: DeleteDayOptions): Promise<DeleteDayResult>;
6058
6137
 
6059
- export { type AIComplexityLevel, type AICostModel, type AIGenerateRequest, type AIGenerateResponse, AIGenerationError, type AIMessage, type AIMessageRole, type AIModelCapabilities, type AIModelQuality, type AIPrivacyLevel, type AIProvider, type AIProviderConfig, type AIProviderOptions, AIProviderRouter, type AIProviderRouterOptions, type AIProviderType, type AIProviderUsage, AIRTABLE_CONNECTOR_ID, type AIRiskLevel, type AIScriptRequest, type AIScriptResponse, type AIStreamChunk, type AIToolCall, type AIToolSpec, type AIUsage, AI_GENERATED_PROVENANCE, AI_RISK_LEVELS, AI_SCOPES, AI_TARGET_KINDS, ALLOWED_PLUGIN_LICENSES, type ActionContext, type ActionDefinition, ActionDefinitionError, ActionDispatchError, type ActionEvent, ActionSsrfError, type ActionTrigger, type AgentToolContribution, type AgentToolInputSchema, type AiAgentApproval, type AiAgentApprovalRequestInput, type AiAgentApprovalResolveInput, type AiAgentApprovalStatus, type AiAgentBackgroundJob, type AiAgentBackgroundJobInput, type AiAgentBackgroundJobRunner, type AiAgentBackgroundJobStatus, type AiAgentDisplayState, type AiAgentDisplayStateKind, type AiAgentEvent, type AiAgentEventType, type AiAgentOrchestratorMode, type AiAgentRunSelectionTurnInput, type AiAgentRunTurnInput, type AiAgentRunTurnResult, AiAgentRuntime, type AiAgentRuntimeConfig, type AiAgentRuntimeListener, type AiAgentRuntimeSnapshot, type AiAgentRuntimeStorage, type AiAgentSelectionContext, type AiAgentSelectionKind, type AiAgentTelemetrySnapshot, type AiAgentThread, type AiAgentThreadCreateInput, type AiAgentThreadStatus, type AiAgentTurn, type AiAgentTurnRole, type AiAgentTurnStatus, type AiAssistMode, type AiAuditEvent, type AiAuthoredPlugin, AiAuthoringError, AiBudgetError, type AiCallableTool, type AiChangeSet, type AiCommandExposure, type AiContextPack, type AiContextPackResource, type AiContextRetriever, type AiContextSeed, type AiDatabaseMutationApplyResult, type AiExtraTool, type AiJsonSchema, type AiJsonSchemaType, type AiMutationPlan, type AiMutationPlanStatus, type AiOperation, type AiPageMarkdownApplyAdapter, type AiPageMarkdownApplyAdapterInput, type AiPageMarkdownApplyAdapterResult, type AiPageMarkdownApplyResult, type AiPageMarkdownRollbackResult, type AiPluginPipelineInput, type AiPluginPipelinePorts, type AiPluginPipelineResult, type AiResource, type AiResourceContent, type AiRetrievedNode, type AiRiskLevel, type AiScope, type AiSearchOptions, type AiSearchResult, type AiSurfaceLimits, AiSurfaceService, type AiSurfaceServiceConfig, type AiTargetKind, type AiToolCallResult, type AiToolDefinition, type AiValidationResult, type AirtableConnectorOptions, type AllowedPluginLicense, AnthropicProvider, type ArrayHelpers, type BlockContribution, type BlockProps, CANVAS_PLUGIN_FIXTURES, CHANNEL_SCHEMA, CHAT_MESSAGE_SCHEMA, CONNECTOR_CATEGORY, CONNECTOR_META, CRM_CANVAS_PLUGIN_FIXTURE, type CanvasCardContribution, type CanvasContribution, type CanvasContributionBase, type CanvasContributionPermission, type CanvasEdgeContribution, type CanvasErpPrototypeAuditEntry, type CanvasErpPrototypeAuditOperation, type CanvasErpPrototypeAuditSource, type CanvasErpPrototypeCard, type CanvasErpPrototypeCommand, type CanvasErpPrototypeEdge, type CanvasErpPrototypeEntityKind, type CanvasErpPrototypeLayoutKind, type CanvasErpPrototypeQueryFrame, type CanvasErpPrototypeQueryPredicate, type CanvasErpPrototypeRect, type CanvasErpPrototypeRisk, type CanvasErpPrototypeRiskSummary, type CanvasErpPrototypeScenario, type CanvasErpPrototypeStatus, type CanvasIngestInputKind, type CanvasIngestorContribution, type CanvasInspectorContribution, type CanvasInspectorPlacement, type CanvasLayoutContribution, type CanvasLayoutScope, type CanvasPluginFixture, type CanvasPluginFixtureCardSample, type CanvasPluginFixtureKind, type CanvasPluginPermissionDecisionStatus, type CanvasPluginPermissionGateDecision, type CanvasPluginPermissionGateInput, type CanvasPluginPermissionPrompt, type CanvasPluginPermissionPromptOption, type CanvasPluginPromptMode, type CanvasPluginSandboxDecision, type CanvasPluginSandboxDomAccess, type CanvasPluginSandboxKind, type CanvasPluginSandboxMutationAccess, type CanvasPluginSandboxNetworkAccess, type CanvasPluginSandboxOutput, type CanvasPluginSandboxOutputKind, type CanvasPluginSandboxOutputValidation, type CanvasPluginSandboxPolicy, type CanvasPluginSandboxRequest, type CanvasPluginWorkspacePolicy, type CanvasPreviewTier, type CanvasRendererSandboxContribution, type CanvasTemplateCategory, type CanvasTemplateContribution, type CanvasToolContribution, type CanvasToolGroup, CapabilityError, type ChromePosture, type CommandContext, type CommandContribution, CommandRegistry, type CommandScope, type ConnectorArtifacts, type ConnectorCadence, type ConnectorDefinition, ConnectorDefinitionError, type ConnectorDetection, type ConnectorEnv, type ConnectorFetch, type ConnectorInstallGate, type ConnectorStore, type ConnectorSyncContext, ConnectorSyncError, type ConnectorSyncResult, type ConnectorSyncSpec, type ConnectorTier, type ConnectorToolDescriptor, type ConsentDecision, type ConsentLine, ContributionRegistry, DEFAULT_PLUGIN_LICENSE, DEFAULT_WORKSPACE_ID, type DefinedAction, type DefinedConnector, type DeleteDayOptions, type DeleteDayResult, type DeliveryResult, DependencyCycleError, type DependencyNode, type Disposable$1 as Disposable, ERP_CANVAS_PLUGIN_FIXTURE, EXTERNAL_ITEM_SCHEMA, type EditorContribution, type EditorSchemaRisk, type EmailActionOptions, type ExtensionContext, type ExtensionStorage, FEED_ITEM_SCHEMA, type FeatureModule, type FeedEntry, type FetchJson, type FetchLike, type FlatNode, type FormatHelpers, GITHUB_CONNECTOR_ID, GOOGLE_CALENDAR_CONNECTOR_ID, type GeneratedScript, type GithubConnectorOptions, type GuardableConnectorStore, type IProcessManager, type ImporterContribution, type InstallOptions, LEAVE_README, LINEAR_CONNECTOR_ID, type LabRunOutcome, type LadderRuntimeTier, type LanguageModelLike, type LanguageModelMonitor, type LanguageModelSessionLike, type LayoutTree, type LeaveBundle, type LicenseCheckResult, LicenseRequiredError, type LinearConnectorOptions, type LocalAPIConfig, type LocalAPITokenConfig, type LocalAPITokenScope, type LocalAPITokenSummary, type LocalServerProbe, MARKETPLACE_PROVENANCE, type MCPPropertySchema, type MCPRequest, type MCPResource, type MCPResponse, type MCPServerConfig, type MCPTool, MEDIA_PROVIDER_CANVAS_PLUGIN_FIXTURE, type ManagedBudgetSnapshot, ManagedProvider, type ManagedProviderOptions, MarketplaceClient, type MarketplaceClientOptions, type MarketplaceEntry, type MarketplaceSort, type MathHelpers, type MentionProviderContribution, type MentionSuggestion, MiddlewareChain, type MissingDependency, type ModuleCapabilities, NOTION_CONNECTOR_ID, type NodeChangeEvent, type NodeChangeEventData, type NodeData, type NodeStoreAPI, type NodeStoreMiddleware, type NotionConnectorOptions, OllamaProvider, OpenAICompatibleProvider, type OpenAICompatibleProviderOptions, OpenAIProvider, PRESET_IDS, PRESET_WORKSPACE_ID_PREFIX, type PendingChange, type Platform, type PlatformCapabilities, type PluginContributions, PluginError, type PluginNode, type PluginNodeChangeEvent, type PluginNodeChangeListener, type PluginPermissions, type PluginPricing, type PluginRating, PluginRegistry, type PluginRunInput, type PluginRunResult, PluginRuntimeError, type PluginRuntimeLadder, PluginSchema, type PluginStatus, PluginValidationError, type PresetId, type ProcessManagerEvents, type PromptApiAvailability, PromptApiProvider, type PromptApiProviderOptions, type PropertyCellProps, type PropertyEditorProps, type PropertyHandler, type PropertyHandlerContribution, type Provenance, type ProvenanceResult, type ProvenanceVerifier, type QueryFilter, REGION_IDS, RSS_CONNECTOR_ID, type RatingSummary, type RecommendOptions, type RegionId, type RegisteredPlugin, type ResolveMentionOptions, type RightToLeavePorts, type RssConnectorOptions, type RunActionPorts, type RunConnectorSyncPorts, type RunPluginCodeInput, SCAFFOLD_SYSTEM_GUARD, SERVICE_IPC_CHANNELS, SLACK_CONNECTOR_ID, type SandboxOptions, ScaffoldError, type ScaffoldResult, type ScaffoldSpec, type ScaffoldTemplate, type SchemaContribution, type SchemaData, type SchemaDefinition, type SchemaProperty, type SchemaRegistryAPI, type ScriptContext, ScriptError, type ScriptExecutionResult, type ScriptExecutor, ScriptGenerationError, ScriptGenerator, type ScriptGeneratorOptions, type ScriptNode, type ScriptNodeChangeEvent, type ScriptOutputType, ScriptRunner, type ScriptRunnerOptions, ScriptSandbox, ScriptSchema, type ScriptStore, ScriptTimeoutError, type ScriptToManifestInput, type ScriptTriggerType, ScriptValidationError, type SemVer, type ServiceClient, type ServiceCommunication, type ServiceDefinition, type ServiceHealthCheck, type ServiceLifecycle, type ServiceOutputEvent, type ServiceProcessConfig, type ServiceProvides, type ServiceState, type ServiceStatus, type ServiceStatusEvent, type SettingContribution, type SettingsPanelProps, ShortcutManager, type SidebarContribution, type SlackConnectorOptions, type SlashCommandContext, type SlashCommandContribution, type SlotContribution, type SlotPlacement, type SlotRegion, type SlotTier, type StatusBarContribution, type SurfaceDockContribution, type SurfaceDockTier, type TelemetryReporter, type TestHarnessOptions, type TestNodeStore, type TestPluginHarness, type TextHelpers, type ToolCallingFidelity, type ToolbarContribution, TypedRegistry, type UsageSignal, type ValidationResult, type VerifyProvenanceInput, type ViewContribution, type ViewProps, type WebLLMEngineLike, WebLLMProvider, type WebLLMProviderOptions, type WebhookConfig, WebhookEmitter, type WebhookOutOptions, type WebhookPayload, type WidgetContribution, type WidgetContributionConfigField, type WidgetContributionProps, type WorkspaceCommand, type WorkspacePayload, type WrapCliConnectorOptions, type WriteMode, XNET_MARKDOWN_DIRECTIVE_SPECS, type XNetExtension, type XNetMarkdownDiffLine, type XNetMarkdownDiffLineKind, type XNetMarkdownDirective, type XNetMarkdownDirectiveSpec, type XNetMarkdownReviewDiff, type XNetPageMarkdownFrontmatter, type XNetPageMarkdownValidation, type XNetPageMarkdownValidationOptions, agentToolToExtraTool, agentToolsAsExtraTools, aggregateRatings, assertNetwork, assertPublicUrl, assertSchemaWrite, assertSystemAudio, assistTurnProvenance, attachAiPlanValidation, buildAirtableConnector, buildDiscordAction, buildEmailAction, buildGithubConnector, buildGoogleCalendarConnector, buildLinearConnector, buildNotionConnector, buildRetryPrompt, buildRssConnector, buildScriptPrompt, buildSlackConnector, buildSlackWebhookAction, buildTelegramAction, buildWebhookOutAction, classifyAiAgentDisplayState, compareVersions, composeAssistSystemPrompt, connectorAsImporter, connectorMarketplaceEntry, contributionsAsAiTools, createAIProvider, createAIProviderRouter, createAiAgentRuntime, createAiChangeSet, createAiOperation, createAiSurfaceService, createAiValidationResult, createCanvasErpPrototypeRiskSummary, createCanvasErpPrototypeScenario, createCanvasPluginFixtureCards, createCanvasPluginFixtureManifests, createCanvasPluginPermissionPrompt, createCanvasPluginSandboxPolicy, createCanvasPreviewSandboxRequest, createCanvasRendererSandboxRequest, createDefaultTree, createExtensionContext, createExtensionStorage, createManagedProvider, createMemoryAiAgentRuntimeStorage, createPresetTree, createPromptApiProvider, createScriptContext, createServiceClient, createTestNodeStore, createTestPluginHarness, createWebLLMProvider, createWebhookEmitter, defaultLocalServerProbes, defineAction, defineConnector, defineExtension, defineFeatureModule, deleteDay, describeCapabilities, detectConnectors, detectUpcomingMeeting, downloadPromptApiModel, emitConnectorArtifacts, evaluateCanvasPluginPermissionGate, evaluateCanvasPluginSandboxRequest, evaluateConnectorInstall, evaluateInstallConsent, executeScript, failClosedVerifier, filterByCategory, findEditorSchemaRisks, findMissingDependencies, generateScript, getCanvasErpPrototypeAuditEntriesForCard, getCanvasErpPrototypeCardsForFrame, getCanvasPluginFixture, getCommandRegistry, getPlatformCapabilities, getShortcutManager, getXNetMarkdownDirectiveSpecs, guardStore, guardedActionFetch, guardedFetch, hasUpdate, importerAdapters, insertSlot, installCommandHandler, installShortcutHandler, isAiRiskLevel, isAiScope, isAiTargetKind, isAllowedPluginLicense, isHostCompatible, isNetworkAllowed, isOllamaAvailable, isPaidPricing, isPresetWorkspaceId, isSchemaDefiningExtension, isSchemaReadAllowed, isSchemaWriteAllowed, isScriptNode, isServiceClientAvailable, isSystemAudioAllowed, ladderTierForTrust, leaveWithEverything, listOllamaModels, matchSchemaIri, moveSlot, normalizeCanvasPluginWorkspacePolicy, packageName, parseAiMutationPlan, parseFeed, parseVersion, parseWorkspacePayload, parseXNetPageFrontmatter, pascalCase, pickBestConnector, placementOf, pluginLicenseText, presetForWorkspaceId, presetWorkspaceId, probeOpenAiCompatible, promptApiAvailability, quickSafetyCheck, recommendExtensions, regionOf, renderEvent, renderMarkdownLineDiff, renderMarkdownReviewDiff, renderSelectionPrompt, resolveImporters, resolveInstallOrder, resolveMentionProviders, runAction, runAiPluginPipeline, runConnectorSync, runPluginCode, satisfiesRange, scaffoldPlugin, scriptToPluginManifest, searchMarketplace, serializeAiMutationPlan, serializeWorkspacePayload, setSlotTier, shortSchemaName, shouldDispatch, slotsIn, sortMarketplace, stripXNetPageFrontmatter, summarizeProvenance, validateAiMutationPlan, validateCanvasPluginSandboxOutput, validateManifest, validateScript, validateScriptAST, validateXNetPageMarkdown, verifyProvenance, warnOnEditorSchemaRisks, wrapCliConnector, writeModeFor };
6138
+ export { type AIComplexityLevel, type AICostModel, type AIGenerateRequest, type AIGenerateResponse, AIGenerationError, type AIMessage, type AIMessageRole, type AIModelCapabilities, type AIModelQuality, type AIPrivacyLevel, type AIProvider, type AIProviderConfig, type AIProviderOptions, AIProviderRouter, type AIProviderRouterOptions, type AIProviderType, type AIProviderUsage, AIRTABLE_CONNECTOR_ID, type AIRiskLevel, type AIScriptRequest, type AIScriptResponse, type AIStreamChunk, type AIToolCall, type AIToolSpec, type AIUsage, AI_GENERATED_PROVENANCE, AI_RISK_LEVELS, AI_SCOPES, AI_TARGET_KINDS, ALLOWED_PLUGIN_LICENSES, type ActionContext, type ActionDefinition, ActionDefinitionError, ActionDispatchError, type ActionEvent, ActionSsrfError, type ActionTrigger, type AgentToolContribution, type AgentToolInputSchema, type AiAgentApproval, type AiAgentApprovalRequestInput, type AiAgentApprovalResolveInput, type AiAgentApprovalStatus, type AiAgentBackgroundJob, type AiAgentBackgroundJobInput, type AiAgentBackgroundJobRunner, type AiAgentBackgroundJobStatus, type AiAgentDisplayState, type AiAgentDisplayStateKind, type AiAgentEvent, type AiAgentEventType, type AiAgentOrchestratorMode, type AiAgentRunSelectionTurnInput, type AiAgentRunTurnInput, type AiAgentRunTurnResult, AiAgentRuntime, type AiAgentRuntimeConfig, type AiAgentRuntimeListener, type AiAgentRuntimeSnapshot, type AiAgentRuntimeStorage, type AiAgentSelectionContext, type AiAgentSelectionKind, type AiAgentTelemetrySnapshot, type AiAgentThread, type AiAgentThreadCreateInput, type AiAgentThreadStatus, type AiAgentTurn, type AiAgentTurnRole, type AiAgentTurnStatus, type AiAssistMode, type AiAuditEvent, type AiAuthoredPlugin, AiAuthoringError, AiBudgetError, type AiCallableTool, type AiChangeSet, type AiCommandExposure, type AiContextPack, type AiContextPackResource, type AiContextRetriever, type AiContextSeed, type AiDatabaseMutationApplyResult, type AiExtraTool, type AiJsonSchema, type AiJsonSchemaType, type AiMutationPlan, type AiMutationPlanStatus, type AiOperation, type AiPageMarkdownApplyAdapter, type AiPageMarkdownApplyAdapterInput, type AiPageMarkdownApplyAdapterResult, type AiPageMarkdownApplyResult, type AiPageMarkdownRollbackResult, type AiPluginPipelineInput, type AiPluginPipelinePorts, type AiPluginPipelineResult, type AiResource, type AiResourceContent, type AiRetrievedNode, type AiRiskLevel, type AiScope, type AiSearchOptions, type AiSearchResult, type AiSurfaceLimits, AiSurfaceService, type AiSurfaceServiceConfig, type AiTargetKind, type AiToolCallResult, type AiToolDefinition, type AiValidationResult, type AirtableConnectorOptions, type AllowedPluginLicense, AnthropicProvider, type ArrayHelpers, type BlockContribution, type BlockNotePageMarkdownAdapterOptions, type BlockProps, CANVAS_PLUGIN_FIXTURES, CHANNEL_SCHEMA, CHAT_MESSAGE_SCHEMA, CONNECTOR_CATEGORY, CONNECTOR_META, CRM_CANVAS_PLUGIN_FIXTURE, type CanvasCardContribution, type CanvasContribution, type CanvasContributionBase, type CanvasContributionPermission, type CanvasEdgeContribution, type CanvasErpPrototypeAuditEntry, type CanvasErpPrototypeAuditOperation, type CanvasErpPrototypeAuditSource, type CanvasErpPrototypeCard, type CanvasErpPrototypeCommand, type CanvasErpPrototypeEdge, type CanvasErpPrototypeEntityKind, type CanvasErpPrototypeLayoutKind, type CanvasErpPrototypeQueryFrame, type CanvasErpPrototypeQueryPredicate, type CanvasErpPrototypeRect, type CanvasErpPrototypeRisk, type CanvasErpPrototypeRiskSummary, type CanvasErpPrototypeScenario, type CanvasErpPrototypeStatus, type CanvasIngestInputKind, type CanvasIngestorContribution, type CanvasInspectorContribution, type CanvasInspectorPlacement, type CanvasLayoutContribution, type CanvasLayoutScope, type CanvasPluginFixture, type CanvasPluginFixtureCardSample, type CanvasPluginFixtureKind, type CanvasPluginPermissionDecisionStatus, type CanvasPluginPermissionGateDecision, type CanvasPluginPermissionGateInput, type CanvasPluginPermissionPrompt, type CanvasPluginPermissionPromptOption, type CanvasPluginPromptMode, type CanvasPluginSandboxDecision, type CanvasPluginSandboxDomAccess, type CanvasPluginSandboxKind, type CanvasPluginSandboxMutationAccess, type CanvasPluginSandboxNetworkAccess, type CanvasPluginSandboxOutput, type CanvasPluginSandboxOutputKind, type CanvasPluginSandboxOutputValidation, type CanvasPluginSandboxPolicy, type CanvasPluginSandboxRequest, type CanvasPluginWorkspacePolicy, type CanvasPreviewTier, type CanvasRendererSandboxContribution, type CanvasTemplateCategory, type CanvasTemplateContribution, type CanvasToolContribution, type CanvasToolGroup, CapabilityError, type ChromePosture, type CommandContext, type CommandContribution, CommandRegistry, type CommandScope, type ConnectorArtifacts, type ConnectorCadence, type ConnectorDefinition, ConnectorDefinitionError, type ConnectorDetection, type ConnectorEnv, type ConnectorFetch, type ConnectorInstallGate, type ConnectorStore, type ConnectorSyncContext, ConnectorSyncError, type ConnectorSyncResult, type ConnectorSyncSpec, type ConnectorTier, type ConnectorToolDescriptor, type ConsentDecision, type ConsentLine, ContributionRegistry, DEFAULT_PLUGIN_LICENSE, DEFAULT_WORKSPACE_ID, type DefinedAction, type DefinedConnector, type DeleteDayOptions, type DeleteDayResult, type DeliveryResult, DependencyCycleError, type DependencyNode, type Disposable$1 as Disposable, ERP_CANVAS_PLUGIN_FIXTURE, EXTERNAL_ITEM_SCHEMA, type EditorContribution, type EditorSchemaRisk, type EmailActionOptions, type ExtensionContext, type ExtensionStorage, FEED_ITEM_SCHEMA, type FeatureModule, type FeedEntry, type FetchJson, type FetchLike, type FlatNode, type FormatHelpers, GITHUB_CONNECTOR_ID, GOOGLE_CALENDAR_CONNECTOR_ID, type GeneratedScript, type GithubConnectorOptions, type GuardableConnectorStore, type IProcessManager, type ImporterContribution, type InstallOptions, LEAVE_README, LINEAR_CONNECTOR_ID, type LabRunOutcome, type LadderRuntimeTier, type LanguageModelLike, type LanguageModelMonitor, type LanguageModelSessionLike, type LayoutTree, type LeaveBundle, type LicenseCheckResult, LicenseRequiredError, type LinearConnectorOptions, type LocalAPIConfig, type LocalAPITokenConfig, type LocalAPITokenScope, type LocalAPITokenSummary, type LocalServerProbe, MARKETPLACE_PROVENANCE, type MCPPropertySchema, type MCPRequest, type MCPResource, type MCPResponse, type MCPServerConfig, type MCPTool, MEDIA_PROVIDER_CANVAS_PLUGIN_FIXTURE, type ManagedBudgetSnapshot, ManagedProvider, type ManagedProviderOptions, MarketplaceClient, type MarketplaceClientOptions, type MarketplaceEntry, type MarketplaceSort, type MathHelpers, type MentionProviderContribution, type MentionSuggestion, MiddlewareChain, type MissingDependency, type ModuleCapabilities, NOTION_CONNECTOR_ID, type NodeChangeEvent, type NodeChangeEventData, type NodeData, type NodeStoreAPI, type NodeStoreMiddleware, type NotionConnectorOptions, OllamaProvider, OpenAICompatibleProvider, type OpenAICompatibleProviderOptions, OpenAIProvider, PRESET_IDS, PRESET_WORKSPACE_ID_PREFIX, type PendingChange, type Platform, type PlatformCapabilities, type PluginContributions, PluginError, type PluginNode, type PluginNodeChangeEvent, type PluginNodeChangeListener, type PluginPermissions, type PluginPricing, type PluginRating, PluginRegistry, type PluginRunInput, type PluginRunResult, PluginRuntimeError, type PluginRuntimeLadder, PluginSchema, type PluginStatus, PluginValidationError, type PresetId, type ProcessManagerEvents, type PromptApiAvailability, PromptApiProvider, type PromptApiProviderOptions, type PropertyCellProps, type PropertyEditorProps, type PropertyHandler, type PropertyHandlerContribution, type Provenance, type ProvenanceResult, type ProvenanceVerifier, type QueryFilter, REGION_IDS, RSS_CONNECTOR_ID, type RatingSummary, type RecommendOptions, type RegionId, type RegisteredPlugin, type ResolveMentionOptions, type RightToLeavePorts, type RssConnectorOptions, type RunActionPorts, type RunConnectorSyncPorts, type RunPluginCodeInput, SCAFFOLD_SYSTEM_GUARD, SERVICE_IPC_CHANNELS, SLACK_CONNECTOR_ID, type SandboxOptions, ScaffoldError, type ScaffoldResult, type ScaffoldSpec, type ScaffoldTemplate, type SchemaContribution, type SchemaData, type SchemaDefinition, type SchemaProperty, type SchemaRegistryAPI, type ScriptContext, ScriptError, type ScriptExecutionResult, type ScriptExecutor, ScriptGenerationError, ScriptGenerator, type ScriptGeneratorOptions, type ScriptNode, type ScriptNodeChangeEvent, type ScriptOutputType, ScriptRunner, type ScriptRunnerOptions, ScriptSandbox, ScriptSchema, type ScriptStore, ScriptTimeoutError, type ScriptToManifestInput, type ScriptTriggerType, ScriptValidationError, type SemVer, type ServiceClient, type ServiceCommunication, type ServiceDefinition, type ServiceHealthCheck, type ServiceLifecycle, type ServiceOutputEvent, type ServiceProcessConfig, type ServiceProvides, type ServiceState, type ServiceStatus, type ServiceStatusEvent, type SettingContribution, type SettingsPanelProps, ShortcutManager, type SidebarContribution, type SlackConnectorOptions, type SlashCommandContext, type SlashCommandContribution, type SlotContribution, type SlotPlacement, type SlotRegion, type SlotTier, type StatusBarContribution, type SurfaceDockContribution, type SurfaceDockTier, type TelemetryReporter, type TestHarnessOptions, type TestNodeStore, type TestPluginHarness, type TextHelpers, type ToolCallingFidelity, TypedRegistry, type UsageSignal, type ValidationResult, type VerifyProvenanceInput, type ViewContribution, type ViewProps, type WebLLMEngineLike, WebLLMProvider, type WebLLMProviderOptions, type WebhookConfig, WebhookEmitter, type WebhookOutOptions, type WebhookPayload, type WidgetContribution, type WidgetContributionConfigField, type WidgetContributionProps, type WorkspaceCommand, type WorkspacePayload, type WrapCliConnectorOptions, type WriteMode, XNET_MARKDOWN_DIRECTIVE_SPECS, XNET_PAGE_FRAGMENT_FIELD, XNET_PAGE_LEGACY_FRAGMENT_FIELD, type XNetExtension, type XNetMarkdownDiffLine, type XNetMarkdownDiffLineKind, type XNetMarkdownDirective, type XNetMarkdownDirectiveSpec, type XNetMarkdownReviewDiff, type XNetPageDocResolver, type XNetPageFragmentReadOptions, type XNetPageFragmentWriteOptions, type XNetPageMarkdownFrontmatter, type XNetPageMarkdownValidation, type XNetPageMarkdownValidationOptions, agentToolToExtraTool, agentToolsAsExtraTools, aggregateRatings, assertNetwork, assertPublicUrl, assertSchemaWrite, assertSystemAudio, assistTurnProvenance, attachAiPlanValidation, blockNoteFragmentToMarkdown, buildAirtableConnector, buildDiscordAction, buildEmailAction, buildGithubConnector, buildGoogleCalendarConnector, buildLinearConnector, buildNotionConnector, buildRetryPrompt, buildRssConnector, buildScriptPrompt, buildSlackConnector, buildSlackWebhookAction, buildTelegramAction, buildWebhookOutAction, classifyAiAgentDisplayState, compareVersions, composeAssistSystemPrompt, connectorAsImporter, connectorMarketplaceEntry, contributionsAsAiTools, createAIProvider, createAIProviderRouter, createAiAgentRuntime, createAiChangeSet, createAiOperation, createAiSurfaceService, createAiValidationResult, createBlockNotePageMarkdownAdapter, createCanvasErpPrototypeRiskSummary, createCanvasErpPrototypeScenario, createCanvasPluginFixtureCards, createCanvasPluginFixtureManifests, createCanvasPluginPermissionPrompt, createCanvasPluginSandboxPolicy, createCanvasPreviewSandboxRequest, createCanvasRendererSandboxRequest, createDefaultTree, createExtensionContext, createExtensionStorage, createManagedProvider, createMemoryAiAgentRuntimeStorage, createPresetTree, createPromptApiProvider, createScriptContext, createServiceClient, createTestNodeStore, createTestPluginHarness, createWebLLMProvider, createWebhookEmitter, defaultLocalServerProbes, defineAction, defineConnector, defineExtension, defineFeatureModule, deleteDay, describeCapabilities, detectConnectors, detectUpcomingMeeting, downloadPromptApiModel, emitConnectorArtifacts, evaluateCanvasPluginPermissionGate, evaluateCanvasPluginSandboxRequest, evaluateConnectorInstall, evaluateInstallConsent, executeScript, failClosedVerifier, filterByCategory, findEditorSchemaRisks, findMissingDependencies, generateScript, getCanvasErpPrototypeAuditEntriesForCard, getCanvasErpPrototypeCardsForFrame, getCanvasPluginFixture, getCommandRegistry, getPlatformCapabilities, getShortcutManager, getXNetMarkdownDirectiveSpecs, guardStore, guardedActionFetch, guardedFetch, hasUpdate, importerAdapters, insertSlot, installCommandHandler, installShortcutHandler, isAiRiskLevel, isAiScope, isAiTargetKind, isAllowedPluginLicense, isHostCompatible, isNetworkAllowed, isOllamaAvailable, isPaidPricing, isPresetWorkspaceId, isSchemaDefiningContribution, isSchemaReadAllowed, isSchemaWriteAllowed, isScriptNode, isServiceClientAvailable, isSystemAudioAllowed, ladderTierForTrust, leaveWithEverything, legacyFragmentToMarkdown, listOllamaModels, matchSchemaIri, moveSlot, normalizeCanvasPluginWorkspacePolicy, packageName, parseAiMutationPlan, parseFeed, parseVersion, parseWorkspacePayload, parseXNetPageFrontmatter, pascalCase, pickBestConnector, placementOf, pluginLicenseText, presetForWorkspaceId, presetWorkspaceId, probeOpenAiCompatible, promptApiAvailability, quickSafetyCheck, recommendExtensions, regionOf, renderEvent, renderMarkdownLineDiff, renderMarkdownReviewDiff, renderSelectionPrompt, replaceXNetPageFragmentWithMarkdown, resolveImporters, resolveInstallOrder, resolveMentionProviders, runAction, runAiPluginPipeline, runConnectorSync, runPluginCode, satisfiesRange, scaffoldPlugin, scriptToPluginManifest, searchMarketplace, serializeAiMutationPlan, serializeWorkspacePayload, setSlotTier, shortSchemaName, shouldDispatch, slotsIn, sortMarketplace, stripXNetPageFrontmatter, summarizeProvenance, validateAiMutationPlan, validateCanvasPluginSandboxOutput, validateManifest, validateScript, validateScriptAST, validateXNetPageMarkdown, verifyProvenance, warnOnEditorSchemaRisks, wrapCliConnector, writeModeFor, xnetPageFragmentToMarkdown };