@pstdio/sdk 0.8.0 → 0.10.0

package/README.md

@@ -7,7 +7,7 @@ This package is the public integration surface for:
 - calling the Prompt Studio HTTP API
 - importing shared request and resource types
 - rendering prompt templates
-- authoring Prompt Studio plugins, actions, and lifecycle hooks
+- authoring Prompt Studio extensions
 
 The package is ESM-only and is published through subpath exports. Import from the entrypoint you need, not from `@pstdio/sdk` directly.
 
@@ -19,14 +19,14 @@ bun add @pstdio/sdk
 
 ## Entry Points
 
-| Import path             | Purpose                                                   |
-| ----------------------- | --------------------------------------------------------- |
-| `@pstdio/sdk/client`    | Runtime HTTP client for Prompt Studio                     |
-| `@pstdio/sdk/api`       | Request and response payload types                        |
-| `@pstdio/sdk/resources` | Shared resource/entity types                              |
-| `@pstdio/sdk/plugins`   | Plugin definition types, hook types, and helper utilities |
-| `@pstdio/sdk/prompts`   | Prompt rendering helpers                                  |
-| `@pstdio/sdk/hooks`     | Hook context and hook client types                        |
+| Import path              | Purpose                               |
+| ------------------------ | ------------------------------------- |
+| `@pstdio/sdk/client`     | Runtime HTTP client for Prompt Studio |
+| `@pstdio/sdk/api`        | Request and response payload types    |
+| `@pstdio/sdk/resources`  | Shared resource/entity types          |
+| `@pstdio/sdk/prompts`    | Prompt rendering helpers              |
+| `@pstdio/sdk/extensions` | Extension authoring types             |
+| `@pstdio/sdk/hooks`      | Hook context and client types         |
 
 Example:
 
@@ -34,9 +34,9 @@ Example:
 import { createClient, PstdioApiError } from "@pstdio/sdk/client";
 import type { CreateTicketInput } from "@pstdio/sdk/api";
 import type { TicketDetail } from "@pstdio/sdk/resources";
-import { createSession, definePlugin } from "@pstdio/sdk/plugins";
 import { renderPrompt } from "@pstdio/sdk/prompts";
-import type { AttemptStatusChangeContext } from "@pstdio/sdk/hooks";
+import type { ExtensionDefinition } from "@pstdio/sdk/extensions";
+import type { WorktreeCreateContext } from "@pstdio/sdk/hooks";
 ```
 
 ## HTTP Client
@@ -71,7 +71,6 @@ The request layer throws `PstdioApiError` for non-2xx responses.
 
 - `error.message`: API error message
 - `error.status`: HTTP status code
-- when the API returns `hook_output`, it is appended to `message`
 
 ```ts
 import { PstdioApiError, createClient } from "@pstdio/sdk/client";
