@pstdio/sdk 0.21.0 → 0.22.1

package/dist/extensions/index.js

@@ -13,19 +13,25 @@ var __export = (target, all) => {
     });
 };
 
+// ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
+var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
+var extensionPanelRegions = ["main", "secondary", "side"];
+
 // ../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
 });
@@ -43,12 +49,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, {
@@ -125,15 +184,14 @@ 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-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",
@@ -149,11 +207,18 @@ 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
 ];
+// package.json
+var version = "0.22.1";
+
+// src/version.ts
+var SDK_VERSION = version;
 // src/extensions/command-outcome.ts
 var unwrapCommandOutcome = (response, fallbackReason = "Command failed.") => {
   const { outcome } = response;
@@ -183,14 +248,16 @@ var defineView = defineContribution("view");
 var defineViewMenu = defineContribution("view-menu");
 var definePlacement = defineContribution("placement");
 var defineResourceKind = defineContribution("resource-kind");
-var resourceSlotRef = (resourceKind, id) => ({
-  resourceKind,
-  id
-});
 var resourceMenuSlotRef2 = (resourceKind, id) => defineSlot(`${resourceKind.id}.${id}`, { kind: "menu" });
-var defineResourceView = defineContribution("resource-view");
 var defineNavigationItem = defineContribution("navigation-item");
+var defineNavigationTree = defineContribution("navigation-tree");
 var defineMode = defineContribution("mode");
+var createPage = (definition) => {
+  const ref = { kind: "page", id: definition.id };
+  const panels = Object.fromEntries(definition.slots.map((slot) => [slot.id, { kind: "page-slot", page: ref, id: slot.id }]));
+  return { ...definition, ref, panels };
+};
+var definePage = createPage;
 var defineStatusBarItem = defineContribution("status-bar-item");
 var defineStatuses = defineContribution("status");
 var defineSettingsPanel = defineContribution("settings-panel");
@@ -242,7 +309,7 @@ var createFilesClient = (host) => ({
   upload: (input) => host.call("files.upload", input),
   list: async (input) => {
     const response = await host.call("files.list", input ?? {});
-    return response.files ?? [];
+    return response.files;
   },
   delete: (id) => host.call("files.delete", { id })
 });
@@ -293,16 +360,30 @@ var params = {
   }),
   repo: (options) => ({ type: "repo", ...options }),
   harness: (options) => ({ type: "harness", ...options }),
+  template: (options) => {
+    const { type: templateType, ...rest } = options;
+    return { type: "template", templateType, ...rest };
+  },
   resource: (options) => ({ type: "resource", ...options }),
   json: (options) => ({ type: "json", ...options }),
   list: (options) => ({ type: "list", ...options })
 };
+// src/extensions/qualify-ref.ts
+function qualifyRef(owner, ref) {
+  if (ref.kind === "page-slot")
+    return { ...ref, page: qualifyRef(owner, ref.page) };
+  return { ...ref, extensionId: owner };
+}
 // src/extensions/refs.ts
 var commandEvent = (command, phase) => ({
   ...command.extensionId ? { extensionId: command.extensionId } : {},
   kind: "event",
   id: `command.${phase}:${command.id}`
 });
+// src/extensions/resource-key.ts
+function resourceKey(resource) {
+  return resource && JSON.stringify([resource.extensionId ?? "", resource.projectId ?? "", resource.type, resource.id]);
+}
 // src/extensions/terminal-session-bridge.ts
 var TERMINAL_SESSION_CAPABILITY = "terminal.session";
 var createTerminalSessionBridge = (host) => ({
@@ -375,6 +456,9 @@ var createTerminalSessionBridge = (host) => ({
     };
   }
 });
+// src/extensions/webview-capabilities.ts
+var artifactMountId = (mount) => typeof mount === "string" ? mount : mount.id;
+var artifactsRead = (mount) => `artifacts.read:${artifactMountId(mount)}`;
 // src/extensions/webview-client.ts
 var createWebviewClient = (host, options) => {
   const extensionId = options?.extensionId ?? host.extensionId;
@@ -402,7 +486,16 @@ var createWebviewClient = (host, options) => {
       await host.call("extension.settings.set", { key, value });
     }
   };
