@pstdio/sdk 0.17.0 → 0.18.0

package/dist/api/extensions.d.ts

@@ -1 +1 @@
-export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ModeLayoutContributionRecord, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "pstdio-api-contracts";
+export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "pstdio-api-contracts";

package/dist/api/index.d.ts

@@ -1,5 +1,5 @@
 export type { CreateNotificationInput, ListNotificationsQuery, ListNotificationsResponse, Notification, NotificationAction, NotificationActionResult, NotificationActorType, NotificationKind, NotificationOrigin, NotificationPriority, NotificationStatus, ResourceRef, UpdateNotificationInput, } from "pstdio-api-contracts";
-export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "./extensions";
+export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "./extensions";
 export type { CreateProjectInput, RegisterRepoInput } from "./projects";
 export type { ApprovalInput, CreateSessionInput, FollowUpInput, ResolveSessionIdInput, ResolveSessionIdResponse, SessionAttachment, SessionAttachmentRef, SessionConversationResponse, } from "./sessions";
 export { sessionAttachmentMimeTypesByExtension } from "./sessions";

package/dist/api/index.js

@@ -13686,8 +13686,10 @@ var packageAsset = (path, baseUrl) => ({
   path,
   baseUrl
 });
+// ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
+var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
 // ../pstdio-api-contracts/src/extension-kernel/types/extension.ts
-var EXTENSION_API_VERSION = "1.0.0";
+var EXTENSION_API_VERSION = "1.0.0-alpha.2";
 // ../pstdio-api-contracts/src/extension-kernel/types/webview-capabilities.ts
 var WEBVIEW_HOST_CAPABILITY_VERSION = 1;
 var WEBVIEW_DECLARABLE_CAPABILITIES = [
@@ -13989,20 +13991,202 @@ var extensionCommandPaletteContributionSchema = exports_external.object({
   when: extensionWhenExpressionSchema.optional()
 });
 
-// ../pstdio-api-contracts/src/extensions/controls-renderer.ts
-var extensionControlsRendererRecordSchema = exports_external.object({
+// ../pstdio-api-contracts/src/extensions/execute.ts
+var extensionResourceRefSchema = exports_external.object({
+  type: exports_external.string(),
+  id: exports_external.string(),
+  projectId: exports_external.string().optional(),
+  label: exports_external.string().optional(),
+  extensionId: exports_external.string().optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var extensionRepoContextSchema = exports_external.object({
+  projectId: exports_external.string(),
+  repoId: exports_external.string(),
+  path: exports_external.string(),
+  remote: exports_external.string().nullable().optional(),
+  role: exports_external.enum(["default", "selected", "workspace"]).optional()
+});
+var extensionSlotInvocationSchema = exports_external.object({
+  id: exports_external.string(),
+  kind: extensionSlotKindSchema,
+  context: jsonObjectSchema
+});
+var extensionAttachmentInvocationSchema = exports_external.object({
+  target: workbenchAttachmentTargetSchema,
+  mode: exports_external.string().optional(),
+  projectId: exports_external.string().optional(),
+  resource: extensionResourceRefSchema.optional()
+});
+var extensionRendererContextSchema = exports_external.object({
+  rendererId: exports_external.string(),
+  projectId: exports_external.string().optional(),
+  modeId: exports_external.string().optional(),
+  resource: extensionResourceRefSchema.optional(),
+  invocation: exports_external.object({ placement: exports_external.enum(["visible", "background"]) }).optional()
+});
+var commandExecuteRequestSchema = exports_external.object({
+  projectId: exports_external.string().min(1),
+  workspaceId: exports_external.string().optional(),
+  params: jsonObjectSchema.optional(),
+  resource: extensionResourceRefSchema.optional(),
+  attachment: extensionAttachmentInvocationSchema.optional(),
+  slot: extensionSlotInvocationSchema.optional(),
+  repo: extensionRepoContextSchema.optional(),
+  source: commandSourceSchema.optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var commandExecuteBodySchema = exports_external.object({
+  workspaceId: exports_external.string().optional(),
+  params: jsonObjectSchema.optional(),
+  resource: extensionResourceRefSchema.optional(),
+  attachment: extensionAttachmentInvocationSchema.optional(),
+  slot: extensionSlotInvocationSchema.optional(),
+  repo: extensionRepoContextSchema.optional(),
+  source: commandSourceSchema.optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var dispatchExtensionEventBodySchema = exports_external.object({
+  eventId: exports_external.string().min(1),
+  payload: jsonObjectSchema
+}).strict();
+var serializedErrorSchema = exports_external.object({
+  name: exports_external.string().optional(),
+  message: exports_external.string(),
+  stack: exports_external.string().optional()
+});
+var commandNoticeSchema = exports_external.object({
+  type: exports_external.enum(["info", "success", "warning", "error"]),
+  title: exports_external.string().optional(),
+  message: exports_external.string(),
+  metadata: jsonObjectSchema.optional()
+});
+var commandDiagnosticSchema = exports_external.object({
+  code: exports_external.string(),
+  message: exports_external.string(),
+  severity: exports_external.enum(["info", "warning", "error"]),
+  extensionId: exports_external.string().optional(),
+  commandId: exports_external.string().optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var commandOutcomeSchema = exports_external.object({
+  ok: exports_external.boolean(),
+  status: exports_external.enum(["success", "rejected", "error"]),
+  value: exports_external.unknown().optional(),
+  code: exports_external.string().optional(),
+  reason: exports_external.string().optional(),
+  data: jsonObjectSchema.optional(),
+  error: serializedErrorSchema.optional(),
+  notices: exports_external.array(commandNoticeSchema).optional(),
+  diagnostics: exports_external.array(commandDiagnosticSchema).optional()
+});
+var commandExecuteResponseSchema = exports_external.object({
+  commandId: exports_external.string(),
+  extensionId: exports_external.string(),
+  eventIds: exports_external.array(exports_external.string()).optional(),
+  outcome: commandOutcomeSchema
+});
+
+// ../pstdio-api-contracts/src/extensions/composition.ts
+var dockedWorkbenchRegionSchema = exports_external.enum(dockedWorkbenchRegions);
+var extensionResourceSlotSchema = exports_external.object({
+  cardinality: exports_external.enum(["one", "many"]),
+  external: exports_external.boolean()
+});
+var extensionResourceKindRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  surface: exports_external.enum(["primary", "secondary", "attached"]),
+  label: localizableStringSchema.optional(),
+  icon: exports_external.string().optional(),
+  slots: exports_external.record(exports_external.string(), extensionResourceSlotSchema)
+});
+var extensionResourcePanelRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  resourceKind: exports_external.string(),
+  panel: exports_external.string(),
+  slot: exports_external.string()
+});
+var panelBodySchema = {
+  webview: exports_external.object({ entry: exports_external.object({ kind: exports_external.literal("package-asset"), path: exports_external.string(), baseUrl: exports_external.string() }) }).optional(),
+  renderer: exports_external.object({ kind: exports_external.enum(["tree", "file", "controls", "dataTable", "kanban"]), id: exports_external.string() }).optional()
+};
+var extensionModePlacementSchema = exports_external.object({
+  region: dockedWorkbenchRegionSchema,
+  allowedRegions: exports_external.array(dockedWorkbenchRegionSchema).optional(),
+  required: exports_external.boolean().optional(),
+  defaultOpen: exports_external.boolean().optional(),
+  pinned: exports_external.boolean().optional()
+});
+var extensionPanelPlacementSchema = exports_external.object({
+  for: exports_external.string().optional(),
+  region: dockedWorkbenchRegionSchema,
+  allowedRegions: exports_external.array(dockedWorkbenchRegionSchema).optional(),
+  required: exports_external.boolean().optional()
+});
+var extensionCompositionPanelRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
   title: localizableStringSchema,
-  queryCommandId: exports_external.string(),
-  updateValueCommandId: exports_external.string().optional(),
-  applyCommandId: exports_external.string().optional(),
-  resetCommandId: exports_external.string().optional(),
-  refreshEventIds: exports_external.array(exports_external.string()).optional(),
-  defaultValues: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  icon: exports_external.string().optional(),
+  show: exports_external.union([extensionPanelPlacementSchema, exports_external.array(extensionPanelPlacementSchema).min(1)]).optional(),
+  ...panelBodySchema
+}).refine((value) => [value.webview, value.renderer].filter(Boolean).length === 1, {
+  message: "Composition panels must declare exactly one body"
+});
+var extensionModeResourceRecipeSchema = exports_external.object({
+  slots: exports_external.record(exports_external.string(), extensionModePlacementSchema).optional(),
+  panels: exports_external.record(exports_external.string(), extensionModePlacementSchema).optional()
+});
+var extensionModeCompositionRecordSchema = exports_external.object({
+  resources: exports_external.record(exports_external.string(), extensionModeResourceRecipeSchema),
+  modePanels: exports_external.record(exports_external.string(), extensionModePlacementSchema).optional(),
+  defaultResource: exports_external.union([extensionResourceRefSchema, exports_external.object({ commandId: exports_external.string() })]).optional()
+});
+var workbenchNavigationTargetSchema = exports_external.object({
+  modeId: exports_external.string().optional(),
+  resource: extensionResourceRefSchema.optional(),
+  replaceActive: exports_external.boolean().optional()
+});
+var extensionResourceHierarchyProviderRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  resourceKind: exports_external.string(),
+  metadata: jsonObjectSchema.optional()
+});
+
+// ../pstdio-api-contracts/src/extensions/renderers.ts
+var extensionRendererRecordBaseSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  title: localizableStringSchema,
+  icon: exports_external.string().optional(),
+  resourceKind: exports_external.string().optional(),
+  refreshEventIds: exports_external.array(exports_external.string().min(1)).optional(),
   emptyTitle: localizableStringSchema.optional(),
   emptyDescription: localizableStringSchema.optional()
 });
+var extensionTreeRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  bodyHandlerId: exports_external.string(),
+  childrenHandlerId: exports_external.string().optional(),
+  footerHandlerId: exports_external.string().optional(),
+  defaultExpandedSectionIds: exports_external.array(exports_external.string()).optional(),
+  defaultExpandedNodeIds: exports_external.array(exports_external.string()).optional()
+});
+var extensionFileRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  loadHandlerId: exports_external.string(),
+  saveHandlerId: exports_external.string().optional()
+});
+
+// ../pstdio-api-contracts/src/extensions/controls-renderer.ts
+var extensionControlsRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  queryHandlerId: exports_external.string(),
+  valueChangeHandlerId: exports_external.string().optional(),
+  applyHandlerId: exports_external.string().optional(),
+  resetHandlerId: exports_external.string().optional(),
+  defaultValues: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+});
 
 // ../pstdio-api-contracts/src/extensions/data-table-renderer.ts
 var themeColorSchema = exports_external.object({
@@ -14049,20 +14233,15 @@ var selectionActionSchema = exports_external.object({
   destructive: exports_external.boolean().optional(),
   commandId: exports_external.string()
 });
-var extensionDataTableRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  resourceKind: exports_external.string().optional(),
+var extensionDataTableRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
   columns: exports_external.array(dataTableRendererColumnSchema).optional(),
-  queryCommandId: exports_external.string(),
+  queryHandlerId: exports_external.string(),
   selectionMode: exports_external.enum(["none", "multiple"]).optional(),
   selectionActions: exports_external.array(selectionActionSchema).optional(),
   rowActions: exports_external.array(rowActionSchema).optional(),
+  rowActivationHandlerId: exports_external.string().optional(),
   initialPageSize: exports_external.number().int().positive().optional(),
-  pageSizeOptions: exports_external.array(exports_external.number().int().positive()).optional(),
-  emptyTitle: localizableStringSchema.optional(),
-  emptyDescription: localizableStringSchema.optional()
+  pageSizeOptions: exports_external.array(exports_external.number().int().positive()).optional()
 });
 
 // ../pstdio-api-contracts/src/extensions/host-capabilities.ts
