@pstdio/sdk 0.37.0 → 0.39.0

package/README.md

@@ -105,6 +105,8 @@ readiness and file capabilities. Remote workspaces never fall back to local file
 `ctx.workspaces.listProviders()` returns available providers, their optional `icon`, and their parameters.
 Render these declared parameters after the user selects a workspace type. The Git
 provider supplies a **Base branch** selection; cloud providers supply their own fields.
+A command that creates a workspace can declare `params.workspace({ providers })`. The
+dashboard then renders this same form, and the command receives `{ providerId, params }`.
 Local setup failures reject creation with the saved workspace ID and setup error.
 The workspace remains available for diagnosis and retry.
 Workspace context records expose `root_path` for a local directory. Remote workspaces have no local root.
@@ -116,8 +118,8 @@ Directory creation accepts one child name under an existing parent.
 Webviews can set `workspaceId` in `createWebviewClient(host, { workspaceId })`
 to run commands in that workspace. The host validates project ownership.
 
-The current host API version is `1.0.0-alpha.14`. Extensions that also work with the
-previous contract can declare `1.0.0-alpha.13 || 1.0.0-alpha.14` in `engines.pstdio`.
-General version ranges and wildcards remain unsupported.
-The compatible extension release must precede the host cutover.
-See [the staged release ADR](../../documentation/adrs/0030-temporary-workspace-contract-release-bridge.md).
+`EXTENSION_API_VERSION` is the current host API version, such as `0.1.0`. Declare a caret
+range in `engines.pstdio`, such as `^0.1.0`, so the extension keeps loading across additive
+host releases. Raise the minimum only when the extension uses a newer API. On `0.x`, a new
+minor is a breaking release. See
+[API versioning](../../documentation/references/extensions/0014-api-versioning.md).

package/dist/api/index.js

@@ -6781,6 +6781,7 @@ var controlParamSchema = discriminatedUnion("type", [
     ...base,
     ...selection,
     type: literal("selection"),
+    allowCustomValues: boolean2().optional(),
     defaultValue: selectionValue,
     options: array(selectionOption),
     multiSelect: boolean2().optional(),
@@ -6929,6 +6930,20 @@ var extensionControlsRendererRecordSchema = extensionRendererRecordBaseSchema.ex
   defaultValues: controlValuesSchema.optional()
 });
 
