@pstdio/sdk 0.20.0 → 0.22.0

package/dist/extensions/index.js

@@ -13,9 +13,110 @@ 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 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),
+  label,
+  menuSlots
+});
+var headerMenuSlots = [
+  { id: "headerPrimary", placement: "header-primary", access: "public" },
+  { id: "headerOverflow", placement: "header-overflow", access: "public" }
+];
+var workbenchResourceKindDefinitions = {
+  project: hostResourceKind("project", "Extension", headerMenuSlots),
+  session: hostResourceKind("session", "Session", headerMenuSlots),
+  workspace: hostResourceKind("workspace", "Workspace", headerMenuSlots)
+};
+var workbenchResourceKinds = {
+  project: workbenchResourceKindDefinitions.project.ref,
+  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 = {
+  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 commandRef = (id) => ({ id });
-var eventRef = (id) => ({ id });
+var createCommandRef = (input) => ({ ...input, kind: "command" });
+var commandRef = Object.assign(createCommandRef, {
+  forExtension: (owner) => (id) => createCommandRef({ extensionId: `${owner.publisher}.${owner.name}`, id })
+});
+var eventRef = (input) => ({
+  ...input,
+  kind: "event"
+});
 
 // ../pstdio-api-contracts/src/extension-kernel/slots.ts
 var defineSlot = (id, options) => ({
@@ -27,48 +128,49 @@ var defineSlot = (id, options) => ({
 });
 
 // ../pstdio-api-contracts/src/extension-kernel/kernel-slots.ts
+var hostEventRef = (id) => eventRef({ extensionId: "pstdio", id });
+var resourceMenuSlotRef = (resourceKind, id) => defineSlot(`${resourceKind.id}.${id}`, { kind: "menu" });
 var projectSlots = {
   sidenav: defineSlot("project.sidenav", { kind: "panel" }),
-  headerPrimary: defineSlot("project.headerPrimary", { kind: "menu" }),
-  headerOverflow: defineSlot("project.headerOverflow", { kind: "menu" }),
+  headerPrimary: resourceMenuSlotRef(workbenchResourceKinds.project, "headerPrimary"),
+  headerOverflow: resourceMenuSlotRef(workbenchResourceKinds.project, "headerOverflow"),
   settingsPanels: defineSlot("project.settingsPanels", { kind: "settings" })
 };
 var sessionSlots = {
-  headerPrimary: defineSlot("session.headerPrimary", { kind: "menu" }),
-  headerOverflow: defineSlot("session.headerOverflow", { kind: "menu" }),
-  transcriptActions: defineSlot("session.transcriptActions", { kind: "menu" })
+  headerPrimary: resourceMenuSlotRef(workbenchResourceKinds.session, "headerPrimary"),
+  headerOverflow: resourceMenuSlotRef(workbenchResourceKinds.session, "headerOverflow")
 };
 var workspaceSlots = {
-  headerPrimary: defineSlot("workspace.headerPrimary", { kind: "menu" }),
-  headerOverflow: defineSlot("workspace.headerOverflow", { kind: "menu" }),
+  headerPrimary: resourceMenuSlotRef(workbenchResourceKinds.workspace, "headerPrimary"),
+  headerOverflow: resourceMenuSlotRef(workbenchResourceKinds.workspace, "headerOverflow"),
   sidenav: defineSlot("workspace.sidenav", { kind: "panel" })
 };
 var projectEvents = {
-  opened: eventRef("project.opened")
+  opened: hostEventRef("project.opened")
 };
 var sessionEvents = {
-  started: eventRef("session.started"),
-  resumed: eventRef("session.resumed"),
-  awaitingInput: eventRef("session.awaitingInput"),
-  succeeded: eventRef("session.succeeded"),
-  failed: eventRef("session.failed"),
-  completed: eventRef("session.completed")
+  started: hostEventRef("session.started"),
+  resumed: hostEventRef("session.resumed"),
+  awaitingInput: hostEventRef("session.awaitingInput"),
+  succeeded: hostEventRef("session.succeeded"),
+  failed: hostEventRef("session.failed"),
+  completed: hostEventRef("session.completed")
 };
 var workspaceEvents = {
-  created: eventRef("workspace.created"),
-  provision: eventRef("workspace.provision"),
-  ready: eventRef("workspace.ready"),
-  archived: eventRef("workspace.archived"),
-  deleted: eventRef("workspace.deleted")
+  created: hostEventRef("workspace.created"),
+  provision: hostEventRef("workspace.provision"),
+  ready: hostEventRef("workspace.ready"),
+  archived: hostEventRef("workspace.archived"),
+  deleted: hostEventRef("workspace.deleted")
 };
 var worktreeEvents = {
-  removed: eventRef("worktree.removed")
+  removed: hostEventRef("worktree.removed")
 };
 var gitEvents = {
-  committed: eventRef("git.committed"),
-  rebased: eventRef("git.rebased"),
-  merged: eventRef("git.merged"),
-  conflicted: eventRef("git.conflicted")
+  committed: hostEventRef("git.committed"),
+  rebased: hostEventRef("git.rebased"),
+  merged: hostEventRef("git.merged"),
+  conflicted: hostEventRef("git.conflicted")
 };
 // ../pstdio-api-contracts/src/extension-kernel/l10n.ts
 var l10n = (key, defaultValue) => ({
@@ -82,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.2";
+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",
@@ -106,95 +207,13 @@ 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/extension-kernel/workbench-targets.ts
-var workbenchMenuTargets = ["workbench.nav.actions", "workbench.nav.overflow"];
-var workbenchTreeTargets = [
-  "workbench.left.tree",
-  "workbench.main.left.tree",
-  "workbench.main.right.tree"
-];
-var workbenchRegions = [
-  "nav",
-  "activity",
-  "sidenav-header",
-  "sidenav",
-  "main-header",
-  "main",
-  "secondary-header",
-  "secondary",
-  "side-header",
-  "side",
-  "status",
-  "overlay"
-];
-var workbenchViewTargets = [
-  "workbench.main",
-  "workbench.main.left",
-  "workbench.main.right",
-  "workbench.secondary"
-];
-var workbenchSettingsTargets = ["workbench.settings"];
-var workbenchSettingsScopes = ["project", "global"];
-var workbenchModePanels = ["main", "secondary", "side"];
-var workbenchModeLayoutTargets = [
-  "workbench.left",
-  "workbench.main.left",
-  "workbench.main",
-  "workbench.main.right",
-  "workbench.secondary"
-];
-var workbenchModeLayoutTargetPanels = {
-  "workbench.left": undefined,
-  "workbench.main.left": "main",
-  "workbench.main": "main",
-  "workbench.main.right": "main",
-  "workbench.secondary": "secondary"
-};
-var getWorkbenchModeLayoutTargetPanel = (target) => workbenchModeLayoutTargetPanels[target];
-var workbenchTargets = [
-  {
-    id: "workbench.nav.actions",
-    allowedKinds: ["menu"],
-    granularity: "surface",
-    rationale: "Primary command surface in the host-owned nav (top) workbench chrome."
-  },
-  {
-    id: "workbench.nav.overflow",
-    allowedKinds: ["menu"],
-    granularity: "surface",
-    rationale: "Secondary command surface in the host-owned nav (top) workbench chrome."
-  },
-  {
-    id: "workbench.left.tree",
-    allowedKinds: ["treeItem"],
-    granularity: "areaTree",
-    rationale: "Tree entries for the active tree renderer mounted in the left area."
-  },
-  {
-    id: "workbench.main.left.tree",
-    allowedKinds: ["treeItem"],
-    granularity: "areaTree",
-    rationale: "Tree entries for the active tree renderer mounted in the main-left area."
-  },
-  {
-    id: "workbench.main.right.tree",
-    allowedKinds: ["treeItem"],
-    granularity: "areaTree",
-    rationale: "Tree entries for the active tree renderer mounted in the main-right area."
-  },
-  {
-    id: "workbench.settings",
-    allowedKinds: ["settings"],
-    granularity: "surface",
-    rationale: "Settings panel placement in host-owned settings navigation."
-  }
-];
-var getWorkbenchTargetDefinition = (id) => workbenchTargets.find((target) => target.id === id);
 // src/extensions/command-outcome.ts
 var unwrapCommandOutcome = (response, fallbackReason = "Command failed.") => {
   const { outcome } = response;
@@ -204,9 +223,57 @@ var unwrapCommandOutcome = (response, fallbackReason = "Command failed.") => {
   return outcome.value;
 };
 // src/extensions/define-command.ts
-var defineCommand = (definition) => definition;
-var defineMiddleware = (definition) => definition;
-var defineHook = (definition) => definition;
+function defineCommand(definition) {
+  return { ...definition, ref: { kind: "command", id: definition.id } };
+}
+var defineMiddleware = (definition) => ({
+  ...definition,
+  ref: { kind: "middleware", id: definition.id }
+});
+var defineHook = (definition) => ({
+  ...definition,
+  ref: { kind: "hook", id: definition.id }
+});
+// src/extensions/define-contribution.ts
+var defineContribution = (_kind) => (definition) => ({
+  ...definition,
+  ref: { kind: _kind, id: definition.id }
+});
+var defineView = defineContribution("view");
+var defineViewMenu = defineContribution("view-menu");
+var definePlacement = defineContribution("placement");
+var defineResourceKind = defineContribution("resource-kind");
+var resourceMenuSlotRef2 = (resourceKind, id) => defineSlot(`${resourceKind.id}.${id}`, { kind: "menu" });
+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");
+var defineActivityItem = defineContribution("activity-item");
+var defineSettingsSection = defineContribution("settings-section");
+var defineCommandPaletteResource = defineContribution("command-palette-resource");
+var defineKeybinding = defineContribution("keybinding");
+var defineSchedule = defineContribution("schedule");
+var defineArtifactMount = defineContribution("artifact-mount");
+var defineTemplateType = defineContribution("template-type");
+var defineTemplate = defineContribution("template");
+var defineSkill = defineContribution("skill");
+var defineTheme = defineContribution("theme");
+var defineFileIconTheme = defineContribution("file-icon-theme");
+var defineWorkspaceType = defineContribution("workspace-type");
+var defineHarness = defineContribution("harness");
+var defineConnection = defineContribution("connection");
+var defineResourceHierarchyProvider = (definition) => ({
+  ...definition,
+  ref: { kind: "resource-hierarchy-provider", id: definition.id }
+});
 // src/extensions/define-extension.ts
 var defineExtension = (extension) => extension;
 // src/extensions/define-extension-view.ts
@@ -237,7 +304,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 })
 });
@@ -288,23 +355,30 @@ var params = {
   }),
   repo: (options) => ({ type: "repo", ...options }),
   harness: (options) => ({ type: "harness", ...options }),
-  template: (options) => ({
-    label: options.label,
-    description: options.description,
-    required: options.required,
-    defaultValue: options.defaultValue,
-    metadata: options.metadata,
-    type: "template",
-    templateType: options.type
-  }),
+  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) => ({
@@ -377,6 +451,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;
@@ -385,7 +462,7 @@ var createWebviewClient = (host, options) => {
   }
   const runCommand = async (commandKey, params2) => {
     const response = await host.call("commands.execute", {
-      commandId: `${extensionId}.${commandKey}`,
+      commandId: `${extensionId}.command.${commandKey}`,
       params: params2
     });
     return unwrapCommandOutcome(response);
@@ -404,51 +481,96 @@ 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) => {
   const resourceTypes = when?.resourceType;
   if (!resourceTypes?.length)
     return true;
-  return resourceType ? resourceTypes.includes(resourceType) : false;
+  return resourceType ? resourceTypes.some((candidate) => (typeof candidate === "string" ? candidate : candidate.id) === resourceType) : false;
 };
 export {
   worktreeEvents,
   workspaceSlots,
   workspaceEvents,
-  workbenchViewTargets,
-  workbenchTreeTargets,
-  workbenchTargets,
-  workbenchSettingsTargets,
-  workbenchSettingsScopes,
-  workbenchModePanels,
-  workbenchModeLayoutTargets,
-  workbenchMenuTargets,
+  workbenchSlots,
+  workbenchResourceKinds,
+  workbenchResourceKindDefinitions,
+  workbenchPanels,
+  workbenchPanelDefinitions,
+  workbenchPages,
+  workbenchPageDefinitions,
+  workbenchModes,
+  workbenchModeDefinitions,
   unwrapCommandOutcome,
   sessionSlots,
   sessionEvents,
+  resourceMenuSlotRef2 as resourceMenuSlotRef,
+  resourceKey,
+  qualifyRef,
   projectSlots,
   projectEvents,
   params,
   packageAsset,
   matchesResourceWhen,
+  localContributionIdPattern,
+  localContributionIdGrammar,
   l10n,
+  isValidLocalContributionId,
   isLocalizedString,
   gitEvents,
-  getWorkbenchTargetDefinition,
-  getWorkbenchModeLayoutTargetPanel,
+  extensionPanelRegions,
   eventRef,
   dockedWorkbenchRegions,
+  defineWorkspaceType,
+  defineViewMenu,
+  defineView,
+  defineTheme,
+  defineTemplateType,
+  defineTemplate,
+  defineStatuses,
+  defineStatusBarItem,
+  defineSlot,
+  defineSkill,
+  defineSettingsSection,
+  defineSettingsPanel,
+  defineSchedule,
+  defineResourceKind,
+  defineResourceHierarchyProvider,
+  definePlacement,
+  definePage,
+  defineNavigationTree,
+  defineNavigationItem,
+  defineMode,
   defineMiddleware,
+  defineKeybinding,
   defineHook,
+  defineHarness,
+  defineFileIconTheme,
   defineExtensionView,
   defineExtension,
+  defineConnection,
+  defineCommandPaletteResource,
   defineCommand,
+  defineArtifactMount,
+  defineActivityItem,
   createWebviewClient,
   createTerminalSessionBridge,
   commandRef,
   commandEvent,
+  artifactsRead,
+  artifactMountId,
+  WEBVIEW_SCOPED_DECLARABLE_CAPABILITIES,
   WEBVIEW_HOST_CAPABILITY_VERSION,
   WEBVIEW_HOST_CAPABILITIES,
   WEBVIEW_DECLARABLE_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 { }