@pstdio/sdk 0.9.0 → 0.11.0

package/README.md

@@ -26,6 +26,7 @@ bun add @pstdio/sdk
 | `@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:
 
@@ -35,6 +36,7 @@ import type { CreateTicketInput } from "@pstdio/sdk/api";
 import type { TicketDetail } from "@pstdio/sdk/resources";
 import { renderPrompt } from "@pstdio/sdk/prompts";
 import type { ExtensionDefinition } from "@pstdio/sdk/extensions";
+import type { WorktreeCreateContext } from "@pstdio/sdk/hooks";
 ```
 
 ## HTTP Client
@@ -49,10 +51,7 @@ const client = createClient({
   token: process.env.PSTDIO_API_TOKEN,
 });
 
-const tickets = await client.tickets.list("proj_123", {
-  status: "wip",
-  tag: ["backend", "bug"],
-});
+const projects = await client.projects.list();
 ```
 
 ### Client options
@@ -177,6 +176,18 @@ const extension: ExtensionDefinition = {
 export default extension;
 ```
 
+## Hook Types
+
+`@pstdio/sdk/hooks` exposes the shared context types used by hook runtimes and hook handlers.
+
+```ts
+import type {
+  CommitContext,
+  RebaseContext,
+  WorktreeRemoveContext,
+} from "@pstdio/sdk/hooks";
+```
+
 ## Package Development
 
 From the repo root:

package/dist/api/extensions.d.ts

@@ -1 +1 @@
-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";
+export type { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ModeLayoutContributionRecord, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionTreeRendererRecord, } from "pstdio-api-contracts";

package/dist/api/index.d.ts

@@ -1,11 +1,8 @@
 export type { SetupAgentInput, SetupAvailableAgentsInput, UpdateAgentInput } from "./agents";
-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 { CommandExecuteRequest, CommandExecuteResponse, ExtensionCommandPaletteContribution, ExtensionCommandPaletteResourceRecord, ExtensionCommandRecord, ExtensionDataRendererRecord, ExtensionDiagnostic, ExtensionKeybindingRecord, ExtensionMenuContribution, ExtensionModeRecord, ExtensionNavigationRecord, ExtensionRecord, ExtensionRouteRecord, ExtensionSettingDefinitionRecord, ExtensionSettingsPanelRecord, ExtensionSettingValueRecord, ExtensionTreeItemContribution, ExtensionTreeRendererRecord, ExtensionViewRecord, ListExtensionAppearanceResponse, ListExtensionCommandsResponse, ListExtensionSettingsResponse, ListProjectExtensionsResponse, LocalizableString, ProjectExtensionInstance, UpdateExtensionSettingRequest, UpdateInstalledExtensionTemplateInput, UpdateInstalledExtensionTemplateResponse, WorkbenchExtensionCommandPaletteResourceRecord, WorkbenchExtensionDataRendererRecord, WorkbenchExtensionMetadata, WorkbenchExtensionTreeRendererRecord, } from "./extensions";
 export type { CreateProjectInput, RegisterRepoInput } from "./projects";
 export type { ApprovalInput, CreateSessionInput, FollowUpInput, ResolveSessionIdInput, ResolveSessionIdResponse, SessionConversationResponse, } from "./sessions";
 export type { Settings, UpdateSettingsInput } from "./settings";
 export type { UpdateSkillInput } from "./skills";
-export type { CreateAttemptStatusInput, CreateStatusInput } from "./statuses";
-export type { CreateTagInput, CreateTagOptionInput, UpdateTagInput, UpdateTagOptionInput } from "./tags";
 export type { CreateTemplateInput, UpdateTemplateInput } from "./templates";
-export type { CreateTicketAttemptInput, CreateTicketInput, ListTicketsInput, TicketAttemptMode, TicketAttemptResponse, UpdateTicketInput, UpdateWhenAttemptStatusInput, UpdateWhenAttemptStatusResponse, UploadTicketFileInput, } from "./tickets";
-export type { CreateWorkspaceInput, RemoveWorktreeResponse, UpdateAttemptStatusInput, UpdateAttemptStatusResponse, } from "./workspaces";
+export type { CreateWorkspaceInput, RemoveWorktreeResponse, RenameWorkspaceInput } from "./workspaces";

