@xnetjs/plugins 2.3.0 → 2.5.0

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 */
@@ -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;
@@ -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();
   }
 };
 
@@ -3473,6 +3475,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 +6360,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 +6635,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 +6696,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 +7137,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/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.3.0",
+  "version": "2.5.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -31,11 +31,11 @@
   "dependencies": {
     "acorn": "^8.15.0",
     "yjs": "^13.6.24",
-    "@xnetjs/abuse": "2.3.0",
-    "@xnetjs/core": "2.3.0",
-    "@xnetjs/trust": "0.0.2",
-    "@xnetjs/data": "2.3.0",
-    "@xnetjs/slack-compat": "0.0.2"
+    "@xnetjs/abuse": "2.5.0",
+    "@xnetjs/core": "2.5.0",
+    "@xnetjs/data": "2.5.0",
+    "@xnetjs/slack-compat": "0.0.2",
+    "@xnetjs/trust": "0.0.2"
   },
   "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.22"
+    "@xnetjs/licenses": "0.0.24"
   },
   "scripts": {
     "build": "tsup",