@pstdio/sdk 0.1.0

package/dist/plugins/define-plugin.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDefinition } from "./types";
+export declare const definePlugin: (plugin: PluginDefinition) => PluginDefinition;

package/dist/plugins/helpers/context.d.ts

@@ -0,0 +1,24 @@
+import type { BaseHookContext } from "../../hooks/base";
+import type { ActionTriggerContext } from "../types";
+export type PluginHelperContext = Pick<BaseHookContext, "client" | "projectId"> | ActionTriggerContext;
+export type TicketRef = {
+    ticketId?: string;
+};
+export type WorkspaceRef = {
+    workspaceId?: string;
+};
+type TicketLike = {
+    id: string;
+    shorthand: string;
+};
+type WorkspaceLike = {
+    id: string;
+    workspace_shorthand: string;
+};
+export declare const firstMatch: <T extends {
+    id: string;
+}>(values: T[], ref: string | undefined, readName: (value: T) => string) => T | null;
+export declare const readTicketFromContext: (ctx: PluginHelperContext, ref: string | undefined) => TicketLike | null;
+export declare const readWorkspaceFromContext: (ctx: PluginHelperContext, ref: string | undefined) => WorkspaceLike | null;
+export declare const resolveSessionIdFromContext: (ctx: PluginHelperContext) => string | null;
+export {};

package/dist/plugins/helpers/create-attempt.d.ts

@@ -0,0 +1,5 @@
+import type { CreateTicketAttemptInput } from "../../api/tickets";
+import type { PluginHelperContext, TicketRef } from "./context";
+type CreateAttemptHelperInput = TicketRef & Omit<CreateTicketAttemptInput, "start_session">;
+export declare const createAttempt: (ctx: PluginHelperContext, input: CreateAttemptHelperInput) => Promise<import("../../api").TicketAttemptResponse | null>;
+export {};

package/dist/plugins/helpers/create-session.d.ts

@@ -0,0 +1,20 @@
+import type { CreateSessionInput } from "../../api/sessions";
+import type { PluginHelperContext } from "./context";
+type CreateSessionHelperInput = Omit<CreateSessionInput, "project_id">;
+export declare const createSession: (ctx: PluginHelperContext, input: CreateSessionHelperInput) => Promise<{
+    id: string;
+    project_id: string | null;
+    title: string;
+    status: "in_progress" | "awaiting_input" | "completed" | "failed" | "cancelled";
+    archived: boolean;
+    last_request_started: string | null;
+    last_request_ended: string | null;
+    agent: string | null;
+    agent_session_id: string | null;
+    session_file_id: string | null;
+    original_session_id: string | null;
+    cwd: string | null;
+    created_at: string;
+    updated_at: string;
+}>;
+export {};

package/dist/plugins/helpers/create-workspace.d.ts

@@ -0,0 +1,5 @@
+import type { CreateTicketAttemptInput } from "../../api/tickets";
+import type { PluginHelperContext, TicketRef } from "./context";
+type CreateWorkspaceHelperInput = TicketRef & Omit<CreateTicketAttemptInput, "agent" | "model" | "prompt" | "start_session">;
+export declare const createWorkspace: (ctx: PluginHelperContext, input: CreateWorkspaceHelperInput) => Promise<import("../../api").TicketAttemptResponse | null>;
+export {};

package/dist/plugins/helpers/find-ticket-by-ref.d.ts

@@ -0,0 +1,6 @@
+import { type PluginHelperContext, type TicketRef } from "./context";
+export declare const findTicketByRef: (ctx: PluginHelperContext, input: TicketRef) => Promise<{
+    id: string;
+    shorthand: string;
+} | null>;
+export declare const resolveTicketShorthand: (ctx: PluginHelperContext, input: TicketRef) => Promise<string | null>;

package/dist/plugins/helpers/find-workspace-by-ref.d.ts

@@ -0,0 +1,5 @@
+import { type PluginHelperContext, type WorkspaceRef } from "./context";
+export declare const findWorkspaceByRef: (ctx: PluginHelperContext, input: WorkspaceRef) => Promise<{
+    id: string;
+    workspace_shorthand: string;
+} | null>;

package/dist/plugins/helpers/followup-session.d.ts

@@ -0,0 +1,22 @@
+import type { FollowUpInput } from "../../api/sessions";
+import { type PluginHelperContext } from "./context";
+type FollowupSessionHelperInput = FollowUpInput & {
+    sessionId?: string;
+};
+export declare const followupSession: (ctx: PluginHelperContext, input: FollowupSessionHelperInput) => Promise<{
+    id: string;
+    project_id: string | null;
+    title: string;
+    status: "in_progress" | "awaiting_input" | "completed" | "failed" | "cancelled";
+    archived: boolean;
+    last_request_started: string | null;
+    last_request_ended: string | null;
+    agent: string | null;
+    agent_session_id: string | null;
+    session_file_id: string | null;
+    original_session_id: string | null;
+    cwd: string | null;
+    created_at: string;
+    updated_at: string;
+}>;
+export {};

