@pstdio/sdk 0.13.2 → 0.15.0

package/dist/api/extensions.d.ts

@@ -1 +1 @@
-export type { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ModeLayoutContributionRecord, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionTreeRendererRecord, } from "pstdio-api-contracts";
+export type { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ModeLayoutContributionRecord, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionTreeRendererRecord, } from "pstdio-api-contracts";

package/dist/api/index.d.ts

@@ -1,8 +1,10 @@
-export type { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionTreeRendererRecord, } from "./extensions";
+export type { CreateNotificationInput, ListNotificationsQuery, ListNotificationsResponse, Notification, NotificationAction, NotificationActionResult, NotificationActorType, NotificationKind, NotificationOrigin, NotificationPriority, NotificationStatus, ResourceRef, UpdateNotificationInput, } from "pstdio-api-contracts";
+export type { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionTreeRendererRecord, } from "./extensions";
 export type { CreateProjectInput, RegisterRepoInput } from "./projects";
 export type { ApprovalInput, CreateSessionInput, FollowUpInput, ResolveSessionIdInput, ResolveSessionIdResponse, SessionAttachment, SessionAttachmentRef, SessionConversationResponse, } from "./sessions";
 export { sessionAttachmentMimeTypesByExtension } from "./sessions";
 export type { Settings, UpdateSettingsInput } from "./settings";
 export type { UpdateSkillInput } from "./skills";
 export type { CreateTemplateInput, UpdateTemplateInput } from "./templates";
+export type { TerminalHostEvent, TerminalSessionOperation, TerminalSessionRequest, TerminalSessionResult, } from "./terminal";
 export type { CreateWorkspaceInput, RemoveWorktreeResponse, RenameWorkspaceInput } from "./workspaces";

package/dist/api/index.js

@@ -13636,11 +13636,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 = {
@@ -13669,12 +13670,16 @@ var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "commands.execute",
   "resource.open",
   "notification.show",
+  "notification.action",
+  "notification.resolve",
+  "notification.dismiss",
   "preferences.get",
   "preferences.set",
   "extension.settings.all",
   "extension.settings.get",
   "extension.settings.set",
   "extension.settings.delete",
+  "terminal.session",
   "files.upload",
   "files.list",
   "files.delete"
@@ -13958,6 +13963,21 @@ var extensionCommandPaletteContributionSchema = exports_external.object({
   when: extensionWhenExpressionSchema.optional()
 });
 
+// ../pstdio-api-contracts/src/extensions/controls-renderer.ts
+var extensionControlsRendererRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  title: localizableStringSchema,
+  queryCommandId: exports_external.string(),
+  updateValueCommandId: exports_external.string().optional(),
+  applyCommandId: exports_external.string().optional(),
+  resetCommandId: exports_external.string().optional(),
+  refreshEventIds: exports_external.array(exports_external.string()).optional(),
+  defaultValues: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  emptyTitle: localizableStringSchema.optional(),
+  emptyDescription: localizableStringSchema.optional()
+});
+
 // ../pstdio-api-contracts/src/extensions/data-renderer.ts
 var dataRendererEnumOptionSchema = exports_external.object({
   value: exports_external.string(),
@@ -14128,8 +14148,9 @@ var workbenchExtensionSettingsPanelRecordSchema = extensionSettingsPanelRecordSc
 });
 
 // ../pstdio-api-contracts/src/extensions/views.ts
-var hasSingleViewBody = (value) => [value.webview, value.treeRendererId, value.fileRendererId].filter(Boolean).length === 1;
-var singleViewBodyMessage = "Extension views must declare exactly one body: webview, treeRendererId, or fileRendererId";
+var hasSingleViewBody = (value) => [value.webview, value.treeRendererId, value.fileRendererId, value.controlsRendererId].filter(Boolean).length === 1;
+var singleViewBodyMessage = "Extension views must declare exactly one body: webview, treeRendererId, fileRendererId, or controlsRendererId";
+var hostTreeDefaultSchema = exports_external.enum(["default", "none"]);
 var extensionViewRecordBaseSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