+// ../pstdio-api-contracts/src/extensions/view-toolbar-action.ts
+var viewToolbarActionSchema = object({
+  id: string2(),
+  label: localizableStringSchema,
+  icon: string2().optional(),
+  presentation: _enum(["primary", "secondary"]).optional(),
+  params: jsonObjectSchema.optional(),
+  input: extensionParamObjectSchema.optional(),
+  submitLabel: string2().optional(),
+  when: string2().optional(),
+  disabled: boolean2().optional()
+});
+var viewToolbarActionRecordSchema = viewToolbarActionSchema.extend({ commandId: string2() });
+
 // ../pstdio-api-contracts/src/extensions/data-table-renderer.ts
 var themeColorSchema = object({
   light: string2(),
@@ -6975,6 +6990,7 @@ var selectionActionSchema = object({
   commandId: string2()
 });
 var extensionDataTableRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  toolbarActions: array(viewToolbarActionRecordSchema).optional(),
   columns: array(dataTableRendererColumnSchema).optional(),
   queryHandlerId: string2(),
   selectionMode: _enum(["none", "multiple"]).optional(),
@@ -7067,6 +7083,7 @@ var extensionKanbanRendererRowActionSchema = object({
   destructive: boolean2().optional()
 });
 var extensionKanbanRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  toolbarActions: array(viewToolbarActionRecordSchema).optional(),
   extensionInstanceId: string2().optional(),
   attributes: array(kanbanRendererAttributeSchema).optional(),
   queryHandlerId: string2(),
@@ -7275,15 +7292,17 @@ var webviewBodySchema = object({ kind: literal("webview"), webview: workbenchExt
 var treeBodySchema = extensionTreeRendererRecordSchema.omit(rendererBaseOmissions).extend({ kind: literal("tree") });
 var fileBodySchema = extensionFileRendererRecordSchema.omit(rendererBaseOmissions).extend({ kind: literal("file") });
 var controlsBodySchema = extensionControlsRendererRecordSchema.omit(rendererBaseOmissions).extend({ kind: literal("controls") });
-var kanbanBodySchema = extensionKanbanRendererRecordSchema.omit({ ...rendererBaseOmissions, createRow: true, rowActions: true }).extend({
+var kanbanBodySchema = extensionKanbanRendererRecordSchema.omit({ ...rendererBaseOmissions, createRow: true, rowActions: true, toolbarActions: true }).extend({
   kind: literal("kanban"),
   createRow: kanbanCreateRowSchema.optional(),
-  rowActions: array(commandActionSchema).optional()
+  rowActions: array(commandActionSchema).optional(),
+  toolbarActions: array(viewToolbarActionSchema.extend({ command: commandRefSchema })).optional()
 });
-var dataTableBodySchema = extensionDataTableRendererRecordSchema.omit({ ...rendererBaseOmissions, selectionActions: true, rowActions: true }).extend({
+var dataTableBodySchema = extensionDataTableRendererRecordSchema.omit({ ...rendererBaseOmissions, selectionActions: true, rowActions: true, toolbarActions: true }).extend({
   kind: literal("dataTable"),
   selectionActions: array(commandActionSchema).optional(),
-  rowActions: array(commandActionSchema).optional()
+  rowActions: array(commandActionSchema).optional(),
+  toolbarActions: array(viewToolbarActionSchema.extend({ command: commandRefSchema })).optional()
 });
 var workbenchExtensionViewBodySchema = discriminatedUnion("kind", [
   webviewBodySchema,
@@ -7359,6 +7378,7 @@ var workbenchExtensionResourceKindRecordSchema = object({
   extensionId: string2(),
   label: localizableStringSchema.optional(),
   icon: string2().optional(),
+  resolveCommand: string2().optional(),
   menuSlots: array(object({
     id: string2(),
     placement: _enum(["header-primary", "header-overflow", "context-menu"]),
@@ -7659,10 +7679,45 @@ var automationRunEventSchema = object({
   createdAt: string2()
 });
 var listAutomationRunEventsResponseSchema = object({ events: array(automationRunEventSchema) });
+// ../pstdio-api-contracts/src/board-views.ts
+var boardFieldSchema = object({
+  id: string2(),
+  label: string2(),
+  kind: _enum(["enum", "enum-multi", "status", "string", "date", "number", "user"]),
+  filterable: boolean2(),
+  groupable: boolean2(),
+  sortable: boolean2(),
+  displayable: boolean2(),
+  options: array(object({ value: string2(), label: string2() })).optional()
+});
+var boardSummarySchema = object({
+  id: string2(),
+  title: string2(),
+  extensionId: string2(),
+  fields: array(boardFieldSchema)
+});
+var boardFiltersSchema = record(string2(), array(string2()));
+var boardViewSchema = object({
+  id: string2(),
+  boardId: string2(),
+  title: string2(),
+  settings: kanbanRendererSettingsSchema,
+  filters: boardFiltersSchema,
+  builtIn: boolean2()
+});
+var boardViewsSchema = object({ views: array(boardViewSchema), defaultViewId: string2() });
+var boardViewUpdateSchema = object({
+  title: string2().trim().min(1).optional(),
+  settings: kanbanRendererSettingsSchema.partial().optional(),
+  filters: boardFiltersSchema.optional()
+}).strict();
+var boardViewCreateSchema = boardViewUpdateSchema.extend({
+  title: string2().trim().min(1),
+  copyFrom: string2().optional()
+});
 // ../pstdio-api-contracts/src/extension-kernel/api-versions.ts
 var numericIdentifier = "(?:0|[1-9]\\d*)";
-var prereleaseIdentifier = `(?:${numericIdentifier}|\\d*[A-Za-z-][0-9A-Za-z-]*)`;
-var exactVersion = new RegExp(`^${numericIdentifier}\\.${numericIdentifier}\\.${numericIdentifier}(?:-${prereleaseIdentifier}(?:\\.${prereleaseIdentifier})*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$`);
+var caretTerm = new RegExp(`^\\^(${numericIdentifier}\\.${numericIdentifier}\\.${numericIdentifier})$`);
 // ../pstdio-api-contracts/src/extension-kernel/builtin-refs.ts
 var hostRef = (kind, id) => ({ extensionId: "pstdio", kind, id });
 var workbenchModes = {
@@ -7916,7 +7971,7 @@ var packageAsset = (path, baseUrl) => ({
   baseUrl
 });
 // ../pstdio-api-contracts/src/extension-kernel/types/extension.ts
-var EXTENSION_API_VERSION = "1.0.0-alpha.14";
+var EXTENSION_API_VERSION = "0.1.0";
 // ../pstdio-api-contracts/src/extension-kernel/types/webview-capabilities.ts
 var WEBVIEW_HOST_CAPABILITY_VERSION = 1;
 var WEBVIEW_DECLARABLE_CAPABILITIES = [

package/dist/api.d.ts

@@ -1,6 +1,6 @@
-import { $ as WorkbenchExtensionMetadata, $a as FollowUpInput, At as TerminalHostEvent, B as ConfigureExtensionConnectionInput, C as ExtensionSettingsPanelRecord, D as ExtensionCommandPaletteResourceRecord, E as ExtensionKeybindingRecord, F as ProjectExtensionInstance, G as LocalizableString, H as ListExtensionConnectionsResponse, I as UpgradeProjectExtensionResponse, J as ExtensionMenuContribution, K as ExtensionCommandPaletteContribution, L as CommandExecuteRequest, M as InstallMarketplaceExtensionResponse, Mt as TerminalSessionRequest, N as ListProjectExtensionsResponse, Nt as TerminalSessionResult, O as WorkbenchExtensionCommandPaletteResourceRecord, P as MarketplaceExtension, Q as WorkbenchExtensionHarnessRecord, Qa as CreateSessionInput, R as CommandExecuteResponse, S as ExtensionSettingValueRecord, So as UpdateNotificationInput, T as UpdateExtensionSettingRequest, U as ExtensionDiagnostic, V as ExtensionConnectionRecord, W as ExtensionRecord, X as ListExtensionAppearanceResponse, Xa as UpdateSkillInput, Y as WorkbenchExtensionAutomationRecord, Yu as ResourceRef, Z as ListExtensionCommandsResponse, Za as ApprovalInput, _ as CreateProjectInput, _o as NotificationActorType, a as RemoveWorktreeResponse$1, at as AutomationRunStatus, bo as NotificationPriority, c as WorkspaceFileContent$1, co as SessionConversationResponse, ct as IssueAutomationTokenInput, dt as ListAutomationTokensResponse, et as WorkbenchExtensionViewBody, f as WorkspaceProviderDescriptor, fo as CreateNotificationInput, g as sessionAttachmentMimeTypesByExtension, go as NotificationAction, h as UpdateSettingsInput, ho as Notification, i as ListWorkspaceFilesInput$1, io as ResolveSessionIdResponse, it as AutomationRunEvent, jt as TerminalSessionOperation, k as AddLocalExtensionFolderResponse, l as WorkspaceFileEntry$1, lo as SessionConversationSources, lt as IssueAutomationTokenResponse, m as Settings, mo as ListNotificationsResponse, nt as AutomationRun, o as RenameWorkspaceInput$1, oo as SessionAttachment, ot as AutomationTokenRecord, p as WriteWorkspaceFileInput$1, po as ListNotificationsQuery, q as ExtensionCommandRecord, ro as ResolveSessionIdInput, rt as AutomationRunError, so as SessionAttachmentRef, st as CreateAutomationRunInput, t as CreateWorkspaceInput$1, tt as WorkbenchExtensionViewRecord, u as WorkspaceFilesResponse$1, uo as SessionQueuedMessagesResponse, ut as ListAutomationRunEventsResponse, vo as NotificationKind, w as ListExtensionSettingsResponse, x as ExtensionSettingDefinitionRecord, xo as NotificationStatus, y as UpdateProjectInput, yo as NotificationOrigin } from "./index-CnOTGr_I.js";
-import "./sessions-CkEvTavd.js";
-import "./skills-CkEvTavd.js";
+import { $ as WorkbenchExtensionMetadata, $u as NotificationActorType, B as ConfigureExtensionConnectionInput, Bu as ResolveSessionIdResponse, C as ExtensionSettingsPanelRecord, D as ExtensionCommandPaletteResourceRecord, E as ExtensionKeybindingRecord, F as ProjectExtensionInstance, Fu as FollowUpInput, G as LocalizableString, Gu as SessionConversationSources, H as ListExtensionConnectionsResponse, Hu as SessionAttachment, I as UpgradeProjectExtensionResponse, It as TerminalHostEvent, J as ExtensionMenuContribution, Ju as CreateNotificationInput, K as ExtensionCommandPaletteContribution, Ku as SessionQueuedMessagesResponse, L as CommandExecuteRequest, Lt as TerminalSessionOperation, M as InstallMarketplaceExtensionResponse, Mu as UpdateSkillInput, N as ListProjectExtensionsResponse, Nu as ApprovalInput, O as WorkbenchExtensionCommandPaletteResourceRecord, P as MarketplaceExtension, Pu as CreateSessionInput, Q as WorkbenchExtensionHarnessRecord, Qu as NotificationAction, R as CommandExecuteResponse, Rt as TerminalSessionRequest, S as ExtensionSettingValueRecord, T as UpdateExtensionSettingRequest, U as ExtensionDiagnostic, Uu as SessionAttachmentRef, V as ExtensionConnectionRecord, W as ExtensionRecord, Wu as SessionConversationResponse, X as ListExtensionAppearanceResponse, Xu as ListNotificationsResponse, Y as WorkbenchExtensionAutomationRecord, Yu as ListNotificationsQuery, Z as ListExtensionCommandsResponse, Zu as Notification, _ as CreateProjectInput, _t as ListAutomationTokensResponse, a as RemoveWorktreeResponse$1, at as BoardViewCreate, c as WorkspaceFileContent$1, ct as AutomationRun, dt as AutomationRunStatus, ed as NotificationKind, et as WorkbenchExtensionViewBody, f as WorkspaceProviderDescriptor, ft as AutomationTokenRecord, g as sessionAttachmentMimeTypesByExtension, gt as ListAutomationRunEventsResponse, h as UpdateSettingsInput, ht as IssueAutomationTokenResponse, i as ListWorkspaceFilesInput$1, id as UpdateNotificationInput, it as BoardView, k as AddLocalExtensionFolderResponse, l as WorkspaceFileEntry$1, lt as AutomationRunError, m as Settings, mt as IssueAutomationTokenInput, nd as NotificationPriority, nt as BoardField, o as RenameWorkspaceInput$1, ot as BoardViewUpdate, p as WriteWorkspaceFileInput$1, pt as CreateAutomationRunInput, q as ExtensionCommandRecord, rd as NotificationStatus, rt as BoardSummary, st as BoardViews, t as CreateWorkspaceInput$1, td as NotificationOrigin, tt as WorkbenchExtensionViewRecord, u as WorkspaceFilesResponse$1, ud as ResourceRef, ut as AutomationRunEvent, w as ListExtensionSettingsResponse, x as ExtensionSettingDefinitionRecord, y as UpdateProjectInput, zt as TerminalSessionResult, zu as ResolveSessionIdInput } from "./index-Dd4tqVV7.js";
+import "./sessions-C-D1oPr0.js";
+import "./skills-C-D1oPr0.js";
 //#region src/api/workspaces.d.ts
 type CreateWorkspaceInput = CreateWorkspaceInput$1;
 type RemoveWorktreeResponse = RemoveWorktreeResponse$1;
@@ -11,5 +11,5 @@ type WorkspaceFileEntry = WorkspaceFileEntry$1;
 type WorkspaceFilesResponse = WorkspaceFilesResponse$1;
 type WriteWorkspaceFileInput = WriteWorkspaceFileInput$1;
 //#endregion
-export { type AddLocalExtensionFolderResponse, type ApprovalInput, type AutomationRun, type AutomationRunError, type AutomationRunEvent, type AutomationRunStatus, type AutomationTokenRecord, type CommandExecuteRequest, type CommandExecuteResponse, type ConfigureExtensionConnectionInput, type CreateAutomationRunInput, type CreateNotificationInput, type CreateProjectInput, type CreateSessionInput, type CreateWorkspaceInput, type ExtensionCommandPaletteContribution, type ExtensionCommandPaletteResourceRecord, type ExtensionCommandRecord, type ExtensionConnectionRecord, type ExtensionDiagnostic, type ExtensionKeybindingRecord, type ExtensionMenuContribution, type ExtensionRecord, type ExtensionSettingDefinitionRecord, type ExtensionSettingValueRecord, type ExtensionSettingsPanelRecord, type FollowUpInput, type InstallMarketplaceExtensionResponse, type IssueAutomationTokenInput, type IssueAutomationTokenResponse, type ListAutomationRunEventsResponse, type ListAutomationTokensResponse, type ListExtensionAppearanceResponse, type ListExtensionCommandsResponse, type ListExtensionConnectionsResponse, type ListExtensionSettingsResponse, type ListNotificationsQuery, type ListNotificationsResponse, type ListProjectExtensionsResponse, type ListWorkspaceFilesInput, type LocalizableString, type MarketplaceExtension, type Notification, type NotificationAction, type NotificationActorType, type NotificationKind, type NotificationOrigin, type NotificationPriority, type NotificationStatus, type ProjectExtensionInstance, type RemoveWorktreeResponse, type RenameWorkspaceInput, type ResolveSessionIdInput, type ResolveSessionIdResponse, type ResourceRef, type SessionAttachment, type SessionAttachmentRef, type SessionConversationResponse, type SessionConversationSources, type SessionQueuedMessagesResponse, type Settings, type TerminalHostEvent, type TerminalSessionOperation, type TerminalSessionRequest, type TerminalSessionResult, type UpdateExtensionSettingRequest, type UpdateNotificationInput, type UpdateProjectInput, type UpdateSettingsInput, type UpdateSkillInput, type UpgradeProjectExtensionResponse, type WorkbenchExtensionAutomationRecord, type WorkbenchExtensionCommandPaletteResourceRecord, type WorkbenchExtensionHarnessRecord, type WorkbenchExtensionMetadata, type WorkbenchExtensionViewBody, type WorkbenchExtensionViewRecord, type WorkspaceFileContent, type WorkspaceFileEntry, type WorkspaceFilesResponse, type WorkspaceProviderDescriptor, type WriteWorkspaceFileInput, sessionAttachmentMimeTypesByExtension };
+export { type AddLocalExtensionFolderResponse, type ApprovalInput, type AutomationRun, type AutomationRunError, type AutomationRunEvent, type AutomationRunStatus, type AutomationTokenRecord, type BoardField, type BoardSummary, type BoardView, type BoardViewCreate, type BoardViewUpdate, type BoardViews, type CommandExecuteRequest, type CommandExecuteResponse, type ConfigureExtensionConnectionInput, type CreateAutomationRunInput, type CreateNotificationInput, type CreateProjectInput, type CreateSessionInput, type CreateWorkspaceInput, type ExtensionCommandPaletteContribution, type ExtensionCommandPaletteResourceRecord, type ExtensionCommandRecord, type ExtensionConnectionRecord, type ExtensionDiagnostic, type ExtensionKeybindingRecord, type ExtensionMenuContribution, type ExtensionRecord, type ExtensionSettingDefinitionRecord, type ExtensionSettingValueRecord, type ExtensionSettingsPanelRecord, type FollowUpInput, type InstallMarketplaceExtensionResponse, type IssueAutomationTokenInput, type IssueAutomationTokenResponse, type ListAutomationRunEventsResponse, type ListAutomationTokensResponse, type ListExtensionAppearanceResponse, type ListExtensionCommandsResponse, type ListExtensionConnectionsResponse, type ListExtensionSettingsResponse, type ListNotificationsQuery, type ListNotificationsResponse, type ListProjectExtensionsResponse, type ListWorkspaceFilesInput, type LocalizableString, type MarketplaceExtension, type Notification, type NotificationAction, type NotificationActorType, type NotificationKind, type NotificationOrigin, type NotificationPriority, type NotificationStatus, type ProjectExtensionInstance, type RemoveWorktreeResponse, type RenameWorkspaceInput, type ResolveSessionIdInput, type ResolveSessionIdResponse, type ResourceRef, type SessionAttachment, type SessionAttachmentRef, type SessionConversationResponse, type SessionConversationSources, type SessionQueuedMessagesResponse, type Settings, type TerminalHostEvent, type TerminalSessionOperation, type TerminalSessionRequest, type TerminalSessionResult, type UpdateExtensionSettingRequest, type UpdateNotificationInput, type UpdateProjectInput, type UpdateSettingsInput, type UpdateSkillInput, type UpgradeProjectExtensionResponse, type WorkbenchExtensionAutomationRecord, type WorkbenchExtensionCommandPaletteResourceRecord, type WorkbenchExtensionHarnessRecord, type WorkbenchExtensionMetadata, type WorkbenchExtensionViewBody, type WorkbenchExtensionViewRecord, type WorkspaceFileContent, type WorkspaceFileEntry, type WorkspaceFilesResponse, type WorkspaceProviderDescriptor, type WriteWorkspaceFileInput, sessionAttachmentMimeTypesByExtension };
 export {};

package/dist/client/index.js

@@ -19,6 +19,23 @@ var createAutomationClient = (request) => ({
   cancelRun: (projectId, runId) => request(`/v1/projects/${projectId}/automation-runs/${encodeURIComponent(runId)}/cancel`, { method: "POST" })
 });
 
+// src/client/board-views.ts
+var projectPath = (id) => `/v1/projects/${encodeURIComponent(id)}`;
+var boardPath = (projectId, boardId) => `${projectPath(projectId)}/boards/${encodeURIComponent(boardId)}/views`;
+var viewPath = (projectId, id) => `${projectPath(projectId)}/board-views/${encodeURIComponent(id)}`;
+var createBoardViewsClient = (request) => ({
+  board: (projectId, boardId) => request(`${projectPath(projectId)}/boards/${encodeURIComponent(boardId)}`),
+  get: (projectId, id) => request(viewPath(projectId, id)),
+  boards: (projectId) => request(`${projectPath(projectId)}/boards`),
+  list: (projectId, boardId) => request(boardPath(projectId, boardId)),
+  orphaned: (projectId) => request(`${projectPath(projectId)}/board-views?orphaned=true`),
+  create: (projectId, boardId, input) => request(boardPath(projectId, boardId), { method: "POST", body: input }),
+  update: (projectId, id, input) => request(viewPath(projectId, id), { method: "PATCH", body: input }),
+  delete: (projectId, id) => request(viewPath(projectId, id), { method: "DELETE" }),
+  reorder: (projectId, boardId, viewIds) => request(`${boardPath(projectId, boardId)}/order`, { method: "PUT", body: { viewIds } }),
+  setDefault: (projectId, boardId, viewId) => request(`${boardPath(projectId, boardId)}/default`, { method: "PUT", body: { viewId } })
+});
+
 // src/client/extensions.ts
 var createExtensionClient = (request) => ({
   enableInstalled: (projectId, installName, body) => request(`/v1/projects/${projectId}/extensions/installed/${encodeURIComponent(installName)}/enable`, {
@@ -281,6 +298,97 @@ var readSseStream = async (body, onEvent, options = {}) => {
   }
 };
 
+// src/client/session-stream.ts
+var createSessionStreamTransport = (request, clientOptions) => {
+  const subscriptions = new Map;
+  let connection;
+  const subscribe = (connectionId, id, subscription) => {
+    subscription.started = request(`/v1/session-stream/${connectionId}/subscriptions`, {
+      method: "POST",
+      body: { subscription_id: id, session_id: subscription.sessionId }
+    }).then(() => {}, (error) => {
+      if (subscriptions.get(id) !== subscription)
+        return;
+      release(id, false);
+      subscription.onError(error);
+    });
+  };
+  const release = (id, notifyServer) => {
+    const started = subscriptions.get(id)?.started;
+    subscriptions.delete(id);
+    if (!connection)
+      return;
+    if (subscriptions.size === 0) {
+      connection.controller.abort();
+      connection = undefined;
+      return;
+    }
+    if (!notifyServer || !started)
+      return;
+    const path = `/v1/session-stream/${connection.id}/subscriptions/${id}`;
+    started.then(() => request(path, { method: "DELETE" })).catch(() => {});
+  };
+  const dispatch = (current, event, payload) => {
+    if (event === "connected") {
+      current.id = payload.connection_id;
+      for (const [id, subscription] of subscriptions)
+        subscribe(current.id, id, subscription);
+      return;
+    }
+    const subscription = subscriptions.get(payload.subscription_id ?? "");
+    if (!subscription)
+      return;
+    if (event === "end" || event === "error")
+      release(payload.subscription_id, false);
+    if (event === "error")
+      subscription.onError(new Error(payload.data.message));
+    else
+      subscription.onEvent(event, payload.data);
+  };
+  const fail = (current, error) => {
+    if (connection !== current)
+      return;
+    connection = undefined;
+    const failed = [...subscriptions.values()];
+    subscriptions.clear();
+    for (const subscription of failed)
+      subscription.onError(error);
+  };
+  const open = () => {
+    const current = { controller: new AbortController };
+    const { signal } = current.controller;
+    connection = current;
+    const read = async () => {
+      const response = await resolveFetch(clientOptions)(resolveClientUrl(resolveBaseUrl(clientOptions), "/v1/session-stream"), { headers: Object.fromEntries(createRequestHeaders(clientOptions).entries()), signal });
+      if (!response.ok || !response.body)
+        throw new Error(`Connection failed: ${response.status}`);
+      await readSseStream(response.body, ({ event, data }) => dispatch(current, event, JSON.parse(data)), { signal });
+      throw new Error("Session stream closed");
+    };
+    read().catch((error) => {
+      if (!signal.aborted)
+        fail(current, error);
+    });
+    return current;
+  };
+  return {
+    subscribe(sessionId, listener) {
+      const id = crypto.randomUUID();
+      const subscription = { ...listener, sessionId };
+      subscriptions.set(id, subscription);
+      const current = connection ?? open();
+      if (current.id)
+        subscribe(current.id, id, subscription);
+      return {
+        close: () => {
+          if (subscriptions.get(id) === subscription)
+            release(id, true);
+        }
+      };
+    }
+  };
+};
+
 // src/client/sessions.ts
 var buildSessionsQuery = (projectId, input = {}) => {
   const params = new URLSearchParams({ project_id: projectId });
@@ -294,100 +402,87 @@ var buildSessionsQuery = (projectId, input = {}) => {
     params.append("archived", "true");
   return params.toString();
 };
-var buildSessionStreamPath = (sessionId, attempt) => {
-  const path = `/v1/sessions/${sessionId}/stream`;
-  return attempt === undefined ? path : `${path}?attempt=${attempt}`;
-};
-var parseEventData = (data) => {
-  if (data.length === 0)
-    return null;
-  return JSON.parse(data);
-};
-var streamSessionEvents = async (clientOptions, path, onEvent, options = {}) => {
-  const response = await resolveFetch(clientOptions)(resolveClientUrl(resolveBaseUrl(clientOptions), path), {
-    headers: Object.fromEntries(createRequestHeaders(clientOptions).entries()),
-    signal: options.signal
-  });
-  if (!response.ok || !response.body)
-    throw new Error(`Connection failed: ${response.status}`);
-  await readSseStream(response.body, onEvent, { signal: options.signal });
-};
-var dispatchSessionStreamEvent = (event, handlers) => {
-  if (event.event === "ready") {
-    handlers.onReady?.(parseEventData(event.data));
+var dispatchSessionStreamEvent = (event, data, handlers) => {
+  if (event === "ready") {
+    handlers.onReady?.(data);
     return;
   }
-  if (event.event === "patch") {
-    handlers.onPatch?.(parseEventData(event.data));
+  if (event === "patch") {
+    handlers.onPatch?.(data);
     return;
   }
-  if (event.event === "approval_request") {
-    handlers.onApprovalRequest?.(parseEventData(event.data));
+  if (event === "approval_request") {
+    handlers.onApprovalRequest?.(data);
     return;
   }
-  if (event.event === "queued_messages") {
-    handlers.onQueuedMessages?.(parseEventData(event.data));
+  if (event === "queued_messages") {
+    handlers.onQueuedMessages?.(data);
     return;
   }
-  if (event.event === "end") {
-    handlers.onEnd?.(parseEventData(event.data));
+  if (event === "end") {
+    handlers.onEnd?.(data);
   }
 };
-var createSessionClient = (request, clientOptions) => ({
-  listActivity: (sessionId, input = {}) => {
-    const params = new URLSearchParams;
-    if (input.event_type)
-      params.append("event_type", input.event_type);
-    if (input.from)
-      params.append("from", input.from);
-    if (input.to)
-      params.append("to", input.to);
-    if (input.cursor)
-      params.append("cursor", input.cursor);
-    if (input.limit !== undefined)
-      params.append("limit", String(input.limit));
-    const query = params.toString();
-    return request(`/v1/sessions/${sessionId}/activity${query ? `?${query}` : ""}`);
-  },
-  list: (projectId, input) => request(`/v1/sessions?${buildSessionsQuery(projectId, input)}`),
-  get: (sessionId) => request(`/v1/sessions/${sessionId}`),
-  uploadAttachment: (projectId, input) => request(`/v1/projects/${encodeURIComponent(projectId)}/session-attachments`, {
-    method: "POST",
-    body: input.data,
-    headers: {
-      "content-type": input.mimeType || "application/octet-stream",
-      "x-file-name": encodeURIComponent(input.name)
-    }
-  }),
-  deleteAttachment: (projectId, fileId) => request(`/v1/projects/${encodeURIComponent(projectId)}/session-attachments/${encodeURIComponent(fileId)}`, {
-    method: "DELETE"
-  }),
-  create: (input) => request("/v1/sessions", { method: "POST", body: input }),
-  archive: (sessionId) => request(`/v1/sessions/${sessionId}/archive`, { method: "POST" }),
-  followUp: (sessionId, input) => request(`/v1/sessions/${sessionId}/follow-up`, { method: "POST", body: input }),
-  approve: (sessionId, input) => request(`/v1/sessions/${sessionId}/approve`, { method: "POST", body: input }),
-  getConversation: (sessionId, signal) => request(`/v1/sessions/${sessionId}/conversation`, { signal }),
-  getConversationSources: (sessionId, signal) => request(`/v1/sessions/${sessionId}/conversation/sources`, { signal }),
-  getQueuedMessages: (sessionId, options) => request(`/v1/sessions/${sessionId}/queued-messages`, options),
-  resolveSessionId: (input) => request("/v1/sessions/resolve-session-id", { method: "POST", body: input }),
-  updateStatus: (sessionId, status) => request(`/v1/sessions/${sessionId}/status`, { method: "PATCH", body: { status } }),
-  stream: (sessionId, onEvent, options = {}) => streamSessionEvents(clientOptions, buildSessionStreamPath(sessionId), onEvent, options),
-  connectStream: (sessionId, handlers, options = {}) => {
-    const abortController = new AbortController;
-    let closed = false;
-    streamSessionEvents(clientOptions, buildSessionStreamPath(sessionId, options.attempt), (event) => dispatchSessionStreamEvent(event, handlers), { signal: abortController.signal }).catch((error) => {
-      if (closed || error.name === "AbortError")
-        return;
-      handlers.onError?.(error);
-    });
-    return {
-      close: () => {
-        closed = true;
-        abortController.abort();
+var createSessionClient = (request, clientOptions) => {
+  const streams = createSessionStreamTransport(request, clientOptions);
+  return {
+    listActivity: (sessionId, input = {}) => {
+      const params = new URLSearchParams;
+      if (input.event_type)
+        params.append("event_type", input.event_type);
+      if (input.from)
+        params.append("from", input.from);
+      if (input.to)
+        params.append("to", input.to);
+      if (input.cursor)
+        params.append("cursor", input.cursor);
+      if (input.limit !== undefined)
+        params.append("limit", String(input.limit));
+      const query = params.toString();
+      return request(`/v1/sessions/${sessionId}/activity${query ? `?${query}` : ""}`);
+    },
+    list: (projectId, input) => request(`/v1/sessions?${buildSessionsQuery(projectId, input)}`),
+    get: (sessionId) => request(`/v1/sessions/${sessionId}`),
+    uploadAttachment: (projectId, input) => request(`/v1/projects/${encodeURIComponent(projectId)}/session-attachments`, {
+      method: "POST",
+      body: input.data,
+      headers: {
+        "content-type": input.mimeType || "application/octet-stream",
+        "x-file-name": encodeURIComponent(input.name)
       }
-    };
-  }
-});
+    }),
+    deleteAttachment: (projectId, fileId) => request(`/v1/projects/${encodeURIComponent(projectId)}/session-attachments/${encodeURIComponent(fileId)}`, {
+      method: "DELETE"
+    }),
+    create: (input) => request("/v1/sessions", { method: "POST", body: input }),
+    archive: (sessionId) => request(`/v1/sessions/${sessionId}/archive`, { method: "POST" }),
+    followUp: (sessionId, input) => request(`/v1/sessions/${sessionId}/follow-up`, { method: "POST", body: input }),
+    approve: (sessionId, input) => request(`/v1/sessions/${sessionId}/approve`, { method: "POST", body: input }),
+    getConversation: (sessionId, signal) => request(`/v1/sessions/${sessionId}/conversation`, { signal }),
+    getConversationSources: (sessionId, signal) => request(`/v1/sessions/${sessionId}/conversation/sources`, { signal }),
+    getQueuedMessages: (sessionId, options) => request(`/v1/sessions/${sessionId}/queued-messages`, options),
+    resolveSessionId: (input) => request("/v1/sessions/resolve-session-id", { method: "POST", body: input }),
+    updateStatus: (sessionId, status) => request(`/v1/sessions/${sessionId}/status`, { method: "PATCH", body: { status } }),
+    stream: (sessionId, onEvent, options = {}) => new Promise((resolve, reject) => {
+      const subscription = streams.subscribe(sessionId, {
+        onEvent: (event, data) => {
+          onEvent({ event, data: JSON.stringify(data) });
+          if (event === "end")
+            resolve();
+        },
+        onError: reject
+      });
+      options.signal?.addEventListener("abort", () => {
+        subscription.close();
+        resolve();
+      }, { once: true });
+    }),
+    connectStream: (sessionId, handlers) => streams.subscribe(sessionId, {
+      onEvent: (event, data) => dispatchSessionStreamEvent(event, data, handlers),
+      onError: (error) => handlers.onError?.(error)
+    })
+  };
+};
 
 // src/client/settings.ts
 var createSettingsClient = (request) => ({
@@ -618,6 +713,7 @@ var createWorkspaceClient = (request) => ({
 var createClient = (options = {}) => {
   const request = createRequest(options);
   return {
+    views: createBoardViewsClient(request),
     projects: createProjectClient(request),
     filesystem: createFilesystemClient(request),
     workspaces: createWorkspaceClient(request),

package/dist/client.d.ts

@@ -1,3 +1,3 @@
-import { A as RequestFn, C as DirectoryEntry, D as AgentClient, E as AutomationClient, M as createRequest, O as ClientOptions, S as NotificationsClient, T as ExtensionClient, _ as SessionStreamHandlers, a as SyncClient, b as createRuntimeClient, c as SyncWriter, d as parseSyncDeleteEvent, f as SkillClient, g as SessionStreamConnection, h as SessionClient, i as StartSyncInput, j as RequestOptions, k as PstdioApiError, l as SyncWriterProvider, m as ListSessionsInput, n as createClient, o as SyncConnection, p as SettingsClient, r as WorkspaceClient, s as SyncRow, t as PstdioClient, u as applySyncEvent, v as SseEvent, w as FilesystemClient, x as ProjectClient, y as RuntimeClient } from "./index-DZSUI5-9.js";
-export { type AgentClient, type AutomationClient, type ClientOptions, type DirectoryEntry, type ExtensionClient, type FilesystemClient, type ListSessionsInput, type NotificationsClient, type ProjectClient, PstdioApiError, type PstdioClient, type RequestFn, type RequestOptions, type RuntimeClient, type SessionClient, type SessionStreamConnection, type SessionStreamHandlers, type SettingsClient, type SkillClient, type SseEvent, type StartSyncInput, type SyncClient, type SyncConnection, type SyncRow, type SyncWriter, type SyncWriterProvider, type WorkspaceClient, applySyncEvent, createClient, createRequest, createRuntimeClient, parseSyncDeleteEvent };
+import { A as PstdioApiError, C as DirectoryEntry, D as AutomationClient, E as BoardViewsClient, M as RequestOptions, N as createRequest, O as AgentClient, S as NotificationsClient, T as ExtensionClient, _ as SessionStreamHandlers, a as SyncClient, b as createRuntimeClient, c as SyncWriter, d as parseSyncDeleteEvent, f as SkillClient, g as SessionStreamConnection, h as SessionClient, i as StartSyncInput, j as RequestFn, k as ClientOptions, l as SyncWriterProvider, m as ListSessionsInput, n as createClient, o as SyncConnection, p as SettingsClient, r as WorkspaceClient, s as SyncRow, t as PstdioClient, u as applySyncEvent, v as SseEvent, w as FilesystemClient, x as ProjectClient, y as RuntimeClient } from "./index-CF8VtORE.js";
+export { type AgentClient, type AutomationClient, type BoardViewsClient, type ClientOptions, type DirectoryEntry, type ExtensionClient, type FilesystemClient, type ListSessionsInput, type NotificationsClient, type ProjectClient, PstdioApiError, type PstdioClient, type RequestFn, type RequestOptions, type RuntimeClient, type SessionClient, type SessionStreamConnection, type SessionStreamHandlers, type SettingsClient, type SkillClient, type SseEvent, type StartSyncInput, type SyncClient, type SyncConnection, type SyncRow, type SyncWriter, type SyncWriterProvider, type WorkspaceClient, applySyncEvent, createClient, createRequest, createRuntimeClient, parseSyncDeleteEvent };
 export {};

package/dist/data.d.ts

@@ -1,4 +1,4 @@
-import { Ir as ArtifactMount } from "./index-CnOTGr_I.js";
+import { Ti as ArtifactMount } from "./index-Dd4tqVV7.js";
 //#region src/data/draft-layout.d.ts
 export declare const assertSafePathSegment: (value: string) => void;
 export declare const requireRepoFiles: (projectFiles: ArtifactMount | undefined) => ArtifactMount;

package/dist/extensions/index.js

@@ -1,7 +1,6 @@
 // ../pstdio-api-contracts/src/extension-kernel/api-versions.ts
 var numericIdentifier = "(?:0|[1-9]\\d*)";
-var prereleaseIdentifier = `(?:${numericIdentifier}|\\d*[A-Za-z-][0-9A-Za-z-]*)`;
-var exactVersion = new RegExp(`^${numericIdentifier}\\.${numericIdentifier}\\.${numericIdentifier}(?:-${prereleaseIdentifier}(?:\\.${prereleaseIdentifier})*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$`);
+var caretTerm = new RegExp(`^\\^(${numericIdentifier}\\.${numericIdentifier}\\.${numericIdentifier})$`);
 // ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
 var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
 var extensionPanelRegions = ["main", "secondary", "side"];
@@ -271,7 +270,7 @@ var packageAsset = (path, baseUrl) => ({
   baseUrl
 });
 // ../pstdio-api-contracts/src/extension-kernel/types/extension.ts
-var EXTENSION_API_VERSION = "1.0.0-alpha.14";
+var EXTENSION_API_VERSION = "0.1.0";
 // ../pstdio-api-contracts/src/extension-kernel/types/webview-capabilities.ts
 var WEBVIEW_HOST_CAPABILITY_VERSION = 1;
 var WEBVIEW_DECLARABLE_CAPABILITIES = [
@@ -524,7 +523,7 @@ var reconcileMessageHistory = (input, projection = {}) => {
   }
 };
 // package.json
-var version = "0.37.0";
+var version = "0.39.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -830,6 +829,7 @@ var parsePageUrl = (input) => {
 };
 // src/extensions/params.ts
 var params = {
+  valueOf: (key) => ({ kind: "param-value", key }),
   text: (options) => ({ type: "text", ...options }),
   longText: (options) => ({ type: "longtext", ...options }),
   markdown: (options) => ({ type: "markdown", ...options }),
@@ -837,11 +837,9 @@ var params = {
   number: (options) => ({ type: "number", ...options }),
   boolean: (options) => ({ type: "boolean", ...options }),
   select: (options) => ({ type: "select", ...options }),
-  multiSelect: (options) => ({
-    type: "multi-select",
-    ...options
-  }),
+  multiSelect: (options) => ({ type: "multi-select", ...options }),
   harness: (options) => ({ type: "harness", ...options }),
+  workspace: (options) => ({ type: "workspace", ...options }),
   template: (options) => {
     const { type: templateType, ...rest } = options;
     return { type: "template", templateType, ...rest };