@xnetjs/plugins 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -563,29 +563,38 @@ interface SchemaContribution {
     schema: unknown;
 }
 /**
- * SurfaceDock tier (exploration 0273). `hero` panels render as the corner
- * launcher's one-tap strip; `secondary` panels live behind "More" and the
- * command palette. Same progressive-disclosure grammar as the devtools
+ * Slot prominence (0273, generalized in 0280). `hero` views render in
+ * their region's one-tap strip; `secondary` views live behind "More" and
+ * the command palette. Same progressive-disclosure grammar as the devtools
  * panel registry (packages/devtools/src/panels/panel-registry.ts), lifted
  * to an app-level contribution point.
  */
 type SurfaceDockTier = 'hero' | 'secondary';
 /**
- * A panel summoned from the quiet shell's bottom-right dock launcher
- * (exploration 0273). First-party residents are the workbench tray views
- * (Shelf, Capture, Notifications, Sync, Console); features and plugins add
- * their own the way they contribute rail items today.
+ * The shell's region skeleton a slot view may occupy (exploration 0280).
+ * Mirrors the app's LayoutTree regions: edge strips (`rail`, `status`)
+ * and the four docks. The `surface` center is not a slot target — views
+ * there are routes/tabs, not panels.
  */
-interface SurfaceDockContribution {
-    /** Unique panel ID, preferably plugin-scoped */
+type SlotRegion = 'rail' | 'status' | 'dock.left' | 'dock.right' | 'dock.bottom' | 'dock.corner';
+/**
+ * A view contributed to the shell's slot system (exploration 0280 —
+ * generalizing the 0273 SurfaceDock contract to every region). Where the
+ * view actually sits is the user's layout tree; `defaultRegion` only says
+ * where it lands until the user (or their agent) moves it, and
+ * `allowedRegions` bounds where it may go. A plugin places only its OWN
+ * views; moving anyone else's is the user's (or consented agent's) call.
+ */
+interface SlotContribution {
+    /** Unique view ID, preferably plugin-scoped */
     id: string;
-    /** Display name in the launcher strip / More menu / palette */
+    /** Display name in strips / menus / palette */
     label: string;
     /** Lucide icon name or component */
     icon?: string | ComponentType;
-    /** Disclosure tier: hero = launcher strip, secondary = More + palette */
+    /** Prominence within the region: hero = strip, secondary = More + palette */
     tier: SurfaceDockTier;
-    /** Grouping key for the More menu (e.g. 'capture', 'activity') */
+    /** Grouping key for menus (e.g. 'capture', 'activity', 'tools') */
     group?: string;
     /** Extra palette search terms */
     keywords?: string[];
@@ -595,9 +604,18 @@ interface SurfaceDockContribution {
     priority?: number;
     /** Dynamic badge (e.g. unread count); null hides it */
     badge?: () => string | number | null;
-    /** The panel body, rendered inside the dock sheet/strip */
+    /** The view body, rendered inside its region's host */
     component: ComponentType;
+    /** Where the view lands if the user hasn't placed it (default: dock.corner) */
+    defaultRegion?: SlotRegion;
+    /** Regions the view may occupy (empty/undefined = any region) */
+    allowedRegions?: SlotRegion[];
 }
+/**
+ * @deprecated Since 0280 — use {@link SlotContribution}. The dock was the
+ * first slot region; the contract is now region-agnostic.
+ */
+type SurfaceDockContribution = SlotContribution;
 type CanvasPreviewTier = 'summary' | 'thumbnail' | 'shell' | 'live';
 type CanvasIngestInputKind = 'url' | 'file' | 'data-transfer' | 'text' | 'node' | 'custom';
 type CanvasToolGroup = 'select' | 'create' | 'connect' | 'annotate' | 'layout' | 'custom';
@@ -763,7 +781,9 @@ declare class ContributionRegistry {
     readonly importers: TypedRegistry<ImporterContribution>;
     readonly mentionProviders: TypedRegistry<MentionProviderContribution>;
     readonly agentTools: TypedRegistry<AgentToolContribution>;
-    readonly surfaceDock: TypedRegistry<SurfaceDockContribution>;
+    readonly slots: TypedRegistry<SlotContribution>;
+    /** @deprecated Since 0280 — the dock registry is the slot registry. */
+    get surfaceDock(): TypedRegistry<SlotContribution>;
     /**
      * Clear all registries (for cleanup/testing)
      */
@@ -1036,6 +1056,8 @@ interface ExtensionContext {
     registerMentionProvider(provider: MentionProviderContribution): Disposable$1;
     /** Register a model-facing agent tool (exploration 0196) */
     registerAgentTool(tool: AgentToolContribution): Disposable$1;
+    /** Register a shell slot view (exploration 0280) */
+    registerSlotView(view: SlotContribution): Disposable$1;
     /** Add middleware to NodeStore */
     addMiddleware(middleware: NodeStoreMiddleware): Disposable$1;
     /** Plugin-private storage */
@@ -1167,6 +1189,12 @@ interface PluginContributions {
     mentionProviders?: MentionProviderContribution[];
     /** Model-facing agent tools — what a Connector exposes (exploration 0196). */
     agentTools?: AgentToolContribution[];
+    /**
+     * Shell slot views (exploration 0280): panels the shell hosts in its
+     * docks/strips. A plugin's views land at their `defaultRegion` (default:
+     * the corner dock) and move with the user's layout tree thereafter.
+     */
+    slots?: SlotContribution[];
 }
 declare class PluginValidationError extends Error {
     readonly issues: string[];
@@ -1182,6 +1210,105 @@ declare function validateManifest(manifest: unknown): XNetExtension;
  */
 declare function defineExtension(manifest: XNetExtension): XNetExtension;
 
+/**
+ * LayoutTree — the shell as data (exploration 0280).
+ *
+ * One tree of regions → slots → view references replaces the hard fork
+ * between the calm shell and the workbench grid. The former shells become
+ * *presets*: named, data-only configurations of the same tree (`quiet`,
+ * `calm`, `bench`). Components never branch on which preset is loaded —
+ * only on the tree's axes (chrome posture, slot tiers, tabsEnabled); the
+ * source-grep tripwire in layout-tree.test.ts enforces this.
+ *
+ * The module is pure (no DOM, no zustand) so presets round-trip through
+ * the `xnet:workspace` node payload and unit tests without a shell.
+ */
+
+type ChromePosture = 'pinned' | 'quiet';
+/**
+ * The fixed region skeleton (the Zed/VS Code lesson: regions never
+ * multiply, only their contents move). `surface` is the center and always
+ * exists; the slot regions (docks + edge strips) come from the
+ * contribution contract.
+ */
+type RegionId = 'surface' | SlotRegion;
+declare const REGION_IDS: RegionId[];
+/**
+ * Disclosure tier of a placed view: `pinned` renders in the frame at rest,
+ * `summoned` is reachable from its region's launcher/chord/palette,
+ * `hidden` only from the palette.
+ */
+type SlotTier = 'pinned' | 'summoned' | 'hidden';
+interface SlotPlacement {
+    /** Contribution id from the slot registry (e.g. 'navigator', 'shelf'). */
+    viewId: string;
+    tier: SlotTier;
+    /** Sort key within the region (lower = earlier). */
+    order: number;
+}
+interface LayoutTree {
+    /** Which workspace (preset or saved node) this tree was loaded from. */
+    workspaceId: string;
+    regions: Record<RegionId, SlotPlacement[]>;
+    /**
+     * Surface capabilities. Tabs/split groups are content state and stay in
+     * the workbench store; the tree only says whether the surface *shows*
+     * them (the bench's tab strip vs the calm bare surface).
+     */
+    surface: {
+        tabsEnabled: boolean;
+    };
+    /** Chrome posture axis (0273) — orthogonal to placements. */
+    chrome: ChromePosture;
+}
+/** Built-in presets — read-only system workspaces (0280 phase 3). */
+type PresetId = 'quiet' | 'calm' | 'bench';
+declare const PRESET_IDS: PresetId[];
+/** Deterministic node ids for the seeded system workspaces. */
+declare const PRESET_WORKSPACE_ID_PREFIX = "workspace-preset-";
+declare function presetWorkspaceId(preset: PresetId): string;
+/** Whether a workspace id denotes a built-in preset (not a saved node). */
+declare function isPresetWorkspaceId(workspaceId: string): boolean;
+declare function presetForWorkspaceId(workspaceId: string): PresetId | null;
+/**
+ * Build the tree for a built-in preset. Presets are data ONLY — every
+ * difference between the former shells must be expressible here, or it
+ * does not exist.
+ */
+declare function createPresetTree(preset: PresetId): LayoutTree;
+/** The region currently holding a view, if any. */
+declare function regionOf(tree: LayoutTree, viewId: string): RegionId | null;
+/** The placement record for a view, if any. */
+declare function placementOf(tree: LayoutTree, viewId: string): SlotPlacement | null;
+/**
+ * Move a view to another region (appended last), keeping its tier.
+ * No-op when the view is absent or already there.
+ */
+declare function moveSlot(tree: LayoutTree, viewId: string, to: RegionId): LayoutTree;
+/** Change a placed view's disclosure tier. No-op when absent/unchanged. */
+declare function setSlotTier(tree: LayoutTree, viewId: string, tier: SlotTier): LayoutTree;
+/** Placements of a region, sorted, optionally filtered to a tier. */
+declare function slotsIn(tree: LayoutTree, region: RegionId, tier?: SlotTier): SlotPlacement[];
+/**
+ * Portable workspace payload: the tree plus a human name. Device-local
+ * state (pixel sizes, monitor splits) deliberately stays OUT of the node —
+ * it lives in the local store keyed by workspaceId.
+ */
+interface WorkspacePayload {
+    name: string;
+    /** Preset provenance, for "Reset to preset". Null = built from scratch. */
+    preset: PresetId | null;
+    tree: LayoutTree;
+}
+/**
+ * Parse an untrusted payload (a synced node) back into a tree. Unknown
+ * regions are dropped, missing regions become empty, malformed placements
+ * are skipped — a shared workspace must never crash the shell.
+ */
+declare function parseWorkspacePayload(value: unknown): WorkspacePayload | null;
+/** Serialize for the node payload. Inverse of {@link parseWorkspacePayload}. */
+declare function serializeWorkspacePayload(payload: WorkspacePayload): WorkspacePayload;
+
 /**
  * @xnetjs/plugins — importer resolution (exploration 0189).
  *
@@ -2284,6 +2411,13 @@ declare function runConnectorSync(def: ConnectorDefinition, ports: RunConnectorS
  * renders on top of this; the view itself is app-side.
  */
 
+/**
+ * What a marketplace listing distributes (exploration 0280). `plugin` is
+ * the default (code, install-gated); `workspace` is a shared bench — a
+ * `xnet:Workspace` node payload, pure data: importing one never runs code,
+ * so it needs no sandbox tier, only the normal node import path.
+ */
+type MarketplaceListingKind = 'plugin' | 'workspace';
 /** A single entry in the marketplace index (`registry.json`). */
 interface MarketplaceEntry {
     id: string;
@@ -2291,6 +2425,8 @@ interface MarketplaceEntry {
     description: string;
     version: string;
     author: string;
+    /** Listing kind (default `plugin`). `workspace` = a shared bench (0280). */
+    kind?: MarketplaceListingKind;
     /** Search keywords / tags. */
     keywords?: string[];
     /** Coarse category for filtering (`productivity`, `finance`, `social`, …). */
@@ -2299,6 +2435,11 @@ interface MarketplaceEntry {
     capabilities?: ModuleCapabilities;
     /** URL the full manifest is fetched from at install. */
     manifestUrl: string;
+    /**
+     * For `kind: 'workspace'` listings: URL of the workspace payload JSON
+     * (the portable tree — parsed by `parseWorkspacePayload` on import).
+     */
+    workspaceUrl?: string;
     /** Lifetime install count (trust signal). */
     installs?: number;
     /** GitHub stars / community signal. */
@@ -3430,7 +3571,7 @@ declare function createTestPluginHarness(options?: TestHarnessOptions): TestPlug
  * (0196 — sync an external service into governed nodes + expose agent tools).
  */
 
-type ScaffoldTemplate = 'client' | 'two-sided' | 'ai-script' | 'connector';
+type ScaffoldTemplate = 'client' | 'two-sided' | 'ai-script' | 'connector' | 'slot-view';
 interface ScaffoldSpec {
     /** Reverse-domain plugin id, e.g. `com.acme.kanban`. */
     id: string;
@@ -5892,4 +6033,4 @@ declare function leaveWithEverything(ports: RightToLeavePorts, opts: {
  */
 declare function deleteDay(ports: RightToLeavePorts, opts: DeleteDayOptions): Promise<DeleteDayResult>;
 
-export { type AIComplexityLevel, type AICostModel, type AIGenerateRequest, type AIGenerateResponse, AIGenerationError, type AIMessage, type AIMessageRole, type AIModelCapabilities, type AIModelQuality, type AIPrivacyLevel, type AIProvider, type AIProviderConfig, type AIProviderOptions, AIProviderRouter, type AIProviderRouterOptions, type AIProviderType, type AIProviderUsage, AIRTABLE_CONNECTOR_ID, type AIRiskLevel, type AIScriptRequest, type AIScriptResponse, type AIStreamChunk, type AIToolCall, type AIToolSpec, type AIUsage, AI_GENERATED_PROVENANCE, AI_RISK_LEVELS, AI_SCOPES, AI_TARGET_KINDS, ALLOWED_PLUGIN_LICENSES, type ActionContext, type ActionDefinition, ActionDefinitionError, ActionDispatchError, type ActionEvent, ActionSsrfError, type ActionTrigger, type AgentToolContribution, type AgentToolInputSchema, type AiAgentApproval, type AiAgentApprovalRequestInput, type AiAgentApprovalResolveInput, type AiAgentApprovalStatus, type AiAgentBackgroundJob, type AiAgentBackgroundJobInput, type AiAgentBackgroundJobRunner, type AiAgentBackgroundJobStatus, type AiAgentDisplayState, type AiAgentDisplayStateKind, type AiAgentEvent, type AiAgentEventType, type AiAgentOrchestratorMode, type AiAgentRunSelectionTurnInput, type AiAgentRunTurnInput, type AiAgentRunTurnResult, AiAgentRuntime, type AiAgentRuntimeConfig, type AiAgentRuntimeListener, type AiAgentRuntimeSnapshot, type AiAgentRuntimeStorage, type AiAgentSelectionContext, type AiAgentSelectionKind, type AiAgentTelemetrySnapshot, type AiAgentThread, type AiAgentThreadCreateInput, type AiAgentThreadStatus, type AiAgentTurn, type AiAgentTurnRole, type AiAgentTurnStatus, type AiAssistMode, type AiAuditEvent, type AiAuthoredPlugin, AiAuthoringError, AiBudgetError, type AiCallableTool, type AiChangeSet, type AiCommandExposure, type AiContextPack, type AiContextPackResource, type AiContextRetriever, type AiContextSeed, type AiDatabaseMutationApplyResult, type AiExtraTool, type AiJsonSchema, type AiJsonSchemaType, type AiMutationPlan, type AiMutationPlanStatus, type AiOperation, type AiPageMarkdownApplyAdapter, type AiPageMarkdownApplyAdapterInput, type AiPageMarkdownApplyAdapterResult, type AiPageMarkdownApplyResult, type AiPageMarkdownRollbackResult, type AiPluginPipelineInput, type AiPluginPipelinePorts, type AiPluginPipelineResult, type AiResource, type AiResourceContent, type AiRetrievedNode, type AiRiskLevel, type AiScope, type AiSearchOptions, type AiSearchResult, type AiSurfaceLimits, AiSurfaceService, type AiSurfaceServiceConfig, type AiTargetKind, type AiToolCallResult, type AiToolDefinition, type AiValidationResult, type AirtableConnectorOptions, type AllowedPluginLicense, AnthropicProvider, type ArrayHelpers, type BlockContribution, type BlockProps, CANVAS_PLUGIN_FIXTURES, CHANNEL_SCHEMA, CHAT_MESSAGE_SCHEMA, CONNECTOR_CATEGORY, CONNECTOR_META, CRM_CANVAS_PLUGIN_FIXTURE, type CanvasCardContribution, type CanvasContribution, type CanvasContributionBase, type CanvasContributionPermission, type CanvasEdgeContribution, type CanvasErpPrototypeAuditEntry, type CanvasErpPrototypeAuditOperation, type CanvasErpPrototypeAuditSource, type CanvasErpPrototypeCard, type CanvasErpPrototypeCommand, type CanvasErpPrototypeEdge, type CanvasErpPrototypeEntityKind, type CanvasErpPrototypeLayoutKind, type CanvasErpPrototypeQueryFrame, type CanvasErpPrototypeQueryPredicate, type CanvasErpPrototypeRect, type CanvasErpPrototypeRisk, type CanvasErpPrototypeRiskSummary, type CanvasErpPrototypeScenario, type CanvasErpPrototypeStatus, type CanvasIngestInputKind, type CanvasIngestorContribution, type CanvasInspectorContribution, type CanvasInspectorPlacement, type CanvasLayoutContribution, type CanvasLayoutScope, type CanvasPluginFixture, type CanvasPluginFixtureCardSample, type CanvasPluginFixtureKind, type CanvasPluginPermissionDecisionStatus, type CanvasPluginPermissionGateDecision, type CanvasPluginPermissionGateInput, type CanvasPluginPermissionPrompt, type CanvasPluginPermissionPromptOption, type CanvasPluginPromptMode, type CanvasPluginSandboxDecision, type CanvasPluginSandboxDomAccess, type CanvasPluginSandboxKind, type CanvasPluginSandboxMutationAccess, type CanvasPluginSandboxNetworkAccess, type CanvasPluginSandboxOutput, type CanvasPluginSandboxOutputKind, type CanvasPluginSandboxOutputValidation, type CanvasPluginSandboxPolicy, type CanvasPluginSandboxRequest, type CanvasPluginWorkspacePolicy, type CanvasPreviewTier, type CanvasRendererSandboxContribution, type CanvasTemplateCategory, type CanvasTemplateContribution, type CanvasToolContribution, type CanvasToolGroup, CapabilityError, type CommandContext, type CommandContribution, CommandRegistry, type CommandScope, type ConnectorArtifacts, type ConnectorCadence, type ConnectorDefinition, ConnectorDefinitionError, type ConnectorDetection, type ConnectorEnv, type ConnectorFetch, type ConnectorInstallGate, type ConnectorStore, type ConnectorSyncContext, ConnectorSyncError, type ConnectorSyncResult, type ConnectorSyncSpec, type ConnectorTier, type ConnectorToolDescriptor, type ConsentDecision, type ConsentLine, ContributionRegistry, DEFAULT_PLUGIN_LICENSE, type DefinedAction, type DefinedConnector, type DeleteDayOptions, type DeleteDayResult, type DeliveryResult, DependencyCycleError, type DependencyNode, type Disposable$1 as Disposable, ERP_CANVAS_PLUGIN_FIXTURE, EXTERNAL_ITEM_SCHEMA, type EditorContribution, type EditorSchemaRisk, type EmailActionOptions, type ExtensionContext, type ExtensionStorage, FEED_ITEM_SCHEMA, type FeatureModule, type FeedEntry, type FetchJson, type FetchLike, type FlatNode, type FormatHelpers, GITHUB_CONNECTOR_ID, GOOGLE_CALENDAR_CONNECTOR_ID, type GeneratedScript, type GithubConnectorOptions, type GuardableConnectorStore, type IProcessManager, type ImporterContribution, type InstallOptions, LEAVE_README, LINEAR_CONNECTOR_ID, type LabRunOutcome, type LadderRuntimeTier, type LanguageModelLike, type LanguageModelMonitor, type LanguageModelSessionLike, type 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, type PendingChange, type Platform, type PlatformCapabilities, type PluginContributions, PluginError, type PluginNode, type PluginNodeChangeEvent, type PluginNodeChangeListener, type PluginPermissions, type PluginPricing, type PluginRating, PluginRegistry, type PluginRunInput, type PluginRunResult, PluginRuntimeError, type PluginRuntimeLadder, PluginSchema, type PluginStatus, PluginValidationError, type ProcessManagerEvents, type PromptApiAvailability, PromptApiProvider, type PromptApiProviderOptions, type PropertyCellProps, type PropertyEditorProps, type PropertyHandler, type PropertyHandlerContribution, type Provenance, type ProvenanceResult, type ProvenanceVerifier, type QueryFilter, RSS_CONNECTOR_ID, type RatingSummary, type RecommendOptions, type RegisteredPlugin, type ResolveMentionOptions, type RightToLeavePorts, type RssConnectorOptions, type RunActionPorts, type RunConnectorSyncPorts, type RunPluginCodeInput, SCAFFOLD_SYSTEM_GUARD, SERVICE_IPC_CHANNELS, SLACK_CONNECTOR_ID, type SandboxOptions, ScaffoldError, type ScaffoldResult, type ScaffoldSpec, type ScaffoldTemplate, type SchemaContribution, type SchemaData, type SchemaDefinition, type SchemaProperty, type SchemaRegistryAPI, type ScriptContext, ScriptError, type ScriptExecutionResult, type ScriptExecutor, ScriptGenerationError, ScriptGenerator, type ScriptGeneratorOptions, type ScriptNode, type ScriptNodeChangeEvent, type ScriptOutputType, ScriptRunner, type ScriptRunnerOptions, ScriptSandbox, ScriptSchema, type ScriptStore, ScriptTimeoutError, type ScriptToManifestInput, type ScriptTriggerType, ScriptValidationError, type SemVer, type ServiceClient, type ServiceCommunication, type ServiceDefinition, type ServiceHealthCheck, type ServiceLifecycle, type ServiceOutputEvent, type ServiceProcessConfig, type ServiceProvides, type ServiceState, type ServiceStatus, type ServiceStatusEvent, type SettingContribution, type SettingsPanelProps, ShortcutManager, type SidebarContribution, type SlackConnectorOptions, type SlashCommandContext, type SlashCommandContribution, type StatusBarContribution, type SurfaceDockContribution, type SurfaceDockTier, type TelemetryReporter, type TestHarnessOptions, type TestNodeStore, type TestPluginHarness, type TextHelpers, type ToolCallingFidelity, type ToolbarContribution, TypedRegistry, type UsageSignal, type ValidationResult, type VerifyProvenanceInput, type ViewContribution, type ViewProps, type WebLLMEngineLike, WebLLMProvider, type WebLLMProviderOptions, type WebhookConfig, WebhookEmitter, type WebhookOutOptions, type WebhookPayload, type WidgetContribution, type WidgetContributionConfigField, type WidgetContributionProps, type WorkspaceCommand, type WrapCliConnectorOptions, type WriteMode, XNET_MARKDOWN_DIRECTIVE_SPECS, type XNetExtension, type XNetMarkdownDiffLine, type XNetMarkdownDiffLineKind, type XNetMarkdownDirective, type XNetMarkdownDirectiveSpec, type XNetMarkdownReviewDiff, type XNetPageMarkdownFrontmatter, type XNetPageMarkdownValidation, type XNetPageMarkdownValidationOptions, agentToolToExtraTool, agentToolsAsExtraTools, aggregateRatings, assertNetwork, assertPublicUrl, assertSchemaWrite, assertSystemAudio, assistTurnProvenance, attachAiPlanValidation, buildAirtableConnector, buildDiscordAction, buildEmailAction, buildGithubConnector, buildGoogleCalendarConnector, buildLinearConnector, buildNotionConnector, buildRetryPrompt, buildRssConnector, buildScriptPrompt, buildSlackConnector, buildSlackWebhookAction, buildTelegramAction, buildWebhookOutAction, classifyAiAgentDisplayState, compareVersions, composeAssistSystemPrompt, connectorAsImporter, connectorMarketplaceEntry, contributionsAsAiTools, createAIProvider, createAIProviderRouter, createAiAgentRuntime, createAiChangeSet, createAiOperation, createAiSurfaceService, createAiValidationResult, createCanvasErpPrototypeRiskSummary, createCanvasErpPrototypeScenario, createCanvasPluginFixtureCards, createCanvasPluginFixtureManifests, createCanvasPluginPermissionPrompt, createCanvasPluginSandboxPolicy, createCanvasPreviewSandboxRequest, createCanvasRendererSandboxRequest, createExtensionContext, createExtensionStorage, createManagedProvider, createMemoryAiAgentRuntimeStorage, createPromptApiProvider, createScriptContext, createServiceClient, createTestNodeStore, createTestPluginHarness, createWebLLMProvider, createWebhookEmitter, defaultLocalServerProbes, defineAction, defineConnector, defineExtension, defineFeatureModule, deleteDay, describeCapabilities, detectConnectors, detectUpcomingMeeting, downloadPromptApiModel, emitConnectorArtifacts, evaluateCanvasPluginPermissionGate, evaluateCanvasPluginSandboxRequest, evaluateConnectorInstall, evaluateInstallConsent, executeScript, failClosedVerifier, filterByCategory, findEditorSchemaRisks, findMissingDependencies, generateScript, getCanvasErpPrototypeAuditEntriesForCard, getCanvasErpPrototypeCardsForFrame, getCanvasPluginFixture, getCommandRegistry, getPlatformCapabilities, getShortcutManager, getXNetMarkdownDirectiveSpecs, guardStore, guardedActionFetch, guardedFetch, hasUpdate, importerAdapters, installCommandHandler, installShortcutHandler, isAiRiskLevel, isAiScope, isAiTargetKind, isAllowedPluginLicense, isHostCompatible, isNetworkAllowed, isOllamaAvailable, isPaidPricing, isSchemaDefiningExtension, isSchemaReadAllowed, isSchemaWriteAllowed, isScriptNode, isServiceClientAvailable, isSystemAudioAllowed, ladderTierForTrust, leaveWithEverything, listOllamaModels, matchSchemaIri, normalizeCanvasPluginWorkspacePolicy, packageName, parseAiMutationPlan, parseFeed, parseVersion, parseXNetPageFrontmatter, pascalCase, pickBestConnector, pluginLicenseText, probeOpenAiCompatible, promptApiAvailability, quickSafetyCheck, recommendExtensions, renderEvent, renderMarkdownLineDiff, renderMarkdownReviewDiff, renderSelectionPrompt, resolveImporters, resolveInstallOrder, resolveMentionProviders, runAction, runAiPluginPipeline, runConnectorSync, runPluginCode, satisfiesRange, scaffoldPlugin, scriptToPluginManifest, searchMarketplace, serializeAiMutationPlan, shortSchemaName, shouldDispatch, sortMarketplace, stripXNetPageFrontmatter, summarizeProvenance, validateAiMutationPlan, validateCanvasPluginSandboxOutput, validateManifest, validateScript, validateScriptAST, validateXNetPageMarkdown, verifyProvenance, warnOnEditorSchemaRisks, wrapCliConnector, writeModeFor };
+export { type AIComplexityLevel, type AICostModel, type AIGenerateRequest, type AIGenerateResponse, AIGenerationError, type AIMessage, type AIMessageRole, type AIModelCapabilities, type AIModelQuality, type AIPrivacyLevel, type AIProvider, type AIProviderConfig, type AIProviderOptions, AIProviderRouter, type AIProviderRouterOptions, type AIProviderType, type AIProviderUsage, AIRTABLE_CONNECTOR_ID, type AIRiskLevel, type AIScriptRequest, type AIScriptResponse, type AIStreamChunk, type AIToolCall, type AIToolSpec, type AIUsage, AI_GENERATED_PROVENANCE, AI_RISK_LEVELS, AI_SCOPES, AI_TARGET_KINDS, ALLOWED_PLUGIN_LICENSES, type ActionContext, type ActionDefinition, ActionDefinitionError, ActionDispatchError, type ActionEvent, ActionSsrfError, type ActionTrigger, type AgentToolContribution, type AgentToolInputSchema, type AiAgentApproval, type AiAgentApprovalRequestInput, type AiAgentApprovalResolveInput, type AiAgentApprovalStatus, type AiAgentBackgroundJob, type AiAgentBackgroundJobInput, type AiAgentBackgroundJobRunner, type AiAgentBackgroundJobStatus, type AiAgentDisplayState, type AiAgentDisplayStateKind, type AiAgentEvent, type AiAgentEventType, type AiAgentOrchestratorMode, type AiAgentRunSelectionTurnInput, type AiAgentRunTurnInput, type AiAgentRunTurnResult, AiAgentRuntime, type AiAgentRuntimeConfig, type AiAgentRuntimeListener, type AiAgentRuntimeSnapshot, type AiAgentRuntimeStorage, type AiAgentSelectionContext, type AiAgentSelectionKind, type AiAgentTelemetrySnapshot, type AiAgentThread, type AiAgentThreadCreateInput, type AiAgentThreadStatus, type AiAgentTurn, type AiAgentTurnRole, type AiAgentTurnStatus, type AiAssistMode, type AiAuditEvent, type AiAuthoredPlugin, AiAuthoringError, AiBudgetError, type AiCallableTool, type AiChangeSet, type AiCommandExposure, type AiContextPack, type AiContextPackResource, type AiContextRetriever, type AiContextSeed, type AiDatabaseMutationApplyResult, type AiExtraTool, type AiJsonSchema, type AiJsonSchemaType, type AiMutationPlan, type AiMutationPlanStatus, type AiOperation, type AiPageMarkdownApplyAdapter, type AiPageMarkdownApplyAdapterInput, type AiPageMarkdownApplyAdapterResult, type AiPageMarkdownApplyResult, type AiPageMarkdownRollbackResult, type AiPluginPipelineInput, type AiPluginPipelinePorts, type AiPluginPipelineResult, type AiResource, type AiResourceContent, type AiRetrievedNode, type AiRiskLevel, type AiScope, type AiSearchOptions, type AiSearchResult, type AiSurfaceLimits, AiSurfaceService, type AiSurfaceServiceConfig, type AiTargetKind, type AiToolCallResult, type AiToolDefinition, type AiValidationResult, type AirtableConnectorOptions, type AllowedPluginLicense, AnthropicProvider, type ArrayHelpers, type BlockContribution, type BlockProps, CANVAS_PLUGIN_FIXTURES, CHANNEL_SCHEMA, CHAT_MESSAGE_SCHEMA, CONNECTOR_CATEGORY, CONNECTOR_META, CRM_CANVAS_PLUGIN_FIXTURE, type CanvasCardContribution, type CanvasContribution, type CanvasContributionBase, type CanvasContributionPermission, type CanvasEdgeContribution, type CanvasErpPrototypeAuditEntry, type CanvasErpPrototypeAuditOperation, type CanvasErpPrototypeAuditSource, type CanvasErpPrototypeCard, type CanvasErpPrototypeCommand, type CanvasErpPrototypeEdge, type CanvasErpPrototypeEntityKind, type CanvasErpPrototypeLayoutKind, type CanvasErpPrototypeQueryFrame, type CanvasErpPrototypeQueryPredicate, type CanvasErpPrototypeRect, type CanvasErpPrototypeRisk, type CanvasErpPrototypeRiskSummary, type CanvasErpPrototypeScenario, type CanvasErpPrototypeStatus, type CanvasIngestInputKind, type CanvasIngestorContribution, type CanvasInspectorContribution, type CanvasInspectorPlacement, type CanvasLayoutContribution, type CanvasLayoutScope, type CanvasPluginFixture, type CanvasPluginFixtureCardSample, type CanvasPluginFixtureKind, type CanvasPluginPermissionDecisionStatus, type CanvasPluginPermissionGateDecision, type CanvasPluginPermissionGateInput, type CanvasPluginPermissionPrompt, type CanvasPluginPermissionPromptOption, type CanvasPluginPromptMode, type CanvasPluginSandboxDecision, type CanvasPluginSandboxDomAccess, type CanvasPluginSandboxKind, type CanvasPluginSandboxMutationAccess, type CanvasPluginSandboxNetworkAccess, type CanvasPluginSandboxOutput, type CanvasPluginSandboxOutputKind, type CanvasPluginSandboxOutputValidation, type CanvasPluginSandboxPolicy, type CanvasPluginSandboxRequest, type CanvasPluginWorkspacePolicy, type CanvasPreviewTier, type CanvasRendererSandboxContribution, type CanvasTemplateCategory, type CanvasTemplateContribution, type CanvasToolContribution, type CanvasToolGroup, CapabilityError, type ChromePosture, type CommandContext, type CommandContribution, CommandRegistry, type CommandScope, type ConnectorArtifacts, type ConnectorCadence, type ConnectorDefinition, ConnectorDefinitionError, type ConnectorDetection, type ConnectorEnv, type ConnectorFetch, type ConnectorInstallGate, type ConnectorStore, type ConnectorSyncContext, ConnectorSyncError, type ConnectorSyncResult, type ConnectorSyncSpec, type ConnectorTier, type ConnectorToolDescriptor, type ConsentDecision, type ConsentLine, ContributionRegistry, DEFAULT_PLUGIN_LICENSE, type DefinedAction, type DefinedConnector, type DeleteDayOptions, type DeleteDayResult, type DeliveryResult, DependencyCycleError, type DependencyNode, type Disposable$1 as Disposable, ERP_CANVAS_PLUGIN_FIXTURE, EXTERNAL_ITEM_SCHEMA, type EditorContribution, type EditorSchemaRisk, type EmailActionOptions, type ExtensionContext, type ExtensionStorage, FEED_ITEM_SCHEMA, type FeatureModule, type FeedEntry, type FetchJson, type FetchLike, type FlatNode, type FormatHelpers, GITHUB_CONNECTOR_ID, GOOGLE_CALENDAR_CONNECTOR_ID, type GeneratedScript, type GithubConnectorOptions, type GuardableConnectorStore, type IProcessManager, type ImporterContribution, type InstallOptions, LEAVE_README, LINEAR_CONNECTOR_ID, type LabRunOutcome, type LadderRuntimeTier, type LanguageModelLike, type LanguageModelMonitor, type LanguageModelSessionLike, type LayoutTree, type LeaveBundle, type LicenseCheckResult, LicenseRequiredError, type LinearConnectorOptions, type LocalAPIConfig, type LocalAPITokenConfig, type LocalAPITokenScope, type LocalAPITokenSummary, type LocalServerProbe, MARKETPLACE_PROVENANCE, type MCPPropertySchema, type MCPRequest, type MCPResource, type MCPResponse, type MCPServerConfig, type MCPTool, MEDIA_PROVIDER_CANVAS_PLUGIN_FIXTURE, type ManagedBudgetSnapshot, ManagedProvider, type ManagedProviderOptions, MarketplaceClient, type MarketplaceClientOptions, type MarketplaceEntry, type MarketplaceSort, type MathHelpers, type MentionProviderContribution, type MentionSuggestion, MiddlewareChain, type MissingDependency, type ModuleCapabilities, NOTION_CONNECTOR_ID, type NodeChangeEvent, type NodeChangeEventData, type NodeData, type NodeStoreAPI, type NodeStoreMiddleware, type NotionConnectorOptions, OllamaProvider, OpenAICompatibleProvider, type OpenAICompatibleProviderOptions, OpenAIProvider, PRESET_IDS, PRESET_WORKSPACE_ID_PREFIX, type PendingChange, type Platform, type PlatformCapabilities, type PluginContributions, PluginError, type PluginNode, type PluginNodeChangeEvent, type PluginNodeChangeListener, type PluginPermissions, type PluginPricing, type PluginRating, PluginRegistry, type PluginRunInput, type PluginRunResult, PluginRuntimeError, type PluginRuntimeLadder, PluginSchema, type PluginStatus, PluginValidationError, type PresetId, type ProcessManagerEvents, type PromptApiAvailability, PromptApiProvider, type PromptApiProviderOptions, type PropertyCellProps, type PropertyEditorProps, type PropertyHandler, type PropertyHandlerContribution, type Provenance, type ProvenanceResult, type ProvenanceVerifier, type QueryFilter, REGION_IDS, RSS_CONNECTOR_ID, type RatingSummary, type RecommendOptions, type RegionId, type RegisteredPlugin, type ResolveMentionOptions, type RightToLeavePorts, type RssConnectorOptions, type RunActionPorts, type RunConnectorSyncPorts, type RunPluginCodeInput, SCAFFOLD_SYSTEM_GUARD, SERVICE_IPC_CHANNELS, SLACK_CONNECTOR_ID, type SandboxOptions, ScaffoldError, type ScaffoldResult, type ScaffoldSpec, type ScaffoldTemplate, type SchemaContribution, type SchemaData, type SchemaDefinition, type SchemaProperty, type SchemaRegistryAPI, type ScriptContext, ScriptError, type ScriptExecutionResult, type ScriptExecutor, ScriptGenerationError, ScriptGenerator, type ScriptGeneratorOptions, type ScriptNode, type ScriptNodeChangeEvent, type ScriptOutputType, ScriptRunner, type ScriptRunnerOptions, ScriptSandbox, ScriptSchema, type ScriptStore, ScriptTimeoutError, type ScriptToManifestInput, type ScriptTriggerType, ScriptValidationError, type SemVer, type ServiceClient, type ServiceCommunication, type ServiceDefinition, type ServiceHealthCheck, type ServiceLifecycle, type ServiceOutputEvent, type ServiceProcessConfig, type ServiceProvides, type ServiceState, type ServiceStatus, type ServiceStatusEvent, type SettingContribution, type SettingsPanelProps, ShortcutManager, type SidebarContribution, type SlackConnectorOptions, type SlashCommandContext, type SlashCommandContribution, type SlotContribution, type SlotPlacement, type SlotRegion, type SlotTier, type StatusBarContribution, type SurfaceDockContribution, type SurfaceDockTier, type TelemetryReporter, type TestHarnessOptions, type TestNodeStore, type TestPluginHarness, type TextHelpers, type ToolCallingFidelity, type ToolbarContribution, TypedRegistry, type UsageSignal, type ValidationResult, type VerifyProvenanceInput, type ViewContribution, type ViewProps, type WebLLMEngineLike, WebLLMProvider, type WebLLMProviderOptions, type WebhookConfig, WebhookEmitter, type WebhookOutOptions, type WebhookPayload, type WidgetContribution, type WidgetContributionConfigField, type WidgetContributionProps, type WorkspaceCommand, type WorkspacePayload, type WrapCliConnectorOptions, type WriteMode, XNET_MARKDOWN_DIRECTIVE_SPECS, type XNetExtension, type XNetMarkdownDiffLine, type XNetMarkdownDiffLineKind, type XNetMarkdownDirective, type XNetMarkdownDirectiveSpec, type XNetMarkdownReviewDiff, type XNetPageMarkdownFrontmatter, type XNetPageMarkdownValidation, type XNetPageMarkdownValidationOptions, agentToolToExtraTool, agentToolsAsExtraTools, aggregateRatings, assertNetwork, assertPublicUrl, assertSchemaWrite, assertSystemAudio, assistTurnProvenance, attachAiPlanValidation, buildAirtableConnector, buildDiscordAction, buildEmailAction, buildGithubConnector, buildGoogleCalendarConnector, buildLinearConnector, buildNotionConnector, buildRetryPrompt, buildRssConnector, buildScriptPrompt, buildSlackConnector, buildSlackWebhookAction, buildTelegramAction, buildWebhookOutAction, classifyAiAgentDisplayState, compareVersions, composeAssistSystemPrompt, connectorAsImporter, connectorMarketplaceEntry, contributionsAsAiTools, createAIProvider, createAIProviderRouter, createAiAgentRuntime, createAiChangeSet, createAiOperation, createAiSurfaceService, createAiValidationResult, createCanvasErpPrototypeRiskSummary, createCanvasErpPrototypeScenario, createCanvasPluginFixtureCards, createCanvasPluginFixtureManifests, createCanvasPluginPermissionPrompt, createCanvasPluginSandboxPolicy, createCanvasPreviewSandboxRequest, createCanvasRendererSandboxRequest, createExtensionContext, createExtensionStorage, createManagedProvider, createMemoryAiAgentRuntimeStorage, createPresetTree, createPromptApiProvider, createScriptContext, createServiceClient, createTestNodeStore, createTestPluginHarness, createWebLLMProvider, createWebhookEmitter, defaultLocalServerProbes, defineAction, defineConnector, defineExtension, defineFeatureModule, deleteDay, describeCapabilities, detectConnectors, detectUpcomingMeeting, downloadPromptApiModel, emitConnectorArtifacts, evaluateCanvasPluginPermissionGate, evaluateCanvasPluginSandboxRequest, evaluateConnectorInstall, evaluateInstallConsent, executeScript, failClosedVerifier, filterByCategory, findEditorSchemaRisks, findMissingDependencies, generateScript, getCanvasErpPrototypeAuditEntriesForCard, getCanvasErpPrototypeCardsForFrame, getCanvasPluginFixture, getCommandRegistry, getPlatformCapabilities, getShortcutManager, getXNetMarkdownDirectiveSpecs, guardStore, guardedActionFetch, guardedFetch, hasUpdate, importerAdapters, installCommandHandler, installShortcutHandler, isAiRiskLevel, isAiScope, isAiTargetKind, isAllowedPluginLicense, isHostCompatible, isNetworkAllowed, isOllamaAvailable, isPaidPricing, isPresetWorkspaceId, isSchemaDefiningExtension, isSchemaReadAllowed, isSchemaWriteAllowed, isScriptNode, isServiceClientAvailable, isSystemAudioAllowed, ladderTierForTrust, leaveWithEverything, listOllamaModels, matchSchemaIri, moveSlot, normalizeCanvasPluginWorkspacePolicy, packageName, parseAiMutationPlan, parseFeed, parseVersion, parseWorkspacePayload, parseXNetPageFrontmatter, pascalCase, pickBestConnector, placementOf, pluginLicenseText, presetForWorkspaceId, presetWorkspaceId, probeOpenAiCompatible, promptApiAvailability, quickSafetyCheck, recommendExtensions, regionOf, renderEvent, renderMarkdownLineDiff, renderMarkdownReviewDiff, renderSelectionPrompt, resolveImporters, resolveInstallOrder, resolveMentionProviders, runAction, runAiPluginPipeline, runConnectorSync, runPluginCode, satisfiesRange, scaffoldPlugin, scriptToPluginManifest, searchMarketplace, serializeAiMutationPlan, serializeWorkspacePayload, setSlotTier, shortSchemaName, shouldDispatch, slotsIn, sortMarketplace, stripXNetPageFrontmatter, summarizeProvenance, validateAiMutationPlan, validateCanvasPluginSandboxOutput, validateManifest, validateScript, validateScriptAST, validateXNetPageMarkdown, verifyProvenance, warnOnEditorSchemaRisks, wrapCliConnector, writeModeFor };

package/dist/index.js

@@ -516,7 +516,11 @@ var ContributionRegistry = class {
   importers = new TypedRegistry();
   mentionProviders = new TypedRegistry();
   agentTools = new TypedRegistry();
-  surfaceDock = new TypedRegistry();
+  slots = new TypedRegistry();
+  /** @deprecated Since 0280 — the dock registry is the slot registry. */
+  get surfaceDock() {
+    return this.slots;
+  }
   /**
    * Clear all registries (for cleanup/testing)
    */
@@ -541,10 +545,201 @@ var ContributionRegistry = class {
     this.importers.clear();
     this.mentionProviders.clear();
     this.agentTools.clear();
-    this.surfaceDock.clear();
+    this.slots.clear();
   }
 };
 
+// src/workspace/layout-tree.ts
+var REGION_IDS = [
+  "surface",
+  "rail",
+  "status",
+  "dock.left",
+  "dock.right",
+  "dock.bottom",
+  "dock.corner"
+];
+var PRESET_IDS = ["quiet", "calm", "bench"];
+var PRESET_WORKSPACE_ID_PREFIX = "workspace-preset-";
+function presetWorkspaceId(preset) {
+  return `${PRESET_WORKSPACE_ID_PREFIX}${preset}`;
+}
+function isPresetWorkspaceId(workspaceId) {
+  return presetForWorkspaceId(workspaceId) !== null;
+}
+function presetForWorkspaceId(workspaceId) {
+  if (!workspaceId.startsWith(PRESET_WORKSPACE_ID_PREFIX)) return null;
+  const rest = workspaceId.slice(PRESET_WORKSPACE_ID_PREFIX.length);
+  return PRESET_IDS.includes(rest) ? rest : null;
+}
+function place(viewId, tier, order) {
+  return { viewId, tier, order };
+}
+function emptyRegions() {
+  return {
+    surface: [],
+    rail: [],
+    status: [],
+    "dock.left": [],
+    "dock.right": [],
+    "dock.bottom": [],
+    "dock.corner": []
+  };
+}
+function cornerResidents() {
+  return [
+    place("shelf", "summoned", 0),
+    place("capture", "summoned", 1),
+    place("notifications", "summoned", 2),
+    place("sync", "summoned", 3),
+    place("console", "summoned", 4)
+  ];
+}
+function createPresetTree(preset) {
+  const regions = emptyRegions();
+  switch (preset) {
+    case "quiet":
+      regions.rail = [place("modes", "summoned", 0)];
+      regions["dock.left"] = [place("navigator", "summoned", 0)];
+      regions["dock.right"] = [place("context", "summoned", 0)];
+      regions["dock.corner"] = cornerResidents();
+      return {
+        workspaceId: presetWorkspaceId("quiet"),
+        regions,
+        surface: { tabsEnabled: false },
+        chrome: "quiet"
+      };
+    case "calm":
+      regions.rail = [place("modes", "pinned", 0)];
+      regions["dock.left"] = [place("navigator", "pinned", 0)];
+      regions["dock.right"] = [place("context", "summoned", 0)];
+      regions["dock.corner"] = cornerResidents();
+      return {
+        workspaceId: presetWorkspaceId("calm"),
+        regions,
+        surface: { tabsEnabled: false },
+        chrome: "pinned"
+      };
+    case "bench":
+      regions.rail = [place("rail", "pinned", 0)];
+      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)
+      ];
+      regions["dock.right"] = [place("context", "summoned", 0)];
+      regions["dock.bottom"] = [
+        place("shelf", "summoned", 0),
+        place("capture", "summoned", 1),
+        place("notifications", "summoned", 2),
+        place("sync", "summoned", 3),
+        place("console", "summoned", 4)
+      ];
+      regions["dock.corner"] = [];
+      return {
+        workspaceId: presetWorkspaceId("bench"),
+        regions,
+        surface: { tabsEnabled: true },
+        chrome: "pinned"
+      };
+  }
+}
+function cloneRegions(regions) {
+  return Object.fromEntries(
+    Object.entries(regions).map(([region, placements]) => [
+      region,
+      placements.map((placement) => ({ ...placement }))
+    ])
+  );
+}
+function regionOf(tree, viewId) {
+  for (const region of REGION_IDS) {
+    if (tree.regions[region].some((placement) => placement.viewId === viewId)) return region;
+  }
+  return null;
+}
+function placementOf(tree, viewId) {
+  const region = regionOf(tree, viewId);
+  if (!region) return null;
+  return tree.regions[region].find((placement) => placement.viewId === viewId) ?? null;
+}
+function renumber(placements) {
+  return [...placements].sort((a, b) => a.order - b.order).map((placement, index) => ({ ...placement, order: index }));
+}
+function moveSlot(tree, viewId, to) {
+  const from = regionOf(tree, viewId);
+  if (!from || from === to) return tree;
+  const placement = tree.regions[from].find((entry) => entry.viewId === viewId);
+  if (!placement) return tree;
+  const regions = cloneRegions(tree.regions);
+  regions[from] = renumber(regions[from].filter((entry) => entry.viewId !== viewId));
+  regions[to] = renumber([...regions[to], { ...placement, order: Number.MAX_SAFE_INTEGER }]);
+  return { ...tree, regions };
+}
+function setSlotTier(tree, viewId, tier) {
+  const region = regionOf(tree, viewId);
+  if (!region) return tree;
+  const current = tree.regions[region].find((entry) => entry.viewId === viewId);
+  if (!current || current.tier === tier) return tree;
+  const regions = cloneRegions(tree.regions);
+  regions[region] = regions[region].map(
+    (entry) => entry.viewId === viewId ? { ...entry, tier } : entry
+  );
+  return { ...tree, regions };
+}
+function slotsIn(tree, region, tier) {
+  const placements = [...tree.regions[region]].sort((a, b) => a.order - b.order);
+  return tier ? placements.filter((placement) => placement.tier === tier) : placements;
+}
+var TIERS = ["pinned", "summoned", "hidden"];
+function isPlacement(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const p = value;
+  return typeof p.viewId === "string" && typeof p.order === "number" && TIERS.includes(p.tier);
+}
+function parseWorkspacePayload(value) {
+  if (typeof value !== "object" || value === null) return null;
+  const payload = value;
+  if (typeof payload.name !== "string") return null;
+  const rawTree = payload.tree;
+  if (typeof rawTree !== "object" || rawTree === null) return null;
+  if (typeof rawTree.workspaceId !== "string") return null;
+  const chrome = rawTree.chrome === "quiet" ? "quiet" : "pinned";
+  const rawSurface = rawTree.surface;
+  const tabsEnabled = rawSurface?.tabsEnabled === true;
+  const regions = emptyRegions();
+  const rawRegions = rawTree.regions;
+  if (typeof rawRegions === "object" && rawRegions !== null) {
+    for (const region of REGION_IDS) {
+      const entries = rawRegions[region];
+      if (!Array.isArray(entries)) continue;
+      regions[region] = renumber(entries.filter(isPlacement));
+    }
+  }
+  const preset = PRESET_IDS.includes(payload.preset) ? payload.preset : null;
+  return {
+    name: payload.name,
+    preset,
+    tree: { workspaceId: rawTree.workspaceId, regions, surface: { tabsEnabled }, chrome }
+  };
+}
+function serializeWorkspacePayload(payload) {
+  return {
+    name: payload.name,
+    preset: payload.preset,
+    tree: {
+      workspaceId: payload.tree.workspaceId,
+      regions: cloneRegions(payload.tree.regions),
+      surface: { tabsEnabled: payload.tree.surface.tabsEnabled },
+      chrome: payload.tree.chrome
+    }
+  };
+}
+
 // src/feature-module.ts
 function defineFeatureModule(module) {
   return module;
@@ -3314,6 +3509,11 @@ function createExtensionContext(options) {
       disposables.push(d);
       return d;
     },
+    registerSlotView(view) {
+      const d = contributions.slots.register(view);
+      disposables.push(d);
+      return d;
+    },
     addMiddleware(middleware) {
       if (!middlewareChain) {
         console.warn(`[Plugin ${pluginId}] Middleware not available on this platform`);
@@ -3833,6 +4033,11 @@ var PluginRegistry = class {
         ctx.registerAgentTool(tool);
       }
     }
+    if (c.slots) {
+      for (const view of c.slots) {
+        ctx.registerSlotView(view);
+      }
+    }
   }
   // ─── Load from Store ───────────────────────────────────────────────────
   /**
@@ -4203,7 +4408,13 @@ var ScaffoldError = class extends Error {
   }
 };
 var ID_RE3 = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9-]*)+$/i;
-var TEMPLATES = ["client", "two-sided", "ai-script", "connector"];
+var TEMPLATES = [
+  "client",
+  "two-sided",
+  "ai-script",
+  "connector",
+  "slot-view"
+];
 function validateSpec(spec) {
   if (!spec.id || !ID_RE3.test(spec.id)) {
     throw new ScaffoldError(`id must be reverse-domain (got: ${JSON.stringify(spec.id)})`);
@@ -4284,6 +4495,21 @@ var MODULE_BODIES = {
       }
     ]
   }`,
+  // A dockable shell panel (exploration 0280). Capability-scoped: the default
+  // manifest declares NO network and NO schemas — the essay's consent form
+  // starts empty and every grant is an explicit, visible addition.
+  "slot-view": (s) => `  capabilities: ${JSON.stringify(s.capabilities ?? { network: [] })},
+  contributes: {
+    slots: [
+      {
+        id: '${packageName(s.id)}',
+        label: '${s.name}',
+        tier: 'secondary',
+        defaultRegion: 'dock.corner',
+        component: ${pascalCase(s.id)}Panel
+      }
+    ]
+  }`,
   "ai-script": (s) => `  contributes: {
     commands: [
       {
@@ -4382,9 +4608,17 @@ function indexSource(spec) {
   pricing: ${JSON.stringify(spec.pricing)},` : "";
   const publisher = spec.publisherDid ? `
   publisherDid: '${spec.publisherDid}',` : "";
+  const slotPanel = spec.template === "slot-view" ? `import { createElement } from 'react'
+
+/** The panel body \u2014 replace with your view (createElement keeps it JSX-free). */
+function ${ctor}Panel() {
+  return createElement('div', { style: { padding: 12 } }, '${spec.name} panel')
+}
+
+` : "";
   return `import { defineFeatureModule } from '@xnetjs/plugins'
 
-export const ${ctor}Module = defineFeatureModule({
+${slotPanel}export const ${ctor}Module = defineFeatureModule({
   id: '${spec.id}',
   name: '${spec.name}',
   version: '0.1.0',${spec.author ? `
@@ -12129,12 +12363,15 @@ export {
   OllamaProvider,
   OpenAICompatibleProvider,
   OpenAIProvider,
+  PRESET_IDS,
+  PRESET_WORKSPACE_ID_PREFIX,
   PluginError,
   PluginRegistry,
   PluginRuntimeError,
   PluginSchema,
   PluginValidationError,
   PromptApiProvider,
+  REGION_IDS,
   RSS_CONNECTOR_ID,
   SCAFFOLD_SYSTEM_GUARD,
   SERVICE_IPC_CHANNELS,
@@ -12201,6 +12438,7 @@ export {
   createExtensionStorage,
   createManagedProvider,
   createMemoryAiAgentRuntimeStorage,
+  createPresetTree,
   createPromptApiProvider,
   createScriptContext,
   createServiceClient,
@@ -12252,6 +12490,7 @@ export {
   isNetworkAllowed,
   isOllamaAvailable,
   isPaidPricing,
+  isPresetWorkspaceId,
   isSchemaDefiningExtension,
   isSchemaReadAllowed,
   isSchemaWriteAllowed,
@@ -12262,19 +12501,25 @@ export {
   leaveWithEverything,
   listOllamaModels,
   matchSchemaIri,
+  moveSlot,
   normalizeCanvasPluginWorkspacePolicy,
   packageName,
   parseAiMutationPlan,
   parseFeed,
   parseVersion,
+  parseWorkspacePayload,
   parseXNetPageFrontmatter,
   pascalCase,
   pickBestConnector,
+  placementOf,
   pluginLicenseText,
+  presetForWorkspaceId,
+  presetWorkspaceId,
   probeOpenAiCompatible,
   promptApiAvailability,
   quickSafetyCheck,
   recommendExtensions,
+  regionOf,
   renderEvent,
   renderMarkdownLineDiff,
   renderMarkdownReviewDiff,
@@ -12293,8 +12538,11 @@ export {
   scriptToPluginManifest,
   searchMarketplace,
   serializeAiMutationPlan,
+  serializeWorkspacePayload,
+  setSlotTier,
   shortSchemaName,
   shouldDispatch,
+  slotsIn,
   sortMarketplace,
   stripXNetPageFrontmatter,
   summarizeProvenance,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/plugins",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -30,10 +30,10 @@
   },
   "dependencies": {
     "acorn": "^8.15.0",
-    "@xnetjs/abuse": "0.5.0",
-    "@xnetjs/core": "0.5.0",
+    "@xnetjs/abuse": "0.6.0",
+    "@xnetjs/core": "0.6.0",
     "@xnetjs/trust": "0.0.2",
-    "@xnetjs/data": "0.5.0",
+    "@xnetjs/data": "0.6.0",
     "@xnetjs/slack-compat": "0.0.2"
   },
   "peerDependencies": {
@@ -48,7 +48,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^4.0.0",
-    "@xnetjs/licenses": "0.0.9"
+    "@xnetjs/licenses": "0.0.10"
   },
   "scripts": {
     "build": "tsup",