@aaac/runtime 0.1.29 → 0.1.30

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.
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-Dyp09_Vl.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-Dyp09_Vl.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-Dyp09_Vl.js';
1
+ import { S as SdkAdapter, A as AdapterSendOptions, M as MemoryRef } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
@@ -1,4 +1,4 @@
1
- import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-Dyp09_Vl.js';
1
+ import { S as SdkAdapter, G as GuardrailHooks, C as CacheConfig, A as AdapterSendOptions, a as AgentExecutionRequest, M as MemoryRef, T as TokenUsage } from '../task-runner-CeM6vETd.js';
2
2
  import 'zod';
3
3
  import '../context-DKkamYX_.js';
4
4
  import '@aaac/observability';
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { O as ObserverEmitFn, b as TaskContext, c as TaskOutcome, d as AgentContractLike, e as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, f as WorkflowRegistries, H as HandoffInput, g as StepCompleteEvent, h as StepResult, D as DelegateStep, i as GuardrailRuleData, j as MemoryStore, M as MemoryRef, k as SdkFunctionTool, G as GuardrailHooks, R as ResolvedComponent, l as ArtifactBindingConfig, m as RunToolchainChecksOptions, n as TaskRunResult, L as LibraryToolRegistry, o as ResolvedToolchain, p as LibraryToolDefinition, q as HookResponse, r as GuardrailCheckResult } from './task-runner-Dyp09_Vl.js';
2
- export { s as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, t as AgentProgressEvent, B as BoundResolveOptions, u as BoundResolver, C as CacheConfig, v as CandidateAgent, w as ConvergenceEnvelope, x as ConvergenceEnvelopePayload, E as EnvelopeParams, y as EvaluateStep, z as GateStep, F as GuardrailCheckFunctions, I as GuardrailRule, J as HookContext, K as InMemoryStore, N as InnerSpanOptions, Q as ModelAwareSdkAdapterFactory, U as ModelClass, V as ModelMappingConfig, X as ModelResolver, Y as ModelResolverOptions, Z as OBSERVABILITY_ENV_VARS, _ as ObservabilityIds, $ as ReceiveSpec, a0 as ResolvedModel, a1 as RetryDecision, a2 as SdkAdapterFactory, a3 as SplitPrompt, a4 as TaskRunOptions, T as TokenUsage, a5 as ToolchainCheckResult, a6 as ToolchainManifest, a7 as ToolchainManifestSchema, a8 as WorkflowContractLike, a9 as WorkflowInvocation, aa as WorkflowRunOptions, ab as WorkflowStep, ac as buildCandidateAgents, ad as buildGateEvaluationPrompt, ae as buildObservabilityEnv, af as buildPerAgentGuardrails, ag as buildRetryFollowUp, ah as buildSdkFunctionTools, ai as buildSplitTaskPrompt, aj as buildTaskPrompt, ak as collectAnalyzerToolIds, al as createExecutionEnvelope, am as createGuardrailHooks, an as createGuardrailHooksForAgent, ao as createGuardrailHooksFromRules, ap as createLibraryToolRegistry, aq as createModelResolver, ar as createRegistryFromSdkTools, as as deriveToolchainsForAgents, at as emitIterationClose, au as emitIterationMetric, av as emitIterationOpen, aw as emitLlmTurnClose, ax as emitLlmTurnOpen, ay as emitSessionClose, az as emitSessionOpen, aA as emitSubagentClose, aB as emitSubagentOpen, aC as emitToolExecClose, aD as emitToolExecOpen, aE as emitToolchainClose, aF as emitToolchainOpen, aG as extractStructuredResult, aH as getBlockingViolations, aI as getEffectiveGuardrailIds, aJ as getGuardrailRulesForAgent, aK as getWarnings, aL as guardrailContextToRuleData, aM as hasBlockingViolation, aN as isNavigationIndex, aO as parseGateEvaluationResponse, aP as renderAgentSystemPrompt, aQ as renderAnalyzerExplorationMandatePrompt, aR as renderNavigationIndexPrompt, aS as runTask, aT as runToolchainChecks, aU as runWorkflow, aV as shouldInjectAnalyzerExplorationMandate, aW as zodSchemaToPromptDescription, aX as zodSchemaToYamlExample } from './task-runner-Dyp09_Vl.js';
1
+ import { O as ObserverEmitFn, b as TaskContext, c as TaskOutcome, d as AgentContractLike, e as TaskContractLike, P as PromptBuilderOptions, W as WorkflowResult, S as SdkAdapter, f as WorkflowRegistries, H as HandoffInput, g as StepCompleteEvent, h as StepResult, D as DelegateStep, i as GuardrailRuleData, j as MemoryStore, M as MemoryRef, k as SdkFunctionTool, G as GuardrailHooks, R as ResolvedComponent, l as ArtifactBindingConfig, m as RunToolchainChecksOptions, n as ModelMappingConfig, o as TaskRunResult, L as LibraryToolRegistry, p as ResolvedToolchain, q as LibraryToolDefinition, r as HookResponse, s as GuardrailCheckResult } from './task-runner-CeM6vETd.js';
2
+ export { t as AdapterOrFactory, A as AdapterSendOptions, a as AgentExecutionRequest, u as AgentProgressEvent, B as BoundResolveOptions, v as BoundResolver, C as CacheConfig, w as CandidateAgent, x as ConvergenceEnvelope, y as ConvergenceEnvelopePayload, E as EnvelopeParams, z as EvaluateStep, F as GateStep, I as GuardrailCheckFunctions, J as GuardrailRule, K as HookContext, N as InMemoryStore, Q as InnerSpanOptions, U as ModelAwareSdkAdapterFactory, V as ModelClass, X as ModelResolver, Y as ModelResolverOptions, Z as OBSERVABILITY_ENV_VARS, _ as ObservabilityIds, $ as ReceiveSpec, a0 as ResolvedModel, a1 as RetryDecision, a2 as SdkAdapterFactory, a3 as SplitPrompt, a4 as TaskRunOptions, T as TokenUsage, a5 as ToolchainCheckResult, a6 as ToolchainManifest, a7 as ToolchainManifestSchema, a8 as WorkflowContractLike, a9 as WorkflowInvocation, aa as WorkflowRunOptions, ab as WorkflowStep, ac as buildCandidateAgents, ad as buildGateEvaluationPrompt, ae as buildObservabilityEnv, af as buildPerAgentGuardrails, ag as buildRetryFollowUp, ah as buildSdkFunctionTools, ai as buildSplitTaskPrompt, aj as buildTaskPrompt, ak as collectAnalyzerToolIds, al as createExecutionEnvelope, am as createGuardrailHooks, an as createGuardrailHooksForAgent, ao as createGuardrailHooksFromRules, ap as createLibraryToolRegistry, aq as createModelResolver, ar as createRegistryFromSdkTools, as as deriveToolchainsForAgents, at as emitIterationClose, au as emitIterationMetric, av as emitIterationOpen, aw as emitLlmTurnClose, ax as emitLlmTurnOpen, ay as emitSessionClose, az as emitSessionOpen, aA as emitSubagentClose, aB as emitSubagentOpen, aC as emitToolExecClose, aD as emitToolExecOpen, aE as emitToolchainClose, aF as emitToolchainOpen, aG as extractStructuredResult, aH as getBlockingViolations, aI as getEffectiveGuardrailIds, aJ as getGuardrailRulesForAgent, aK as getWarnings, aL as guardrailContextToRuleData, aM as hasBlockingViolation, aN as isNavigationIndex, aO as parseGateEvaluationResponse, aP as renderAgentSystemPrompt, aQ as renderAnalyzerExplorationMandatePrompt, aR as renderNavigationIndexPrompt, aS as runTask, aT as runToolchainChecks, aU as runWorkflow, aV as shouldInjectAnalyzerExplorationMandate, aW as zodSchemaToPromptDescription, aX as zodSchemaToYamlExample } from './task-runner-CeM6vETd.js';
3
3
  import { z } from 'zod';
