@pstdio/sdk 0.14.0 → 0.16.0

package/dist/api/terminal.d.ts

@@ -0,0 +1,49 @@
+export interface TerminalSessionRequest {
+    /** Command + args to run; defaults to the user's login shell when omitted. */
+    command?: string[];
+    /** Working directory; falls back to the extension's workspace root. */
+    cwd?: string;
+    /** Extra env vars merged over the inherited environment. */
+    env?: Record<string, string>;
+    /** Initial column count; the renderer can resize later. */
+    cols: number;
+    /** Initial row count; the renderer can resize later. */
+    rows: number;
+}
+export type TerminalSessionOperation = {
+    operation: "open";
+    request: TerminalSessionRequest;
+} | {
+    operation: "write";
+    sessionId: string;
+    data: string | Uint8Array;
+} | {
+    operation: "resize";
+    sessionId: string;
+    cols: number;
+    rows: number;
+} | {
+    operation: "kill";
+    sessionId: string;
+    signal?: string;
+} | {
+    operation: "subscribe";
+    sessionId: string;
+};
+export type TerminalSessionResult = {
+    operation: "open";
+    sessionId: string;
+} | {
+    operation: "write" | "resize" | "kill" | "subscribe";
+    accepted: true;
+};
+export type TerminalHostEvent = {
+    sessionId: string;
+    kind: "data";
+    chunk: Uint8Array;
+} | {
+    sessionId: string;
+    kind: "exit";
+    code: number | null;
+    signal: string | null;
+};

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

