@xnetjs/plugins 2.4.0 → 3.0.0

package/README.md

@@ -2,6 +2,11 @@
 
 Plugin system for xNet -- registry, sandboxed script execution, AI-powered script generation, and service integrations.
 
+> **Alpha software.** xNet is released but early: this package is on npm and
+> usable today, but its API can change between releases, sometimes without a
+> migration path. Pin your version. See the
+> [project README](https://github.com/crs48/xNet#readme) for what alpha means here.
+
 ## Installation
 
 ```bash

package/dist/index.d.ts

@@ -322,6 +322,21 @@ interface ViewContribution {
     /** Schema IRIs this view supports (empty = all) */
     supportedSchemas?: string[];
 }
+/**
+ * A frame source renderer (0346): how a node of some schema renders as
+ * a frame (document embeds, dashboard frame widgets, frame tabs). The
+ * capability rule mirrors slots: a plugin registers renderers only under
+ * its OWN id namespace and never replaces another provider's renderer —
+ * enforced by `PluginContext.registerFrameRenderer`.
+ */
+interface FrameRendererContribution {
+    /** Renderer id — namespaced `${pluginId}:${name}` by the context. */
+    id: string;
+    /** Schema IRIs this renderer can frame ('*' = any). */
+    supportedSchemas: string[] | '*';
+    /** Component receiving the host's NodeFrameProps contract. */
+    component: ComponentType<never>;
+}
 interface ViewProps {
     nodeId: string;
     schemaId: string;
@@ -783,6 +798,7 @@ declare class ContributionRegistry {
     readonly mentionProviders: TypedRegistry<MentionProviderContribution>;
     readonly agentTools: TypedRegistry<AgentToolContribution>;
     readonly slots: TypedRegistry<SlotContribution>;
+    readonly frameRenderers: TypedRegistry<FrameRendererContribution>;
     /** @deprecated Since 0280 — the dock registry is the slot registry. */
     get surfaceDock(): TypedRegistry<SlotContribution>;
     /**
@@ -1023,6 +1039,13 @@ interface ExtensionContext {
     registerSchema(schema: unknown): Disposable$1;
     /** Register a custom view type */
     registerView(view: ViewContribution): Disposable$1;
+    /**
+     * Register a frame source renderer (0346). Own-views-only rule: the
+     * renderer id is namespaced under this plugin's id, so a plugin can
+     * add frames for its own schemas but never replace another provider's
+     * renderer.
+     */
+    registerFrameRenderer(renderer: FrameRendererContribution): Disposable$1;
     /** Register a dashboard widget (trust tier assigned by the host) */
     registerWidget(widget: WidgetContribution): Disposable$1;
     /** Register a property type handler */
@@ -1699,7 +1722,7 @@ declare function warnOnEditorSchemaRisks(pluginId: string, contributions: readon
  *
  * A Connector is xNet's answer to the agent-native CLI (Printing Press / OpenClaw):
  * instead of giving the agent a credentialed shell, it syncs an external service
- * into governed XNet nodes and exposes agent-callable tools over them. It is a
+ * into governed xNet nodes and exposes agent-callable tools over them. It is a
  * `FeatureModule` subtype that bundles three things:
  *
  *   1. a `capabilities` manifest — `secrets` (held by the hub broker, never the
@@ -2163,6 +2186,14 @@ declare class AiSurfaceService {
     private readPageMarkdown;
     private readPageOutline;
     private planPagePatch;
+    /**
+     * Compose a page of frames (0346, Phase 5): create the Page node, then
+     * plan + apply its markdown content (intro + frame directives) through
+     * the standard page pipeline — one audited step, rollbackable via the
+     * page-markdown rollback handle (the created page itself is reported
+     * so a rejected compose can be cleaned up).
+     */
+    private composePage;
     private applyPageMarkdown;
     private finalizeAppliedPageMarkdown;
     private getAuditLog;
@@ -2969,16 +3000,16 @@ declare function wrapCliConnector(options: WrapCliConnectorOptions): DefinedConn
 /**
  * @xnetjs/plugins — the Slack migration connector (exploration 0198).
  *
- * "Switch from Slack to XNet and bring my data with me." This is the Half-1
+ * "Switch from Slack to xNet and bring my data with me." This is the Half-1
  * answer from exploration 0198: a {@link defineConnector} that pulls a Slack
- * workspace's channels and message history into XNet's native `Channel` and
+ * workspace's channels and message history into xNet's native `Channel` and
  * `ChatMessage` nodes, through the guarded connector store (egress-contained to
  * `slack.com`, space-stamped, budget-charged). The Slack token lives in the hub
  * broker and never reaches the agent — it only ever sees the synced nodes.
  *
  * Message bodies are translated to GitHub-flavored markdown via
  * `@xnetjs/slack-compat` (Block Kit first, then `mrkdwn`), so they render
- * natively in XNet chat. Pagination, DMs, files and reactions are deferred (see
+ * natively in xNet chat. Pagination, DMs, files and reactions are deferred (see
  * the exploration's checklist).
  */
 
@@ -5039,7 +5070,7 @@ type ManagedProviderOptions = AIProviderOptions & {
     onBudget?: (snapshot: ManagedBudgetSnapshot) => void;
 };
 /**
- * XNet Cloud **managed** AI provider (exploration 0208).
+ * xNet Cloud **managed** AI provider (exploration 0208).
  *
  * Posts to the hub's `/ai/chat`, which forwards to the metered control-plane
  * gateway (OpenRouter behind a per-tenant budgeted key). Unlike every other cloud
@@ -5053,7 +5084,7 @@ type ManagedProviderOptions = AIProviderOptions & {
  * No `stream` method, so the runtime uses the request/response path.
  */
 declare class ManagedProvider implements AIProvider {
-    readonly name = "XNet Cloud";
+    readonly name = "xNet Cloud";
     private readonly baseUrl;
     private readonly model?;
     private readonly fetchImpl;
@@ -5513,7 +5544,7 @@ type WriteMode = 'agentic' | 'propose-only';
  */
 interface ConnectorEnv {
     /**
-     * Probe XNet Cloud managed AI: GET `${managedUrl}/ai/health` is `ok` and the
+     * Probe xNet Cloud managed AI: GET `${managedUrl}/ai/health` is `ok` and the
      * tenant has AI enabled. Default: a same-origin fetch (returns false off-cloud).
      */
     probeManaged?: (baseUrl: string) => Promise<boolean>;
@@ -7170,4 +7201,4 @@ declare function buildCommunityRegistryEntry(source: PluginSourceNode, options:
  */
 declare function exportPluginSourceAsRepoFiles(source: PluginSourceNode): Record<string, string>;
 
-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 AgentAuditContext, AgentAuditRecorder, type AgentAuditRecorderConfig, type AgentAuditSurface, type AgentCallOutcome, type AgentExecutedResult, type AgentNotificationToolsOptions, type AgentPendingApproval, 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 CommunityRegistryEntry, 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 HotReloadEvent, 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, PLUGIN_FRAME_SANDBOX, PLUGIN_SOURCE_SCHEMA_IRI, PLUGIN_STORE_DENYLIST, PRESET_IDS, PRESET_WORKSPACE_ID_PREFIX, type PendingChange, type Platform, type PlatformCapabilities, type PluginBuildDiagnostic, type PluginBuildInput, type PluginContributions, PluginError, type PluginFeedbackEntry, type PluginFileTranspiler, type PluginFrameSession, type PluginFrameToHostMessage, type PluginFrameTransport, type PluginGraphPayload, type PluginHostToFrameMessage, type PluginModuleGraph, type PluginNode, type PluginNodeChangeEvent, type PluginNodeChangeListener, type PluginPermissions, type PluginPricing, type PluginRating, type PluginRegisteredHandlers, PluginRegistry, type PluginRunInput, type PluginRunResult, PluginRuntimeError, type PluginRuntimeLadder, PluginSchema, type PluginSourceDiff, type PluginSourceNode, PluginSourceSchema, type PluginSourceWatcher, type PluginStatus, type PluginStoreRpc, PluginStoreRpcError, type PluginUpdateAssessment, 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 PublishConsentRequest, 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, SOURCE_SETTLE_DEBOUNCE_MS, 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 VendorModuleSources, type VerifyProvenanceInput, type ViewContribution, type ViewProps, WRITING_XNET_PLUGINS_SKILL_MD, type WebLLMEngineLike, WebLLMProvider, type WebLLMProviderOptions, type WebhookConfig, WebhookEmitter, type WebhookOutOptions, type WebhookPayload, type WidgetContribution, type WidgetContributionConfigField, type WidgetContributionProps, type WorkspaceCommand, type WorkspacePayload, type WorkspacePluginAgentToolsOptions, type WorkspacePluginContributionsData, type WorkspacePluginDraftBackend, WorkspacePluginError, type WorkspacePluginHandle, type WorkspacePluginHostDeps, type WorkspacePluginHotReloader, type WorkspacePluginManifestData, type WorkspacePluginPreviewManager, type WorkspacePluginPreviewResult, type WorkspacePluginPublishResult, type WorkspacePluginSourceBackend, type WorkspacePluginStore, 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, activateWorkspacePlugin, agentToolToExtraTool, agentToolsAsExtraTools, aggregateRatings, assertNetwork, assertPublicUrl, assertSchemaWrite, assertSystemAudio, assessPluginUpdate, assistTurnProvenance, attachAiPlanValidation, blockNoteFragmentToMarkdown, buildAirtableConnector, buildCommunityRegistryEntry, buildDiscordAction, buildEmailAction, buildGithubConnector, buildGoogleCalendarConnector, buildLinearConnector, buildNotionConnector, buildPluginFrameSrcdoc, buildPluginModuleGraph, buildRetryPrompt, buildRssConnector, buildScriptPrompt, buildSlackConnector, buildSlackWebhookAction, buildTelegramAction, buildWebhookOutAction, buildWorkspacePlugin, classifyAiAgentDisplayState, compareVersions, composeAssistSystemPrompt, computePluginSourceHash, connectorAsImporter, connectorMarketplaceEntry, contributionsAsAiTools, createAIProvider, createAIProviderRouter, createAgentCeremonyTools, createAgentNotificationTools, createAiAgentRuntime, createAiChangeSet, createAiOperation, createAiSurfaceService, createAiValidationResult, createBlockNotePageMarkdownAdapter, createCanvasErpPrototypeRiskSummary, createCanvasErpPrototypeScenario, createCanvasPluginFixtureCards, createCanvasPluginFixtureManifests, createCanvasPluginPermissionPrompt, createCanvasPluginSandboxPolicy, createCanvasPreviewSandboxRequest, createCanvasRendererSandboxRequest, createDefaultTree, createExtensionContext, createExtensionStorage, createManagedProvider, createMemoryAiAgentRuntimeStorage, createPluginFrameSession, createPluginSourceWatcher, createPluginStoreRpc, createPresetTree, createPromptApiProvider, createScriptContext, createServiceClient, createTestNodeStore, createTestPluginHarness, createWebLLMProvider, createWebhookEmitter, createWorkspacePluginAgentTools, createWorkspacePluginHotReloader, createWorkspacePluginPreviewManager, defaultLocalServerProbes, defineAction, defineConnector, defineExtension, defineFeatureModule, deleteDay, describeCapabilities, detectConnectors, detectUpcomingMeeting, diffPluginSourceFiles, downloadPromptApiModel, emitConnectorArtifacts, evaluateCanvasPluginPermissionGate, evaluateCanvasPluginSandboxRequest, evaluateConnectorInstall, evaluateInstallConsent, executeScript, exportPluginSourceAsRepoFiles, failClosedVerifier, filterByCategory, findEditorSchemaRisks, findMissingDependencies, framePluginCsp, generateScript, getCanvasErpPrototypeAuditEntriesForCard, getCanvasErpPrototypeCardsForFrame, getCanvasPluginFixture, getCommandRegistry, getPlatformCapabilities, getShortcutManager, getXNetMarkdownDirectiveSpecs, guardStore, guardedActionFetch, guardedFetch, hasUpdate, hashNonce, importerAdapters, insertSlot, installCommandHandler, installShortcutHandler, isAiRiskLevel, isAiScope, isAiTargetKind, isAllowedPluginLicense, isDenylistedSchema, 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, permissionsToCapabilities, pickBestConnector, placementOf, pluginLicenseText, presetForWorkspaceId, presetWorkspaceId, probeOpenAiCompatible, promptApiAvailability, quickSafetyCheck, readPluginSourceNode, recommendExtensions, regionOf, renderEvent, renderMarkdownLineDiff, renderMarkdownReviewDiff, renderSelectionPrompt, replaceXNetPageFragmentWithMarkdown, requestWorkspacePluginPublish, resolveImporters, resolveInstallOrder, resolveMentionProviders, reversibilityForTool, riskForTool, runAction, runAiPluginPipeline, runConnectorSync, runPluginCode, satisfiesRange, scaffoldPlugin, scaffoldWorkspacePluginFiles, scriptToPluginManifest, searchMarketplace, serializeAiMutationPlan, serializeWorkspacePayload, setSlotTier, shortSchemaName, shouldDispatch, slotsIn, sortMarketplace, stripXNetPageFrontmatter, summarizeProvenance, validateAiMutationPlan, validateCanvasPluginSandboxOutput, validateManifest, validateScript, validateScriptAST, validateWorkspaceManifest, validateXNetPageMarkdown, verifyProvenance, warnOnEditorSchemaRisks, wrapCliConnector, writeModeFor, xnetPageFragmentToMarkdown };
+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 AgentAuditContext, AgentAuditRecorder, type AgentAuditRecorderConfig, type AgentAuditSurface, type AgentCallOutcome, type AgentExecutedResult, type AgentNotificationToolsOptions, type AgentPendingApproval, 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 CommunityRegistryEntry, 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, type FrameRendererContribution, GITHUB_CONNECTOR_ID, GOOGLE_CALENDAR_CONNECTOR_ID, type GeneratedScript, type GithubConnectorOptions, type GuardableConnectorStore, type HotReloadEvent, 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, PLUGIN_FRAME_SANDBOX, PLUGIN_SOURCE_SCHEMA_IRI, PLUGIN_STORE_DENYLIST, PRESET_IDS, PRESET_WORKSPACE_ID_PREFIX, type PendingChange, type Platform, type PlatformCapabilities, type PluginBuildDiagnostic, type PluginBuildInput, type PluginContributions, PluginError, type PluginFeedbackEntry, type PluginFileTranspiler, type PluginFrameSession, type PluginFrameToHostMessage, type PluginFrameTransport, type PluginGraphPayload, type PluginHostToFrameMessage, type PluginModuleGraph, type PluginNode, type PluginNodeChangeEvent, type PluginNodeChangeListener, type PluginPermissions, type PluginPricing, type PluginRating, type PluginRegisteredHandlers, PluginRegistry, type PluginRunInput, type PluginRunResult, PluginRuntimeError, type PluginRuntimeLadder, PluginSchema, type PluginSourceDiff, type PluginSourceNode, PluginSourceSchema, type PluginSourceWatcher, type PluginStatus, type PluginStoreRpc, PluginStoreRpcError, type PluginUpdateAssessment, 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 PublishConsentRequest, 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, SOURCE_SETTLE_DEBOUNCE_MS, 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 VendorModuleSources, type VerifyProvenanceInput, type ViewContribution, type ViewProps, WRITING_XNET_PLUGINS_SKILL_MD, type WebLLMEngineLike, WebLLMProvider, type WebLLMProviderOptions, type WebhookConfig, WebhookEmitter, type WebhookOutOptions, type WebhookPayload, type WidgetContribution, type WidgetContributionConfigField, type WidgetContributionProps, type WorkspaceCommand, type WorkspacePayload, type WorkspacePluginAgentToolsOptions, type WorkspacePluginContributionsData, type WorkspacePluginDraftBackend, WorkspacePluginError, type WorkspacePluginHandle, type WorkspacePluginHostDeps, type WorkspacePluginHotReloader, type WorkspacePluginManifestData, type WorkspacePluginPreviewManager, type WorkspacePluginPreviewResult, type WorkspacePluginPublishResult, type WorkspacePluginSourceBackend, type WorkspacePluginStore, 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, activateWorkspacePlugin, agentToolToExtraTool, agentToolsAsExtraTools, aggregateRatings, assertNetwork, assertPublicUrl, assertSchemaWrite, assertSystemAudio, assessPluginUpdate, assistTurnProvenance, attachAiPlanValidation, blockNoteFragmentToMarkdown, buildAirtableConnector, buildCommunityRegistryEntry, buildDiscordAction, buildEmailAction, buildGithubConnector, buildGoogleCalendarConnector, buildLinearConnector, buildNotionConnector, buildPluginFrameSrcdoc, buildPluginModuleGraph, buildRetryPrompt, buildRssConnector, buildScriptPrompt, buildSlackConnector, buildSlackWebhookAction, buildTelegramAction, buildWebhookOutAction, buildWorkspacePlugin, classifyAiAgentDisplayState, compareVersions, composeAssistSystemPrompt, computePluginSourceHash, connectorAsImporter, connectorMarketplaceEntry, contributionsAsAiTools, createAIProvider, createAIProviderRouter, createAgentCeremonyTools, createAgentNotificationTools, createAiAgentRuntime, createAiChangeSet, createAiOperation, createAiSurfaceService, createAiValidationResult, createBlockNotePageMarkdownAdapter, createCanvasErpPrototypeRiskSummary, createCanvasErpPrototypeScenario, createCanvasPluginFixtureCards, createCanvasPluginFixtureManifests, createCanvasPluginPermissionPrompt, createCanvasPluginSandboxPolicy, createCanvasPreviewSandboxRequest, createCanvasRendererSandboxRequest, createDefaultTree, createExtensionContext, createExtensionStorage, createManagedProvider, createMemoryAiAgentRuntimeStorage, createPluginFrameSession, createPluginSourceWatcher, createPluginStoreRpc, createPresetTree, createPromptApiProvider, createScriptContext, createServiceClient, createTestNodeStore, createTestPluginHarness, createWebLLMProvider, createWebhookEmitter, createWorkspacePluginAgentTools, createWorkspacePluginHotReloader, createWorkspacePluginPreviewManager, defaultLocalServerProbes, defineAction, defineConnector, defineExtension, defineFeatureModule, deleteDay, describeCapabilities, detectConnectors, detectUpcomingMeeting, diffPluginSourceFiles, downloadPromptApiModel, emitConnectorArtifacts, evaluateCanvasPluginPermissionGate, evaluateCanvasPluginSandboxRequest, evaluateConnectorInstall, evaluateInstallConsent, executeScript, exportPluginSourceAsRepoFiles, failClosedVerifier, filterByCategory, findEditorSchemaRisks, findMissingDependencies, framePluginCsp, generateScript, getCanvasErpPrototypeAuditEntriesForCard, getCanvasErpPrototypeCardsForFrame, getCanvasPluginFixture, getCommandRegistry, getPlatformCapabilities, getShortcutManager, getXNetMarkdownDirectiveSpecs, guardStore, guardedActionFetch, guardedFetch, hasUpdate, hashNonce, importerAdapters, insertSlot, installCommandHandler, installShortcutHandler, isAiRiskLevel, isAiScope, isAiTargetKind, isAllowedPluginLicense, isDenylistedSchema, 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, permissionsToCapabilities, pickBestConnector, placementOf, pluginLicenseText, presetForWorkspaceId, presetWorkspaceId, probeOpenAiCompatible, promptApiAvailability, quickSafetyCheck, readPluginSourceNode, recommendExtensions, regionOf, renderEvent, renderMarkdownLineDiff, renderMarkdownReviewDiff, renderSelectionPrompt, replaceXNetPageFragmentWithMarkdown, requestWorkspacePluginPublish, resolveImporters, resolveInstallOrder, resolveMentionProviders, reversibilityForTool, riskForTool, runAction, runAiPluginPipeline, runConnectorSync, runPluginCode, satisfiesRange, scaffoldPlugin, scaffoldWorkspacePluginFiles, scriptToPluginManifest, searchMarketplace, serializeAiMutationPlan, serializeWorkspacePayload, setSlotTier, shortSchemaName, shouldDispatch, slotsIn, sortMarketplace, stripXNetPageFrontmatter, summarizeProvenance, validateAiMutationPlan, validateCanvasPluginSandboxOutput, validateManifest, validateScript, validateScriptAST, validateWorkspaceManifest, validateXNetPageMarkdown, verifyProvenance, warnOnEditorSchemaRisks, wrapCliConnector, writeModeFor, xnetPageFragmentToMarkdown };

package/dist/index.js

@@ -517,6 +517,7 @@ var ContributionRegistry = class {
   mentionProviders = new TypedRegistry();
   agentTools = new TypedRegistry();
   slots = new TypedRegistry();
+  frameRenderers = new TypedRegistry();
   /** @deprecated Since 0280 — the dock registry is the slot registry. */
   get surfaceDock() {
     return this.slots;
@@ -546,6 +547,7 @@ var ContributionRegistry = class {
     this.mentionProviders.clear();
     this.agentTools.clear();
     this.slots.clear();
+    this.frameRenderers.clear();
   }
 };
 
@@ -621,7 +623,7 @@ function createPresetTree(preset) {
         chrome: "pinned"
       };
     case "bench":
-      regions.rail = [place("rail", "pinned", 0)];
+      regions.rail = [];
       regions.status = [place("status", "pinned", 0)];
       regions["dock.left"] = [
         place("explorer", "pinned", 0),
@@ -651,15 +653,16 @@ function createPresetTree(preset) {
 var DEFAULT_WORKSPACE_ID = "workspace-default";
 function createDefaultTree() {
   const regions = emptyRegions();
-  regions.rail = [place("sidebar", "pinned", 0)];
+  regions.rail = [];
   regions.status = [place("status", "pinned", 0)];
   regions["dock.left"] = [
-    place("explorer", "pinned", 0),
-    place("chats", "summoned", 1),
-    place("tasks", "summoned", 2),
-    place("today", "summoned", 3),
-    place("data", "summoned", 4),
-    place("ai-chat", "summoned", 5)
+    place("tree", "pinned", 0),
+    place("explorer", "summoned", 1),
+    place("chats", "summoned", 2),
+    place("tasks", "summoned", 3),
+    place("today", "summoned", 4),
+    place("data", "summoned", 5),
+    place("ai-chat", "summoned", 6)
   ];
   regions["dock.right"] = [place("context", "summoned", 0)];
   regions["dock.bottom"] = [
@@ -2526,7 +2529,7 @@ function searchTool(id, search) {
   return {
     id: `${id}.search`,
     name: "slack_search_messages",
-    description: "Search messages imported from Slack into XNet channels.",
+    description: "Search messages imported from Slack into xNet channels.",
     inputSchema: {
       type: "object",
       properties: { query: { type: "string", description: "Full-text query." } },
@@ -2541,7 +2544,7 @@ function buildSlackConnector(options = {}) {
   return defineConnector({
     id,
     name: "Slack",
-    description: "Import Slack channels and message history into XNet.",
+    description: "Import Slack channels and message history into xNet.",
     capabilities: {
       secrets: ["SLACK_USER_TOKEN"],
       schemaWrite: [CHANNEL_SCHEMA, CHAT_MESSAGE_SCHEMA],
@@ -3473,6 +3476,16 @@ function createExtensionContext(options) {
       disposables.push(d);
       return d;
     },
+    registerFrameRenderer(renderer) {
+      const namespacedId = renderer.id.startsWith(`${pluginId}:`) ? renderer.id : `${pluginId}:${renderer.id}`;
+      const existing = contributions.frameRenderers.getAll().find((entry) => entry.id === namespacedId);
+      if (existing) {
+        throw new Error(`[Plugin ${pluginId}] frame renderer already registered: ${namespacedId}`);
+      }
+      const d = contributions.frameRenderers.register({ ...renderer, id: namespacedId });
+      disposables.push(d);
+      return d;
+    },
     registerWidget(widget) {
       const d = contributions.widgets.register(widget);
       disposables.push(d);
@@ -6348,6 +6361,156 @@ var rollbackPageMarkdownTool = {
   execute: async (host, args) => await host.rollbackPageMarkdown(args)
 };
 
+// src/ai-surface/tools/frames.ts
+function readPlacements(args) {
+  const raw = args.placements;
+  if (!Array.isArray(raw) || raw.length === 0) {
+    throw new Error("placements must be a non-empty array");
+  }
+  return raw.map((entry, index) => {
+    if (typeof entry !== "object" || entry === null) {
+      throw new Error(`placements[${index}] must be an object`);
+    }
+    const record = entry;
+    const nodeId = record.nodeId;
+    if (typeof nodeId !== "string" || !nodeId) {
+      throw new Error(`placements[${index}].nodeId is required`);
+    }
+    const kind = record.kind === "page" ? "page" : "database";
+    return {
+      nodeId,
+      kind,
+      viewType: typeof record.viewType === "string" ? record.viewType : void 0,
+      title: typeof record.title === "string" ? record.title : void 0,
+      config: typeof record.config === "object" && record.config !== null ? record.config : void 0
+    };
+  });
+}
+function framePlacementDirective(placement) {
+  if (placement.kind === "page") {
+    const payload2 = { nodeId: placement.nodeId, title: placement.title ?? "" };
+    return `:::xnet-page
+${JSON.stringify(payload2)}
+:::`;
+  }
+  const payload = {
+    databaseId: placement.nodeId,
+    viewType: placement.viewType ?? "table",
+    viewConfig: placement.config ?? {}
+  };
+  return `:::xnet-database
+${JSON.stringify(payload)}
+:::`;
+}
+function frameMarkdownBody(intro, placements) {
+  const sections = placements.map((p) => framePlacementDirective(p));
+  return [intro?.trim(), ...sections].filter(Boolean).join("\n\n");
+}
+var placementsSchema = {
+  type: "array",
+  description: 'Frames to place, in order. kind "database" embeds a live database view (viewType: table | board | list | gallery | calendar | timeline | map | plugin types); kind "page" embeds a live page transclusion.',
+  items: {
+    type: "object",
+    properties: {
+      nodeId: { type: "string", description: "Target node id (database or page)." },
+      kind: { type: "string", enum: ["database", "page"] },
+      viewType: { type: "string", description: "Registry view type for database frames." },
+      title: { type: "string", description: "Display title for page frames." },
+      config: { type: "object", description: "Per-view presentation config." }
+    },
+    required: ["nodeId"]
+  }
+};
+var planFramePlacementTool = {
+  definition: {
+    name: "xnet_plan_frame_placement",
+    title: "Plan frame placement",
+    description: "Plan appending live frames (database views, page transclusions) to an existing page. Returns a validated mutation plan with a review diff; apply with xnet_apply_frame_placement.",
+    risk: "medium",
+    requiredScopes: ["page.read", "page.propose"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        pageId: { type: "string", description: "Page to place frames on." },
+        placements: placementsSchema,
+        intent: { type: "string", description: "Why these frames are being placed." }
+      },
+      required: ["pageId", "placements"]
+    }
+  },
+  execute: async (host, args) => {
+    const pageId = readRequiredString(args, "pageId");
+    const placements = readPlacements(args);
+    const current = await host.readPageMarkdown(pageId, true);
+    const markdown = `${current.text.trimEnd()}
+
+${frameMarkdownBody(void 0, placements)}
+`;
+    return host.planPagePatch({
+      pageId,
+      markdown,
+      actor: readOptionalString(args, "actor") ?? "ai-agent",
+      intent: readOptionalString(args, "intent") ?? `Place ${placements.length} frame${placements.length === 1 ? "" : "s"} on the page`
+    });
+  }
+};
+var applyFramePlacementTool = {
+  definition: {
+    name: "xnet_apply_frame_placement",
+    title: "Apply frame placement",
+    description: "Apply a validated frame-placement plan (from xnet_plan_frame_placement). Requires confirmApply: true. Audited and rollbackable via xnet_rollback_page_markdown.",
+    risk: "high",
+    requiredScopes: ["page.write"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        plan: { type: "object", description: "The validated mutation plan." },
+        confirmApply: { type: "boolean", description: "Must be true to apply." }
+      },
+      required: ["plan", "confirmApply"]
+    }
+  },
+  execute: async (host, args) => host.applyPageMarkdown(args)
+};
+var composePageTool = {
+  definition: {
+    name: "xnet_compose_page",
+    title: "Compose a page of frames",
+    description: "Create a new page and seed it with intro text plus live frames (database views, page transclusions) in one audited step. The result is ordinary editable content \u2014 every frame stays live and human-editable. Requires confirmApply: true.",
+    risk: "high",
+    requiredScopes: ["page.write"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: { type: "string", description: "New page title." },
+        intro: { type: "string", description: "Optional intro paragraph (markdown)." },
+        placements: placementsSchema,
+        confirmApply: { type: "boolean", description: "Must be true to create and compose." },
+        intent: { type: "string" }
+      },
+      required: ["title", "placements", "confirmApply"]
+    }
+  },
+  execute: async (host, args) => {
+    const title = readRequiredString(args, "title");
+    const placements = readPlacements(args);
+    const body = frameMarkdownBody(readOptionalString(args, "intro"), placements);
+    return host.composePage({
+      title,
+      markdown: body,
+      confirmApply: args.confirmApply === true,
+      actor: readOptionalString(args, "actor") ?? "ai-agent",
+      intent: readOptionalString(args, "intent") ?? `Compose page "${title}"`,
+      extra: readOptionalRecord(args, "extra") ?? void 0
+    });
+  }
+};
+var frameToolEntries = [
+  planFramePlacementTool,
+  applyFramePlacementTool,
+  composePageTool
+];
+
 // src/ai-surface/tools/search.ts
 var searchTool4 = {
   definition: {
@@ -6473,7 +6636,9 @@ var BUILT_IN_TOOL_ENTRIES = [
   rollbackPageMarkdownTool,
   ...databaseToolEntries,
   ...canvasToolEntries,
-  validateMutationPlanTool
+  validateMutationPlanTool,
+  // Frame placement (0346) — appended last to keep prior positions stable.
+  ...frameToolEntries
 ];
 var BUILT_IN_TOOLS_BY_NAME = new Map(
   BUILT_IN_TOOL_ENTRIES.map((entry) => [entry.definition.name, entry])
@@ -6532,6 +6697,7 @@ var AiSurfaceService = class {
     planPagePatch: (args) => this.planPagePatch(args),
     applyPageMarkdown: (args) => this.applyPageMarkdown(args),
     rollbackPageMarkdown: (args) => this.rollbackPageMarkdown(args),
+    composePage: (args) => this.composePage(args),
     getAuditLog: (options) => this.getAuditLog(options),
     describeDatabase: (databaseId, options) => this.describeDatabase(databaseId, options),
     readDatabaseViews: (databaseId) => this.readDatabaseViews(databaseId),
@@ -6972,6 +7138,42 @@ var AiSurfaceService = class {
       errors: markdownValidation.validation.errors
     });
   }
+  /**
+   * Compose a page of frames (0346, Phase 5): create the Page node, then
+   * plan + apply its markdown content (intro + frame directives) through
+   * the standard page pipeline — one audited step, rollbackable via the
+   * page-markdown rollback handle (the created page itself is reported
+   * so a rejected compose can be cleaned up).
+   */
+  async composePage(args) {
+    if (!args.confirmApply) {
+      throw new Error("confirmApply must be true to compose a page");
+    }
+    const created = await this.config.store.create({
+      schemaId: "xnet://xnet.fyi/Page@1.0.0",
+      properties: { title: args.title, ...args.extra ?? {} }
+    });
+    const frontmatterBody = args.markdown;
+    const plan = await this.planPagePatch({
+      pageId: created.id,
+      markdown: frontmatterBody,
+      actor: args.actor ?? "ai-agent",
+      intent: args.intent ?? `Compose page "${args.title}"`
+    });
+    if (plan.status !== "validated") {
+      return { pageId: created.id, planId: plan.id, applied: false, plan };
+    }
+    const result = await this.applyPageMarkdown({
+      plan,
+      confirmApply: true
+    });
+    return {
+      pageId: created.id,
+      planId: plan.id,
+      applied: result.applied ?? false,
+      result
+    };
+  }
   async applyPageMarkdown(args) {
     const confirmApply = readOptionalBoolean(args, "confirmApply") ?? false;
     if (!confirmApply) {
@@ -11698,7 +11900,7 @@ var AiBudgetError = class extends Error {
   }
 };
 var ManagedProvider = class {
-  name = "XNet Cloud";
+  name = "xNet Cloud";
   baseUrl;
   model;
   fetchImpl;
@@ -12811,7 +13013,7 @@ var CONNECTOR_META = {
   // Preferred when available: no key to paste, metered + budget-capped, switchable
   // models — the managed path the rest of this exploration (0208) wires up.
   managed: {
-    label: "XNet Cloud (managed, metered)",
+    label: "xNet Cloud (managed, metered)",
     toolCalling: "reliable",
     preference: 0
   },
@@ -12911,7 +13113,7 @@ async function detectConnectors(env = {}) {
     {
       tier: "managed",
       available: managed,
-      ...managed ? {} : { setupHint: "Managed AI is available on XNet Cloud plans with AI enabled." }
+      ...managed ? {} : { setupHint: "Managed AI is available on xNet Cloud plans with AI enabled." }
     },
     {
       tier: "bridge",

package/dist/services/node.d.ts

@@ -379,6 +379,14 @@ declare class AiSurfaceService {
     private readPageMarkdown;
     private readPageOutline;
     private planPagePatch;
+    /**
+     * Compose a page of frames (0346, Phase 5): create the Page node, then
+     * plan + apply its markdown content (intro + frame directives) through
+     * the standard page pipeline — one audited step, rollbackable via the
+     * page-markdown rollback handle (the created page itself is reported
+     * so a rejected compose can be cleaned up).
+     */
+    private composePage;
     private applyPageMarkdown;
     private finalizeAppliedPageMarkdown;
     private getAuditLog;

package/dist/services/node.js

@@ -1279,6 +1279,156 @@ var rollbackPageMarkdownTool = {
   execute: async (host, args) => await host.rollbackPageMarkdown(args)
 };
 
+// src/ai-surface/tools/frames.ts
+function readPlacements(args) {
+  const raw = args.placements;
+  if (!Array.isArray(raw) || raw.length === 0) {
+    throw new Error("placements must be a non-empty array");
+  }
+  return raw.map((entry, index) => {
+    if (typeof entry !== "object" || entry === null) {
+      throw new Error(`placements[${index}] must be an object`);
+    }
+    const record = entry;
+    const nodeId = record.nodeId;
+    if (typeof nodeId !== "string" || !nodeId) {
+      throw new Error(`placements[${index}].nodeId is required`);
+    }
+    const kind = record.kind === "page" ? "page" : "database";
+    return {
+      nodeId,
+      kind,
+      viewType: typeof record.viewType === "string" ? record.viewType : void 0,
+      title: typeof record.title === "string" ? record.title : void 0,
+      config: typeof record.config === "object" && record.config !== null ? record.config : void 0
+    };
+  });
+}
+function framePlacementDirective(placement) {
+  if (placement.kind === "page") {
+    const payload2 = { nodeId: placement.nodeId, title: placement.title ?? "" };
+    return `:::xnet-page
+${JSON.stringify(payload2)}
+:::`;
+  }
+  const payload = {
+    databaseId: placement.nodeId,
+    viewType: placement.viewType ?? "table",
+    viewConfig: placement.config ?? {}
+  };
+  return `:::xnet-database
+${JSON.stringify(payload)}
+:::`;
+}
+function frameMarkdownBody(intro, placements) {
+  const sections = placements.map((p) => framePlacementDirective(p));
+  return [intro?.trim(), ...sections].filter(Boolean).join("\n\n");
+}
+var placementsSchema = {
+  type: "array",
+  description: 'Frames to place, in order. kind "database" embeds a live database view (viewType: table | board | list | gallery | calendar | timeline | map | plugin types); kind "page" embeds a live page transclusion.',
+  items: {
+    type: "object",
+    properties: {
+      nodeId: { type: "string", description: "Target node id (database or page)." },
+      kind: { type: "string", enum: ["database", "page"] },
+      viewType: { type: "string", description: "Registry view type for database frames." },
+      title: { type: "string", description: "Display title for page frames." },
+      config: { type: "object", description: "Per-view presentation config." }
+    },
+    required: ["nodeId"]
+  }
+};
+var planFramePlacementTool = {
+  definition: {
+    name: "xnet_plan_frame_placement",
+    title: "Plan frame placement",
+    description: "Plan appending live frames (database views, page transclusions) to an existing page. Returns a validated mutation plan with a review diff; apply with xnet_apply_frame_placement.",
+    risk: "medium",
+    requiredScopes: ["page.read", "page.propose"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        pageId: { type: "string", description: "Page to place frames on." },
+        placements: placementsSchema,
+        intent: { type: "string", description: "Why these frames are being placed." }
+      },
+      required: ["pageId", "placements"]
+    }
+  },
+  execute: async (host, args) => {
+    const pageId = readRequiredString(args, "pageId");
+    const placements = readPlacements(args);
+    const current = await host.readPageMarkdown(pageId, true);
+    const markdown = `${current.text.trimEnd()}
+
+${frameMarkdownBody(void 0, placements)}
+`;
+    return host.planPagePatch({
+      pageId,
+      markdown,
+      actor: readOptionalString(args, "actor") ?? "ai-agent",
+      intent: readOptionalString(args, "intent") ?? `Place ${placements.length} frame${placements.length === 1 ? "" : "s"} on the page`
+    });
+  }
+};
+var applyFramePlacementTool = {
+  definition: {
+    name: "xnet_apply_frame_placement",
+    title: "Apply frame placement",
+    description: "Apply a validated frame-placement plan (from xnet_plan_frame_placement). Requires confirmApply: true. Audited and rollbackable via xnet_rollback_page_markdown.",
+    risk: "high",
+    requiredScopes: ["page.write"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        plan: { type: "object", description: "The validated mutation plan." },
+        confirmApply: { type: "boolean", description: "Must be true to apply." }
+      },
+      required: ["plan", "confirmApply"]
+    }
+  },
+  execute: async (host, args) => host.applyPageMarkdown(args)
+};
+var composePageTool = {
+  definition: {
+    name: "xnet_compose_page",
+    title: "Compose a page of frames",
+    description: "Create a new page and seed it with intro text plus live frames (database views, page transclusions) in one audited step. The result is ordinary editable content \u2014 every frame stays live and human-editable. Requires confirmApply: true.",
+    risk: "high",
+    requiredScopes: ["page.write"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: { type: "string", description: "New page title." },
+        intro: { type: "string", description: "Optional intro paragraph (markdown)." },
+        placements: placementsSchema,
+        confirmApply: { type: "boolean", description: "Must be true to create and compose." },
+        intent: { type: "string" }
+      },
+      required: ["title", "placements", "confirmApply"]
+    }
+  },
+  execute: async (host, args) => {
+    const title = readRequiredString(args, "title");
+    const placements = readPlacements(args);
+    const body = frameMarkdownBody(readOptionalString(args, "intro"), placements);
+    return host.composePage({
+      title,
+      markdown: body,
+      confirmApply: args.confirmApply === true,
+      actor: readOptionalString(args, "actor") ?? "ai-agent",
+      intent: readOptionalString(args, "intent") ?? `Compose page "${title}"`,
+      extra: readOptionalRecord(args, "extra") ?? void 0
+    });
+  }
+};
+var frameToolEntries = [
+  planFramePlacementTool,
+  applyFramePlacementTool,
+  composePageTool
+];
+
 // src/ai-surface/tools/search.ts
 var searchTool = {
   definition: {
@@ -1404,7 +1554,9 @@ var BUILT_IN_TOOL_ENTRIES = [
   rollbackPageMarkdownTool,
   ...databaseToolEntries,
   ...canvasToolEntries,
-  validateMutationPlanTool
+  validateMutationPlanTool,
+  // Frame placement (0346) — appended last to keep prior positions stable.
+  ...frameToolEntries
 ];
 var BUILT_IN_TOOLS_BY_NAME = new Map(
   BUILT_IN_TOOL_ENTRIES.map((entry) => [entry.definition.name, entry])
@@ -1463,6 +1615,7 @@ var AiSurfaceService = class {
     planPagePatch: (args) => this.planPagePatch(args),
     applyPageMarkdown: (args) => this.applyPageMarkdown(args),
     rollbackPageMarkdown: (args) => this.rollbackPageMarkdown(args),
+    composePage: (args) => this.composePage(args),
     getAuditLog: (options) => this.getAuditLog(options),
     describeDatabase: (databaseId, options) => this.describeDatabase(databaseId, options),
     readDatabaseViews: (databaseId) => this.readDatabaseViews(databaseId),
@@ -1903,6 +2056,42 @@ var AiSurfaceService = class {
       errors: markdownValidation.validation.errors
     });
   }
+  /**
+   * Compose a page of frames (0346, Phase 5): create the Page node, then
+   * plan + apply its markdown content (intro + frame directives) through
+   * the standard page pipeline — one audited step, rollbackable via the
+   * page-markdown rollback handle (the created page itself is reported
+   * so a rejected compose can be cleaned up).
+   */
+  async composePage(args) {
+    if (!args.confirmApply) {
+      throw new Error("confirmApply must be true to compose a page");
+    }
+    const created = await this.config.store.create({
+      schemaId: "xnet://xnet.fyi/Page@1.0.0",
+      properties: { title: args.title, ...args.extra ?? {} }
+    });
+    const frontmatterBody = args.markdown;
+    const plan = await this.planPagePatch({
+      pageId: created.id,
+      markdown: frontmatterBody,
+      actor: args.actor ?? "ai-agent",
+      intent: args.intent ?? `Compose page "${args.title}"`
+    });
+    if (plan.status !== "validated") {
+      return { pageId: created.id, planId: plan.id, applied: false, plan };
+    }
+    const result = await this.applyPageMarkdown({
+      plan,
+      confirmApply: true
+    });
+    return {
+      pageId: created.id,
+      planId: plan.id,
+      applied: result.applied ?? false,
+      result
+    };
+  }
   async applyPageMarkdown(args) {
     const confirmApply = readOptionalBoolean(args, "confirmApply") ?? false;
     if (!confirmApply) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/plugins",
-  "version": "2.4.0",
+  "version": "3.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -11,12 +11,12 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./node": {
-      "import": "./dist/services/node.js",
-      "types": "./dist/services/node.d.ts"
+      "types": "./dist/services/node.d.ts",
+      "import": "./dist/services/node.js"
     }
   },
   "files": [
@@ -31,11 +31,11 @@
   "dependencies": {
     "acorn": "^8.15.0",
     "yjs": "^13.6.24",
-    "@xnetjs/abuse": "2.4.0",
-    "@xnetjs/core": "2.4.0",
-    "@xnetjs/trust": "0.0.2",
-    "@xnetjs/data": "2.4.0",
-    "@xnetjs/slack-compat": "0.0.2"
+    "@xnetjs/abuse": "3.0.0",
+    "@xnetjs/core": "3.0.0",
+    "@xnetjs/trust": "0.0.3",
+    "@xnetjs/data": "3.0.0",
+    "@xnetjs/slack-compat": "0.0.3"
   },
   "peerDependencies": {
     "react": "^18.0.0"
@@ -47,7 +47,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^4.0.0",
-    "@xnetjs/licenses": "0.0.23"
+    "@xnetjs/licenses": "0.0.25"
   },
   "scripts": {
     "build": "tsup",