agl 40.6.0 → 41.0.0

package/ts/classes.flexservice.ts

@@ -73,7 +73,7 @@ import {
   readOnlyFlexRequestMethods,
   type IFlexDriverResolution,
 } from './interfaces.flexipc.js';
-import { composeDriverSystem, driverToolDefinitions } from './driver/functions.drivertools.js';
+import { driverNotesContext, driverToolDefinitions } from './driver/functions.drivertools.js';
 import { flexClaudePoolConnectionId, parseFlexAuthorityConnectionId } from '../ts_interfaces/functions.authorityscope.js';
 import { createFailureReference, describeFailure } from './functions.failuredescription.js';
 import { resolveConfiguredFlexMcpServers } from './configuration/functions.flexmcp.js';
@@ -92,6 +92,13 @@ type TFlexAuthorityAccessTarget = { scopeId: string } | { purpose: TFlexInstalla
 type TFlexDelegatedRunAdmissionProviderContext =
   plugins.flexharness.IFlexDelegatedRunAdmissionContext<IFlexProjectScope>;
 
+/**
+ * The driver's cache setting on Anthropic: one-hour breakpoints. The controller keeps the driver's cache warm for an
+ * hour after its board last changed (`fleet.driver.keepCacheWarm`), and FlexHarness times its warm turns by the TTL a
+ * call wrote, so an idle hour costs one warm turn instead of one every four minutes. Other providers keep their
+ * default: the ChatGPT backend caches in memory and takes no retention.
+ */
+const flexDriverAnthropicCache: plugins.flexharness.TFlexAgentCacheSetting = { retention: '1h' };
 const flexFailureStatusTimeoutMs = 1_000;
 
 export const flexHarnessTimeoutPolicy = Object.freeze({
@@ -359,6 +366,7 @@ const projectSerializedMethods: ReadonlySet<TFlexRequestMethod> = new Set([
   'session.reversion.info',
   'slash.list',
   'message.page',
+  'message.metadata.page',
   'message.get',
   'prompt.start',
   'prompt.continue',
@@ -403,6 +411,7 @@ const projectScopedMethods: ReadonlySet<TFlexRequestMethod> = new Set([
   'slash.list',
   'slash.execute',
   'message.page',
+  'message.metadata.page',
   'message.get',
   'prompt.start',
   'prompt.continue',
@@ -1403,6 +1412,16 @@ export class FlexService {
           }),
         };
       }
+      case 'message.metadata.page': {
+        const payload = payloadArg as IFlexRequestMap['message.metadata.page']['request'];
+        return {
+          result: await harness.listMessageMetadataPage(payload.scopeId, payload.sessionId, {
+            ...(payload.limit !== undefined ? { limit: payload.limit } : {}),
+            ...(payload.before !== undefined ? { before: payload.before } : {}),
+            ...(payload.includeUndone === undefined ? {} : { includeUndone: payload.includeUndone }),
+          }),
+        };
+      }
       case 'message.get': {
         const payload = payloadArg as IFlexRequestMap['message.get']['request'];
         return {
@@ -2340,11 +2359,18 @@ export class FlexService {
   private async resolveConfiguredRunModel(
     contextArg: Readonly<plugins.flexharness.IFlexModelResolverContext<IFlexProjectScope>>,
   ): Promise<TFlexResolvedModel> {
-    const resolved = await this.resolveModel(
+    const model = await this.resolveModel(
       contextArg.scopeId, contextArg.signal, contextArg.modelHint, contextArg, contextArg.sessionId,
     );
     const driver = await this.resolveDriver(contextArg);
-    const driverSystem = driver ? composeDriverSystem(driver.instructions, driver.notes) : undefined;
+    // The driver's system prompt holds its stable instructions only; its notes are a pinned
+    // context, so a notes update never rewrites the cached prefix.
+    const resolved: TFlexResolvedModel = driver ? {
+      ...model,
+      ...(model.identity.provider === 'anthropic' ? { cache: flexDriverAnthropicCache } : {}),
+      pinnedContext: driverNotesContext(driver.notes, driver.notesRevision),
+    } : model;
+    const driverSystem = driver?.instructions.trim();
     const key = this.configurationSessionKey(contextArg);
     const projection = this.configuredSessions.get(key);
     if (!projection) {
@@ -2363,7 +2389,8 @@ export class FlexService {
 
   /**
    * The controller says whether a root run belongs to the host's driver session, with the driver's
-   * instructions and notes. A run reads them once, so its system prompt stays stable while it runs.
+   * instructions and its notes with their scratchpad revision. A run reads them once, so its system
+   * prompt and pinned notes stay stable while it runs.
    */
   private resolveDriver(contextArg: Readonly<{
     scopeId: string;
@@ -4114,7 +4141,8 @@ export class FlexService {
         baseTextUtf8Bytes: eventArg.baseTextUtf8Bytes,
         textUtf8Bytes: eventArg.textUtf8Bytes,
       });
-      this.queueSessionChange(eventArg.scopeId, eventArg.sessionId, eventArg);
+      // Content progress travels only as the delta: the part's start and completion, and the
+      // run's lifecycle, carry the session change (updated time, preview, status).
       return;
     }
     if (