@@ -14142,7 +14163,10 @@ var extensionViewRecordBaseSchema = exports_external.object({
   surface: exports_external.enum(["panel", "modal"]).optional(),
   webview: extensionWebviewContributionSchema.optional(),
   treeRendererId: exports_external.string().optional(),
-  fileRendererId: exports_external.string().optional()
+  fileRendererId: exports_external.string().optional(),
+  controlsRendererId: exports_external.string().optional(),
+  hostTreeHeader: hostTreeDefaultSchema.optional(),
+  hostTreeFooter: hostTreeDefaultSchema.optional()
 });
 var extensionViewRecordSchema = extensionViewRecordBaseSchema.refine(hasSingleViewBody, {
   message: singleViewBodyMessage
@@ -14257,6 +14281,7 @@ var extensionsCheckResponseSchema = exports_external.object({
   commandPaletteResources: exports_external.array(extensionCommandPaletteResourceRecordSchema),
   treeRenderers: exports_external.array(extensionTreeRendererRecordSchema),
   fileRenderers: exports_external.array(extensionFileRendererRecordSchema),
+  controlsRenderers: exports_external.array(extensionControlsRendererRecordSchema),
   keybindings: exports_external.array(extensionKeybindingRecordSchema),
   settingsDefinitions: exports_external.array(extensionSettingDefinitionRecordSchema).optional(),
   templates: exports_external.array(extensionViewLikeSchema),
@@ -14278,6 +14303,7 @@ var workbenchExtensionMetadataSchema = exports_external.object({
   commandPaletteResources: exports_external.array(extensionCommandPaletteResourceRecordSchema).optional(),
   treeRenderers: exports_external.array(extensionTreeRendererRecordSchema).optional(),
   fileRenderers: exports_external.array(extensionFileRendererRecordSchema).optional(),
+  controlsRenderers: exports_external.array(extensionControlsRendererRecordSchema).optional(),
   keybindings: exports_external.array(extensionKeybindingRecordSchema).optional(),
   settingsDefinitions: exports_external.array(extensionSettingDefinitionRecordSchema).optional(),
   diagnostics: exports_external.array(extensionDiagnosticSchema)
@@ -14322,6 +14348,7 @@ var extensionAttachmentInvocationSchema = exports_external.object({
 });
 var commandExecuteRequestSchema = exports_external.object({
   projectId: exports_external.string().min(1),
+  workspaceId: exports_external.string().optional(),
   params: jsonObjectSchema.optional(),
   resource: extensionResourceRefSchema.optional(),
   attachment: extensionAttachmentInvocationSchema.optional(),
@@ -14331,6 +14358,7 @@ var commandExecuteRequestSchema = exports_external.object({
   metadata: jsonObjectSchema.optional()
 });
 var commandExecuteBodySchema = exports_external.object({
+  workspaceId: exports_external.string().optional(),
   params: jsonObjectSchema.optional(),
   resource: extensionResourceRefSchema.optional(),
   attachment: extensionAttachmentInvocationSchema.optional(),
@@ -14339,6 +14367,10 @@ var commandExecuteBodySchema = exports_external.object({
   source: commandSourceSchema.optional(),
   metadata: jsonObjectSchema.optional()
 });
+var dispatchExtensionEventBodySchema = exports_external.object({
+  eventId: exports_external.string().min(1),
+  payload: jsonObjectSchema
+}).strict();
 var serializedErrorSchema = exports_external.object({
   name: exports_external.string().optional(),
   message: exports_external.string(),

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/client/client.d.ts

@@ -1,5 +1,6 @@
 import { type AgentClient } from "./agents";
 import { type ExtensionClient } from "./extensions";
+import { type NotificationsClient } from "./notifications";
 import { type ProjectClient } from "./projects";
 import type { ClientOptions } from "./request";
 import { type SessionClient } from "./sessions";
@@ -15,6 +16,7 @@ export type PstdioClient = {
     templates: TemplateClient;
     skills: SkillClient;
     agents: AgentClient;
+    notifications: NotificationsClient;
     extensions: ExtensionClient;
     settings: SettingsClient;
     sync: SyncClient;

package/dist/client/extensions.d.ts

@@ -1,4 +1,4 @@
-import type { CommandExecuteRequest, CommandExecuteResponse, EnableInstalledExtensionRequest, EnableInstalledExtensionResponse, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse } from "pstdio-api-contracts";
+import type { CommandExecuteRequest, CommandExecuteResponse, DispatchExtensionEventInput, EnableInstalledExtensionRequest, EnableInstalledExtensionResponse, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse } from "pstdio-api-contracts";
 import type { RequestFn } from "./request";
 export type ExtensionClient = {
     enableInstalled(projectId: string, installName: string, request: EnableInstalledExtensionRequest): Promise<EnableInstalledExtensionResponse>;
@@ -6,5 +6,6 @@ export type ExtensionClient = {
     listAppearance(projectId: string): Promise<ListExtensionAppearanceResponse>;
     listCommands(projectId: string): Promise<ListExtensionCommandsResponse>;
     execute(commandId: string, request: CommandExecuteRequest): Promise<CommandExecuteResponse>;
+    dispatchEvent(projectId: string, input: DispatchExtensionEventInput): Promise<void>;
 };
 export declare const createExtensionClient: (request: RequestFn) => ExtensionClient;

package/dist/client/index.d.ts

@@ -1,6 +1,7 @@
 export type { AgentClient } from "./agents";
 export { createClient, type PstdioClient } from "./client";
 export type { ExtensionClient } from "./extensions";
+export type { NotificationsClient } from "./notifications";
 export type { ProjectClient } from "./projects";
 export { type ClientOptions, createRequest, PstdioApiError, type RequestFn, type RequestOptions, } from "./request";
 export type { ListSessionsInput, SessionClient, SessionStreamConnection, SessionStreamHandlers } from "./sessions";

package/dist/client/index.js

@@ -37,7 +37,51 @@ var createExtensionClient = (request) => ({
       method: "POST",
       body
     });
-  }
+  },
+  dispatchEvent: (projectId, body) => request(`/v1/projects/${projectId}/extensions/events/dispatch`, {
+    method: "POST",
+    body
+  })
+});
+
+// src/client/notifications.ts
+var appendArrayOrValue = (params, key, value) => {
+  if (value === undefined)
+    return;
+  params.set(key, Array.isArray(value) ? value.join(",") : value);
+};
+var buildQuery = (query = {}) => {
+  const params = new URLSearchParams;
+  appendArrayOrValue(params, "status", query.status);
+  appendArrayOrValue(params, "priority", query.priority);
+  if (query.sourceExtensionId)
+    params.set("sourceExtensionId", query.sourceExtensionId);
+  if (query.resourceType)
+    params.set("resourceType", query.resourceType);
+  if (query.resourceId)
+    params.set("resourceId", query.resourceId);
+  if (query.cursor)
+    params.set("cursor", query.cursor);
+  if (query.limit !== undefined)
+    params.set("limit", String(query.limit));
+  const value = params.toString();
+  return value ? `?${value}` : "";
+};
+var notificationPath = (projectId, suffix = "") => `/v1/projects/${encodeURIComponent(projectId)}/notifications${suffix}`;
+var createNotificationsClient = (request) => ({
+  list: (projectId, query) => request(notificationPath(projectId, buildQuery(query))),
+  count: (projectId, query) => request(notificationPath(projectId, `/count${buildQuery(query)}`)),
+  get: (projectId, id) => request(notificationPath(projectId, `/${encodeURIComponent(id)}`)),
+  create: (input) => {
+    const { projectId, ...body } = input;
+    return request(notificationPath(projectId), { method: "POST", body });
+  },
+  update: (projectId, id, input) => request(notificationPath(projectId, `/${encodeURIComponent(id)}`), { method: "PATCH", body: input }),
+  markRead: (projectId, id) => request(notificationPath(projectId, `/${encodeURIComponent(id)}/read`), { method: "POST" }),
+  dismiss: (projectId, id) => request(notificationPath(projectId, `/${encodeURIComponent(id)}/dismiss`), { method: "POST" }),
+  markDone: (projectId, id) => request(notificationPath(projectId, `/${encodeURIComponent(id)}/done`), { method: "POST" }),
+  snooze: (projectId, id, until) => request(notificationPath(projectId, `/${encodeURIComponent(id)}/snooze`), { method: "POST", body: { until } }),
+  resolveByDedupeKey: (projectId, input) => request(notificationPath(projectId, "/resolve-by-dedupe-key"), { method: "POST", body: input })
 });
 
 // src/client/projects.ts
@@ -497,6 +541,7 @@ var createClient = (options = {}) => {
     templates: createTemplateClient(request),
     skills: createSkillClient(request),
     agents: createAgentClient(request),
+    notifications: createNotificationsClient(request),
     extensions: createExtensionClient(request),
     settings: createSettingsClient(request),
     sync: createSyncClient(options)

package/dist/client/notifications.d.ts

@@ -0,0 +1,23 @@
+import type { CreateNotificationInput, ListNotificationsQuery, ListNotificationsResponse, Notification, NotificationStatus, UpdateNotificationInput } from "pstdio-api-contracts";
+import type { RequestFn } from "./request";
+export type NotificationsClient = {
+    list(projectId: string, query?: ListNotificationsQuery): Promise<ListNotificationsResponse>;
+    count(projectId: string, query?: Pick<ListNotificationsQuery, "status" | "priority" | "sourceExtensionId">): Promise<{
+        count: number;
+    }>;
+    get(projectId: string, id: string): Promise<Notification>;
+    create(input: CreateNotificationInput): Promise<Notification>;
+    update(projectId: string, id: string, input: UpdateNotificationInput): Promise<Notification>;
+    markRead(projectId: string, id: string): Promise<Notification>;
+    dismiss(projectId: string, id: string): Promise<Notification>;
+    markDone(projectId: string, id: string): Promise<Notification>;
+    snooze(projectId: string, id: string, until: string): Promise<Notification>;
+    resolveByDedupeKey(projectId: string, input: {
+        dedupeKey: string;
+        status?: Extract<NotificationStatus, "done" | "dismissed" | "expired">;
+    }): Promise<{
+        resolved: number;
+        notifications: Notification[];
+    }>;
+};
+export declare const createNotificationsClient: (request: RequestFn) => NotificationsClient;

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,5 +1,6 @@
+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 type { CommitPayload, ConflictPayload, MergePayload, RebasePayload, SessionLifecyclePayload, WorkspaceProvisionPayload, WorkspaceType, 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 CommandResponse, unwrapCommandOutcome } from "./command-outcome";
 export { defineCommand, defineHook, defineMiddleware } from "./define-command";
@@ -7,4 +8,5 @@ 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

@@ -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 = {
@@ -89,12 +90,16 @@ var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "commands.execute",
   "resource.open",
   "notification.show",
+  "notification.action",
+  "notification.resolve",
+  "notification.dismiss",
   "preferences.get",
   "preferences.set",
   "extension.settings.all",
   "extension.settings.get",
   "extension.settings.set",
   "extension.settings.delete",
+  "terminal.session",
   "files.upload",
   "files.list",
   "files.delete"
@@ -305,6 +310,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;
@@ -341,6 +418,7 @@ export {
   defineExtensionView,
   defineExtension,
   defineCommand,
+  createTerminalSessionBridge,
   commandsOf,
   commandRef,
   commandEvent,

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;

package/dist/resources/index.js

@@ -13636,11 +13636,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 = {
@@ -13669,12 +13670,16 @@ var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "commands.execute",
   "resource.open",
   "notification.show",
+  "notification.action",
+  "notification.resolve",
+  "notification.dismiss",
   "preferences.get",
   "preferences.set",
   "extension.settings.all",
   "extension.settings.get",
   "extension.settings.set",
   "extension.settings.delete",
+  "terminal.session",
   "files.upload",
   "files.list",
   "files.delete"
@@ -13958,6 +13963,21 @@ var extensionCommandPaletteContributionSchema = exports_external.object({
   when: extensionWhenExpressionSchema.optional()
 });
 
+// ../pstdio-api-contracts/src/extensions/controls-renderer.ts
+var extensionControlsRendererRecordSchema = exports_external.object({
+  id: exports_external.string(),
+  extensionId: exports_external.string(),
+  title: localizableStringSchema,
+  queryCommandId: exports_external.string(),
+  updateValueCommandId: exports_external.string().optional(),
+  applyCommandId: exports_external.string().optional(),
+  resetCommandId: exports_external.string().optional(),
+  refreshEventIds: exports_external.array(exports_external.string()).optional(),
+  defaultValues: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+  emptyTitle: localizableStringSchema.optional(),
+  emptyDescription: localizableStringSchema.optional()
+});
+
 // ../pstdio-api-contracts/src/extensions/data-renderer.ts
 var dataRendererEnumOptionSchema = exports_external.object({
   value: exports_external.string(),
@@ -14128,8 +14148,9 @@ var workbenchExtensionSettingsPanelRecordSchema = extensionSettingsPanelRecordSc
 });
 
 // ../pstdio-api-contracts/src/extensions/views.ts
-var hasSingleViewBody = (value) => [value.webview, value.treeRendererId, value.fileRendererId].filter(Boolean).length === 1;
-var singleViewBodyMessage = "Extension views must declare exactly one body: webview, treeRendererId, or fileRendererId";
+var hasSingleViewBody = (value) => [value.webview, value.treeRendererId, value.fileRendererId, value.controlsRendererId].filter(Boolean).length === 1;
+var singleViewBodyMessage = "Extension views must declare exactly one body: webview, treeRendererId, fileRendererId, or controlsRendererId";
+var hostTreeDefaultSchema = exports_external.enum(["default", "none"]);
 var extensionViewRecordBaseSchema = exports_external.object({
   id: exports_external.string(),
   extensionId: exports_external.string(),
@@ -14142,7 +14163,10 @@ var extensionViewRecordBaseSchema = exports_external.object({
   surface: exports_external.enum(["panel", "modal"]).optional(),
   webview: extensionWebviewContributionSchema.optional(),
   treeRendererId: exports_external.string().optional(),
-  fileRendererId: exports_external.string().optional()
+  fileRendererId: exports_external.string().optional(),
+  controlsRendererId: exports_external.string().optional(),
+  hostTreeHeader: hostTreeDefaultSchema.optional(),
+  hostTreeFooter: hostTreeDefaultSchema.optional()
 });
 var extensionViewRecordSchema = extensionViewRecordBaseSchema.refine(hasSingleViewBody, {
   message: singleViewBodyMessage
@@ -14257,6 +14281,7 @@ var extensionsCheckResponseSchema = exports_external.object({
   commandPaletteResources: exports_external.array(extensionCommandPaletteResourceRecordSchema),
   treeRenderers: exports_external.array(extensionTreeRendererRecordSchema),
   fileRenderers: exports_external.array(extensionFileRendererRecordSchema),
+  controlsRenderers: exports_external.array(extensionControlsRendererRecordSchema),
   keybindings: exports_external.array(extensionKeybindingRecordSchema),
   settingsDefinitions: exports_external.array(extensionSettingDefinitionRecordSchema).optional(),
   templates: exports_external.array(extensionViewLikeSchema),
@@ -14278,6 +14303,7 @@ var workbenchExtensionMetadataSchema = exports_external.object({
   commandPaletteResources: exports_external.array(extensionCommandPaletteResourceRecordSchema).optional(),
   treeRenderers: exports_external.array(extensionTreeRendererRecordSchema).optional(),
   fileRenderers: exports_external.array(extensionFileRendererRecordSchema).optional(),
+  controlsRenderers: exports_external.array(extensionControlsRendererRecordSchema).optional(),
   keybindings: exports_external.array(extensionKeybindingRecordSchema).optional(),
   settingsDefinitions: exports_external.array(extensionSettingDefinitionRecordSchema).optional(),
   diagnostics: exports_external.array(extensionDiagnosticSchema)
@@ -14322,6 +14348,7 @@ var extensionAttachmentInvocationSchema = exports_external.object({
 });
 var commandExecuteRequestSchema = exports_external.object({
   projectId: exports_external.string().min(1),
+  workspaceId: exports_external.string().optional(),
   params: jsonObjectSchema.optional(),
   resource: extensionResourceRefSchema.optional(),
   attachment: extensionAttachmentInvocationSchema.optional(),
@@ -14331,6 +14358,7 @@ var commandExecuteRequestSchema = exports_external.object({
   metadata: jsonObjectSchema.optional()
 });
 var commandExecuteBodySchema = exports_external.object({
+  workspaceId: exports_external.string().optional(),
   params: jsonObjectSchema.optional(),
   resource: extensionResourceRefSchema.optional(),
   attachment: extensionAttachmentInvocationSchema.optional(),
@@ -14339,6 +14367,10 @@ var commandExecuteBodySchema = exports_external.object({
   source: commandSourceSchema.optional(),
   metadata: jsonObjectSchema.optional()
 });
+var dispatchExtensionEventBodySchema = exports_external.object({
+  eventId: exports_external.string().min(1),
+  payload: jsonObjectSchema
+}).strict();
 var serializedErrorSchema = exports_external.object({
   name: exports_external.string().optional(),
   message: exports_external.string(),

package/package.json

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