qlogicagent 2.24.1 → 2.24.2

package/dist/types/orchestration/workflow/workflow-intent-contract.d.ts

@@ -1,56 +0,0 @@
-/**
- * Conversation-owned Workflow intent ledger.
- *
- * Deliberately not an acceptance gate: it has no ready/complete/pass field and is never consulted
- * to decide whether a proposal may be saved or whether an Agent turn may finish. It preserves
- * exact user observations plus a revisable interpretation so incomplete conversations work.
- */
-export interface WorkflowIntentObservation {
-    id: string;
-    sequence: number;
-    text: string;
-}
-export interface WorkflowIntentFact {
-    id: string;
-    statement: string;
-    confidence: "explicit" | "inferred";
-    sourceObservationIds: string[];
-    status: "active" | "superseded";
-}
-export interface WorkflowIntentQuestion {
-    id: string;
-    question: string;
-    sourceObservationIds: string[];
-    status: "open" | "resolved";
-}
-export interface WorkflowIntentContract {
-    revision: number;
-    observations: WorkflowIntentObservation[];
-    facts: WorkflowIntentFact[];
-    openQuestions: WorkflowIntentQuestion[];
-    diagnostics: string[];
-}
-export interface WorkflowIntentDelta {
-    upsertFacts?: Array<{
-        id: string;
-        statement: string;
-        confidence: "explicit" | "inferred";
-        sourceObservationIds: string[];
-    }>;
-    supersedeFactIds?: string[];
-    upsertQuestions?: Array<{
-        id: string;
-        question: string;
-        sourceObservationIds: string[];
-    }>;
-    resolveQuestionIds?: string[];
-}
-export declare function evolveWorkflowIntentContract(input: {
-    previous: WorkflowIntentContract | null | undefined;
-    newTurns: Array<{
-        sequence: number;
-        role: "user" | "assistant";
-        content: string;
-    }>;
-    delta?: WorkflowIntentDelta | null;
-}): WorkflowIntentContract;

package/dist/types/orchestration/workflow/workflow-patch.d.ts

