@xandreed/sdk 0.15.0 → 0.16.0

package/README.md

@@ -1,5 +1,5 @@
 # @xandreed/sdk
 
-Efferent composable agent framework, 0.15.0. Node 24 or Bun.
+Efferent composable agent framework, 0.16.0. Node 24 or Bun.
 
 Documentation: https://github.com/xandreeddev/efferent

package/dist/agent.adapter.d.ts

@@ -42,7 +42,7 @@ export interface AgentConfig {
     readonly workspace?: string;
     /**
      * Defaults for every run; a turn's policy overrides them. Its loop
-     * protection (`degenerate`, `malformedLimit`) is decoded here
+     * protection (`degenerate`, `malformedLimit`, `invalidCalls`) is decoded here
      * (`config.limits`), and a run's merged limits again (`turn.limits`).
      */
     readonly limits?: Partial<LoopLimits>;

package/dist/agent.adapter.js

@@ -3,6 +3,7 @@ import {
   CurrentTraceContent,
   DrainActivity,
   WaitingInput,
+  BackgroundWorkers,
   CapabilitiesLive,
   DEFAULT_SHUTDOWN_DEADLINE,
   Capabilities,
@@ -11,6 +12,7 @@ import {
   harnessDefectsAsFailures,
   HarnessError,
   LoopProtection,
+  notifyCommittedTurn,
   isBudgetTokens,
   normalizeUserMessage,
   PluginInstanceId,
@@ -74,7 +76,7 @@ const failure = (code, message) => new HarnessError({ code, message }), missing
 }, []), makeAgent = (config) => Effect.gen(function* () {
   if (config.budgetTokens !== void 0 && !isBudgetTokens(config.budgetTokens))
     return yield* Effect.fail(failure("config.budget", `budgetTokens must be an integer of at least 1, not ${config.budgetTokens}`));
-  yield* Schema.decodeUnknownEffect(LoopProtection)(config.limits ?? {}).pipe(Effect.mapError((cause) => new HarnessError({ code: "config.limits", message: "the agent's limits carry a degenerate policy or malformedLimit that does not decode", cause })));
+  yield* Schema.decodeUnknownEffect(LoopProtection)(config.limits ?? {}).pipe(Effect.mapError((cause) => new HarnessError({ code: "config.limits", message: "the agent's limits carry a degenerate policy, malformedLimit or invalidCalls that does not decode", cause })));
   const parent = yield* Effect.scope, entries = config.plugins.map(entryOf), hosted = config.capabilities ?? [], host = hostCapabilities(hosted), withHost = hosted.length > 0, plugins = [...withHost ? [host] : [], ...entries.map((entry) => entry.plugin)], harness = {
     version: 1,
     plugins: [
@@ -123,16 +125,17 @@ const failure = (code, message) => new HarnessError({ code, message }), missing
       if (!own)
         return yield* exit;
       if (Exit.isFailure(exit)) {
-        yield* writer.end(turnEndingOf(exit)).pipe(Effect.catchTag("TurnClosed", (closed) => Effect.logDebug(`the failed turn's end was not stored: the turn was ${closed.reason}`)), Effect.catch((error) => Effect.logWarning(`the failed turn's end was not stored: ${reasonOf(Cause.fail(error))}`)));
+        yield* writer.end(turnEndingOf(exit)).pipe(Effect.tap(() => notifyCommittedTurn({ session: writer.admitted.session, runId: writer.admitted.runId, turn: writer.admitted.turn }).pipe(Effect.provide(context))), Effect.catchTag("TurnClosed", (closed) => Effect.logDebug(`the failed turn's end was not stored: the turn was ${closed.reason}`)), Effect.catch((error) => Effect.logWarning(`the failed turn's end was not stored: ${reasonOf(Cause.fail(error))}`)));
         return yield* Effect.failCause(exit.cause);
       }
       const { pending } = yield* writer.end(turnEndingOf(exit));
+      yield* notifyCommittedTurn({ session: writer.admitted.session, runId: writer.admitted.runId, turn: writer.admitted.turn }).pipe(Effect.provide(context));
       return { ...exit.value, pending };
     }).pipe(Effect.annotateLogs(turnAttributes(writer.admitted)), measureTurn, traceTurn(writer, { spanMeta: config.spanMeta ?? [] }));
   }))), runtimeProbes = (effect) => effect.pipe(Effect.updateContext((current) => {
-    const probes = Context.merge(Context.omit(TurnActivity, TaskActivity, TurnShutdown, WaitingInput, DrainActivity)(current), Context.pick(TurnActivity, TaskActivity, TurnShutdown, WaitingInput, DrainActivity)(runtime)), drains = Option.orElse(Context.getOption(runtime, DrainActivity), () => Context.getOption(current, DrainActivity));
+    const probes = Context.merge(Context.omit(TurnActivity, TaskActivity, TurnShutdown, WaitingInput, DrainActivity, BackgroundWorkers)(current), Context.pick(TurnActivity, TaskActivity, TurnShutdown, WaitingInput, DrainActivity, BackgroundWorkers)(runtime)), drains = Option.orElse(Context.getOption(runtime, DrainActivity), () => Context.getOption(current, DrainActivity));
     return Option.match(drains, { onNone: () => probes, onSome: (probe) => Context.add(probes, DrainActivity, probe) });
-  })), activity = runtimeProbes(processActivity), shutdown = (options) => runtimeProbes(shutdownGracefully(options ?? config.shutdown ?? { deadline: DEFAULT_SHUTDOWN_DEADLINE })).pipe(Effect.tap((report) => report.left.inFlight ? Effect.logWarning(`the agent stopped with ${report.left.openTurns.length + report.left.beginningTurns} turns and ${report.left.runningTasks} tasks still in flight`) : Effect.void)), configured = config.shutdown;
+  })), activity = runtimeProbes(processActivity), shutdown = (options) => runtimeProbes(shutdownGracefully(options ?? config.shutdown ?? { deadline: DEFAULT_SHUTDOWN_DEADLINE })).pipe(Effect.tap((report) => report.left.inFlight ? Effect.logWarning(`the agent stopped with ${report.left.openTurns.length + report.left.beginningTurns} turns and ${report.left.runningTasks} tasks${report.left.runningWorkers === void 0 ? "" : ` and ${report.left.runningWorkers} worker jobs`} still in flight`) : Effect.void)), configured = config.shutdown;
   if (configured !== void 0)
     yield* Effect.addFinalizer(() => shutdown(configured).pipe(Effect.asVoid));
   return { fingerprint: graphFingerprint(graph), activity, shutdown, turn };

