@pstdio/sdk 0.16.0 → 0.18.0

package/dist/client/client.d.ts

@@ -3,6 +3,7 @@ import { type ExtensionClient } from "./extensions";
 import { type NotificationsClient } from "./notifications";
 import { type ProjectClient } from "./projects";
 import type { ClientOptions } from "./request";
+import { type RuntimeClient } from "./runtime";
 import { type SessionClient } from "./sessions";
 import { type SettingsClient } from "./settings";
 import { type SkillClient } from "./skills";
@@ -20,5 +21,6 @@ export type PstdioClient = {
     extensions: ExtensionClient;
     settings: SettingsClient;
     sync: SyncClient;
+    runtime: RuntimeClient;
 };
 export declare const createClient: (options?: ClientOptions) => PstdioClient;

package/dist/client/extensions.d.ts

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

package/dist/client/index.d.ts

@@ -4,6 +4,7 @@ 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 { createRuntimeClient, type RuntimeClient } from "./runtime";
 export type { ListSessionsInput, SessionClient, SessionStreamConnection, SessionStreamHandlers } from "./sessions";
 export type { SettingsClient } from "./settings";
 export type { SkillClient } from "./skills";

package/dist/client/index.js

@@ -31,6 +31,7 @@ var createExtensionClient = (request) => ({
   }),
   listAppearance: (projectId) => request(`/v1/projects/${projectId}/extensions/appearance`),
   listCommands: (projectId) => request(`/v1/projects/${projectId}/extensions/commands`),
