@pstdio/sdk 0.8.0 → 0.10.0

package/dist/extensions/index.js

@@ -37,7 +37,6 @@ var defineSlot = (id, options) => ({
 
 // src/extensions/kernel-slots.ts
 var projectSlots = {
-  sidebarNav: defineSlot("project.sidebarNav", { kind: "navigation" }),
   sidebar: defineSlot("project.sidebar", { kind: "view" }),
   headerPrimary: defineSlot("project.headerPrimary", { kind: "menu" }),
   headerOverflow: defineSlot("project.headerOverflow", { kind: "menu" }),
@@ -49,10 +48,13 @@ var sessionSlots = {
   headerOverflow: defineSlot("session.headerOverflow", { kind: "menu" }),
   transcriptActions: defineSlot("session.transcriptActions", { kind: "menu" })
 };
+var ticketSlots = {
+  headerPrimary: defineSlot("ticket.headerPrimary", { kind: "menu" }),
+  headerOverflow: defineSlot("ticket.headerOverflow", { kind: "menu" })
+};
 var workspaceSlots = {
   headerPrimary: defineSlot("workspace.headerPrimary", { kind: "menu" }),
   headerOverflow: defineSlot("workspace.headerOverflow", { kind: "menu" }),
-  tabs: defineSlot("workspace.tabs", { kind: "navigation" }),
   sidebar: defineSlot("workspace.sidebar", { kind: "view" })
 };
 var projectEvents = {
@@ -101,17 +103,17 @@ var packageAsset = (path, baseUrl) => ({
 });
 // src/extensions/params.ts
 var params = {
-  text: (options = {}) => ({ type: "text", ...options }),
-  longText: (options = {}) => ({ type: "longtext", ...options }),
-  number: (options = {}) => ({ type: "number", ...options }),
-  boolean: (options = {}) => ({ type: "boolean", ...options }),
+  text: (options) => ({ type: "text", ...options }),
+  longText: (options) => ({ type: "longtext", ...options }),
+  number: (options) => ({ type: "number", ...options }),
+  boolean: (options) => ({ type: "boolean", ...options }),
   select: (options) => ({ type: "select", ...options }),
   multiSelect: (options) => ({
     type: "multi-select",
     ...options
   }),
-  repo: (options = {}) => ({ type: "repo", ...options }),
-  harness: (options = {}) => ({ type: "harness", ...options }),
+  repo: (options) => ({ type: "repo", ...options }),
+  harness: (options) => ({ type: "harness", ...options }),
   template: (options) => ({
     label: options.label,
     description: options.description,
@@ -122,7 +124,7 @@ var params = {
     templateType: options.type
   }),
   resource: (options) => ({ type: "resource", ...options }),
-  json: (options = {}) => ({ type: "json", ...options })
+  json: (options) => ({ type: "json", ...options })
 };
 // src/extensions/types/extension.ts
 var EXTENSION_API_VERSION = "1.0.0";
@@ -133,18 +135,125 @@ var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "resource.open",
   "notification.show",
   "preferences.get",
-  "preferences.set"
+  "preferences.set",
+  "extension.settings.all",
+  "extension.settings.get",
+  "extension.settings.set",
+  "extension.settings.delete"
 ];
 var ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES = ["host.dispatchKeyboardEvent"];
 var WEBVIEW_HOST_CAPABILITIES = [
   ...WEBVIEW_DECLARABLE_CAPABILITIES,
   ...ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES
 ];
+// src/extensions/workbench-targets.ts
+var workbenchMenuTargets = [
+  "workbench.nav.actions",
+  "workbench.nav.overflow",
+  "workbench.commandPalette"
+];
+var workbenchTreeTargets = [
+  "workbench.left.tree",
+  "workbench.main.left.tree",
+  "workbench.main.right.tree"
+];
+var workbenchViewTargets = [
+  "workbench.main",
+  "workbench.main.left",
+  "workbench.main.right",
+  "workbench.secondary"
+];
+var workbenchSettingsTargets = ["workbench.settings"];
+var workbenchSettingsScopes = ["project", "global"];
+var workbenchModeLayoutTargets = [
+  "workbench.left",
+  "workbench.main.left",
+  "workbench.main",
+  "workbench.main.right",
+  "workbench.secondary"
+];
+var workbenchTargets = [
+  {
+    id: "workbench.nav.actions",
+    allowedKinds: ["menu"],
+    granularity: "surface",
+    rationale: "Primary command surface in the host-owned nav (top) workbench chrome."
+  },
+  {
+    id: "workbench.nav.overflow",
+    allowedKinds: ["menu"],
+    granularity: "surface",
+    rationale: "Secondary command surface in the host-owned nav (top) workbench chrome."
+  },
+  {
+    id: "workbench.commandPalette",
+    allowedKinds: ["menu"],
+    granularity: "surface",
+    rationale: "Global command discovery surface owned by the workbench."
+  },
+  {
+    id: "workbench.left.tree",
+    allowedKinds: ["treeItem"],
+    granularity: "areaTree",
+    rationale: "Tree entries for the active tree renderer mounted in the left area."
+  },
+  {
+    id: "workbench.main.left.tree",
+    allowedKinds: ["treeItem"],
+    granularity: "areaTree",
+    rationale: "Tree entries for the active tree renderer mounted in the main-left area."
+  },
+  {
+    id: "workbench.main.right.tree",
+    allowedKinds: ["treeItem"],
+    granularity: "areaTree",
+    rationale: "Tree entries for the active tree renderer mounted in the main-right area."
+  },
+  {
+    id: "workbench.main",
+    allowedKinds: ["view"],
+    granularity: "area",
+    rationale: "Direct extension view placement in the main area."
+  },
+  {
+    id: "workbench.main.left",
+    allowedKinds: ["view"],
+    granularity: "area",
+    rationale: "Direct extension view placement in the main-left area."
+  },
+  {
+    id: "workbench.main.right",
+    allowedKinds: ["view"],
+    granularity: "area",
+    rationale: "Direct extension view placement in the main-right area."
+  },
+  {
+    id: "workbench.secondary",
+    allowedKinds: ["view"],
+    granularity: "area",
+    rationale: "Direct extension view placement in the secondary area."
+  },
+  {
+    id: "workbench.settings",
+    allowedKinds: ["settings"],
+    granularity: "surface",
+    rationale: "Settings panel placement in host-owned settings navigation."
+  }
+];
+var getWorkbenchTargetDefinition = (id) => workbenchTargets.find((target) => target.id === id);
 export {
   worktreeEvents,
   workspaceSlots,
   workspaceEvents,
   workspaceCommands,
+  workbenchViewTargets,
+  workbenchTreeTargets,
+  workbenchTargets,
+  workbenchSettingsTargets,
+  workbenchSettingsScopes,
+  workbenchModeLayoutTargets,
+  workbenchMenuTargets,
+  ticketSlots,
   ticketEvents,
   sessionSlots,
   sessionEvents,
@@ -153,8 +262,8 @@ export {
   params,
   packageAsset,
   gitEvents,
+  getWorkbenchTargetDefinition,
   eventRef,
-  defineSlot,
   defineMiddleware,
   defineHook,
   defineExtensionView,

package/dist/extensions/kernel-slots.d.ts

@@ -1,21 +1,9 @@
-import type { SetAttemptStatusInput, SetAttemptStatusResult } from "./types/context";
-import type { JsonObject } from "./types/json";
+import type { ExtensionTicket, ExtensionWorkspace, SetAttemptStatusInput, SetAttemptStatusResult } from "./types/context";
 import type { ResourceAnchor } from "./types/resources";
+/** @deprecated Legacy core ticket event payload. Ticket events are owned by the pstdio tickets extension. */
 export interface TicketArchivedEventPayload {
     projectId: string;
-    ticket: {
-        id: string;
-        shorthand: string;
-        displayTitle: string | null;
-        userPrompt: string | null;
-        parentId: string | null;
-        draft: boolean;
-        archived: boolean;
-        status: string | null;
-        tagIds: string[];
-        tagNames: string[];
-        fileIds: string[];
-    };
+    ticket: ExtensionTicket;
 }
 export interface WorktreeCreatedEventPayload {
     projectId: string;
@@ -24,49 +12,55 @@ export interface WorktreeCreatedEventPayload {
     branch: string;
     workspace: string;
     workspaceId: string;
+    /** @deprecated Legacy ticket worktree linkage. Ticket worktree setup is owned by the pstdio tickets extension. */
     ticket: string;
 }
+/** @deprecated Legacy core ticket event payload. Ticket events are owned by the pstdio tickets extension. */
 export interface TicketLifecyclePayload {
     projectId: string;
-    ticket: JsonObject;
+    ticket: ExtensionTicket;
 }
+/** @deprecated Legacy core ticket event payload. Ticket events are owned by the pstdio tickets extension. */
 export interface TicketStatusChangePayload {
     projectId: string;
-    ticket: JsonObject;
+    ticket: ExtensionTicket;
     fromStatus: string | null;
-    toStatus: string;
+    toStatus: string | null;
 }
 export interface AttemptStatusChangePayload {
     projectId: string;
     workspaceId: string;
-    ticket: JsonObject | null;
+    /** @deprecated Legacy ticket attempt linkage. Ticket data is owned by the pstdio tickets extension. */
+    ticket: ExtensionTicket | null;
     fromStatus: string | null;
     toStatus: string;
     statusChangeId?: string;
     sessionId: string | null;
     originalSessionId: string | null;
     worktreePath: string | null;
-    workspace: JsonObject;
+    workspace: ExtensionWorkspace;
 }
 export interface SessionLifecyclePayload {
     projectId: string;
     sessionId: string;
     sessionStatus?: string;
     originalSessionId?: string;
-    workspace?: JsonObject;
+    workspace?: ExtensionWorkspace;
     workspaceId?: string;
     worktreePath?: string;
     branch?: string;
-    ticket?: JsonObject;
+    /** @deprecated Legacy ticket session linkage. Ticket data is owned by the pstdio tickets extension. */
+    ticket?: ExtensionTicket;
     attemptStatus?: string;
 }
 export interface WorktreeRemovedPayload {
     projectId: string;
     repoPath?: string;
     worktreePath: string;
-    workspace?: JsonObject;
+    workspace?: ExtensionWorkspace;
     workspaceId?: string;
-    ticket?: JsonObject | string;
+    /** @deprecated Legacy ticket worktree linkage. Ticket data is owned by the pstdio tickets extension. */
+    ticket?: ExtensionTicket | string;
 }
 export interface CommitPayload {
     projectId: string;
@@ -74,16 +68,17 @@ export interface CommitPayload {
     worktreePath?: string;
     branch?: string;
     commitSha?: string;
-    workspace?: JsonObject;
-    ticket?: JsonObject | string;
+    workspace?: ExtensionWorkspace;
+    /** @deprecated Legacy ticket git linkage. Ticket data is owned by the pstdio tickets extension. */
+    ticket?: ExtensionTicket | string;
 }
 export interface RebasePayload {
     projectId: string;
     repoPath?: string;
     worktreePath?: string;
     branch?: string;
-    workspace?: JsonObject;
-    ticket?: JsonObject | string;
+    workspace?: ExtensionWorkspace;
+    ticket?: ExtensionTicket | string;
 }
 export interface MergePayload extends CommitPayload {
 }
@@ -93,11 +88,11 @@ export interface ConflictPayload {
     repoPath?: string;
     worktreePath?: string;
     branch?: string;
-    workspace?: JsonObject;
-    ticket?: JsonObject | string;
+    workspace?: ExtensionWorkspace;
+    /** @deprecated Legacy ticket git linkage. Ticket data is owned by the pstdio tickets extension. */
+    ticket?: ExtensionTicket | string;
 }
 export declare const projectSlots: {
-    sidebarNav: import("./types").SlotRef<object, "navigation">;
     sidebar: import("./types").SlotRef<object, "view">;
     headerPrimary: import("./types").SlotRef<object, "menu">;
     headerOverflow: import("./types").SlotRef<object, "menu">;
@@ -109,10 +104,14 @@ export declare const sessionSlots: {
     headerOverflow: import("./types").SlotRef<object, "menu">;
     transcriptActions: import("./types").SlotRef<object, "menu">;
 };
+/** @deprecated Legacy core ticket slots. Ticket UI contributions are owned by the pstdio tickets extension. */
+export declare const ticketSlots: {
+    headerPrimary: import("./types").SlotRef<object, "menu">;
+    headerOverflow: import("./types").SlotRef<object, "menu">;
+};
 export declare const workspaceSlots: {
     headerPrimary: import("./types").SlotRef<object, "menu">;
     headerOverflow: import("./types").SlotRef<object, "menu">;
-    tabs: import("./types").SlotRef<object, "navigation">;
     sidebar: import("./types").SlotRef<object, "view">;
 };
 export declare const projectEvents: {
@@ -132,6 +131,7 @@ export declare const sessionEvents: {
         anchors?: ResourceAnchor[];
     }>;
 };
+/** @deprecated Legacy core ticket events. Ticket events are owned by the pstdio tickets extension. */
 export declare const ticketEvents: {
     created: import("./types").EventRef<TicketLifecyclePayload>;
     statusChanged: import("./types").EventRef<TicketStatusChangePayload>;
@@ -140,13 +140,13 @@ export declare const ticketEvents: {
 };
 export declare const workspaceEvents: {
     created: import("./types").EventRef<{
-        workspace: JsonObject;
+        workspace: ExtensionWorkspace;
     }>;
     archived: import("./types").EventRef<{
-        workspace: JsonObject;
+        workspace: ExtensionWorkspace;
     }>;
     deleted: import("./types").EventRef<{
-        workspace: JsonObject;
+        workspace: ExtensionWorkspace;
     }>;
 };
 export declare const worktreeEvents: {
@@ -159,6 +159,7 @@ export declare const gitEvents: {
     merged: import("./types").EventRef<MergePayload>;
     conflicted: import("./types").EventRef<ConflictPayload>;
 };
+/** @deprecated Legacy ticket attempt status events. Workspace status automation is extension-owned. */
 export declare const attemptStatusEvents: {
     changed: import("./types").EventRef<AttemptStatusChangePayload>;
 };

package/dist/extensions/params.d.ts

@@ -1,4 +1,10 @@
 import type { BooleanParam, HarnessParam, JsonParam, LongTextParam, MultiSelectParam, NumberParam, RepoParam, ResourceParam, SelectParam, TemplateParam, TextParam } from "./types/params";
+type RequiredOf<TOptions> = TOptions extends {
+    required: infer TRequired extends boolean;
+} ? TRequired : undefined;
+type ParamOptions<TParam extends {
+    type: string;
+}> = Omit<TParam, "type">;
 /**
  * Builders for typed parameter descriptors. Each builder produces a discriminated
  * `ParamDescriptor` so the runtime and editor only see fields valid for that type.
@@ -10,17 +16,18 @@ import type { BooleanParam, HarnessParam, JsonParam, LongTextParam, MultiSelectP
  *   }
  */
 export declare const params: {
-    text: (options?: Omit<TextParam, "type">) => TextParam;
-    longText: (options?: Omit<LongTextParam, "type">) => LongTextParam;
-    number: (options?: Omit<NumberParam, "type">) => NumberParam;
-    boolean: (options?: Omit<BooleanParam, "type">) => BooleanParam;
-    select: (options: Omit<SelectParam, "type">) => SelectParam;
-    multiSelect: (options: Omit<MultiSelectParam, "type">) => MultiSelectParam;
-    repo: (options?: Omit<RepoParam, "type">) => RepoParam;
-    harness: (options?: Omit<HarnessParam, "type">) => HarnessParam;
-    template: (options: Omit<TemplateParam, "type" | "templateType"> & {
+    text: <const TOptions extends ParamOptions<TextParam> | undefined = undefined>(options?: TOptions) => TextParam<RequiredOf<TOptions>>;
+    longText: <const TOptions extends ParamOptions<LongTextParam> | undefined = undefined>(options?: TOptions) => LongTextParam<RequiredOf<TOptions>>;
+    number: <const TOptions extends ParamOptions<NumberParam> | undefined = undefined>(options?: TOptions) => NumberParam<RequiredOf<TOptions>>;
+    boolean: <const TOptions extends ParamOptions<BooleanParam> | undefined = undefined>(options?: TOptions) => BooleanParam<RequiredOf<TOptions>>;
+    select: <const TOptions extends ParamOptions<SelectParam>>(options: TOptions) => SelectParam<RequiredOf<TOptions>>;
+    multiSelect: <const TOptions extends ParamOptions<MultiSelectParam>>(options: TOptions) => MultiSelectParam<RequiredOf<TOptions>>;
+    repo: <const TOptions extends ParamOptions<RepoParam> | undefined = undefined>(options?: TOptions) => RepoParam<RequiredOf<TOptions>>;
+    harness: <const TOptions extends ParamOptions<HarnessParam> | undefined = undefined>(options?: TOptions) => HarnessParam<RequiredOf<TOptions>>;
+    template: <const TOptions extends Omit<TemplateParam, "type" | "templateType"> & {
         type: string;
-    }) => TemplateParam;
-    resource: (options: Omit<ResourceParam, "type">) => ResourceParam;
-    json: <T = unknown>(options?: Omit<JsonParam<T>, "type">) => JsonParam<T>;
+    }>(options: TOptions) => TemplateParam<RequiredOf<TOptions>>;
+    resource: <const TOptions extends ParamOptions<ResourceParam>>(options: TOptions) => ResourceParam<RequiredOf<TOptions>>;
+    json: <T = unknown, const TOptions extends ParamOptions<JsonParam<T>> | undefined = undefined>(options?: TOptions) => JsonParam<T, RequiredOf<TOptions>>;
 };
+export {};

package/dist/extensions/refs.d.ts

@@ -17,8 +17,8 @@ export declare const eventRef: <TPayload extends Struct = Struct>(id: string) =>
  * 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>>;
-type CommandRefFromDefinition<TDefinition> = TDefinition extends CommandDefinition<infer TSchema, infer TResult> ? CommandRef<TSchema extends ParamObjectSchema ? ParamsOf<TSchema> : Struct, TResult> : never;
+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]>;
 };
@@ -32,7 +32,7 @@ type CommandsRefMap<TCommands extends CommandsRecord> = {
  * @example
  *   const ext = defineExtension({ commands: { ... } });
  *   const labCommands = commandsOf("extension-lab", ext);
- *   labCommands.awaken; // CommandRef<{ title: string }, ...>
+ *   labCommands.awaken; // CommandRef<{ title?: string }, ...>
  */
 export declare const commandsOf: <TExtension extends {
     commands?: CommandsRecord;

package/dist/extensions/slots.d.ts

@@ -1,14 +1,6 @@
 import type { Struct } from "./types/json";
 import type { SlotOptions, SlotRef, UiSlotKind } from "./types/slots";
 /**
- * Define a UI slot that contributions can target. The `TContext` parameter constrains
- * the data passed to renderers/menus invoked through the slot, and `TKind` picks the
- * contribution shape (`menu`, `navigation`, `view`, `settings`, `renderer`).
- *
- * @example
- *   export const projectHeader = defineSlot<{ projectId: string }, "menu">("project.header", {
- *     kind: "menu",
- *     label: "Project header",
- *   });
+ * Define a host-owned UI slot that extension contributions can target.
  */
 export declare const defineSlot: <TContext extends Struct = Struct, TKind extends UiSlotKind = UiSlotKind>(id: string, options: SlotOptions<TKind>) => SlotRef<TContext, TKind>;

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

@@ -1,3 +1,4 @@
+import type { WorkbenchAttachmentTarget } from "../workbench-targets";
 import type { JsonObject, JsonValue, Struct } from "./json";
 import type { RepoContext, ResourceRef } from "./resources";
 import type { SlotInvocationContext } from "./slots";
@@ -13,11 +14,18 @@ export interface SerializedError {
     stack?: string;
     cause?: JsonValue;
 }
+export interface WorkbenchAttachmentInvocationContext {
+    target: WorkbenchAttachmentTarget;
+    mode?: string;
+    projectId?: string;
+    resource?: ResourceRef;
+}
 export interface CommandInvocation<TParams extends Struct = Struct> {
     params: TParams;
     resource?: ResourceRef;
     repoId?: string;
     repoPath?: string;
+    attachment?: WorkbenchAttachmentInvocationContext;
     slot?: SlotInvocationContext;
     metadata?: JsonObject;
 }