package/dist/plugins/helpers/get-attempts-for-ticket.d.ts

@@ -0,0 +1,17 @@
+import type { PluginHelperContext, TicketRef } from "./context";
+export declare const getAttemptsForTicket: (ctx: PluginHelperContext, input: TicketRef) => Promise<{
+    id: string;
+    project_id: string;
+    name: string;
+    branch: string | null;
+    worktree_path: string | null;
+    attempt_status_id: string | null;
+    archived: boolean;
+    workspace_shorthand: string;
+    startup_log_file_id: string | null;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+    ticket_shorthand: string;
+    attempt_status_name: string | null;
+}[]>;

package/dist/plugins/helpers/index.d.ts

@@ -0,0 +1,15 @@
+export { createAttempt } from "./create-attempt";
+export { createSession } from "./create-session";
+export { createWorkspace } from "./create-workspace";
+export { findTicketByRef } from "./find-ticket-by-ref";
+export { findWorkspaceByRef } from "./find-workspace-by-ref";
+export { followupSession } from "./followup-session";
+export { getAttemptsForTicket } from "./get-attempts-for-ticket";
+export { removeAllWorktreesForTicket } from "./remove-all-worktrees-for-ticket";
+export { runCommand } from "./run-command";
+export { setTicketStatus } from "./set-ticket-status";
+export { setWorkspaceAttemptStatus } from "./set-workspace-attempt-status";
+export { type PullTicketsInput, type PullTicketsResult, pullTickets } from "./ticket-pull";
+export { updateTicketWhenAllAttemptsMatch } from "./update-ticket-when-all-attempts-match";
+export { workspacesForTicket } from "./workspaces-for-ticket";
+export { bootstrapWorktree } from "./worktree-bootstrap";

package/dist/plugins/helpers/remove-all-worktrees-for-ticket.d.ts

@@ -0,0 +1,2 @@
+import type { PluginHelperContext, TicketRef } from "./context";
+export declare const removeAllWorktreesForTicket: (ctx: PluginHelperContext, input: TicketRef) => Promise<number>;

package/dist/plugins/helpers/run-command.d.ts

@@ -0,0 +1,9 @@
+type CommandOutputOptions = {
+    quiet?: boolean;
+};
+export declare const runCommand: (cwd: string, command: string[], options?: CommandOutputOptions) => Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}>;
+export {};

package/dist/plugins/helpers/set-ticket-status.d.ts

@@ -0,0 +1,7 @@
+import type { PluginHelperContext } from "./context";
+type TicketStatusUpdateInput = {
+    ticket: string;
+    status: string;
+};
+export declare const setTicketStatus: (ctx: PluginHelperContext, input: TicketStatusUpdateInput) => Promise<boolean>;
+export {};

package/dist/plugins/helpers/set-workspace-attempt-status.d.ts

@@ -0,0 +1,7 @@
+import type { PluginHelperContext, WorkspaceRef } from "./context";
+type WorkspaceAttemptStatusInput = WorkspaceRef & {
+    statusName: string;
+    sessionId?: string;
+};
+export declare const setWorkspaceAttemptStatus: (ctx: PluginHelperContext, input: WorkspaceAttemptStatusInput) => Promise<boolean>;
+export {};

package/dist/plugins/helpers/ticket-pull.d.ts

@@ -0,0 +1,18 @@
+import type { PluginHelperContext } from "./context";
+type TicketPullRef = {
+    ticketId?: string;
+};
+type PullTicketsInput = TicketPullRef & {
+    rootPath: string;
+    force?: boolean;
+    log?: (message: string) => void;
+};
+type PullTicketsResult = {
+    pulledTicketShorthands: string[];
+    downloadedFileCount: number;
+};
+export declare const pullTickets: (ctx: PluginHelperContext, input: PullTicketsInput) => Promise<{
+    pulledTicketShorthands: string[];
+    downloadedFileCount: number;
+}>;
+export type { PullTicketsInput, PullTicketsResult };

package/dist/plugins/helpers/update-ticket-when-all-attempts-match.d.ts

@@ -0,0 +1,7 @@
+import type { PluginHelperContext, TicketRef } from "./context";
+type TicketAttemptStatusTransitionInput = TicketRef & {
+    allAttemptsStatus: string;
+    setStatus: string;
+};
+export declare const updateTicketWhenAllAttemptsMatch: (ctx: PluginHelperContext, input: TicketAttemptStatusTransitionInput) => Promise<boolean>;
+export {};

package/dist/plugins/helpers/workspaces-for-ticket.d.ts

@@ -0,0 +1,17 @@
+import type { PluginHelperContext, TicketRef } from "./context";
+export declare const workspacesForTicket: (ctx: PluginHelperContext, input: TicketRef) => Promise<{
+    id: string;
+    project_id: string;
+    name: string;
+    branch: string | null;
+    worktree_path: string | null;
+    attempt_status_id: string | null;
+    archived: boolean;
+    workspace_shorthand: string;
+    startup_log_file_id: string | null;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+    ticket_shorthand: string;
+    attempt_status_name: string | null;
+}[]>;