package/dist/turn/turn-run.usecase.functions.js

@@ -55,7 +55,7 @@ export const schemaTokens = (tools, active) => active.reduce((sum, name) => {
   return tool === void 0 ? sum : sum + estimateTokens(`${tool.description ?? ""}${canonicalJson(toolParametersSchema(tool))}`);
 }, 0), cacheKeyOf = (prefix, conversation) => Option.map(Option.filter(Option.some(prefix), (value) => value.length > 0), (value) => `${value}:${conversation}`), stepRequestOf = Effect.fnUntraced(function* (policy, options = {}) {
   const runServices = Context.omit(CurrentToolResultReceipt)(replayableContext(yield* Effect.context())), memory = yield* TurnMemory, prompt = yield* TurnPrompt, events = yield* TurnEvents, tasks = yield* TurnTasks, tools = yield* (yield* TurnToolbox).tools, session = memory.session, run = yield* memory.startRun, inRun = (effect, step = Option.none()) => effect.pipe(Effect.provideService(CurrentAgentRun, Option.some(run)), Effect.provideService(CurrentAgentStep, step), Effect.provide(runServices)), defaultModel = Context.getOption(runServices, LanguageModel.LanguageModel), limits = { ...defaultLimits, ...options.limits, ...policy.limits };
-  yield* Schema.decodeUnknownEffect(LoopProtection)(limits).pipe(Effect.mapError((cause) => new HarnessError({ code: "turn.limits", message: "the run's limits carry a degenerate policy or malformedLimit that does not decode", cause })));
+  yield* Schema.decodeUnknownEffect(LoopProtection)(limits).pipe(Effect.mapError((cause) => new HarnessError({ code: "turn.limits", message: "the run's limits carry a degenerate policy, malformedLimit or invalidCalls that does not decode", cause })));
   const budget = policy.budgetTokens ?? options.budgetTokens ?? defaultBudgetTokens;
   if (!isBudgetTokens(budget))
     return yield* Effect.fail(failure("turn.budget", `budgetTokens must be an integer of at least 1, not ${budget}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xandreed/sdk",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "engines": {
     "node": ">=24",
     "bun": ">=1.3.0"
@@ -18,12 +18,13 @@
     }
   },
   "dependencies": {
-    "@xandreed/runtime": "^0.15.0"
+    "@xandreed/runtime": "^0.16.0"
   },
+  "gitHead": "7eb972d259e80a0c88a99d81e84e9440aed884f0",
   "private": false,
   "types": "./dist/index.d.ts",
   "peerDependencies": {
-    "@xandreed/core": "^0.15.0",
+    "@xandreed/core": "^0.16.0",
     "effect": "^4.0.7"
   },
   "files": [