@hachej/boring-automation 0.1.71 → 0.1.79

package/dist/server/index.d.ts

@@ -1,7 +1,10 @@
+import { WorkspaceAgentDispatcherResolver } from '@hachej/boring-agent/server';
+import { FastifyRequest, FastifyInstance } from 'fastify';
+import { WorkspaceAgentServerPluginContext } from '@hachej/boring-workspace/app/server';
 import { WorkspaceServerPlugin } from '@hachej/boring-workspace/server';
-import { Automation, AutomationCreate, AutomationPatch, AutomationRunCreate, AutomationRun, AutomationRunPatch, BoringAutomationErrorCode } from '../shared/index.js';
-export { AutomationCreateInput, AutomationCreateSchema, AutomationPatchInput, AutomationPatchSchema, AutomationRunCreateInput, AutomationRunCreateSchema, AutomationRunPatchInput, AutomationRunPatchSchema, AutomationRunStatus, AutomationRunStatusSchema, AutomationRunTrigger, AutomationRunTriggerSchema, BORING_AUTOMATION_ERROR_CODES, BORING_AUTOMATION_PLUGIN_ID, BORING_AUTOMATION_PLUGIN_LABEL, BORING_AUTOMATION_ROUTE_PREFIX, IdParamsSchema, PromptUpdateSchema } from '../shared/index.js';
-import { FastifyInstance } from 'fastify';
+import { Automation, AutomationCreate, AutomationPatch, AutomationRunBegin, AutomationRun, AutomationRunLifecyclePatch, BoringAutomationErrorCode, AutomationScheduleDecision } from '../shared/index.js';
+export { AUTOMATION_SCHEDULE_ERRORS, AutomationCreateInput, AutomationCreateSchema, AutomationPatchInput, AutomationPatchSchema, AutomationRunBeginInput, AutomationRunBeginSchema, AutomationRunLifecyclePatchInput, AutomationRunLifecyclePatchSchema, AutomationRunStatus, AutomationRunStatusSchema, AutomationRunTrigger, AutomationRunTriggerSchema, AutomationScheduleDueDecision, AutomationScheduleDueReason, AutomationScheduleSkipDecision, AutomationScheduleSkipReason, AutomationScheduleValidationResult, BORING_AUTOMATION_ERROR_CODES, BORING_AUTOMATION_PLUGIN_ID, BORING_AUTOMATION_PLUGIN_LABEL, BORING_AUTOMATION_ROUTE_PREFIX, EvaluateAutomationScheduleInput, EvaluateAutomationScheduleResult, IdParamsSchema, PromptUpdateSchema, evaluateAutomationSchedule, isValidFiveFieldCron, isValidIanaTimeZone, validateAutomationSchedule } from '../shared/index.js';
+import postgres from 'postgres';
 import 'zod';
 
 /** Plugin-local dependency injection seam for the single-workspace automation store. */
