@pstdio/sdk 0.18.0 → 0.20.0

package/dist/api/extensions.d.ts

@@ -1 +1 @@
-export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "pstdio-api-contracts";
+export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, InstallMarketplaceExtensionResponse, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, MarketplaceExtension, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, UpgradeProjectExtensionResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "pstdio-api-contracts";

package/dist/api/index.d.ts

@@ -1,5 +1,5 @@
 export type { CreateNotificationInput, ListNotificationsQuery, ListNotificationsResponse, Notification, NotificationAction, NotificationActionResult, NotificationActorType, NotificationKind, NotificationOrigin, NotificationPriority, NotificationStatus, ResourceRef, UpdateNotificationInput, } from "pstdio-api-contracts";
-export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "./extensions";
+export type { AttemptExtensionFixResponse, CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionControlsRendererRecord, ExtensionDataTableRendererRecord, ExtensionDiagnostic, ExtensionKanbanRendererRecord, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionPanelRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, InstallMarketplaceExtensionResponse, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, MarketplaceExtension, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, UpgradeProjectExtensionResponse, WorkbenchExtensionAutomationRecord, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionControlsRendererRecord, WorkbenchExtensionDataTableRendererRecord, WorkbenchExtensionHarnessRecord, WorkbenchExtensionKanbanRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionPanelRecord, WorkbenchExtensionTreeRendererRecord, WorkbenchExtensionViewRecord, } from "./extensions";
 export type { CreateProjectInput, RegisterRepoInput } from "./projects";
 export type { ApprovalInput, CreateSessionInput, FollowUpInput, ResolveSessionIdInput, ResolveSessionIdResponse, SessionAttachment, SessionAttachmentRef, SessionConversationResponse, } from "./sessions";
 export { sessionAttachmentMimeTypesByExtension } from "./sessions";
@@ -7,4 +7,4 @@ 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";
+export type { CreateWorkspaceInput, ListWorkspaceFilesInput, RemoveWorktreeResponse, RenameWorkspaceInput, WorkspaceFileContent, WorkspaceFileEntry, WorkspaceFilesResponse, WriteWorkspaceFileInput, } from "./workspaces";

package/dist/api/index.js

@@ -14168,6 +14168,8 @@ var extensionRendererRecordBaseSchema = exports_external.object({
   emptyDescription: localizableStringSchema.optional()
 });
 var extensionTreeRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  searchable: exports_external.boolean().optional(),
+  searchPlaceholder: localizableStringSchema.optional(),
   bodyHandlerId: exports_external.string(),
   childrenHandlerId: exports_external.string().optional(),
   footerHandlerId: exports_external.string().optional(),
@@ -14664,10 +14666,18 @@ var projectExtensionInstanceSchema = exports_external.object({
   lastError: jsonObjectSchema.nullable().optional(),
   enabled: exports_external.boolean(),
   config: exports_external.record(exports_external.string(), exports_external.unknown()),
+  canUpgrade: exports_external.boolean(),
   updateAvailable: exports_external.boolean()
 });
