@pstdio/sdk 0.24.0 → 0.25.0

package/dist/api.d.ts

@@ -180,6 +180,7 @@ declare const commandExecuteResponseSchema: z.ZodObject<{
             rejected: "rejected";
         }>;
         value: z.ZodOptional<z.ZodUnknown>;
+        navigationRequests: z.ZodOptional<z.ZodArray<z.ZodType<NavigationTarget, unknown, z.core.$ZodTypeInternals<NavigationTarget, unknown>>>>;
         code: z.ZodOptional<z.ZodString>;
         reason: z.ZodOptional<z.ZodString>;
         data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/client/index.js

@@ -1,18 +1,3 @@
-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/client/agents.ts
 var createAgentClient = (request) => ({
   info: (params) => request(params?.project ? `/v1/agents/info?project=${encodeURIComponent(params.project)}` : "/v1/agents/info"),
@@ -270,7 +255,7 @@ var readSseStream = async (body, onEvent, options = {}) => {
   const decoder = new TextDecoder;
   let buffer = "";
   const abort = () => {
-    reader.cancel();
+    reader.cancel().catch(() => {});
   };
   options.signal?.addEventListener("abort", abort, { once: true });
   try {
@@ -634,10 +619,10 @@ var createClient = (options = {}) => {
   };
 };
 export {
-  parseSyncDeleteEvent,
-  createRuntimeClient,
-  createRequest,
-  createClient,
+  PstdioApiError,
   applySyncEvent,
-  PstdioApiError
+  createClient,
+  createRequest,
+  createRuntimeClient,
+  parseSyncDeleteEvent
 };

package/dist/client.d.ts

@@ -244,6 +244,7 @@ declare const commandExecuteResponseSchema: z.ZodObject<{
             rejected: "rejected";
         }>;
         value: z.ZodOptional<z.ZodUnknown>;
+        navigationRequests: z.ZodOptional<z.ZodArray<z.ZodType<NavigationTarget, unknown, z.core.$ZodTypeInternals<NavigationTarget, unknown>>>>;
         code: z.ZodOptional<z.ZodString>;
         reason: z.ZodOptional<z.ZodString>;
         data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/data/index.js

@@ -1,18 +1,3 @@
-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/data/draft-layout.ts
 var assertSafePathSegment = (value) => {
   if (!value || value === "." || value === ".." || /[/\\\0]/.test(value))
@@ -102,14 +87,14 @@ var resolveByIdOrName = (items, value, nameOf, label) => {
   throw new Error(`Unknown ${label} "${value}"`);
 };
 export {
-  unquoteYamlScalar,
-  stripFrontmatter,
-  sameName,
-  resolveByIdOrName,
-  requireRepoFiles,
-  quoteYamlScalar,
-  findClosingFrontmatterDelimiter,
-  createDraftLayout,
+  applyFrontmatter,
   assertSafePathSegment,
-  applyFrontmatter
+  createDraftLayout,
+  findClosingFrontmatterDelimiter,
+  quoteYamlScalar,
+  requireRepoFiles,
+  resolveByIdOrName,
+  sameName,
+  stripFrontmatter,
+  unquoteYamlScalar
 };

package/dist/data.d.ts

@@ -10,6 +10,8 @@ declare interface ArtifactMount {
     exists(path: string): Promise<boolean>;
     readText(path: string): Promise<string>;
     writeText(path: string, value: string): Promise<void>;
+    /** Replace existing text. Fails if missing and never recreates a concurrently deleted file. */
+    updateText(path: string, value: string): Promise<void>;
     readBytes(path: string): Promise<Uint8Array>;
     writeBytes(path: string, value: Uint8Array): Promise<void>;
     list(pattern?: string): Promise<ArtifactFile[]>;

package/dist/extensions/index.js

@@ -1,18 +1,3 @@
-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)
-    });
-};
-
 // ../pstdio-api-contracts/src/extension-kernel/types/composition.ts
 var dockedWorkbenchRegions = ["sidenav", "main", "secondary", "side"];
 var extensionPanelRegions = ["main", "secondary", "side"];
@@ -178,6 +163,98 @@ var l10n = (key, defaultValue) => ({
   ...defaultValue === undefined ? {} : { default: defaultValue }
 });
 var isLocalizedString = (value) => typeof value === "object" && value !== null && ("$l10n" in value) && typeof value.$l10n === "string";
+// ../pstdio-api-contracts/src/extension-kernel/navigation-href.ts
+var isNavigationHref = (href) => {
+  if (typeof href !== "string")
+    return false;
+  try {
+    const { protocol } = new URL(href);
+    return protocol === "https:" || protocol === "http:";
+  } catch {
+    return false;
+  }
+};
+
+// ../pstdio-api-contracts/src/extension-kernel/navigation.ts
+var isRecord = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+var isContributionRef = (value, kind) => isRecord(value) && value.kind === kind && typeof value.id === "string";
+var isResource = (value) => isRecord(value) && typeof value.type === "string" && typeof value.id === "string";
+var isOpenIntent = (value) => value === undefined || value === "preview" || value === "pin";
+var isPageTarget = (value, ancestors = new Set) => {
+  if (!isRecord(value) || value.kind !== "page" || !isContributionRef(value.page, "page"))
+    return false;
+  if (ancestors.has(value))
+    return false;
+  if (value.resource !== undefined && !isResource(value.resource))
+    return false;
+  if (value.section !== undefined && !isRecord(value.section))
+    return false;
+  if (!isOpenIntent(value.open))
+    return false;
+  if (value.parent === undefined)
+    return true;
+  const next = new Set(ancestors);
+  next.add(value);
+  return isPageTarget(value.parent, next);
+};
+var isPanelTarget = (value) => {
+  if (!isRecord(value) || value.kind !== "panel" || !isRecord(value.panel))
+    return false;
+  const panel = value.panel;
+  const validPanel = isContributionRef(panel, "placement") || panel.kind === "page-slot" && isContributionRef(panel.page, "page") && typeof panel.id === "string";
+  return validPanel && (value.resource === undefined || isResource(value.resource)) && isOpenIntent(value.open);
+};
+var isItemTarget = (value) => {
+  if (!isRecord(value))
+    return false;
+  if (value.kind === "page")
+    return isPageTarget(value);
+  if (value.kind === "panel")
+    return isPanelTarget(value);
+  if (value.kind === "href")
+    return isNavigationHref(value.href);
+  return value.kind === "command" && isRecord(value.target) && isContributionRef(value.target.command, "command") && (value.target.params === undefined || isRecord(value.target.params));
+};
+var isNavigationTarget = (value) => {
+  if (isItemTarget(value))
+    return true;
+  if (!isRecord(value) || value.kind !== "compound" || !Array.isArray(value.targets) || value.targets.length === 0) {
+    return false;
+  }
+  return value.targets.every((target) => isPageTarget(target) || isPanelTarget(target));
+};
+var withExtensionOwner = (ref, extensionId) => ref.extensionId !== undefined || extensionId === undefined ? ref : { ...ref, extensionId };
+var toPageTarget = (target, extensionId, projectId) => ({
+  ...target,
+  page: withExtensionOwner(target.page, extensionId),
+  ...target.resource ? { resource: qualifyResource(target.resource, extensionId, projectId) } : {},
+  ...target.parent ? { parent: toPageTarget(target.parent, extensionId, projectId) } : {}
+});
+var qualifyResource = (resource, extensionId, projectId) => ({
+  ...resource,
+  extensionId: resource.extensionId ?? extensionId,
+  projectId: resource.projectId ?? projectId
+});
+var qualifyNavigationTarget = (target, extensionId, projectId) => {
+  if (!isNavigationTarget(target))
+    throw new Error("Invalid navigation target.");
+  if (target.kind === "page")
+    return toPageTarget(target, extensionId, projectId);
+  if (target.kind === "panel")
+    return {
+      ...target,
+      panel: target.panel.kind === "page-slot" ? { ...target.panel, page: withExtensionOwner(target.panel.page, extensionId) } : withExtensionOwner(target.panel, extensionId),
+      ...target.resource ? { resource: qualifyResource(target.resource, extensionId, projectId) } : {}
+    };
+  if (target.kind === "command")
+    return { ...target, target: { ...target.target, command: withExtensionOwner(target.target.command, extensionId) } };
+  if (target.kind === "href")
+    return target;
+  return {
+    ...target,
+    targets: target.targets.map((item) => qualifyNavigationTarget(item, extensionId, projectId))
+  };
+};
 // ../pstdio-api-contracts/src/extension-kernel/package-asset.ts
 var packageAsset = (path, baseUrl) => ({
   kind: "package-asset",
@@ -215,7 +292,7 @@ var WEBVIEW_HOST_CAPABILITIES = [
   ...ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES
 ];
 // package.json
-var version = "0.24.0";
+var version = "0.25.0";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -414,11 +491,11 @@ var normalizedSection = (value) => {
   }
   return {
     anchors: anchors.map((anchor) => {
-      const value2 = anchor;
+      const value = anchor;
       return {
-        id: value2.id,
-        heading: value2.heading,
-        ...value2.occurrence !== undefined ? { occurrence: value2.occurrence } : {}
+        id: value.id,
+        heading: value.heading,
+        ...value.occurrence !== undefined ? { occurrence: value.occurrence } : {}
       };
     })
   };
@@ -652,10 +729,10 @@ var createWebviewClient = (host, options) => {
   if (!extensionId) {
     throw new Error("The host bridge did not provide an extension id. Pass { extensionId } to createWebviewClient.");
   }
-  const runCommand = async (commandKey, params2) => {
+  const runCommand = async (commandKey, params) => {
     const response = await host.call("commands.execute", {
       commandId: `${extensionId}.command.${commandKey}`,
-      params: params2
+      params
     });
     return unwrapCommandOutcome(response);
   };
@@ -663,7 +740,7 @@ var createWebviewClient = (host, options) => {
     get: (_target, commandKey) => {
       if (typeof commandKey !== "string")
         return;
-      return (params2) => runCommand(commandKey, params2);
+      return (params) => runCommand(commandKey, params);
     }
   });
   const settings = {
@@ -696,90 +773,92 @@ var matchesResourceWhen = (when, resourceType) => {
 // src/extensions/index.ts
 var projectPrefix = () => ({ $prefix: "project" });
 export {
-  worktreeEvents,
-  workspaceSlots,
-  workspaceEvents,
-  workbenchSlots,
-  workbenchResourceKinds,
-  workbenchResourceKindDefinitions,
-  workbenchPanels,
-  workbenchPanelDefinitions,
-  workbenchPages,
-  workbenchPageDefinitions,
-  workbenchModes,
-  workbenchModeDefinitions,
-  unwrapCommandOutcome,
-  sessionSlots,
-  sessionEvents,
-  serializeWorkbenchPageUrl,
-  serializePageUrl,
-  resourceMenuSlotRef2 as resourceMenuSlotRef,
-  resourceKey,
-  resolveEventReferenceId,
-  qualifyRef,
-  projectSlots,
-  projectPrefix,
-  projectEvents,
-  parseWorkbenchPageUrl,
-  parsePageUrl,
-  params,
-  packageAsset,
-  matchesResourceWhen,
-  localContributionIdPattern,
-  localContributionIdGrammar,
-  l10n,
-  isWorkbenchProjectUrl,
-  isValidLocalContributionId,
-  isLocalizedString,
-  gitEvents,
-  extensionPanelRegions,
-  eventRef,
-  dockedWorkbenchRegions,
-  defineWorkspaceType,
-  defineViewMenu,
-  defineView,
-  defineTheme,
-  defineTemplateType,
-  defineTemplate,
-  defineStatuses,
-  defineStatusBarItem,
-  defineSlot,
-  defineSkill,
-  defineSettingsSection,
-  defineSettingsPanel,
-  defineSchedule,
-  defineResourceKind,
-  defineResourceHierarchyProvider,
-  definePlacement,
-  definePage,
-  defineNavigationTree,
-  defineNavigationItem,
-  defineMode,
-  defineMiddleware,
-  defineKeybinding,
-  defineHook,
-  defineHarness,
-  defineFileIconTheme,
-  defineExtensionView,
-  defineExtension,
-  defineConnection,
-  defineCommandPaletteResource,
-  defineCommand,
-  defineArtifactMount,
-  defineActivityItem,
-  defaultPageResourceCodec,
-  createWebviewClient,
-  createTerminalSessionBridge,
-  commandRef,
-  commandEvent,
-  artifactsRead,
-  artifactMountId,
-  WEBVIEW_SCOPED_DECLARABLE_CAPABILITIES,
-  WEBVIEW_HOST_CAPABILITY_VERSION,
-  WEBVIEW_HOST_CAPABILITIES,
-  WEBVIEW_DECLARABLE_CAPABILITIES,
-  SDK_VERSION,
-  EXTENSION_EVENTS_SCOPE,
+  ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES,
   EXTENSION_API_VERSION,
-  ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES
+  EXTENSION_EVENTS_SCOPE,
+  SDK_VERSION,
+  WEBVIEW_DECLARABLE_CAPABILITIES,
+  WEBVIEW_HOST_CAPABILITIES,
+  WEBVIEW_HOST_CAPABILITY_VERSION,
+  WEBVIEW_SCOPED_DECLARABLE_CAPABILITIES,
+  artifactMountId,
+  artifactsRead,
+  commandEvent,
+  commandRef,
+  createTerminalSessionBridge,
+  createWebviewClient,
+  defaultPageResourceCodec,
+  defineActivityItem,
+  defineArtifactMount,
+  defineCommand,
+  defineCommandPaletteResource,
+  defineConnection,
+  defineExtension,
+  defineExtensionView,
+  defineFileIconTheme,
+  defineHarness,
+  defineHook,
+  defineKeybinding,
+  defineMiddleware,
+  defineMode,
+  defineNavigationItem,
+  defineNavigationTree,
+  definePage,
+  definePlacement,
+  defineResourceHierarchyProvider,
+  defineResourceKind,
+  defineSchedule,
+  defineSettingsPanel,
+  defineSettingsSection,
+  defineSkill,
+  defineSlot,
+  defineStatusBarItem,
+  defineStatuses,
+  defineTemplate,
+  defineTemplateType,
+  defineTheme,
+  defineView,
+  defineViewMenu,
+  defineWorkspaceType,
+  dockedWorkbenchRegions,
+  eventRef,
+  extensionPanelRegions,
+  gitEvents,
+  isLocalizedString,
+  isNavigationTarget,
+  isValidLocalContributionId,
+  isWorkbenchProjectUrl,
+  l10n,
+  localContributionIdGrammar,
+  localContributionIdPattern,
+  matchesResourceWhen,
+  packageAsset,
+  params,
+  parsePageUrl,
+  parseWorkbenchPageUrl,
+  projectEvents,
+  projectPrefix,
+  projectSlots,
+  qualifyNavigationTarget,
+  qualifyRef,
+  resolveEventReferenceId,
+  resourceKey,
+  resourceMenuSlotRef2 as resourceMenuSlotRef,
+  serializePageUrl,
+  serializeWorkbenchPageUrl,
+  sessionEvents,
+  sessionSlots,
+  unwrapCommandOutcome,
+  workbenchModeDefinitions,
+  workbenchModes,
+  workbenchPageDefinitions,
+  workbenchPages,
+  workbenchPanelDefinitions,
+  workbenchPanels,
+  workbenchResourceKindDefinitions,
+  workbenchResourceKinds,
+  workbenchSlots,
+  workspaceEvents,
+  workspaceSlots,
+  worktreeEvents
 };

package/dist/extensions/react/index.js

@@ -1,18 +1,3 @@
-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) => {
@@ -34,6 +19,6 @@ var useCommandMutation = (input) => {
   });
 };
 export {
-  useCommandQuery,
-  useCommandMutation
+  useCommandMutation,
+  useCommandQuery
 };

package/dist/extensions.d.ts

@@ -99,6 +99,8 @@ export declare interface ArtifactMount {
     exists(path: string): Promise<boolean>;
     readText(path: string): Promise<string>;
     writeText(path: string, value: string): Promise<void>;
+    /** Replace existing text. Fails if missing and never recreates a concurrently deleted file. */
+    updateText(path: string, value: string): Promise<void>;
     readBytes(path: string): Promise<Uint8Array>;
     writeBytes(path: string, value: Uint8Array): Promise<void>;
     list(pattern?: string): Promise<ArtifactFile[]>;
@@ -303,6 +305,7 @@ export declare type CommandOutcome<TResult = unknown> = {
     ok: true;
     status: "success";
     value: TResult;
+    navigationRequests?: NavigationTarget[];
     notices?: CommandNotice[];
     diagnostics?: CommandDiagnostic[];
 } | {
@@ -652,7 +655,7 @@ export declare interface DataTableRendererRowAction<TParams extends Struct = Str
 
 export declare type DataTableRendererRowActivationHandler = RendererCallback<{
     row: DataTableRendererRow;
-}, undefined | NavigationTarget>;
+}, void | NavigationTarget>;
 
 export declare interface DataTableRendererSelectionAction<TParams extends Struct = Struct> {
     id: string;
@@ -933,6 +936,10 @@ export declare interface ExtensionContextBase<TSettings extends Record<string, u
     source?: CommandSource;
     storage: ExtensionStorageApi;
     resources: ExtensionResourcesApi;
+    /** Records navigation for the invoking UI; headless execution opens nothing. */
+    navigation: {
+        open(target: NavigationTarget): void;
+    };
     artifacts: ExtensionArtifactApi;
     /** Working tree of the invocation's repo, scoped to its root. Absent for non-repo (event/hook) invocations. */
     repoFiles?: ArtifactMount;
@@ -1064,6 +1071,8 @@ export declare interface ExtensionReposApi {
 }
 
 export declare interface ExtensionResourcesApi {
+    /** Publish a committed removal to clients displaying this project resource. */
+    removed(resource: ResourceRef): Promise<void>;
     allocate(input: {
         kind: string;
     }): Promise<{
@@ -1173,6 +1182,8 @@ export declare interface ExtensionStorageCollectionApi<TItem = unknown> {
     get(id: string): Promise<TItem | undefined>;
     list(): Promise<TItem[]>;
     put(id: string, value: TItem): Promise<void>;
+    /** Replace an existing item atomically. Throws if the item was deleted. */
+    update(id: string, value: TItem): Promise<void>;
     createIfAbsent(id: string, value: TItem): Promise<boolean>;
     deleteIfValue(id: string, value: TItem): Promise<boolean>;
     create(value: TItem): Promise<TItem & {
@@ -1488,6 +1499,8 @@ export declare interface HookDefinition<TPayload extends Struct = Struct> extend
 
 export declare const isLocalizedString: (value: unknown) => value is LocalizedString;
 
+export declare const isNavigationTarget: (value: unknown) => value is NavigationTarget;
+
 export declare const isValidLocalContributionId: (id: string) => boolean;
 
 export declare const isWorkbenchProjectUrl: (urlValue: string, projectId: string) => boolean;
@@ -1646,7 +1659,7 @@ export declare interface KanbanRendererRowAction<TParams extends Struct = Struct
 
 export declare type KanbanRendererRowActivationHandler = RendererCallback<{
     row: KanbanRendererRow;
-}, undefined | NavigationTarget>;
+}, void | NavigationTarget>;
 
 export declare interface KanbanRendererSavedView {
     id: string;
@@ -2332,6 +2345,8 @@ export declare type QualifiedRef<Ref extends QualifiableRef> = Ref extends PageS
     readonly extensionId: string;
 };
 
+export declare const qualifyNavigationTarget: (target: NavigationTarget, extensionId: string, projectId?: string) => NavigationTarget;
+
 /** Publish a provider-owned reference without changing the local contribution definition. */
 export declare function qualifyRef<Ref extends QualifiableRef>(owner: string, ref: Ref): QualifiedRef<Ref>;
 
@@ -2552,6 +2567,11 @@ export declare interface ResourceRef {
 /** A reference the host can open (e.g. another resource tab). */
 export declare type ResourceRefValue = ResourceRef;
 
+export declare interface ResourceRemovedEvent {
+    id: string;
+    resource: ResourceRef;
+}
+
 export declare type ResourceRole = "primary" | "context" | "source" | "result";
 
 /** A reattach error is permanent unless the provider explicitly marks it retryable. */

package/dist/hooks.d.ts

@@ -242,6 +242,7 @@ declare const commandExecuteResponseSchema: z.ZodObject<{
             rejected: "rejected";
         }>;
         value: z.ZodOptional<z.ZodUnknown>;
+        navigationRequests: z.ZodOptional<z.ZodArray<z.ZodType<NavigationTarget, unknown, z.core.$ZodTypeInternals<NavigationTarget, unknown>>>>;
         code: z.ZodOptional<z.ZodString>;
         reason: z.ZodOptional<z.ZodString>;
         data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/prompts/index.js

@@ -1,18 +1,3 @@
-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/prompts/render-prompt.ts
 import Mustache from "mustache";
 var renderPrompt = (template, data) => Mustache.render(template, data);