@@ -105,7 +104,6 @@ try {
 | `templates`  | `list`, `get`, `create`, `update`, `delete`                                                                                                        |
 | `skills`     | `list`, `get`, `update`                                                                                                                            |
 | `agents`     | `list`, `info`, `models`, `setup`, `setupAvailable`, `update`, `delete`                                                                            |
-| `actions`    | `list`, `execute`                                                                                                                                  |
 
 Notes:
 
@@ -125,18 +123,11 @@ import type {
 } from "@pstdio/sdk/api";
 ```
 
-Most of these types come from `pstdio-api-contracts`. The SDK also defines a few client-facing types:
-
-- `ListTicketsInput`
-- `TicketAttemptResponse`
-- `ActionResult`
-- `ExecuteActionInput`
-
-Use `import type` for this entrypoint. It does not expose runtime helpers.
+Most of these types come from `pstdio-api-contracts`. Use `import type` for this entrypoint. It does not expose runtime helpers.
 
 ## Resource Types
 
-`@pstdio/sdk/resources` re-exports the shared Prompt Studio entities used across the API and plugin system.
+`@pstdio/sdk/resources` re-exports the shared Prompt Studio entities used across the API and extension system.
 
 Common exports include `Project`, `Repo`, `Ticket`, `TicketDetail`, `TicketListItem`, `TicketFile`, `Workspace`,
 `WorkspaceListItem`, `Session`, `SessionStatus`, `Status`, `AttemptStatus`, `Tag`, `TagOption`, `Template`,
@@ -163,179 +154,41 @@ const prompt = renderPrompt("Implement ticket {{ticket}}", {
 });
 ```
 
-Use this when a session prompt or action prompt is stored as a reusable template with variables.
-
-## Plugins
-
-Prompt Studio plugins export a default `definePlugin(...)` result from a TypeScript or JavaScript module.
-
-Plugins can provide:
+## Extensions
 
-- `actions`: user-triggered actions attached to tickets, workspaces, or sessions
-- `hooks`: lifecycle handlers that run before or after Prompt Studio events
-
-### Action example
+Prompt Studio extensions are packaged integrations that can contribute commands, middleware, lifecycle event handlers, menu entries, and webviews. Use `@pstdio/sdk/extensions` for the extension authoring types.
 
 ```ts
-import { createSession, definePlugin } from "@pstdio/sdk/plugins";
-
-export default definePlugin({
-  actions: [
-    {
-      key: "refine-ticket",
-      label: "Refine ticket",
-      targetType: "ticket",
-      placement: "overflow",
-      params: [
-        {
-          key: "context",
-          label: "Additional context",
-          type: "longtext",
-          required: false,
-        },
-      ],
-      async trigger(ctx) {
-        const context = ctx.params.context as string | undefined;
-
-        const parts = [`Refine ticket: ${ctx.target.shorthand}`];
-        if (context) parts.push(`Additional context:\n${context}`);
-
-        await createSession(ctx, {
-          title: `Refine ticket: ${ctx.target.shorthand}`,
-          prompt: parts.join("\n\n"),
-        });
-      },
-    },
-  ],
-});
-```
+import type { ExtensionDefinition } from "@pstdio/sdk/extensions";
 
-### Hook example
-
-```ts
-import { definePlugin, runCommand } from "@pstdio/sdk/plugins";
-
-export default definePlugin({
-  hooks: {
-    async preAttemptStatusChange(ctx) {
-      if (ctx.toStatus !== "review-ready") return;
-      if (!ctx.worktreePath) return;
-
-      const validation = await runCommand(ctx.worktreePath, [
-        "bun",
-        "run",
-        "validate",
-      ]);
-      if (validation.exitCode === 0) return;
-
-      const output = [validation.stdout, validation.stderr]
-        .filter(Boolean)
-        .join("\n\n");
-
-      return {
-        reject: true,
-        reason: output || "bun run validate failed",
-      };
-    },
+const extension: ExtensionDefinition = {
+  manifest: {
+    id: "example-extension",
+    name: "Example extension",
+    version: "0.0.0",
   },
-});
+  activate(ctx) {
+    ctx.commands.register({
+      id: "example-extension.say-hello",
+      title: "Say hello",
+      handler: () => ({ ok: true }),
+    });
+  },
+};
+
+export default extension;
 ```
 
-### Plugin types
-
-The plugin entrypoint exports the core types used by plugin authors, including `PluginDefinition`, `PluginHooks`,
-`PrePluginHooks`, `PostPluginHooks`, `HookResponse`, `PreHookReturn`, `PostHookReturn`, `ActionDefinition`,
-`ActionDescriptor`, `ActionInput`, `ActionTriggerContext`, `ActionParamDef`, `TargetType`, and `ActionPlacement`.
-
-Action parameter definitions support `text`, `longtext`, `select`, `template-select`, `agent`, and `repo`.
-Action targets support `ticket`, `workspace`, and `session`. Action placement supports `primary`, `secondary`,
-and `overflow`.
-
-`definePlugin()` is intentionally small. Today it mainly validates that every declared action has a `trigger(ctx)` function and then returns the plugin definition unchanged.
-
-### Lifecycle hooks
-
-Pre hooks may return `{ reject, reason, data }` to stop an operation. Post hooks return `void`.
-
-Available pre hooks:
-
-- `preTicketCreation`
-- `preTicketStatusChange`
-- `preTicketArchive`
-- `preTicketDeletion`
-- `preWorktreeCreate`
-- `preWorktreeRemove`
-- `preCommit`
-- `preRebase`
-- `preMerge`
-- `preAttemptStatusChange`
-
-Available post hooks:
-
-- `postTicketCreation`
-- `postTicketStatusChange`
-- `postTicketArchive`
-- `postTicketDeletion`
-- `postSessionStart`
-- `postSessionSuccess`
-- `postSessionFail`
-- `postSessionResume`
-- `postSessionAwaitInput`
-- `postWorktreeCreate`
-- `postWorktreeRemove`
-- `postCommit`
-- `postRebase`
-- `postMerge`
-- `onConflict`
-- `postAttemptStatusChange`
-
-### Plugin helpers
-
-`@pstdio/sdk/plugins` also exports helper functions for common workflow automation:
-
-| Helper                             | Purpose                                                                                      |
-| ---------------------------------- | -------------------------------------------------------------------------------------------- |
-| `createAttempt`                    | Create a ticket attempt and start a session                                                  |
-| `createWorkspace`                  | Create a ticket attempt without starting a session                                           |
-| `createSession`                    | Create a session using `ctx.projectId` automatically                                         |
-| `followupSession`                  | Send a follow-up message using an explicit or contextual session id                          |
-| `findTicketByRef`                  | Resolve a ticket by id or shorthand                                                          |
-| `findWorkspaceByRef`               | Resolve a workspace by id or shorthand                                                       |
-| `getAttemptsForTicket`             | List workspaces for a ticket                                                                 |
-| `workspacesForTicket`              | List workspaces for a ticket                                                                 |
-| `setTicketStatus`                  | Resolve a status by name and update the ticket                                               |
-| `setWorkspaceAttemptStatus`        | Update a workspace attempt status by name                                                    |
-| `updateTicketWhenAllAttemptsMatch` | Update a ticket when all attempts share a target attempt status                              |
-| `removeAllWorktreesForTicket`      | Remove every worktree currently attached to a ticket                                         |
-| `bootstrapWorktree`                | Copy Prompt Studio and agent metadata into a worktree and optionally pull the ticket locally |
-| `pullTickets`                      | Write ticket markdown and attachments into `.pstdio/tickets/...`                             |
-| `runCommand`                       | Run a command array in a working directory and capture `stdout`, `stderr`, and `exitCode`    |
-
-These helpers accept action or hook context and resolve project-scoped ids for you where possible.
-
-## Hook Context Types
-
-`@pstdio/sdk/hooks` exposes the shared context types used by hooks and hook runtimes:
-
-`BaseHookContext`, `HookClient`, `HookPayload`, `SessionFollowupInput`, `AttemptStatusChangeContext`,
-`SessionHookContext`, `TicketContext`, `TicketCreationContext`, `TicketStatusChangeContext`, `WorktreeContext`,
-and `WorktreeCreateContext`.
-
-Import from this entrypoint when you want to annotate hook code explicitly:
+## Hook Types
+
+`@pstdio/sdk/hooks` exposes the shared context types used by hook runtimes and hook handlers.
 
 ```ts
 import type {
-  SessionHookContext,
-  TicketStatusChangeContext,
+  CommitContext,
+  RebaseContext,
+  WorktreeRemoveContext,
 } from "@pstdio/sdk/hooks";
-
-const logStatusChange = (ctx: TicketStatusChangeContext) => {
-  console.log(ctx.shorthand, ctx.fromStatus, ctx.toStatus);
-};
-
-const onSessionStart = async (ctx: SessionHookContext) => {
-  console.log(ctx.sessionId, ctx.sessionStatus);
-};
 ```
 
 ## Package Development

package/dist/api/extensions.d.ts

@@ -1 +1 @@
-export type { CommandExecuteRequest, CommandExecuteResponse, DashboardExtensionMetadata, ExtensionCommandRecord, ExtensionDiagnostic, ExtensionMenuContribution, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingsPanelRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListProjectExtensionsResponse, ProjectExtensionInstance, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, } from "pstdio-api-contracts";
+export type { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, ModeLayoutContributionRecord, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, } from "pstdio-api-contracts";

package/dist/api/index.d.ts

@@ -1,6 +1,5 @@
-export type { ActionResult, ExecuteActionInput } from "./actions";
 export type { SetupAgentInput, SetupAvailableAgentsInput, UpdateAgentInput } from "./agents";
-export type { CommandExecuteRequest, CommandExecuteResponse, DashboardExtensionMetadata, ExtensionCommandRecord, ExtensionDiagnostic, ExtensionMenuContribution, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingsPanelRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListProjectExtensionsResponse, ProjectExtensionInstance, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, } from "./extensions";
+export type { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, } from "./extensions";
 export type { CreateProjectInput, RegisterRepoInput } from "./projects";
 export type { ApprovalInput, CreateSessionInput, FollowUpInput, ResolveSessionIdInput, ResolveSessionIdResponse, SessionConversationResponse, } from "./sessions";
 export type { Settings, UpdateSettingsInput } from "./settings";

package/dist/api/statuses.d.ts

@@ -1 +1,2 @@
+/** @deprecated Legacy core ticket status API. Ticket statuses are owned by the pstdio tickets extension. */
 export type { CreateAttemptStatusInput, CreateStatusInput } from "pstdio-api-contracts";

package/dist/api/tags.d.ts

@@ -1 +1,2 @@
+/** @deprecated Legacy core ticket tag API. Ticket tags are owned by the pstdio tickets extension. */
 export type { CreateTagInput, CreateTagOptionInput, UpdateTagInput, UpdateTagOptionInput, } from "pstdio-api-contracts";

package/dist/api/tickets.d.ts

@@ -1,5 +1,7 @@
+/** @deprecated Legacy core ticket API. Ticket data is owned by the pstdio tickets extension. */
 export type { CreateTicketAttemptInput, CreateTicketInput, ListProjectActivityForTicketsInput, ListTicketActivityInput, ListTicketActivityResponse, TicketAttemptMode, UpdateTicketInput, UpdateWhenAttemptStatusInput, UpdateWhenAttemptStatusResponse, UploadTicketFileInput, } from "pstdio-api-contracts";
 import type { Ticket, Workspace } from "../resources";
+/** @deprecated Legacy core ticket API. Ticket data is owned by the pstdio tickets extension. */
 export type ListTicketsInput = {
     status?: string;
     tag?: string | string[];
@@ -9,6 +11,7 @@ export type ListTicketsInput = {
     shorthand?: string;
     search?: string;
 };
+/** @deprecated Legacy core ticket attempts. Ticket attempts are owned by the pstdio tickets extension. */
 export type TicketAttemptResponse = {
     mode: "worktree" | "current_branch";
     ticket: Ticket;

package/dist/api/workspaces.d.ts

@@ -1 +1,10 @@
-export type { CreateWorkspaceInput, ListWorkspaceActivityInput, ListWorkspaceActivityResponse, RemoveWorktreeResponse, UpdateAttemptStatusInput, UpdateAttemptStatusResponse, } from "pstdio-api-contracts";
+import type { CreateWorkspaceInput as ContractCreateWorkspaceInput, ListWorkspaceActivityInput as ContractListWorkspaceActivityInput, ListWorkspaceActivityResponse as ContractListWorkspaceActivityResponse, RemoveWorktreeResponse as ContractRemoveWorktreeResponse, UpdateAttemptStatusInput as ContractUpdateAttemptStatusInput, UpdateAttemptStatusResponse as ContractUpdateAttemptStatusResponse } from "pstdio-api-contracts";
+/** @deprecated Requires legacy ticket-workspace linkage. Ticket ownership is moving to the pstdio tickets extension. */
+export type CreateWorkspaceInput = ContractCreateWorkspaceInput;
+export type ListWorkspaceActivityInput = ContractListWorkspaceActivityInput;
+export type ListWorkspaceActivityResponse = ContractListWorkspaceActivityResponse;
+export type RemoveWorktreeResponse = ContractRemoveWorktreeResponse;
+/** @deprecated Legacy ticket attempt status mutation. Workspace status automation is extension-owned. */
+export type UpdateAttemptStatusInput = ContractUpdateAttemptStatusInput;
+/** @deprecated Legacy ticket attempt status mutation. Workspace status automation is extension-owned. */
+export type UpdateAttemptStatusResponse = ContractUpdateAttemptStatusResponse;

package/dist/client/client.d.ts

@@ -1,4 +1,3 @@
-import { type ActionClient } from "./actions";
 import { type AgentClient } from "./agents";
 import { type ExtensionClient } from "./extensions";
 import { type ProjectClient } from "./projects";
@@ -14,15 +13,17 @@ import { type TicketClient } from "./tickets";
 import { type WorkspaceClient } from "./workspaces";
 export type PstdioClient = {
     projects: ProjectClient;
+    /** @deprecated Legacy core ticket client. Ticket data is owned by the pstdio tickets extension. */
     tickets: TicketClient;
     workspaces: WorkspaceClient;
     sessions: SessionClient;
+    /** @deprecated Legacy core ticket status client. Ticket statuses are owned by the pstdio tickets extension. */
     statuses: StatusClient;
+    /** @deprecated Legacy core ticket tag client. Ticket tags are owned by the pstdio tickets extension. */
     tags: TagClient;
     templates: TemplateClient;
     skills: SkillClient;
     agents: AgentClient;
-    actions: ActionClient;
     extensions: ExtensionClient;
     settings: SettingsClient;
     sync: SyncClient;

package/dist/client/index.d.ts

@@ -1,4 +1,3 @@
-export type { ActionClient } from "./actions";
 export type { AgentClient } from "./agents";
 export { createClient, type PstdioClient } from "./client";
 export type { ExtensionClient } from "./extensions";

package/dist/client/index.js

@@ -1,12 +1,3 @@
-// src/client/actions.ts
-var createActionClient = (request) => ({
-  list: (projectId, targetType) => request(targetType ? `/v1/projects/${projectId}/actions?targetType=${targetType}` : `/v1/projects/${projectId}/actions`),
-  execute: (projectId, actionKey, input) => request(`/v1/projects/${projectId}/actions/${encodeURIComponent(actionKey)}/execute`, {
-    method: "POST",
-    body: input
-  })
-});
-
 // src/client/agents.ts
 var createAgentClient = (request) => ({
   list: () => request("/v1/agents"),
@@ -62,8 +53,6 @@ var createProjectClient = (request) => ({
     const query = params.toString();
     return request(`/v1/projects/${projectId}/activity${query ? `?${query}` : ""}`);
   },
-  listPlugins: (projectId) => request(`/v1/projects/${projectId}/plugins`),
-  registerPlugins: (projectId) => request(`/v1/projects/${projectId}/plugins/register`, { method: "POST" }),
   listRepos: (projectId) => request(`/v1/projects/${projectId}/repos`),
   registerRepo: (projectId, input) => request(`/v1/projects/${projectId}/repos`, { method: "POST", body: input }),
   removeRepo: (projectId, repoId) => request(`/v1/projects/${projectId}/repos/${repoId}`, { method: "DELETE" })
@@ -581,7 +570,6 @@ var createClient = (options = {}) => {
     templates: createTemplateClient(request),
     skills: createSkillClient(request),
     agents: createAgentClient(request),
-    actions: createActionClient(request),
     extensions: createExtensionClient(request),
     settings: createSettingsClient(request),
     sync: createSyncClient(options)

package/dist/client/projects.d.ts

@@ -1,25 +1,14 @@
 import type { CreateProjectInput, ListProjectActivityForTicketsInput, ListTicketActivityResponse, RegisterRepoInput, Repo } from "pstdio-api-contracts";
 import type { Project } from "../resources";
 import type { RequestFn } from "./request";
-type RegisteredPlugin = {
-    identity: string;
-    filePath: string;
-};
-type RegisteredPluginsResponse = {
-    plugins: RegisteredPlugin[];
-    pluginsDir: string | null;
-};
 export type ProjectClient = {
     list(): Promise<Project[]>;
     get(projectId: string): Promise<Project>;
     create(input: CreateProjectInput): Promise<Project>;
     delete(projectId: string): Promise<void>;
-    listPlugins(projectId: string): Promise<RegisteredPluginsResponse>;
-    registerPlugins(projectId: string): Promise<RegisteredPluginsResponse>;
     listActivity(projectId: string, input?: ListProjectActivityForTicketsInput): Promise<ListTicketActivityResponse>;
     listRepos(projectId: string): Promise<Repo[]>;
     registerRepo(projectId: string, input: RegisterRepoInput): Promise<Repo>;
     removeRepo(projectId: string, repoId: string): Promise<void>;
 };
 export declare const createProjectClient: (request: RequestFn) => ProjectClient;
-export {};

package/dist/client/statuses.d.ts

@@ -1,6 +1,7 @@
 import type { AttemptStatus, CreateAttemptStatusInput, CreateStatusInput } from "pstdio-api-contracts";
 import type { Status } from "../resources";
 import type { RequestFn } from "./request";
+/** @deprecated Legacy core ticket status client. Ticket statuses are owned by the pstdio tickets extension. */
 export type StatusClient = {
     list(projectId: string): Promise<Status[]>;
     create(projectId: string, input: CreateStatusInput): Promise<Status>;
@@ -19,4 +20,5 @@ export type StatusClient = {
     }): Promise<AttemptStatus>;
     deleteAttemptStatus(projectId: string, statusId: string): Promise<void>;
 };
+/** @deprecated Legacy core ticket status client. Ticket statuses are owned by the pstdio tickets extension. */
 export declare const createStatusClient: (request: RequestFn) => StatusClient;

package/dist/client/tags.d.ts

@@ -1,6 +1,7 @@
 import type { CreateTagInput, CreateTagOptionInput, UpdateTagInput, UpdateTagOptionInput } from "../api/tags";
 import type { Tag, TagOption } from "../resources";
 import type { RequestFn } from "./request";
+/** @deprecated Legacy core ticket tag client. Ticket tags are owned by the pstdio tickets extension. */
 export type TagClient = {
     list(projectId: string): Promise<Tag[]>;
     create(projectId: string, input: CreateTagInput): Promise<Tag>;
@@ -10,4 +11,5 @@ export type TagClient = {
     updateOption(projectId: string, tagId: string, optionId: string, input: UpdateTagOptionInput): Promise<TagOption>;
     deleteOption(projectId: string, tagId: string, optionId: string): Promise<void>;
 };
+/** @deprecated Legacy core ticket tag client. Ticket tags are owned by the pstdio tickets extension. */
 export declare const createTagClient: (request: RequestFn) => TagClient;

package/dist/client/tickets.d.ts

@@ -1,6 +1,7 @@
 import type { CreateTicketAttemptInput, CreateTicketInput, ListProjectActivityForTicketsInput, ListTicketActivityInput, ListTicketActivityResponse, ListTicketsInput, TicketAttemptResponse, UpdateTicketInput, UpdateWhenAttemptStatusInput, UpdateWhenAttemptStatusResponse, UploadTicketFileInput } from "../api/tickets";
 import type { Ticket, TicketDetail, TicketFile, TicketListItem } from "../resources";
 import { type ClientOptions, type RequestFn } from "./request";
+/** @deprecated Legacy core ticket client. Ticket data is owned by the pstdio tickets extension. */
 export type TicketClient = {
     list(projectId: string, input?: ListTicketsInput): Promise<TicketListItem[]>;
     get(ticketId: string): Promise<TicketDetail>;
@@ -19,4 +20,5 @@ export type TicketClient = {
     uploadFile(ticketId: string, input: UploadTicketFileInput): Promise<TicketFile>;
     deleteFile(ticketId: string, fileId: string): Promise<void>;
 };
+/** @deprecated Legacy core ticket client. Ticket data is owned by the pstdio tickets extension. */
 export declare const createTicketClient: (request: RequestFn, options?: ClientOptions) => TicketClient;

package/dist/client/workspaces.d.ts

@@ -4,7 +4,9 @@ import type { RequestFn } from "./request";
 export type WorkspaceClient = {
     list(projectId: string): Promise<WorkspaceListItem[]>;
     getByShorthand(projectId: string, shorthand: string): Promise<Workspace>;
+    /** @deprecated Requires legacy ticket-workspace linkage. Ticket ownership is moving to the pstdio tickets extension. */
     create(input: CreateWorkspaceInput): Promise<Workspace>;
+    /** @deprecated Legacy ticket attempt status mutation. Workspace status automation is extension-owned. */
     updateAttemptStatus(workspaceId: string, input: UpdateAttemptStatusInput): Promise<UpdateAttemptStatusResponse>;
     listActivity(workspaceId: string, input?: ListWorkspaceActivityInput): Promise<ListWorkspaceActivityResponse>;
     removeWorktree(workspaceId: string): Promise<RemoveWorktreeResponse>;

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

@@ -9,7 +9,7 @@ import type { ParamObjectSchema } from "./types/params";
  * @example
  *   export const sayHello = defineCommand({
  *     title: "Say hello",
- *     params: { name: params.text() },
+ *     params: { name: params.text({ required: true }) },
  *     async run(ctx) {
  *       ctx.params.name; // string
  *     },

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

@@ -1,15 +1,58 @@
-import type { ExtensionDefinition } from "./types/extension";
-type ExactExtensionDefinition<TExtension extends ExtensionDefinition> = TExtension & Record<Exclude<keyof TExtension, keyof ExtensionDefinition>, never>;
+import type { ExtensionSettingProperty, ExtensionSettingsContribution } from "./types/contributions";
+import type { CommandDefinition, ExtensionDefinition, HookDefinition, MiddlewareDefinition, ScheduleContribution } from "./types/extension";
+import type { Struct } from "./types/json";
+import type { ParamObjectSchema } from "./types/params";
+type CommandSchemas = Record<string, ParamObjectSchema | undefined>;
+type MiddlewareParams = Record<string, Struct>;
+type MiddlewareResults = Record<string, unknown>;
+type HookPayloads = Record<string, Struct>;
+type EmptyMap = Record<string, never>;
+type SettingProperties = Record<string, ExtensionSettingProperty>;
+type EmptySettings = Record<string, never>;
+type SettingValue<TProperty> = TProperty extends {
+    type: "boolean";
+} ? boolean : TProperty extends {
+    type: "number";
+} ? number : TProperty extends {
+    type: "string";
+} ? string : TProperty extends {
+    type: "array";
+} ? unknown[] : TProperty extends {
+    type: "object";
+} ? Record<string, unknown> : unknown;
+type SettingsMap<TSettings> = TSettings extends {
+    properties: infer TProperties;
+} ? {
+    [K in keyof TProperties & string]: SettingValue<TProperties[K]>;
+} : EmptySettings;
+type CommandDefinitions<TSchemas extends CommandSchemas, TSettings extends Record<string, unknown>> = {
+    [K in keyof TSchemas]: CommandDefinition<TSchemas[K], unknown, TSettings>;
+};
+type MiddlewareDefinitions<TParams extends MiddlewareParams, TResults extends MiddlewareResults> = {
+    [K in keyof TParams]: MiddlewareDefinition<TParams[K], K extends keyof TResults ? TResults[K] : unknown>;
+};
+type HookDefinitions<TPayloads extends HookPayloads> = {
+    [K in keyof TPayloads]: HookDefinition<TPayloads[K]>;
+};
+type ExtensionAuthoringDefinition<TCommandSchemas extends CommandSchemas, TMiddlewareParams extends MiddlewareParams, TMiddlewareResults extends MiddlewareResults, THookPayloads extends HookPayloads, TScheduleParams extends MiddlewareParams, TSettings extends ExtensionSettingsContribution<SettingProperties> | undefined> = Omit<ExtensionDefinition, "commands" | "middlewares" | "hooks" | "schedules" | "settings"> & {
+    settings?: TSettings;
+    commands?: CommandDefinitions<TCommandSchemas, SettingsMap<TSettings>>;
+    middlewares?: MiddlewareDefinitions<TMiddlewareParams, TMiddlewareResults>;
+    hooks?: HookDefinitions<THookPayloads>;
+    schedules?: {
+        [K in keyof TScheduleParams]: ScheduleContribution<TScheduleParams[K]>;
+    };
+};
 /**
- * Identity helper that preserves the literal type of the passed contributions. Authors
- * get full autocomplete on contributions, and `commandsOf(packageName, ext)` can derive typed refs
- * from the returned definition. Extension identity (id, name, version, description,
- * publisher, engines.pstdio) lives in package.json.
+ * 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,
+ * engines.pstdio) lives in package.json.
  *
  * @example
  *   export default defineExtension({
  *     commands: { ... },
  *   });
  */
-export declare const defineExtension: <const TExtension extends ExtensionDefinition>(extension: ExactExtensionDefinition<TExtension>) => TExtension;
+export declare const defineExtension: <const TCommandSchemas extends CommandSchemas = EmptyMap, const TMiddlewareParams extends MiddlewareParams = EmptyMap, const TMiddlewareResults extends MiddlewareResults = MiddlewareResults, const THookPayloads extends HookPayloads = EmptyMap, const TScheduleParams extends MiddlewareParams = EmptyMap, const TSettings extends ExtensionSettingsContribution<SettingProperties> | undefined = undefined>(extension: ExtensionAuthoringDefinition<TCommandSchemas, TMiddlewareParams, TMiddlewareResults, THookPayloads, TScheduleParams, TSettings>) => ExtensionAuthoringDefinition<TCommandSchemas, TMiddlewareParams, TMiddlewareResults, THookPayloads, TScheduleParams, TSettings> & ExtensionDefinition;
 export {};

package/dist/extensions/index.d.ts

@@ -1,11 +1,12 @@
 export { defineCommand, defineHook, defineMiddleware } from "./define-command";
 export { defineExtension } from "./define-extension";
 export { defineExtensionView, type ExtensionViewModule, type ExtensionViewRender, type ExtensionViewRenderContext, type GuestHost, type PropsStore, } from "./define-extension-view";
-export { attemptStatusEvents, gitEvents, projectEvents, projectSlots, sessionEvents, sessionSlots, ticketEvents, workspaceCommands, workspaceEvents, workspaceSlots, worktreeEvents, } from "./kernel-slots";
+export type { AttemptStatusChangePayload, CommitPayload, ConflictPayload, MergePayload, RebasePayload, SessionLifecyclePayload, TicketArchivedEventPayload, TicketLifecyclePayload, TicketStatusChangePayload, WorktreeCreatedEventPayload, WorktreeRemovedPayload, } from "./kernel-slots";
+export { attemptStatusEvents, gitEvents, projectEvents, projectSlots, sessionEvents, sessionSlots, ticketEvents, ticketSlots, workspaceCommands, workspaceEvents, workspaceSlots, worktreeEvents, } from "./kernel-slots";
 export { packageAsset } from "./package-asset";
 export { params } from "./params";
 export { commandEvent, commandRef, commandsOf, eventRef } from "./refs";
-export { defineSlot } from "./slots";
 export type * from "./types";
 export { EXTENSION_API_VERSION } from "./types/extension";
 export { ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES, WEBVIEW_DECLARABLE_CAPABILITIES, WEBVIEW_HOST_CAPABILITIES, WEBVIEW_HOST_CAPABILITY_VERSION, } from "./types/webview-capabilities";
+export { getWorkbenchTargetDefinition, type WorkbenchAttachmentTarget, type WorkbenchContributionKind, type WorkbenchLayoutTarget, type WorkbenchMenuTarget, type WorkbenchModeLayoutTarget, type WorkbenchSettingsScope, type WorkbenchSettingsTarget, type WorkbenchTargetDefinition, type WorkbenchTargetGranularity, type WorkbenchTreeTarget, type WorkbenchViewTarget, workbenchMenuTargets, workbenchModeLayoutTargets, workbenchSettingsScopes, workbenchSettingsTargets, workbenchTargets, workbenchTreeTargets, workbenchViewTargets, } from "./workbench-targets";