@hold-rein/cli 0.0.0

package/dist/runtime/api/modules/agents/agent-types.d.ts

@@ -0,0 +1,198 @@
+import type { AgentHarnessEvent } from "@earendil-works/pi-agent-core";
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { TaskRow, WorkspaceRow } from "../../db";
+export interface StartAgentInput {
+    approvalPolicy?: ApprovalPolicy;
+    modelId: string;
+    prompt: string;
+    provider: string;
+    runtimeContributions?: BrowserRuntimeContributions;
+    thinkingLevel?: ThinkingLevel;
+    workspacePath: string;
+}
+export interface RunAgentInput extends Omit<StartAgentInput, "approvalPolicy" | "thinkingLevel"> {
+    approvalPolicy: ApprovalPolicy;
+    session?: AgentSessionMetadata;
+    taskId: string;
+    thinkingLevel: ThinkingLevel;
+}
+export interface BrowserRuntimeToolSchema {
+    description?: string;
+    inputSchema: unknown;
+    name: string;
+}
+export interface BrowserRuntimeSkill {
+    content: string;
+    description?: string;
+    name: string;
+}
+export interface BrowserRuntimeContributions {
+    skills?: BrowserRuntimeSkill[];
+    systemPrompts?: string[];
+    tools?: BrowserRuntimeToolSchema[];
+}
+export interface BrowserToolResultInput {
+    agentId: string;
+    content: string | StoredTextContent[];
+    isError?: boolean;
+    toolCallId: string;
+}
+export interface AgentSessionMetadata {
+    createdAt: string;
+    id: string;
+    path: string;
+}
+export interface AgentRunResult {
+    agentId: string;
+    session: AgentSessionMetadata;
+    status: "running";
+}
+export type ApprovalPolicy = "approval" | "run_all";
+export type { ThinkingLevel };
+export type InterruptTaskResult = {
+    agentId: string;
+    status: "interrupted";
+    taskId: string;
+} | {
+    status: "not_found" | "not_running";
+    taskId: string;
+};
+export interface StartAgentResult {
+    agentId: string;
+    sessionId: string;
+    status: "running";
+    task: TaskRow;
+    workspace: WorkspaceRow;
+}
+export interface TaskTitleResult {
+    id: string;
+    title: string;
+}
+export interface AgentEventEnvelope {
+    agentId: string;
+    payload?: unknown;
+    sequence: number;
+    timestamp: string;
+    type: string;
+}
+export interface TaskSubagentHistory {
+    agentId: string;
+    agentName: string;
+    messages: StoredAgentMessage[];
+    parentAgentId: string;
+    status: "running" | "completed" | "interrupted";
+}
+export interface TaskMessageHistory {
+    messages: StoredAgentMessage[];
+    subagents: TaskSubagentHistory[];
+}
+export interface AgentEventSubscription {
+    unsubscribe: () => void;
+}
+export interface SubscribeAgentEventsInput {
+    afterSequence?: number;
+    agentId: string;
+}
+export interface ApprovalDecisionInput {
+    agentId: string;
+    approvalId: string;
+    approved: boolean;
+    reason?: string;
+}
+export interface ApprovalDecisionResult extends ApprovalDecisionInput {
+}
+export interface ApprovalDecision {
+    approved: boolean;
+    reason?: string;
+}
+export interface ToolApprovalRequest {
+    agentId: string;
+    approvalId: string;
+    title?: string;
+    tool: {
+        description?: string;
+        input: unknown;
+        label?: string;
+        name: string;
+        toolCallId: string;
+    };
+}
+export type HarnessEvent = AgentHarnessEvent;
+export interface StoredTextContent {
+    text: string;
+    textSignature?: string;
+    type: "text";
+}
+export interface StoredThinkingContent {
+    redacted?: boolean;
+    thinking: string;
+    thinkingSignature?: string;
+    type: "thinking";
+}
+export interface StoredImageContent {
+    data: string;
+    mimeType: string;
+    type: "image";
+}
+export interface StoredToolCall {
+    arguments: Record<string, unknown>;
+    id: string;
+    name: string;
+    thoughtSignature?: string;
+    type: "toolCall";
+}
+export type StoredUserContent = StoredTextContent | StoredImageContent;
+export type StoredAssistantContent = StoredTextContent | StoredThinkingContent | StoredToolCall;
+interface StoredMessageBase {
+    id: string;
+    timestamp: number;
+}
+export interface StoredUserMessage extends StoredMessageBase {
+    content: string | StoredUserContent[];
+    role: "user";
+}
+export interface StoredAssistantMessage extends StoredMessageBase {
+    api: string;
+    content: StoredAssistantContent[];
+    errorMessage?: string;
+    model: string;
+    provider: string;
+    role: "assistant";
+    stopReason: "stop" | "length" | "toolUse" | "error" | "aborted";
+}
+export interface StoredToolResultMessage extends StoredMessageBase {
+    content: StoredUserContent[];
+    isError: boolean;
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+}
+export interface StoredBashExecutionMessage extends StoredMessageBase {
+    cancelled: boolean;
+    command: string;
+    excludeFromContext?: boolean;
+    exitCode?: number;
+    fullOutputPath?: string;
+    output: string;
+    role: "bashExecution";
+    truncated: boolean;
+}
+export interface StoredCustomMessage extends StoredMessageBase {
+    content: string | StoredUserContent[];
+    customType: string;
+    details?: unknown;
+    display: boolean;
+    role: "custom";
+}
+export interface StoredBranchSummaryMessage extends StoredMessageBase {
+    fromId: string;
+    role: "branchSummary";
+    summary: string;
+}
+export interface StoredCompactionSummaryMessage extends StoredMessageBase {
+    role: "compactionSummary";
+    summary: string;
+    tokensBefore: number;
+}
+export type StoredAgentMessage = StoredUserMessage | StoredAssistantMessage | StoredToolResultMessage | StoredBashExecutionMessage | StoredCustomMessage | StoredBranchSummaryMessage | StoredCompactionSummaryMessage;
+//# sourceMappingURL=agent-types.d.ts.map