@@ -14153,25 +14332,20 @@ var extensionKanbanRendererRowActionSchema = exports_external.object({
   commandId: exports_external.string(),
   destructive: exports_external.boolean().optional()
 });
-var extensionKanbanRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
+var extensionKanbanRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
   extensionInstanceId: exports_external.string().optional(),
-  title: localizableStringSchema,
-  resourceKind: exports_external.string().optional(),
   attributes: exports_external.array(kanbanRendererAttributeSchema).optional(),
-  queryCommandId: exports_external.string(),
-  updateAttributeCommandId: exports_external.string().optional(),
-  reorderCommandId: exports_external.string().optional(),
-  columnActionCommandId: exports_external.string().optional(),
+  queryHandlerId: exports_external.string(),
+  attributeChangeHandlerId: exports_external.string().optional(),
+  reorderHandlerId: exports_external.string().optional(),
+  columnActionHandlerId: exports_external.string().optional(),
   createRow: extensionKanbanRendererCreateRowSchema.optional(),
   rowActions: exports_external.array(extensionKanbanRendererRowActionSchema).optional(),
+  rowActivationHandlerId: exports_external.string().optional(),
   defaultSettings: kanbanRendererSettingsSchema.partial().optional(),
   defaultFilters: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional(),
   defaultViews: exports_external.array(kanbanRendererSavedViewSchema).optional(),
   defaultActiveViewId: exports_external.string().optional(),
