@hasna/loops 0.4.27 → 0.4.29

package/dist/sdk/http.d.ts

@@ -1,3 +1,43 @@
+export interface PublicValidationDetails {
+    "code": string;
+    "reason": "not_array" | "invalid_array" | "invalid_item" | "option_not_allowed";
+    "path": string;
+    "index"?: number;
+    "option"?: string;
+}
+export interface ValidationFailureResponse {
+    "ok": boolean;
+    "error": string;
+    "details"?: PublicValidationDetails;
+}
+export interface InvalidLoopStatusResponse {
+    "ok": boolean;
+    "error": string;
+}
+export interface AmbiguousNameResponse {
+    "ok": boolean;
+    "error": string;
+}
+export interface InvalidJsonResponse {
+    "ok": boolean;
+    "error": string;
+}
+export interface UnsupportedMediaTypeResponse {
+    "ok": boolean;
+    "error": string;
+}
+export interface InvalidWorkflowRecoveryBodyResponse {
+    "ok": boolean;
+    "error": string;
+}
+export interface WorkflowRecoveryConflictResponse {
+    "ok": boolean;
+    "error": "workflow_run_has_live_steps" | "workflow_run_step_ownership_unverifiable" | "workflow_run_not_running";
+}
+export interface RunFinalizeConflictResponse {
+    "ok": boolean;
+    "error": "stale_claim" | "run_not_running" | "loop_advancement_conflict";
+}
 export interface Foundation {
     "status": string;
     "version": string;
@@ -9,7 +49,8 @@ export interface Loop {
     "id": string;
     "name": string;
     "description"?: string | null;
-    "status": string;
+    "labels": Array<string>;
+    "status": "active" | "paused" | "stopped" | "expired";
     "schedule"?: Record<string, unknown>;
     "target"?: Record<string, unknown>;
     "nextRunAt"?: string | null;
@@ -19,6 +60,7 @@ export interface Loop {
 export interface CreateLoopInput {
     "name": string;
     "description"?: string;
+    "labels"?: Array<string>;
     "schedule": Record<string, unknown>;
     "target": Record<string, unknown>;
 }
@@ -27,6 +69,7 @@ export interface UpdateLoopInput {
     "nextRunAt"?: string | null;
     "retryScheduledFor"?: string | null;
     "expiresAt"?: string | null;
+    "labels"?: Array<string>;
 }
 export interface Run {
     "id": string;
@@ -111,6 +154,182 @@ export interface RunReceiptListResponse {
     "ok": boolean;
     "receipts": Array<RunReceipt>;
 }
+export interface Workflow {
+    "id": string;
+    "name": string;
+    "description"?: string | null;
+    "version": number;
+    "status": string;
+    "steps": Array<Record<string, unknown>>;
+    "goal"?: Record<string, unknown>;
+    "createdAt"?: string;
+    "updatedAt"?: string;
+}
+export interface CreateWorkflowInput {
+    "name": string;
+    "description"?: string;
+    "steps": Array<Record<string, unknown>>;
+    "goal"?: Record<string, unknown>;
+}
+export interface WorkflowResponse {
+    "ok": boolean;
+    "workflow": Workflow;
+}
+export interface WorkflowListResponse {
+    "ok": boolean;
+    "workflows": Array<Workflow>;
+}
+export interface CreateWorkflowInvocationInput {
+    "id"?: string;
+    "workflowId"?: string;
+    "templateId"?: string;
+    "sourceRef": Record<string, unknown>;
+    "subjectRef": Record<string, unknown>;
+    "intent": string;
+    "scope"?: Record<string, unknown>;
+    "outputPolicy"?: Record<string, unknown>;
+}
+export type WorkflowInvocation = CreateWorkflowInvocationInput & {
+    "id": string;
+    "createdAt": string;
+    "updatedAt": string;
+};
+export interface WorkflowInvocationResponse {
+    "ok": boolean;
+    "invocation": WorkflowInvocation;
+}
+export interface WorkflowInvocationListResponse {
+    "ok": boolean;
+    "invocations": Array<WorkflowInvocation>;
+}
+export interface WorkflowWorkItem {
+    "id": string;
+    "routeKey": string;
+    "idempotencyKey": string;
+    "invocationId": string;
+    "sourceType": string;
+    "sourceRef": string;
+    "subjectRef": string;
+    "status": string;
+    "priority": number;
+    "createdAt"?: string;
+    "updatedAt"?: string;
+}
+export interface UpsertWorkflowWorkItemInput {
+    "id"?: string;
+    "routeKey": string;
+    "idempotencyKey": string;
+    "invocationId": string;
+    "sourceType": string;
+    "sourceRef": string;
+    "subjectRef": string;
+    "projectKey"?: string;
+    "projectGroup"?: string;
+    "machineId"?: string;
+    "routeScope"?: string;
+    "priority"?: number;
+    "status"?: "queued" | "deferred";
+    "nextAttemptAt"?: string;
+    "lastReason"?: string;
+}
+export interface WorkflowWorkItemResponse {
+    "ok": boolean;
+    "workItem": WorkflowWorkItem;
+}
+export interface WorkflowWorkItemListResponse {
+    "ok": boolean;
+    "workItems": Array<WorkflowWorkItem>;
+}
+export interface ImportInput {
+    "workflows"?: Array<Record<string, unknown>>;
+    "loops"?: Array<Record<string, unknown>>;
+    "runs"?: Array<Record<string, unknown>>;
+    "replace"?: boolean;
+    "preserveLoopScheduling"?: boolean;
+    "preserveWorkflowActivation"?: boolean;
+}
+export interface ImportResponse {
+    "ok": boolean;
+    "imported": {
+        "workflows": number;
+        "loops": number;
+        "runs": number;
+    };
+    "skippedRunning": number;
+}
+export interface AgentSessionContract {
+    "version": 1;
+    "provider": "claude" | "cursor" | "codewith" | "codex" | "aicopilot" | "opencode";
+    "model"?: string;
+    "cwd"?: string;
+    "permissionMode": "default" | "plan" | "auto" | "bypass";
+    "sandbox": "read-only" | "workspace-write" | "danger-full-access" | "enabled" | "disabled" | "provider-default";
+    "manualBreakGlass": boolean;
+    "routing"?: {
+        "projectPath"?: string;
+        "projectGroup"?: string;
+        "taskId"?: string;
+        "eventId"?: string;
+        "eventType"?: string;
+        "eventSource"?: string;
+        "role"?: "triage" | "planner" | "worker" | "verifier";
+    };
+    "timeoutMs": number | null;
+    "restrictions": {
+        "tools"?: Array<string>;
+        "commands"?: Array<string>;
+        "enforcement": "metadata_only";
+        "providerEnforced": false;
+    };
+    "safetyReason"?: string;
+}
+export interface AgentSessionContractEventInput {
+    "claimToken": string;
+    "eventType": "agent_session_contract";
+    "stepId": string;
+    "payload": AgentSessionContract;
+}
+export interface GenericWorkflowEvent {
+    "id": string;
+    "workflowRunId": string;
+    "sequence": number;
+    "eventType": "created" | "workflow_archived" | "todos_workflow_pointers_synced" | "todos_workflow_pointers_sync_failed" | "step_started" | "step_progress" | "recovered" | "step_pending" | "step_running" | "step_succeeded" | "step_failed" | "step_timed_out" | "step_skipped" | "step_cancelled" | "succeeded" | "failed" | "timed_out" | "cancelled";
+    "stepId"?: string;
+    "payload"?: Record<string, unknown>;
+    "createdAt": string;
+}
+export interface AgentSessionContractWorkflowEvent {
+    "id": string;
+    "workflowRunId": string;
+    "sequence": number;
+    "eventType": "agent_session_contract";
+    "stepId": string;
+    "payload": AgentSessionContract;
+    "createdAt": string;
+}
+export interface CustomWorkflowEvent {
+    "id": string;
+    "workflowRunId": string;
+    "sequence": number;
+    "eventKind": "custom";
+    "eventType": string;
+    "stepId"?: string;
+    "payload"?: Record<string, unknown>;
+    "createdAt": string;
+}
+export type WorkflowEvent = AgentSessionContractWorkflowEvent | GenericWorkflowEvent | CustomWorkflowEvent;
+export interface WorkflowEventResponse {
+    "ok": boolean;
+    "event": WorkflowEvent;
+}
+export interface WorkflowEventListResponse {
+    "ok": boolean;
+    "events": Array<WorkflowEvent>;
+}
+export interface CountResponse {
+    "ok": boolean;
+    "count": number;
+}
 export interface LoopsClientOptions {
     /** Base URL, e.g. process.env.APP_API_URL. */
     baseUrl: string;
@@ -135,26 +354,65 @@ export declare class LoopsClient {
     private request;
     /** Liveness probe */
     healthCheck(init?: RequestInit): Promise<Foundation>;
+    healthzProbe(init?: RequestInit): Promise<Record<string, unknown>>;
+    openapiJsonProbe(init?: RequestInit): Promise<Record<string, unknown>>;
     /** Readiness probe (storage reachable + migrated) */
     readyCheck(init?: RequestInit): Promise<Foundation>;
+    readyzProbe(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** status.read */
+    statusRead(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** api.read */
+    apiRead(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** goalRuns.list */
+    goalRunsList(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** goals.list */
+    goalsList(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** goals.get */
+    goalsGet(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** goals.planNodes */
+    goalsPlanNodes(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** history.prune */
+    historyPrune(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** Bulk id-preserving import (self-hosted backfill) */
+    importRows(body: ImportInput, init?: RequestInit): Promise<ImportResponse>;
+    /** List workflow route invocations */
+    listWorkflowInvocations(query?: {
+        "limit"?: number;
+    }, init?: RequestInit): Promise<WorkflowInvocationListResponse>;
+    /** Create an id-preserving workflow route invocation */
+    createWorkflowInvocation(body: CreateWorkflowInvocationInput, init?: RequestInit): Promise<WorkflowInvocationResponse>;
+    /** invocations.get */
+    invocationsGet(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** leases.recover */
+    leasesRecover(init?: RequestInit): Promise<Record<string, unknown>>;
     /** List loops */
     listLoops(query?: {
         "status"?: "active" | "paused" | "stopped" | "expired";
         "limit"?: number;
+        "offset"?: number;
         "includeArchived"?: boolean;
         "archived"?: boolean;
+        "labels"?: Array<string>;
     }, init?: RequestInit): Promise<LoopListResponse>;
     /** Create a loop */
     createLoop(body: CreateLoopInput, init?: RequestInit): Promise<LoopResponse>;
+    /** Count loops (total-row verification) */
+    countLoops(query?: {
+        "status"?: string;
+        "includeArchived"?: boolean;
+        "archived"?: boolean;
+    }, init?: RequestInit): Promise<CountResponse>;
     /** Get a loop by id */
     getLoop(id: string, init?: RequestInit): Promise<LoopResponse>;
     /** Delete a loop */
     deleteLoop(id: string, init?: RequestInit): Promise<DeleteResponse>;
     /** Update a loop (status / schedule fields) */
     updateLoop(id: string, body: UpdateLoopInput, init?: RequestInit): Promise<LoopResponse>;
-    /** Archive a loop */
+    /** Archive a loop by id or name */
     archiveLoop(id: string, init?: RequestInit): Promise<LoopResponse>;
-    /** Unarchive a loop */
+    /** loops.rename */
+    loopsRename(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** Unarchive a loop by id or name */
     unarchiveLoop(id: string, init?: RequestInit): Promise<LoopResponse>;
     /** List run receipts */
     listRunReceipts(query?: {
@@ -169,14 +427,116 @@ export declare class LoopsClient {
     writeRunReceipt(body: WriteRunReceiptInput, init?: RequestInit): Promise<RunReceiptResponse>;
     /** Get a run receipt by run id */
     getRunReceipt(runId: string, init?: RequestInit): Promise<RunReceiptResponse>;
+    /** runners.claim */
+    runnersClaim(body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runners.poll */
+    runnersPoll(body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
     /** List runs */
     listRuns(query?: {
         "loopId"?: string;
         "status"?: string;
+        "labels"?: Array<string>;
         "limit"?: number;
+        "offset"?: number;
+        "showOutput"?: boolean;
     }, init?: RequestInit): Promise<RunListResponse>;
+    /** Count runs (total-row verification) */
+    countRuns(query?: {
+        "status"?: string;
+    }, init?: RequestInit): Promise<CountResponse>;
     /** Get a run by id */
-    getRun(id: string, init?: RequestInit): Promise<RunResponse>;
+    getRun(id: string, query?: {
+        "showOutput"?: boolean;
+    }, init?: RequestInit): Promise<RunResponse>;
+    /** runs.evidence */
+    runsEvidence(id: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.finalize */
+    runsFinalize(id: string, body: {
+        "claimToken": string;
+        "status": "succeeded" | "failed" | "timed_out";
+        "finishedAt"?: string;
+        "durationMs"?: number;
+        "stdout"?: string;
+        "stderr"?: string;
+        "error"?: string;
+        "exitCode"?: number;
+        "pid"?: number;
+    }, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Create */
+    runsGoalsCreate(id: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Find */
+    runsGoalsFind(id: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Events */
+    runsGoalsEvents(id: string, goalId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Get */
+    runsGoalsGet(id: string, goalId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Plan.Nodes.Create */
+    runsGoalsPlanNodesCreate(id: string, goalId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Plan.Nodes.List */
+    runsGoalsPlanNodesList(id: string, goalId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Plan.Nodes.Update */
+    runsGoalsPlanNodesUpdate(id: string, goalId: string, key: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.Goals.Status */
+    runsGoalsStatus(id: string, goalId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.heartbeat */
+    runsHeartbeat(id: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.recover */
+    runsRecover(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.workflowRuns.create */
+    runsWorkflowRunsCreate(id: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** Validate a legacy runner-authored agent session contract */
+    runsWorkflowRunsEvents(id: string, workflowRunId: string, body: AgentSessionContractEventInput, init?: RequestInit): Promise<WorkflowEventResponse>;
+    /** runs.workflowRuns.finalize */
+    runsWorkflowRunsFinalize(id: string, workflowRunId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.workflowRuns.get */
+    runsWorkflowRunsGet(id: string, workflowRunId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.workflowRuns.recover */
+    runsWorkflowRunsRecover(id: string, workflowRunId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.workflowRuns.steps */
+    runsWorkflowRunsSteps(id: string, workflowRunId: string, body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** runs.workflowRuns.stepAction */
+    runsWorkflowRunsStepAction(id: string, workflowRunId: string, stepId: string, action: "get" | "start" | "pid" | "progress" | "skip" | "finalize", body: Record<string, unknown>, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** api.status */
+    apiStatus(init?: RequestInit): Promise<Record<string, unknown>>;
+    v1VersionProbe(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** List workflow route work items */
+    listWorkflowWorkItems(query?: {
+        "status"?: string;
+        "routeKey"?: string;
+        "limit"?: number;
+    }, init?: RequestInit): Promise<WorkflowWorkItemListResponse>;
+    /** Upsert an id-preserving workflow route work item */
+    upsertWorkflowWorkItem(body: UpsertWorkflowWorkItemInput, init?: RequestInit): Promise<WorkflowWorkItemResponse>;
+    /** workItems.get */
+    workItemsGet(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** workflowRuns.list */
+    workflowRunsList(init?: RequestInit): Promise<Record<string, unknown>>;
+    /** workflowRuns.get */
+    workflowRunsGet(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** workflowRuns.events */
+    workflowRunsEvents(id: string, init?: RequestInit): Promise<WorkflowEventListResponse>;
+    /** workflowRuns.recover */
+    workflowRunsRecover(id: string, body?: {
+        "reason"?: string;
+    }, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** workflowRuns.steps */
+    workflowRunsSteps(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
+    /** List workflow specs */
+    listWorkflows(query?: {
+        "status"?: "active" | "archived";
+        "limit"?: number;
+        "offset"?: number;
+    }, init?: RequestInit): Promise<WorkflowListResponse>;
+    /** Create a workflow spec */
+    createWorkflow(body: CreateWorkflowInput, init?: RequestInit): Promise<WorkflowResponse>;
+    /** Count workflow specs */
+    countWorkflows(query?: {
+        "status"?: string;
+    }, init?: RequestInit): Promise<CountResponse>;
+    /** Get a workflow spec by id */
+    getWorkflow(id: string, init?: RequestInit): Promise<WorkflowResponse>;
+    /** workflows.archive */
+    workflowsArchive(id: string, init?: RequestInit): Promise<Record<string, unknown>>;
     /** Service version */
     getVersion(init?: RequestInit): Promise<Foundation>;
 }