package/dist/api/workspaces.d.ts

@@ -1,10 +1,6 @@
-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. */
+import type { CreateWorkspaceInput as ContractCreateWorkspaceInput, ListWorkspaceActivityInput as ContractListWorkspaceActivityInput, ListWorkspaceActivityResponse as ContractListWorkspaceActivityResponse, RemoveWorktreeResponse as ContractRemoveWorktreeResponse, RenameWorkspaceInput as ContractRenameWorkspaceInput } from "pstdio-api-contracts";
 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;
+export type RenameWorkspaceInput = ContractRenameWorkspaceInput;

package/dist/client/client.d.ts

@@ -5,22 +5,13 @@ import type { ClientOptions } from "./request";
 import { type SessionClient } from "./sessions";
 import { type SettingsClient } from "./settings";
 import { type SkillClient } from "./skills";
-import { type StatusClient } from "./statuses";
 import { type SyncClient } from "./sync";
-import { type TagClient } from "./tags";
 import { type TemplateClient } from "./templates";
-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;

package/dist/client/index.d.ts

@@ -7,9 +7,6 @@ export type { ListSessionsInput, SessionClient, SessionStreamConnection, Session
 export type { SettingsClient } from "./settings";
 export type { SkillClient } from "./skills";
 export type { SseEvent } from "./sse";
-export type { StatusClient } from "./statuses";
 export { applySyncEvent, parseSyncDeleteEvent, type StartSyncInput, type SyncClient, type SyncConnection, type SyncRow, type SyncWriter, type SyncWriterProvider, } from "./sync";
-export type { TagClient } from "./tags";
 export type { TemplateClient } from "./templates";
-export type { TicketClient } from "./tickets";
 export type { WorkspaceClient } from "./workspaces";

package/dist/client/index.js

@@ -107,19 +107,32 @@ var createRequestHeaders = (options, reqOpts = {}) => {
     headers.set("authorization", `Bearer ${options.token}`);
   return headers;
 };
+var isBinaryBody = (body) => body instanceof ArrayBuffer || ArrayBuffer.isView(body);
+var serializeRequestBody = (body) => {
+  if (body instanceof ArrayBuffer)
+    return body;
+  if (ArrayBuffer.isView(body)) {
+    if (body.buffer instanceof ArrayBuffer)
+      return body;
+    const copy = new Uint8Array(body.byteLength);
+    copy.set(new Uint8Array(body.buffer, body.byteOffset, body.byteLength));
+    return copy;
+  }
+  return JSON.stringify(body);
+};
 var createRequest = (options) => {
   const baseUrl = resolveBaseUrl(options);
   const fetchFn = resolveFetch(options);
   return async (path, reqOpts = {}) => {
     const headers = createRequestHeaders(options, {
       headers: reqOpts.headers,
-      hasJsonBody: reqOpts.body !== undefined
+      hasJsonBody: reqOpts.body !== undefined && !isBinaryBody(reqOpts.body)
     });
     const url = resolveClientUrl(baseUrl, path);
     const response = await fetchFn(url, {
       method: reqOpts.method ?? "GET",
       headers: Object.fromEntries(headers.entries()),
-      body: reqOpts.body !== undefined ? JSON.stringify(reqOpts.body) : undefined,
+      body: reqOpts.body !== undefined ? serializeRequestBody(reqOpts.body) : undefined,
       signal: reqOpts.signal,
       cache: reqOpts.cache
     });
@@ -288,19 +301,6 @@ var createSkillClient = (request) => ({
   updatePreferences: (projectId, skillName, input) => request(`/v1/projects/${projectId}/skills/${skillName}`, { method: "PUT", body: input })
 });
 
-// src/client/statuses.ts
-var createStatusClient = (request) => ({
-  list: (projectId) => request(`/v1/projects/${projectId}/statuses`),
-  create: (projectId, input) => request(`/v1/projects/${projectId}/statuses`, { method: "POST", body: input }),
-  update: (projectId, statusId, input) => request(`/v1/projects/${projectId}/statuses/${statusId}`, { method: "PATCH", body: input }),
-  setDefault: (projectId, statusId) => request(`/v1/projects/${projectId}/statuses/${statusId}/set-default`, { method: "PATCH" }),
-  delete: (projectId, statusId) => request(`/v1/projects/${projectId}/statuses/${statusId}`, { method: "DELETE" }),
-  listAttemptStatuses: (projectId) => request(`/v1/projects/${projectId}/attempt-statuses`),
-  createAttemptStatus: (projectId, input) => request(`/v1/projects/${projectId}/attempt-statuses`, { method: "POST", body: input }),
-  updateAttemptStatus: (projectId, statusId, input) => request(`/v1/projects/${projectId}/attempt-statuses/${statusId}`, { method: "PATCH", body: input }),
-  deleteAttemptStatus: (projectId, statusId) => request(`/v1/projects/${projectId}/attempt-statuses/${statusId}`, { method: "DELETE" })
-});
-
 // src/client/sync.ts
 var DEFAULT_HEARTBEAT_INTERVAL_MS = 1e4;
 var DEFAULT_HEARTBEAT_THRESHOLD = 3;
@@ -432,17 +432,6 @@ var createSyncClient = (clientOptions) => ({
   }
 });
 
-// src/client/tags.ts
-var createTagClient = (request) => ({
-  list: (projectId) => request(`/v1/projects/${projectId}/ticket-tags`),
-  create: (projectId, input) => request(`/v1/projects/${projectId}/ticket-tags`, { method: "POST", body: input }),
-  update: (projectId, tagId, input) => request(`/v1/projects/${projectId}/ticket-tags/${tagId}`, { method: "PATCH", body: input }),
-  delete: (projectId, tagId) => request(`/v1/projects/${projectId}/ticket-tags/${tagId}`, { method: "DELETE" }),
-  createOption: (projectId, tagId, input) => request(`/v1/projects/${projectId}/ticket-tags/${tagId}/options`, { method: "POST", body: input }),
-  updateOption: (projectId, tagId, optionId, input) => request(`/v1/projects/${projectId}/ticket-tags/${tagId}/options/${optionId}`, { method: "PATCH", body: input }),
-  deleteOption: (projectId, tagId, optionId) => request(`/v1/projects/${projectId}/ticket-tags/${tagId}/options/${optionId}`, { method: "DELETE" })
-});
-
 // src/client/templates.ts
 var createTemplateClient = (request) => ({
   list: (projectId) => request(`/v1/projects/${projectId}/templates`),
@@ -452,86 +441,6 @@ var createTemplateClient = (request) => ({
   delete: (projectId, templateId) => request(`/v1/projects/${projectId}/templates/${templateId}`, { method: "DELETE" })
 });
 
-// src/client/tickets.ts
-var resolveBaseUrl2 = (options) => options.baseUrl ?? (typeof process !== "undefined" ? process.env.PSTDIO_API_URL : undefined) ?? "http://localhost:19840";
-var readErrorMessage2 = async (response) => {
-  const errorBody = await response.json().catch(() => null);
-  if (errorBody && typeof errorBody === "object" && errorBody !== null && "error" in errorBody) {
-    return String(errorBody.error);
-  }
-  return `Request failed: ${response.status}`;
-};
-var buildTicketsQuery = (projectId, input = {}) => {
-  const params = new URLSearchParams({ project_id: projectId });
-  if (input.status)
-    params.append("status", input.status);
-  if (Array.isArray(input.tag)) {
-    for (const tag of input.tag)
-      params.append("tag", tag);
-  } else if (input.tag) {
-    params.append("tag", input.tag);
-  }
-  if (input.archived !== undefined)
-    params.append("archived", String(input.archived));
-  if (input.draft !== undefined)
-    params.append("draft", String(input.draft));
-  if (input.parent_id)
-    params.append("parent_id", input.parent_id);
-  if (input.shorthand)
-    params.append("shorthand", input.shorthand);
-  if (input.search)
-    params.append("search", input.search);
-  return params.toString();
-};
-var buildActivityQuery = (input = {}) => {
-  const params = new URLSearchParams;
-  if (input.resource_type)
-    params.append("resource_type", input.resource_type);
-  if (input.event_type)
-    params.append("event_type", input.event_type);
-  if (input.from)
-    params.append("from", input.from);
-  if (input.to)
-    params.append("to", input.to);
-  if (input.cursor)
-    params.append("cursor", input.cursor);
-  if (input.limit !== undefined)
-    params.append("limit", String(input.limit));
-  return params.toString();
-};
-var createTicketClient = (request, options = {}) => ({
-  list: (projectId, input) => request(`/v1/tickets?${buildTicketsQuery(projectId, input)}`),
-  get: (ticketId) => request(`/v1/tickets/${ticketId}`),
-  create: (input) => request("/v1/tickets", { method: "POST", body: input }),
-  update: (ticketId, input) => request(`/v1/tickets/${ticketId}`, { method: "PATCH", body: input }),
-  delete: (ticketId) => request(`/v1/tickets/${ticketId}`, { method: "DELETE" }),
-  createAttempt: (ticketId, input) => request(`/v1/tickets/${ticketId}/attempts`, { method: "POST", body: input }),
-  listActivity: (ticketId, input) => {
-    const query = buildActivityQuery(input);
-    return request(`/v1/tickets/${ticketId}/activity${query ? `?${query}` : ""}`);
-  },
-  listProjectActivity: (projectId, input) => {
-    const query = buildActivityQuery(input);
-    return request(`/v1/projects/${projectId}/activity${query ? `?${query}` : ""}`);
-  },
-  updateWhenAttemptStatus: (ticketId, input) => request(`/v1/tickets/${ticketId}/update-when-attempt-status`, { method: "POST", body: input }),
-  listFiles: (ticketId) => request(`/v1/tickets/${ticketId}/files`),
-  getFileContent: async (ticketId, fileId, requestOptions = {}) => {
-    const baseUrl = resolveBaseUrl2(options);
-    const fetchFn = options.fetch ?? globalThis.fetch;
-    const headers = {};
-    if (options.token)
-      headers.authorization = `Bearer ${options.token}`;
-    const response = await fetchFn(`${baseUrl}/v1/tickets/${encodeURIComponent(ticketId)}/files/${encodeURIComponent(fileId)}/content`, { cache: requestOptions.cache, headers, signal: requestOptions.signal });
-    if (!response.ok) {
-      throw new PstdioApiError(await readErrorMessage2(response), response.status);
-    }
-    return new Uint8Array(await response.arrayBuffer());
-  },
-  uploadFile: (ticketId, input) => request(`/v1/tickets/${ticketId}/files`, { method: "POST", body: input }),
-  deleteFile: (ticketId, fileId) => request(`/v1/tickets/${ticketId}/files/${fileId}`, { method: "DELETE" })
-});
-
 // src/client/workspaces.ts
 var createWorkspaceClient = (request) => ({
   listActivity: (workspaceId, input = {}) => {
@@ -552,7 +461,7 @@ var createWorkspaceClient = (request) => ({
   list: (projectId) => request(`/v1/workspaces?project_id=${projectId}`),
   getByShorthand: (projectId, shorthand) => request(`/v1/workspaces/by-shorthand?project_id=${encodeURIComponent(projectId)}&shorthand=${encodeURIComponent(shorthand)}`),
   create: (input) => request("/v1/workspaces", { method: "POST", body: input }),
-  updateAttemptStatus: (workspaceId, input) => request(`/v1/workspaces/${workspaceId}/attempt-status`, { method: "PATCH", body: input }),
+  rename: (workspaceId, input) => request(`/v1/workspaces/${workspaceId}`, { method: "PATCH", body: input }),
   removeWorktree: (workspaceId) => request(`/v1/workspaces/${workspaceId}/remove-worktree`, { method: "POST" }),
   delete: (workspaceId) => request(`/v1/workspaces/${workspaceId}`, { method: "DELETE" })
 });
@@ -562,11 +471,8 @@ var createClient = (options = {}) => {
   const request = createRequest(options);
   return {
     projects: createProjectClient(request),
-    tickets: createTicketClient(request, options),
     workspaces: createWorkspaceClient(request),
     sessions: createSessionClient(request, options),
-    statuses: createStatusClient(request),
-    tags: createTagClient(request),
     templates: createTemplateClient(request),
     skills: createSkillClient(request),
     agents: createAgentClient(request),

package/dist/client/projects.d.ts

@@ -1,4 +1,4 @@
-import type { CreateProjectInput, ListProjectActivityForTicketsInput, ListTicketActivityResponse, RegisterRepoInput, Repo } from "pstdio-api-contracts";
+import type { CreateProjectInput, ListActivityResponse, ListProjectActivityInput, RegisterRepoInput, Repo } from "pstdio-api-contracts";
 import type { Project } from "../resources";
 import type { RequestFn } from "./request";
 export type ProjectClient = {
@@ -6,7 +6,7 @@ export type ProjectClient = {
     get(projectId: string): Promise<Project>;
     create(input: CreateProjectInput): Promise<Project>;
     delete(projectId: string): Promise<void>;
-    listActivity(projectId: string, input?: ListProjectActivityForTicketsInput): Promise<ListTicketActivityResponse>;
+    listActivity(projectId: string, input?: ListProjectActivityInput): Promise<ListActivityResponse>;
     listRepos(projectId: string): Promise<Repo[]>;
     registerRepo(projectId: string, input: RegisterRepoInput): Promise<Repo>;
     removeRepo(projectId: string, repoId: string): Promise<void>;

package/dist/client/workspaces.d.ts

@@ -1,13 +1,11 @@
-import type { CreateWorkspaceInput, ListWorkspaceActivityInput, ListWorkspaceActivityResponse, RemoveWorktreeResponse, UpdateAttemptStatusInput, UpdateAttemptStatusResponse } from "pstdio-api-contracts";
+import type { CreateWorkspaceInput, ListWorkspaceActivityInput, ListWorkspaceActivityResponse, RemoveWorktreeResponse, RenameWorkspaceInput } from "pstdio-api-contracts";
 import type { Workspace, WorkspaceListItem } from "../resources";
 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>;
+    rename(workspaceId: string, input: RenameWorkspaceInput): Promise<Workspace>;
     listActivity(workspaceId: string, input?: ListWorkspaceActivityInput): Promise<ListWorkspaceActivityResponse>;
     removeWorktree(workspaceId: string): Promise<RemoveWorktreeResponse>;
     delete(workspaceId: string): Promise<void>;

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

@@ -0,0 +1,5 @@
+import type { CommandOutcome } from "./types";
+export type CommandResponse<TResult = unknown> = {
+    outcome: CommandOutcome<TResult>;
+};
+export declare const unwrapCommandOutcome: <TResult>(response: CommandResponse<TResult>, fallbackReason?: string) => TResult;

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

@@ -15,10 +15,35 @@ export type PropsStore<TProps = unknown> = {
     get: () => TProps;
     subscribe: (listener: (props: TProps) => void) => () => void;
 };
+export interface WebviewFilesClient {
+    pick(opts?: {
+        accept?: string;
+        multiple?: boolean;
+    }): Promise<File[]>;
+    upload(input: {
+        name: string;
+        data: Uint8Array | ArrayBuffer;
+        mimeType?: string;
+        scope?: {
+            type: string;
+            id?: string;
+        };
+    }): Promise<import("./types/webview-capabilities").ExtensionBlobRef>;
+    list(input?: {
+        scope?: {
+            type: string;
+            id?: string;
+        };
+    }): Promise<import("./types/webview-capabilities").ExtensionBlobRef[]>;
+    delete(id: string): Promise<void>;
+}
 export type ExtensionViewRenderContext<TProps = unknown> = {
     mount: HTMLElement;
     host: GuestHost;
+    files: WebviewFilesClient;
     propsStore: PropsStore<TProps>;
+    locale: string;
+    t: (key: string, defaultValue?: string, args?: Record<string, unknown>) => string;
 };
 export type ExtensionViewRender<TProps = unknown> = (context: ExtensionViewRenderContext<TProps>) => void | (() => void) | Promise<void | (() => void)>;
 export type ExtensionViewModule<TProps = unknown> = {

package/dist/extensions/index.d.ts

@@ -1,12 +1,15 @@
+export { type CommandResponse, unwrapCommandOutcome } from "./command-outcome";
 export { defineCommand, defineHook, defineMiddleware } from "./define-command";
 export { defineExtension } from "./define-extension";
-export { defineExtensionView, type ExtensionViewModule, type ExtensionViewRender, type ExtensionViewRenderContext, type GuestHost, type PropsStore, } from "./define-extension-view";
-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 { defineExtensionView, type ExtensionViewModule, type ExtensionViewRender, type ExtensionViewRenderContext, type GuestHost, type PropsStore, type WebviewFilesClient, } from "./define-extension-view";
+export type { CommitPayload, ConflictPayload, MergePayload, RebasePayload, SessionLifecyclePayload, WorktreeCreatedEventPayload, WorktreeRemovedPayload, } from "./kernel-slots";
+export { gitEvents, projectEvents, projectSlots, sessionEvents, sessionSlots, workspaceEvents, workspaceSlots, worktreeEvents, } from "./kernel-slots";
+export { isLocalizedString, type Localizable, type LocalizedString, l10n } from "./l10n";
 export { packageAsset } from "./package-asset";
 export { params } from "./params";
 export { commandEvent, commandRef, commandsOf, eventRef } from "./refs";
 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 { matchesResourceWhen } from "./when";
 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";

package/dist/extensions/index.js

@@ -1,3 +1,11 @@
+// src/extensions/command-outcome.ts
+var unwrapCommandOutcome = (response, fallbackReason = "Command failed.") => {
+  const { outcome } = response;
+  if (outcome.status !== "success") {
+    throw new Error(outcome.reason || fallbackReason);
+  }
+  return outcome.value;
+};
 // src/extensions/define-command.ts
 var defineCommand = (definition) => definition;
 var defineMiddleware = (definition) => definition;
@@ -5,9 +13,66 @@ var defineHook = (definition) => definition;
 // src/extensions/define-extension.ts
 var defineExtension = (extension) => extension;
 // src/extensions/define-extension-view.ts
+var pickFiles = (opts = {}) => new Promise((resolve, reject) => {
+  const input = document.createElement("input");
+  input.type = "file";
+  input.accept = opts.accept ?? "";
+  input.multiple = opts.multiple ?? false;
+  input.style.display = "none";
+  input.addEventListener("change", () => {
+    const files = input.files ? Array.from(input.files) : [];
+    input.remove();
+    resolve(files);
+  });
+  input.addEventListener("cancel", () => {
+    input.remove();
+    resolve([]);
+  });
+  input.addEventListener("error", () => {
+    input.remove();
+    reject(new Error("Could not pick files."));
+  });
+  document.body.appendChild(input);
+  input.click();
+});
+var createFilesClient = (host) => ({
+  pick: pickFiles,
+  upload: (input) => host.call("files.upload", input),
+  list: async (input) => {
+    const response = await host.call("files.list", input ?? {});
+    return response.files ?? [];
+  },
+  delete: (id) => host.call("files.delete", { id })
+});
+var readTranslationProps = (props) => {
+  const translations = typeof props === "object" && props !== null && "translations" in props ? props.translations : undefined;
+  if (typeof translations !== "object" || translations === null)
+    return null;
+  return translations;
+};
+var interpolate = (value, args) => Object.entries(args ?? {}).reduce((next, [key, replacement]) => next.replaceAll(`{{${key}}}`, String(replacement)), value);
+var createTranslationApi = (propsStore) => {
+  const locale = () => readTranslationProps(propsStore.get())?.locale ?? "en";
+  const t = (key, defaultValue, args) => {
+    const translations = readTranslationProps(propsStore.get());
+    const value = translations?.bundle?.[key] ?? translations?.defaultBundle?.[key] ?? defaultValue ?? key;
+    return interpolate(value, args);
+  };
+  return { locale, t };
+};
 var defineExtensionView = (definition) => ({
   mount: async (mount, host, propsStore) => {
-    const cleanup = await definition.render({ mount, host, propsStore });
+    const translations = createTranslationApi(propsStore);
+    const cleanup = await definition.render({
+      mount,
+      host,
+      files: createFilesClient(host),
+      propsStore,
+      get locale() {
+        return translations.locale();
+      },
+      t: translations.t
+    });
     return typeof cleanup === "function" ? cleanup : () => {};
   }
 });
@@ -40,7 +105,6 @@ var projectSlots = {
   sidebar: defineSlot("project.sidebar", { kind: "view" }),
   headerPrimary: defineSlot("project.headerPrimary", { kind: "menu" }),
   headerOverflow: defineSlot("project.headerOverflow", { kind: "menu" }),
-  commandPanel: defineSlot("project.commandPanel", { kind: "menu" }),
   settingsPanels: defineSlot("project.settingsPanels", { kind: "settings" })
 };
 var sessionSlots = {
@@ -48,10 +112,6 @@ 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" }),
@@ -68,12 +128,6 @@ var sessionEvents = {
   failed: eventRef("session.failed"),
   completed: eventRef("session.completed")
 };
-var ticketEvents = {
-  created: eventRef("ticket.created"),
-  statusChanged: eventRef("ticket.statusChanged"),
-  archived: eventRef("ticket.archived"),
-  deleted: eventRef("ticket.deleted")
-};
 var workspaceEvents = {
   created: eventRef("workspace.created"),
   archived: eventRef("workspace.archived"),
@@ -89,12 +143,12 @@ var gitEvents = {
   merged: eventRef("git.merged"),
   conflicted: eventRef("git.conflicted")
 };
-var attemptStatusEvents = {
-  changed: eventRef("attemptStatus.changed")
-};
-var workspaceCommands = {
-  setAttemptStatus: commandRef("kernel.workspace.setAttemptStatus")
-};
+// src/extensions/l10n.ts
+var l10n = (key, defaultValue) => ({
+  $l10n: key,
+  ...defaultValue === undefined ? {} : { default: defaultValue }
+});
+var isLocalizedString = (value) => typeof value === "object" && value !== null && ("$l10n" in value) && typeof value.$l10n === "string";
 // src/extensions/package-asset.ts
 var packageAsset = (path, baseUrl) => ({
   kind: "package-asset",
@@ -124,7 +178,8 @@ var params = {
     templateType: options.type
   }),
   resource: (options) => ({ type: "resource", ...options }),
-  json: (options) => ({ type: "json", ...options })
+  json: (options) => ({ type: "json", ...options }),
+  list: (options) => ({ type: "list", ...options })
 };
 // src/extensions/types/extension.ts
 var EXTENSION_API_VERSION = "1.0.0";
@@ -139,19 +194,25 @@ var WEBVIEW_DECLARABLE_CAPABILITIES = [
   "extension.settings.all",
   "extension.settings.get",
   "extension.settings.set",
-  "extension.settings.delete"
+  "extension.settings.delete",
+  "files.upload",
+  "files.list",
+  "files.delete"
 ];
 var ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES = ["host.dispatchKeyboardEvent"];
 var WEBVIEW_HOST_CAPABILITIES = [
   ...WEBVIEW_DECLARABLE_CAPABILITIES,
   ...ALWAYS_AVAILABLE_WEBVIEW_CAPABILITIES
 ];
+// src/extensions/when.ts
+var matchesResourceWhen = (when, resourceType) => {
+  const resourceTypes = when?.resourceType;
+  if (!resourceTypes?.length)
+    return true;
+  return resourceType ? resourceTypes.includes(resourceType) : false;
+};
 // src/extensions/workbench-targets.ts
-var workbenchMenuTargets = [
-  "workbench.top.actions",
-  "workbench.top.overflow",
-  "workbench.commandPalette"
-];
+var workbenchMenuTargets = ["workbench.nav.actions", "workbench.nav.overflow"];
 var workbenchTreeTargets = [
   "workbench.left.tree",
   "workbench.main.left.tree",
@@ -161,7 +222,7 @@ var workbenchViewTargets = [
   "workbench.main",
   "workbench.main.left",
   "workbench.main.right",
-  "workbench.main.bottom"
+  "workbench.secondary"
 ];
 var workbenchSettingsTargets = ["workbench.settings"];
 var workbenchSettingsScopes = ["project", "global"];
@@ -170,26 +231,20 @@ var workbenchModeLayoutTargets = [
   "workbench.main.left",
   "workbench.main",
   "workbench.main.right",
-  "workbench.main.bottom"
+  "workbench.secondary"
 ];
 var workbenchTargets = [
   {
-    id: "workbench.top.actions",
-    allowedKinds: ["menu"],
-    granularity: "surface",
-    rationale: "Primary command surface in the host-owned top workbench chrome."
-  },
-  {
-    id: "workbench.top.overflow",
+    id: "workbench.nav.actions",
     allowedKinds: ["menu"],
     granularity: "surface",
-    rationale: "Secondary command surface in the host-owned top workbench chrome."
+    rationale: "Primary command surface in the host-owned nav (top) workbench chrome."
   },
   {
-    id: "workbench.commandPalette",
+    id: "workbench.nav.overflow",
     allowedKinds: ["menu"],
     granularity: "surface",
-    rationale: "Global command discovery surface owned by the workbench."
+    rationale: "Secondary command surface in the host-owned nav (top) workbench chrome."
   },
   {
     id: "workbench.left.tree",
@@ -228,10 +283,10 @@ var workbenchTargets = [
     rationale: "Direct extension view placement in the main-right area."
   },
   {
-    id: "workbench.main.bottom",
+    id: "workbench.secondary",
     allowedKinds: ["view"],
     granularity: "area",
-    rationale: "Direct extension view placement in the main-bottom area."
+    rationale: "Direct extension view placement in the secondary area."
   },
   {
     id: "workbench.settings",
@@ -245,7 +300,6 @@ export {
   worktreeEvents,
   workspaceSlots,
   workspaceEvents,
-  workspaceCommands,
   workbenchViewTargets,
   workbenchTreeTargets,
   workbenchTargets,
@@ -253,14 +307,16 @@ export {
   workbenchSettingsScopes,
   workbenchModeLayoutTargets,
   workbenchMenuTargets,
-  ticketSlots,
-  ticketEvents,
+  unwrapCommandOutcome,
   sessionSlots,
   sessionEvents,
   projectSlots,
   projectEvents,
   params,
   packageAsset,
+  matchesResourceWhen,
+  l10n,
+  isLocalizedString,
   gitEvents,
   getWorkbenchTargetDefinition,
   eventRef,
@@ -272,7 +328,6 @@ export {
   commandsOf,
   commandRef,
   commandEvent,
-  attemptStatusEvents,
   WEBVIEW_HOST_CAPABILITY_VERSION,
   WEBVIEW_HOST_CAPABILITIES,
   WEBVIEW_DECLARABLE_CAPABILITIES,