@pstdio/sdk 0.21.0 → 0.22.0

package/dist/api/index.js

@@ -13619,6 +13619,10 @@ var agentModelSchema = exports_external.object({
 var harnessLocalId = (id) => id.slice(id.lastIndexOf(".") + 1);
 // ../pstdio-api-contracts/src/extensions/common.ts
 var jsonObjectSchema = exports_external.record(exports_external.string(), exports_external.unknown());
+var serializableJsonObjectSchema = exports_external.record(exports_external.string(), exports_external.json()).meta({
+  type: "object",
+  additionalProperties: true
+});
 var localizedStringSchema = exports_external.object({ $l10n: exports_external.string(), default: exports_external.string().optional() });
 var localizableStringSchema = exports_external.union([exports_external.string(), localizedStringSchema]);
 var extensionSettingScopeSchema = exports_external.enum(["global", "project"]);
@@ -13638,6 +13642,9 @@ var extensionRecordSchema = exports_external.object({
   id: exports_external.string(),
   name: exports_external.string(),
   displayName: exports_external.string(),
+  extensionInstanceId: exports_external.string().optional(),
+  installedExtensionId: exports_external.string().optional(),
+  installName: exports_external.string().optional(),
   version: exports_external.string().optional(),
   description: exports_external.string().optional(),
   sourcePath: exports_external.string()
@@ -13741,7 +13748,6 @@ var workbenchTreeTargets = [
 var workbenchRegions = [
   "nav",
   "activity",
-  "sidenav-header",
   "sidenav",
   "main-header",
   "main",
@@ -13760,7 +13766,6 @@ var workbenchViewTargets = [
 ];
 var workbenchSettingsTargets = ["workbench.settings"];
 var workbenchSettingsScopes = ["project", "global"];
-var workbenchModePanels = ["main", "secondary", "side"];
 var workbenchModeLayoutTargets = [
   "workbench.left",
   "workbench.main.left",
@@ -13868,6 +13873,39 @@ var extensionHostCompatibilitySchema = exports_external.object({
 
 // ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
 var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
+var extensionPanelRegions = ["main", "secondary", "side"];
+
+// ../pstdio-api-contracts/src/extensions/connections.ts
+var workbenchExtensionConnectionRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  localId: exports_external.string(),
+  extensionId: exports_external.string(),
+  label: localizableStringSchema,
+  authType: exports_external.enum(["bearer", "header"]),
+  supportsCheck: exports_external.boolean()
+});
+var extensionConnectionRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  connectionId: exports_external.string(),
+  baseUrl: exports_external.string(),
+  authType: exports_external.enum(["bearer", "header"]),
+  configured: exports_external.boolean(),
+  lastCheck: exports_external.object({
+    ok: exports_external.boolean(),
+    status: exports_external.number().int().nullable(),
+    error: exports_external.string().nullable(),
+    checkedAt: exports_external.string()
+  }).nullable(),
+  updatedAt: exports_external.string()
+});
+var configureExtensionConnectionSchema = exports_external.object({
+  baseUrl: exports_external.url(),
+  secret: exports_external.string().optional()
+});
+var listExtensionConnectionsResponseSchema = exports_external.object({
+  connections: exports_external.array(extensionConnectionRecordSchema)
+});
 
 // ../pstdio-api-contracts/src/extensions/execute.ts
 var extensionResourceRefSchema = exports_external.object({
@@ -13875,8 +13913,9 @@ var extensionResourceRefSchema = exports_external.object({
   id: exports_external.string(),
   projectId: exports_external.string().optional(),
   label: exports_external.string().optional(),
+  icon: exports_external.string().optional(),
   extensionId: exports_external.string().optional(),
-  metadata: jsonObjectSchema.optional()
+  metadata: serializableJsonObjectSchema.optional()
 });
 var extensionRepoContextSchema = exports_external.object({
   projectId: exports_external.string(),
@@ -13965,223 +14004,162 @@ var commandExecuteResponseSchema = exports_external.object({
   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 extensionResourceMenuSlotSchema = exports_external.object({
-  placement: exports_external.enum(["header-primary", "header-overflow", "context-menu"]),
-  label: localizableStringSchema.optional(),
-  external: exports_external.boolean(),
-  order: exports_external.number().optional()
-});
-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),
-  menuSlots: exports_external.record(exports_external.string(), extensionResourceMenuSlotSchema).default({})
-});
-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,
-  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/panels.ts
-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 panelBodySchema2 = {
-  webview: extensionWebviewContributionSchema.optional(),
-  renderer: exports_external.object({
-    kind: exports_external.enum(["tree", "file", "controls", "dataTable", "kanban"]),
-    id: exports_external.string()
-  }).optional()
-};
-var extensionPanelMenuRecordSchema = exports_external.object({
+// ../pstdio-api-contracts/src/extensions/control-declarations.ts
+var base = { id: exports_external.string(), name: exports_external.string(), description: exports_external.string().optional(), readOnly: exports_external.boolean().optional() };
+var numeric = { min: exports_external.number().optional(), max: exports_external.number().optional(), step: exports_external.number().optional() };
+var vector = exports_external.strictObject({ x: exports_external.number(), y: exports_external.number() });
+var range = exports_external.tuple([exports_external.number(), exports_external.number()]);
+var selectionValue = exports_external.union([exports_external.string(), exports_external.array(exports_external.string())]);
+var selectionOption = exports_external.strictObject({
   id: exports_external.string(),
-  extensionId: exports_external.string(),
-  ownerPanelId: exports_external.string(),
-  title: localizableStringSchema,
-  side: exports_external.enum(["left", "right"]),
-  group: exports_external.string().optional(),
-  placement: extensionPlacementSchema.optional(),
-  hostTreeHeader: hostTreeDefaultSchema.optional(),
-  hostTreeFooter: hostTreeDefaultSchema.optional(),
-  ...panelBodySchema2
-}).refine(hasSinglePanelBody, { message: singlePanelBodyMessage });
-var workbenchExtensionPanelMenuRecordSchema = extensionPanelMenuRecordSchema.safeExtend({ webview: workbenchExtensionWebviewSchema.optional() }).refine(hasSinglePanelBody, { message: singlePanelBodyMessage });
-var extensionPanelRecordBaseSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  path: exports_external.string().optional(),
-  aliases: exports_external.array(exports_external.string()).optional(),
+  name: exports_external.string(),
   icon: exports_external.string().optional(),
-  show: exports_external.union([extensionPanelPlacementSchema, exports_external.array(extensionPanelPlacementSchema).min(1)]).optional(),
-  panelMenus: exports_external.array(extensionPanelMenuRecordSchema).optional(),
-  ...panelBodySchema2
-});
-var extensionPanelRecordSchema = extensionPanelRecordBaseSchema.refine(hasSinglePanelBody, {
-  message: singlePanelBodyMessage
-});
-var extensionRouteRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  path: exports_external.string(),
-  label: localizableStringSchema,
-  webview: extensionWebviewContributionSchema
+  color: exports_external.string().optional(),
+  description: exports_external.string().optional(),
+  disabled: exports_external.boolean().optional()
 });
-var extensionTreeItemActionSchema = exports_external.discriminatedUnion("kind", [
-  exports_external.object({
-    kind: exports_external.literal("command"),
-    commandId: exports_external.string(),
-    args: jsonObjectSchema.optional()
+var selection = {
+  placeholder: exports_external.string().optional(),
+  searchable: exports_external.boolean().optional(),
+  searchPlaceholder: exports_external.string().optional(),
+  emptyText: exports_external.string().optional(),
+  disabled: exports_external.boolean().optional()
+};
+var image = exports_external.strictObject({ src: exports_external.string(), alt: exports_external.string() });
+var primitive = exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean(), exports_external.null()]);
+var readOnlyContent = exports_external.union([
+  primitive,
+  exports_external.array(primitive),
+  image.extend({ type: exports_external.literal("image") }),
+  exports_external.strictObject({ type: exports_external.literal("image-gallery"), images: exports_external.array(image) })
+]);
+var controlValueSchema = exports_external.union([primitive, exports_external.array(exports_external.string()), range, vector]);
+var controlValuesSchema = exports_external.record(exports_external.string(), controlValueSchema);
+var controlParamSchema = exports_external.discriminatedUnion("type", [
+  exports_external.strictObject({ ...base, ...numeric, type: exports_external.literal("number"), defaultValue: exports_external.number() }),
+  exports_external.strictObject({ ...base, type: exports_external.literal("boolean"), defaultValue: exports_external.boolean() }),
+  exports_external.strictObject({ ...base, type: exports_external.literal("text"), defaultValue: exports_external.string(), singleLine: exports_external.boolean().optional() }),
+  exports_external.strictObject({
+    ...base,
+    type: exports_external.literal("markdown"),
+    defaultValue: exports_external.string(),
+    placeholder: exports_external.string().optional()
   }),
-  exports_external.object({ kind: exports_external.literal("view"), viewId: 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 })
+  exports_external.strictObject({
+    ...base,
+    ...selection,
+    type: exports_external.literal("selection"),
+    defaultValue: selectionValue,
+    options: exports_external.array(selectionOption),
+    multiSelect: exports_external.boolean().optional(),
+    clearable: exports_external.boolean().optional(),
+    group: exports_external.strictObject({
+      id: exports_external.string(),
+      name: exports_external.string(),
+      defaultValue: exports_external.string(),
+      options: exports_external.array(selectionOption),
+      ...selection
+    }).optional()
+  }),
+  exports_external.strictObject({
+    ...base,
+    type: exports_external.literal("date"),
+    defaultValue: exports_external.string(),
+    min: exports_external.string().optional(),
+    max: exports_external.string().optional()
+  }),
+  exports_external.strictObject({ ...base, type: exports_external.literal("color"), defaultValue: exports_external.string() }),
+  exports_external.strictObject({ ...base, type: exports_external.literal("readOnly"), value: readOnlyContent }),
+  exports_external.strictObject({
+    ...base,
+    type: exports_external.literal("resource"),
+    defaultValue: selectionValue,
+    options: exports_external.array(exports_external.strictObject({
+      id: exports_external.string(),
+      name: exports_external.string(),
+      icon: exports_external.string().optional(),
+      color: exports_external.string().optional(),
+      description: exports_external.string().optional(),
+      href: exports_external.string().optional(),
+      ref: extensionResourceRefSchema.optional(),
+      copyText: exports_external.string().optional()
+    })),
+    multiSelect: exports_external.boolean().optional(),
+    editable: exports_external.boolean().optional(),
+    placeholder: exports_external.string().optional(),
+    emptyText: exports_external.string().optional()
+  }),
+  exports_external.strictObject({
+    ...base,
+    ...numeric,
+    type: exports_external.literal("range"),
+    defaultValue: range,
+    min: exports_external.number(),
+    max: exports_external.number(),
+    unit: exports_external.string().optional(),
+    markerCount: exports_external.number().optional()
+  }),
+  exports_external.strictObject({
+    ...base,
+    type: exports_external.literal("segmented"),
+    defaultValue: exports_external.string(),
+    variant: exports_external.enum(["default", "dots"]).optional(),
+    options: exports_external.array(exports_external.strictObject({
+      id: exports_external.string(),
+      name: exports_external.string(),
+      icon: exports_external.string().optional(),
+      indicatorColor: exports_external.string().optional()
+    }))
+  }),
+  exports_external.strictObject({
+    ...base,
+    type: exports_external.literal("actions"),
+    defaultValue: exports_external.string().optional(),
+    options: exports_external.array(exports_external.strictObject({
+      id: exports_external.string(),
+      name: exports_external.string(),
+      icon: exports_external.string().optional(),
+      disabled: exports_external.boolean().optional()
+    }))
+  }),
+  exports_external.strictObject({
+    ...base,
+    type: exports_external.literal("anchorGrid"),
+    defaultValue: exports_external.enum([
+      "top-left",
+      "top",
+      "top-right",
+      "left",
+      "center",
+      "right",
+      "bottom-left",
+      "bottom",
+      "bottom-right"
+    ])
+  }),
+  exports_external.strictObject({
+    ...base,
+    ...numeric,
+    type: exports_external.literal("vector"),
+    defaultValue: vector,
+    coordinateMode: exports_external.enum(["cartesian", "screen"]).optional(),
+    xLabel: exports_external.string().optional(),
+    yLabel: exports_external.string().optional()
+  })
 ]);
-var extensionActivityItemRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  title: localizableStringSchema,
-  icon: exports_external.string(),
-  modes: exports_external.array(exports_external.string()),
-  placement: extensionPlacementSchema.optional(),
-  commandId: exports_external.string(),
-  params: jsonObjectSchema.optional()
-});
-var extensionTreeItemContributionSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  target: workbenchTreeTargetSchema,
-  label: localizableStringSchema,
-  group: exports_external.string().nullable().optional(),
-  placement: extensionPlacementSchema.optional(),
-  icon: exports_external.string().optional(),
-  action: extensionTreeItemActionSchema,
-  when: extensionWhenExpressionSchema.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(),
-  panelRegions: exports_external.array(exports_external.enum(workbenchModePanels)).optional()
-}).extend(extensionModeCompositionRecordSchema.partial().shape);
-var extensionStatusItemRecordSchema = exports_external.object({
+var controlGroupSchema = exports_external.strictObject({
   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(),
-  installedExtensionId: exports_external.string().optional(),
-  installName: exports_external.string().optional(),
-  webview: workbenchExtensionWebviewSchema.optional(),
-  panelMenus: exports_external.array(workbenchExtensionPanelMenuRecordSchema).optional()
-}).refine(hasSinglePanelBody, {
-  message: singlePanelBodyMessage
-});
-var workbenchExtensionRouteRecordSchema = extensionRouteRecordSchema.extend({
-  extensionInstanceId: exports_external.string().optional(),
-  installedExtensionId: exports_external.string().optional(),
-  installName: exports_external.string().optional(),
-  webview: workbenchExtensionWebviewSchema
-});
-var extensionViewLikeSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string()
-});
-
-// ../pstdio-api-contracts/src/extensions/connections.ts
-var workbenchExtensionConnectionRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  localId: exports_external.string(),
-  extensionId: exports_external.string(),
-  label: localizableStringSchema,
-  authType: exports_external.enum(["bearer", "header"]),
-  supportsCheck: exports_external.boolean()
-});
-var extensionConnectionRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  connectionId: exports_external.string(),
-  baseUrl: exports_external.string(),
-  authType: exports_external.enum(["bearer", "header"]),
-  configured: exports_external.boolean(),
-  lastCheck: exports_external.object({
-    ok: exports_external.boolean(),
-    status: exports_external.number().int().nullable(),
-    error: exports_external.string().nullable(),
-    checkedAt: exports_external.string()
-  }).nullable(),
-  updatedAt: exports_external.string()
-});
-var configureExtensionConnectionSchema = exports_external.object({
-  baseUrl: exports_external.url(),
-  secret: exports_external.string().optional()
+  title: exports_external.string(),
+  description: exports_external.string().optional(),
+  params: exports_external.array(controlParamSchema),
+  collapsible: exports_external.boolean().optional(),
+  defaultCollapsed: exports_external.boolean().optional()
 });
