@hasna/loops 0.3.60 → 0.4.1

package/dist/lib/template-kit.d.ts

@@ -0,0 +1,70 @@
+import type { AgentWorktreeSpec, LoopTemplateSummary } from "../types.js";
+/**
+ * Builtin template metadata, prompt kit, and deterministic script assets.
+ *
+ * The copy-edited prose blocks (worktree policy, exact-todos-commands stanzas,
+ * evidence rules, no-tmux stanzas) live here as composable named fragments;
+ * per-template wording deltas are explicit parameters so drift stays visible
+ * in one place. Rendered wording is contract-tested in templates.test.ts.
+ */
+export declare const TODOS_TASK_WORKER_VERIFIER_TEMPLATE_ID = "todos-task-worker-verifier";
+export declare const EVENT_WORKER_VERIFIER_TEMPLATE_ID = "event-worker-verifier";
+export declare const BOUNDED_AGENT_WORKER_VERIFIER_TEMPLATE_ID = "bounded-agent-worker-verifier";
+export declare const TASK_LIFECYCLE_TEMPLATE_ID = "task-lifecycle";
+export declare const PR_REVIEW_TEMPLATE_ID = "pr-review";
+export declare const SCHEDULED_AUDIT_TEMPLATE_ID = "scheduled-audit";
+export declare const KNOWLEDGE_REFRESH_TEMPLATE_ID = "knowledge-refresh";
+export declare const REPORT_ONLY_TEMPLATE_ID = "report-only";
+export declare const INCIDENT_RESPONSE_TEMPLATE_ID = "incident-response";
+export declare const DETERMINISTIC_CHECK_CREATE_TASK_TEMPLATE_ID = "deterministic-check-create-task";
+export type AgentWorkflowRole = "triage" | "planner" | "worker" | "verifier";
+export declare const BUILTIN_TEMPLATE_SUMMARIES: LoopTemplateSummary[];
+export declare const NO_TMUX_DISPATCH_FRAGMENT = "Do not dispatch or paste prompts into tmux panes. If additional work is required, create or update deduped todos tasks so task-created routing can start a fresh headless workflow.";
+export declare const WORKER_LEAVES_COMPLETION_FRAGMENT = "Do not mark the task complete in the worker step; the verifier step owns completion after independent validation.";
+export declare const VERIFIER_TINY_FIXES_FRAGMENT = "Do not make broad unrelated changes. Only apply tiny verification fixes when they are necessary and low risk; otherwise create follow-up tasks.";
+export declare const TASK_VERIFIER_DECISION_FRAGMENT = "If the work is valid, record verification evidence in todos and mark/leave the task in the correct completed state according to the todos CLI. If it is not valid, add precise follow-up tasks or comments and leave the original task open or blocked with clear evidence.";
+export declare const LIFECYCLE_VERIFIER_DECISION_FRAGMENT = "If the work is valid, record verification evidence in todos and mark/leave the task completed according to the todos CLI. If not valid, add precise follow-up tasks or comments and leave the original task open or blocked with clear evidence.";
+export declare const EVENT_VERIFIER_DECISION_FRAGMENT = "If the work is valid, record verification evidence in the relevant local system. If it is not valid, add precise follow-up tasks/comments and leave the event handling state open or blocked with clear evidence.";
+export declare const BOUNDED_VERIFIER_REVIEW_FRAGMENT = "Use fresh context. Review the worker result for correctness, regressions, missing tests, safety, runaway-agent risk, output bounds, and incomplete evidence.";
+export declare const BOUNDED_VERIFIER_DECISION_FRAGMENT = "If valid, record verification evidence. If invalid, create precise follow-up tasks or comments and leave the original work open. Do not make broad unrelated changes.";
+export declare const TASK_REVIEW_FOCUS = "correctness, regressions, missing tests, security, and incomplete requirements";
+export declare const EVENT_REVIEW_FOCUS = "correctness, regressions, security, missing evidence, and incomplete requirements";
+export type BuiltinFlow = "task" | "lifecycle" | "event" | "bounded";
+export declare function roleFragment(role: string, flow: BuiltinFlow): string;
+/**
+ * `/goal` header lines. The blank separator line is intentionally part of the
+ * fragment; prompts assembled with `.filter(Boolean)` historically drop it and
+ * that rendering is contract-tested, so composition must preserve both shapes.
+ */
+export declare function goalHeaderFragment(goal: string, role: string, flow: BuiltinFlow): string[];
+export declare function adversarialReviewFragment(inspect: string, focus: string): string;
+export declare const DEFAULT_VERIFIER_IDLE_TIMEOUT_MS: number;
+export declare function verifierIdleTimeoutMs(input: {
+    verifierIdleTimeoutMs?: number;
+}): number | undefined;
+export declare function verifierRuntimeGuidance(input: {
+    verifierIdleTimeoutMs?: number;
+}): string;
+export declare function todosInspectLine(todosProjectPath: string, taskId: string): string;
+export declare function todosStartLine(todosProjectPath: string, taskId: string): string;
+export declare function todosEvidenceLine(todosProjectPath: string, taskId: string, placeholder: string): string;
+export declare function todosVerificationLine(todosProjectPath: string, taskId: string): string;
+export declare function todosDoneLine(todosProjectPath: string, taskId: string): string;
+/** Exact-todos-commands stanza: project pin, cwd-inference warning, inspect, then role-specific command lines. */
+export declare function todosExactCommandsFragment(todosProjectPath: string, taskId: string, commandLines: string[]): string[];
+/** Worktree policy PROSE for agent guidance; enforcement is executor-native via target.worktree. */
+export declare function worktreePrompt(plan: AgentWorktreeSpec): string;
+export declare function worktreeContextFragment(plan: AgentWorktreeSpec): Record<string, unknown>;
+export declare function shellQuote(value: string): string;
+export declare function sourceTaskGateCommand(todosProjectPath: string, taskId: string): string;
+export type LifecycleGateStage = "triage" | "planner";
+export declare function lifecycleGateCommand(todosProjectPath: string, taskId: string, stage: LifecycleGateStage, goMarker: string, blockedMarker: string): string;
+export interface PrHandoffCommandOptions {
+    artifactPath: string;
+    taskId: string;
+    todosProjectPath: string;
+    worktreeCwd: string;
+    worktreeRoot: string;
+    expectedBranch: string;
+}
+export declare function prHandoffCommand(opts: PrHandoffCommandOptions): string;

