@pstdio/sdk 0.10.0 → 0.11.0

package/dist/extensions/types/contributions.d.ts

@@ -1,14 +1,16 @@
+import type { Localizable } from "../l10n";
 import type { WorkbenchMenuTarget, WorkbenchModeLayoutTarget, WorkbenchSettingsScope, WorkbenchSettingsTarget, WorkbenchTreeTarget, WorkbenchViewTarget } from "../workbench-targets";
 import type { CommandRef, CommandSource } from "./commands";
+import type { EventRef } from "./events";
 import type { JsonObject, JsonValue, Struct } from "./json";
 import type { ParamObjectSchema } from "./params";
-import type { PackageAssetDescriptor } from "./resources";
+import type { PackageAssetDescriptor, ResourceRef } from "./resources";
 import type { SlotRef } from "./slots";
 import type { WebviewCapabilityDeclaration } from "./webview-capabilities";
 export interface CliContribution {
     path?: string[];
     globalAliases?: string[][];
-    description?: string;
+    description?: Localizable<string>;
     examples?: string[];
     hidden?: boolean;
 }
@@ -21,7 +23,7 @@ export interface WhenExpression {
 export interface MenuContribution<TSlotContext extends Struct = Struct, TParams extends Struct = Struct> {
     target?: WorkbenchMenuTarget;
     slot?: SlotRef<TSlotContext, "menu"> | string;
-    label?: string;
+    label?: Localizable<string>;
     group?: string;
     placement?: "first" | "default" | "last";
     icon?: string;
@@ -30,9 +32,17 @@ export interface MenuContribution<TSlotContext extends Struct = Struct, TParams
     params?: Partial<TParams>;
     presentation?: "menu-item" | "button" | "icon-button";
 }
+export interface CommandPaletteContribution<TParams extends Struct = Struct> {
+    label?: Localizable<string>;
+    group?: string;
+    placement?: "first" | "default" | "last";
+    icon?: string;
+    when?: WhenExpression;
+    params?: Partial<TParams>;
+}
 export interface TreeItemContribution<TParams extends Struct = Struct> {
     target: WorkbenchTreeTarget;
-    label: string;
+    label: Localizable<string>;
     group?: string;
     placement?: "first" | "default" | "last";
     icon?: string;
@@ -56,14 +66,14 @@ export type WorkbenchLayoutTarget = WorkbenchModeLayoutTarget;
 export type ModeTargetContribution = {
     target: WorkbenchLayoutTarget;
     view: string;
-    title?: string;
+    title?: Localizable<string>;
     resource?: string;
     pinned?: boolean;
 } | {
     target: WorkbenchLayoutTarget;
     resource: string;
     widget?: string;
-    title?: string;
+    title?: Localizable<string>;
     pinned?: boolean;
 };
 export interface ModeLayoutContribution {
@@ -72,30 +82,49 @@ export interface ModeLayoutContribution {
 }
 export interface ModeContribution {
     id?: string;
-    label: string;
+    label: Localizable<string>;
     icon?: string;
     layout?: ModeLayoutContribution;
 }
 export interface WebviewContribution {
     entry: PackageAssetDescriptor;
-    title?: string;
+    title?: Localizable<string>;
     capabilities?: WebviewCapabilityDeclaration[];
 }
-export interface ViewContribution<TSlotContext extends Struct = Struct> {
-    title: string;
+export interface ViewContributionBase<TSlotContext extends Struct = Struct> {
+    title: Localizable<string>;
     target?: WorkbenchViewTarget;
     slot?: SlotRef<TSlotContext, "view"> | string;
     group?: string;
     placement?: "first" | "default" | "last";
-    webview: WebviewContribution;
+    /**
+     * Marks this view as the editor for resources of the given kind. The host opens
+     * the view's webview as a widget (bound to the resource) whenever a resource of
+     * this kind is opened — e.g. a `ticket` data-renderer row opening the editor.
+     */
+    resourceKind?: string;
+    /**
+     * Where the host mounts the view. `panel` (default) docks it in a workbench area;
+     * `modal` mounts it as an overlay dialog — used by data-renderer create flows where
+     * a row's create button opens the matching `resourceKind` modal instead of the
+     * inline create command.
+     */
+    surface?: "panel" | "modal";
 }
+export type ViewContribution<TSlotContext extends Struct = Struct> = ViewContributionBase<TSlotContext> & ({
+    webview: WebviewContribution;
+    treeRenderer?: never;
+} | {
+    treeRenderer: string;
+    webview?: never;
+});
 export interface RouteContribution {
     path: string;
-    label: string;
+    label: Localizable<string>;
     webview: WebviewContribution;
 }
 export interface SettingsPanelContribution<TSlotContext extends Struct = Struct> {
-    title: string;
+    title: Localizable<string>;
     target?: WorkbenchSettingsTarget;
     scope?: WorkbenchSettingsScope;
     slot?: SlotRef<TSlotContext, "settings"> | string;
@@ -105,7 +134,7 @@ export type DataRendererViewMode = "board" | "list";
 export type DataRendererSortDirection = "asc" | "desc";
 export interface DataRendererEnumOption {
     value: string;
-    label: string;
+    label: Localizable<string>;
     color?: string;
     icon?: string | null;
 }
@@ -126,7 +155,7 @@ export type DataRendererAttributeType = {
 };
 export interface DataRendererAttributeDescriptor {
     id: string;
-    label: string;
+    label: Localizable<string>;
     type: DataRendererAttributeType;
     filterable?: boolean;
     groupable?: boolean;
@@ -165,7 +194,7 @@ export interface DataRendererRow {
 }
 export interface DataRendererColumnAction {
     id: string;
-    label: string;
+    label: Localizable<string>;
     icon?: string;
 }
 export interface DataRendererBoardColumnConfig {
@@ -182,8 +211,8 @@ export interface DataRendererQueryResult {
 }
 export interface DataRendererCreateRowContribution<TParams extends ParamObjectSchema = ParamObjectSchema> {
     command: CommandRef<Struct, unknown> | string;
-    title?: string;
-    submitLabel?: string;
+    title?: Localizable<string>;
+    submitLabel?: Localizable<string>;
     columnParam?: string;
     params?: TParams;
 }
@@ -191,8 +220,16 @@ export interface DataRendererSavedViewsContribution {
     resourceKind: string;
     scope?: "project" | "user";
 }
+export interface DataRendererRowAction<TParams extends Struct = Struct> {
+    id: string;
+    label: Localizable<string>;
+    icon?: string;
+    /** Invoked with `{ rowId }` when the row's context-menu action is chosen. */
+    command: CommandRef<TParams, unknown> | string;
+    destructive?: boolean;
+}
 export interface DataRendererContribution {
-    title: string;
+    title: Localizable<string>;
     resourceKind?: string;
     attributes?: DataRendererAttributeDescriptor[];
     queryCommand: CommandRef<DataRendererQueryParams, DataRendererQueryResult> | string;
@@ -210,13 +247,53 @@ export interface DataRendererContribution {
         actionId: string;
     }, unknown> | string;
     createRow?: DataRendererCreateRowContribution;
+    rowActions?: DataRendererRowAction[];
     defaultSettings?: Partial<DataRendererSettings>;
     defaultFilters?: DataRendererFilterState;
-    emptyTitle?: string;
-    emptyDescription?: string;
+    emptyTitle?: Localizable<string>;
+    emptyDescription?: Localizable<string>;
     hideToolbar?: boolean;
     savedViews?: DataRendererSavedViewsContribution;
 }
+/**
+ * Command palette resource providers contribute dynamic, searchable palette results
+ * (e.g. slides in a presentation) backed by an extension `queryCommand`, instead of
+ * static command entries generated at module load. The host queries matching providers
+ * as the user types and refreshes results when a declared `refreshEvent` fires.
+ */
+export interface CommandPaletteResourceQueryParams {
+    projectId?: string;
+    modeId?: string;
+    activeResource?: ResourceRef;
+    providerId: string;
+    query: string;
+    limit: number;
+}
+export type CommandPaletteResourceTarget = {
+    kind: "command";
+    command: CommandRef<Struct, unknown> | string;
+    params?: Struct;
+} | {
+    kind: "resource";
+    resource: ResourceRef;
+};
+export interface CommandPaletteResourceItem {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    keywords?: string[];
+    target: CommandPaletteResourceTarget;
+}
+export interface CommandPaletteResourceQueryResult {
+    items: CommandPaletteResourceItem[];
+}
+export interface CommandPaletteResourceContribution {
+    title: Localizable<string>;
+    resourceKind?: string;
+    queryCommand: CommandRef<CommandPaletteResourceQueryParams, CommandPaletteResourceQueryResult> | string;
+    refreshEvents?: (EventRef | string)[];
+}
 export type ExtensionSettingScope = "global" | "project";
 export type ExtensionSettingValueType = "boolean" | "number" | "string" | "array" | "object";
 export type ExtensionSettingValueForType<TType extends ExtensionSettingValueType> = TType extends "boolean" ? boolean : TType extends "number" ? number : TType extends "string" ? string : TType extends "array" ? JsonValue[] : JsonObject;
@@ -226,8 +303,8 @@ export type ExtensionSettingProperty<TType extends ExtensionSettingValueType = E
         scope: ExtensionSettingScope;
         default?: ExtensionSettingValueForType<TSettingType>;
         enum?: ExtensionSettingValueForType<TSettingType>[];
-        title?: string;
-        description?: string;
+        title?: Localizable<string>;
+        description?: Localizable<string>;
     };
 }[TType];
 export interface ExtensionSettingsContribution<TProperties extends Record<string, ExtensionSettingProperty> = Record<string, ExtensionSettingProperty>> {
@@ -241,35 +318,57 @@ export interface RendererContribution<TSlotContext extends Struct = Struct> {
 export interface ArtifactMountContribution {
     /** Relative path under .pstdio/<extension.name>/. */
     path: string;
-    label: string;
+    label: Localizable<string>;
     repoRole?: "default" | "selected" | "workspace";
 }
 export interface TemplateTypeContribution {
-    label: string;
-    description?: string;
+    label: Localizable<string>;
+    description?: Localizable<string>;
 }
 export interface TemplateContribution {
-    title: string;
+    title: Localizable<string>;
     type: string;
     source: PackageAssetDescriptor;
-    description?: string;
+    description?: Localizable<string>;
 }
 export interface SkillContribution {
-    title: string;
+    title: Localizable<string>;
     source: PackageAssetDescriptor;
-    description?: string;
+    description?: Localizable<string>;
 }
 export type ThemeMode = "light" | "dark";
 export interface ThemeContribution {
-    title: string;
+    title: Localizable<string>;
     source: PackageAssetDescriptor;
     format: "vscode-color-theme";
     mode?: ThemeMode;
-    description?: string;
+    description?: Localizable<string>;
 }
 export interface FileIconThemeContribution {
-    title: string;
+    title: Localizable<string>;
     source: PackageAssetDescriptor;
     format: "vscode-file-icon-theme";
-    description?: string;
+    description?: Localizable<string>;
+}
+/**
+ * Chord string in TanStack Hotkeys syntax (e.g. "mod+shift+p"). `mod` is
+ * Cmd on macOS and Ctrl elsewhere. Parsing, validation, canonicalization,
+ * and display labels are all delegated to `@tanstack/hotkeys`.
+ */
+export type KeybindingChord = string;
+export interface KeybindingContribution<TParams extends Struct = Struct> {
+    /** Default chord. Used on every platform unless an override is provided. */
+    key: KeybindingChord;
+    /** macOS override. */
+    mac?: KeybindingChord;
+    /** Linux override. */
+    linux?: KeybindingChord;
+    /** Windows override. */
+    win?: KeybindingChord;
+    /** Command this chord executes. */
+    command: CommandRef<TParams, unknown> | string;
+    /** Optional command params. */
+    args?: Partial<TParams>;
+    /** Optional gating predicate. The host evaluates it at dispatch time. */
+    when?: WhenExpression;
 }

package/dist/extensions/types/extension.d.ts

@@ -1,9 +1,12 @@
+import type { Localizable } from "../l10n";
 import type { CommandRef } from "./commands";
 import type { CommandMiddlewareHandler, CommandRunHandler, EventContext, ExtensionContextBase, MigrationContext, SetupContext } from "./context";
-import type { ArtifactMountContribution, CliContribution, DataRendererContribution, ExtensionSettingsContribution, FileIconThemeContribution, MenuContribution, ModeContribution, RendererContribution, RouteContribution, SettingsPanelContribution, SkillContribution, TemplateContribution, TemplateTypeContribution, ThemeContribution, TreeItemContribution, ViewContribution } from "./contributions";
+import type { ArtifactMountContribution, CliContribution, CommandPaletteContribution, CommandPaletteResourceContribution, DataRendererContribution, ExtensionSettingsContribution, FileIconThemeContribution, KeybindingContribution, MenuContribution, ModeContribution, RendererContribution, RouteContribution, SettingsPanelContribution, SkillContribution, TemplateContribution, TemplateTypeContribution, ThemeContribution, TreeItemContribution, ViewContribution } from "./contributions";
 import type { EventRef } from "./events";
 import type { JsonObject, MaybePromise, Struct } from "./json";
 import type { ParamObjectSchema, ParamsOf } from "./params";
+import type { PackageAssetDescriptor } from "./resources";
+import type { TreeRendererContribution } from "./tree-renderer";
 /** Current host extension API version. `engines.pstdio` in package.json is a semver range checked against this. */
 export declare const EXTENSION_API_VERSION = "1.0.0";
 type SchemaParams<TSchema extends ParamObjectSchema | undefined> = TSchema extends ParamObjectSchema ? ParamsOf<TSchema> : Struct;
@@ -12,10 +15,11 @@ type SchemaParams<TSchema extends ParamObjectSchema | undefined> = TSchema exten
  * the inferred shape of `ctx.params` in `run`.
  */
 export interface CommandDefinition<TSchema extends ParamObjectSchema | undefined = ParamObjectSchema | undefined, TResult = unknown, TSettings extends Record<string, unknown> = Record<string, unknown>> {
-    title: string;
-    description?: string;
+    title: Localizable<string>;
+    description?: Localizable<string>;
     params?: TSchema;
     menus?: MenuContribution[];
+    palette?: boolean | CommandPaletteContribution<SchemaParams<TSchema>> | CommandPaletteContribution<SchemaParams<TSchema>>[];
     cli?: boolean | CliContribution;
     run: CommandRunHandler<SchemaParams<TSchema>, TResult, TSettings>;
 }
@@ -38,7 +42,7 @@ export interface HookDefinition<TPayload extends Struct = Struct> {
     handler(ctx: EventContext, payload: TPayload): MaybePromise<void>;
 }
 export interface ScheduleContribution<TParams extends Struct = Struct> {
-    title: string;
+    title: Localizable<string>;
     cron: string;
     command?: CommandRef<TParams, unknown>;
     commandId?: string;
@@ -59,7 +63,7 @@ export interface HarnessRun {
 }
 export interface HarnessProvider {
     id: string;
-    label: string;
+    label: Localizable<string>;
     detect?(ctx: ExtensionContextBase): MaybePromise<HarnessDetectionResult>;
     start(ctx: ExtensionContextBase, input: {
         workspacePath: string;
@@ -76,7 +80,7 @@ export interface HarnessProvider {
 }
 export interface WorkspaceTypeProvider {
     id: string;
-    label: string;
+    label: Localizable<string>;
     create(ctx: ExtensionContextBase, input: JsonObject): MaybePromise<JsonObject>;
     resolve(ctx: ExtensionContextBase, workspace: JsonObject): MaybePromise<{
         rootPath: string;
@@ -131,8 +135,11 @@ export interface UiContributions {
     routes?: Record<string, RouteContribution>;
     views?: Record<string, ViewContribution>;
     treeItems?: Record<string, TreeItemContribution>;
+    treeRenderers?: Record<string, TreeRendererContribution>;
     settingsPanels?: Record<string, SettingsPanelContribution>;
     dataRenderers?: Record<string, DataRendererContribution>;
+    commandPaletteResources?: Record<string, CommandPaletteResourceContribution>;
+    keybindings?: Record<string, KeybindingContribution<any>>;
     activityRenderers?: Record<string, RendererContribution>;
     sessionAnchorRenderers?: Record<string, RendererContribution>;
 }
@@ -151,6 +158,8 @@ export interface AssetContributions {
     skills?: Record<string, SkillContribution>;
     themes?: Record<string, ThemeContribution>;
     fileIconThemes?: Record<string, FileIconThemeContribution>;
+    translations?: Record<string, PackageAssetDescriptor>;
+    defaultLocale?: string;
 }
 /** Provider contributions: harnesses, workspace types. */
 export interface ProviderContributions {

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

@@ -7,4 +7,5 @@ export type * from "./json";
 export type * from "./params";
 export type * from "./resources";
 export type * from "./slots";
+export type * from "./tree-renderer";
 export * from "./webview-capabilities";

package/dist/extensions/types/params.d.ts

@@ -1,6 +1,6 @@
 import type { JsonObject } from "./json";
 import type { ResourceRef } from "./resources";
-export type ParamType = "text" | "longtext" | "number" | "boolean" | "select" | "multi-select" | "repo" | "harness" | "template" | "resource" | "json";
+export type ParamType = "text" | "longtext" | "number" | "boolean" | "select" | "multi-select" | "repo" | "harness" | "template" | "resource" | "json" | "list";
 type ParamRequired<TRequired extends boolean | undefined> = TRequired extends true ? {
     required: true;
 } : TRequired extends false ? {
@@ -63,7 +63,10 @@ export type ResourceParam<TRequired extends boolean | undefined = boolean | unde
 export type JsonParam<T = unknown, TRequired extends boolean | undefined = boolean | undefined> = ParamBase<T, TRequired> & {
     type: "json";
 };
-export type ParamDescriptor<TValue = unknown, TRequired extends boolean | undefined = boolean | undefined> = TextParam<TRequired> | LongTextParam<TRequired> | NumberParam<TRequired> | BooleanParam<TRequired> | SelectParam<TRequired> | MultiSelectParam<TRequired> | RepoParam<TRequired> | HarnessParam<TRequired> | TemplateParam<TRequired> | ResourceParam<TRequired> | JsonParam<TValue, TRequired>;
+export type ListParam<TRequired extends boolean | undefined = boolean | undefined> = ParamBase<string[], TRequired> & {
+    type: "list";
+};
+export type ParamDescriptor<TValue = unknown, TRequired extends boolean | undefined = boolean | undefined> = TextParam<TRequired> | LongTextParam<TRequired> | NumberParam<TRequired> | BooleanParam<TRequired> | SelectParam<TRequired> | MultiSelectParam<TRequired> | RepoParam<TRequired> | HarnessParam<TRequired> | TemplateParam<TRequired> | ResourceParam<TRequired> | JsonParam<TValue, TRequired> | ListParam<TRequired>;
 export type ParamObjectSchema = Record<string, ParamDescriptor>;
 export type ParamValue<TDescriptor extends ParamDescriptor> = TDescriptor extends ParamDescriptor<infer V> ? V : never;
 type RequiredParamKeys<TSchema extends ParamObjectSchema> = {

package/dist/extensions/types/tree-renderer.d.ts

@@ -0,0 +1,89 @@
+import type { Localizable } from "../l10n";
+import type { CommandRef } from "./commands";
+import type { JsonObject, JsonValue } from "./json";
+import type { ParamObjectSchema } from "./params";
+export interface TreeRendererResourceRef {
+    type: string;
+    id: string;
+    projectId?: string;
+    label?: string;
+    extensionId?: string;
+    metadata?: JsonObject;
+}
+export interface TreeRendererState {
+    expandedNodeIds: string[];
+    expandedSectionIds: string[];
+    selectedNodeId?: string;
+}
+export interface TreeRendererQueryParams {
+    projectId?: string;
+    modeId?: string;
+    resource?: TreeRendererResourceRef;
+    treeId: string;
+    state?: TreeRendererState;
+    filter?: string;
+}
+export interface TreeRendererChildrenParams extends TreeRendererQueryParams {
+    node: TreeNode;
+}
+export interface TreeRendererActionParams extends TreeRendererQueryParams {
+    actionId: string;
+    node?: TreeNode;
+}
+export type TreeNodeTarget = {
+    kind: "command";
+    commandId: string;
+    args?: JsonObject;
+} | {
+    kind: "resource";
+    resource: TreeRendererResourceRef;
+} | {
+    kind: "view";
+    widgetId: string;
+};
+export interface TreeAction {
+    id: string;
+    label?: Localizable<string>;
+    icon?: string;
+    commandId?: string;
+    args?: JsonObject;
+    params?: ParamObjectSchema;
+    when?: string;
+    disabled?: boolean;
+}
+export interface TreeNode {
+    id: string;
+    label: Localizable<string>;
+    icon?: string;
+    iconColor?: string;
+    iconTooltip?: string;
+    resource?: TreeRendererResourceRef;
+    target?: TreeNodeTarget;
+    actions?: TreeAction[];
+    contextMenuActions?: TreeAction[];
+    collapsible?: boolean;
+    disabled?: boolean;
+    children?: TreeNode[];
+    description?: string;
+    contextValue?: string;
+    hiddenByDefault?: boolean;
+    metadata?: JsonObject;
+}
+export interface TreeViewSection {
+    id: string;
+    label?: Localizable<string>;
+    actions?: TreeAction[];
+    collapsible?: boolean;
+    nodes: TreeNode[];
+    hiddenByDefault?: boolean;
+}
+export interface TreeRendererContribution {
+    title: Localizable<string>;
+    icon?: string;
+    bodyCommand: CommandRef<TreeRendererQueryParams, TreeViewSection[]> | string;
+    childrenCommand?: CommandRef<TreeRendererChildrenParams, TreeNode[]> | string;
+    footerCommand?: CommandRef<TreeRendererQueryParams, TreeNode[]> | string;
+    defaultExpandedSectionIds?: string[];
+    defaultExpandedNodeIds?: string[];
+}
+export type TreeRendererCommandResult = TreeViewSection[] | TreeNode[] | JsonValue;

package/dist/extensions/types/webview-capabilities.d.ts

@@ -1,9 +1,10 @@
 import type { JsonObject } from "./json";
 import type { RepoContext, ResourceRef } from "./resources";
+export type { ExtensionBlobRef } from "./context";
 export declare const WEBVIEW_HOST_CAPABILITY_VERSION = 1;
-export declare const WEBVIEW_DECLARABLE_CAPABILITIES: readonly ["commands.execute", "resource.open", "notification.show", "preferences.get", "preferences.set", "extension.settings.all", "extension.settings.get", "extension.settings.set", "extension.settings.delete"];
+export declare const WEBVIEW_DECLARABLE_CAPABILITIES: readonly ["commands.execute", "resource.open", "notification.show", "preferences.get", "preferences.set", "extension.settings.all", "extension.settings.get", "extension.settings.set", "extension.settings.delete", "files.upload", "files.list", "files.delete"];
 export declare const ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES: readonly ["host.dispatchKeyboardEvent"];
-export declare const WEBVIEW_HOST_CAPABILITIES: readonly ["commands.execute", "resource.open", "notification.show", "preferences.get", "preferences.set", "extension.settings.all", "extension.settings.get", "extension.settings.set", "extension.settings.delete", "host.dispatchKeyboardEvent"];
+export declare const WEBVIEW_HOST_CAPABILITIES: readonly ["commands.execute", "resource.open", "notification.show", "preferences.get", "preferences.set", "extension.settings.all", "extension.settings.get", "extension.settings.set", "extension.settings.delete", "files.upload", "files.list", "files.delete", "host.dispatchKeyboardEvent"];
 export type WebviewHostCapability = (typeof WEBVIEW_HOST_CAPABILITIES)[number];
 export type WebviewDeclarableCapability = (typeof WEBVIEW_DECLARABLE_CAPABILITIES)[number];
 export type WebviewCapabilityDeclaration = WebviewDeclarableCapability | `${WebviewDeclarableCapability}@${typeof WEBVIEW_HOST_CAPABILITY_VERSION}`;
@@ -42,6 +43,30 @@ export interface WebviewExtensionSettingKeyParams {
 export interface WebviewExtensionSettingSetParams extends WebviewExtensionSettingKeyParams {
     value: unknown;
 }
+export type WebviewFileScope = {
+    type: "project";
+} | {
+    type: "repo";
+    id: string;
+} | {
+    type: "resource";
+    id: string;
+} | {
+    type: string;
+    id?: string;
+};
+export interface WebviewFilesUploadParams {
+    name: string;
+    data: Uint8Array | ArrayBuffer;
+    mimeType?: string;
+    scope?: WebviewFileScope;
+}
+export interface WebviewFilesListParams {
+    scope?: WebviewFileScope;
+}
+export interface WebviewFilesDeleteParams {
+    id: string;
+}
 export interface WebviewKeyboardEventParams {
     key?: string;
     code?: string;
@@ -61,5 +86,8 @@ export interface WebviewHostCapabilityParams {
     "extension.settings.get": WebviewExtensionSettingKeyParams;
     "extension.settings.set": WebviewExtensionSettingSetParams;
     "extension.settings.delete": WebviewExtensionSettingKeyParams;
+    "files.upload": WebviewFilesUploadParams;
+    "files.list": WebviewFilesListParams;
+    "files.delete": WebviewFilesDeleteParams;
     "host.dispatchKeyboardEvent": WebviewKeyboardEventParams;
 }

package/dist/extensions/when.d.ts

@@ -0,0 +1,9 @@
+import type { WhenExpression } from "./types/contributions";
+/**
+ * Resource-scoped visibility for command-palette contributions. Both the workbench host and the
+ * dashboard palette gate the same way, so the rule lives here once instead of being re-derived per
+ * surface. Only `resourceType` is evaluated: it is the sole `when` field a palette surface can
+ * resolve from the active resource alone (`mode`/`source`/`metadata` require execution context the
+ * palette does not have).
+ */
+export declare const matchesResourceWhen: (when: Pick<WhenExpression, "resourceType"> | undefined, resourceType: string | undefined) => boolean;

package/dist/extensions/workbench-targets.d.ts

@@ -1,4 +1,4 @@
-export declare const workbenchMenuTargets: readonly ["workbench.nav.actions", "workbench.nav.overflow", "workbench.commandPalette"];
+export declare const workbenchMenuTargets: readonly ["workbench.nav.actions", "workbench.nav.overflow"];
 export declare const workbenchTreeTargets: readonly ["workbench.left.tree", "workbench.main.left.tree", "workbench.main.right.tree"];
 export declare const workbenchViewTargets: readonly ["workbench.main", "workbench.main.left", "workbench.main.right", "workbench.secondary"];
 export declare const workbenchSettingsTargets: readonly ["workbench.settings"];
@@ -30,11 +30,6 @@ export declare const workbenchTargets: readonly [{
     readonly allowedKinds: readonly ["menu"];
     readonly granularity: "surface";
     readonly rationale: "Secondary command surface in the host-owned nav (top) workbench chrome.";
-}, {
-    readonly id: "workbench.commandPalette";
-    readonly allowedKinds: readonly ["menu"];
-    readonly granularity: "surface";
-    readonly rationale: "Global command discovery surface owned by the workbench.";
 }, {
     readonly id: "workbench.left.tree";
     readonly allowedKinds: readonly ["treeItem"];
@@ -86,11 +81,6 @@ export declare const getWorkbenchTargetDefinition: (id: string) => {
     readonly allowedKinds: readonly ["menu"];
     readonly granularity: "surface";
     readonly rationale: "Secondary command surface in the host-owned nav (top) workbench chrome.";
-} | {
-    readonly id: "workbench.commandPalette";
-    readonly allowedKinds: readonly ["menu"];
-    readonly granularity: "surface";
-    readonly rationale: "Global command discovery surface owned by the workbench.";
 } | {
     readonly id: "workbench.left.tree";
     readonly allowedKinds: readonly ["treeItem"];

package/dist/hooks/entities.d.ts

@@ -1,10 +1,8 @@
-import type { Ticket, Workspace } from "../resources";
-/** @deprecated Legacy core ticket hook entity. Ticket data is owned by the pstdio tickets extension. */
-export type HookTicket = Ticket & {
-    status_name: string | null;
-};
-export type HookWorkspace = Workspace & {
-    /** @deprecated Legacy ticket-workspace linkage. Ticket data is owned by the pstdio tickets extension. */
-    ticket_shorthand: string;
-    attempt_status_name: string | null;
+import type { Workspace } from "../resources";
+export type HookResourceAnchor = {
+    type: string;
+    id: string;
+    label?: string;
+    metadata?: Record<string, unknown>;
 };
+export type HookWorkspace = Workspace;

package/dist/hooks/index.d.ts

@@ -1,5 +1,3 @@
-export type { AttemptStatusChangeContext } from "./attempt";
 export type { BaseHookContext, HookClient, HookPayload, SessionFollowupInput } from "./base";
 export type { SessionHookContext } from "./session";
-export type { TicketContext, TicketCreationContext, TicketStatusChangeContext } from "./ticket";
 export type { CommitContext, ConflictContext, MergeContext, RebaseContext, WorktreeContext, WorktreeCreateContext, WorktreeRemoveContext, } from "./worktree";

package/dist/hooks/session.d.ts

@@ -1,5 +1,5 @@
 import type { BaseHookContext } from "./base";
-import type { HookTicket, HookWorkspace } from "./entities";
+import type { HookResourceAnchor, HookWorkspace } from "./entities";
 export type SessionHookContext = BaseHookContext & {
     sessionId: string;
     sessionStatus: "in_progress" | "awaiting_input" | "queued" | "completed" | "failed" | "cancelled" | "disconnected";
@@ -8,6 +8,5 @@ export type SessionHookContext = BaseHookContext & {
     workspaceId?: string;
     worktreePath?: string;
     branch?: string;
-    ticket?: HookTicket;
-    attemptStatus?: string;
+    anchors?: HookResourceAnchor[];
 };