@@ -1,122 +0,0 @@
-/**
- * WorkflowPatch — the single mutation channel for workflow editing.
- *
- * One change protocol for BOTH agent edits and canvas hand-edits: every edit is a list of
- * `WorkflowPatch` ops applied transactionally to a workflow's graph. This module is the
- * deterministic ENGINE half (no gateway, no UI, no LLM):
- *   - applies the 8 ops to a WorkflowDef (+ workflow meta/trigger),
- *   - enforces scoped-edit boundaries (框选批注: ops may only touch the selection subgraph,
- *     D19) at the PROTOCOL level — not a prompt soft-constraint,
- *   - validates the resulting graph through DagScheduler v2's invariants (acyclic minus
- *     loopBack, edge integrity, loop maxIterations) — the spec's "patch 落库前过 validateDag".
- *
- * Transactional + fail-loud (§1.5): a patch is all-or-nothing. The candidate is built on a deep
- * clone; if any op is illegal, references a missing node/edge, breaks scope, or yields an invalid
- * graph, the WHOLE patch is rejected via `PatchError` (carrying `errors` for agent self-correction)
- * and the input is never mutated. No partial application, no silent drop.
- */
-import type { WorkflowDef, WorkflowNodeDef, DataEdge } from "./node-schema.js";
-import type { TriggerDef } from "./workflow-trigger.js";
-export type { TriggerDef } from "./workflow-trigger.js";
-/** A workflow trigger (spec §B / plan D7). Registered by the gateway trigger layer. */
-/** Workflow-global fields a patch can set (kept separate from the node graph). */
-export interface WorkflowMeta {
-    name?: string;
-    active?: boolean;
-    trigger?: TriggerDef | null;
-}
-/** The full mutable target of a patch: the node graph plus workflow-global meta. */
-export interface PatchTarget {
-    def: WorkflowDef;
-    meta: WorkflowMeta;
-}
-export type WorkflowPatch = {
-    op: "add_node";
-    node: WorkflowNodeDef;
-} | {
-    op: "remove_node";
-    nodeId: string;
-} | {
-    op: "update_params";
-    nodeId: string;
-    params: Record<string, unknown>;
-} | {
-    op: "rename_node";
-    nodeId: string;
-    name: string;
-} | {
-    op: "add_edge";
-    edge: DataEdge;
-} | {
-    op: "remove_edge";
-    edge: {
-        from: string;
-        to: string;
-        fromPort?: string;
-    };
-} | {
-    op: "set_trigger";
-    trigger: TriggerDef | null;
-} | {
-    op: "set_meta";
-    meta: {
-        name?: string;
-        active?: boolean;
-    };
-} | {
-    op: "set_node_options";
-    nodeId: string;
-    retry?: {
-        maxTries: number;
-        backoffMs?: number;
-    } | null;
-    timeoutMs?: number | null;
-    onError?: "stop" | "continue" | "errorPort" | null;
-} | {
-    op: "set_node_ui";
-    positions: Record<string, {
-        x: number;
-        y: number;
-    } | null>;
-};
-/** A patch + concurrency/scope envelope (spec §C). `scope` present ⇒ scoped (框选) edit. */
-export interface PatchEnvelope {
-    patch: WorkflowPatch[];
-    /** Optimistic-concurrency base revision (LWW handled by the store layer). */
-    baseRev?: number;
-    /** Selected node ids for a scoped edit; given ⇒ ops may only touch the selection subgraph. */
-    scope?: string[];
-}
-export interface ApplyResult {
-    target: PatchTarget;
-    applied: WorkflowPatch[];
-    /** Non-blocking facts about pre-existing defects outside a scoped edit. */
-    diagnostics: WorkflowPatchDiagnostic[];
-}
-export interface WorkflowPatchDiagnostic {
-    classification: "preexisting";
-    nodeId: string;
-    message: string;
-}
-/** Thrown when a patch is rejected. `errors` is the ordered list of reasons (for self-correction). */
-export declare class PatchError extends Error {
-    readonly errors: string[];
-    constructor(errors: string[]);
-}
-/**
- * Apply a patch transactionally. Returns a NEW PatchTarget (input untouched) or throws PatchError.
- * Scope enforcement (when `scope` is set, spec §C):
- *   - update_params / rename_node / remove_node: the node MUST be in scope.
- *   - add_node: allowed; the new node joins the in-scope set for subsequent ops in this patch.
- *   - add_edge / remove_edge: at least ONE endpoint must be in scope (selection-boundary edges).
- *   - set_trigger / set_meta: workflow-global ⇒ rejected under a scoped edit.
- */
-export declare function applyPatch(target: PatchTarget, env: PatchEnvelope): ApplyResult;
-/**
- * Validate a standalone WorkflowDef against DagScheduler v2's invariants (acyclic minus loopBack,
- * edge integrity, duplicate ids, loop maxIterations + hard cap). Returns a list of human-readable
- * errors; empty ⇒ valid. This is the SAME graph gate `applyPatch` runs, exported so every
- * persistence path (controller create/update) enforces identical invariants — single-track, no
- * write path may bypass validation (D17 "一个 store").
- */
-export declare function validateWorkflowDef(def: WorkflowDef): string[];

package/dist/types/orchestration/workflow/workflow-render.d.ts