package/dist/runtime/api/modules/agents/agent-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-types.d.ts","sourceRoot":"","sources":["../../../src/modules/agents/agent-types.ts"],"names":[],"mappings":"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"}

package/dist/runtime/api/modules/agents/agent-types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/api/modules/agents/agents-router.d.ts

@@ -0,0 +1,7 @@
+import { Router } from "express";
+import type { AgentsService } from "./agents-service";
+export interface CreateAgentsRouterOptions {
+    agentsService?: AgentsService;
+}
+export declare function createAgentsRouter(options?: CreateAgentsRouterOptions): Router;
+//# sourceMappingURL=agents-router.d.ts.map

package/dist/runtime/api/modules/agents/agents-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-router.d.ts","sourceRoot":"","sources":["../../../src/modules/agents/agents-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAwBD,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,MAAM,CA0SR"}

package/dist/runtime/api/modules/agents/agents-router.js

@@ -0,0 +1,210 @@
+import { Router } from "express";
+import { sendError, sendSuccess } from "../../response/index.js";
+import { RESPONSE_CODE_DEFINITIONS } from "../../response/response-codes.js";
+import { getDefaultAgentsService } from "./default-agents-service.js";
+export function createAgentsRouter(options = {}) {
+    const router = Router();
+    const getService = () => options.agentsService ?? getDefaultAgentsService();
+    router.post("/agents/start", (request, response) => {
+        const input = parseStartAgentBody(request.body);
+        if (!input) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "workspacePath, provider, modelId and prompt must be strings");
+            return;
+        }
+        void getService()
+            .startAgent(input)
+            .then((result) => {
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to start agent");
+        });
+    });
+    router.get("/agents/tasks/:taskId/messages", (request, response) => {
+        void getService()
+            .listTaskMessages({ taskId: request.params.taskId })
+            .then((messages) => sendSuccess(response, messages))
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to load task messages");
+        });
+    });
+    router.patch("/agents/tasks/:taskId", (request, response) => {
+        const title = typeof request.body.title === "string" ? request.body.title.trim() : "";
+        if (!title) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "title must be a non-empty string");
+            return;
+        }
+        void getService()
+            .renameTask({ taskId: request.params.taskId, title })
+            .then((result) => {
+            if (!result) {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to rename task");
+        });
+    });
+    router.delete("/agents/tasks/:taskId", (request, response) => {
+        void getService()
+            .deleteTask({ taskId: request.params.taskId })
+            .then((result) => {
+            if (result.status === "not_found") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            if (result.status === "running") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.conflict, "Task is running");
+                return;
+            }
+            sendSuccess(response, { taskId: result.taskId });
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to delete task");
+        });
+    });
+    router.post("/agents/tasks/:taskId/continue", (request, response) => {
+        const input = parseContinueTaskBody(request.body, request.params.taskId);
+        if (!input) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "prompt must be a string and provider and modelId must both be strings when provided");
+            return;
+        }
+        void getService()
+            .continueTask(input)
+            .then((result) => {
+            if (!result) {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to continue task");
+        });
+    });
+    router.post("/agents/tasks/:taskId/interrupt", (request, response) => {
+        void getService()
+            .interruptTask({ taskId: request.params.taskId })
+            .then((result) => {
+            if (result.status === "not_found") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            if (result.status === "not_running") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.conflict, "Task is not running");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to interrupt task");
+        });
+    });
+    router.get("/agents/tasks/:taskId/title", (request, response) => {
+        void getService()
+            .getTaskTitle({ taskId: request.params.taskId })
+            .then((result) => {
+            if (!result) {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to get task title");
+        });
+    });
+    router.get("/agents/:agentId/events", (request, response) => {
+        const afterSequence = parseAfterSequence(request.query.afterSequence);
+        if (afterSequence === null) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "afterSequence must be a non-negative integer");
+            return;
+        }
+        response.status(200);
+        response.setHeader("Content-Type", "application/x-ndjson");
+        response.setHeader("Cache-Control", "no-cache");
+        response.setHeader("Connection", "keep-alive");
+        response.flushHeaders();
+        const subscription = getService().subscribeToAgentEvents({
+            ...(afterSequence === undefined ? {} : { afterSequence }),
+            agentId: request.params.agentId
+        }, (event) => {
+            writeNdjsonEvent(response, event);
+        });
+        request.on("close", () => {
+            subscription.unsubscribe();
+        });
+    });
+    router.post("/agents/:agentId/approvals/:approvalId", (request, response) => {
+        if (typeof request.body.approved !== "boolean") {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "approved must be a boolean");
+            return;
+        }
+        if (request.body.reason !== undefined &&
+            typeof request.body.reason !== "string") {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "reason must be a string");
+            return;
+        }
+        void getService()
+            .approveAgentAction({
+            agentId: request.params.agentId,
+            approvalId: request.params.approvalId,
+            approved: request.body.approved,
+            ...(request.body.reason === undefined
+                ? {}
+                : { reason: request.body.reason })
+        })
+            .then((result) => {
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, error instanceof Error ? error.message : "Unknown approval request");
+        });
+    });
+    return router;
+}
+function parseContinueTaskBody(body, taskId) {
+    if (typeof body.prompt !== "string") {
+        return null;
+    }
+    if (body.provider === undefined && body.modelId === undefined) {
+        return { prompt: body.prompt, taskId };
+    }
+    if (typeof body.provider !== "string" || typeof body.modelId !== "string") {
+        return null;
+    }
+    return {
+        modelId: body.modelId,
+        prompt: body.prompt,
+        provider: body.provider,
+        taskId
+    };
+}
+function parseStartAgentBody(body) {
+    if (typeof body.workspacePath !== "string" ||
+        typeof body.provider !== "string" ||
+        typeof body.modelId !== "string" ||
+        typeof body.prompt !== "string") {
+        return null;
+    }
+    return {
+        modelId: body.modelId,
+        prompt: body.prompt,
+        provider: body.provider,
+        workspacePath: body.workspacePath
+    };
+}
+function parseAfterSequence(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string" || !/^\d+$/.test(value)) {
+        return null;
+    }
+    return Number(value);
+}
+function writeNdjsonEvent(response, event) {
+    response.write(`${JSON.stringify(event)}\n`);
+}