-  return { commands, settings };
+  const artifacts = {
+    list: (mount, prefix) => host.call("artifacts.read", {
+      op: "list",
+      mount: artifactMountId(mount),
+      ...prefix === undefined ? {} : { prefix }
+    }),
+    readText: (mount, path) => host.call("artifacts.read", { op: "readText", mount: artifactMountId(mount), path }),
+    imageUrl: (mount, path) => host.call("artifacts.read", { op: "imageUrl", mount: artifactMountId(mount), path })
+  };
+  return { artifacts, commands, settings };
 };
 // src/extensions/when.ts
 var matchesResourceWhen = (when, resourceType) => {
@@ -418,21 +511,30 @@ export {
   workbenchSlots,
   workbenchResourceKinds,
   workbenchResourceKindDefinitions,
+  workbenchPanels,
+  workbenchPanelDefinitions,
+  workbenchPages,
+  workbenchPageDefinitions,
   workbenchModes,
-  workbenchCommands,
+  workbenchModeDefinitions,
   unwrapCommandOutcome,
   sessionSlots,
   sessionEvents,
-  resourceSlotRef,
   resourceMenuSlotRef2 as resourceMenuSlotRef,
+  resourceKey,
+  qualifyRef,
   projectSlots,
   projectEvents,
   params,
   packageAsset,
   matchesResourceWhen,
+  localContributionIdPattern,
+  localContributionIdGrammar,
   l10n,
+  isValidLocalContributionId,
   isLocalizedString,
   gitEvents,
+  extensionPanelRegions,
   eventRef,
   dockedWorkbenchRegions,
   defineWorkspaceType,
@@ -448,10 +550,11 @@ export {
   defineSettingsSection,
   defineSettingsPanel,
   defineSchedule,
-  defineResourceView,
   defineResourceKind,
   defineResourceHierarchyProvider,
   definePlacement,
+  definePage,
+  defineNavigationTree,
   defineNavigationItem,
   defineMode,
   defineMiddleware,
@@ -470,9 +573,13 @@ export {
   createTerminalSessionBridge,
   commandRef,
   commandEvent,
+  artifactsRead,
+  artifactMountId,
+  WEBVIEW_SCOPED_DECLARABLE_CAPABILITIES,
   WEBVIEW_HOST_CAPABILITY_VERSION,
   WEBVIEW_HOST_CAPABILITIES,
   WEBVIEW_DECLARABLE_CAPABILITIES,
+  SDK_VERSION,
   EXTENSION_API_VERSION,
   ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES
 };

package/dist/extensions/react/index.js

@@ -17,12 +17,13 @@ var __export = (target, all) => {
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 var useCommandQuery = (input) => {
   const { command, enabled, queryKey, staleTime } = input;
-  return useQuery({
+  const query = useQuery({
     queryKey,
     enabled,
     staleTime,
     queryFn: () => command()
   });
+  return query;
 };
 var useCommandMutation = (input) => {
   const { command, invalidate } = input;

package/dist/{extensions/react/index.d.ts → extensions-react.d.ts}

@@ -1,16 +1,23 @@
-import { type QueryKey } from "@tanstack/react-query";
-interface CommandQueryInput<TResult> {
-    queryKey: QueryKey;
-    command: () => Promise<TResult>;
-    enabled?: boolean;
-    staleTime?: number;
-}
-/** Reads server state via a typed client command, cached and deduped by react-query. */
-export declare const useCommandQuery: <TResult>(input: CommandQueryInput<TResult>) => import("@tanstack/react-query").UseQueryResult<import("@tanstack/react-query").NoInfer<TResult>, Error>;
-interface CommandMutationInput<TParams, TResult> {
-    command: (params: TParams) => Promise<TResult>;
-    invalidate?: QueryKey[];
-}
-/** Writes server state via a typed client command and refreshes affected queries on success. */
-export declare const useCommandMutation: <TParams, TResult>(input: CommandMutationInput<TParams, TResult>) => import("@tanstack/react-query").UseMutationResult<TResult, Error, TParams, unknown>;
-export {};
+import { QueryKey } from '@tanstack/react-query';
+import { UseMutationResult } from '@tanstack/react-query';
+import { UseQueryResult } from '@tanstack/react-query';
+
+declare interface CommandMutationInput<TParams, TResult> {
+    command: (params: TParams) => Promise<TResult>;
+    invalidate?: QueryKey[];
+}
+
+declare interface CommandQueryInput<TResult> {
+    queryKey: QueryKey;
+    command: () => Promise<TResult>;
+    enabled?: boolean;
+    staleTime?: number;
+}
+
+/** Writes server state via a typed client command and refreshes affected queries on success. */
+export declare const useCommandMutation: <TParams, TResult>(input: CommandMutationInput<TParams, TResult>) => UseMutationResult<TResult, Error, TParams, unknown>;
+
+/** Reads server state via a typed client command, cached and deduped by react-query. */
+export declare const useCommandQuery: <TResult>(input: CommandQueryInput<TResult>) => UseQueryResult<TResult>;
+
+export { }