@@ -1,40 +0,0 @@
-/**
- * Compact workflow renderer — the "workflow-as-context" feeder.
- *
- * Every page-chat user turn injects the LATEST workflow as compact, deterministic text (NOT raw
- * JSON: cheaper tokens, never stale, stable node ids the agent references back in a WorkflowPatch).
- * This module is the deterministic ENGINE half of that loop — the agent reads this rendering and
- * emits a `WorkflowPatch` (workflow-patch.ts) against the shown `rev`. Pure function: no gateway,
- * no LLM, no I/O.
- *
- * Determinism (§1.5): node order follows the def's node array (stable, persisted order); param
- * keys are sorted; expressions (`{{ }}`) render verbatim so the agent can copy them into bindings.
- * Large graphs truncate with an explicit hint to fetch the full definition from the Gateway Host.
- */
-import type { WorkflowDef } from "./node-schema.js";
-import type { TriggerDef } from "./workflow-patch.js";
-/** The minimal shape needed to render (WorkflowRecord satisfies it). */
-export interface RenderableWorkflow {
-    name: string;
-    rev: number;
-    active: boolean;
-    trigger?: TriggerDef | null;
-    def: WorkflowDef;
-}
-export interface RenderOptions {
-    /** Max nodes to list before truncating (default 50). */
-    maxNodes?: number;
-    /** Max rendered length of a single param value before eliding (default 60). */
-    maxValueLen?: number;
-}
-/**
- * Render a workflow as compact agent-context text. Shape (spec §B):
- *
- *   Workflow "晨报" (rev 7, trigger: schedule "0 9 * * *", active)
- *   nodes:
- *     n1 [agent]   prompt="抓取今日新闻要点"   out: default
- *     n3 [if]      cond={{ $json.count > 0 }}   out: true,false
- *   edges:
- *     n1.default→n2.default ; n3.true→n4.default
- */
-export declare function renderWorkflow(wf: RenderableWorkflow, opts?: RenderOptions): string;

package/dist/types/orchestration/workflow/workflow-runtime.d.ts