+  listProject: (projectId) => request(`/v1/projects/${projectId}/extensions`),
   execute: (commandId, input) => {
     const { projectId, ...body } = input;
     return request(`/v1/projects/${projectId}/extensions/commands/${encodeURIComponent(commandId)}/execute`, {
@@ -150,15 +151,27 @@ ${hookOutput}` : message;
   }
   return `Request failed: ${status}`;
 };
-var resolveBaseUrl = (options) => options.baseUrl ?? (typeof process !== "undefined" ? process.env.PSTDIO_API_URL : undefined) ?? "http://localhost:19840";
+var processEnvironment = () => typeof process !== "undefined" && process.env ? process.env : undefined;
+var resolveBaseUrl = (options) => options.baseUrl ?? processEnvironment()?.PSTDIO_API_URL ?? "http://127.0.0.1:19840";
 var resolveClientUrl = (baseUrl, path) => path.startsWith("http://") || path.startsWith("https://") ? path : `${baseUrl}${path}`;
+var isSameOriginTarget = (baseUrl, path, url) => {
+  if (!path.startsWith("http://") && !path.startsWith("https://"))
+    return true;
+  try {
+    return new URL(url).origin === new URL(baseUrl).origin;
+  } catch {
+    return false;
+  }
+};
 var resolveFetch = (options) => options.fetch ?? globalThis.fetch;
+var resolveToken = (options) => options.token ?? processEnvironment()?.PSTDIO_API_TOKEN;
 var createRequestHeaders = (options, reqOpts = {}) => {
   const headers = new Headers(reqOpts.headers);
   if (reqOpts.hasJsonBody && !headers.has("content-type"))
     headers.set("content-type", "application/json");
-  if (options.token)
-    headers.set("authorization", `Bearer ${options.token}`);
+  const token = resolveToken(options);
+  if (token)
+    headers.set("authorization", `Bearer ${token}`);
   return headers;
 };
 var isBinaryBody = (body) => body instanceof ArrayBuffer || ArrayBuffer.isView(body);
@@ -178,17 +191,20 @@ var createRequest = (options) => {
   const baseUrl = resolveBaseUrl(options);
   const fetchFn = resolveFetch(options);
   return async (path, reqOpts = {}) => {
+    const url = resolveClientUrl(baseUrl, path);
     const headers = createRequestHeaders(options, {
       headers: reqOpts.headers,
       hasJsonBody: reqOpts.body !== undefined && !isBinaryBody(reqOpts.body)
     });
-    const url = resolveClientUrl(baseUrl, path);
+    if (!isSameOriginTarget(baseUrl, path, url))
+      headers.delete("authorization");
     const response = await fetchFn(url, {
       method: reqOpts.method ?? "GET",
       headers: Object.fromEntries(headers.entries()),
       body: reqOpts.body !== undefined ? serializeRequestBody(reqOpts.body) : undefined,
       signal: reqOpts.signal,
-      cache: reqOpts.cache
+      cache: reqOpts.cache,
+      credentials: "same-origin"
     });
     if (!response.ok) {
       const errorBody = await response.json().catch(() => null);
@@ -201,6 +217,11 @@ var createRequest = (options) => {
   };
 };
 
+// src/client/runtime.ts
+var createRuntimeClient = (request) => ({
+  provisionBrowserSession: () => request("/runtime/browser-session", { method: "POST" })
+});
+
 // src/client/sse.ts
 var parseSseEvent = (part) => {
   let event = "message";
@@ -260,6 +281,8 @@ var buildSessionsQuery = (projectId, input = {}) => {
     params.append("status", input.status);
   if (input.agent)
     params.append("agent", input.agent);
+  if (input.workspaceId)
+    params.append("workspace_id", input.workspaceId);
   if (input.archived)
     params.append("archived", "true");
   return params.toString();
@@ -467,7 +490,8 @@ var createSyncClient = (clientOptions) => ({
       try {
         const response = await resolveFetch(clientOptions)(resolveClientUrl(resolveBaseUrl(clientOptions), buildSyncStreamPath(lastSeq)), {
           headers: Object.fromEntries(createRequestHeaders(clientOptions).entries()),
-          signal: abortController.signal
+          signal: abortController.signal,
+          credentials: "same-origin"
         });
         if (!response.ok || !response.body)
           throw new Error("SSE connection failed");
@@ -544,11 +568,13 @@ var createClient = (options = {}) => {
     notifications: createNotificationsClient(request),
     extensions: createExtensionClient(request),
     settings: createSettingsClient(request),
-    sync: createSyncClient(options)
+    sync: createSyncClient(options),
+    runtime: createRuntimeClient(request)
   };
 };
 export {
   parseSyncDeleteEvent,
+  createRuntimeClient,
   createRequest,
   createClient,
   applySyncEvent,

package/dist/client/runtime.d.ts

@@ -0,0 +1,5 @@
+import type { RequestFn } from "./request";
+export type RuntimeClient = {
+    provisionBrowserSession: () => Promise<void>;
+};
+export declare const createRuntimeClient: (request: RequestFn) => RuntimeClient;

package/dist/client/sessions.d.ts

@@ -5,6 +5,7 @@ import { type SseEvent } from "./sse";
 export type ListSessionsInput = {
     status?: string;
     agent?: string;
+    workspaceId?: string;
     archived?: boolean;
 };
 export type SessionClient = {

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

@@ -42,8 +42,7 @@ type ExtensionAuthoringDefinition<TCommandSchemas extends CommandSchemas, TMiddl
 };
 /**
  * Identity helper that types the passed contributions. Authors get autocomplete on
- * contributions, and `commandsOf(packageName, ext)` can derive typed refs from the
- * returned definition. Extension identity (id, name, version, description, publisher,
+ * contributions. Extension identity (id, name, version, description, publisher,
  * engines.pstdio) lives in package.json.
  *
  * @example

package/dist/extensions/index.d.ts

@@ -1,12 +1,12 @@
 export type { CreateNotificationInput, ListNotificationsQuery, ListNotificationsResponse, Notification, NotificationAction, NotificationActionResult, NotificationActorType, NotificationKind, NotificationOrigin, NotificationPriority, NotificationStatus, UpdateNotificationInput, } from "pstdio-api-contracts";
 export type * from "pstdio-api-contracts/extension-kernel";
 export type { CommitPayload, ConflictPayload, MergePayload, RebasePayload, SessionLifecyclePayload, WorkspaceProvisionPayload, WorkspaceType, WorktreeRemovedPayload, } from "pstdio-api-contracts/extension-kernel";
-export { ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES, EXTENSION_API_VERSION, getWorkbenchModeLayoutTargetPanel, getWorkbenchTargetDefinition, gitEvents, isLocalizedString, type Localizable, type LocalizedString, l10n, packageAsset, projectEvents, projectSlots, sessionEvents, sessionSlots, WEBVIEW_DECLARABLE_CAPABILITIES, WEBVIEW_HOST_CAPABILITIES, WEBVIEW_HOST_CAPABILITY_VERSION, type WorkbenchAttachmentTarget, type WorkbenchContributionKind, type WorkbenchLayoutTarget, type WorkbenchMenuTarget, type WorkbenchModeLayoutTarget, type WorkbenchModePanel, type WorkbenchSettingsScope, type WorkbenchSettingsTarget, type WorkbenchTargetDefinition, type WorkbenchTargetGranularity, type WorkbenchTreeTarget, type WorkbenchViewTarget, workbenchMenuTargets, workbenchModeLayoutTargets, workbenchModePanels, workbenchSettingsScopes, workbenchSettingsTargets, workbenchTargets, workbenchTreeTargets, workbenchViewTargets, workspaceEvents, workspaceSlots, worktreeEvents, } from "pstdio-api-contracts/extension-kernel";
+export { ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES, dockedWorkbenchRegions, EXTENSION_API_VERSION, getWorkbenchModeLayoutTargetPanel, getWorkbenchTargetDefinition, gitEvents, isLocalizedString, type Localizable, type LocalizedString, l10n, packageAsset, projectEvents, projectSlots, sessionEvents, sessionSlots, WEBVIEW_DECLARABLE_CAPABILITIES, WEBVIEW_HOST_CAPABILITIES, WEBVIEW_HOST_CAPABILITY_VERSION, type WorkbenchAttachmentTarget, type WorkbenchContributionKind, type WorkbenchLayoutTarget, type WorkbenchMenuTarget, type WorkbenchModeLayoutTarget, type WorkbenchModePanel, type WorkbenchSettingsScope, type WorkbenchSettingsTarget, type WorkbenchTargetDefinition, type WorkbenchTargetGranularity, type WorkbenchTreeTarget, type WorkbenchViewTarget, workbenchMenuTargets, workbenchModeLayoutTargets, workbenchModePanels, workbenchSettingsScopes, workbenchSettingsTargets, workbenchTargets, workbenchTreeTargets, workbenchViewTargets, workspaceEvents, workspaceSlots, worktreeEvents, } from "pstdio-api-contracts/extension-kernel";
 export { type CommandResponse, unwrapCommandOutcome } from "./command-outcome";
 export { defineCommand, defineHook, defineMiddleware } from "./define-command";
 export { defineExtension } from "./define-extension";
 export { defineExtensionView, type ExtensionViewModule, type ExtensionViewRender, type ExtensionViewRenderContext, type GuestHost, type PropsStore, type WebviewFilesClient, } from "./define-extension-view";
 export { params } from "./params";
-export { commandEvent, commandRef, commandsOf, eventRef } from "./refs";
+export { commandEvent, commandRef, eventRef } from "./refs";
 export { createTerminalSessionBridge, type TerminalSessionAdapter, type TerminalSessionBridge, type TerminalSessionExit, } from "./terminal-session-bridge";
 export { matchesResourceWhen } from "./when";

package/dist/extensions/index.js

@@ -82,8 +82,10 @@ var packageAsset = (path, baseUrl) => ({
   path,
   baseUrl
 });
+// ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
+var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
 // ../pstdio-api-contracts/src/extension-kernel/types/extension.ts
-var EXTENSION_API_VERSION = "1.0.0";
+var EXTENSION_API_VERSION = "1.0.0-alpha.2";
 // ../pstdio-api-contracts/src/extension-kernel/types/webview-capabilities.ts
 var WEBVIEW_HOST_CAPABILITY_VERSION = 1;
 var WEBVIEW_DECLARABLE_CAPABILITIES = [
@@ -303,14 +305,6 @@ var params = {
 var commandEvent = (command, phase) => ({
   id: `command.${phase}:${command.id}`
 });
-var commandsOf = (packageName, extension) => {
-  const refs = {};
-  const commands = extension.commands ?? {};
-  for (const key of Object.keys(commands)) {
-    refs[key] = { id: `${packageName}.${key}` };
-  }
-  return refs;
-};
 // src/extensions/terminal-session-bridge.ts
 var TERMINAL_SESSION_CAPABILITY = "terminal.session";
 var createTerminalSessionBridge = (host) => ({
@@ -416,13 +410,13 @@ export {
   getWorkbenchTargetDefinition,
   getWorkbenchModeLayoutTargetPanel,
   eventRef,
+  dockedWorkbenchRegions,
   defineMiddleware,
   defineHook,
   defineExtensionView,
   defineExtension,
   defineCommand,
   createTerminalSessionBridge,
-  commandsOf,
   commandRef,
   commandEvent,
   WEBVIEW_HOST_CAPABILITY_VERSION,

package/dist/extensions/refs.d.ts

@@ -1,4 +1,4 @@
-import type { CommandDefinition, CommandLifecycleEventPayload, CommandLifecyclePhase, CommandRef, EventRef, ParamObjectSchema, ParamsOf, Struct } from "pstdio-api-contracts/extension-kernel";
+import type { CommandLifecycleEventPayload, CommandLifecyclePhase, CommandRef, EventRef, Struct } from "pstdio-api-contracts/extension-kernel";
 export { commandRef, eventRef } from "pstdio-api-contracts/extension-kernel";
 /**
  * Build an `EventRef` for a command lifecycle phase (`requested`, `started`, `completed`,
@@ -6,23 +6,3 @@ export { commandRef, eventRef } from "pstdio-api-contracts/extension-kernel";
  * the correct shape.
  */
 export declare const commandEvent: <TPhase extends CommandLifecyclePhase, TParams extends Struct = Struct, TResult = unknown>(command: CommandRef<TParams, TResult>, phase: TPhase) => EventRef<CommandLifecycleEventPayload<TPhase, TParams, TResult>>;
-type CommandsRecord = Record<string, CommandDefinition<any, any, any>>;
-type CommandRefFromDefinition<TDefinition> = TDefinition extends CommandDefinition<infer TSchema, infer TResult, infer _TSettings> ? CommandRef<TSchema extends ParamObjectSchema ? ParamsOf<TSchema> : Struct, TResult> : never;
-type CommandsRefMap<TCommands extends CommandsRecord> = {
-    [K in keyof TCommands]: CommandRefFromDefinition<TCommands[K]>;
-};
-/**
- * Derive typed `CommandRef`s from an extension contribution object. Renaming a
- * command in the definition surfaces as a type error wherever the ref is used.
- *
- * The package name is explicit because identity now lives in package.json, not in
- * `defineExtension()`.
- *
- * @example
- *   const ext = defineExtension({ commands: { ... } });
- *   const labCommands = commandsOf("extension-lab", ext);
- *   labCommands.awaken; // CommandRef<{ title?: string }, ...>
- */
-export declare const commandsOf: <TExtension extends {
-    commands?: CommandsRecord;
-}>(packageName: string, extension: TExtension) => CommandsRefMap<NonNullable<TExtension["commands"]>>;