@pstdio/sdk 0.11.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pstdio/sdk",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/pufflyai/prompt-studio"
@@ -40,7 +40,7 @@
   },
   "scripts": {
     "build": "rm -rf ./dist && bun run build:js && bun run build:types",
-    "build:js": "bun build ./src/api/index.ts ./src/client/index.ts ./src/extensions/index.ts ./src/prompts/index.ts ./src/hooks/index.ts ./src/resources/index.ts --outdir ./dist --root ./src --target node --format esm --packages external",
+    "build:js": "bun build ./src/api/index.ts ./src/client/index.ts ./src/extensions/index.ts ./src/prompts/index.ts ./src/hooks/index.ts ./src/resources/index.ts --outdir ./dist --root ./src --target node --format esm --external mustache",
     "build:types": "tsc --project ./tsconfig.build.json",
     "prepack": "bun run build",
     "typecheck": "tsc --noEmit",

package/dist/api/agents.d.ts

@@ -1 +0,0 @@
-export type { SetupAgentInput, SetupAvailableAgentsInput, UpdateAgentInput } from "pstdio-api-contracts";

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

@@ -1,112 +0,0 @@
-import type { ExtensionWorkspace } from "./types/context";
-import type { ResourceAnchor } from "./types/resources";
-export interface WorktreeCreatedEventPayload {
-    projectId: string;
-    repoPath: string;
-    worktreePath: string;
-    branch: string;
-    workspace: string;
-    workspaceId: string;
-    anchors?: ResourceAnchor[];
-}
-export interface SessionLifecyclePayload {
-    projectId: string;
-    sessionId: string;
-    sessionStatus?: string;
-    originalSessionId?: string;
-    workspace?: ExtensionWorkspace;
-    workspaceId?: string;
-    worktreePath?: string;
-    branch?: string;
-    anchors?: ResourceAnchor[];
-}
-export interface WorktreeRemovedPayload {
-    projectId: string;
-    repoPath?: string;
-    worktreePath: string;
-    workspace?: ExtensionWorkspace;
-    workspaceId?: string;
-    anchors?: ResourceAnchor[];
-}
-export interface CommitPayload {
-    projectId: string;
-    repoPath?: string;
-    worktreePath?: string;
-    branch?: string;
-    commitSha?: string;
-    workspace?: ExtensionWorkspace;
-    anchors?: ResourceAnchor[];
-}
-export interface RebasePayload {
-    projectId: string;
-    repoPath?: string;
-    worktreePath?: string;
-    branch?: string;
-    workspace?: ExtensionWorkspace;
-    anchors?: ResourceAnchor[];
-}
-export interface MergePayload extends CommitPayload {
-}
-export interface ConflictPayload {
-    projectId: string;
-    operation: "rebase" | "merge";
-    repoPath?: string;
-    worktreePath?: string;
-    branch?: string;
-    workspace?: ExtensionWorkspace;
-    anchors?: ResourceAnchor[];
-}
-export declare const projectSlots: {
-    sidebar: import("./types").SlotRef<object, "view">;
-    headerPrimary: import("./types").SlotRef<object, "menu">;
-    headerOverflow: import("./types").SlotRef<object, "menu">;
-    settingsPanels: import("./types").SlotRef<object, "settings">;
-};
-export declare const sessionSlots: {
-    headerPrimary: import("./types").SlotRef<object, "menu">;
-    headerOverflow: import("./types").SlotRef<object, "menu">;
-    transcriptActions: import("./types").SlotRef<object, "menu">;
-};
-export declare const workspaceSlots: {
-    headerPrimary: import("./types").SlotRef<object, "menu">;
-    headerOverflow: import("./types").SlotRef<object, "menu">;
-    sidebar: import("./types").SlotRef<object, "view">;
-};
-export declare const projectEvents: {
-    opened: import("./types").EventRef<{
-        projectId: string;
-    }>;
-};
-export declare const sessionEvents: {
-    started: import("./types").EventRef<SessionLifecyclePayload & {
-        anchors?: ResourceAnchor[];
-    }>;
-    resumed: import("./types").EventRef<SessionLifecyclePayload>;
-    awaitingInput: import("./types").EventRef<SessionLifecyclePayload>;
-    succeeded: import("./types").EventRef<SessionLifecyclePayload>;
-    failed: import("./types").EventRef<SessionLifecyclePayload>;
-    completed: import("./types").EventRef<SessionLifecyclePayload & {
-        anchors?: ResourceAnchor[];
-    }>;
-};
-export declare const workspaceEvents: {
-    created: import("./types").EventRef<{
-        workspace: ExtensionWorkspace;
-    }>;
-    archived: import("./types").EventRef<{
-        workspace: ExtensionWorkspace;
-    }>;
-    deleted: import("./types").EventRef<{
-        workspace: ExtensionWorkspace;
-    }>;
-};
-export declare const worktreeEvents: {
-    created: import("./types").EventRef<WorktreeCreatedEventPayload>;
-    removed: import("./types").EventRef<WorktreeRemovedPayload>;
-};
-export declare const gitEvents: {
-    committed: import("./types").EventRef<CommitPayload>;
-    rebased: import("./types").EventRef<RebasePayload>;
-    merged: import("./types").EventRef<MergePayload>;
-    conflicted: import("./types").EventRef<ConflictPayload>;
-};

package/dist/extensions/l10n.d.ts

@@ -1,10 +0,0 @@
-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/package-asset.d.ts

@@ -1,10 +0,0 @@
-import type { PackageAssetDescriptor } from "./types/resources";
-/**
- * Reference an asset shipped alongside the extension's compiled output. `path` is
- * resolved relative to `baseUrl`; in practice authors always pass `import.meta.url`
- * so the runtime can locate the file no matter where the extension is installed.
- *
- * @example
- *   webview: { entry: packageAsset("./src/page.tsx", import.meta.url) }
- */
-export declare const packageAsset: (path: string, baseUrl: string) => PackageAssetDescriptor;

package/dist/extensions/slots.d.ts

@@ -1,6 +0,0 @@
-import type { Struct } from "./types/json";
-import type { SlotOptions, SlotRef, UiSlotKind } from "./types/slots";
-/**
- * Define a host-owned UI slot that extension contributions can target.
- */
-export declare const defineSlot: <TContext extends Struct = Struct, TKind extends UiSlotKind = UiSlotKind>(id: string, options: SlotOptions<TKind>) => SlotRef<TContext, TKind>;

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

@@ -1,125 +0,0 @@
-import type { WorkbenchAttachmentTarget } from "../workbench-targets";
-import type { JsonObject, JsonValue, Struct } from "./json";
-import type { RepoContext, ResourceRef } from "./resources";
-import type { SlotInvocationContext } from "./slots";
-export type CommandSource = "cli" | "dashboard" | "api" | "schedule" | "event" | "automation" | "command-panel";
-export interface CommandRef<TParams extends Struct = Struct, TResult = unknown> {
-    id: string;
-    params?: TParams;
-    result?: TResult;
-}
-export interface SerializedError {
-    name?: string;
-    message: string;
-    stack?: string;
-    cause?: JsonValue;
-}
-export interface WorkbenchAttachmentInvocationContext {
-    target: WorkbenchAttachmentTarget;
-    mode?: string;
-    projectId?: string;
-    resource?: ResourceRef;
-}
-export interface CommandInvocation<TParams extends Struct = Struct> {
-    params: TParams;
-    resource?: ResourceRef;
-    repoId?: string;
-    repoPath?: string;
-    attachment?: WorkbenchAttachmentInvocationContext;
-    slot?: SlotInvocationContext;
-    metadata?: JsonObject;
-}
-export interface CommandContinue {
-    type: "continue";
-}
-export interface CommandPatchParams<TParams extends Struct = Struct> {
-    type: "patchParams";
-    params: Partial<TParams>;
-}
-export interface CommandReplaceParams<TParams extends Struct = Struct> {
-    type: "replaceParams";
-    params: TParams;
-}
-export interface CommandReplaceInvocation<TParams extends Struct = Struct> {
-    type: "replaceInvocation";
-    invocation: CommandInvocation<TParams>;
-}
-export interface CommandReject {
-    type: "reject";
-    code?: string;
-    reason: string;
-    data?: JsonObject;
-}
-export type CommandMiddlewareResult<TParams extends Struct = Struct> = void | CommandContinue | CommandPatchParams<TParams> | CommandReplaceParams<TParams> | CommandReplaceInvocation<TParams> | CommandReject;
-export interface CommandNotice {
-    type: "info" | "success" | "warning" | "error";
-    title?: string;
-    message: string;
-    metadata?: JsonObject;
-}
-export interface CommandDiagnostic {
-    code: string;
-    message: string;
-    severity: "info" | "warning" | "error";
-    extensionId?: string;
-    commandId?: string;
-    metadata?: JsonObject;
-}
-export type CommandOutcome<TResult = unknown> = {
-    ok: true;
-    status: "success";
-    value: TResult;
-    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 interface CommandHelpersApi {
-    execute<TParams extends Struct = Struct, TResult = unknown>(command: CommandRef<TParams, TResult> | string, 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;
-}
-export interface CommandRequestedEvent<TParams extends Struct = Struct> {
-    commandId: string;
-    invocationId: string;
-    source?: CommandSource;
-    params: TParams;
-    resource?: ResourceRef;
-    repo?: RepoContext;
-}
-export interface CommandStartedEvent<TParams extends Struct = Struct> extends CommandRequestedEvent<TParams> {
-}
-export interface CommandCompletedEvent<TParams extends Struct = Struct, TResult = unknown> extends CommandStartedEvent<TParams> {
-    result: TResult;
-    elapsedMs: number;
-}
-export interface CommandRejectedEvent<TParams extends Struct = Struct> extends CommandRequestedEvent<TParams> {
-    code?: string;
-    reason: string;
-    data?: JsonObject;
-}
-export interface CommandFailedEvent<TParams extends Struct = Struct> extends CommandRequestedEvent<TParams> {
-    code?: string;
-    reason: string;
-    error?: SerializedError;
-    elapsedMs: number;
-}
-export type CommandLifecyclePhase = "requested" | "started" | "completed" | "rejected" | "failed";
-export type CommandLifecycleEventPayload<TPhase extends CommandLifecyclePhase, TParams extends Struct = Struct, TResult = unknown> = TPhase extends "requested" ? CommandRequestedEvent<TParams> : TPhase extends "started" ? CommandStartedEvent<TParams> : TPhase extends "completed" ? CommandCompletedEvent<TParams, TResult> : TPhase extends "rejected" ? CommandRejectedEvent<TParams> : CommandFailedEvent<TParams>;

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

@@ -1,258 +0,0 @@
-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";
-import type { RepoContext, ResourceAnchor, ResourceRef } from "./resources";
-import type { SlotInvocationContext } from "./slots";
-export interface ExtensionStorageCollectionApi<TItem = unknown> {
-    get(id: string): Promise<TItem | undefined>;
-    list(): Promise<TItem[]>;
-    put(id: string, value: TItem): Promise<void>;
-    create(value: TItem): Promise<TItem & {
-        id: string;
-    }>;
-    delete(id: string): Promise<void>;
-    attachments(itemId: string): ExtensionBlobsApi;
-}
-export type StorageScope = {
-    type: "project";
-} | {
-    type: "repo";
-    repoId: string;
-} | {
-    type: "resource";
-    resource: ResourceRef;
-} | {
-    type: 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;
-    updatedAt?: string;
-}
-export interface ArtifactMount {
-    exists(path: string): Promise<boolean>;
-    readText(path: string): Promise<string>;
-    writeText(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>;
-}
-export interface ExtensionArtifactApi {
-    mount(key: string): ArtifactMount;
-}
-export 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>;
-}
-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;
-        template?: string;
-        vars?: JsonObject;
-        harness?: ExtensionHarnessInput;
-        workspaceId?: string;
-        repoId?: string;
-        anchors?: ResourceAnchor[];
-        originalSessionId?: string;
-    }): Promise<ExtensionSessionResource>;
-    followup(input: {
-        sessionId: string;
-        prompt?: string;
-        template?: string;
-        vars?: JsonObject;
-    }): Promise<void>;
-}
-export interface ExtensionHarnessInput {
-    harnessId: string;
-    model?: string;
-}
-export interface ExtensionWorkspace {
-    id: string;
-    name?: string;
-    project_id?: string;
-    workspace_shorthand?: string;
-    branch?: string | null;
-    worktree_path?: string | null;
-    anchors_json?: ResourceAnchor[];
-    initializing?: boolean;
-    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>;
-}
-export interface BootstrapWorktreeInput {
-    repoPath: string;
-    worktreePath: string;
-}
-export interface ExtensionWorktreesApi {
-    bootstrap(input: BootstrapWorktreeInput): Promise<void>;
-}
-export interface ExtensionReposApi {
-    list(): Promise<RepoContext[]>;
-    get(repoId: string): Promise<RepoContext>;
-    getDefault(): Promise<RepoContext | undefined>;
-    resolvePath(repoId: string, relativePath: string, options?: {
-        basePath?: string;
-    }): Promise<string>;
-}
-export interface ExtensionEventsApi {
-    emit<TPayload extends Struct>(event: EventRef<TPayload> | string, payload: TPayload): Promise<EventDeliveryResult>;
-}
-export interface ExtensionActivityApi {
-    record(input: {
-        message: string;
-        target?: ResourceRef;
-        related?: ResourceRef[];
-        metadata?: JsonObject;
-    }): Promise<{
-        id: string;
-    }>;
-}
-export interface ExtensionNotifyApi {
-    toast(notice: CommandNotice): Promise<void>;
-}
-export interface ProcessRunResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}
-export interface ProcessRunInput {
-    command: string[];
-    cwd?: string;
-    env?: Record<string, string>;
-    timeoutMs?: number;
-}
-export interface ExtensionProcessApi {
-    run(input: ProcessRunInput): Promise<ProcessRunResult>;
-    runOrThrow(input: ProcessRunInput): Promise<ProcessRunResult>;
-    spawnDetached(input: {
-        command: string[];
-        cwd?: string;
-        env?: Record<string, string>;
-    }): Promise<{
-        pid?: number;
-    }>;
-}
-export interface ExtensionNetApi {
-    findFreePort(input?: {
-        host?: string;
-    }): Promise<number>;
-}
-export interface ExtensionLoggerApi {
-    info(message: string, metadata?: JsonObject): void;
-    warn(message: string, metadata?: JsonObject): void;
-    error(message: string, metadata?: JsonObject): void;
-}
-export 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>;
-}
-export interface ExtensionContextBase<TSettings extends Record<string, unknown> = Record<string, unknown>> {
-    projectId: string;
-    extensionId: string;
-    /** Extension package name. Used for grouping/prefixing user-facing references. */
-    name: string;
-    repo?: RepoContext;
-    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;
-    sessions: ExtensionSessionsApi;
-    workspaces: ExtensionWorkspacesApi;
-    worktrees: ExtensionWorktreesApi;
-    repos: ExtensionReposApi;
-    commands: CommandHelpersApi;
-    events: ExtensionEventsApi;
-    activity: ExtensionActivityApi;
-    notify: ExtensionNotifyApi;
-    process: ExtensionProcessApi;
-    net: ExtensionNetApi;
-    logger: ExtensionLoggerApi;
-    settings: ExtensionSettingsApi<TSettings>;
-}
-export interface CommandContext<TParams extends Struct = Struct, TSettings extends Record<string, unknown> = Record<string, unknown>> extends ExtensionContextBase<TSettings> {
-    commandId: string;
-    invocationId: string;
-    invocation: CommandInvocation<TParams>;
-    resource?: ResourceRef;
-    attachment?: WorkbenchAttachmentInvocationContext;
-    slot?: SlotInvocationContext;
-    params: TParams;
-}
-export type CommandMiddlewareContext<TParams extends Struct = Struct> = CommandContext<TParams>;
-export type CommandMiddlewareHandler<TParams extends Struct = Struct> = (ctx: CommandMiddlewareContext<TParams>) => MaybePromise<CommandMiddlewareResult<TParams>>;
-export type CommandRunHandler<TParams extends Struct = Struct, TResult = unknown, TSettings extends Record<string, unknown> = Record<string, unknown>> = (ctx: CommandContext<TParams, TSettings>) => MaybePromise<TResult>;
-export interface EventContext extends ExtensionContextBase {
-    eventId: string;
-    deliveryId: string;
-}
-export type SetupContext = ExtensionContextBase;
-export type MigrationContext = ExtensionContextBase;