@@ -1,184 +0,0 @@
-/**
- * WorkflowRuntime — the automation data-routing driver (M2; plan §M2, spec §A1/§A5).
- *
- * Responsibilities (control/data separation, spec §A1):
- *   - DagScheduler v2 owns CONTROL (ready/skip/loop/ports). The runtime owns DATA:
- *     for each ready node it collects upstream outputs along data edges (fromPort→toPort),
- *     resolves param expressions, invokes the registered NodeExecutor, stores outputs, and
- *     reports completion + firedPorts back to the scheduler.
- *   - run-from-node + output cache (spec §A5): cache key = hash(kind + resolved params +
- *     input signature + runIndex). A clean node hits cache (executor skipped); a changed node
- *     and its dirty downstream recompute. This is content-addressed, so successive run() calls
- *     after a param change recompute only the dirty subgraph.
- *   - loop control is runtime-owned (DagScheduler.decideLoop), not a user executor.
- *   - every node passes an injectable budget/permission gate before executing (plan D15).
- *
- * fail-loud: unknown kinds, gate rejections, and executor errors all throw and halt the run.
- */
-import { DagScheduler } from "../dag-scheduler.js";
-import { type PortMap } from "./data-item.js";
-import { NodeRegistry } from "./node-registry.js";
-import type { RunCheckpoint } from "./run-checkpoint-store.js";
-import type { WorkflowDef, ExecutorHost } from "./node-schema.js";
-/** Gate invoked before each node executes (budget / permission). Throw to halt the run. */
-export interface ExecutionGate {
-    check(nodeId: string, kind: string): void;
-    /**
-     * Optionally raise the gate's remaining allowance so a budget-paused run can resume (D15
-     * "抬预算后 resume"). Gates without a budget may omit this. Implementations are fail-loud on
-     * non-positive deltas.
-     */
-    extend?(delta: {
-        executions?: number;
-        durationMs?: number;
-    }): void;
-}
-/**
- * Thrown by a gate (or `pause()`) to suspend the run gracefully. Unlike a plain error this is
- * not a failure: completed work stays cached, and a later `run()` on the same instance resumes
- * (cached nodes hit, only the not-yet-run remainder executes).
- */
-export declare class WorkflowPauseSignal extends Error {
-    readonly atNodeId?: string | undefined;
-    constructor(atNodeId?: string | undefined);
-}
-/** Controlled cancellation requested by the controller/delete path. */
-export declare class WorkflowRunCanceled extends Error {
-    constructor(message?: string);
-}
-/** Per-node execution stats for the run trace (D33, IT-9). */
-export interface NodeRunStats {
-    /** Execution order (1-based; cache hits count too — they advance the dag). */
-    seq: number;
-    startedAt: string;
-    finishedAt: string;
-    durationMs: number;
-    /** Executor attempts actually made (≥1; >1 means retries happened). */
-    attempts: number;
-    /** True when the content-addressed cache satisfied this node (no executor invocation). */
-    cacheHit: boolean;
-    /** Final per-node disposition (errorPort/continue keep the run alive but mark failed). */
-    status: "completed" | "failed";
-    /** Engine-imposed limit surfaced on this node (e.g. a loop forced out at its iteration cap) —
-     *  rendered into the run history so caps are visible in the run record, never silent. */
-    warning?: string;
-}
-export interface RunResult {
-    status: "completed" | "failed" | "paused";
-    /** nodeId → its output PortMap. */
-    outputs: Record<string, PortMap>;
-    /** nodeIds whose executor actually ran in this run (cache misses). */
-    executed: Set<string>;
-    progress: ReturnType<DagScheduler["getProgress"]>;
-    /** Set when status === "paused": the node the run suspended at. */
-    pausedAt?: string;
-    /** Ordered per-node trace (D33): timing, attempts, cache hits, disposition. */
-    nodeStats: Record<string, NodeRunStats>;
-}
-export interface WorkflowRuntimeOptions {
-    registry?: NodeRegistry;
-    gate?: ExecutionGate;
-    now?: () => Date;
-    trigger?: Record<string, unknown>;
-    /** This run's trigger KIND (manual/schedule/…) — exposed on ExecutorContext for IT-7b audits. */
-    triggerKind?: string;
-    /** Durable run identity exposed to Host-backed node executors. */
-    runId?: string;
-    log?: {
-        info(m: string): void;
-        warn(m: string): void;
-    };
-    /** Host capabilities for host-backed kinds (agent/tool/http/mcp/channel), D13. */
-    host?: ExecutorHost;
-    /** Cancellation propagated to host calls. */
-    signal?: AbortSignal;
-    /** Durable run checkpoint for crash-restart recovery (plan §M3). */
-    checkpoint?: RunCheckpoint;
-    /**
-     * R5 跨 run 缓存(reuseCache):完成后不清 checkpoint 而是整表回写 —— 同一工作流的
-     * 下一个 run seed 它,未变节点(同 kind+params+inputs 签名)命中跳过(ComfyUI 语义)。
-     * 默认 false = 既有崩溃恢复语义(完成即清)。
-     */
-    preserveCheckpoint?: boolean;
-    /** Per-node lifecycle callback for live status (canvas coloring). Fire-and-forget, not durable. */
-    onNodeStatus?: (nodeId: string, status: "running" | "completed" | "failed", error?: string) => void;
-}
-export declare class WorkflowRuntime {
-    private def;
-    private readonly registry;
-    private readonly gate?;
-    private readonly now;
-    private readonly trigger?;
-    private readonly triggerKind?;
-    private readonly runId?;
-    private readonly log?;
-    private readonly host?;
-    private readonly abortController?;
-    private readonly signal;
-    private readonly checkpoint?;
-    private readonly preserveCheckpoint;
-    private readonly onNodeStatus?;
-    /** Serializes snapshots so an older slow write cannot land after a newer parallel-node write. */
-    private checkpointWriteChain;
-    private dag;
-    private readonly nodeDefs;
-    private readonly nodeOutputs;
-    /** Content-addressed output cache; persists across run() calls for run-from-node. */
-    private readonly cache;
-    /** loopBack source nodeId → loop controller nodeId. */
-    private readonly loopBackOf;
-    /** Cooperative pause request; honored before the next node executes. */
-    private pauseRequested;
-    /** Per-node trace (D33): seq/timing/attempts/cacheHit/disposition, keyed by nodeId. */
-    private readonly nodeStats;
-    private statsSeq;
-    /** True once the durable checkpoint has been loaded into `cache` (load once per instance). */
-    private checkpointLoaded;
-    constructor(def: WorkflowDef, opts?: WorkflowRuntimeOptions);
-    /** Patch a node's params (for run-from-node param changes). Invalidates nothing directly —
-     * the content-addressed cache recomputes only what changed. */
-    setNodeParams(nodeId: string, params: Record<string, unknown>): void;
-    /** Request a cooperative pause: the in-flight run suspends before the next node executes. */
-    pause(): void;
-    /** Cancel the run and abort the signal exposed to long-running executors. */
-    cancel(reason?: string): void;
-    /**
-     * Raise the budget gate's remaining allowance so a budget-paused run can resume (D15
-     * "抬预算后 resume"). fail-loud if this runtime was built without an extensible budget gate.
-     */
-    extendBudget(delta: {
-        executions?: number;
-        durationMs?: number;
-    }): void;
-    /** Execute the workflow to completion (or until the gate halts / a branch fails / a pause). */
-    run(): Promise<RunResult>;
-    /**
-     * Seed the content-addressed cache from a durable checkpoint (once per instance). After a
-     * crash-restart a fresh runtime replays the DAG; nodes that completed before the crash hit
-     * these entries and their executors are not re-invoked (no duplicate side effects).
-     */
-    private loadCheckpoint;
-    /** Persist the full content-addressed cache so a crash mid-run can resume from here. */
-    private persistCheckpoint;
-    private executeNode;
-    /** Loop entry: fire the "loop" port once to kick the first iteration. */
-    private enterLoop;
-    private decideLoopBack;
-    /** A loop forced out at its maxIterations cap (the scheduler marks error="loop_cap_reached:N",
-     *  which previously had NO consumer — the run just took the "done" port as if the loop finished
-     *  naturally). Surface it as a node-level warning: a warn log line + a trace entry the run history
-     *  renders (run-history-store.buildNodeRecords), so the engine-imposed cap is visible in the record. */
-    private surfaceLoopCap;
-    /** Loop again? No condition → loop until the scheduler's maxIterations cap. */
-    private evalLoopCondition;
-    /** Collect inputs for a node from completed upstream outputs along forward data edges. */
-    private collectInputs;
-    private buildExprContext;
-    private cacheKey;
-    private isCanceled;
-    private canceledError;
-    private throwIfCanceled;
-    /** Cancel-aware sleep for retry backoff: aborts immediately when the run is canceled. */
-    private cancellableDelay;
-    private buildDag;
-}