@@ -10,6 +10,8 @@
  */
 export type GuestHost = {
     call: <TResult = unknown>(method: string, params?: unknown) => Promise<TResult>;
+    /** Subscribe to host-pushed events for a capability scope (e.g. "terminal.session"). */
+    onEvent: (scope: string, handler: (payload: unknown) => void) => () => void;
 };
 export type PropsStore<TProps = unknown> = {
     get: () => TProps;

package/dist/extensions/index.d.ts

@@ -1,11 +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, WorktreeCreatedEventPayload, WorktreeRemovedPayload, } from "pstdio-api-contracts/extension-kernel";
-export { ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES, EXTENSION_API_VERSION, 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 WorkbenchSettingsScope, type WorkbenchSettingsTarget, type WorkbenchTargetDefinition, type WorkbenchTargetGranularity, type WorkbenchTreeTarget, type WorkbenchViewTarget, workbenchMenuTargets, workbenchModeLayoutTargets, workbenchSettingsScopes, workbenchSettingsTargets, workbenchTargets, workbenchTreeTargets, workbenchViewTargets, workspaceEvents, workspaceSlots, worktreeEvents, } 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 { 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 { createTerminalSessionBridge, type TerminalSessionAdapter, type TerminalSessionBridge, type TerminalSessionExit, } from "./terminal-session-bridge";
 export { matchesResourceWhen } from "./when";

package/dist/extensions/index.js

@@ -28,7 +28,7 @@ var defineSlot = (id, options) => ({
 
 // ../pstdio-api-contracts/src/extension-kernel/kernel-slots.ts
 var projectSlots = {
-  sidebar: defineSlot("project.sidebar", { kind: "view" }),
+  sidenav: defineSlot("project.sidenav", { kind: "panel" }),
   headerPrimary: defineSlot("project.headerPrimary", { kind: "menu" }),
   headerOverflow: defineSlot("project.headerOverflow", { kind: "menu" }),
   settingsPanels: defineSlot("project.settingsPanels", { kind: "settings" })
@@ -41,7 +41,7 @@ var sessionSlots = {
 var workspaceSlots = {
   headerPrimary: defineSlot("workspace.headerPrimary", { kind: "menu" }),
   headerOverflow: defineSlot("workspace.headerOverflow", { kind: "menu" }),
-  sidebar: defineSlot("workspace.sidebar", { kind: "view" })
+  sidenav: defineSlot("workspace.sidenav", { kind: "panel" })
 };
 var projectEvents = {
   opened: eventRef("project.opened")
@@ -56,11 +56,12 @@ var sessionEvents = {
 };
 var workspaceEvents = {
   created: eventRef("workspace.created"),
+  provision: eventRef("workspace.provision"),
+  ready: eventRef("workspace.ready"),
   archived: eventRef("workspace.archived"),
   deleted: eventRef("workspace.deleted")
 };
 var worktreeEvents = {
-  created: eventRef("worktree.created"),
   removed: eventRef("worktree.removed")
 };
 var gitEvents = {
@@ -98,6 +99,7 @@ var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "extension.settings.get",
   "extension.settings.set",
   "extension.settings.delete",
+  "terminal.session",
   "files.upload",
   "files.list",
   "files.delete"
@@ -114,6 +116,20 @@ var workbenchTreeTargets = [
   "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",
@@ -122,6 +138,7 @@ var workbenchViewTargets = [
 ];
 var workbenchSettingsTargets = ["workbench.settings"];
 var workbenchSettingsScopes = ["project", "global"];
+var workbenchModePanels = ["main", "secondary", "side"];
 var workbenchModeLayoutTargets = [
   "workbench.left",
   "workbench.main.left",
@@ -129,6 +146,14 @@ var workbenchModeLayoutTargets = [
   "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",
@@ -160,30 +185,6 @@ var workbenchTargets = [
     granularity: "areaTree",
     rationale: "Tree entries for the active tree renderer mounted in the main-right area."
   },
-  {
-    id: "workbench.main",
-    allowedKinds: ["view"],
-    granularity: "area",
-    rationale: "Direct extension view placement in the main area."
-  },
-  {
-    id: "workbench.main.left",
-    allowedKinds: ["view"],
-    granularity: "area",
-    rationale: "Direct extension view placement in the main-left area."
-  },
-  {
-    id: "workbench.main.right",
-    allowedKinds: ["view"],
-    granularity: "area",
-    rationale: "Direct extension view placement in the main-right area."
-  },
-  {
-    id: "workbench.secondary",
-    allowedKinds: ["view"],
-    granularity: "area",
-    rationale: "Direct extension view placement in the secondary area."
-  },
   {
     id: "workbench.settings",
     allowedKinds: ["settings"],
@@ -274,6 +275,8 @@ var defineExtensionView = (definition) => ({
 var params = {
   text: (options) => ({ type: "text", ...options }),
   longText: (options) => ({ type: "longtext", ...options }),
+  markdown: (options) => ({ type: "markdown", ...options }),
+  files: (options) => ({ type: "files", ...options }),
   number: (options) => ({ type: "number", ...options }),
   boolean: (options) => ({ type: "boolean", ...options }),
   select: (options) => ({ type: "select", ...options }),
@@ -308,6 +311,78 @@ var commandsOf = (packageName, extension) => {
   }
   return refs;
 };
+// src/extensions/terminal-session-bridge.ts
+var TERMINAL_SESSION_CAPABILITY = "terminal.session";
+var createTerminalSessionBridge = (host) => ({
+  async openSession(request) {
+    const call = (operation) => host.call(TERMINAL_SESSION_CAPABILITY, operation);
+    const opened = await call({ operation: "open", request });
+    const sessionId = opened.sessionId;
+    const dataHandlers = new Set;
+    const exitHandlers = new Set;
+    const errorHandlers = new Set;
+    const callDetached = (operation) => {
+      call(operation).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        for (const handler of errorHandlers)
+          handler({ message });
+      });
+    };
+    const pendingData = [];
+    let pendingExit = null;
+    const unsubscribeHostEvents = host.onEvent(TERMINAL_SESSION_CAPABILITY, (payload) => {
+      const event = payload;
+      if (event.sessionId !== sessionId)
+        return;
+      if (event.kind === "data") {
+        if (dataHandlers.size === 0) {
+          pendingData.push(event.chunk);
+          return;
+        }
+        for (const handler of dataHandlers)
+          handler(event.chunk);
+        return;
+      }
+      const exit = { code: event.code, signal: event.signal };
+      if (exitHandlers.size === 0)
+        pendingExit = exit;
+      for (const handler of exitHandlers)
+        handler(exit);
+      unsubscribeHostEvents();
+    });
+    await call({ operation: "subscribe", sessionId });
+    return {
+      id: sessionId,
+      write(data) {
+        callDetached({ operation: "write", sessionId, data });
+      },
+      resize(cols, rows) {
+        callDetached({ operation: "resize", sessionId, cols, rows });
+      },
+      async kill(signal) {
+        await call({ operation: "kill", sessionId, signal });
+      },
+      onData(handler) {
+        dataHandlers.add(handler);
+        while (pendingData.length > 0)
+          handler(pendingData.shift());
+        return () => dataHandlers.delete(handler);
+      },
+      onExit(handler) {
+        exitHandlers.add(handler);
+        if (pendingExit) {
+          handler(pendingExit);
+          pendingExit = null;
+        }
+        return () => exitHandlers.delete(handler);
+      },
+      onError(handler) {
+        errorHandlers.add(handler);
+        return () => errorHandlers.delete(handler);
+      }
+    };
+  }
+});
 // src/extensions/when.ts
 var matchesResourceWhen = (when, resourceType) => {
   const resourceTypes = when?.resourceType;
@@ -324,6 +399,7 @@ export {
   workbenchTargets,
   workbenchSettingsTargets,
   workbenchSettingsScopes,
+  workbenchModePanels,
   workbenchModeLayoutTargets,
   workbenchMenuTargets,
   unwrapCommandOutcome,
@@ -338,12 +414,14 @@ export {
   isLocalizedString,
   gitEvents,
   getWorkbenchTargetDefinition,
+  getWorkbenchModeLayoutTargetPanel,
   eventRef,
   defineMiddleware,
   defineHook,
   defineExtensionView,
   defineExtension,
   defineCommand,
+  createTerminalSessionBridge,
   commandsOf,
   commandRef,
   commandEvent,

package/dist/extensions/params.d.ts

@@ -1,4 +1,4 @@
-import type { BooleanParam, HarnessParam, JsonParam, ListParam, LongTextParam, MultiSelectParam, NumberParam, RepoParam, ResourceParam, SelectParam, TemplateParam, TextParam } from "pstdio-api-contracts/extension-kernel";
+import type { BooleanParam, FilesParam, HarnessParam, JsonParam, ListParam, LongTextParam, MarkdownParam, MultiSelectParam, NumberParam, RepoParam, ResourceParam, SelectParam, TemplateParam, TextParam } from "pstdio-api-contracts/extension-kernel";
 type RequiredOf<TOptions> = TOptions extends {
     required: infer TRequired extends boolean;
 } ? TRequired : undefined;
@@ -18,6 +18,8 @@ type ParamOptions<TParam extends {
 export declare const params: {
     text: <const TOptions extends ParamOptions<TextParam> | undefined = undefined>(options?: TOptions) => TextParam<RequiredOf<TOptions>>;
     longText: <const TOptions extends ParamOptions<LongTextParam> | undefined = undefined>(options?: TOptions) => LongTextParam<RequiredOf<TOptions>>;
+    markdown: <const TOptions extends ParamOptions<MarkdownParam> | undefined = undefined>(options?: TOptions) => MarkdownParam<RequiredOf<TOptions>>;
+    files: <const TOptions extends ParamOptions<FilesParam> | undefined = undefined>(options?: TOptions) => FilesParam<RequiredOf<TOptions>>;
     number: <const TOptions extends ParamOptions<NumberParam> | undefined = undefined>(options?: TOptions) => NumberParam<RequiredOf<TOptions>>;
     boolean: <const TOptions extends ParamOptions<BooleanParam> | undefined = undefined>(options?: TOptions) => BooleanParam<RequiredOf<TOptions>>;
     select: <const TOptions extends ParamOptions<SelectParam>>(options: TOptions) => SelectParam<RequiredOf<TOptions>>;

package/dist/extensions/terminal-session-bridge.d.ts

@@ -0,0 +1,32 @@
+import type { TerminalSessionRequest } from "../api/terminal";
+import type { GuestHost } from "./define-extension-view";
+export interface TerminalSessionExit {
+    code: number | null;
+    signal: string | null;
+}
+/**
+ * Renderer-side session over the `terminal.session` capability. Structurally
+ * compatible with the `TerminalSessionAdapter` contract of `@pstdio/ui/terminal`,
+ * so it plugs straight into the `Terminal` component's `bridge` prop.
+ */
+export interface TerminalSessionAdapter {
+    readonly id: string;
+    write(data: string | Uint8Array): void;
+    resize(cols: number, rows: number): void;
+    kill(signal?: string): Promise<void>;
+    onData(handler: (chunk: Uint8Array) => void): () => void;
+    onExit(handler: (exit: TerminalSessionExit) => void): () => void;
+    onError(handler: (error: {
+        message: string;
+    }) => void): () => void;
+}
+export interface TerminalSessionBridge {
+    openSession(request: TerminalSessionRequest): Promise<TerminalSessionAdapter>;
+}
+/**
+ * Builds a terminal bridge for an extension webview from its `GuestHost`.
+ * Operations go through `host.call("terminal.session", ...)`; output and exit
+ * events arrive through the host event channel. The webview must declare the
+ * `terminal.session` capability or every call is rejected by the host gate.
+ */
+export declare const createTerminalSessionBridge: (host: GuestHost) => TerminalSessionBridge;