@aaac/runtime 0.1.11 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -333,7 +333,36 @@ interface GateStep {
333
333
  readonly description: string;
334
334
  readonly depends_on?: readonly string[];
335
335
  }
336
- type WorkflowStep = DelegateStep | GateStep;
336
+ /**
337
+ * Evaluate step — runs a task that returns a convergence-envelope, then either
338
+ * proceeds (verdict=pass) or loops back to `loop_to` with feedback injected
339
+ * (verdict=fail, iteration < max_iterations), or applies `on_exhausted`.
340
+ */
341
+ interface EvaluateStep {
342
+ readonly type: "evaluate";
343
+ readonly task: string;
344
+ readonly from_agent: string;
345
+ readonly evaluator_agent?: string;
346
+ readonly description?: string;
347
+ readonly loop_to: string;
348
+ readonly max_iterations: number;
349
+ readonly inject_as?: string;
350
+ readonly on_exhausted?: "abort" | "fail_partial" | "escalate";
351
+ readonly depends_on?: readonly string[];
352
+ }
353
+ /**
354
+ * Payload returned by an evaluate task in a convergence-envelope handoff.
355
+ * The runtime reads `verdict` to decide whether to proceed or loop back.
356
+ */
357
+ interface ConvergenceEnvelopePayload {
358
+ /** "pass" means quality gate passed; "fail" triggers a loop-back. */
359
+ readonly verdict: "pass" | "fail";
360
+ /** Human-readable feedback injected into the next iteration via `inject_as`. */
361
+ readonly feedback?: string;
362
+ }
363
+ /** Typed handoff envelope produced by an evaluate task. */
364
+ type ConvergenceEnvelope = HandoffInput<"convergence-envelope", ConvergenceEnvelopePayload>;
365
+ type WorkflowStep = DelegateStep | GateStep | EvaluateStep;
337
366
  interface WorkflowContractLike {
338
367
  readonly id: string;
339
368
  readonly description: string;
@@ -432,7 +461,7 @@ interface StepResult {
432
461
  interface StepCompleteEvent {
433
462
  workflow_id: string;
434
463
  step_index: number;
435
- step_type: "delegate" | "gate";
464
+ step_type: "delegate" | "gate" | "evaluate";
436
465
  task_id?: string;
437
466
  gate_kind?: string;
438
467
  outcome_status: string;
@@ -915,4 +944,4 @@ declare function runTask(adapter: SdkAdapter, taskId: string, context: TaskConte
915
944
  libraryTools?: LibraryToolRegistry;
916
945
  }): Promise<TaskRunResult>;
917
946
 
918
- export { type WorkflowStep as $, type AdapterSendOptions as A, type BoundResolveOptions as B, type CacheConfig as C, type DelegateStep as D, type EnvelopeParams as E, type ModelResolver as F, type GuardrailHooks as G, type HandoffInput as H, InMemoryStore as I, type ModelResolverOptions as J, type ReceiveSpec as K, type LibraryToolRegistry as L, type MemoryRef as M, type ResolvedModel as N, type ObserverEmitFn as O, type PromptBuilderOptions as P, type RetryDecision as Q, type ResolvedComponent as R, type SdkAdapter as S, type TaskContext as T, type SdkAdapterFactory as U, type SplitPrompt as V, type WorkflowResult as W, type TaskRunOptions as X, type WorkflowContractLike as Y, type WorkflowInvocation as Z, type WorkflowRunOptions as _, type AgentExecutionRequest as a, buildCandidateAgents as a0, buildGateEvaluationPrompt as a1, buildPerAgentGuardrails as a2, buildRetryFollowUp as a3, buildSplitTaskPrompt as a4, buildTaskPrompt as a5, createExecutionEnvelope as a6, createGuardrailHooks as a7, createGuardrailHooksForAgent as a8, createGuardrailHooksFromRules as a9, createLibraryToolRegistry as aa, createModelResolver as ab, deriveToolchainsForAgents as ac, emitSessionClose as ad, emitSessionOpen as ae, emitSubagentClose as af, emitSubagentOpen as ag, emitToolchainClose as ah, emitToolchainOpen as ai, extractStructuredResult as aj, getBlockingViolations as ak, getEffectiveGuardrailIds as al, getGuardrailRulesForAgent as am, getWarnings as an, guardrailContextToRuleData as ao, hasBlockingViolation as ap, parseGateEvaluationResponse as aq, renderAgentSystemPrompt as ar, runTask as as, runWorkflow as at, zodSchemaToPromptDescription as au, zodSchemaToYamlExample as av, type TaskOutcome as b, type AgentContractLike as c, type TaskContractLike as d, type WorkflowRegistries as e, type StepCompleteEvent as f, type StepResult as g, type GuardrailRuleData as h, type MemoryStore as i, type ArtifactBindingConfig as j, type TaskRunResult as k, type ResolvedToolchain as l, type LibraryToolDefinition as m, type AdapterOrFactory as n, type AgentProgressEvent as o, BoundResolver as p, type CandidateAgent as q, type GateStep as r, type GuardrailCheckFunctions as s, type GuardrailCheckResult as t, type GuardrailRule as u, type HookContext as v, type HookResponse as w, type ModelAwareSdkAdapterFactory as x, type ModelClass as y, type ModelMappingConfig as z };
947
+ export { type WorkflowContractLike as $, type AdapterSendOptions as A, type BoundResolveOptions as B, type CacheConfig as C, type DelegateStep as D, type EnvelopeParams as E, type ModelAwareSdkAdapterFactory as F, type GuardrailHooks as G, type HandoffInput as H, InMemoryStore as I, type ModelClass as J, type ModelMappingConfig as K, type LibraryToolRegistry as L, type MemoryRef as M, type ModelResolver as N, type ObserverEmitFn as O, type PromptBuilderOptions as P, type ModelResolverOptions as Q, type ResolvedComponent as R, type SdkAdapter as S, type TaskContext as T, type ReceiveSpec as U, type ResolvedModel as V, type WorkflowResult as W, type RetryDecision as X, type SdkAdapterFactory as Y, type SplitPrompt as Z, type TaskRunOptions as _, type AgentExecutionRequest as a, type WorkflowInvocation as a0, type WorkflowRunOptions as a1, type WorkflowStep as a2, buildCandidateAgents as a3, buildGateEvaluationPrompt as a4, buildPerAgentGuardrails as a5, buildRetryFollowUp as a6, buildSplitTaskPrompt as a7, buildTaskPrompt as a8, createExecutionEnvelope as a9, createGuardrailHooks as aa, createGuardrailHooksForAgent as ab, createGuardrailHooksFromRules as ac, createLibraryToolRegistry as ad, createModelResolver as ae, deriveToolchainsForAgents as af, emitSessionClose as ag, emitSessionOpen as ah, emitSubagentClose as ai, emitSubagentOpen as aj, emitToolchainClose as ak, emitToolchainOpen as al, extractStructuredResult as am, getBlockingViolations as an, getEffectiveGuardrailIds as ao, getGuardrailRulesForAgent as ap, getWarnings as aq, guardrailContextToRuleData as ar, hasBlockingViolation as as, parseGateEvaluationResponse as at, renderAgentSystemPrompt as au, runTask as av, runWorkflow as aw, zodSchemaToPromptDescription as ax, zodSchemaToYamlExample as ay, type TaskOutcome as b, type AgentContractLike as c, type TaskContractLike as d, type WorkflowRegistries as e, type StepCompleteEvent as f, type StepResult as g, type GuardrailRuleData as h, type MemoryStore as i, type ArtifactBindingConfig as j, type TaskRunResult as k, type ResolvedToolchain as l, type LibraryToolDefinition as m, type AdapterOrFactory as n, type AgentProgressEvent as o, BoundResolver as p, type CandidateAgent as q, type ConvergenceEnvelope as r, type ConvergenceEnvelopePayload as s, type EvaluateStep as t, type GateStep as u, type GuardrailCheckFunctions as v, type GuardrailCheckResult as w, type GuardrailRule as x, type HookContext as y, type HookResponse as z };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aaac/runtime",
3
- "version": "0.1.11",
3
+ "version": "0.1.12",
4
4
  "description": "Runtime SDK for the AaaC toolchain",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -58,7 +58,7 @@
58
58
  "@aaac/contracts": "*",
59
59
  "@aaac/toolchain": "*",
60
60
  "@aaac/observability": "*",
61
- "agent-contracts": "^0.35.0",
61
+ "agent-contracts": "^0.35.1",
62
62
  "commander": "^12.1.0",
63
63
  "dotenv": "^17.4.2",
64
64
  "tsx": "^4.21.0",