-var listExtensionConnectionsResponseSchema = exports_external.object({
-  connections: exports_external.array(extensionConnectionRecordSchema)
+var controlsQueryResultSchema = exports_external.strictObject({
+  params: exports_external.array(controlParamSchema).optional(),
+  groups: exports_external.array(controlGroupSchema).optional(),
+  values: controlValuesSchema.optional(),
+  readOnly: exports_external.boolean().optional()
 });
 
 // ../pstdio-api-contracts/src/extensions/renderers.ts
@@ -14198,6 +14176,7 @@ var extensionRendererRecordBaseSchema = exports_external.object({
 var extensionTreeRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
   searchable: exports_external.boolean().optional(),
   searchPlaceholder: localizableStringSchema.optional(),
+  headerHandlerId: exports_external.string().optional(),
   bodyHandlerId: exports_external.string(),
   childrenHandlerId: exports_external.string().optional(),
   footerHandlerId: exports_external.string().optional(),
@@ -14215,7 +14194,7 @@ var extensionControlsRendererRecordSchema = extensionRendererRecordBaseSchema.ex
   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()
+  defaultValues: controlValuesSchema.optional()
 });
 
 // ../pstdio-api-contracts/src/extensions/data-table-renderer.ts
@@ -14297,8 +14276,9 @@ var kanbanRendererAttributeTypeSchema = exports_external.discriminatedUnion("kin
   exports_external.object({ kind: exports_external.literal("number") }),
   exports_external.object({ kind: exports_external.literal("user") })
 ]);
-var kanbanRendererAttributeDisplaySchema = exports_external.discriminatedUnion("kind", [
-  exports_external.object({ kind: exports_external.literal("workspace-badge"), itemsAttributeId: exports_external.string() })
+var kanbanRendererAttributeDisplaySchema = exports_external.union([
+  exports_external.object({ kind: exports_external.literal("badge-list"), itemsAttributeId: exports_external.string() }),
+  exports_external.object({ kind: exports_external.string() }).passthrough().refine((display) => display.kind !== "badge-list")
 ]);
 var kanbanRendererAttributeSchema = exports_external.object({
   id: exports_external.string(),
@@ -14379,6 +14359,52 @@ var extensionCommandPaletteResourceRecordSchema = exports_external.object({
   refreshEventIds: exports_external.array(exports_external.string().min(1)).optional()
 });
 
+// ../pstdio-api-contracts/src/extensions/workbench-refs-metadata.ts
+var contributionRefSchema = (kind) => exports_external.object({ extensionId: exports_external.string(), kind: exports_external.literal(kind), id: exports_external.string() });
+var pageRefSchema = contributionRefSchema("page");
+var placementRefSchema = contributionRefSchema("placement");
+var modeRefSchema = contributionRefSchema("mode");
+var viewRefSchema = contributionRefSchema("view");
+var resourceKindRefSchema = contributionRefSchema("resource-kind");
+var pageSlotRefSchema = exports_external.object({
+  kind: exports_external.literal("page-slot"),
+  page: pageRefSchema,
+  id: exports_external.string()
+});
+var panelRefSchema = exports_external.union([placementRefSchema, pageSlotRefSchema]);
+var commandTargetSchema = exports_external.object({
+  command: contributionRefSchema("command"),
+  params: serializableJsonObjectSchema.optional()
+});
+
+// ../pstdio-api-contracts/src/extensions/navigation-target-metadata.ts
+var sectionSchema = exports_external.object({
+  anchors: exports_external.array(exports_external.object({ id: exports_external.string(), heading: exports_external.string(), occurrence: exports_external.number().int().nonnegative().optional() }))
+});
+var pageTargetSchema = exports_external.lazy(() => exports_external.object({
+  kind: exports_external.literal("page"),
+  page: pageRefSchema,
+  resource: extensionResourceRefSchema.optional(),
+  open: exports_external.enum(["preview", "pin"]).optional(),
+  section: sectionSchema.optional(),
+  parent: pageTargetSchema.optional()
+})).meta({ id: "WorkbenchMetadataPageTarget" });
+var navigationOperationSchema = exports_external.union([
+  pageTargetSchema,
+  exports_external.object({
+    kind: exports_external.literal("panel"),
+    panel: panelRefSchema,
+    resource: extensionResourceRefSchema.optional(),
+    open: exports_external.enum(["preview", "pin"]).optional()
+  })
+]);
+var navigationTargetSchema = exports_external.union([
+  navigationOperationSchema,
+  exports_external.object({ kind: exports_external.literal("command"), target: commandTargetSchema }),
+  exports_external.object({ kind: exports_external.literal("href"), href: exports_external.string() }),
+  exports_external.object({ kind: exports_external.literal("compound"), targets: exports_external.array(navigationOperationSchema).min(1) })
+]);
+
 // ../pstdio-api-contracts/src/extensions/keybindings.ts
 var parsedKeybindingChordSchema = exports_external.object({
   key: exports_external.string(),
@@ -14391,7 +14417,7 @@ var parsedKeybindingChordSchema = exports_external.object({
 var extensionKeybindingRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
-  commandId: exports_external.string(),
+  action: navigationTargetSchema,
   key: exports_external.string(),
   canonicalChord: exports_external.string(),
   parsed: parsedKeybindingChordSchema,
@@ -14400,8 +14426,72 @@ var extensionKeybindingRecordSchema = exports_external.object({
     linux: exports_external.string().optional(),
     win: exports_external.string().optional()
   }).optional(),
-  when: extensionWhenExpressionSchema.optional(),
-  args: jsonObjectSchema.optional()
+  when: extensionWhenExpressionSchema.optional()
+});
+
+// ../pstdio-api-contracts/src/extensions/placement-metadata.ts
+var workbenchPlacementPresentationSchema = exports_external.object({
+  mountStrategy: exports_external.enum(["active", "keep-mounted"]).optional(),
+  hiddenByDefault: exports_external.boolean().optional(),
+  headerBorderBottom: exports_external.boolean().optional(),
+  tab: exports_external.object({
+    queryHandlerId: exports_external.string(),
+    refreshEventIds: exports_external.array(exports_external.string()).optional()
+  }).optional()
+});
+var placementPresenceSchema = exports_external.enum(["fixed", "open", "closed"]);
+var regionSizeSchema = exports_external.object({
+  defaultPx: exports_external.number().optional(),
+  minPx: exports_external.number().optional(),
+  maxPx: exports_external.number().optional()
+});
+var regionSettingsSchema = exports_external.object({
+  showHeader: exports_external.boolean().optional(),
+  size: regionSizeSchema.optional(),
+  collapsible: exports_external.boolean().optional(),
+  alwaysShowTabs: exports_external.boolean().optional()
+});
+
+// ../pstdio-api-contracts/src/extensions/resource-binding-metadata.ts
+var resourceConstraintSchema = exports_external.object({ kinds: exports_external.array(resourceKindRefSchema).min(1) }).strict();
+var resourceBindingSchema = resourceConstraintSchema.extend({
+  view: viewRefSchema,
+  cardinality: exports_external.enum(["one", "many"]),
+  add: navigationTargetSchema.optional()
+});
+var placementItemSchema = exports_external.discriminatedUnion("kind", [
+  exports_external.object({ kind: exports_external.literal("view"), view: viewRefSchema, presence: placementPresenceSchema }).strict(),
+  exports_external.object({ kind: exports_external.literal("binding"), binding: resourceBindingSchema }).strict()
+]);
+
+// ../pstdio-api-contracts/src/extensions/page-metadata.ts
+var mainSchema = exports_external.discriminatedUnion("kind", [
+  workbenchPlacementPresentationSchema.extend({
+    kind: exports_external.literal("view"),
+    view: viewRefSchema,
+    cardinality: exports_external.enum(["one", "many"])
+  }).strict(),
+  exports_external.object({ kind: exports_external.literal("panels"), empty: viewRefSchema }).strict()
+]);
+var slotSchema = workbenchPlacementPresentationSchema.extend({
+  id: exports_external.string(),
+  region: exports_external.enum(["main", "secondary", "side"]),
+  order: exports_external.number().optional(),
+  item: placementItemSchema,
+  openOn: exports_external.literal("page-resource").optional()
+}).strict();
+var workbenchExtensionPageRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  localId: exports_external.string(),
+  extensionId: exports_external.string(),
+  title: localizableStringSchema,
+  icon: exports_external.string().optional(),
+  path: exports_external.string(),
+  mode: modeRefSchema,
+  parent: pageRefSchema.optional(),
+  resource: resourceConstraintSchema.optional(),
+  main: mainSchema,
+  slots: exports_external.array(slotSchema)
 });
 
 // ../pstdio-api-contracts/src/extensions/settings.ts
@@ -14451,47 +14541,21 @@ var extensionSettingsSectionRecordSchema = exports_external.object({
 });
 
 // ../pstdio-api-contracts/src/extensions/workbench-metadata.ts
-var contributionRefSchema = (kind) => exports_external.object({ extensionId: exports_external.string(), kind: exports_external.literal(kind), id: exports_external.string() });
-var commandRefSchema = contributionRefSchema("command");
-var modeRefSchema = contributionRefSchema("mode");
-var navigationSlotRefSchema = contributionRefSchema("navigation-item");
-var resourceKindRefSchema = contributionRefSchema("resource-kind");
-var settingsSectionRefSchema = contributionRefSchema("settings-section");
-var statusRefSchema = contributionRefSchema("status");
-var viewRefSchema = contributionRefSchema("view");
+var contributionRefSchema2 = (kind) => exports_external.object({ extensionId: exports_external.string(), kind: exports_external.literal(kind), id: exports_external.string() });
+var commandRefSchema = contributionRefSchema2("command");
+var modeRefSchema2 = contributionRefSchema2("mode");
+var pageRefSchema2 = contributionRefSchema2("page");
+var resourceKindRefSchema2 = contributionRefSchema2("resource-kind");
+var settingsSectionRefSchema = contributionRefSchema2("settings-section");
+var statusRefSchema = contributionRefSchema2("status");
+var viewRefSchema2 = contributionRefSchema2("view");
 var normalizedWhenSchema = exports_external.object({
-  mode: exports_external.union([modeRefSchema, exports_external.array(modeRefSchema)]).optional(),
+  mode: exports_external.union([modeRefSchema2, exports_external.array(modeRefSchema2)]).optional(),
   source: exports_external.array(exports_external.enum(["cli", "dashboard", "api", "schedule", "event", "automation", "command-panel"])).optional(),
-  view: exports_external.union([viewRefSchema, exports_external.array(viewRefSchema)]).optional(),
-  resourceType: exports_external.array(resourceKindRefSchema).optional(),
+  view: exports_external.union([viewRefSchema2, exports_external.array(viewRefSchema2)]).optional(),
+  resourceType: exports_external.array(resourceKindRefSchema2).optional(),
   metadata: jsonObjectSchema.optional()
 });
-var commandTargetSchema = exports_external.object({ command: commandRefSchema, params: jsonObjectSchema.optional() });
-var navigationTargetItemSchema = exports_external.discriminatedUnion("kind", [
-  exports_external.object({
-    kind: exports_external.literal("view"),
-    view: viewRefSchema,
-    input: exports_external.object({ strategy: exports_external.enum(["persistent", "preview", "replace-active", "replace-invoking"]).optional() }).optional()
-  }),
-  exports_external.object({
-    kind: exports_external.literal("resource"),
-    resource: extensionResourceRefSchema,
-    input: exports_external.object({ strategy: exports_external.enum(["persistent", "replace-active"]).optional() }).optional(),
-    section: exports_external.object({
-      anchors: exports_external.array(exports_external.object({
-        id: exports_external.string(),
-        heading: exports_external.string(),
-        occurrence: exports_external.number().int().nonnegative().optional()
-      }))
-    }).optional()
-  }),
-  exports_external.object({ kind: exports_external.literal("command"), target: commandTargetSchema }),
-  exports_external.object({ kind: exports_external.literal("href"), href: exports_external.string() })
-]);
-var navigationTargetSchema = exports_external.union([
-  navigationTargetItemSchema,
-  exports_external.object({ kind: exports_external.literal("compound"), targets: exports_external.array(navigationTargetItemSchema).min(1) })
-]);
 var rendererBaseOmissions = {
   id: true,
   extensionId: true,
@@ -14549,7 +14613,6 @@ var workbenchExtensionViewRecordSchema = exports_external.object({
   extensionId: exports_external.string(),
   title: localizableStringSchema,
   icon: exports_external.string().optional(),
-  path: exports_external.string().optional(),
   body: workbenchExtensionViewBodySchema
 });
 var workbenchExtensionModeRecordSchema = exports_external.object({
@@ -14557,31 +14620,28 @@ var workbenchExtensionModeRecordSchema = exports_external.object({
   localId: exports_external.string(),
   extensionId: exports_external.string(),
   label: localizableStringSchema,
-  icon: exports_external.string().optional()
+  icon: exports_external.string().optional(),
+  regions: exports_external.array(exports_external.enum(extensionPanelRegions)),
+  floatingPanels: exports_external.enum(["visible", "hidden"]).optional(),
+  regionSettings: exports_external.partialRecord(exports_external.enum(dockedWorkbenchRegions), regionSettingsSchema).optional(),
+  defaultTheme: contributionRefSchema2("theme").optional(),
+  chrome: exports_external.partialRecord(exports_external.enum(["nav", "sidenav", "activity", "status"]), exports_external.union([viewRefSchema2, exports_external.literal(false)])).optional()
 });
-var workbenchExtensionPlacementRecordSchema = exports_external.object({
+var workbenchExtensionPlacementRecordSchema = workbenchPlacementPresentationSchema.extend({
   id: exports_external.string(),
   localId: exports_external.string(),
   extensionId: exports_external.string(),
-  mode: modeRefSchema,
-  item: exports_external.discriminatedUnion("kind", [
-    exports_external.object({ kind: exports_external.literal("view"), view: viewRefSchema }),
-    exports_external.object({
-      kind: exports_external.literal("resource-slot"),
-      slot: exports_external.object({ resourceKind: resourceKindRefSchema, id: exports_external.string() })
-    })
-  ]),
-  region: exports_external.enum(dockedWorkbenchRegions),
+  mode: modeRefSchema2,
+  item: placementItemSchema,
+  region: exports_external.enum(extensionPanelRegions),
   order: exports_external.number().optional(),
-  defaultOpen: exports_external.boolean().optional(),
-  required: exports_external.boolean().optional(),
-  movableTo: exports_external.array(exports_external.enum(dockedWorkbenchRegions)).optional()
+  movableTo: exports_external.array(exports_external.enum(extensionPanelRegions)).optional()
 });
 var workbenchExtensionViewMenuRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
-  owner: viewRefSchema,
-  view: viewRefSchema,
+  owner: viewRefSchema2,
+  view: viewRefSchema2,
   side: exports_external.enum(["left", "right"]),
   group: exports_external.string().optional(),
   placement: exports_external.enum(["first", "default", "last"]).optional(),
@@ -14591,22 +14651,27 @@ var workbenchExtensionViewMenuRecordSchema = exports_external.object({
 var workbenchExtensionNavigationItemRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
-  slot: navigationSlotRefSchema,
+  owner: exports_external.union([modeRefSchema2, pageRefSchema2]),
+  slot: exports_external.enum(["header", "content", "footer"]),
   label: localizableStringSchema,
   icon: exports_external.string().optional(),
   group: exports_external.string().optional(),
-  order: exports_external.number().optional(),
   when: normalizedWhenSchema.optional(),
   action: navigationTargetSchema
 });
+var workbenchExtensionNavigationTreeRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  owner: exports_external.union([modeRefSchema2, pageRefSchema2]),
+  slot: exports_external.enum(["header", "content", "footer"]),
+  view: viewRefSchema2
+});
 var workbenchExtensionResourceKindRecordSchema = exports_external.object({
   id: exports_external.string(),
   localId: 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.array(exports_external.object({ id: exports_external.string(), cardinality: exports_external.enum(["one", "many"]), access: exports_external.enum(["owner", "public"]) })).optional(),
   menuSlots: exports_external.array(exports_external.object({
     id: exports_external.string(),
     placement: exports_external.enum(["header-primary", "header-overflow", "context-menu"]),
@@ -14615,25 +14680,17 @@ var workbenchExtensionResourceKindRecordSchema = exports_external.object({
     order: exports_external.number().optional()
   })).optional()
 });
-var workbenchExtensionResourceViewRecordSchema = exports_external.object({
-  id: exports_external.string(),
-  extensionId: exports_external.string(),
-  resourceKind: resourceKindRefSchema,
-  slot: exports_external.object({ resourceKind: resourceKindRefSchema, id: exports_external.string() }),
-  view: viewRefSchema,
-  order: exports_external.number().optional()
-});
 var workbenchExtensionSettingsPanelRecordSchema2 = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
-  view: viewRefSchema,
+  view: viewRefSchema2,
   slot: exports_external.object({ id: exports_external.string() }),
   section: settingsSectionRefSchema.optional()
 });
 var workbenchExtensionStatusBarItemRecordSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
-  view: viewRefSchema,
+  view: viewRefSchema2,
   slot: exports_external.object({ id: exports_external.string() }),
   order: exports_external.number().optional(),
   when: normalizedWhenSchema.optional()
@@ -14653,13 +14710,14 @@ var workbenchExtensionMetadataSchema = exports_external.object({
   menuContributions: exports_external.array(extensionMenuContributionSchema),
   commandPaletteContributions: exports_external.array(extensionCommandPaletteContributionSchema).optional(),
   modes: exports_external.array(workbenchExtensionModeRecordSchema),
+  pages: exports_external.array(workbenchExtensionPageRecordSchema),
   views: exports_external.array(workbenchExtensionViewRecordSchema),
   viewMenus: exports_external.array(workbenchExtensionViewMenuRecordSchema),
   placements: exports_external.array(workbenchExtensionPlacementRecordSchema),
   resourceKinds: exports_external.array(workbenchExtensionResourceKindRecordSchema),
-  resourceViews: exports_external.array(workbenchExtensionResourceViewRecordSchema),
-  resourceHierarchyProviders: exports_external.array(exports_external.object({ id: exports_external.string(), extensionId: exports_external.string(), resourceKind: resourceKindRefSchema })).optional(),
+  resourceHierarchyProviders: exports_external.array(exports_external.object({ id: exports_external.string(), extensionId: exports_external.string(), resourceKind: resourceKindRefSchema2 })).optional(),
   navigationItems: exports_external.array(workbenchExtensionNavigationItemRecordSchema),
+  navigationTrees: exports_external.array(workbenchExtensionNavigationTreeRecordSchema),
   statusBarItems: exports_external.array(workbenchExtensionStatusBarItemRecordSchema),
   statuses: exports_external.array(workbenchExtensionStatusRecordSchema),
   activityItems: exports_external.array(exports_external.object({
@@ -14667,7 +14725,7 @@ var workbenchExtensionMetadataSchema = exports_external.object({
     extensionId: exports_external.string(),
     title: localizableStringSchema,
     icon: exports_external.string(),
-    modes: exports_external.array(modeRefSchema),
+    modes: exports_external.array(modeRefSchema2),
     placement: exports_external.enum(["first", "default", "last"]).optional(),
     command: commandRefSchema,
     params: jsonObjectSchema.optional()
@@ -14716,19 +14774,24 @@ var workbenchExtensionMetadataSchema = exports_external.object({
 });
 
 // ../pstdio-api-contracts/src/extensions/check.ts
+var extensionViewLikeSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string()
+});
 var checkWorkbenchMetadataSchema = workbenchExtensionMetadataSchema.pick({
   extensions: true,
   commands: true,
   menuContributions: true,
   commandPaletteContributions: true,
   modes: true,
+  pages: true,
   views: true,
   viewMenus: true,
   placements: true,
   resourceKinds: true,
-  resourceViews: true,
   resourceHierarchyProviders: true,
   navigationItems: true,
+  navigationTrees: true,
   statusBarItems: true,
   statuses: true,
   activityItems: true,
@@ -14908,17 +14971,19 @@ var automationRunEventSchema = exports_external.object({
 var listAutomationRunEventsResponseSchema = exports_external.object({ events: exports_external.array(automationRunEventSchema) });
 // ../pstdio-api-contracts/src/extension-kernel/builtin-refs.ts
 var hostRef = (kind, id) => ({ extensionId: "pstdio", kind, id });
-var workbenchCommands = {
-  switchMode: hostRef("command", "workbench.action.switchMode")
-};
 var workbenchModes = {
   project: hostRef("mode", "project"),
+  sessions: hostRef("mode", "sessions"),
   settings: hostRef("mode", "settings")
 };
+var workbenchModeDefinitions = {
+  project: { ref: workbenchModes.project, regions: dockedWorkbenchRegions },
+  sessions: { ref: workbenchModes.sessions, regions: dockedWorkbenchRegions },
+  settings: { ref: workbenchModes.settings, regions: dockedWorkbenchRegions }
+};
 var hostResourceKind = (id, label, menuSlots) => ({
   id,
   ref: hostRef("resource-kind", id),
-  surface: "primary",
   label,
   menuSlots
 });
@@ -14936,12 +15001,65 @@ var workbenchResourceKinds = {
   session: workbenchResourceKindDefinitions.session.ref,
   workspace: workbenchResourceKindDefinitions.workspace.ref
 };
+var workbenchPages = {
+  start: hostRef("page", "start"),
+  sessions: hostRef("page", "sessions"),
+  session: hostRef("page", "session"),
+  workspaces: hostRef("page", "workspaces"),
+  workspace: hostRef("page", "workspace")
+};
+var workbenchPageDefinitions = {
+  start: {
+    ref: workbenchPages.start,
+    mode: workbenchModes.project,
+    path: "",
+    primary: { cardinality: "one", resourceKinds: [] }
+  },
+  sessions: {
+    ref: workbenchPages.sessions,
+    mode: workbenchModes.sessions,
+    path: "sessions",
+    primary: { cardinality: "one", resourceKinds: [] }
+  },
+  session: {
+    ref: workbenchPages.session,
+    mode: workbenchModes.sessions,
+    path: "session",
+    primary: { cardinality: "one", resourceKinds: ["session", "session-draft"] }
+  },
+  workspaces: {
+    ref: workbenchPages.workspaces,
+    mode: workbenchModes.project,
+    path: "workspaces",
+    primary: { cardinality: "one", resourceKinds: [] }
+  },
+  workspace: {
+    ref: workbenchPages.workspace,
+    mode: workbenchModes.project,
+    path: "workspace",
+    primary: { cardinality: "many", resourceKinds: ["workspace"] }
+  }
+};
+var workbenchPanels = {
+  projectSession: hostRef("placement", "project-session")
+};
+var workbenchPanelDefinitions = {
+  projectSession: {
+    ref: workbenchPanels.projectSession,
+    mode: workbenchModes.project,
+    cardinality: "many",
+    resourceKinds: ["session", "session-draft"]
+  }
+};
 var workbenchSlots = {
-  projectNavigation: hostRef("navigation-item", "project.navigation"),
   projectSettings: hostRef("settings-panel", "project.settings"),
   statusBarLeading: hostRef("status-bar-item", "status-bar.leading"),
   statusBarTrailing: hostRef("status-bar-item", "status-bar.trailing")
 };
+// ../pstdio-api-contracts/src/extension-kernel/contribution-id.ts
+var localContributionIdPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*(?:\.[a-z0-9]+(?:-[a-z0-9]+)*)*$/;
+var isValidLocalContributionId = (id) => localContributionIdPattern.test(id);
+var localContributionIdGrammar = 'lowercase kebab-case segments separated by dots, such as "ticket-status.create"';
 // ../pstdio-api-contracts/src/extension-kernel/refs.ts
 var createCommandRef = (input) => ({ ...input, kind: "command" });
 var commandRef = Object.assign(createCommandRef, {
@@ -15019,12 +15137,13 @@ var packageAsset = (path, baseUrl) => ({
   baseUrl
 });
 // ../pstdio-api-contracts/src/extension-kernel/types/extension.ts
-var EXTENSION_API_VERSION = "1.0.0-alpha.5";
+var EXTENSION_API_VERSION = "1.0.0-alpha.10";
 // ../pstdio-api-contracts/src/extension-kernel/types/webview-capabilities.ts
 var WEBVIEW_HOST_CAPABILITY_VERSION = 1;
 var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "commands.execute",
-  "resource.open",
+  "navigation.open",
+  "placement.close",
   "notification.show",
   "notification.action",
   "notification.resolve",
@@ -15040,9 +15159,11 @@ var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "files.list",
   "files.delete"
 ];
+var WEBVIEW_SCOPED_DECLARABLE_CAPABILITIES = ["artifacts.read"];
 var ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES = ["host.dispatchKeyboardEvent"];
 var WEBVIEW_HOST_CAPABILITIES = [
   ...WEBVIEW_DECLARABLE_CAPABILITIES,
+  ...WEBVIEW_SCOPED_DECLARABLE_CAPABILITIES,
   ...ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES
 ];
 // ../pstdio-api-contracts/src/files.ts