package/dist/types/orchestration/workflow/workflow-scheduler.d.ts

@@ -1,122 +0,0 @@
-/**
- * Reusable in-process Workflow trigger scheduler (plan M3 trigger layer).
- *
- * Production ownership lives in the Runtime Gateway Host: it constructs one project-scoped instance,
- * owns its clock and lifecycle, and routes cron/webhook/IM/manual triggers through that instance. The
- * qlogicagent executable only publishes this inert engine building block and never constructs a
- * scheduler owner.
- *
- * The scheduler is the consumer of WorkflowController: on `start()` it loads every active workflow
- * (`listActive`, spec §B4 restart re-registration) and arms a timer per `schedule` trigger; on fire
- * it calls `controller.run(id, { type: "schedule" })`. Webhook / IM / manual triggers are
- * caller-driven (the gateway relay or the agent invokes the matching method). Concurrency,
- * budgeting, and permission gating all live in `controller.run` — the scheduler only decides WHEN.
- *
- * Determinism: the clock (now + timers) is injected, so tests pin time exactly and far-future cron
- * delays are handled by chunked re-arming (Node's setTimeout caps at ~24.8 days).
- */
-import type { WorkflowController, RunOutcome } from "./workflow-controller.js";
-export type TimerHandle = unknown;
-/** Injectable clock + timer surface so the scheduler is fully deterministic under test. */
-export interface SchedulerClock {
-    now(): number;
-    setTimer(fn: () => void, delayMs: number): TimerHandle;
-    clearTimer(handle: TimerHandle): void;
-}
-/** Default clock backed by the real system time and Node timers. */
-export declare const systemClock: SchedulerClock;
-export interface SchedulerDeps {
-    controller: WorkflowController;
-    clock?: SchedulerClock;
-    /**
-     * Product-level timezone for legacy schedule records that predate an explicit timezone.
-     * The reusable engine remains UTC by default; desktop hosts should pass the user's system zone.
-     */
-    defaultTimezone?: string;
-    /** Latest durable scheduled-run start, used to detect one missed slot after a cold restart. */
-    getLastScheduledAt?: (workflowId: string) => Promise<number | undefined>;
-    /**
-     * Surfaces an error from a timer-driven (cron) run, which has no caller to throw back to.
-     * Required so a failed unattended run is never silently swallowed (§1.5 fail-loud). Caller-driven
-     * triggers (webhook/IM/manual) propagate their errors to the caller instead.
-     */
-    onError: (err: unknown, workflowId: string) => void;
-    onRunStarted?: (workflowId: string, triggerType: string, runId: string) => void | Promise<void>;
-    onRunCompleted?: (outcome: RunOutcome, triggerType: string) => void;
-    onRunFailed?: (workflowId: string, triggerType: string, err: unknown) => void;
-    /**
-     * Trigger rate-limit (D32/§B5 防洪): minimum ms between UNATTENDED fires (webhook/IM/cron) of
-     * the same workflow. A fire inside the window is DROPPED — loudly, via onTriggerDropped (dead
-     * letter), never silently. Manual/intent (attended) fires are exempt. Default 0 (off) — the
-     * production assembly (ensureWorkflowRoot) opts in explicitly; rate policy is the host's call.
-     */
-    minTriggerIntervalMs?: number;
-    /** Dead-letter surface for rate-limited drops. Required when minTriggerIntervalMs > 0. */
-    onTriggerDropped?: (workflowId: string, triggerType: string, detail: {
-        sinceLastMs: number;
-        minIntervalMs: number;
-        reason?: "rate-limit" | "misfire";
-        scheduledAt?: number;
-    }) => void;
-}
-export declare class WorkflowScheduler {
-    private readonly controller;
-    private readonly clock;
-    private readonly onError;
-    private readonly onRunStarted?;
-    private readonly onRunCompleted?;
-    private readonly onRunFailed?;
-    private readonly defaultTimezone;
-    private readonly getLastScheduledAt?;
-    /** Every registered workflow's trigger, keyed by id (the single source for lookups). */
-    private readonly triggers;
-    /** Active cron arms keyed by workflow id. */
-    private readonly cronArms;
-    /** Last unattended fire per workflow (rate-limit window anchor, D32). */
-    private readonly lastFireAt;
-    private readonly minTriggerIntervalMs;
-    private readonly onTriggerDropped?;
-    private started;
-    constructor(deps: SchedulerDeps);
-    /** Load every active workflow and arm its trigger (spec §B4 restart re-registration). */
-    start(): Promise<void>;
-    /** Stop all timers and forget every registration. Idempotent. */
-    stop(): void;
-    /**
-     * Re-read a workflow and (re-)arm its trigger after a create/patch/setActive change. If the
-     * workflow no longer exists or is inactive it is unregistered. Active workflows are armed by
-     * their current trigger (manual ⇒ lookup-only, no timer).
-     */
-    refresh(id: string): Promise<void>;
-    /** Drop a workflow's registration and cancel any pending cron timer. */
-    unregister(id: string): void;
-    /** Workflow ids currently registered (for inspection/tests). */
-    registeredIds(): string[];
-    /** The epoch ms a scheduled workflow will next fire, or undefined if it has no cron arm. */
-    nextFireAt(id: string): number | undefined;
-    /**
-     * Deliver an external webhook hit. Runs every active workflow whose webhook trigger path equals
-     * `path`. Returns the outcomes (empty ⇒ no workflow matched, which the gateway maps to 404).
-     * Errors propagate to the caller (the HTTP handler), which is the fail-loud surface here.
-     */
-    onWebhook(path: string, payload?: Record<string, unknown>): Promise<RunOutcome[]>;
-    /**
-     * Deliver an inbound IM message. Runs every active workflow whose im-message trigger is on
-     * `channel` and whose optional `match` regex tests `text`. The message text + channel are merged
-     * into the run payload so downstream nodes can reference `$trigger`.
-     */
-    onImMessage(channel: string, text: string, payload?: Record<string, unknown>): Promise<RunOutcome[]>;
-    /** Manually trigger a single workflow for the owning Runtime Host. Errors propagate to caller. */
-    triggerManual(id: string, payload?: Record<string, unknown>): Promise<RunOutcome>;
-    private matchingIds;
-    private registerTrigger;
-    private armCron;
-    private fireCron;
-    /**
-     * Unattended-fire rate limit (D32): true ⇒ proceed (and anchor the window); false ⇒ DROPPED,
-     * surfaced via onTriggerDropped (dead letter) — never silent.
-     */
-    private passesRateLimit;
-    private runWithLifecycle;
-    private reportLifecycleCallbackError;
-}

