@xandreed/plugin-memory-summary 0.12.0 → 0.14.0

package/README.md

@@ -1,5 +1,5 @@
 # @xandreed/plugin-memory-summary
 
-Efferent composable agent framework, 0.12.0. Node 24 or Bun.
+Efferent composable agent framework, 0.14.0. Node 24 or Bun.
 
 Documentation: https://github.com/xandreeddev/efferent

package/dist/plugin.adapter.d.ts

@@ -12,8 +12,19 @@ export declare const MemorySummaryConfig: Schema.Struct<{
     readonly replies: Schema.Boolean;
     /** Show recorded tool digests in place of the results they digest. */
     readonly digests: Schema.Boolean;
+    /**
+     * How images reach the model (a user's attachments, the images tool
+     * results return): the current turn's are sent as images first, within
+     * `maxImages` and `maxMediaChars` (with the defaults a message's own images
+     * always fit); `inline` (the default) sends earlier turns' images too,
+     * newest turn first, while they fit, `none` shows them as label lines.
+     * Text only: `maxMediaChars: 0`.
+     */
     readonly media: Schema.Literals<readonly ["none", "inline"]>;
+    /** Images one request sends as images, never more than `MEDIA_LIMITS.requestImages` (and artifact reference lines one result shows). */
     readonly maxImages: Schema.Int;
+    /** Base64 characters of the images one request sends, at most `MEDIA_LIMITS.requestChars`; 0 sends none (text only). */
+    readonly maxMediaChars: Schema.Int;
     /** Instructions for the summarizer; the transcript and any earlier summary follow. */
     readonly instructions: Schema.String;
 }>;
@@ -39,6 +50,7 @@ export declare const memorySummaryPlugin: import("@xandreed/core").TypedPlugin<{
     readonly digests: boolean;
     readonly media: "none" | "inline";
     readonly maxImages: number;
+    readonly maxMediaChars: number;
     readonly instructions: string;
 }, {
     readonly triggerRatio: number;
@@ -49,6 +61,7 @@ export declare const memorySummaryPlugin: import("@xandreed/core").TypedPlugin<{
     readonly digests: boolean;
     readonly media: "none" | "inline";
     readonly maxImages: number;
+    readonly maxMediaChars: number;
     readonly instructions: string;
 }, ConversationMemory, never, never>;
 /** Summarizing memory as a typed layer: provides ConversationMemory (and needs a UtilityLlm per turn). */
@@ -61,6 +74,7 @@ export declare const MemorySummaryLive: (options?: Partial<{
     readonly digests: boolean;
     readonly media: "none" | "inline";
     readonly maxImages: number;
+    readonly maxMediaChars: number;
     readonly instructions: string;
 }> | undefined) => Layer.Layer<ConversationMemory, HarnessError, never>;
 export default memorySummaryPlugin;

package/dist/plugin.adapter.js

@@ -5,6 +5,7 @@ import {
   digestTranscript,
   estimateMessageTokens,
   HarnessError,
+  MEDIA_LIMITS,
   openLogSession,
   UtilityLlm
 } from "@xandreed/core";
@@ -17,6 +18,7 @@ export const MemorySummaryConfig = Schema.Struct({
   digests: Schema.Boolean,
   media: Schema.Literals(["none", "inline"]),
   maxImages: Schema.Int.pipe(Schema.check(Schema.isGreaterThanOrEqualTo(0))),
+  maxMediaChars: Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 0, maximum: MEDIA_LIMITS.requestChars }))),
   instructions: Schema.String
 }), memorySummaryDefaults = {
   triggerRatio: 0.8,
@@ -25,8 +27,9 @@ export const MemorySummaryConfig = Schema.Struct({
   turnContext: "current",
   replies: !0,
   digests: !0,
-  media: "none",
-  maxImages: 8,
+  media: "inline",
+  maxImages: MEDIA_LIMITS.requestImages,
+  maxMediaChars: MEDIA_LIMITS.requestChars,
   instructions: "Summarize the earlier part of this conversation for the same assistant, which will continue from your summary plus the newest turns. Preserve, in order: the user's goals and constraints; facts and records established (with their identifiers); answers already given; open questions and pending work. Dense prose and lists; never invent anything not in the transcript."
 }, SUMMARY_STRATEGY = { id: "summary", version: "1" };
 const latestSummary = (entries) => Option.fromNullishOr(entries.flatMap((entry) => entry.body._tag === "Compaction" && entry.body.strategy === SUMMARY_STRATEGY.id && entry.body.action._tag === "Summarize" ? [{ turn: entry.turn, keepFromTurn: entry.body.action.keepFromTurn, summary: entry.body.action.summary }] : []).at(-1)), keepFrom = (entries, turn, keepTokens, render) => Array.from({ length: turn }, (_, index) => turn - index).reduce((kept, candidate) => {
@@ -35,7 +38,7 @@ const latestSummary = (entries) => Option.fromNullishOr(entries.flatMap((entry)
 }, turn);
 export const summaryPolicy = (config, summarize) => ({
   strategy: SUMMARY_STRATEGY,
-  render: { turnContext: config.turnContext, replies: config.replies, digests: config.digests, media: { mode: config.media, maxImages: config.maxImages } },
+  render: { turnContext: config.turnContext, replies: config.replies, digests: config.digests, media: { mode: config.media, maxImages: config.maxImages, maxChars: config.maxMediaChars } },
   digestOnWrite: Option.none(),
   maintain: (input) => decide(config, summarize, input).pipe(Effect.map((actions) => ({ actions, digest: [] })))
 });
@@ -60,7 +63,7 @@ ${transcript}`)).trim(), action = { _tag: "Summarize", keepFromTurn: from, summa
 }), missingUtility = new HarnessError({ code: "memory.summary", message: "The summary strategy needs a UtilityLlm in the turn's services" });
 export const memorySummaryPlugin = definePlugin({
   id: "@xandreed/plugin-memory-summary",
-  version: "0.12.0",
+  version: "0.14.0",
   scope: "runtime",
   config: MemorySummaryConfig,
   defaults: memorySummaryDefaults,

package/package.json

@@ -1,6 +1,10 @@
 {
   "name": "@xandreed/plugin-memory-summary",
-  "version": "0.12.0",
+  "version": "0.14.0",
+  "engines": {
+    "node": ">=24",
+    "bun": ">=1.3.0"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -10,8 +14,8 @@
     }
   },
   "dependencies": {
-    "@xandreed/core": "0.12.0",
-    "effect": "4.0.0-rc.118"
+    "@xandreed/core": "0.14.0",
+    "effect": "4.0.7"
   },
   "private": false,
   "types": "./dist/index.d.ts",
@@ -22,9 +26,5 @@
     "README.md",
     "LICENSE"
   ],
-  "engines": {
-    "node": ">=24",
-    "bun": ">=1.3.0"
-  },
   "license": "MIT"
 }