4
4
  import { OperationIR, ComponentIR } from '@aaac/contracts';
5
5
  import { ResolvedConfig } from './generator/index.js';
@@ -510,6 +510,8 @@ interface ExecuteOptions {
510
510
  * Only consumed by executeWorkflow (toolchain checks are a run-level concern).
511
511
  */
512
512
  toolchain?: RunToolchainChecksOptions;
513
+ /** Per-class adapter/model mapping from project.yaml (used by executeWorkflow). */
514
+ modelMapping?: ModelMappingConfig;
513
515
  }
514
516
  interface TaskHookContext {
515
517
  adapter: SdkAdapter;
@@ -863,4 +865,4 @@ declare function executePrompt(message: string, ir: ComponentIR, binding: Runtim
863
865
  /** Package version string. */
864
866
  declare const version: string;
865
867
 
866
- export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, type AnalyzeImpactInput, type AnalyzerBridge, type AnalyzerBridgeOptions, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type BuildCallGraphInput, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GenerateContextPackInput, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, createAdapter, createAnalyzerBridge, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, guardStatus, isContextPack, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseRouterResponse, pluginRegistry, renderContextPackPrompt, resolveArtifacts, version };
868
+ export { type AaacInvocationContext, type AaacObserver, type AaacPolicy, type AaacRuntime, AgentContractLike, AgentLogWriter, type AgentLogWriterOptions, type AgentPlugin, type AnalyzeImpactInput, type AnalyzerBridge, type AnalyzerBridgeOptions, ArtifactBindingConfig, type ArtifactResolveOptions, type ArtifactResolveResult, type BuildCallGraphInput, type ComponentScope, type CreateAdapterOptions, type CreateComponentScopeOptions, type CreateProjectRuntimeOptions, DelegateStep, type DslContext, DslValidationError, type EvaluateGuardrailOptions, type EvaluateGuardrailResult, type ExecuteOptions, type ExecuteTaskOptions, type ExecuteWorkflowOptions, FileMemoryStore, type GenerateContextPackInput, type GuardStatusOptions, type GuardStatusResult, GuardrailCheckResult, GuardrailHooks, type GuardrailListEntry, type GuardrailResult, GuardrailRuleData, HandoffInput, HookResponse, LibraryToolDefinition, LibraryToolRegistry, type ListGuardrailsOptions, type ListGuardrailsResult, type LoadDslOptions, MemoryRef, MemoryStore, type MemoryStoreEntry, ModelMappingConfig, type NavigationContext, type NavigationContextOptions, ObserverEmitFn, type OperationHandler, type OperationMemoryRefConfig, type OperationToolDef, PROJECT_CONFIG_FILENAME, type PermissionMode, type PluginLoadResult, PluginRegistry, type ProcessEditOptions, type ProcessTaskOptions, type ProcessWorkflowOptions, type ProgressSink, type ProgressSinkOptions, type ProjectRuntime, type PromptBuilderArgs, PromptBuilderOptions, type PromptExecuteOptions, type PromptResult, type RequiredEntities, type ResolvedAdapterSelection, ResolvedComponent, ResolvedToolchain, type RunLogEvent, RunToolchainChecksOptions, type Runtime, type RuntimeBinding, type RuntimeConfig, SdkAdapter, SdkFunctionTool, StepCompleteEvent, StepResult, TaskContext, TaskContractLike, type TaskHookContext, TaskOutcome, TaskRunResult, WorkflowBuilder, type WorkflowHookContext, WorkflowRegistries, WorkflowResult, buildGuardrailRulesFromDsl, buildNavigationContext, buildRegistriesFromDsl, createAdapter, createAnalyzerBridge, createComponentScope, createProgressSink, createProjectRuntime, createRuntime, createRuntimeBinding, emitProcessEdit, emitProcessTaskClose, emitProcessTaskOpen, emitProcessWorkflowClose, emitProcessWorkflowOpen, evaluateGuardrail, executePrompt, executeTask, executeWorkflow, findProjectConfig, guardStatus, isContextPack, jsonSchemaToZod, listGuardrails, loadDslContext, loadPlugins, loadPluginsFromDirectory, loadPluginsFromPaths, operationsToTools, parseRouterResponse, pluginRegistry, renderContextPackPrompt, resolveArtifacts, version };
package/dist/index.js CHANGED
@@ -923,8 +923,10 @@ async function runTask(adapter, taskId, context, options) {
923
923
  taskInstanceId: taskId,
924
924
  componentId: agentContract.id,
925
925
  fromAgent: agentContract.id,
926
- parentRunId: options?.parentSpanId
926
+ parentRunId: options?.parentSpanId,
927
927
  // correlates to agent.session run_id
928
+ adapter: options?.envelopeAdapter,
929
+ model: options?.envelopeModel
928
930
  });