package/dist/types/orchestration/workflow/workflow-store.d.ts

@@ -1,85 +0,0 @@
-/**
- * Workflow Store: project-scoped persistence used by Runtime's Gateway Workflow Host.
- *
- * Stored at `<project>/.qlogicagent/workflows/<workflowId>/workflow.json`. Within a Runtime Host
- * project service, this is the single source of truth for the workflow definition, active flag,
- * and concurrency policy. Runtime re-registers active triggers when that service starts.
- *
- * fail-loud: missing id on save throws; load returns undefined only for a genuinely absent record.
- */
-import type { WorkflowDef } from "./node-schema.js";
-import type { TriggerDef } from "./workflow-patch.js";
-import type { WorkflowTemplateSetupManifest, WorkflowTemplateSetupState } from "./workflow-template-setup.js";
-/** What to do when a workflow is triggered while a previous run is still in-flight (spec §B5). */
-export type ConcurrencyPolicy = "queue" | "skip" | "parallel";
-export interface WorkflowRecord {
-    id: string;
-    name: string;
-    /** Owning user, resolved by the Runtime Host. */
-    owner?: string;
-    def: WorkflowDef;
-    /** Active workflows have their triggers registered by the Runtime Gateway Host. */
-    active: boolean;
-    concurrency: ConcurrencyPolicy;
-    /** The workflow's trigger (set via a WorkflowPatch set_trigger op; spec §C/D7). */
-    trigger?: TriggerDef | null;
-    /** Portable, credential-free inputs shown in the import/template setup panel. */
-    setup?: WorkflowTemplateSetupManifest;
-    /** Non-secret answers and opaque connection references applied from `setup`. */
-    setupState?: WorkflowTemplateSetupState;
-    /**
-     * Unattended-run capability grant (spec D30, IT-7): sensitive node kinds this workflow may
-     * execute under unattended triggers (schedule/im/webhook). Granted explicitly by the owner
-     * at activation time; absent ⇒ unattended runs of sensitive kinds are denied by the gate.
-     */
-    permissionScope?: {
-        allowUnattendedKinds: string[];
-        grantedAt: string;
-    } | null;
-    /** The published (run-by-triggers) snapshot. Absent ⇒ never published ⇒ cannot activate. */
-    publishedDef?: WorkflowDef | null;
-    /** The draft rev that was published (UI: draft-ahead badge when rev > publishedRev). */
-    publishedRev?: number;
-    /** Archived workflows keep their data but cannot run or activate (D31 lifecycle). */
-    archived?: boolean;
-    /** Monotonic revision for optimistic concurrency (LWW); bumped on every patch (spec §C). */
-    rev: number;
-    createdAt: string;
-    updatedAt: string;
-}
-/** Root dir of all workflow records for a project (shared with the run-history store). */
-export declare function workflowsDir(cwd: string): string;
-/** Bounded def-revision history depth — enough for undo, small enough to never matter on disk. */
-export declare const MAX_REVISIONS = 20;
-/** Summary row for revision lists (full snapshot stays behind loadRevision). */
-export interface RevisionSummary {
-    rev: number;
-    updatedAt: string;
-    name: string;
-    nodeCount: number;
-}
-export declare class WorkflowStore {
-    private readonly cwd;
-    constructor(cwd: string);
-    save(record: WorkflowRecord): Promise<void>;
-    /**
-     * Persist a per-rev snapshot alongside the live record (undo/revert 基座).
-     * Keyed by rev: a meta-only update (same rev, e.g. setActive) overwrites its own
-     * snapshot; a patch (rev bump) appends a new one. Bounded to MAX_REVISIONS.
-     * fail-soft: snapshot/prune errors must never block the primary save.
-     */
-    private snapshotRevision;
-    /** Revision numbers, newest first. */
-    private revisionNumbers;
-    /** Newest-first revision summaries for the undo/history UI. */
-    listRevisions(id: string): Promise<RevisionSummary[]>;
-    /** Full record snapshot at a given rev (undefined when pruned/absent). */
-    loadRevision(id: string, rev: number): Promise<WorkflowRecord | undefined>;
-    load(id: string): Promise<WorkflowRecord | undefined>;
-    /** Load a record or throw (fail-loud lookup for callers that require existence). */
-    require(id: string): Promise<WorkflowRecord>;
-    list(): Promise<WorkflowRecord[]>;
-    /** Active workflows the Runtime Gateway Host re-registers when the project service starts. */
-    listActive(): Promise<WorkflowRecord[]>;
-    delete(id: string): Promise<void>;
-}