package/dist/runtime/api/modules/agents/agents-service.d.ts

@@ -0,0 +1,52 @@
+import type { ModelProvidersService } from "../model-providers/model-providers-service";
+import type { WorkspaceRepository } from "../workspaces/workspace-repository";
+import type { AgentApprovalStore } from "./agent-approval-store";
+import type { ActiveTaskRunRegistry } from "./active-task-run-registry";
+import type { AgentEventBus, AgentEventListener } from "./agent-event-bus";
+import type { AgentRuntime } from "./agent-runtime";
+import type { TaskTitleGenerator } from "./agent-task-title-generator";
+import { type DeleteTaskResult } from "./agent-task-actions";
+import type { AgentEventSubscription, ApprovalDecisionInput, ApprovalDecisionResult, InterruptTaskResult, StartAgentInput, StartAgentResult, SubscribeAgentEventsInput, TaskMessageHistory, TaskTitleResult } from "./agent-types";
+import { type SubagentRepository } from "./subagent-repository";
+export interface AgentsService {
+    approveAgentAction: (input: ApprovalDecisionInput) => Promise<ApprovalDecisionResult>;
+    deleteTask: (input: GetTaskTitleInput) => Promise<DeleteTaskResult>;
+    getTaskTitle: (input: GetTaskTitleInput) => Promise<TaskTitleResult | null>;
+    interruptTask: (input: GetTaskTitleInput) => Promise<InterruptTaskResult>;
+    continueTask: (input: ContinueTaskInput) => Promise<StartAgentResult | null>;
+    listTaskMessages: (input: GetTaskTitleInput) => Promise<TaskMessageHistory>;
+    renameTask: (input: RenameTaskInput) => Promise<TaskTitleResult | null>;
+    startAgent: (input: StartAgentInput) => Promise<StartAgentResult>;
+    subscribeToAgentEvents: (input: SubscribeAgentEventsInput, listener: AgentEventListener) => AgentEventSubscription;
+}
+export interface GetTaskTitleInput {
+    taskId: string;
+}
+export interface RenameTaskInput extends GetTaskTitleInput {
+    title: string;
+}
+interface ContinueTaskBaseInput {
+    prompt: string;
+    taskId: string;
+}
+export type ContinueTaskInput = ContinueTaskBaseInput & ({
+    modelId: string;
+    provider: string;
+} | {
+    modelId?: never;
+    provider?: never;
+});
+export interface CreateAgentsServiceOptions {
+    activeTaskRuns?: ActiveTaskRunRegistry;
+    approvalStore: AgentApprovalStore;
+    eventBus: AgentEventBus;
+    modelProvidersService?: ModelProvidersService;
+    now?: () => Date;
+    repository: WorkspaceRepository;
+    runtime: AgentRuntime;
+    subagentRepository?: SubagentRepository;
+    titleGenerator: TaskTitleGenerator;
+}
+export declare function createAgentsService(options: CreateAgentsServiceOptions): AgentsService;
+export {};
+//# sourceMappingURL=agents-service.d.ts.map

package/dist/runtime/api/modules/agents/agents-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-service.d.ts","sourceRoot":"","sources":["../../../src/modules/agents/agents-service.ts"],"names":[],"mappings":"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"}