929
931
  const modifiedContext = await pluginRegistry.runBeforeTask(taskId, context);
930
932
  if (modifiedContext === null) {
@@ -1301,7 +1303,8 @@ function resolveInvocation(invocation) {
1301
1303
  progressOutput: invocation.progressOutput,
1302
1304
  observer: invocation.observer,
1303
1305
  toolchain: invocation.toolchain,
1304
- libraryTools: invocation.libraryTools
1306
+ libraryTools: invocation.libraryTools,
1307
+ resolveModelMeta: invocation.resolveModelMeta
1305
1308
  }
1306
1309
  };
1307
1310
  }
@@ -1349,7 +1352,12 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1349
1352
  };
1350
1353
  }
1351
1354
  await pluginRegistry.runBeforeWorkflow(workflowId, options.user_request);
1352
- const sessionEnvelope = createExecutionEnvelope({ componentId: workflowId });
1355
+ const sessionMeta = options.resolveModelMeta?.(void 0);
1356
+ const sessionEnvelope = createExecutionEnvelope({
1357
+ componentId: workflowId,
1358
+ adapter: sessionMeta?.adapter,
1359
+ model: sessionMeta?.model
1360
+ });
1353
1361
  const sessionSpanId = emitSessionOpen(options.observer, sessionEnvelope, workflowId);