package/dist/plugins/helpers/worktree-bootstrap.d.ts

@@ -0,0 +1,8 @@
+import type { PluginHelperContext } from "./context";
+type BootstrapWorktreeInput = {
+    repoPath: string;
+    worktreePath: string;
+    ticketId?: string;
+};
+export declare const bootstrapWorktree: (ctx: PluginHelperContext, input: BootstrapWorktreeInput) => Promise<void>;
+export {};

package/dist/plugins/hooks.d.ts

@@ -0,0 +1,42 @@
+import type { AttemptStatusChangeContext } from "../hooks/attempt";
+import type { SessionHookContext } from "../hooks/session";
+import type { TicketContext, TicketCreationContext, TicketStatusChangeContext } from "../hooks/ticket";
+import type { CommitContext, ConflictContext, MergeContext, RebaseContext, WorktreeContext, WorktreeCreateContext, WorktreeRemoveContext } from "../hooks/worktree";
+export type HookResponse = {
+    reject?: boolean;
+    reason?: string;
+    data?: Record<string, unknown>;
+};
+export type PreHookReturn = HookResponse | undefined | Promise<HookResponse | undefined>;
+export type PostHookReturn = void | Promise<void>;
+export type PrePluginHooks = {
+    preTicketCreation?: (ctx: TicketCreationContext) => PreHookReturn;
+    preTicketStatusChange?: (ctx: TicketStatusChangeContext) => PreHookReturn;
+    preTicketArchive?: (ctx: TicketContext) => PreHookReturn;
+    preTicketDeletion?: (ctx: TicketContext) => PreHookReturn;
+    preWorktreeCreate?: (ctx: WorktreeCreateContext) => PreHookReturn;
+    preWorktreeRemove?: (ctx: WorktreeRemoveContext) => PreHookReturn;
+    preCommit?: (ctx: CommitContext) => PreHookReturn;
+    preRebase?: (ctx: RebaseContext) => PreHookReturn;
+    preMerge?: (ctx: MergeContext) => PreHookReturn;
+    preAttemptStatusChange?: (ctx: AttemptStatusChangeContext) => PreHookReturn;
+};
+export type PostPluginHooks = {
+    postTicketCreation?: (ctx: TicketContext) => PostHookReturn;
+    postTicketStatusChange?: (ctx: TicketStatusChangeContext) => PostHookReturn;
+    postTicketArchive?: (ctx: TicketContext) => PostHookReturn;
+    postTicketDeletion?: (ctx: TicketContext) => PostHookReturn;
+    postSessionStart?: (ctx: SessionHookContext) => PostHookReturn;
+    postSessionSuccess?: (ctx: SessionHookContext) => PostHookReturn;
+    postSessionFail?: (ctx: SessionHookContext) => PostHookReturn;
+    postSessionResume?: (ctx: SessionHookContext) => PostHookReturn;
+    postSessionAwaitInput?: (ctx: SessionHookContext) => PostHookReturn;
+    postWorktreeCreate?: (ctx: WorktreeContext) => PostHookReturn;
+    postWorktreeRemove?: (ctx: WorktreeRemoveContext) => PostHookReturn;
+    postCommit?: (ctx: CommitContext) => PostHookReturn;
+    postRebase?: (ctx: RebaseContext) => PostHookReturn;
+    postMerge?: (ctx: MergeContext) => PostHookReturn;
+    onConflict?: (ctx: ConflictContext) => PostHookReturn;
+    postAttemptStatusChange?: (ctx: AttemptStatusChangeContext) => PostHookReturn;
+};
+export type PluginHooks = PrePluginHooks & PostPluginHooks;

package/dist/plugins/index.d.ts

@@ -0,0 +1,5 @@
+export { renderPrompt } from "../prompts";
+export { definePlugin } from "./define-plugin";
+export { bootstrapWorktree, createAttempt, createSession, createWorkspace, findTicketByRef, findWorkspaceByRef, followupSession, getAttemptsForTicket, type PullTicketsInput, type PullTicketsResult, pullTickets, removeAllWorktreesForTicket, runCommand, setTicketStatus, setWorkspaceAttemptStatus, updateTicketWhenAllAttemptsMatch, workspacesForTicket, } from "./helpers";
+export type { HookResponse, PluginHooks, PostHookReturn, PostPluginHooks, PreHookReturn, PrePluginHooks, } from "./hooks";
+export type { ActionDefinition, ActionDescriptor, ActionInput, ActionParamDef, ActionParamValue, ActionPlacement, ActionTargetMap, ActionTriggerContext, AgentActionParam, AgentParamValue, LongTextActionParam, PluginDefinition, RepoActionParam, RepoParamValue, SelectActionParam, TargetType, TemplateSelectActionParam, TextActionParam, } from "./types";