@sweny-ai/core 0.1.176 → 0.1.178

package/dist/executor.d.ts

@@ -12,11 +12,10 @@
  *
  * This replaces ~8k lines of engine + recipe step code.
  */
-import type { Workflow, Skill, Tool, Claude, Observer, NodeResult, Logger, ExecutionResult } from "./types.js";
-import "./skills/git-push.js";
+import type { Workflow, Node, Skill, Tool, Claude, Observer, NodeResult, Logger, ExecutionResult, JSONSchema } from "./types.js";
 import type { HarnessPolicyMode } from "./harness/policy.js";
 import type { AgentHarness } from "./harness/types.js";
-import type { DeciderMode } from "./decider.js";
+import type { DeciderOperatorConfig } from "./decider.js";
 import type { Budget } from "./budget.js";
 import { type ActorInfo } from "./safe-outputs.js";
 import type { ExecutionJournal } from "./journal.js";
@@ -107,11 +106,13 @@ export interface ExecuteOptions {
      */
     harnessPolicy?: HarnessPolicyMode;
     /**
-     * Override `workflow.decider.mode` (CLI `--decider`). `shadow` still needs
-     * `decider.provider` in the workflow; there is no default URL. Default: the
-     * workflow's own mode, else off (zero HTTP calls).
+     * Operator config for the decision model (#357): where it lives and its
+     * key. Only nodes with `route_by: decider` consult it. `false` turns it off
+     * for this run (CLI `--no-decider`). Undefined: no decider (those nodes are
+     * routed by the agent and the receipt says why). Never read from the
+     * workflow; the CLI builds it from `.sweny.yml` and SWENY_DECIDER_* env.
      */
-    decider?: DeciderMode;
+    decider?: DeciderOperatorConfig | false;
 }
 /**
  * Default workflow-level step budget. Counts total node executions across the
@@ -139,14 +140,61 @@ export declare class RouteEvaluationError extends Error {
     readonly node: string;
     constructor(node: string, message: string);
 }
+/** A declared output field the decider may see: a number, an integer, a boolean or a string enum. */
+type RoutableField = {
+    kind: "number" | "integer" | "boolean";
+} | {
+    kind: "enum";
+    values: ReadonlySet<string>;
+};
+/**
+ * The routable fields a node declares: `output.properties` entries typed
+ * number, integer or boolean, or a string `enum`. Free-text strings, arrays,
+ * objects and anything untyped are never routable.
+ */
+export declare function routableFields(node: Node | undefined): Map<string, RoutableField>;
+/**
+ * The state the decision model sees (#357), or null when the decider must be
+ * skipped (`no_routable_state`): a condition reads `input.*` (never sent), the
+ * routed node declares no routable field, or a condition names a node that
+ * declares none. Otherwise: per prior node, its status, its routable declared
+ * fields projected to their declared types (successful nodes only) and its
+ * eval verdicts. Never the run input, free-text or undeclared data,
+ * summaries, tool calls, env or skill config. Redacted with the journal's
+ * redactor and fenced as untrusted data.
+ */
+export declare function deciderRoutingState(workflow: Workflow, current: string, results: Map<string, NodeResult>, conditions: string[], secrets: string[]): string | null;
 /**
  * The bounded prompt context for one node: `input` plus its dependencies' entries.
  * Exported for the property tests only; not part of the package API (index.ts does not re-export it).
  * @internal
  */
 export declare function buildBoundedContext(workflow: Workflow, nodeId: string, results: Map<string, NodeResult>, input: unknown, instruction: string): Record<string, unknown>;
+/** One way a node's emitted data breaks its declared output contract. */
+export interface ContractProblem {
+    field: string;
+    kind: "missing" | "invalid";
+    problem: string;
+}
+/** Keyword on an integer output property: the count sweny cross-checks against an array in the same output. */
+export declare const COUNT_OF_KEYWORD = "x-sweny-count-of";
+/**
+ * Check emitted data against the declared output contract (#357): every
+ * `required` field present; every present top-level property of its declared
+ * `type` and inside its `enum`; and every `x-sweny-count-of` integer equal to
+ * the count it declares over its array. Not full JSON Schema: formats,
+ * nested shapes and additionalProperties stay the author's concern.
+ */
+export declare function outputContractProblems(data: unknown, output: JSONSchema | undefined): ContractProblem[];
 /**
  * Dry-run tool gate (#380). Only an explicit `access: "read"` passes; a tool
  * with no `access` is treated as a write so new tools fail safe.
  */
 export declare function isReadTool(tool: Pick<Tool, "access">): boolean;
+/**
+ * The tool dispatcher's staged-run gate: in a staged or dry run no write (or
+ * unclassified) tool handler runs, whatever reached the agent. Throws before
+ * any side effect.
+ */
+export declare function guardStagedWrite(tool: Pick<Tool, "name" | "access">, staged: boolean): void;
+export {};