package/dist/lib/templates-custom.d.ts

@@ -0,0 +1,34 @@
+import type { CreateWorkflowInput, LoopTemplateSummary, LoopTemplateVariable } from "../types.js";
+/**
+ * Custom loop template registry: JSON-defined workflow templates stored under
+ * the data dir. Rendering fails closed on danger-full-access/bypass flags and
+ * on collisions with the builtin template keys (passed in as reservedKeys).
+ */
+export interface CustomLoopTemplateImportOptions {
+    replace?: boolean;
+}
+export interface CustomLoopTemplateImportResult {
+    template: LoopTemplateSummary;
+    path: string;
+    replaced: boolean;
+}
+interface CustomLoopTemplateDefinition {
+    id: string;
+    name: string;
+    description: string;
+    kind: "workflow";
+    variables: LoopTemplateVariable[];
+    workflow: unknown;
+}
+export interface CustomLoopTemplateEntry {
+    definition: CustomLoopTemplateDefinition;
+    summary: LoopTemplateSummary;
+    path: string;
+}
+export declare function customLoopTemplatesDir(): string;
+export declare function loadCustomLoopTemplates(reservedKeys: Set<string>): CustomLoopTemplateEntry[];
+export declare function getCustomLoopTemplate(id: string, reservedKeys: Set<string>): CustomLoopTemplateEntry | undefined;
+export declare function renderCustomLoopTemplate(entry: CustomLoopTemplateEntry, values: Record<string, string | undefined>): CreateWorkflowInput;
+export declare function validateCustomLoopTemplateFile(file: string, reservedKeys: Set<string>): LoopTemplateSummary;
+export declare function importCustomLoopTemplate(file: string, reservedKeys: Set<string>, opts?: CustomLoopTemplateImportOptions): CustomLoopTemplateImportResult;
+export {};

