@pstdio/sdk 0.25.0 → 0.36.0

package/dist/testing.d.ts

@@ -1,921 +1,27 @@
-import { z } from 'zod';
-
-declare interface ArtifactFile {
-    path: string;
-    size?: number;
-    updatedAt?: string;
-}
-
-declare interface ArtifactMount {
-    exists(path: string): Promise<boolean>;
-    readText(path: string): Promise<string>;
-    writeText(path: string, value: string): Promise<void>;
-    /** Replace existing text. Fails if missing and never recreates a concurrently deleted file. */
-    updateText(path: string, value: string): Promise<void>;
-    readBytes(path: string): Promise<Uint8Array>;
-    writeBytes(path: string, value: Uint8Array): Promise<void>;
-    list(pattern?: string): Promise<ArtifactFile[]>;
-    listDirs(path?: string): Promise<string[]>;
-    delete(path: string): Promise<void>;
-}
-
-declare interface CommandContext<TSettings extends Record<string, unknown> = Record<string, unknown>> extends ExtensionContextBase<TSettings> {
-    commandId: string;
-    invocationId: string;
-    /** Aborts when the host cancels this command run. Handlers must stop external side effects when it fires. */
-    signal: AbortSignal;
-    invocation: {
-        readonly source?: CommandSource;
-        readonly attachment?: WorkbenchAttachmentInvocationContext;
-        readonly slot?: SlotInvocationContext;
-        readonly metadata?: JsonObject;
-    };
-    resource?: ResourceRef;
-    attachment?: WorkbenchAttachmentInvocationContext;
-    slot?: SlotInvocationContext;
-}
-
-export declare interface CommandContextInput<TParams extends Record<string, unknown>> {
-    storage: ExtensionStorageApi;
-    params: TParams;
-    projectId?: string;
-    resourcePrefixes?: Record<string, string>;
-    overrides?: CommandContextOverrides;
-}
-
-export declare type CommandContextOverrides = {
-    [K in keyof CommandContext]?: Partial<CommandContext[K]>;
-};
-
-declare interface CommandContinue {
-    type: "continue";
-}
-
-declare interface CommandDiagnostic {
-    code: string;
-    message: string;
-    severity: "info" | "warning" | "error";
-    extensionId?: string;
-    commandId?: string;
-    metadata?: JsonObject;
-}
-
-declare interface CommandHelpersApi {
-    execute<TParams extends Struct = Struct, TResult = unknown>(command: CommandRef<TParams, TResult>, invocation: CommandInvocation<TParams>): Promise<CommandOutcome<TResult>>;
-    continue(): CommandContinue;
-    patchParams<TParams extends Struct = Struct>(params: Partial<TParams>): CommandPatchParams<TParams>;
-    replaceParams<TParams extends Struct = Struct>(params: TParams): CommandReplaceParams<TParams>;
-    replaceInvocation<TParams extends Struct = Struct>(invocation: CommandInvocation<TParams>): CommandReplaceInvocation<TParams>;
-    reject(input: Omit<CommandReject, "type">): CommandReject;
-}
-
-declare interface CommandInvocation<TParams extends Struct = Struct> {
-    params: TParams;
-    resource?: ResourceRef;
-    repoId?: string;
-    repoPath?: string;
-    attachment?: WorkbenchAttachmentInvocationContext;
-    slot?: SlotInvocationContext;
-    metadata?: JsonObject;
-}
-
-declare interface CommandNotice {
-    type: "info" | "success" | "warning" | "error";
-    title?: string;
-    message: string;
-    metadata?: JsonObject;
-}
-
-declare type CommandOutcome<TResult = unknown> = {
-    ok: true;
-    status: "success";
-    value: TResult;
-    navigationRequests?: NavigationTarget[];
-    notices?: CommandNotice[];
-    diagnostics?: CommandDiagnostic[];
-} | {
-    ok: false;
-    status: "rejected";
-    code?: string;
-    reason: string;
-    data?: JsonObject;
-    notices?: CommandNotice[];
-    diagnostics?: CommandDiagnostic[];
-} | {
-    ok: false;
-    status: "error";
-    code?: string;
-    reason: string;
-    error?: SerializedError;
-    notices?: CommandNotice[];
-    diagnostics?: CommandDiagnostic[];
-};
-
-export declare const commandParamsFor: <TParams extends Record<string, unknown>>(context: CommandContext) => TParams;
-
-declare interface CommandPatchParams<TParams extends Struct = Struct> {
-    type: "patchParams";
-    params: Partial<TParams>;
-}
-
-declare interface CommandRef<TParams extends Struct = Struct, TResult = unknown> extends ContributionRef<"command"> {
-    params?: TParams;
-    result?: TResult;
-}
-
-declare interface CommandReject {
-    type: "reject";
-    code?: string;
-    reason: string;
-    data?: JsonObject;
-}
-
-declare interface CommandReplaceInvocation<TParams extends Struct = Struct> {
-    type: "replaceInvocation";
-    invocation: CommandInvocation<TParams>;
-}
-
-declare interface CommandReplaceParams<TParams extends Struct = Struct> {
-    type: "replaceParams";
-    params: TParams;
-}
-
-declare type CommandSource = "cli" | "dashboard" | "api" | "schedule" | "event" | "automation" | "command-panel";
-
-declare interface CommandTarget<TParams extends Struct = Struct> {
-    command: CommandRef<TParams, unknown>;
-    params?: TParams;
-}
-
-declare type ContributionKind = "activity-item" | "artifact-mount" | "command" | "command-palette-resource" | "connection" | "file-icon-theme" | "harness" | "hook" | "keybinding" | "middleware" | "mode" | "navigation-item" | "navigation-tree" | "page" | "placement" | "resource-hierarchy-provider" | "resource-kind" | "schedule" | "settings-panel" | "settings-section" | "skill" | "status" | "status-bar-item" | "template" | "template-type" | "theme" | "view" | "view-menu" | "workspace-type";
-
-declare interface ContributionRef<Kind extends ContributionKind> {
-    readonly extensionId?: string;
-    readonly kind: Kind;
-    readonly id: string;
-}
-
-declare interface CreateExtensionWorkspaceInput {
-    project_id?: string;
-    shorthand_base: string;
-    provider_id?: string;
-    params?: JsonObject;
-    anchors?: ResourceAnchor[];
-    repo_id?: string;
-    base?: string;
-}
-
-export declare const createMemoryRepoFiles: () => ArtifactMount & {
-    files: Map<string, Uint8Array>;
-};
-
-export declare const createMemoryResources: (prefixes: Record<string, string>, sequences?: Map<string, number>) => ExtensionResourcesApi;
-
-export declare const createMemoryStorage: () => ExtensionStorageApi;
-
-declare interface CreateNotificationInput {
-    projectId: string;
-    title: string;
-    body?: string;
-    kind: NotificationKind;
-    priority?: NotificationPriority;
-    target?: ResourceRef;
-    related?: ResourceRef[];
-    actions?: NotificationAction[];
-    dedupeKey?: string;
-    expiresAt?: string;
-    snoozedUntil?: string;
-    metadata?: JsonObject;
-}
-
-declare interface EventDeliveryResult {
-    delivered: number;
-    diagnostics?: CommandDiagnostic[];
-}
-
-declare interface EventRef<TPayload extends Struct = Struct> {
-    readonly extensionId?: string;
-    readonly kind: "event";
-    readonly id: string;
-    payload?: TPayload;
-}
-
-declare interface ExtensionActivityApi {
-    record(input: {
-        message: string;
-        target?: ResourceRef;
-        related?: ResourceRef[];
-        metadata?: JsonObject;
-    }): Promise<{
-        id: string;
-    }>;
-}
-
-declare interface ExtensionArtifactApi {
-    mount(key: string): ArtifactMount;
-}
-
-declare interface ExtensionBlobInput {
-    name: string;
-    data: Uint8Array | ArrayBuffer;
-    mimeType?: string | null;
-}
-
-declare interface ExtensionBlobRef {
-    id: string;
-    name: string;
-    mimeType: string | null;
-    size: number;
-    hash: string | null;
-    url: string;
-    createdAt: string;
-    updatedAt: string;
-}
-
-declare 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;
-}
-
-declare type ExtensionConnectionMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-
-declare interface ExtensionConnectionRequest {
-    method: ExtensionConnectionMethod;
-    path: string;
-    headers?: Record<string, string>;
-    body?: JsonValue;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
-
-declare interface ExtensionConnectionResponse<TBody = JsonValue> {
-    status: number;
-    headers: Record<string, string>;
-    body: TBody;
-}
-
-declare interface ExtensionConnectionsApi {
-    request<TBody = JsonValue>(connectionId: string, input: ExtensionConnectionRequest): Promise<ExtensionConnectionResponse<TBody>>;
-    stream(connectionId: string, input: ExtensionConnectionRequest): AsyncIterable<ExtensionConnectionStreamEvent>;
-}
-
-declare type ExtensionConnectionStreamEvent = {
-    type: "response";
-    status: number;
-    headers: Record<string, string>;
-} | {
-    type: "data";
-    data: Uint8Array;
-} | {
-    type: "end";
-};
-
-declare interface ExtensionContextBase<TSettings extends Record<string, unknown> = Record<string, unknown>> {
-    projectId: string;
-    /** Host workspace id when the command runs from inside a worktree-backed workspace. */
-    workspaceId?: string;
-    project: ExtensionProjectContext;
-    extensionId: string;
-    /** Extension package name. Used for grouping/prefixing user-facing references. */
-    name: string;
-    repo?: RepoContext;
-    source?: CommandSource;
-    storage: ExtensionStorageApi;
-    resources: ExtensionResourcesApi;
-    /** Records navigation for the invoking UI; headless execution opens nothing. */
-    navigation: {
-        open(target: NavigationTarget): void;
-    };
-    artifacts: ExtensionArtifactApi;
-    /** Working tree of the invocation's repo, scoped to its root. Absent for non-repo (event/hook) invocations. */
-    repoFiles?: ArtifactMount;
-    /** Files of the workspace this context targets, scoped to its working dir. */
-    workspaceFiles?: WorkspaceFilesMount;
-    /** Read-only files packaged with the installed extension, scoped to its package root. */
-    packageFiles: ExtensionPackageFilesApi;
-    /** Repo directory allocated to this extension. Present wherever repoFiles is present. */
-    extensionFiles?: ArtifactMount;
-    files: ExtensionFilesApi;
-    /** Project skill catalog. Present where the host wires it (command/event contexts). */
-    skills?: ExtensionSkillsApi;
-    sessions: ExtensionSessionsApi;
-    workspaces: ExtensionWorkspacesApi;
-    repos: ExtensionReposApi;
-    commands: CommandHelpersApi;
-    events: ExtensionEventsApi;
-    activity: ExtensionActivityApi;
-    notify: ExtensionNotifyApi;
-    process: ExtensionProcessApi;
-    /** Interactive PTY sessions. Present only where the host wires a terminal supervisor (e.g. the workbench panel). */
-    terminal?: ExtensionTerminalApi;
-    net: ExtensionNetApi;
-    connections: ExtensionConnectionsApi;
-    logger: ExtensionLoggerApi;
-    settings: ExtensionSettingsApi<TSettings>;
-}
-
-declare interface ExtensionEventsApi {
-    emit<TPayload extends Struct>(event: EventRef<TPayload> | string, payload: TPayload): Promise<EventDeliveryResult>;
-}
-
-declare interface ExtensionFilesApi {
-    readText(fileId: string): Promise<string>;
-    writeText(fileId: string, value: string): Promise<void>;
-    createText(input: {
-        name: string;
-        content: string;
-        metadata?: JsonObject;
-    }): Promise<{
-        id: string;
-    }>;
-    delete(fileId: string): Promise<void>;
-}
-
-declare interface ExtensionHarnessInput {
-    harnessId: string;
-    model?: string;
-}
-
-declare interface ExtensionLoggerApi {
-    info(message: string, metadata?: JsonObject): void;
-    warn(message: string, metadata?: JsonObject): void;
-    error(message: string, metadata?: JsonObject): void;
-}
-
-declare interface ExtensionNetApi {
-    findFreePort(input?: {
-        host?: string;
-    }): Promise<number>;
-}
-
-declare interface ExtensionNotifyApi {
-    toast(notice: CommandNotice): Promise<void>;
-    action(input: Omit<CreateNotificationInput, "projectId">): Promise<Notification_2>;
-    resolve(input: {
-        id?: string;
-        dedupeKey?: string;
-        status?: Extract<NotificationStatus, "done" | "dismissed" | "expired">;
-    }): Promise<Notification_2[]>;
-    dismiss(input: {
-        id?: string;
-        dedupeKey?: string;
-    }): Promise<Notification_2[]>;
-}
-
-declare type ExtensionPackageFilesApi = Pick<ArtifactMount, "exists" | "readText" | "readBytes" | "list" | "listDirs">;
-
-declare interface ExtensionProcessApi {
-    run(input: ProcessRunInput): Promise<ProcessRunResult>;
-    runOrThrow(input: ProcessRunInput): Promise<ProcessRunResult>;
-    /**
-     * Starts an independent process with no attached standard streams.
-     * It survives runtime and desktop shutdown and does not delay host exit.
-     * The extension owns the child's lifetime and must arrange its cleanup.
-     */
-    spawnDetached(input: {
-        command: string[];
-        cwd?: string;
-        env?: Record<string, string>;
-    }): Promise<{
-        pid?: number;
-    }>;
-}
-
-declare interface ExtensionProjectContext {
-    id: string;
-    name: string;
-    shorthand: string;
-}
-
-declare interface ExtensionReposApi {
-    list(): Promise<RepoContext[]>;
-    get(repoId: string): Promise<RepoContext>;
-    getDefault(): Promise<RepoContext | undefined>;
-    resolvePath(repoId: string, relativePath: string, options?: {
-        basePath?: string;
-    }): Promise<string>;
-}
-
-declare interface ExtensionResourcesApi {
-    /** Publish a committed removal to clients displaying this project resource. */
-    removed(resource: ResourceRef): Promise<void>;
-    allocate(input: {
-        kind: string;
-    }): Promise<{
-        id: string;
-        shorthand: string;
-    }>;
-}
-
-declare interface ExtensionSessionResource {
-    type: "session";
-    id: string;
-    title: string;
-    status: SessionStatus;
-}
-
-declare interface ExtensionSessionsApi {
-    get(id: string): Promise<{
-        id: string;
-        title: string;
-        status?: string;
-        original_session_id?: string | null;
-        cwd?: string | null;
-        updated_at?: string | null;
-        anchors_json?: ResourceAnchor[];
-    } | null>;
-    list(): Promise<Array<{
-        id: string;
-        title: string;
-        status: SessionStatus;
-        last_request_started?: string | null;
-        last_request_ended?: string | null;
-        updated_at?: string | null;
-        anchors_json?: ResourceAnchor[];
-    }>>;
-    /** Sessions linked to a workspace (via the workspace-session join), oldest first. */
-    listByWorkspace(workspaceId: string): Promise<Array<{
-        id: string;
-        title: string;
-        status: SessionStatus;
-        created_at?: string | null;
-        updated_at?: string | null;
-        anchors_json?: ResourceAnchor[];
-    }>>;
-    create(input: {
-        title: string;
-        prompt?: string;
-        harness?: ExtensionHarnessInput;
-        workspaceId?: string;
-        repoId?: string;
-        anchors?: ResourceAnchor[];
-        attachments?: SessionAttachmentRef[];
-        originalSessionId?: string;
-    }): Promise<ExtensionSessionResource>;
-    followup(input: {
-        sessionId: string;
-        prompt?: string;
-        attachments?: SessionAttachmentRef[];
-    }): Promise<void>;
-    addAnchors(sessionId: string, anchors: ResourceAnchor[]): Promise<void>;
-}
-
-declare interface ExtensionSettingsApi<TSettings extends Record<string, unknown> = Record<string, unknown>> {
-    all(): Promise<Partial<TSettings>>;
-    get<TKey extends keyof TSettings & string>(key: TKey): Promise<TSettings[TKey] | undefined>;
-    set<TKey extends keyof TSettings & string>(key: TKey, value: TSettings[TKey]): Promise<void>;
-    delete<TKey extends keyof TSettings & string>(key: TKey): Promise<void>;
-}
-
-declare interface ExtensionSkillsApi {
-    /** The project's resolved skill catalog (DB skills + extension-contributed skills, deduped). */
-    list(): Promise<Skill[]>;
-}
-
-declare 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>;
-}
-
-declare interface ExtensionStorageCollectionApi<TItem = unknown> {
-    get(id: string): Promise<TItem | undefined>;
-    list(): Promise<TItem[]>;
-    put(id: string, value: TItem): Promise<void>;
-    /** Replace an existing item atomically. Throws if the item was deleted. */
-    update(id: string, value: TItem): Promise<void>;
-    createIfAbsent(id: string, value: TItem): Promise<boolean>;
-    deleteIfValue(id: string, value: TItem): Promise<boolean>;
-    create(value: TItem): Promise<TItem & {
-        id: string;
-    }>;
-    delete(id: string): Promise<void>;
-    attachments(itemId: string): ExtensionBlobsApi;
-}
-
-/** Opens long-lived, interactive PTY sessions. Complements {@link ExtensionProcessApi}'s run-to-completion model. */
-declare interface ExtensionTerminalApi {
-    openSession(request: TerminalSessionRequest): TerminalSessionHandle;
-}
-
-declare interface ExtensionWorkspace {
-    id: string;
-    name?: string;
-    project_id?: string;
-    workspace_shorthand?: string;
-    branch?: string | null;
-    worktree_path?: string | null;
-    provider_id?: string;
-    provider_state?: WorkspaceProviderState;
-    execution_kind?: "local" | "remote";
-    display_path?: string | null;
-    provider_capabilities_json?: WorkspaceCapabilities;
-    anchors_json?: ResourceAnchor[];
-    initializing?: boolean;
-    created_at?: string;
-    updated_at?: string;
-}
-
-declare interface ExtensionWorkspacesApi {
-    list(): Promise<ExtensionWorkspace[]>;
-    get(id: string): Promise<ExtensionWorkspace | null>;
-    getByShorthand(shorthand: string): Promise<ExtensionWorkspace | null>;
-    create(input: CreateExtensionWorkspaceInput): Promise<ExtensionWorkspace>;
-    resolve(id: string): Promise<WorkspaceProviderResult>;
-    cancel(id: string): Promise<ExtensionWorkspace>;
-    archive(id: string): Promise<ExtensionWorkspace>;
-    removeWorktree(id: string): Promise<{
-        removed: boolean;
-    }>;
-    delete(id: string): Promise<void>;
-}
-
-declare interface FileRendererSectionAnchor {
-    /** Stable extension-owned tree node id. */
-    id: string;
-    /** Plain heading text as it appears in the Markdown document. */
-    heading: string;
-    /** Zero-based occurrence when the document repeats the same heading text. */
-    occurrence?: number;
-}
-
-declare interface FileRendererSectionTarget {
-    /** The document outline used for deep-linking and active-heading sync. */
-    anchors: FileRendererSectionAnchor[];
-}
-
-declare type JsonObject = {
-    [key: string]: JsonValue;
-};
-
-declare type JsonPrimitive = string | number | boolean | null;
-
-declare type JsonValue = JsonPrimitive | JsonValue[] | JsonObject;
-
-export declare const makeCommandArgs: <TParams extends Record<string, unknown>>(input: CommandContextInput<TParams>) => readonly [CommandContext<Record<string, unknown>>, TParams];
-
-export declare const makeCommandContext: <TParams extends Record<string, unknown>>(input: CommandContextInput<TParams>) => CommandContext<Record<string, unknown>>;
-
-declare type NavigationTarget = NavigationTargetItem | NavigationTargetCompound;
-
-declare interface NavigationTargetCommand {
-    kind: "command";
-    target: CommandTarget<JsonObject>;
-}
-
-declare interface NavigationTargetCompound {
-    kind: "compound";
-    targets: readonly (NavigationTargetPage | NavigationTargetPanel)[];
-}
-
-declare interface NavigationTargetHref {
-    kind: "href";
-    href: string;
-}
-
-declare type NavigationTargetItem = NavigationTargetPage | NavigationTargetPanel | NavigationTargetCommand | NavigationTargetHref;
-
-declare interface NavigationTargetPage {
-    kind: "page";
-    page: PageRef;
-    resource?: ResourceRef;
-    section?: FileRendererSectionTarget;
-    open?: PageOpenIntent;
-    parent?: NavigationTargetPage;
-}
-
-declare interface NavigationTargetPanel {
-    kind: "panel";
-    panel: PanelRef;
-    resource?: ResourceRef;
-    open?: PageOpenIntent;
-}
-
-declare interface Notification_2 {
-    id: string;
-    projectId: string;
-    title: string;
-    body?: string | null;
-    kind: NotificationKind;
-    status: NotificationStatus;
-    priority: NotificationPriority;
-    source: CommandSource;
-    origin: NotificationOrigin;
-    sourceExtensionId?: string | null;
-    actorType?: NotificationActorType | null;
-    actorId?: string | null;
-    target?: ResourceRef | null;
-    related: ResourceRef[];
-    actions: NotificationAction[];
-    dedupeKey?: string | null;
-    metadata?: JsonObject | null;
-    createdAt: string;
-    updatedAt: string;
-    readAt?: string | null;
-    resolvedAt?: string | null;
-    snoozedUntil?: string | null;
-    expiresAt?: string | null;
-}
-
-declare type NotificationAction = {
-    id: string;
-    label: string;
-    kind: "navigate";
-    target: NavigationTarget;
-    primary?: boolean;
-} | {
-    id: string;
-    label: string;
-    kind: "command";
-    command: string;
-    params?: JsonObject;
-    primary?: boolean;
-    destructive?: boolean;
-} | {
-    id: string;
-    label: string;
-    kind: "url";
-    href: string;
-    primary?: boolean;
-};
-
-declare type NotificationActorType = "user" | "agent" | "system";
-
-declare type NotificationKind = "needs_review" | "ready_to_merge" | "blocked" | "approval_required" | "failed" | "info";
-
-declare type NotificationOrigin = "core" | "extension" | "agent";
-
-declare type NotificationPriority = "low" | "normal" | "high" | "urgent";
-
-declare type NotificationStatus = "open" | "read" | "snoozed" | "done" | "dismissed" | "expired";
-
-declare type PageOpenIntent = "preview" | "pin";
-
-declare type PageRef = ContributionRef<"page">;
-
-declare interface PageSlotRef {
-    readonly kind: "page-slot";
-    readonly page: PageRef;
-    readonly id: string;
-}
-
-declare type PanelRef = PlacementRef | PageSlotRef;
-
-declare type PlacementRef = ContributionRef<"placement">;
-
-declare interface ProcessRunInput {
-    command: string[];
-    cwd?: string;
-    env?: Record<string, string>;
-    timeoutMs?: number;
-}
-
-declare interface ProcessRunResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}
-
-declare interface RepoContext {
-    projectId: string;
-    repoId: string;
-    path: string;
-    remote?: string | null;
-    role?: "default" | "selected" | "workspace";
-}
-
-declare interface ResourceAnchor extends ResourceRef {
-    role?: ResourceRole;
-}
-
-declare interface ResourceRef {
-    type: string;
-    id: string;
-    shorthand?: string;
-    projectId?: string;
-    label?: string;
-    icon?: string;
-    extensionId?: string;
-    metadata?: JsonObject;
-}
-
-declare type ResourceRole = "primary" | "context" | "source" | "result";
-
-declare interface SerializedError {
-    name?: string;
-    message: string;
-    stack?: string;
-    cause?: JsonValue;
-}
-
-declare type SessionAttachmentRef = z.infer<typeof sessionAttachmentRefSchema>;
-
-declare const sessionAttachmentRefSchema: z.ZodObject<{
-    file_id: z.ZodString;
-}, z.core.$strip>;
-
-declare type SessionStatus = z.infer<typeof sessionStatusSchema>;
-
-declare const sessionStatusSchema: z.ZodEnum<{
-    completed: "completed";
-    failed: "failed";
-    in_progress: "in_progress";
-    awaiting_input: "awaiting_input";
-    queued: "queued";
-    cancelled: "cancelled";
-    disconnected: "disconnected";
-}>;
-
-declare type Skill = z.infer<typeof skillSchema>;
-
-declare const skillSchema: z.ZodObject<{
-    id: z.ZodString;
-    project_id: z.ZodString;
-    name: z.ZodString;
-    title: z.ZodString;
-    description: z.ZodString;
-    source_kind: z.ZodEnum<{
-        project: "project";
-        extension: "extension";
-    }>;
-    files: z.ZodArray<z.ZodObject<{
-        path: z.ZodString;
-        content: z.ZodString;
-        encoding: z.ZodLiteral<"utf8">;
-    }, z.core.$strip>>;
-    editable: z.ZodBoolean;
-    extension_instance_id: z.ZodOptional<z.ZodString>;
-    extension_id: z.ZodOptional<z.ZodString>;
-    installed_extension_id: z.ZodOptional<z.ZodString>;
-    install_name: z.ZodOptional<z.ZodString>;
-    key: z.ZodOptional<z.ZodString>;
-    source: z.ZodOptional<z.ZodObject<{
-        kind: z.ZodLiteral<"package-asset">;
-        path: z.ZodString;
-        baseUrl: z.ZodString;
-    }, z.core.$strip>>;
-    enabled: z.ZodOptional<z.ZodBoolean>;
-    created_at: z.ZodString;
-    updated_at: z.ZodString;
-    deleted_at: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-
-declare interface SlotInvocationContext<TContext extends Struct = Struct> {
-    id: string;
-    kind: UiSlotKind;
-    context: TContext;
-}
-
-declare type StorageScope = {
-    type: "project";
-} | {
-    type: "repo";
-    repoId: string;
-} | {
-    type: "resource";
-    resource: ResourceRef;
-} | {
-    type: string;
-    id: string;
-};
-
-declare type Struct = object;
-
-declare type TerminalEvent = {
-    kind: "data";
-    chunk: Uint8Array;
-} | {
-    kind: "title";
-    title: string;
-} | {
-    kind: "exit";
-    code: number | null;
-    signal: string | null;
-} | {
-    kind: "error";
-    message: string;
-};
-
-declare interface TerminalSessionHandle {
-    /** Stable session id. */
-    readonly id: string;
-    /** Send stdin to the PTY. */
-    write(data: string | Uint8Array): void;
-    /** Adjust the PTY geometry. */
-    resize(cols: number, rows: number): void;
-    /** Terminate the child and clean up host resources. */
-    kill(signal?: string): Promise<void>;
-    /**
-     * Async iterable of output / exit / error events. A single iterator is
-     * supported per session — calling this twice throws. `exit` is always the
-     * last event delivered for a session.
-     */
-    events(): AsyncIterable<TerminalEvent>;
-}
-
-declare interface TerminalSessionRequest {
-    /** Command + args to run; defaults to the user's login shell when omitted. */
-    command?: string[];
-    /** Working directory; falls back to the extension's workspace root. */
-    cwd?: string;
-    /** Extra env vars merged over the inherited environment. */
-    env?: Record<string, string>;
-    /** Initial column count; the renderer can resize later. */
-    cols: number;
-    /** Initial row count; the renderer can resize later. */
-    rows: number;
-}
-
-declare type UiSlotKind = "menu" | "panel" | "settings" | "renderer" | "kanbanRenderer" | "dataTableRenderer";
-
-declare interface WorkbenchAttachmentInvocationContext {
-    target: WorkbenchAttachmentTarget;
-    mode?: string;
-    projectId?: string;
-    resource?: ResourceRef;
-}
-
-declare type WorkbenchAttachmentTarget = WorkbenchMenuTarget | WorkbenchTreeTarget | WorkbenchViewTarget | WorkbenchSettingsTarget;
-
-declare type WorkbenchMenuTarget = (typeof workbenchMenuTargets)[number];
-
-declare const workbenchMenuTargets: readonly ["workbench.nav.actions", "workbench.nav.overflow"];
-
-declare type WorkbenchSettingsTarget = (typeof workbenchSettingsTargets)[number];
-
-declare const workbenchSettingsTargets: readonly ["workbench.settings"];
-
-declare type WorkbenchTreeTarget = (typeof workbenchTreeTargets)[number];
-
-declare const workbenchTreeTargets: readonly ["workbench.left.tree", "workbench.main.left.tree", "workbench.main.right.tree"];
-
-declare type WorkbenchViewTarget = (typeof workbenchViewTargets)[number];
-
-declare const workbenchViewTargets: readonly ["workbench.main", "workbench.main.left", "workbench.main.right", "workbench.secondary"];
-
-declare interface WorkspaceCapabilities {
-    files: "none" | "read" | "write";
-    diff: boolean;
-    merge: boolean;
-    rebase: boolean;
-    archive: boolean;
-    delete: boolean;
-}
-
-declare type WorkspaceExecutionTarget = {
-    kind: "local";
-    rootPath: string;
-    displayPath?: string;
-} | {
-    kind: "remote";
-    providerId: string;
-    providerRef: WorkspaceProviderRef;
-    displayPath?: string;
-};
-
-declare interface WorkspaceFilesMount extends ArtifactMount {
-    /**
-     * Write each file atomically (temp + rename) and prune files managed by an earlier sync that are no
-     * longer present. Other files under `dir` are preserved. Idempotent and safe to re-run on every
-     * catalog change; a live agent's dir-watcher only ever sees complete files.
-     */
-    syncDir(dir: string, files: WorkspaceSyncFile[]): Promise<void>;
-}
-
-declare interface WorkspaceProviderRef {
-    version: number;
-    data: JsonObject;
-}
-
-declare interface WorkspaceProviderResult {
-    providerRef?: WorkspaceProviderRef;
-    /** Git branch exposed to host merge and diff features. Provider refs stay opaque. */
-    branch?: string;
-    state: WorkspaceProviderState;
-    executionKind: "local" | "remote";
-    executionTarget?: WorkspaceExecutionTarget;
-    displayPath?: string;
-    capabilities: WorkspaceCapabilities;
-    error?: {
-        code: string;
-        message: string;
-        retryable: boolean;
-    };
-}
-
-declare type WorkspaceProviderState = "provisioning" | "ready" | "failed" | "cancelled" | "archiving" | "archived" | "deleting" | "provider_missing";
-
-declare interface WorkspaceSyncFile {
-    /** Path relative to the `dir` passed to {@link WorkspaceFilesMount.syncDir}. */
-    path: string;
-    content: string;
-}
-
-export { }
+import { Gu as ExtensionResourcesApi, Ir as ArtifactMount, Lr as CommandContext, oi as ExtensionStorageApi } from "./index-CR17_9lz.js";
+//#region src/testing/command-context.d.ts
+type CommandContextOverrides = { [K in keyof CommandContext]?: Partial<CommandContext[K]>; };
+interface CommandContextInput<TParams extends Record<string, unknown>> {
+  storage: ExtensionStorageApi;
+  params: TParams;
+  projectId?: string;
+  resourcePrefixes?: Record<string, string>;
+  overrides?: CommandContextOverrides;
+}
+export declare const makeCommandContext: <TParams extends Record<string, unknown>>(input: CommandContextInput<TParams>) => CommandContext<Record<string, unknown>>;
+export declare const commandParamsFor: <TParams extends Record<string, unknown>>(context: CommandContext) => TParams;
+export declare const makeCommandArgs: <TParams extends Record<string, unknown>>(input: CommandContextInput<TParams>) => readonly [CommandContext<Record<string, unknown>>, TParams];
+//#endregion
+//#region src/testing/memory-repo-files.d.ts
+export declare const createMemoryRepoFiles: () => ArtifactMount & {
+  files: Map<string, Uint8Array>;
+};
+//#endregion
+//#region src/testing/memory-resources.d.ts
+export declare const createMemoryResources: (prefixes: Record<string, string>, sequences?: Map<string, number>) => ExtensionResourcesApi;
+//#endregion
+//#region src/testing/memory-storage.d.ts
+export declare const createMemoryStorage: () => ExtensionStorageApi;
+//#endregion
+export type { CommandContextInput, CommandContextOverrides };
+export {};