1354
1362
  const workflowStart = Date.now();
1355
1363
  let wfResult;
@@ -1413,7 +1421,7 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1413
1421
  const evaluateExecCount = /* @__PURE__ */ new Map();
1414
1422
  const iterationSpanIds = /* @__PURE__ */ new Map();
1415
1423
  const loopInjectedVars = {};
1416
- async function executeStep(i, stepAdapter) {
1424
+ async function executeStep(i, stepAdapter, envelopeMeta) {
1417
1425
  const step = workflow.steps[i];
1418
1426
  const stepStart = Date.now();
1419
1427
  if (step.type === "gate") {
@@ -1450,7 +1458,9 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1450
1458
  observer: options.observer,
1451
1459
  parentSpanId: iterationSpanId ?? sessionSpanId,
1452
1460
  sessionId: sessionSpanId ?? sessionEnvelope.run_id,
1453
- libraryTools: options.libraryTools
1461
+ libraryTools: options.libraryTools,
1462
+ envelopeAdapter: envelopeMeta?.adapter,
1463
+ envelopeModel: envelopeMeta?.model
1454
1464
  });
1455
1465
  return {
1456
1466
  step_index: i,
@@ -1513,7 +1523,9 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1513
1523
  observer: options.observer,
1514
1524
  parentSpanId: sessionSpanId,
1515
1525
  sessionId: sessionSpanId ?? sessionEnvelope.run_id,
1516
- libraryTools: options.libraryTools
1526
+ libraryTools: options.libraryTools,
1527
+ envelopeAdapter: envelopeMeta?.adapter,
1528
+ envelopeModel: envelopeMeta?.model
1517
1529
  });
1518
1530
  return {
1519
1531
  step_index: i,
@@ -1556,7 +1568,8 @@ async function runWorkflow(adapterOrFactory, workflowIdOrInvocation, optionsOrRe
1556
1568
  } else {
1557
1569
  stepAdapter = primaryAdapter;
1558
1570
  }
1559
- return executeStep(i, stepAdapter);
1571
+ const envelopeMeta = options.resolveModelMeta?.(modelClass);
1572
+ return executeStep(i, stepAdapter, envelopeMeta);
1560
1573
  }));
1561
1574
  for (let b = 0; b < ready.length; b++) {
1562
1575
  const i = ready[b];
@@ -3123,6 +3136,8 @@ async function executeTask(taskId, options) {
3123
3136
  progressOutput: progressSink,
3124
3137
  observer: options.observer,
3125
3138
  libraryTools: analyzerTools,
3139
+ envelopeAdapter: options.adapter,
3140
+ envelopeModel: options.model,
3126
3141
  ...execCtx.registries
3127
3142
  });
3128
3143
  if (options.hooks?.afterTask) {
@@ -3160,6 +3175,11 @@ async function executeWorkflow(workflowId, options) {
3160
3175
  if (options.hooks?.beforeWorkflow) {
3161
3176
  await options.hooks.beforeWorkflow({ adapter, registries: execCtx.registries, workflowId });
3162
3177
  }
3178
+ const modelResolver = createModelResolver({
3179
+ modelMapping: options.modelMapping,
3180
+ fallbackAdapter: options.adapter,
3181
+ fallbackModel: options.model
3182
+ });
3163
3183
  const invocation = {
3164
3184
  workflow: workflowId,
3165
3185
  user_request: options.request,
@@ -3168,6 +3188,7 @@ async function executeWorkflow(workflowId, options) {
3168
3188
  observer: options.observer,
3169
3189
  toolchain: options.toolchain,
3170
3190
  libraryTools: analyzerTools,
3191
+ resolveModelMeta: (modelClass) => modelResolver.resolve(modelClass),
3171
3192
  runtime: {
3172
3193
  maxFollowUps: options.maxFollowUps ?? 2,
3173
3194
  maxRetries: options.maxRetries ?? 0
@@ -3396,6 +3417,7 @@ async function createProjectRuntime(options) {
3396
3417
  artifactBinding: config.artifactsPath ? { source: config.artifactsPath } : void 0,
3397
3418
  maxFollowUps: config.recovery.max_follow_ups,
3398
3419
  maxRetries: config.recovery.max_retries,
3420
+ modelMapping: config.model_mapping,
3399
3421
  observer,
3400
3422
  // Toolchain.execution observation: only when BOTH in-process observability
3401
3423
  // is wired AND project.yaml declares `toolchains`. Observation is non-