+var marketplaceExtensionSchema = exports_external.object({
+  installName: exports_external.string(),
+  displayName: exports_external.string(),
+  description: exports_external.string(),
+  installed: exports_external.boolean()
+});
 var listProjectExtensionsResponseSchema = exports_external.object({
-  extensions: exports_external.array(projectExtensionInstanceSchema)
+  extensions: exports_external.array(projectExtensionInstanceSchema),
+  marketplace: exports_external.array(marketplaceExtensionSchema)
 });
 var setProjectExtensionEnabledRequestSchema = exports_external.object({
   enabled: exports_external.boolean()
@@ -14679,6 +14689,13 @@ var attemptExtensionFixResponseSchema = exports_external.object({
   sessionId: exports_external.string(),
   title: exports_external.string()
 });
+var upgradeProjectExtensionResponseSchema = exports_external.object({
+  changed: exports_external.boolean(),
+  extension: projectExtensionInstanceSchema
+});
+var installMarketplaceExtensionResponseSchema = exports_external.object({
+  extension: projectExtensionInstanceSchema
+});
 var updateInstalledExtensionTemplateInputSchema = exports_external.object({
   content: exports_external.string().min(1)
 });
@@ -15110,6 +15127,41 @@ var renameWorkspaceInputSchema = exports_external.object({
 var removeWorktreeResponseSchema = exports_external.object({
   removed: exports_external.boolean()
 });
+var workspaceFileEntrySchema = exports_external.object({
+  path: exports_external.string(),
+  name: exports_external.string(),
+  type: exports_external.enum(["file", "directory"]),
+  size: exports_external.number().int().nonnegative().optional(),
+  modified_at: exports_external.string().optional()
+});
+var workspaceFilesResponseSchema = exports_external.object({
+  workspace_id: exports_external.string(),
+  path: exports_external.string(),
+  entries: exports_external.array(workspaceFileEntrySchema),
+  truncated: exports_external.boolean()
+});
+var workspaceFileContentSchema = exports_external.object({
+  workspace_id: exports_external.string(),
+  path: exports_external.string(),
+  file_name: exports_external.string(),
+  mime_type: exports_external.string().optional(),
+  size: exports_external.number().int().nonnegative(),
+  encoding: exports_external.enum(["utf8", "base64"]),
+  content: exports_external.string().optional(),
+  data_url: exports_external.string().optional(),
+  editable: exports_external.boolean()
+});
+var writeWorkspaceFileInputSchema = exports_external.object({
+  content: exports_external.string()
+});
+var moveWorkspaceEntryInputSchema = exports_external.object({
+  destination_path: exports_external.string().min(1)
+});
+var listWorkspaceFilesInputSchema = exports_external.object({
+  path: exports_external.string().optional(),
+  query: exports_external.string().optional(),
+  limit: exports_external.number().int().positive().max(500).optional()
+});
 export {
   sessionAttachmentMimeTypesByExtension
 };

package/dist/api/workspaces.d.ts

@@ -1,6 +1,12 @@
-import type { CreateWorkspaceInput as ContractCreateWorkspaceInput, ListWorkspaceActivityInput as ContractListWorkspaceActivityInput, ListWorkspaceActivityResponse as ContractListWorkspaceActivityResponse, RemoveWorktreeResponse as ContractRemoveWorktreeResponse, RenameWorkspaceInput as ContractRenameWorkspaceInput } from "pstdio-api-contracts";
+import type { CreateWorkspaceInput as ContractCreateWorkspaceInput, ListWorkspaceActivityInput as ContractListWorkspaceActivityInput, ListWorkspaceActivityResponse as ContractListWorkspaceActivityResponse, ListWorkspaceFilesInput as ContractListWorkspaceFilesInput, MoveWorkspaceEntryInput as ContractMoveWorkspaceEntryInput, RemoveWorktreeResponse as ContractRemoveWorktreeResponse, RenameWorkspaceInput as ContractRenameWorkspaceInput, WorkspaceFileContent as ContractWorkspaceFileContent, WorkspaceFileEntry as ContractWorkspaceFileEntry, WorkspaceFilesResponse as ContractWorkspaceFilesResponse, WriteWorkspaceFileInput as ContractWriteWorkspaceFileInput } from "pstdio-api-contracts";
 export type CreateWorkspaceInput = ContractCreateWorkspaceInput;
 export type ListWorkspaceActivityInput = ContractListWorkspaceActivityInput;
 export type ListWorkspaceActivityResponse = ContractListWorkspaceActivityResponse;
 export type RemoveWorktreeResponse = ContractRemoveWorktreeResponse;
 export type RenameWorkspaceInput = ContractRenameWorkspaceInput;
+export type ListWorkspaceFilesInput = ContractListWorkspaceFilesInput;
+export type MoveWorkspaceEntryInput = ContractMoveWorkspaceEntryInput;
+export type WorkspaceFileContent = ContractWorkspaceFileContent;
+export type WorkspaceFileEntry = ContractWorkspaceFileEntry;
+export type WorkspaceFilesResponse = ContractWorkspaceFilesResponse;
+export type WriteWorkspaceFileInput = ContractWriteWorkspaceFileInput;

package/dist/client/index.js

@@ -532,6 +532,55 @@ var createTemplateClient = (request) => ({
 
 // src/client/workspaces.ts
 var createWorkspaceClient = (request) => ({
+  listFiles: (workspaceId, input = {}) => {
+    const params = new URLSearchParams;
+    if (input.path !== undefined)
+      params.append("path", input.path);
+    if (input.query !== undefined)
+      params.append("query", input.query);
+    if (input.limit !== undefined)
+      params.append("limit", String(input.limit));
+    const query = params.toString();
+    return request(`/v1/workspaces/${encodeURIComponent(workspaceId)}/files${query ? `?${query}` : ""}`);
+  },
+  readFile: (workspaceId, path) => {
+    const params = new URLSearchParams({ path });
+    return request(`/v1/workspaces/${encodeURIComponent(workspaceId)}/file?${params.toString()}`);
+  },
+  createDirectory: (workspaceId, path) => {
+    const params = new URLSearchParams({ path });
+    return request(`/v1/workspaces/${encodeURIComponent(workspaceId)}/directory?${params.toString()}`, {
+      method: "POST"
+    });
+  },
+  createFile: (workspaceId, path, input) => {
+    const params = new URLSearchParams({ path });
+    return request(`/v1/workspaces/${encodeURIComponent(workspaceId)}/file?${params.toString()}`, {
+      method: "POST",
+      body: input
+    });
+  },
+  writeFile: (workspaceId, path, input) => {
+    const params = new URLSearchParams({ path });
+    return request(`/v1/workspaces/${encodeURIComponent(workspaceId)}/file?${params.toString()}`, {
+      method: "PUT",
+      body: input
+    });
+  },
+  moveEntry: (workspaceId, path, destinationPath) => {
+    const params = new URLSearchParams({ path });
+    const body = { destination_path: destinationPath };
+    return request(`/v1/workspaces/${encodeURIComponent(workspaceId)}/entry?${params.toString()}`, {
+      method: "PATCH",
+      body
+    });
+  },
+  deleteEntry: (workspaceId, path) => {
+    const params = new URLSearchParams({ path });
+    return request(`/v1/workspaces/${encodeURIComponent(workspaceId)}/entry?${params.toString()}`, {
+      method: "DELETE"
+    });
+  },
   listActivity: (workspaceId, input = {}) => {
     const params = new URLSearchParams;
     if (input.event_type)

package/dist/client/workspaces.d.ts

@@ -1,4 +1,4 @@
-import type { CreateWorkspaceInput, ListWorkspaceActivityInput, ListWorkspaceActivityResponse, RemoveWorktreeResponse, RenameWorkspaceInput } from "pstdio-api-contracts";
+import type { CreateWorkspaceInput, ListWorkspaceActivityInput, ListWorkspaceActivityResponse, ListWorkspaceFilesInput, RemoveWorktreeResponse, RenameWorkspaceInput, WorkspaceFileContent, WorkspaceFileEntry, WorkspaceFilesResponse, WriteWorkspaceFileInput } from "pstdio-api-contracts";
 import type { Workspace, WorkspaceListItem } from "../resources";
 import type { RequestFn } from "./request";
 export type WorkspaceClient = {
@@ -7,6 +7,13 @@ export type WorkspaceClient = {
     create(input: CreateWorkspaceInput): Promise<Workspace>;
     rename(workspaceId: string, input: RenameWorkspaceInput): Promise<Workspace>;
     listActivity(workspaceId: string, input?: ListWorkspaceActivityInput): Promise<ListWorkspaceActivityResponse>;
+    listFiles(workspaceId: string, input?: ListWorkspaceFilesInput): Promise<WorkspaceFilesResponse>;
+    createDirectory(workspaceId: string, path: string): Promise<WorkspaceFileEntry>;
+    createFile(workspaceId: string, path: string, input: WriteWorkspaceFileInput): Promise<WorkspaceFileContent>;
+    readFile(workspaceId: string, path: string): Promise<WorkspaceFileContent>;
+    writeFile(workspaceId: string, path: string, input: WriteWorkspaceFileInput): Promise<WorkspaceFileContent>;
+    moveEntry(workspaceId: string, path: string, destinationPath: string): Promise<void>;
+    deleteEntry(workspaceId: string, path: string): Promise<void>;
     removeWorktree(workspaceId: string): Promise<RemoveWorktreeResponse>;
     delete(workspaceId: string): Promise<void>;
 };

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

@@ -12,6 +12,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;
+    /** Id of the extension that owns this webview. Missing only on hosts older than the bridge that sends it. */
+    extensionId?: string;
 };
 export type PropsStore<TProps = unknown> = {
     get: () => TProps;

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

@@ -17,7 +17,7 @@ type SettingValue<TProperty> = TProperty extends {
 } ? unknown[] : TProperty extends {
     type: "object";
 } ? Record<string, unknown> : unknown;
-type SettingsMap<TSettings> = TSettings extends {
+export type SettingsMap<TSettings> = TSettings extends {
     properties: infer TProperties;
 } ? {
     [K in keyof TProperties & string]: SettingValue<TProperties[K]>;

package/dist/extensions/index.d.ts

@@ -9,4 +9,5 @@ export { defineExtensionView, type ExtensionViewModule, type ExtensionViewRender
 export { params } from "./params";
 export { commandEvent, commandRef, eventRef } from "./refs";
 export { createTerminalSessionBridge, type TerminalSessionAdapter, type TerminalSessionBridge, type TerminalSessionExit, } from "./terminal-session-bridge";
+export { createWebviewClient, type WebviewClient, type WebviewClientOptions, type WebviewCommandsClient, type WebviewSettingsClient, } from "./webview-client";
 export { matchesResourceWhen } from "./when";

package/dist/extensions/index.js

@@ -377,6 +377,35 @@ var createTerminalSessionBridge = (host) => ({
     };
   }
 });
+// src/extensions/webview-client.ts
+var createWebviewClient = (host, options) => {
+  const extensionId = options?.extensionId ?? host.extensionId;
+  if (!extensionId) {
+    throw new Error("The host bridge did not provide an extension id. Pass { extensionId } to createWebviewClient.");
+  }
+  const runCommand = async (commandKey, params2) => {
+    const response = await host.call("commands.execute", {
+      commandId: `${extensionId}.${commandKey}`,
+      params: params2
+    });
+    return unwrapCommandOutcome(response);
+  };
+  const commands = new Proxy({}, {
+    get: (_target, commandKey) => {
+      if (typeof commandKey !== "string")
+        return;
+      return (params2) => runCommand(commandKey, params2);
+    }
+  });
+  const settings = {
+    all: async () => await host.call("extension.settings.all", {}) ?? {},
+    get: (key) => host.call("extension.settings.get", { key }),
+    set: async (key, value) => {
+      await host.call("extension.settings.set", { key, value });
+    }
+  };
+  return { commands, settings };
+};
 // src/extensions/when.ts
 var matchesResourceWhen = (when, resourceType) => {
   const resourceTypes = when?.resourceType;
@@ -416,6 +445,7 @@ export {
   defineExtensionView,
   defineExtension,
   defineCommand,
+  createWebviewClient,
   createTerminalSessionBridge,
   commandRef,
   commandEvent,

package/dist/extensions/react/index.d.ts

@@ -0,0 +1,16 @@
+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 {};

package/dist/extensions/react/index.js

@@ -0,0 +1,38 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/extensions/react/index.ts
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+var useCommandQuery = (input) => {
+  const { command, enabled, queryKey, staleTime } = input;
+  return useQuery({
+    queryKey,
+    enabled,
+    staleTime,
+    queryFn: () => command()
+  });
+};
+var useCommandMutation = (input) => {
+  const { command, invalidate } = input;
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (params) => command(params),
+    onSuccess: () => invalidate?.forEach((queryKey) => void queryClient.invalidateQueries({ queryKey }))
+  });
+};
+export {
+  useCommandQuery,
+  useCommandMutation
+};

package/dist/extensions/webview-client.d.ts

@@ -0,0 +1,41 @@
+import type { CommandDefinition, ParamObjectSchema, ParamsOf } from "pstdio-api-contracts/extension-kernel";
+import type { SettingsMap } from "./define-extension";
+import type { GuestHost } from "./define-extension-view";
+type CommandFn<TDefinition> = TDefinition extends CommandDefinition<infer TSchema, infer TResult, infer _TSettings> ? TSchema extends ParamObjectSchema ? Partial<ParamsOf<TSchema>> extends ParamsOf<TSchema> ? (params?: ParamsOf<TSchema>) => Promise<TResult> : (params: ParamsOf<TSchema>) => Promise<TResult> : () => Promise<TResult> : never;
+export type WebviewCommandsClient<TCommands> = {
+    [K in keyof TCommands & string]: CommandFn<TCommands[K]>;
+};
+export type WebviewSettingsClient<TSettings> = {
+    all: () => Promise<Partial<TSettings>>;
+    get: <K extends keyof TSettings & string>(key: K) => Promise<TSettings[K] | undefined>;
+    set: <K extends keyof TSettings & string>(key: K, value: TSettings[K]) => Promise<void>;
+};
+type ClientSettingsMap<TSettings> = TSettings extends {
+    properties: unknown;
+} ? SettingsMap<TSettings> : Record<never, never>;
+export type WebviewClient<TCommands, TSettings = undefined> = {
+    commands: WebviewCommandsClient<TCommands>;
+    settings: WebviewSettingsClient<ClientSettingsMap<TSettings>>;
+};
+export interface WebviewClientOptions {
+    /** Overrides the extension id provided by the host bridge (e.g. in tests). */
+    extensionId?: string;
+}
+/**
+ * Typed guest-side client over the host bridge. Command params and results come from
+ * the extension's exported commands record (`defineCommand` values); settings come
+ * from its exported settings contribution. Command outcomes are unwrapped, so
+ * failures throw.
+ *
+ * Import both as types only, so no server code enters the webview bundle:
+ *
+ * @example
+ *   import type { commands } from "../commands";
+ *   import type { settings } from "../settings";
+ *
+ *   const client = createWebviewClient<typeof commands, typeof settings>(host);
+ *   const { statuses } = await client.commands["ticketStatus.read"]();
+ *   const enabled = await client.settings.get("counter.enabled");
+ */
+export declare const createWebviewClient: <TCommands extends object, TSettings = undefined>(host: GuestHost, options?: WebviewClientOptions) => WebviewClient<TCommands, TSettings>;
+export {};

package/dist/resources/index.js

@@ -14168,6 +14168,8 @@ var extensionRendererRecordBaseSchema = exports_external.object({
   emptyDescription: localizableStringSchema.optional()
 });
 var extensionTreeRendererRecordSchema = extensionRendererRecordBaseSchema.extend({
+  searchable: exports_external.boolean().optional(),
+  searchPlaceholder: localizableStringSchema.optional(),
   bodyHandlerId: exports_external.string(),
   childrenHandlerId: exports_external.string().optional(),
   footerHandlerId: exports_external.string().optional(),
@@ -14664,10 +14666,18 @@ var projectExtensionInstanceSchema = exports_external.object({
   lastError: jsonObjectSchema.nullable().optional(),
   enabled: exports_external.boolean(),
   config: exports_external.record(exports_external.string(), exports_external.unknown()),
+  canUpgrade: exports_external.boolean(),
   updateAvailable: exports_external.boolean()
 });
+var marketplaceExtensionSchema = exports_external.object({
+  installName: exports_external.string(),
+  displayName: exports_external.string(),
+  description: exports_external.string(),
+  installed: exports_external.boolean()
+});
 var listProjectExtensionsResponseSchema = exports_external.object({
-  extensions: exports_external.array(projectExtensionInstanceSchema)
+  extensions: exports_external.array(projectExtensionInstanceSchema),
+  marketplace: exports_external.array(marketplaceExtensionSchema)
 });
 var setProjectExtensionEnabledRequestSchema = exports_external.object({
   enabled: exports_external.boolean()
@@ -14679,6 +14689,13 @@ var attemptExtensionFixResponseSchema = exports_external.object({
   sessionId: exports_external.string(),
   title: exports_external.string()
 });
+var upgradeProjectExtensionResponseSchema = exports_external.object({
+  changed: exports_external.boolean(),
+  extension: projectExtensionInstanceSchema
+});
+var installMarketplaceExtensionResponseSchema = exports_external.object({
+  extension: projectExtensionInstanceSchema
+});
 var updateInstalledExtensionTemplateInputSchema = exports_external.object({
   content: exports_external.string().min(1)
 });
@@ -15110,6 +15127,41 @@ var renameWorkspaceInputSchema = exports_external.object({
 var removeWorktreeResponseSchema = exports_external.object({
   removed: exports_external.boolean()
 });
+var workspaceFileEntrySchema = exports_external.object({
+  path: exports_external.string(),
+  name: exports_external.string(),
+  type: exports_external.enum(["file", "directory"]),
+  size: exports_external.number().int().nonnegative().optional(),
+  modified_at: exports_external.string().optional()
+});
+var workspaceFilesResponseSchema = exports_external.object({
+  workspace_id: exports_external.string(),
+  path: exports_external.string(),
+  entries: exports_external.array(workspaceFileEntrySchema),
+  truncated: exports_external.boolean()
+});
+var workspaceFileContentSchema = exports_external.object({
+  workspace_id: exports_external.string(),
+  path: exports_external.string(),
+  file_name: exports_external.string(),
+  mime_type: exports_external.string().optional(),
+  size: exports_external.number().int().nonnegative(),
+  encoding: exports_external.enum(["utf8", "base64"]),
+  content: exports_external.string().optional(),
+  data_url: exports_external.string().optional(),
+  editable: exports_external.boolean()
+});
+var writeWorkspaceFileInputSchema = exports_external.object({
+  content: exports_external.string()
+});
+var moveWorkspaceEntryInputSchema = exports_external.object({
+  destination_path: exports_external.string().min(1)
+});
+var listWorkspaceFilesInputSchema = exports_external.object({
+  path: exports_external.string().optional(),
+  query: exports_external.string().optional(),
+  limit: exports_external.number().int().positive().max(500).optional()
+});
 export {
   harnessLocalId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pstdio/sdk",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/pufflyai/prompt-studio"
@@ -29,6 +29,10 @@
       "types": "./dist/extensions/index.d.ts",
       "import": "./dist/extensions/index.js"
     },
+    "./extensions/react": {
+      "types": "./dist/extensions/react/index.d.ts",
+      "import": "./dist/extensions/react/index.js"
+    },
     "./prompts": {
       "types": "./dist/prompts/index.d.ts",
       "import": "./dist/prompts/index.js"
@@ -40,7 +44,7 @@
   },
   "scripts": {
     "build": "rm -rf ./dist && bun run build:js && bun run build:types",
-    "build:js": "bun build ./src/api/index.ts ./src/client/index.ts ./src/extensions/index.ts ./src/prompts/index.ts ./src/hooks/index.ts ./src/resources/index.ts --outdir ./dist --root ./src --target node --format esm --external mustache",
+    "build:js": "bun build ./src/api/index.ts ./src/client/index.ts ./src/extensions/index.ts ./src/extensions/react/index.ts ./src/prompts/index.ts ./src/hooks/index.ts ./src/resources/index.ts --outdir ./dist --root ./src --target node --format esm --external mustache --external react --external @tanstack/react-query",
     "build:types": "tsc --project ./tsconfig.build.json",
     "prepack": "bun run build",
     "typecheck": "tsc --noEmit",
@@ -52,10 +56,25 @@
   "dependencies": {
     "mustache": "^4.2.0"
   },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@types/bun": "latest",
+    "@tanstack/react-query": "^5.90.21",
+    "@types/bun": "1.3.13",
     "@types/mustache": "^4.2.6",
+    "@types/react": "^19.2.0",
     "pstdio-api-contracts": "workspace:*",
+    "react": "^19.0.0",
     "typescript": "6.0.2"
   }
 }