@beeuni/sdk 0.1.0

package/dist/core/runtime/beeuni-master.d.ts

@@ -0,0 +1,477 @@
+export type BeeuniTaskStatus = 'todo' | 'in_progress' | 'input_needed' | 'awaiting_review' | 'completed' | 'cancelled';
+export interface BeeuniTask {
+    id: string;
+    project_id: string;
+    title: string;
+    description: string;
+    verification_condition: string;
+    status: BeeuniTaskStatus;
+    result: string | null;
+    verification_summary: string | null;
+    blocking_question: string | null;
+    owner_session_id: string | null;
+    owner_agent: string | null;
+    requested_by_session_id: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface BeeuniTaskEvent {
+    id: string;
+    task_id: string;
+    project_id: string;
+    session_id: string | null;
+    type: 'progress' | 'blocker' | 'evidence' | 'verification_started' | 'verification_passed' | 'verification_failed' | 'delivered';
+    message: string | null;
+    payload_json: string | null;
+    created_at: string;
+}
+export interface BeeuniTaskLiveStatus {
+    task_id: string;
+    status: BeeuniTaskStatus;
+    latest_run_id: string | null;
+    run_status: 'running' | 'input_needed' | 'awaiting_review' | 'completed' | 'cancelled' | 'failed' | null;
+    owner_session_id: string | null;
+    detail: string;
+}
+export interface ListTasksParams {
+    projectId?: string;
+    status?: string;
+}
+export interface CreateTaskInput {
+    project_id: string;
+    title: string;
+    description?: string;
+    verification_condition?: string;
+    status?: BeeuniTaskStatus;
+}
+export declare function listTasks(baseUrl: string, params?: ListTasksParams): Promise<unknown[]>;
+export declare function getTask(baseUrl: string, id: string): Promise<unknown>;
+export declare function listTaskEvents(baseUrl: string, id: string): Promise<BeeuniTaskEvent[]>;
+export declare function getTaskStatus(baseUrl: string, id: string): Promise<BeeuniTaskLiveStatus>;
+export declare function createTask(baseUrl: string, data: CreateTaskInput): Promise<BeeuniTask>;
+export declare function updateTask(baseUrl: string, id: string, data: Partial<BeeuniTask>): Promise<BeeuniTask>;
+export declare function startTask(baseUrl: string, id: string): Promise<BeeuniTask>;
+export declare function approveTask(baseUrl: string, id: string): Promise<BeeuniTask>;
+export declare function deleteTask(baseUrl: string, id: string): Promise<{
+    deleted: boolean;
+}>;
+export type AssigneeType = 'user' | 'agent';
+export type ActorType = 'user' | 'agent' | 'system';
+export type ExecutionMode = 'per_ticket' | 'per_assignment' | 'persistent';
+export type ToolGroup = 'project_action' | 'project_manage';
+export interface TicketAssignee {
+    ticket_id: string;
+    assignee_type: AssigneeType;
+    assignee_id: string;
+    assigned_at: string;
+}
+export interface TicketColumn {
+    id: string;
+    project_id: string;
+    key: string;
+    label: string;
+    order_index: number;
+    default_assignee_type: AssigneeType | null;
+    default_assignee_id: string | null;
+    is_terminal: number;
+    is_off_flow: number;
+    icon: string | null;
+}
+export interface Ticket {
+    id: string;
+    project_id: string;
+    number: number;
+    title: string;
+    body_md: string;
+    status: string;
+    template_id: string | null;
+    custom_fields_json: string;
+    created_by_type: ActorType;
+    created_by_id: string | null;
+    parent_id: string | null;
+    milestone_id: string | null;
+    created_at: string;
+    updated_at: string;
+    assignees: TicketAssignee[];
+    column?: TicketColumn | null;
+}
+export interface TicketEvent {
+    id: string;
+    ticket_id: string;
+    project_id: string;
+    actor_type: ActorType;
+    actor_id: string | null;
+    type: string;
+    message: string | null;
+    payload_json: string | null;
+    created_at: string;
+}
+export interface ProjectField {
+    id: string;
+    project_id: string;
+    key: string;
+    label: string;
+    type: 'text' | 'number' | 'date' | 'select';
+    options_json: string | null;
+    order_index: number;
+}
+export interface TicketTemplate {
+    id: string;
+    project_id: string;
+    name: string;
+    body_md: string;
+    created_at: string;
+}
+export interface ProjectAgent {
+    id: string;
+    project_id: string;
+    slug: string;
+    name: string;
+    file_path: string;
+    session_id: string | null;
+    execution_mode: ExecutionMode;
+    tool_groups_json: string;
+    default_assignee_columns_json: string;
+    default_model: string | null;
+    color_hue: number | null;
+    icon: string | null;
+    created_at: string;
+}
+export interface TriggeredAgent {
+    agent_id: string;
+    agent_slug: string;
+    reason: string;
+}
+export interface CreateTicketInput {
+    project_id: string;
+    title: string;
+    body_md?: string;
+    status?: string;
+    template_id?: string | null;
+    custom_fields?: Record<string, unknown>;
+    assign_to?: Array<{
+        type: AssigneeType;
+        id: string;
+    }>;
+    milestone_id?: string | null;
+    parent_id?: string | null;
+    actor_type: ActorType;
+    actor_id: string;
+    created_by_type: ActorType;
+    created_by_id: string;
+}
+export interface UpdateTicketInput {
+    title?: string;
+    body_md?: string;
+    template_id?: string | null;
+    custom_fields?: Record<string, unknown>;
+    milestone_id?: string | null;
+    actor_type: ActorType;
+    actor_id: string;
+}
+export declare function listTickets(baseUrl: string, projectId?: string): Promise<Ticket[]>;
+export declare function getTicket(baseUrl: string, id: string): Promise<Ticket>;
+export declare function listTicketEvents(baseUrl: string, id: string): Promise<TicketEvent[]>;
+export declare function createTicket(baseUrl: string, body: CreateTicketInput): Promise<{
+    ticket: Ticket;
+    triggered: TriggeredAgent[];
+}>;
+export declare function updateTicket(baseUrl: string, id: string, body: Partial<UpdateTicketInput>): Promise<Ticket>;
+export declare function updateTicketStatus(baseUrl: string, id: string, body: {
+    status: string;
+    actor_type: ActorType;
+    actor_id: string;
+}): Promise<{
+    ticket: Ticket;
+    triggered: TriggeredAgent[];
+}>;
+export declare function assignTicket(baseUrl: string, id: string, body: {
+    assignee_type: AssigneeType;
+    assignee_id: string;
+    actor_type: ActorType;
+    actor_id: string;
+}): Promise<{
+    added: boolean;
+    ticket: Ticket;
+}>;
+export declare function unassignTicket(baseUrl: string, id: string, body: {
+    assignee_type: AssigneeType;
+    assignee_id: string;
+    actor_type: ActorType;
+    actor_id: string;
+}): Promise<{
+    removed: boolean;
+    ticket: Ticket;
+}>;
+export declare function commentTicket(baseUrl: string, id: string, body: {
+    body: string;
+    actor_type: ActorType;
+    actor_id: string;
+}): Promise<{
+    event: TicketEvent;
+    mentions: string[];
+    triggered: Array<{
+        agent_slug: string;
+    }>;
+}>;
+export declare function deleteTicket(baseUrl: string, id: string): Promise<{
+    deleted: true;
+}>;
+export interface ReplaceColumnInput {
+    key: string;
+    label: string;
+    default_assignee_type?: AssigneeType | null;
+    default_assignee_id?: string | null;
+    is_terminal?: boolean;
+    is_off_flow?: boolean;
+    icon?: string | null;
+}
+export declare function listColumns(baseUrl: string, projectId: string): Promise<TicketColumn[]>;
+export declare function replaceColumns(baseUrl: string, projectId: string, columns: ReplaceColumnInput[]): Promise<TicketColumn[]>;
+export interface ReplaceFieldInput {
+    key: string;
+    label: string;
+    type: 'text' | 'number' | 'date' | 'select';
+    options?: string[] | null;
+}
+export declare function listFields(baseUrl: string, projectId: string): Promise<ProjectField[]>;
+export declare function replaceFields(baseUrl: string, projectId: string, fields: ReplaceFieldInput[]): Promise<ProjectField[]>;
+export interface ReplaceTemplateInput {
+    name: string;
+    body_md: string;
+}
+export declare function listTemplates(baseUrl: string, projectId: string): Promise<TicketTemplate[]>;
+export declare function replaceTemplates(baseUrl: string, projectId: string, templates: ReplaceTemplateInput[]): Promise<TicketTemplate[]>;
+export declare function ensurePmSession(baseUrl: string, projectId: string): Promise<{
+    session_id: string;
+    reused: boolean;
+}>;
+export interface CreateProjectAgentInput {
+    slug: string;
+    name: string;
+    body_md: string;
+    execution_mode?: ExecutionMode;
+    tool_groups?: ToolGroup[];
+    default_assignee_columns?: string[];
+    default_model?: string | null;
+    color_hue?: number | null;
+    icon?: string | null;
+}
+export type UpdateProjectAgentInput = Partial<Omit<CreateProjectAgentInput, 'slug'>>;
+export declare function listProjectAgents(baseUrl: string, projectId: string): Promise<ProjectAgent[]>;
+export declare function createProjectAgent(baseUrl: string, projectId: string, body: CreateProjectAgentInput): Promise<ProjectAgent>;
+export declare function updateProjectAgent(baseUrl: string, projectId: string, slug: string, body: UpdateProjectAgentInput): Promise<ProjectAgent>;
+export declare function deleteProjectAgent(baseUrl: string, projectId: string, slug: string): Promise<{
+    deleted: true;
+}>;
+export declare function getAgentPersona(baseUrl: string, projectId: string, slug: string): Promise<{
+    agent: ProjectAgent;
+    body_md: string;
+}>;
+export declare function getProjectActivity(baseUrl: string, projectId: string, limit?: number): Promise<TicketEvent[]>;
+export interface BeeuniMasterProject {
+    id: string;
+    name: string;
+    path: string;
+    description: string;
+    created_at: string;
+    opencode_id: string | null;
+    structure_version?: number;
+    sessionCount?: number;
+    worktree?: string;
+    time?: {
+        created: number;
+        updated: number;
+        initialized?: number;
+    };
+}
+export type BeeuniProject = BeeuniMasterProject;
+export interface PatchBeeuniMasterProjectInput {
+    name?: string;
+    description?: string;
+    user_handle?: string | null;
+}
+export type PatchBeeuniProjectInput = PatchBeeuniMasterProjectInput;
+export declare function listBeeuniProjects(baseUrl: string): Promise<BeeuniMasterProject[]>;
+export declare function getBeeuniProject(baseUrl: string, id: string): Promise<BeeuniMasterProject>;
+export declare function getBeeuniProjectBySession(baseUrl: string, sessionId: string): Promise<BeeuniMasterProject>;
+export declare function listBeeuniProjectSessions(baseUrl: string, projectId: string): Promise<unknown[]>;
+export declare function deleteBeeuniProject(baseUrl: string, id: string): Promise<{
+    deleted: boolean;
+    name: string;
+    path: string;
+}>;
+export declare function patchBeeuniProject(baseUrl: string, id: string, body: PatchBeeuniMasterProjectInput): Promise<BeeuniMasterProject>;
+export type MilestoneStatus = 'open' | 'closed' | 'cancelled';
+export interface MilestoneProgress {
+    total: number;
+    done: number;
+    in_progress: number;
+    blocked: number;
+    review: number;
+    other: number;
+}
+export interface Milestone {
+    id: string;
+    project_id: string;
+    number: number;
+    title: string;
+    description_md: string;
+    acceptance_md: string;
+    status: MilestoneStatus;
+    due_at: string | null;
+    completed_at: string | null;
+    closed_by_type: 'user' | 'agent' | 'system' | null;
+    closed_by_id: string | null;
+    created_by_type: 'user' | 'agent' | 'system';
+    created_by_id: string | null;
+    color_hue: number | null;
+    icon: string | null;
+    created_at: string;
+    updated_at: string;
+    progress: MilestoneProgress;
+    percent_complete: number;
+}
+export interface MilestoneDetail extends Milestone {
+    tickets: Ticket[];
+}
+export interface MilestoneEvent {
+    id: string;
+    milestone_id: string;
+    project_id: string;
+    actor_type: 'user' | 'agent' | 'system';
+    actor_id: string | null;
+    type: string;
+    message: string | null;
+    payload_json: string | null;
+    created_at: string;
+}
+export interface CreateMilestoneBody {
+    title: string;
+    description_md?: string;
+    acceptance_md?: string;
+    due_at?: string | null;
+    color_hue?: number | null;
+    icon?: string | null;
+}
+export type UpdateMilestoneBody = Partial<Pick<Milestone, 'title' | 'description_md' | 'acceptance_md' | 'due_at' | 'color_hue' | 'icon'>>;
+export declare function listMilestones(baseUrl: string, projectId: string, statusFilter?: 'open' | 'closed' | 'all'): Promise<Milestone[]>;
+export declare function getMilestone(baseUrl: string, projectId: string, ref: string): Promise<MilestoneDetail>;
+export declare function listMilestoneEvents(baseUrl: string, projectId: string, ref: string): Promise<MilestoneEvent[]>;
+export declare function createMilestone(baseUrl: string, projectId: string, body: CreateMilestoneBody): Promise<Milestone>;
+export declare function updateMilestone(baseUrl: string, projectId: string, ref: string, patch: UpdateMilestoneBody): Promise<Milestone>;
+export declare function closeMilestone(baseUrl: string, projectId: string, ref: string, body: {
+    summary_md?: string;
+    cancelled?: boolean;
+}): Promise<Milestone>;
+export declare function reopenMilestone(baseUrl: string, projectId: string, ref: string): Promise<Milestone>;
+export declare function deleteMilestone(baseUrl: string, projectId: string, ref: string): Promise<{
+    ok: boolean;
+}>;
+export interface CredentialItem {
+    id: string;
+    name: string;
+    description: string | null;
+    created_at: string;
+    updated_at: string;
+    last_read_at: string | null;
+}
+export interface CredentialWithValue extends CredentialItem {
+    value: string;
+}
+export interface CredentialEvent {
+    id: string;
+    project_id: string;
+    credential_id: string | null;
+    credential_name: string;
+    actor_type: 'user' | 'agent' | 'system';
+    actor_id: string | null;
+    action: string;
+    message: string | null;
+    created_at: string;
+}
+export interface UpsertCredentialBody {
+    name: string;
+    value: string;
+    description?: string | null;
+}
+export declare function listCredentials(baseUrl: string, projectId: string): Promise<CredentialItem[]>;
+export declare function listCredentialEvents(baseUrl: string, projectId: string, name: string): Promise<CredentialEvent[]>;
+export declare function upsertCredential(baseUrl: string, projectId: string, body: UpsertCredentialBody): Promise<CredentialItem>;
+export declare function revealCredential(baseUrl: string, projectId: string, name: string): Promise<CredentialWithValue>;
+export declare function deleteCredential(baseUrl: string, projectId: string, name: string): Promise<{
+    ok: boolean;
+}>;
+export type SandboxServiceStatus = 'running' | 'stopped' | 'starting' | 'failed' | 'backoff';
+export type SandboxServiceAdapter = 'spawn' | 's6';
+export type SandboxServiceScope = 'bootstrap' | 'core' | 'project' | 'session';
+export type SandboxServiceAction = 'start' | 'stop' | 'restart' | 'delete';
+export interface SandboxService {
+    id: string;
+    name: string;
+    port: number;
+    pid: number;
+    framework: string;
+    sourcePath: string;
+    startedAt: string;
+    status: SandboxServiceStatus;
+    managed: boolean;
+    adapter?: SandboxServiceAdapter;
+    scope?: SandboxServiceScope;
+    desiredState?: 'running' | 'stopped';
+    builtin?: boolean;
+    autoStart?: boolean;
+}
+export interface SandboxServiceTemplate {
+    id: string;
+    name: string;
+    description: string;
+    adapter: SandboxServiceAdapter;
+    framework?: string;
+    startCommand?: string;
+    installCommand?: string | null;
+    buildCommand?: string | null;
+    defaultPort?: number;
+}
+export interface RegisterSandboxServicePayload {
+    id: string;
+    name?: string;
+    adapter?: SandboxServiceAdapter;
+    scope?: SandboxServiceScope;
+    description?: string;
+    projectId?: string | null;
+    template?: string | null;
+    framework?: string | null;
+    sourcePath?: string | null;
+    startCommand?: string | null;
+    installCommand?: string | null;
+    buildCommand?: string | null;
+    envVarKeys?: string[];
+    deps?: string[];
+    port?: number | null;
+    desiredState?: 'running' | 'stopped';
+    autoStart?: boolean;
+    restartPolicy?: 'always' | 'on-failure' | 'never';
+    restartDelayMs?: number;
+    s6ServiceName?: string | null;
+    processPatterns?: string[];
+    userVisible?: boolean;
+    healthCheck?: {
+        type?: 'none' | 'tcp' | 'http';
+        path?: string;
+        timeoutMs?: number;
+    };
+    startNow?: boolean;
+}
+export declare function listServices(baseUrl: string, includeAll?: boolean): Promise<SandboxService[]>;
+export declare function listServiceTemplates(baseUrl: string): Promise<SandboxServiceTemplate[]>;
+export declare function getServiceLogs(baseUrl: string, serviceId: string): Promise<string[]>;
+export declare function serviceAction(baseUrl: string, serviceId: string, action: SandboxServiceAction): Promise<unknown>;
+export declare function reconcileServices(baseUrl: string, reload?: boolean): Promise<unknown>;
+export declare function registerService(baseUrl: string, payload: RegisterSandboxServicePayload): Promise<{
+    success: boolean;
+    output?: string;
+    service?: SandboxService;
+}>;