package/dist/types/orchestration/workflow/workflow-template-setup.d.ts

@@ -1,65 +0,0 @@
-import type { WorkflowDef } from "./node-schema.js";
-import type { TriggerDef } from "./workflow-trigger.js";
-export type WorkflowTemplateSetupValue = string | number | boolean;
-export interface WorkflowTemplateSetupOption {
-    label: string;
-    value: string;
-}
-export interface WorkflowTemplateSetupField {
-    id: string;
-    label: string;
-    description?: string;
-    group?: string;
-    type: "text" | "textarea" | "url" | "number" | "boolean" | "select" | "connection";
-    required?: boolean;
-    placeholder?: string;
-    defaultValue?: WorkflowTemplateSetupValue;
-    options?: WorkflowTemplateSetupOption[];
-    /** Capability/provider family used to filter installed connections. */
-    connectionType?: string;
-}
-export interface WorkflowTemplateSetupBinding {
-    fieldId: string;
-    target: {
-        kind: "node";
-        nodeId: string;
-        path: string;
-    } | {
-        kind: "trigger";
-        path: string;
-    };
-}
-export interface WorkflowTemplateSetupManifest {
-    version: 1;
-    title?: string;
-    description?: string;
-    fields: WorkflowTemplateSetupField[];
-    bindings: WorkflowTemplateSetupBinding[];
-}
-export interface WorkflowTemplateSetupState {
-    values: Record<string, WorkflowTemplateSetupValue>;
-    updatedAt?: string;
-    completedAt?: string;
-}
-export interface WorkflowTemplateSetupProjection {
-    manifest: WorkflowTemplateSetupManifest;
-    values: Record<string, WorkflowTemplateSetupValue>;
-    status: "pending" | "complete";
-    missingRequired: string[];
-}
-export declare function validateWorkflowTemplateSetup(value: unknown, def: WorkflowDef): WorkflowTemplateSetupManifest;
-export declare function projectWorkflowTemplateSetup(manifest: WorkflowTemplateSetupManifest, state?: WorkflowTemplateSetupState): WorkflowTemplateSetupProjection;
-export declare function applyWorkflowTemplateSetup(definition: WorkflowDef, trigger: TriggerDef | null | undefined, manifest: WorkflowTemplateSetupManifest, previous: WorkflowTemplateSetupState | undefined, input: Record<string, unknown>, now?: string): {
-    def: WorkflowDef;
-    trigger?: TriggerDef | null;
-    state: WorkflowTemplateSetupState;
-    missingRequired: string[];
-};
-/**
- * Reset every setup-bound destination before a workflow leaves the local Host.
- * The manifest travels with the bundle; user answers and opaque connection ids do not.
- */
-export declare function resetWorkflowTemplateSetupBindings(definition: WorkflowDef, trigger: TriggerDef | null | undefined, manifest: WorkflowTemplateSetupManifest): {
-    def: WorkflowDef;
-    trigger?: TriggerDef | null;
-};