@@ -13,10 +16,10 @@ interface AutomationStore {
     deleteAutomation(id: string): Promise<void>;
     getPrompt(automationId: string): Promise<string>;
     updatePrompt(automationId: string, body: string): Promise<void>;
-    createRun(input: AutomationRunCreate): Promise<AutomationRun>;
-    updateRun(runId: string, patch: AutomationRunPatch): Promise<AutomationRun>;
+    reconcileOrphanedRuns(automationId: string): Promise<void>;
+    beginRun(input: AutomationRunBegin): Promise<AutomationRun>;
+    updateRunLifecycle(runId: string, patch: AutomationRunLifecyclePatch): Promise<AutomationRun>;
     listRuns(automationId: string): Promise<AutomationRun[]>;
-    findRunningRun(automationId: string): Promise<AutomationRun | null>;
 }
 declare class AutomationStoreError extends Error {
     readonly code: BoringAutomationErrorCode;
@@ -24,17 +27,90 @@ declare class AutomationStoreError extends Error {
 }
 declare function automationNotFound(id: string): AutomationStoreError;
 declare function runNotFound(id: string): AutomationStoreError;
+declare function runAlreadyActive(automationId: string): AutomationStoreError;
+declare function runAlreadyRecorded(automationId: string, scheduledFor: string): AutomationStoreError;
+
+interface VerifiedAutomationActor {
+    workspaceId: string;
+    userId: string;
+}
+interface ManualRunExecutorOptions {
+    store: AutomationStore;
+    storeForRequest?: (request: FastifyRequest, actor: VerifiedAutomationActor) => Promise<AutomationStore> | AutomationStore;
+    dispatcherResolver: WorkspaceAgentDispatcherResolver;
+    actorResolver: (request: FastifyRequest) => Promise<VerifiedAutomationActor> | VerifiedAutomationActor;
+    clock?: () => Date;
+}
+interface ManualRunInput {
+    automationId: string;
+    request: FastifyRequest;
+    trigger?: "manual" | "scheduled";
+    scheduledFor?: string | null;
+}
+declare class ManualRunExecutor {
+    private readonly options;
+    private readonly clock;
+    constructor(options: ManualRunExecutorOptions);
+    run(input: ManualRunInput): Promise<AutomationRun>;
+    private finalizeRun;
+    private nowIso;
+}
+declare function parseAutomationModel(value: string): {
+    provider: string;
+    id: string;
+};
+
+type DueRunSummary = Pick<AutomationRun, "id" | "automationId" | "sessionId" | "status" | "trigger" | "scheduledFor" | "startedAt" | "completedAt" | "durationMs" | "inputTokens" | "outputTokens" | "totalTokens">;
+type DueRunOutcome = {
+    kind: "started";
+    automationId: string;
+    scheduledFor: string;
+    run: DueRunSummary;
+} | {
+    kind: "skipped";
+    automationId: string;
+    scheduledFor: string | null;
+    reason: string;
+    message: string;
+} | {
+    kind: "failed";
+    automationId: string;
+    scheduledFor: string;
+    code: string;
+    message: string;
+};
+interface DueRunResult {
+    now: string;
+    decisions: AutomationScheduleDecision[];
+    outcomes: DueRunOutcome[];
+}
+interface DueRunServiceOptions {
+    store: AutomationStore;
+    executor: Pick<ManualRunExecutor, "run">;
+    clock?: () => Date;
+}
+/** Deterministic, externally invoked due-run orchestration. It owns no timer. */
+declare class DueRunService {
+    private readonly options;
+    private readonly clock;
+    constructor(options: DueRunServiceOptions);
+    runDue(request: FastifyRequest): Promise<DueRunResult>;
+}
 
 type AtomicWriter = (path: string, content: string) => Promise<void>;
 interface FileAutomationStoreOptions {
     writer?: AtomicWriter;
+    clock?: () => Date;
 }
 declare class FileAutomationStore implements AutomationStore {
     private readonly rootDir;
     private state;
     private loadInFlight;
     private writeChain;
+    /** Active runs owned by this store process; persisted active runs are orphaned after restart. */
+    private readonly activeRunIds;
     private readonly writer;
+    private readonly clock;
     constructor(rootDir: string, options?: FileAutomationStoreOptions);
     listAutomations(): Promise<Automation[]>;
     getAutomation(id: string): Promise<Automation | null>;
@@ -43,29 +119,61 @@ declare class FileAutomationStore implements AutomationStore {
     deleteAutomation(id: string): Promise<void>;
     getPrompt(automationId: string): Promise<string>;
     updatePrompt(automationId: string, body: string): Promise<void>;
-    createRun(input: AutomationRunCreate): Promise<AutomationRun>;
-    updateRun(runId: string, patch: AutomationRunPatch): Promise<AutomationRun>;
+    reconcileOrphanedRuns(automationId: string): Promise<void>;
+    beginRun(input: AutomationRunBegin): Promise<AutomationRun>;
+    updateRunLifecycle(runId: string, patch: AutomationRunLifecyclePatch): Promise<AutomationRun>;
     listRuns(automationId: string): Promise<AutomationRun[]>;
-    findRunningRun(automationId: string): Promise<AutomationRun | null>;
     private statePath;
     private promptPath;
     private writePromptFile;
     private mutate;
+    private nowIso;
     private load;
 }
 
+/** Deployment-owned hosted schema registration for the automation plugin. */
+declare function runBoringAutomationMigrations(sql: postgres.Sql): Promise<void>;
+
+interface HostedAutomationActor {
+    workspaceId: string;
+    userId: string;
+}
+type Sql = postgres.Sql;
+/** Hosted store bound to a verified workspace/user pair; every query is scoped by both. */
+declare class PostgresAutomationStore implements AutomationStore {
+    private readonly sql;
+    private readonly actor;
+    private readonly clock;
+    constructor(sql: Sql, actor: HostedAutomationActor, clock?: () => Date);
+    listAutomations(): Promise<Automation[]>;
+    getAutomation(id: string): Promise<Automation | null>;
+    createAutomation(input: AutomationCreate): Promise<Automation>;
+    updateAutomation(id: string, patch: AutomationPatch): Promise<Automation>;
+    deleteAutomation(id: string): Promise<void>;
+    getPrompt(automationId: string): Promise<string>;
+    updatePrompt(automationId: string, body: string): Promise<void>;
+    reconcileOrphanedRuns(automationId: string): Promise<void>;
+    beginRun(input: AutomationRunBegin): Promise<AutomationRun>;
+    updateRunLifecycle(runId: string, patch: AutomationRunLifecyclePatch): Promise<AutomationRun>;
+    listRuns(automationId: string): Promise<AutomationRun[]>;
+    private findRun;
+}
+
 interface AutomationRoutesOptions {
     store: AutomationStore;
+    storeForRequest?: (request: FastifyRequest) => Promise<AutomationStore> | AutomationStore;
+    manualRunExecutor?: Pick<ManualRunExecutor, "run">;
+    dueRunService?: Pick<DueRunService, "runDue">;
 }
 declare function automationRoutes(app: FastifyInstance, opts: AutomationRoutesOptions): Promise<void>;
 
 interface BoringAutomationServerPluginOptions {
     workspaceRoot?: string;
     store?: AutomationStore;
+    dispatcherResolver?: WorkspaceAgentDispatcherResolver;
+    actorResolver?: (request: FastifyRequest) => Promise<VerifiedAutomationActor> | VerifiedAutomationActor;
 }
 declare function createBoringAutomationServerPlugin(options?: BoringAutomationServerPluginOptions): WorkspaceServerPlugin;
-declare function defaultBoringAutomationServerPlugin(options?: BoringAutomationServerPluginOptions, ctx?: {
-    workspaceRoot?: string;
-}): WorkspaceServerPlugin;
+declare function defaultBoringAutomationServerPlugin(options?: BoringAutomationServerPluginOptions, ctx?: Pick<WorkspaceAgentServerPluginContext, "workspaceRoot"> & Partial<Pick<WorkspaceAgentServerPluginContext, "trusted">>): WorkspaceServerPlugin;
 
-export { Automation, AutomationCreate, AutomationPatch, type AutomationRoutesOptions, AutomationRun, AutomationRunCreate, AutomationRunPatch, type AutomationStore, AutomationStoreError, BoringAutomationErrorCode, type BoringAutomationServerPluginOptions, FileAutomationStore, type FileAutomationStoreOptions, automationNotFound, automationRoutes, createBoringAutomationServerPlugin, defaultBoringAutomationServerPlugin as default, runNotFound };
+export { Automation, AutomationCreate, AutomationPatch, type AutomationRoutesOptions, AutomationRun, AutomationRunBegin, AutomationRunLifecyclePatch, AutomationScheduleDecision, type AutomationStore, AutomationStoreError, BoringAutomationErrorCode, type BoringAutomationServerPluginOptions, type DueRunOutcome, type DueRunResult, DueRunService, type DueRunServiceOptions, type DueRunSummary, FileAutomationStore, type FileAutomationStoreOptions, type HostedAutomationActor, ManualRunExecutor, type ManualRunExecutorOptions, type ManualRunInput, PostgresAutomationStore, type VerifiedAutomationActor, automationNotFound, automationRoutes, createBoringAutomationServerPlugin, defaultBoringAutomationServerPlugin as default, parseAutomationModel, runAlreadyActive, runAlreadyRecorded, runBoringAutomationMigrations, runNotFound };