package/dist/lib/templates.d.ts

@@ -1,20 +1,10 @@
 import type { AccountRef, AgentPermissionMode, AgentProvider, AgentSandbox, AgentWorktreeMode, CreateWorkflowInput, LoopTemplateSource, LoopTemplateSummary, TimeoutMs } from "../types.js";
-export declare const TODOS_TASK_WORKER_VERIFIER_TEMPLATE_ID = "todos-task-worker-verifier";
-export declare const EVENT_WORKER_VERIFIER_TEMPLATE_ID = "event-worker-verifier";
-export declare const BOUNDED_AGENT_WORKER_VERIFIER_TEMPLATE_ID = "bounded-agent-worker-verifier";
-export declare const TASK_LIFECYCLE_TEMPLATE_ID = "task-lifecycle";
-export declare const PR_REVIEW_TEMPLATE_ID = "pr-review";
-export declare const SCHEDULED_AUDIT_TEMPLATE_ID = "scheduled-audit";
-export declare const KNOWLEDGE_REFRESH_TEMPLATE_ID = "knowledge-refresh";
-export declare const REPORT_ONLY_TEMPLATE_ID = "report-only";
-export declare const INCIDENT_RESPONSE_TEMPLATE_ID = "incident-response";
-export declare const DETERMINISTIC_CHECK_CREATE_TASK_TEMPLATE_ID = "deterministic-check-create-task";
-export interface TodosTaskWorkflowTemplateInput {
-    taskId: string;
-    taskTitle?: string;
-    taskDescription?: string;
+export { BOUNDED_AGENT_WORKER_VERIFIER_TEMPLATE_ID, DETERMINISTIC_CHECK_CREATE_TASK_TEMPLATE_ID, EVENT_WORKER_VERIFIER_TEMPLATE_ID, INCIDENT_RESPONSE_TEMPLATE_ID, KNOWLEDGE_REFRESH_TEMPLATE_ID, PR_REVIEW_TEMPLATE_ID, REPORT_ONLY_TEMPLATE_ID, SCHEDULED_AUDIT_TEMPLATE_ID, TASK_LIFECYCLE_TEMPLATE_ID, TODOS_TASK_WORKER_VERIFIER_TEMPLATE_ID, } from "./template-kit.js";
+import type { CustomLoopTemplateImportOptions, CustomLoopTemplateImportResult } from "./templates-custom.js";
+export type { CustomLoopTemplateImportOptions, CustomLoopTemplateImportResult } from "./templates-custom.js";
+/** Agent/account/worktree fields shared by every agent-backed builtin template input. */
+export interface AgentWorkflowTemplateBaseInput {
     projectPath: string;
-    todosProjectPath?: string;
     routeProjectPath?: string;
     projectGroup?: string;
     provider?: AgentProvider;
@@ -42,91 +32,33 @@ export interface TodosTaskWorkflowTemplateInput {
     worktreeBranchPrefix?: string;
     timeoutMs?: TimeoutMs;
     verifierIdleTimeoutMs?: number;
+}
+export interface TodosTaskWorkflowTemplateInput extends AgentWorkflowTemplateBaseInput {
+    taskId: string;
+    taskTitle?: string;
+    taskDescription?: string;
+    todosProjectPath?: string;
     prHandoff?: boolean;
     eventId?: string;
     eventType?: string;
 }
-export interface EventWorkflowTemplateInput {
+export interface EventWorkflowTemplateInput extends AgentWorkflowTemplateBaseInput {
     eventId: string;
     eventType: string;
     eventSource: string;
     eventSubject?: string;
     eventMessage?: string;
     eventJson: string;
-    projectPath: string;
-    routeProjectPath?: string;
-    projectGroup?: string;
-    provider?: AgentProvider;
-    authProfile?: string;
-    authProfilePool?: string[];
-    triageAuthProfile?: string;
-    plannerAuthProfile?: string;
-    workerAuthProfile?: string;
-    verifierAuthProfile?: string;
-    account?: AccountRef;
-    accountPool?: AccountRef[];
-    triageAccount?: AccountRef;
-    plannerAccount?: AccountRef;
-    workerAccount?: AccountRef;
-    verifierAccount?: AccountRef;
-    model?: string;
-    variant?: string;
-    agent?: string;
-    addDirs?: string[];
-    permissionMode?: AgentPermissionMode;
-    sandbox?: AgentSandbox;
-    manualBreakGlass?: boolean;
-    worktreeMode?: AgentWorktreeMode;
-    worktreeRoot?: string;
-    worktreeBranchPrefix?: string;
-    timeoutMs?: TimeoutMs;
-    verifierIdleTimeoutMs?: number;
 }
-export interface BoundedAgentWorkflowTemplateInput {
+export interface BoundedAgentWorkflowTemplateInput extends AgentWorkflowTemplateBaseInput {
     name?: string;
     objective: string;
     prompt?: string;
-    projectPath: string;
-    routeProjectPath?: string;
-    projectGroup?: string;
-    provider?: AgentProvider;
-    authProfile?: string;
-    authProfilePool?: string[];
-    triageAuthProfile?: string;
-    plannerAuthProfile?: string;
-    workerAuthProfile?: string;
-    verifierAuthProfile?: string;
-    account?: AccountRef;
-    accountPool?: AccountRef[];
-    triageAccount?: AccountRef;
-    plannerAccount?: AccountRef;
-    workerAccount?: AccountRef;
-    verifierAccount?: AccountRef;
-    model?: string;
-    variant?: string;
-    agent?: string;
-    addDirs?: string[];
-    permissionMode?: AgentPermissionMode;
-    sandbox?: AgentSandbox;
-    manualBreakGlass?: boolean;
-    worktreeMode?: AgentWorktreeMode;
-    worktreeRoot?: string;
-    worktreeBranchPrefix?: string;
-    timeoutMs?: TimeoutMs;
-    verifierIdleTimeoutMs?: number;
 }
 export type LoopTemplateSourceFilter = LoopTemplateSource | "all";
 export interface ListLoopTemplatesOptions {
     source?: LoopTemplateSourceFilter;
 }
-export interface CustomLoopTemplateImportOptions {
-    replace?: boolean;
-}
-export interface CustomLoopTemplateImportResult {
-    template: LoopTemplateSummary;
-    path: string;
-    replaced: boolean;
-}
 export declare function loopTemplatesDir(): string;
 export declare function validateCustomLoopTemplateFile(file: string): LoopTemplateSummary;
 export declare function importCustomLoopTemplate(file: string, opts?: CustomLoopTemplateImportOptions): CustomLoopTemplateImportResult;

package/dist/lib/workflow-runner.d.ts

@@ -8,6 +8,8 @@ export interface ExecuteWorkflowOptions extends ExecuteOptions {
     idempotencyKey?: string;
     cancelPollMs?: number;
     signalTimeoutMessage?: () => string | undefined;
+    /** Per-node goal prompt appended to agent step prompts when a goal executes this workflow. */
+    goalNodePrompt?: string;
 }
 export declare function executeWorkflow(store: Store, workflow: WorkflowSpec, opts?: ExecuteWorkflowOptions): Promise<ExecutorResult>;
 export declare function preflightWorkflow(workflow: WorkflowSpec, opts?: ExecuteOptions): ReturnType<typeof preflightTarget>[];

package/dist/mcp/index.d.ts

@@ -2,11 +2,14 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export interface LoopsMcpToolMetadata {
     name: string;
+    /** legacy tool names kept as deprecated alias registrations */
+    aliases?: string[];
     description: string;
     readOnly: boolean;
     guarded?: boolean;
     requiresEnv?: string;
 }
+/** Tool metadata derived from TOOL_REGISTRATIONS; served via loops://tools and `loops mcp list-tools`. */
 export declare const LOOPS_MCP_TOOLS: LoopsMcpToolMetadata[];
 export declare function createLoopsMcpServer(): McpServer;
 export declare function listToolsForCli(): LoopsMcpToolMetadata[];