-  emptyTitle: localizableStringSchema.optional(),
-  emptyDescription: localizableStringSchema.optional(),
   hideToolbar: exports_external.boolean().optional()
 });
 var extensionCommandPaletteResourceRecordSchema = exports_external.object({
@@ -14180,7 +14354,7 @@ var extensionCommandPaletteResourceRecordSchema = exports_external.object({
   title: localizableStringSchema,
   resourceKind: exports_external.string().optional(),
   queryCommandId: exports_external.string(),
-  refreshEventIds: exports_external.array(exports_external.string()).optional()
+  refreshEventIds: exports_external.array(exports_external.string().min(1)).optional()
 });
 
 // ../pstdio-api-contracts/src/extensions/keybindings.ts
@@ -14209,21 +14383,15 @@ var extensionKeybindingRecordSchema = exports_external.object({
 });
 
 // ../pstdio-api-contracts/src/extensions/panels.ts
-var hasSinglePanelBody = (value) => [
-  value.webview,
-  value.treeRendererId,
-  value.fileRendererId,
-  value.controlsRendererId,
-  value.dataTableRendererId
-].filter(Boolean).length === 1;
-var singlePanelBodyMessage = "Extension panels must declare exactly one body: webview, treeRendererId, fileRendererId, controlsRendererId, or dataTableRendererId";
+var hasSinglePanelBody = (value) => [value.webview, value.renderer].filter(Boolean).length === 1;
+var singlePanelBodyMessage = "Extension panels must declare exactly one body: webview or renderer";
 var hostTreeDefaultSchema = exports_external.enum(["default", "none"]);
-var panelBodySchema = {
+var panelBodySchema2 = {
   webview: extensionWebviewContributionSchema.optional(),
-  treeRendererId: exports_external.string().optional(),
-  fileRendererId: exports_external.string().optional(),
-  controlsRendererId: exports_external.string().optional(),
-  dataTableRendererId: exports_external.string().optional()
+  renderer: exports_external.object({
+    kind: exports_external.enum(["tree", "file", "controls", "dataTable", "kanban"]),
+    id: exports_external.string()
+  }).optional()
 };
 var extensionPanelMenuRecordSchema = exports_external.object({
   id: exports_external.string(),
@@ -14235,7 +14403,7 @@ var extensionPanelMenuRecordSchema = exports_external.object({
   placement: extensionPlacementSchema.optional(),
   hostTreeHeader: hostTreeDefaultSchema.optional(),
   hostTreeFooter: hostTreeDefaultSchema.optional(),
-  ...panelBodySchema
+  ...panelBodySchema2
 }).refine(hasSinglePanelBody, { message: singlePanelBodyMessage });
 var workbenchExtensionPanelMenuRecordSchema = extensionPanelMenuRecordSchema.safeExtend({ webview: workbenchExtensionWebviewSchema.optional() }).refine(hasSinglePanelBody, { message: singlePanelBodyMessage });
 var extensionPanelRecordBaseSchema = exports_external.object({
@@ -14243,14 +14411,9 @@ var extensionPanelRecordBaseSchema = exports_external.object({
   extensionId: exports_external.string(),
   title: localizableStringSchema,
   icon: exports_external.string().optional(),
-  region: workbenchRegionSchema,
-  closable: exports_external.boolean(),
-  group: exports_external.string().optional(),
-  placement: extensionPlacementSchema.optional(),
-  resourceKind: exports_external.string().optional(),
-  eligibleLocations: exports_external.object({ resourceKinds: exports_external.array(exports_external.string()).optional() }).optional(),
+  show: exports_external.union([extensionPanelPlacementSchema, exports_external.array(extensionPanelPlacementSchema).min(1)]).optional(),
   panelMenus: exports_external.array(extensionPanelMenuRecordSchema).optional(),
-  ...panelBodySchema
+  ...panelBodySchema2
 });
 var extensionPanelRecordSchema = extensionPanelRecordBaseSchema.refine(hasSinglePanelBody, {
   message: singlePanelBodyMessage
@@ -14262,29 +14425,16 @@ var extensionRouteRecordSchema = exports_external.object({
   label: localizableStringSchema,
   webview: extensionWebviewContributionSchema
 });
-var extensionNavigationRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  slotId: exports_external.string(),
-  label: localizableStringSchema,
-  group: exports_external.string().optional(),
-  placement: extensionPlacementSchema.optional(),
-  route: exports_external.string().optional(),
-  href: exports_external.string().optional(),
-  commandId: exports_external.string().optional(),
-  params: jsonObjectSchema.optional(),
-  icon: exports_external.string().optional(),
-  when: extensionWhenExpressionSchema.optional()
-});
 var extensionTreeItemActionSchema = exports_external.discriminatedUnion("kind", [
   exports_external.object({
     kind: exports_external.literal("command"),
     commandId: exports_external.string(),
     args: jsonObjectSchema.optional()
   }),
-  exports_external.object({ kind: exports_external.literal("kanbanRenderer"), kanbanRendererId: exports_external.string() }),
+  exports_external.object({ kind: exports_external.literal("panel"), panelId: exports_external.string() }),
   exports_external.object({ kind: exports_external.literal("route"), route: exports_external.string() }),
-  exports_external.object({ kind: exports_external.literal("href"), href: exports_external.string() })
+  exports_external.object({ kind: exports_external.literal("href"), href: exports_external.string() }),
+  exports_external.object({ kind: exports_external.literal("resource"), resource: extensionResourceRefSchema })
 ]);
 var extensionActivityItemRecordSchema = exports_external.object({
   id: exports_external.string(),
@@ -14301,33 +14451,26 @@ var extensionTreeItemContributionSchema = exports_external.object({
   extensionId: exports_external.string(),
   target: workbenchTreeTargetSchema,
   label: localizableStringSchema,
-  group: exports_external.string().optional(),
+  group: exports_external.string().nullable().optional(),
   placement: extensionPlacementSchema.optional(),
   icon: exports_external.string().optional(),
   action: extensionTreeItemActionSchema,
   when: extensionWhenExpressionSchema.optional()
 });
-var modeTargetContributionRecordSchema = exports_external.object({
-  panel: exports_external.string().optional(),
-  resource: exports_external.string().optional(),
-  region: workbenchRegionSchema.optional(),
-  title: localizableStringSchema.optional(),
-  pinned: exports_external.boolean().optional()
-}).refine((value) => value.panel || value.resource, {
-  message: "Mode layout entries must declare a panel or resource"
-});
-var modeLayoutContributionRecordSchema = exports_external.object({
-  panels: exports_external.array(exports_external.enum(workbenchModePanels)).optional(),
-  open: exports_external.array(modeTargetContributionRecordSchema).optional()
-});
 var extensionModeRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
   modeId: exports_external.string(),
   label: localizableStringSchema,
   icon: exports_external.string().optional(),
-  resourceKind: exports_external.string().optional(),
-  layout: modeLayoutContributionRecordSchema.optional()
+  panelRegions: exports_external.array(exports_external.enum(workbenchModePanels)).optional()
+}).extend(extensionModeCompositionRecordSchema.partial().shape);
+var extensionStatusItemRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  title: localizableStringSchema,
+  when: extensionWhenExpressionSchema.optional(),
+  webview: workbenchExtensionWebviewSchema.optional()
 });
 var workbenchExtensionPanelRecordSchema = extensionPanelRecordBaseSchema.extend({
   extensionInstanceId: exports_external.string().optional(),
@@ -14349,28 +14492,6 @@ var extensionViewLikeSchema = exports_external.object({
   extensionId: exports_external.string()
 });
 
-// ../pstdio-api-contracts/src/extensions/renderers.ts
-var extensionTreeRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  icon: exports_external.string().optional(),
-  bodyCommandId: exports_external.string(),
-  childrenCommandId: exports_external.string().optional(),
-  footerCommandId: exports_external.string().optional(),
-  defaultExpandedSectionIds: exports_external.array(exports_external.string()).optional(),
-  defaultExpandedNodeIds: exports_external.array(exports_external.string()).optional()
-});
-var extensionFileRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  icon: exports_external.string().optional(),
-  resourceKind: exports_external.string().optional(),
-  loadCommandId: exports_external.string(),
-  saveCommandId: exports_external.string().optional()
-});
-
 // ../pstdio-api-contracts/src/extensions/settings.ts
 var extensionSettingsPanelRecordSchema = exports_external.object({
   id: exports_external.string(),
@@ -14436,7 +14557,6 @@ var extensionsCheckResponseSchema = exports_external.object({
   modes: exports_external.array(extensionModeRecordSchema),
   panels: exports_external.array(extensionPanelRecordSchema),
   routes: exports_external.array(extensionRouteRecordSchema),
-  navigation: exports_external.array(extensionNavigationRecordSchema),
   treeItems: exports_external.array(extensionTreeItemContributionSchema),
   activityItems: exports_external.array(extensionActivityItemRecordSchema).optional(),
   settingsPanels: exports_external.array(extensionSettingsPanelRecordSchema),
@@ -14472,8 +14592,11 @@ var workbenchExtensionMetadataSchema = exports_external.object({
   commandPaletteContributions: exports_external.array(extensionCommandPaletteContributionSchema).optional(),
   modes: exports_external.array(extensionModeRecordSchema),
   panels: exports_external.array(workbenchExtensionPanelRecordSchema),
+  resourceKinds: exports_external.array(extensionResourceKindRecordSchema).optional(),
+  resourcePanels: exports_external.array(extensionResourcePanelRecordSchema).optional(),
+  resourceHierarchyProviders: exports_external.array(extensionResourceHierarchyProviderRecordSchema).optional(),
+  statusItems: exports_external.array(extensionStatusItemRecordSchema).optional(),
   routes: exports_external.array(workbenchExtensionRouteRecordSchema),
-  navigation: exports_external.array(extensionNavigationRecordSchema),
   treeItems: exports_external.array(extensionTreeItemContributionSchema).optional(),
   activityItems: exports_external.array(extensionActivityItemRecordSchema).optional(),
   settingsSections: exports_external.array(extensionSettingsSectionRecordSchema).optional(),
@@ -14504,93 +14627,6 @@ var listExtensionAppearanceResponseSchema = exports_external.object({
   translations: exports_external.array(extensionTranslationRecordSchema),
   diagnostics: exports_external.array(extensionDiagnosticSchema)
 });
-// ../pstdio-api-contracts/src/extensions/execute.ts
-var extensionResourceRefSchema = exports_external.object({
-  type: exports_external.string(),
-  id: exports_external.string(),
-  projectId: exports_external.string().optional(),
-  label: exports_external.string().optional(),
-  extensionId: exports_external.string().optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var extensionRepoContextSchema = exports_external.object({
-  projectId: exports_external.string(),
-  repoId: exports_external.string(),
-  path: exports_external.string(),
-  remote: exports_external.string().nullable().optional(),
-  role: exports_external.enum(["default", "selected", "workspace"]).optional()
-});
-var extensionSlotInvocationSchema = exports_external.object({
-  id: exports_external.string(),
-  kind: extensionSlotKindSchema,
-  context: jsonObjectSchema
-});
-var extensionAttachmentInvocationSchema = exports_external.object({
-  target: workbenchAttachmentTargetSchema,
-  mode: exports_external.string().optional(),
-  projectId: exports_external.string().optional(),
-  resource: extensionResourceRefSchema.optional()
-});
-var commandExecuteRequestSchema = exports_external.object({
-  projectId: exports_external.string().min(1),
-  workspaceId: exports_external.string().optional(),
-  params: jsonObjectSchema.optional(),
-  resource: extensionResourceRefSchema.optional(),
-  attachment: extensionAttachmentInvocationSchema.optional(),
-  slot: extensionSlotInvocationSchema.optional(),
-  repo: extensionRepoContextSchema.optional(),
-  source: commandSourceSchema.optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var commandExecuteBodySchema = exports_external.object({
-  workspaceId: exports_external.string().optional(),
-  params: jsonObjectSchema.optional(),
-  resource: extensionResourceRefSchema.optional(),
-  attachment: extensionAttachmentInvocationSchema.optional(),
-  slot: extensionSlotInvocationSchema.optional(),
-  repo: extensionRepoContextSchema.optional(),
-  source: commandSourceSchema.optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var dispatchExtensionEventBodySchema = exports_external.object({
-  eventId: exports_external.string().min(1),
-  payload: jsonObjectSchema
-}).strict();
-var serializedErrorSchema = exports_external.object({
-  name: exports_external.string().optional(),
-  message: exports_external.string(),
-  stack: exports_external.string().optional()
-});
-var commandNoticeSchema = exports_external.object({
-  type: exports_external.enum(["info", "success", "warning", "error"]),
-  title: exports_external.string().optional(),
-  message: exports_external.string(),
-  metadata: jsonObjectSchema.optional()
-});
-var commandDiagnosticSchema = exports_external.object({
-  code: exports_external.string(),
-  message: exports_external.string(),
-  severity: exports_external.enum(["info", "warning", "error"]),
-  extensionId: exports_external.string().optional(),
-  commandId: exports_external.string().optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var commandOutcomeSchema = exports_external.object({
-  ok: exports_external.boolean(),
-  status: exports_external.enum(["success", "rejected", "error"]),
-  value: exports_external.unknown().optional(),
-  code: exports_external.string().optional(),
-  reason: exports_external.string().optional(),
-  data: jsonObjectSchema.optional(),
-  error: serializedErrorSchema.optional(),
-  notices: exports_external.array(commandNoticeSchema).optional(),
-  diagnostics: exports_external.array(commandDiagnosticSchema).optional()
-});
-var commandExecuteResponseSchema = exports_external.object({
-  commandId: exports_external.string(),
-  extensionId: exports_external.string(),
-  outcome: commandOutcomeSchema
-});
 // ../pstdio-api-contracts/src/extensions/install.ts
 var enableInstalledExtensionRequestSchema = exports_external.object({
   displayName: exports_external.string(),
@@ -14627,7 +14663,8 @@ var projectExtensionInstanceSchema = exports_external.object({
   lastLoadedAt: exports_external.string().nullable().optional(),
   lastError: jsonObjectSchema.nullable().optional(),
   enabled: exports_external.boolean(),
-  config: exports_external.record(exports_external.string(), exports_external.unknown())
+  config: exports_external.record(exports_external.string(), exports_external.unknown()),
+  updateAvailable: exports_external.boolean()
 });
 var listProjectExtensionsResponseSchema = exports_external.object({
   extensions: exports_external.array(projectExtensionInstanceSchema)

package/dist/client/index.js

@@ -281,6 +281,8 @@ var buildSessionsQuery = (projectId, input = {}) => {
     params.append("status", input.status);
   if (input.agent)
     params.append("agent", input.agent);
+  if (input.workspaceId)
+    params.append("workspace_id", input.workspaceId);
   if (input.archived)
     params.append("archived", "true");
   return params.toString();

package/dist/client/sessions.d.ts

@@ -5,6 +5,7 @@ import { type SseEvent } from "./sse";
 export type ListSessionsInput = {
     status?: string;
     agent?: string;
+    workspaceId?: string;
     archived?: boolean;
 };
 export type SessionClient = {

package/dist/extensions/define-extension.d.ts

@@ -42,8 +42,7 @@ type ExtensionAuthoringDefinition<TCommandSchemas extends CommandSchemas, TMiddl
 };
 /**
  * Identity helper that types the passed contributions. Authors get autocomplete on
- * contributions, and `commandsOf(packageName, ext)` can derive typed refs from the
- * returned definition. Extension identity (id, name, version, description, publisher,
+ * contributions. Extension identity (id, name, version, description, publisher,
  * engines.pstdio) lives in package.json.
  *
  * @example

package/dist/extensions/index.d.ts

@@ -1,12 +1,12 @@
 export type { CreateNotificationInput, ListNotificationsQuery, ListNotificationsResponse, Notification, NotificationAction, NotificationActionResult, NotificationActorType, NotificationKind, NotificationOrigin, NotificationPriority, NotificationStatus, UpdateNotificationInput, } from "pstdio-api-contracts";
 export type * from "pstdio-api-contracts/extension-kernel";
 export type { CommitPayload, ConflictPayload, MergePayload, RebasePayload, SessionLifecyclePayload, WorkspaceProvisionPayload, WorkspaceType, WorktreeRemovedPayload, } from "pstdio-api-contracts/extension-kernel";
-export { ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES, EXTENSION_API_VERSION, getWorkbenchModeLayoutTargetPanel, getWorkbenchTargetDefinition, gitEvents, isLocalizedString, type Localizable, type LocalizedString, l10n, packageAsset, projectEvents, projectSlots, sessionEvents, sessionSlots, WEBVIEW_DECLARABLE_CAPABILITIES, WEBVIEW_HOST_CAPABILITIES, WEBVIEW_HOST_CAPABILITY_VERSION, type WorkbenchAttachmentTarget, type WorkbenchContributionKind, type WorkbenchLayoutTarget, type WorkbenchMenuTarget, type WorkbenchModeLayoutTarget, type WorkbenchModePanel, type WorkbenchSettingsScope, type WorkbenchSettingsTarget, type WorkbenchTargetDefinition, type WorkbenchTargetGranularity, type WorkbenchTreeTarget, type WorkbenchViewTarget, workbenchMenuTargets, workbenchModeLayoutTargets, workbenchModePanels, workbenchSettingsScopes, workbenchSettingsTargets, workbenchTargets, workbenchTreeTargets, workbenchViewTargets, workspaceEvents, workspaceSlots, worktreeEvents, } from "pstdio-api-contracts/extension-kernel";
+export { ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES, dockedWorkbenchRegions, EXTENSION_API_VERSION, getWorkbenchModeLayoutTargetPanel, getWorkbenchTargetDefinition, gitEvents, isLocalizedString, type Localizable, type LocalizedString, l10n, packageAsset, projectEvents, projectSlots, sessionEvents, sessionSlots, WEBVIEW_DECLARABLE_CAPABILITIES, WEBVIEW_HOST_CAPABILITIES, WEBVIEW_HOST_CAPABILITY_VERSION, type WorkbenchAttachmentTarget, type WorkbenchContributionKind, type WorkbenchLayoutTarget, type WorkbenchMenuTarget, type WorkbenchModeLayoutTarget, type WorkbenchModePanel, type WorkbenchSettingsScope, type WorkbenchSettingsTarget, type WorkbenchTargetDefinition, type WorkbenchTargetGranularity, type WorkbenchTreeTarget, type WorkbenchViewTarget, workbenchMenuTargets, workbenchModeLayoutTargets, workbenchModePanels, workbenchSettingsScopes, workbenchSettingsTargets, workbenchTargets, workbenchTreeTargets, workbenchViewTargets, workspaceEvents, workspaceSlots, worktreeEvents, } from "pstdio-api-contracts/extension-kernel";
 export { type CommandResponse, unwrapCommandOutcome } from "./command-outcome";
 export { defineCommand, defineHook, defineMiddleware } from "./define-command";
 export { defineExtension } from "./define-extension";
 export { defineExtensionView, type ExtensionViewModule, type ExtensionViewRender, type ExtensionViewRenderContext, type GuestHost, type PropsStore, type WebviewFilesClient, } from "./define-extension-view";
 export { params } from "./params";
-export { commandEvent, commandRef, commandsOf, eventRef } from "./refs";
+export { commandEvent, commandRef, eventRef } from "./refs";
 export { createTerminalSessionBridge, type TerminalSessionAdapter, type TerminalSessionBridge, type TerminalSessionExit, } from "./terminal-session-bridge";
 export { matchesResourceWhen } from "./when";

package/dist/extensions/index.js

@@ -82,8 +82,10 @@ var packageAsset = (path, baseUrl) => ({
   path,
   baseUrl
 });
+// ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
+var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
 // ../pstdio-api-contracts/src/extension-kernel/types/extension.ts
-var EXTENSION_API_VERSION = "1.0.0";
+var EXTENSION_API_VERSION = "1.0.0-alpha.2";
 // ../pstdio-api-contracts/src/extension-kernel/types/webview-capabilities.ts
 var WEBVIEW_HOST_CAPABILITY_VERSION = 1;
 var WEBVIEW_DECLARABLE_CAPABILITIES = [
@@ -303,14 +305,6 @@ var params = {
 var commandEvent = (command, phase) => ({
   id: `command.${phase}:${command.id}`
 });
-var commandsOf = (packageName, extension) => {
-  const refs = {};
-  const commands = extension.commands ?? {};
-  for (const key of Object.keys(commands)) {
-    refs[key] = { id: `${packageName}.${key}` };
-  }
-  return refs;
-};
 // src/extensions/terminal-session-bridge.ts
 var TERMINAL_SESSION_CAPABILITY = "terminal.session";
 var createTerminalSessionBridge = (host) => ({
@@ -416,13 +410,13 @@ export {
   getWorkbenchTargetDefinition,
   getWorkbenchModeLayoutTargetPanel,
   eventRef,
+  dockedWorkbenchRegions,
   defineMiddleware,
   defineHook,
   defineExtensionView,
   defineExtension,
   defineCommand,
   createTerminalSessionBridge,
-  commandsOf,
   commandRef,
   commandEvent,
   WEBVIEW_HOST_CAPABILITY_VERSION,

package/dist/extensions/refs.d.ts

@@ -1,4 +1,4 @@
-import type { CommandDefinition, CommandLifecycleEventPayload, CommandLifecyclePhase, CommandRef, EventRef, ParamObjectSchema, ParamsOf, Struct } from "pstdio-api-contracts/extension-kernel";
+import type { CommandLifecycleEventPayload, CommandLifecyclePhase, CommandRef, EventRef, Struct } from "pstdio-api-contracts/extension-kernel";
 export { commandRef, eventRef } from "pstdio-api-contracts/extension-kernel";
 /**
  * Build an `EventRef` for a command lifecycle phase (`requested`, `started`, `completed`,
@@ -6,23 +6,3 @@ export { commandRef, eventRef } from "pstdio-api-contracts/extension-kernel";
  * the correct shape.
  */
 export declare const commandEvent: <TPhase extends CommandLifecyclePhase, TParams extends Struct = Struct, TResult = unknown>(command: CommandRef<TParams, TResult>, phase: TPhase) => EventRef<CommandLifecycleEventPayload<TPhase, TParams, TResult>>;
-type CommandsRecord = Record<string, CommandDefinition<any, any, any>>;
-type CommandRefFromDefinition<TDefinition> = TDefinition extends CommandDefinition<infer TSchema, infer TResult, infer _TSettings> ? CommandRef<TSchema extends ParamObjectSchema ? ParamsOf<TSchema> : Struct, TResult> : never;
-type CommandsRefMap<TCommands extends CommandsRecord> = {
-    [K in keyof TCommands]: CommandRefFromDefinition<TCommands[K]>;
-};
-/**
- * Derive typed `CommandRef`s from an extension contribution object. Renaming a
- * command in the definition surfaces as a type error wherever the ref is used.
- *
- * The package name is explicit because identity now lives in package.json, not in
- * `defineExtension()`.
- *
- * @example
- *   const ext = defineExtension({ commands: { ... } });
- *   const labCommands = commandsOf("extension-lab", ext);
- *   labCommands.awaken; // CommandRef<{ title?: string }, ...>
- */
-export declare const commandsOf: <TExtension extends {
-    commands?: CommandsRecord;
-}>(packageName: string, extension: TExtension) => CommandsRefMap<NonNullable<TExtension["commands"]>>;

package/dist/resources/index.js

@@ -13686,8 +13686,10 @@ var packageAsset = (path, baseUrl) => ({
   path,
   baseUrl
 });
+// ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
+var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
 // ../pstdio-api-contracts/src/extension-kernel/types/extension.ts
-var EXTENSION_API_VERSION = "1.0.0";
+var EXTENSION_API_VERSION = "1.0.0-alpha.2";
 // ../pstdio-api-contracts/src/extension-kernel/types/webview-capabilities.ts
 var WEBVIEW_HOST_CAPABILITY_VERSION = 1;
 var WEBVIEW_DECLARABLE_CAPABILITIES = [
@@ -13989,20 +13991,202 @@ var extensionCommandPaletteContributionSchema = exports_external.object({
   when: extensionWhenExpressionSchema.optional()
 });
 
-// ../pstdio-api-contracts/src/extensions/controls-renderer.ts
-var extensionControlsRendererRecordSchema = exports_external.object({
+// ../pstdio-api-contracts/src/extensions/execute.ts
+var extensionResourceRefSchema = exports_external.object({
+  type: exports_external.string(),
+  id: exports_external.string(),
+  projectId: exports_external.string().optional(),
+  label: exports_external.string().optional(),
+  extensionId: exports_external.string().optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var extensionRepoContextSchema = exports_external.object({
+  projectId: exports_external.string(),
+  repoId: exports_external.string(),
+  path: exports_external.string(),
+  remote: exports_external.string().nullable().optional(),
+  role: exports_external.enum(["default", "selected", "workspace"]).optional()
+});
+var extensionSlotInvocationSchema = exports_external.object({
+  id: exports_external.string(),
+  kind: extensionSlotKindSchema,
+  context: jsonObjectSchema
+});
+var extensionAttachmentInvocationSchema = exports_external.object({
+  target: workbenchAttachmentTargetSchema,
+  mode: exports_external.string().optional(),
+  projectId: exports_external.string().optional(),
+  resource: extensionResourceRefSchema.optional()
+});
+var extensionRendererContextSchema = exports_external.object({
+  rendererId: exports_external.string(),
+  projectId: exports_external.string().optional(),
+  modeId: exports_external.string().optional(),
+  resource: extensionResourceRefSchema.optional(),
+  invocation: exports_external.object({ placement: exports_external.enum(["visible", "background"]) }).optional()
+});
+var commandExecuteRequestSchema = exports_external.object({
+  projectId: exports_external.string().min(1),
+  workspaceId: exports_external.string().optional(),
+  params: jsonObjectSchema.optional(),
+  resource: extensionResourceRefSchema.optional(),
+  attachment: extensionAttachmentInvocationSchema.optional(),
+  slot: extensionSlotInvocationSchema.optional(),
+  repo: extensionRepoContextSchema.optional(),
+  source: commandSourceSchema.optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var commandExecuteBodySchema = exports_external.object({
+  workspaceId: exports_external.string().optional(),
+  params: jsonObjectSchema.optional(),
+  resource: extensionResourceRefSchema.optional(),
+  attachment: extensionAttachmentInvocationSchema.optional(),
+  slot: extensionSlotInvocationSchema.optional(),
+  repo: extensionRepoContextSchema.optional(),
+  source: commandSourceSchema.optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var dispatchExtensionEventBodySchema = exports_external.object({
+  eventId: exports_external.string().min(1),
+  payload: jsonObjectSchema
+}).strict();
+var serializedErrorSchema = exports_external.object({
+  name: exports_external.string().optional(),
+  message: exports_external.string(),
+  stack: exports_external.string().optional()
+});
+var commandNoticeSchema = exports_external.object({
+  type: exports_external.enum(["info", "success", "warning", "error"]),
+  title: exports_external.string().optional(),
+  message: exports_external.string(),
+  metadata: jsonObjectSchema.optional()
+});
+var commandDiagnosticSchema = exports_external.object({
+  code: exports_external.string(),
+  message: exports_external.string(),
+  severity: exports_external.enum(["info", "warning", "error"]),
+  extensionId: exports_external.string().optional(),
+  commandId: exports_external.string().optional(),
+  metadata: jsonObjectSchema.optional()
+});
+var commandOutcomeSchema = exports_external.object({
+  ok: exports_external.boolean(),
+  status: exports_external.enum(["success", "rejected", "error"]),
+  value: exports_external.unknown().optional(),
+  code: exports_external.string().optional(),
+  reason: exports_external.string().optional(),
+  data: jsonObjectSchema.optional(),
+  error: serializedErrorSchema.optional(),
+  notices: exports_external.array(commandNoticeSchema).optional(),
+  diagnostics: exports_external.array(commandDiagnosticSchema).optional()
+});
+var commandExecuteResponseSchema = exports_external.object({
+  commandId: exports_external.string(),
+  extensionId: exports_external.string(),
+  eventIds: exports_external.array(exports_external.string()).optional(),
+  outcome: commandOutcomeSchema
+});
+
+// ../pstdio-api-contracts/src/extensions/composition.ts
+var dockedWorkbenchRegionSchema = exports_external.enum(dockedWorkbenchRegions);
+var extensionResourceSlotSchema = exports_external.object({
+  cardinality: exports_external.enum(["one", "many"]),
+  external: exports_external.boolean()
+});
+var extensionResourceKindRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  surface: exports_external.enum(["primary", "secondary", "attached"]),
+  label: localizableStringSchema.optional(),
+  icon: exports_external.string().optional(),
+  slots: exports_external.record(exports_external.string(), extensionResourceSlotSchema)
+});
+var extensionResourcePanelRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  resourceKind: exports_external.string(),
+  panel: exports_external.string(),
+  slot: exports_external.string()
+});
+var panelBodySchema = {
+  webview: exports_external.object({ entry: exports_external.object({ kind: exports_external.literal("package-asset"), path: exports_external.string(), baseUrl: exports_external.string() }) }).optional(),
+  renderer: exports_external.object({ kind: exports_external.enum(["tree", "file", "controls", "dataTable", "kanban"]), id: exports_external.string() }).optional()
+};
+var extensionModePlacementSchema = exports_external.object({
+  region: dockedWorkbenchRegionSchema,
+  allowedRegions: exports_external.array(dockedWorkbenchRegionSchema).optional(),
+  required: exports_external.boolean().optional(),
+  defaultOpen: exports_external.boolean().optional(),
+  pinned: exports_external.boolean().optional()
+});
+var extensionPanelPlacementSchema = exports_external.object({
+  for: exports_external.string().optional(),
+  region: dockedWorkbenchRegionSchema,
+  allowedRegions: exports_external.array(dockedWorkbenchRegionSchema).optional(),
+  required: exports_external.boolean().optional()
+});
+var extensionCompositionPanelRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
   title: localizableStringSchema,
-  queryCommandId: exports_external.string(),
-  updateValueCommandId: exports_external.string().optional(),
-  applyCommandId: exports_external.string().optional(),
-  resetCommandId: exports_external.string().optional(),
-  refreshEventIds: exports_external.array(exports_external.string()).optional(),
-  defaultValues: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  icon: exports_external.string().optional(),
+  show: exports_external.union([extensionPanelPlacementSchema, exports_external.array(extensionPanelPlacementSchema).min(1)]).optional(),
+  ...panelBodySchema
+}).refine((value) => [value.webview, value.renderer].filter(Boolean).length === 1, {
+  message: "Composition panels must declare exactly one body"
+});
+var extensionModeResourceRecipeSchema = exports_external.object({
+  slots: exports_external.record(exports_external.string(), extensionModePlacementSchema).optional(),
+  panels: exports_external.record(exports_external.string(), extensionModePlacementSchema).optional()
+});
+var extensionModeCompositionRecordSchema = exports_external.object({
+  resources: exports_external.record(exports_external.string(), extensionModeResourceRecipeSchema),
+  modePanels: exports_external.record(exports_external.string(), extensionModePlacementSchema).optional(),
+  defaultResource: exports_external.union([extensionResourceRefSchema, exports_external.object({ commandId: exports_external.string() })]).optional()
+});
+var workbenchNavigationTargetSchema = exports_external.object({
+  modeId: exports_external.string().optional(),
+  resource: extensionResourceRefSchema.optional(),
+  replaceActive: exports_external.boolean().optional()
+});
+var extensionResourceHierarchyProviderRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  resourceKind: exports_external.string(),
+  metadata: jsonObjectSchema.optional()
+});
+
+// ../pstdio-api-contracts/src/extensions/renderers.ts
+var extensionRendererRecordBaseSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  title: localizableStringSchema,
+  icon: exports_external.string().optional(),
+  resourceKind: exports_external.string().optional(),
+  refreshEventIds: exports_external.array(exports_external.string().min(1)).optional(),
   emptyTitle: localizableStringSchema.optional(),
   emptyDescription: localizableStringSchema.optional()
 });
+var extensionTreeRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  bodyHandlerId: exports_external.string(),
+  childrenHandlerId: exports_external.string().optional(),
+  footerHandlerId: exports_external.string().optional(),
+  defaultExpandedSectionIds: exports_external.array(exports_external.string()).optional(),
+  defaultExpandedNodeIds: exports_external.array(exports_external.string()).optional()
+});
+var extensionFileRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  loadHandlerId: exports_external.string(),
+  saveHandlerId: exports_external.string().optional()
+});
+
+// ../pstdio-api-contracts/src/extensions/controls-renderer.ts
+var extensionControlsRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  queryHandlerId: exports_external.string(),
+  valueChangeHandlerId: exports_external.string().optional(),
+  applyHandlerId: exports_external.string().optional(),
+  resetHandlerId: exports_external.string().optional(),
+  defaultValues: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+});
 
 // ../pstdio-api-contracts/src/extensions/data-table-renderer.ts
 var themeColorSchema = exports_external.object({
@@ -14049,20 +14233,15 @@ var selectionActionSchema = exports_external.object({
   destructive: exports_external.boolean().optional(),
   commandId: exports_external.string()
 });
-var extensionDataTableRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  resourceKind: exports_external.string().optional(),
+var extensionDataTableRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
   columns: exports_external.array(dataTableRendererColumnSchema).optional(),
-  queryCommandId: exports_external.string(),
+  queryHandlerId: exports_external.string(),
   selectionMode: exports_external.enum(["none", "multiple"]).optional(),
   selectionActions: exports_external.array(selectionActionSchema).optional(),
   rowActions: exports_external.array(rowActionSchema).optional(),
+  rowActivationHandlerId: exports_external.string().optional(),
   initialPageSize: exports_external.number().int().positive().optional(),
-  pageSizeOptions: exports_external.array(exports_external.number().int().positive()).optional(),
-  emptyTitle: localizableStringSchema.optional(),
-  emptyDescription: localizableStringSchema.optional()
+  pageSizeOptions: exports_external.array(exports_external.number().int().positive()).optional()
 });
 
 // ../pstdio-api-contracts/src/extensions/host-capabilities.ts
@@ -14153,25 +14332,20 @@ var extensionKanbanRendererRowActionSchema = exports_external.object({
   commandId: exports_external.string(),
   destructive: exports_external.boolean().optional()
 });
-var extensionKanbanRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
+var extensionKanbanRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
   extensionInstanceId: exports_external.string().optional(),
-  title: localizableStringSchema,
-  resourceKind: exports_external.string().optional(),
   attributes: exports_external.array(kanbanRendererAttributeSchema).optional(),
-  queryCommandId: exports_external.string(),
-  updateAttributeCommandId: exports_external.string().optional(),
-  reorderCommandId: exports_external.string().optional(),
-  columnActionCommandId: exports_external.string().optional(),
+  queryHandlerId: exports_external.string(),
+  attributeChangeHandlerId: exports_external.string().optional(),
+  reorderHandlerId: exports_external.string().optional(),
+  columnActionHandlerId: exports_external.string().optional(),
   createRow: extensionKanbanRendererCreateRowSchema.optional(),
   rowActions: exports_external.array(extensionKanbanRendererRowActionSchema).optional(),
+  rowActivationHandlerId: exports_external.string().optional(),
   defaultSettings: kanbanRendererSettingsSchema.partial().optional(),
   defaultFilters: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional(),
   defaultViews: exports_external.array(kanbanRendererSavedViewSchema).optional(),
   defaultActiveViewId: exports_external.string().optional(),
-  emptyTitle: localizableStringSchema.optional(),
-  emptyDescription: localizableStringSchema.optional(),
   hideToolbar: exports_external.boolean().optional()
 });
 var extensionCommandPaletteResourceRecordSchema = exports_external.object({
@@ -14180,7 +14354,7 @@ var extensionCommandPaletteResourceRecordSchema = exports_external.object({
   title: localizableStringSchema,
   resourceKind: exports_external.string().optional(),
   queryCommandId: exports_external.string(),
-  refreshEventIds: exports_external.array(exports_external.string()).optional()
+  refreshEventIds: exports_external.array(exports_external.string().min(1)).optional()
 });
 
 // ../pstdio-api-contracts/src/extensions/keybindings.ts
@@ -14209,21 +14383,15 @@ var extensionKeybindingRecordSchema = exports_external.object({
 });
 
 // ../pstdio-api-contracts/src/extensions/panels.ts
-var hasSinglePanelBody = (value) => [
-  value.webview,
-  value.treeRendererId,
-  value.fileRendererId,
-  value.controlsRendererId,
-  value.dataTableRendererId
-].filter(Boolean).length === 1;
-var singlePanelBodyMessage = "Extension panels must declare exactly one body: webview, treeRendererId, fileRendererId, controlsRendererId, or dataTableRendererId";
+var hasSinglePanelBody = (value) => [value.webview, value.renderer].filter(Boolean).length === 1;
+var singlePanelBodyMessage = "Extension panels must declare exactly one body: webview or renderer";
 var hostTreeDefaultSchema = exports_external.enum(["default", "none"]);
-var panelBodySchema = {
+var panelBodySchema2 = {
   webview: extensionWebviewContributionSchema.optional(),
-  treeRendererId: exports_external.string().optional(),
-  fileRendererId: exports_external.string().optional(),
-  controlsRendererId: exports_external.string().optional(),
-  dataTableRendererId: exports_external.string().optional()
+  renderer: exports_external.object({
+    kind: exports_external.enum(["tree", "file", "controls", "dataTable", "kanban"]),
+    id: exports_external.string()
+  }).optional()
 };
 var extensionPanelMenuRecordSchema = exports_external.object({
   id: exports_external.string(),
@@ -14235,7 +14403,7 @@ var extensionPanelMenuRecordSchema = exports_external.object({
   placement: extensionPlacementSchema.optional(),
   hostTreeHeader: hostTreeDefaultSchema.optional(),
   hostTreeFooter: hostTreeDefaultSchema.optional(),
-  ...panelBodySchema
+  ...panelBodySchema2
 }).refine(hasSinglePanelBody, { message: singlePanelBodyMessage });
 var workbenchExtensionPanelMenuRecordSchema = extensionPanelMenuRecordSchema.safeExtend({ webview: workbenchExtensionWebviewSchema.optional() }).refine(hasSinglePanelBody, { message: singlePanelBodyMessage });
 var extensionPanelRecordBaseSchema = exports_external.object({
@@ -14243,14 +14411,9 @@ var extensionPanelRecordBaseSchema = exports_external.object({
   extensionId: exports_external.string(),
   title: localizableStringSchema,
   icon: exports_external.string().optional(),
-  region: workbenchRegionSchema,
-  closable: exports_external.boolean(),
-  group: exports_external.string().optional(),
-  placement: extensionPlacementSchema.optional(),
-  resourceKind: exports_external.string().optional(),
-  eligibleLocations: exports_external.object({ resourceKinds: exports_external.array(exports_external.string()).optional() }).optional(),
+  show: exports_external.union([extensionPanelPlacementSchema, exports_external.array(extensionPanelPlacementSchema).min(1)]).optional(),
   panelMenus: exports_external.array(extensionPanelMenuRecordSchema).optional(),
-  ...panelBodySchema
+  ...panelBodySchema2
 });
 var extensionPanelRecordSchema = extensionPanelRecordBaseSchema.refine(hasSinglePanelBody, {
   message: singlePanelBodyMessage
@@ -14262,29 +14425,16 @@ var extensionRouteRecordSchema = exports_external.object({
   label: localizableStringSchema,
   webview: extensionWebviewContributionSchema
 });
-var extensionNavigationRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  slotId: exports_external.string(),
-  label: localizableStringSchema,
-  group: exports_external.string().optional(),
-  placement: extensionPlacementSchema.optional(),
-  route: exports_external.string().optional(),
-  href: exports_external.string().optional(),
-  commandId: exports_external.string().optional(),
-  params: jsonObjectSchema.optional(),
-  icon: exports_external.string().optional(),
-  when: extensionWhenExpressionSchema.optional()
-});
 var extensionTreeItemActionSchema = exports_external.discriminatedUnion("kind", [
   exports_external.object({
     kind: exports_external.literal("command"),
     commandId: exports_external.string(),
     args: jsonObjectSchema.optional()
   }),
-  exports_external.object({ kind: exports_external.literal("kanbanRenderer"), kanbanRendererId: exports_external.string() }),
+  exports_external.object({ kind: exports_external.literal("panel"), panelId: exports_external.string() }),
   exports_external.object({ kind: exports_external.literal("route"), route: exports_external.string() }),
-  exports_external.object({ kind: exports_external.literal("href"), href: exports_external.string() })
+  exports_external.object({ kind: exports_external.literal("href"), href: exports_external.string() }),
+  exports_external.object({ kind: exports_external.literal("resource"), resource: extensionResourceRefSchema })
 ]);
 var extensionActivityItemRecordSchema = exports_external.object({
   id: exports_external.string(),
@@ -14301,33 +14451,26 @@ var extensionTreeItemContributionSchema = exports_external.object({
   extensionId: exports_external.string(),
   target: workbenchTreeTargetSchema,
   label: localizableStringSchema,
-  group: exports_external.string().optional(),
+  group: exports_external.string().nullable().optional(),
   placement: extensionPlacementSchema.optional(),
   icon: exports_external.string().optional(),
   action: extensionTreeItemActionSchema,
   when: extensionWhenExpressionSchema.optional()
 });
-var modeTargetContributionRecordSchema = exports_external.object({
-  panel: exports_external.string().optional(),
-  resource: exports_external.string().optional(),
-  region: workbenchRegionSchema.optional(),
-  title: localizableStringSchema.optional(),
-  pinned: exports_external.boolean().optional()
-}).refine((value) => value.panel || value.resource, {
-  message: "Mode layout entries must declare a panel or resource"
-});
-var modeLayoutContributionRecordSchema = exports_external.object({
-  panels: exports_external.array(exports_external.enum(workbenchModePanels)).optional(),
-  open: exports_external.array(modeTargetContributionRecordSchema).optional()
-});
 var extensionModeRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
   modeId: exports_external.string(),
   label: localizableStringSchema,
   icon: exports_external.string().optional(),
-  resourceKind: exports_external.string().optional(),
-  layout: modeLayoutContributionRecordSchema.optional()
+  panelRegions: exports_external.array(exports_external.enum(workbenchModePanels)).optional()
+}).extend(extensionModeCompositionRecordSchema.partial().shape);
+var extensionStatusItemRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  title: localizableStringSchema,
+  when: extensionWhenExpressionSchema.optional(),
+  webview: workbenchExtensionWebviewSchema.optional()
 });
 var workbenchExtensionPanelRecordSchema = extensionPanelRecordBaseSchema.extend({
   extensionInstanceId: exports_external.string().optional(),
@@ -14349,28 +14492,6 @@ var extensionViewLikeSchema = exports_external.object({
   extensionId: exports_external.string()
 });
 
-// ../pstdio-api-contracts/src/extensions/renderers.ts
-var extensionTreeRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  icon: exports_external.string().optional(),
-  bodyCommandId: exports_external.string(),
-  childrenCommandId: exports_external.string().optional(),
-  footerCommandId: exports_external.string().optional(),
-  defaultExpandedSectionIds: exports_external.array(exports_external.string()).optional(),
-  defaultExpandedNodeIds: exports_external.array(exports_external.string()).optional()
-});
-var extensionFileRendererRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  icon: exports_external.string().optional(),
-  resourceKind: exports_external.string().optional(),
-  loadCommandId: exports_external.string(),
-  saveCommandId: exports_external.string().optional()
-});
-
 // ../pstdio-api-contracts/src/extensions/settings.ts
 var extensionSettingsPanelRecordSchema = exports_external.object({
   id: exports_external.string(),
@@ -14436,7 +14557,6 @@ var extensionsCheckResponseSchema = exports_external.object({
   modes: exports_external.array(extensionModeRecordSchema),
   panels: exports_external.array(extensionPanelRecordSchema),
   routes: exports_external.array(extensionRouteRecordSchema),
-  navigation: exports_external.array(extensionNavigationRecordSchema),
   treeItems: exports_external.array(extensionTreeItemContributionSchema),
   activityItems: exports_external.array(extensionActivityItemRecordSchema).optional(),
   settingsPanels: exports_external.array(extensionSettingsPanelRecordSchema),
@@ -14472,8 +14592,11 @@ var workbenchExtensionMetadataSchema = exports_external.object({
   commandPaletteContributions: exports_external.array(extensionCommandPaletteContributionSchema).optional(),
   modes: exports_external.array(extensionModeRecordSchema),
   panels: exports_external.array(workbenchExtensionPanelRecordSchema),
+  resourceKinds: exports_external.array(extensionResourceKindRecordSchema).optional(),
+  resourcePanels: exports_external.array(extensionResourcePanelRecordSchema).optional(),
+  resourceHierarchyProviders: exports_external.array(extensionResourceHierarchyProviderRecordSchema).optional(),
+  statusItems: exports_external.array(extensionStatusItemRecordSchema).optional(),
   routes: exports_external.array(workbenchExtensionRouteRecordSchema),
-  navigation: exports_external.array(extensionNavigationRecordSchema),
   treeItems: exports_external.array(extensionTreeItemContributionSchema).optional(),
   activityItems: exports_external.array(extensionActivityItemRecordSchema).optional(),
   settingsSections: exports_external.array(extensionSettingsSectionRecordSchema).optional(),
@@ -14504,93 +14627,6 @@ var listExtensionAppearanceResponseSchema = exports_external.object({
   translations: exports_external.array(extensionTranslationRecordSchema),
   diagnostics: exports_external.array(extensionDiagnosticSchema)
 });
-// ../pstdio-api-contracts/src/extensions/execute.ts
-var extensionResourceRefSchema = exports_external.object({
-  type: exports_external.string(),
-  id: exports_external.string(),
-  projectId: exports_external.string().optional(),
-  label: exports_external.string().optional(),
-  extensionId: exports_external.string().optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var extensionRepoContextSchema = exports_external.object({
-  projectId: exports_external.string(),
-  repoId: exports_external.string(),
-  path: exports_external.string(),
-  remote: exports_external.string().nullable().optional(),
-  role: exports_external.enum(["default", "selected", "workspace"]).optional()
-});
-var extensionSlotInvocationSchema = exports_external.object({
-  id: exports_external.string(),
-  kind: extensionSlotKindSchema,
-  context: jsonObjectSchema
-});
-var extensionAttachmentInvocationSchema = exports_external.object({
-  target: workbenchAttachmentTargetSchema,
-  mode: exports_external.string().optional(),
-  projectId: exports_external.string().optional(),
-  resource: extensionResourceRefSchema.optional()
-});
-var commandExecuteRequestSchema = exports_external.object({
-  projectId: exports_external.string().min(1),
-  workspaceId: exports_external.string().optional(),
-  params: jsonObjectSchema.optional(),
-  resource: extensionResourceRefSchema.optional(),
-  attachment: extensionAttachmentInvocationSchema.optional(),
-  slot: extensionSlotInvocationSchema.optional(),
-  repo: extensionRepoContextSchema.optional(),
-  source: commandSourceSchema.optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var commandExecuteBodySchema = exports_external.object({
-  workspaceId: exports_external.string().optional(),
-  params: jsonObjectSchema.optional(),
-  resource: extensionResourceRefSchema.optional(),
-  attachment: extensionAttachmentInvocationSchema.optional(),
-  slot: extensionSlotInvocationSchema.optional(),
-  repo: extensionRepoContextSchema.optional(),
-  source: commandSourceSchema.optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var dispatchExtensionEventBodySchema = exports_external.object({
-  eventId: exports_external.string().min(1),
-  payload: jsonObjectSchema
-}).strict();
-var serializedErrorSchema = exports_external.object({
-  name: exports_external.string().optional(),
-  message: exports_external.string(),
-  stack: exports_external.string().optional()
-});
-var commandNoticeSchema = exports_external.object({
-  type: exports_external.enum(["info", "success", "warning", "error"]),
-  title: exports_external.string().optional(),
-  message: exports_external.string(),
-  metadata: jsonObjectSchema.optional()
-});
-var commandDiagnosticSchema = exports_external.object({
-  code: exports_external.string(),
-  message: exports_external.string(),
-  severity: exports_external.enum(["info", "warning", "error"]),
-  extensionId: exports_external.string().optional(),
-  commandId: exports_external.string().optional(),
-  metadata: jsonObjectSchema.optional()
-});
-var commandOutcomeSchema = exports_external.object({
-  ok: exports_external.boolean(),
-  status: exports_external.enum(["success", "rejected", "error"]),
-  value: exports_external.unknown().optional(),
-  code: exports_external.string().optional(),
-  reason: exports_external.string().optional(),
-  data: jsonObjectSchema.optional(),
-  error: serializedErrorSchema.optional(),
-  notices: exports_external.array(commandNoticeSchema).optional(),
-  diagnostics: exports_external.array(commandDiagnosticSchema).optional()
-});
-var commandExecuteResponseSchema = exports_external.object({
-  commandId: exports_external.string(),
-  extensionId: exports_external.string(),
-  outcome: commandOutcomeSchema
-});
 // ../pstdio-api-contracts/src/extensions/install.ts
 var enableInstalledExtensionRequestSchema = exports_external.object({
   displayName: exports_external.string(),
@@ -14627,7 +14663,8 @@ var projectExtensionInstanceSchema = exports_external.object({
   lastLoadedAt: exports_external.string().nullable().optional(),
   lastError: jsonObjectSchema.nullable().optional(),
   enabled: exports_external.boolean(),
-  config: exports_external.record(exports_external.string(), exports_external.unknown())
+  config: exports_external.record(exports_external.string(), exports_external.unknown()),
+  updateAvailable: exports_external.boolean()
 });
 var listProjectExtensionsResponseSchema = exports_external.object({
   extensions: exports_external.array(projectExtensionInstanceSchema)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pstdio/sdk",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/pufflyai/prompt-studio"