@pstdio/sdk 0.10.0 → 0.11.0

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

@@ -1,10 +1,5 @@
-import type { ExtensionTicket, ExtensionWorkspace, SetAttemptStatusInput, SetAttemptStatusResult } from "./types/context";
+import type { ExtensionWorkspace } 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: ExtensionTicket;
-}
 export interface WorktreeCreatedEventPayload {
     projectId: string;
     repoPath: string;
@@ -12,33 +7,7 @@ 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: ExtensionTicket;
-}
-/** @deprecated Legacy core ticket event payload. Ticket events are owned by the pstdio tickets extension. */
-export interface TicketStatusChangePayload {
-    projectId: string;
-    ticket: ExtensionTicket;
-    fromStatus: string | null;
-    toStatus: string | null;
-}
-export interface AttemptStatusChangePayload {
-    projectId: string;
-    workspaceId: string;
-    /** @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: ExtensionWorkspace;
+    anchors?: ResourceAnchor[];
 }
 export interface SessionLifecyclePayload {
     projectId: string;
@@ -49,9 +18,7 @@ export interface SessionLifecyclePayload {
     workspaceId?: string;
     worktreePath?: string;
     branch?: string;
-    /** @deprecated Legacy ticket session linkage. Ticket data is owned by the pstdio tickets extension. */
-    ticket?: ExtensionTicket;
-    attemptStatus?: string;
+    anchors?: ResourceAnchor[];
 }
 export interface WorktreeRemovedPayload {
     projectId: string;
@@ -59,8 +26,7 @@ export interface WorktreeRemovedPayload {
     worktreePath: string;
     workspace?: ExtensionWorkspace;
     workspaceId?: string;
-    /** @deprecated Legacy ticket worktree linkage. Ticket data is owned by the pstdio tickets extension. */
-    ticket?: ExtensionTicket | string;
+    anchors?: ResourceAnchor[];
 }
 export interface CommitPayload {
     projectId: string;
@@ -69,8 +35,7 @@ export interface CommitPayload {
     branch?: string;
     commitSha?: string;
     workspace?: ExtensionWorkspace;
-    /** @deprecated Legacy ticket git linkage. Ticket data is owned by the pstdio tickets extension. */
-    ticket?: ExtensionTicket | string;
+    anchors?: ResourceAnchor[];
 }
 export interface RebasePayload {
     projectId: string;
@@ -78,7 +43,7 @@ export interface RebasePayload {
     worktreePath?: string;
     branch?: string;
     workspace?: ExtensionWorkspace;
-    ticket?: ExtensionTicket | string;
+    anchors?: ResourceAnchor[];
 }
 export interface MergePayload extends CommitPayload {
 }
@@ -89,14 +54,12 @@ export interface ConflictPayload {
     worktreePath?: string;
     branch?: string;
     workspace?: ExtensionWorkspace;
-    /** @deprecated Legacy ticket git linkage. Ticket data is owned by the pstdio tickets extension. */
-    ticket?: ExtensionTicket | string;
+    anchors?: ResourceAnchor[];
 }
 export declare const projectSlots: {
     sidebar: import("./types").SlotRef<object, "view">;
     headerPrimary: import("./types").SlotRef<object, "menu">;
     headerOverflow: import("./types").SlotRef<object, "menu">;
-    commandPanel: import("./types").SlotRef<object, "menu">;
     settingsPanels: import("./types").SlotRef<object, "settings">;
 };
 export declare const sessionSlots: {
@@ -104,11 +67,6 @@ 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">;
@@ -131,13 +89,6 @@ 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>;
-    archived: import("./types").EventRef<TicketArchivedEventPayload>;
-    deleted: import("./types").EventRef<TicketLifecyclePayload>;
-};
 export declare const workspaceEvents: {
     created: import("./types").EventRef<{
         workspace: ExtensionWorkspace;
@@ -159,10 +110,3 @@ 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>;
-};
-export declare const workspaceCommands: {
-    setAttemptStatus: import("./types").CommandRef<SetAttemptStatusInput, SetAttemptStatusResult>;
-};

package/dist/extensions/l10n.d.ts

@@ -0,0 +1,10 @@
+export interface LocalizedString {
+    readonly $l10n: string;
+    readonly default?: string;
+}
+export type Localizable<T extends string = string> = T | LocalizedString;
+export declare const l10n: (key: string, defaultValue?: string) => {
+    default?: string | undefined;
+    $l10n: string;
+};
+export declare const isLocalizedString: (value: unknown) => value is LocalizedString;

package/dist/extensions/params.d.ts

@@ -1,4 +1,4 @@
-import type { BooleanParam, HarnessParam, JsonParam, LongTextParam, MultiSelectParam, NumberParam, RepoParam, ResourceParam, SelectParam, TemplateParam, TextParam } from "./types/params";
+import type { BooleanParam, HarnessParam, JsonParam, ListParam, LongTextParam, MultiSelectParam, NumberParam, RepoParam, ResourceParam, SelectParam, TemplateParam, TextParam } from "./types/params";
 type RequiredOf<TOptions> = TOptions extends {
     required: infer TRequired extends boolean;
 } ? TRequired : undefined;
@@ -29,5 +29,6 @@ export declare const params: {
     }>(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>>;
+    list: <const TOptions extends ParamOptions<ListParam> | undefined = undefined>(options?: TOptions) => ListParam<RequiredOf<TOptions>>;
 };
 export {};

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

@@ -1,3 +1,4 @@
+import type { SessionStatus } from "pstdio-api-contracts";
 import type { CommandHelpersApi, CommandInvocation, CommandMiddlewareResult, CommandNotice, CommandSource, WorkbenchAttachmentInvocationContext } from "./commands";
 import type { EventDeliveryResult, EventRef } from "./events";
 import type { JsonObject, MaybePromise, Struct } from "./json";
@@ -11,26 +12,51 @@ export interface ExtensionStorageCollectionApi<TItem = unknown> {
         id: string;
     }>;
     delete(id: string): Promise<void>;
+    attachments(itemId: string): ExtensionBlobsApi;
 }
 export type StorageScope = {
     type: "project";
 } | {
     type: "repo";
-    repoId?: string;
+    repoId: string;
 } | {
     type: "resource";
-    resource?: ResourceRef;
+    resource: ResourceRef;
 } | {
     type: string;
-    id?: string;
+    id: string;
 };
 export interface ExtensionStorageApi {
     scope(scope: StorageScope): ExtensionStorageApi;
+    files: ExtensionBlobsApi;
     get<T = unknown>(key: string): Promise<T | undefined>;
     set<T = unknown>(key: string, value: T): Promise<void>;
     delete(key: string): Promise<void>;
     collection<TItem = unknown>(name: string): ExtensionStorageCollectionApi<TItem>;
 }
+export interface ExtensionBlobRef {
+    id: string;
+    name: string;
+    mimeType: string | null;
+    size: number;
+    hash: string | null;
+    url: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ExtensionBlobInput {
+    name: string;
+    data: Uint8Array | ArrayBuffer;
+    mimeType?: string | null;
+}
+export interface ExtensionBlobsApi {
+    put(input: ExtensionBlobInput): Promise<ExtensionBlobRef>;
+    get(id: string): Promise<ExtensionBlobRef | undefined>;
+    getBytes(id: string): Promise<Uint8Array>;
+    list(): Promise<ExtensionBlobRef[]>;
+    delete(id: string): Promise<void>;
+    urlFor(id: string): string;
+}
 export interface ArtifactFile {
     path: string;
     size?: number;
@@ -61,7 +87,21 @@ export interface ExtensionFilesApi {
     }>;
     delete(fileId: string): Promise<void>;
 }
+export interface ExtensionSessionResource {
+    type: "session";
+    id: string;
+    title: string;
+    status: SessionStatus;
+}
 export interface ExtensionSessionsApi {
+    get(id: string): Promise<{
+        id: string;
+        title: string;
+        status?: string;
+        original_session_id?: string | null;
+        cwd?: string | null;
+        anchors_json?: ResourceAnchor[];
+    } | null>;
     create(input: {
         title: string;
         prompt?: string;
@@ -72,9 +112,7 @@ export interface ExtensionSessionsApi {
         repoId?: string;
         anchors?: ResourceAnchor[];
         originalSessionId?: string;
-    }): Promise<{
-        id: string;
-    }>;
+    }): Promise<ExtensionSessionResource>;
     followup(input: {
         sessionId: string;
         prompt?: string;
@@ -86,204 +124,32 @@ export interface ExtensionHarnessInput {
     harnessId: string;
     model?: string;
 }
-/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
-export interface ExtensionTicket {
-    id: string;
-    shorthand: string;
-    created_at?: string;
-    updated_at?: string;
-    display_title?: string | null;
-    displayTitle?: string | null;
-    user_prompt?: string | null;
-    userPrompt?: string | null;
-    parent_id?: string | null;
-    parentId?: string | null;
-    draft?: boolean;
-    archived?: boolean;
-    status_id?: string | null;
-    status?: string | null;
-    status_name?: string | null;
-    tag_ids?: string[];
-    tag_names?: string[];
-    tagIds?: string[];
-    tagNames?: string[];
-    file_id?: string | null;
-    fileId?: string | null;
-    fileIds?: string[];
-}
-/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
-export interface ExtensionTicketFile {
-    id: string;
-    file_name?: string | null;
-    fileName?: string | null;
-    file_kind?: string | null;
-    fileKind?: string | null;
-    mime_type?: string | null;
-    mimeType?: string | null;
-    created_at?: string;
-    updated_at?: string;
-}
-/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
-export interface ExtensionTicketListInput {
-    status?: string;
-    tag?: string | string[];
-    archived?: boolean;
-    draft?: boolean;
-    parentId?: string;
-    shorthand?: string;
-    search?: string;
-}
 export interface ExtensionWorkspace {
     id: string;
+    name?: string;
     project_id?: string;
     workspace_shorthand?: string;
-    /** @deprecated Legacy ticket-workspace linkage. Ticket data is owned by the pstdio tickets extension. */
-    ticket_id?: string | null;
-    /** @deprecated Legacy ticket-workspace linkage. Ticket data is owned by the pstdio tickets extension. */
-    ticket_shorthand?: string | null;
     branch?: string | null;
     worktree_path?: string | null;
-    attempt_status_id?: string | null;
-    attempt_status_name?: string | null;
+    anchors_json?: ResourceAnchor[];
     initializing?: boolean;
-}
-/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
-export interface ExtensionTicketsApi {
-    list(input?: ExtensionTicketListInput): Promise<ExtensionTicket[]>;
-    get(ref: string): Promise<ExtensionTicket>;
-    update(input: {
-        ticket: string;
-        content?: string;
-    }): Promise<ExtensionTicket>;
-    listFiles(ref: string): Promise<ExtensionTicketFile[]>;
-    createAttempt(input: {
-        ticket: string;
-        agent?: string;
-        branch?: string;
-        repoId?: string;
-        repoPath?: string;
-        mode?: "worktree" | "current_branch";
-        model?: string;
-        prompt?: string;
-        base?: string;
-        startSession?: boolean;
-    }): Promise<unknown>;
-    setStatus(input: {
-        ticket: string;
-        status: string;
-    }): Promise<void>;
-    updateWhenAllAttemptsMatch(input: {
-        ticket: string;
-        allAttemptsStatus: string;
-        setStatus: string;
-    }): Promise<{
-        updated: boolean;
-    }>;
-}
-/** @deprecated Legacy core ticket status extension API. Ticket statuses are owned by the pstdio tickets extension. */
-export interface ExtensionTicketStatus {
-    id: string;
-    name: string;
-    color: string;
-    sortOrder: number;
-    isDefault: boolean;
-    canCreate: boolean;
-    canDragIn: boolean;
-    canDragOut: boolean;
-    columnActions: string[];
-}
-/** @deprecated Legacy core ticket status extension API. Ticket statuses are owned by the pstdio tickets extension. */
-export interface ExtensionTicketStatusesApi {
-    list(): Promise<ExtensionTicketStatus[]>;
-    create(input: {
-        name: string;
-        color: string;
-        sortOrder?: number;
-        isDefault?: boolean;
-        canCreate?: boolean;
-        canDragIn?: boolean;
-        canDragOut?: boolean;
-        columnActions?: string[];
-    }): Promise<ExtensionTicketStatus>;
-    update(input: {
-        statusId: string;
-        name?: string;
-        color?: string;
-        sortOrder?: number;
-        canCreate?: boolean;
-        canDragIn?: boolean;
-        canDragOut?: boolean;
-        columnActions?: string[];
-    }): Promise<ExtensionTicketStatus>;
-    setDefault(input: {
-        statusId: string;
-    }): Promise<void>;
-    delete(input: {
-        statusId: string;
-    }): Promise<void>;
-}
-/** @deprecated Legacy ticket attempt status extension API. Workspace status automation is extension-owned. */
-export interface ExtensionAttemptStatus {
-    id: string;
-    name: string;
-    color: string;
-    sortOrder: number;
-    isDefault: boolean;
-}
-/** @deprecated Legacy ticket attempt status extension API. Workspace status automation is extension-owned. */
-export interface ExtensionAttemptStatusesApi {
-    list(): Promise<ExtensionAttemptStatus[]>;
-    create(input: {
-        name: string;
-        color: string;
-        sortOrder?: number;
-        isDefault?: boolean;
-    }): Promise<ExtensionAttemptStatus>;
-    update(input: {
-        statusId: string;
-        name?: string;
-        color?: string;
-        sortOrder?: number;
-        isDefault?: boolean;
-    }): Promise<ExtensionAttemptStatus>;
-    delete(input: {
-        statusId: string;
-    }): Promise<void>;
-}
-export interface SetAttemptStatusInput {
-    workspaceId: string;
-    status: string;
-    sessionId?: string;
-}
-export interface SetAttemptStatusResult {
-    id: string;
-    attempt_status_id: string | null;
-    from_status: string | null;
-    to_status: string;
-    status_change_id: string;
+    created_at?: string;
+    updated_at?: string;
 }
 export interface ExtensionWorkspacesApi {
+    list(): Promise<ExtensionWorkspace[]>;
     get(id: string): Promise<ExtensionWorkspace | null>;
     getByShorthand(shorthand: string): Promise<ExtensionWorkspace | null>;
     create(input: JsonObject): Promise<ExtensionWorkspace>;
     archive(id: string): Promise<void>;
     delete(id: string): Promise<void>;
-    setAttemptStatus(input: SetAttemptStatusInput): Promise<SetAttemptStatusResult>;
 }
 export interface BootstrapWorktreeInput {
     repoPath: string;
     worktreePath: string;
-    /** @deprecated Legacy ticket worktree bootstrap. Ticket worktree setup is owned by the pstdio tickets extension. */
-    ticketId?: string;
-}
-/** @deprecated Legacy ticket worktree cleanup. Ticket worktree setup is owned by the pstdio tickets extension. */
-export interface RemoveWorktreesForTicketInput {
-    ticketId?: string;
 }
 export interface ExtensionWorktreesApi {
     bootstrap(input: BootstrapWorktreeInput): Promise<void>;
-    /** @deprecated Legacy ticket worktree cleanup. Ticket worktree setup is owned by the pstdio tickets extension. */
-    removeAllForTicket(input: RemoveWorktreesForTicketInput): Promise<number>;
 }
 export interface ExtensionReposApi {
     list(): Promise<RepoContext[]>;
@@ -356,13 +222,9 @@ export interface ExtensionContextBase<TSettings extends Record<string, unknown>
     source?: CommandSource;
     storage: ExtensionStorageApi;
     artifacts: ExtensionArtifactApi;
+    /** Working tree of the invocation's repo, scoped to its root. Absent for non-repo (event/hook) invocations. */
+    repoFiles?: ArtifactMount;
     files: ExtensionFilesApi;
-    /** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
-    tickets: ExtensionTicketsApi;
-    /** @deprecated Legacy core ticket status extension API. Ticket statuses are owned by the pstdio tickets extension. */
-    ticketStatuses: ExtensionTicketStatusesApi;
-    /** @deprecated Legacy ticket attempt status extension API. Workspace status automation is extension-owned. */
-    attemptStatuses: ExtensionAttemptStatusesApi;
     sessions: ExtensionSessionsApi;
     workspaces: ExtensionWorkspacesApi;
     worktrees: ExtensionWorktreesApi;