@framers/agentos 0.15.64 → 0.15.65

package/dist/cognition/substrate/GMIManager.d.ts

@@ -12,7 +12,7 @@ import { InMemoryWorkingMemory } from './memory/InMemoryWorkingMemory.js';
 import { ConversationManager } from '../../core/conversation/ConversationManager.js';
 import { ConversationContext } from '../../core/conversation/ConversationContext.js';
 import { GMIError, GMIErrorCode } from '../../core/utils/errors.js';
-import { IPromptEngine } from '../../core/llm/IPromptEngine.js';
+import type { IPromptEngine, PromptEngineConfig } from '../../core/llm/IPromptEngine.js';
 import { AIModelProviderManager } from '../../core/llm/providers/AIModelProviderManager.js';
 import { IUtilityAI } from '../nlp/ai_utilities/IUtilityAI.js';
 import { IToolOrchestrator } from '../../core/tools/IToolOrchestrator.js';
@@ -55,6 +55,12 @@ export interface GMIManagerConfig {
      * section on every turn. Without it the manager builds GMIs as it did before the layer existed.
      */
     learningLayer?: ILearningLayer;
+    /**
+     * The prompt-engine config of the GMIs `createAgencySeat` builds for the teams a GMI launches (`launch_agency` on the
+     * full runtime). Their engine gets no utility AI, so it truncates history and makes no model call. AgentOS sets it
+     * from its own `promptEngineConfig` when `agencies` is set.
+     */
+    agencySeatPromptEngineConfig?: PromptEngineConfig;
 }
 export interface GMICognitiveMemoryFactoryInput {
     gmiInstanceId: string;
@@ -78,6 +84,31 @@ export interface GMIAgencyContextOptions {
     evolutionRules?: PersonaEvolutionRule[];
     evolutionContext?: PersonaEvolutionContext;
 }
+/**
+ * One seat of a team a GMI launched on the full runtime (`launch_agency`): what {@link GMIManager.createAgencySeat}
+ * builds. The launch passes the views the seat runs through, so the manager imports nothing of the launch.
+ */
+export interface AgencySeatSpec {
+    /**
+     * `seat:<agencyId>:<role>`; refused when a GMI already serves it. Until the seat is released no request acquires
+     * a GMI in it and no feedback reaches its GMI.
+     */
+    seatSessionId: string;
+    /** The parent turn's user: the seat's tools and the tier check see it. */
+    userId: string;
+    /** A registered persona, by id (a persistent member), or the definition a launch made for a temporary seat. */
+    persona: {
+        personaId: string;
+    } | {
+        definition: IPersonaDefinition;
+    };
+    /** The seat's tool orchestrator: a view the launch makes over the shared one. */
+    toolView: (base: IToolOrchestrator) => IToolOrchestrator;
+    /** The seat's provider manager: a view the launch makes over the runtime's; the runtime's own when absent. */
+    providerManager?: (base: AIModelProviderManager) => AIModelProviderManager;
+    /** The seat's step limit; the GMI's default when absent. */
+    maxToolLoopIterations?: number;
+}
 /**
  * Manages the lifecycle of Generalized Mind Instances (GMIs).
  */
@@ -101,8 +132,8 @@ export declare class GMIManager {
     private isInitialized;
     readonly managerId: string;
     /**
-     * One promise per getOrCreateGMIForSession() call in flight, resolved when
-     * the call returns or throws. shutdown() waits for them.
+     * One promise per getOrCreateGMIForSession() or createAgencySeat() call in
+     * flight, resolved when the call returns or throws. shutdown() waits for them.
      */
     private readonly creationsInFlight;
     /**
@@ -111,6 +142,14 @@ export declare class GMIManager {
      * waits for it and never hands out a GMI that is shutting down.
      */
     private readonly deactivations;
+    /**
+     * The session of each seat createAgencySeat() registered, mapped to the seat's GMI instance id, until the seat is
+     * released. A seat's GMI serves its team alone: an acquisition that names one is refused and feedback that names one
+     * is not recorded, so a request can neither run a turn on a seat's GMI (its tools, budget and working memory are the
+     * team's) nor shut a running seat down by asking for another persona; the idle cleanup passes it by, since its launch
+     * releases it.
+     */
+    private readonly agencySeatSessions;
     constructor(config: GMIManagerConfig, subscriptionService: ISubscriptionService | undefined, authService: IAuthService | undefined, conversationManager: ConversationManager, promptEngine: IPromptEngine, llmProviderManager: AIModelProviderManager, utilityAI: IUtilityAI, toolOrchestrator: IToolOrchestrator, retrievalAugmentor?: IRetrievalAugmentor, personaLoader?: IPersonaLoader);
     private validateGMIDependencies;
     private getAgencySeatKey;
@@ -146,7 +185,8 @@ export declare class GMIManager {
     private assembleLearning;
     private assembleGMIBaseConfig;
     /**
-     * The GMI of a session: the one the session has, or a new one built for it.
+     * The GMI of a session: the one the session has, or a new one built for it. A session that a seat of a team a GMI
+     * launched holds (createAgencySeat()) is refused with `PERMISSION_DENIED` until the seat is released.
      *
      * @param turnOrganizationId - The resolved organization of the turn the GMI is acquired for (`''` for none).
      *   With a learning layer a new GMI's learner session is bound under it; a caller that cannot resolve it before
@@ -165,6 +205,43 @@ export declare class GMIManager {
     private resolveGMIForSession;
     getGMIByInstanceId(gmiInstanceId: string): IGMI | undefined;
     deactivateGMIForSession(sessionId: string): Promise<boolean>;
+    /** The seat GMIs' prompt engine: built once, with no utility AI; a build that fails is not kept. */
+    private agencySeatEngine?;
+    private agencySeatPromptEngine;
+    /** A seat's persona: the definition a launch made, or a registered one the user may use. */
+    private agencySeatPersona;
+    /**
+     * Builds and registers the GMI of one seat of a team a GMI launched (`launch_agency` on the full runtime): the
+     * registered persona a `personaId` seat names, checked as a session's persona is (strict validation, the user's
+     * tier), or the definition the launch made for a temporary seat. The GMI has no cognitive memory and no retrieval
+     * augmentor (its input is a manager's or a sibling's text), a prompt engine and a statistical utility that
+     * make no model call, the tool view and provider manager the launch gives it, and, with the runtime's learning layer,
+     * no learner (a workflow seat's source): it still renders its persona's traits, and with the layer off it sends no
+     * personality section. It is registered under the seat session id, so its own tool calls resolve it; `release()`
+     * shuts it down and takes it out of the manager, and a handle released after the manager shut down leaves alone
+     * whatever holds the session since. Until then the session is the seat's:
+     * `getOrCreateGMIForSession()` refuses it with `PERMISSION_DENIED`, whatever persona the request names (a request
+     * whose GMI was being built when the seat took the session included, that GMI shut down unregistered),
+     * `processUserFeedback()` records nothing for it and `cleanupInactiveGMIs()` passes it by. `shutdown()` waits for a
+     * seat being built, as it waits for a session's GMI, and the build then fails with its GMI shut down.
+     *
+     * @throws {GMIManagerError} `PERSONA_NOT_FOUND` for an unknown persona; `PERMISSION_DENIED` for one the user's tier or
+     *   strict validation refuses; `INVALID_STATE` for a session that already has a GMI; `CONFIGURATION_ERROR` without
+     *   `agencySeatPromptEngineConfig`; `NOT_INITIALIZED` when the manager is not, or shuts down while the seat is built.
+     * @throws {GMIError} `GMI_INITIALIZATION_ERROR` when the GMI does not initialize.
+     */
+    createAgencySeat(spec: AgencySeatSpec): Promise<{
+        gmi: IGMI;
+        personaId: string;
+        release(): Promise<void>;
+    }>;
+    /** The work of {@link GMIManager.createAgencySeat}. */
+    private buildAgencySeat;
+    /**
+     * Releases one seat's GMI and then its hold on the session. Only the seat's own GMI and hold go: once the manager has
+     * shut down, the session may hold a GMI or a seat that came after it, which stays.
+     */
+    private releaseAgencySeat;
     /**
      * Shuts down the GMI bound to a session and removes it from both maps. It
      * skips the initialization check because `shutdown()` marks the manager
@@ -190,16 +267,18 @@ export declare class GMIManager {
      */
     private shutDownGMI;
     /**
-     * Waits, at most `shutdownTimeoutMs`, for the getOrCreateGMIForSession()
-     * calls in flight to settle. A call still running after that shuts down the
-     * GMI it builds once it gets that far.
+     * Waits, at most `shutdownTimeoutMs`, for the getOrCreateGMIForSession() and
+     * createAgencySeat() calls in flight to settle. A call still running after
+     * that shuts down the GMI it builds once it gets that far.
      */
     private creationsSettled;
     cleanupInactiveGMIs(inactivityThresholdMinutes?: number): Promise<number>;
     shutdown(): Promise<void>;
     /**
-     * Routes user feedback to the GMI that serves the session. The payload is
-     * normalized first (see {@link normalizeUserFeedback}): a `rating` label
+     * Routes user feedback to the GMI that serves the session; feedback that
+     * names the session of a seat of a launched team (createAgencySeat()) is not
+     * recorded. The payload is normalized first (see
+     * {@link normalizeUserFeedback}): a `rating` label
      * decides the polarity, otherwise a numeric rating is read on the 1 to 5
      * scale. The GMI then records a trace entry and, when cognitive memory is
      * configured, stores the feedback and any correction as memories of the user.

package/dist/cognition/substrate/GMIManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GMIManager.d.ts","sourceRoot":"","sources":["../../../src/cognition/substrate/GMIManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GMIManager.d.ts","sourceRoot":"","sources":["../../../src/cognition/substrate/GMIManager.ts"],"names":[],"mappings":"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"}

package/dist/cognition/substrate/GMIManager.js

@@ -10,11 +10,14 @@ import { validatePersonas, formatAggregateReport, applyStrictMode } from './pers
 import { PersonaLoader } from './personas/PersonaLoader.js';
 import { InMemoryWorkingMemory } from './memory/InMemoryWorkingMemory.js';
 import { GMIError, GMIErrorCode, createGMIErrorFromError } from '../../core/utils/errors.js';
+import { PromptEngine } from '../../core/llm/PromptEngine.js';
+import { StatisticalUtilityAI } from '../nlp/ai_utilities/StatisticalUtilityAI.js';
 import { PersonaOverlayManager } from './persona_overlays/PersonaOverlayManager.js';
 import { resolveSecretForProvider } from '../../core/config/extensionSecrets.js';
 import { feedbackTraceMessage, normalizeUserFeedback } from './userFeedback.js';
 import { settlesWithin, shutdownTimeoutOrDefault } from './shutdownBound.js';
 import { normalizeHexacoTraits } from './personas/hexaco.js';
+import { normalizePersonaDefinition } from './personas/personaNormalization.js';
 import { traitOverlayPatch } from './personas/personalityPrompt.js';
 import { deferLearnerSession } from '../learning/LearnerSession.js';
 /**
@@ -70,8 +73,8 @@ export class GMIManager {
     constructor(config, subscriptionService, authService, conversationManager, promptEngine, llmProviderManager, utilityAI, toolOrchestrator, retrievalAugmentor, personaLoader) {
         this.isInitialized = false;
         /**
-         * One promise per getOrCreateGMIForSession() call in flight, resolved when
-         * the call returns or throws. shutdown() waits for them.
+         * One promise per getOrCreateGMIForSession() or createAgencySeat() call in
+         * flight, resolved when the call returns or throws. shutdown() waits for them.
          */
         this.creationsInFlight = new Set();
         /**
@@ -80,6 +83,14 @@ export class GMIManager {
          * waits for it and never hands out a GMI that is shutting down.
          */
         this.deactivations = new Map();
+        /**
+         * The session of each seat createAgencySeat() registered, mapped to the seat's GMI instance id, until the seat is
+         * released. A seat's GMI serves its team alone: an acquisition that names one is refused and feedback that names one
+         * is not recorded, so a request can neither run a turn on a seat's GMI (its tools, budget and working memory are the
+         * team's) nor shut a running seat down by asking for another persona; the idle cleanup passes it by, since its launch
+         * releases it.
+         */
+        this.agencySeatSessions = new Map();
         this.managerId = `gmi-manager-${uuidv4()}`;
         if (!config || !config.personaLoaderConfig) {
             throw new GMIManagerError('Invalid GMIManager configuration: personaLoaderConfig is required.', GMIErrorCode.CONFIGURATION_ERROR, { providedConfig: config });
@@ -93,6 +104,7 @@ export class GMIManager {
             cognitiveMemoryFactory: config.cognitiveMemoryFactory,
             shutdownTimeoutMs: shutdownTimeoutOrDefault(config.shutdownTimeoutMs),
             learningLayer: config.learningLayer,
+            agencySeatPromptEngineConfig: config.agencySeatPromptEngineConfig,
         };
         this.subscriptionService = subscriptionService;
         this.authService = authService;
@@ -495,7 +507,8 @@ export class GMIManager {
         };
     }
     /**
-     * The GMI of a session: the one the session has, or a new one built for it.
+     * The GMI of a session: the one the session has, or a new one built for it. A session that a seat of a team a GMI
+     * launched holds (createAgencySeat()) is refused with `PERMISSION_DENIED` until the seat is released.
      *
      * @param turnOrganizationId - The resolved organization of the turn the GMI is acquired for (`''` for none).
      *   With a learning layer a new GMI's learner session is bound under it; a caller that cannot resolve it before
@@ -525,6 +538,12 @@ export class GMIManager {
      * down first.
      */
     async resolveGMIForSession(userId, sessionId, requestedPersonaId, conversationIdInput, preferredModelId, preferredProviderId, userApiKeys, agencyOptions, turnOrganizationId) {
+        // A seat's session serves its team alone, whatever persona the request names: reusing its GMI would run the
+        // request on the team's tools, budget and working memory, and a persona refresh would shut the seat down mid-run.
+        // It is checked first, and again after each wait in which a seat could take the session.
+        const seatSessionRefused = () => new GMIManagerError(`Session '${sessionId}' is a seat of a team a GMI launched; no request runs in it.`, GMIErrorCode.PERMISSION_DENIED, { sessionId });
+        if (this.agencySeatSessions.has(sessionId))
+            throw seatSessionRefused();
         const personaDefinition = this.getPersonaDefinition(requestedPersonaId);
         if (!personaDefinition) {
             throw new GMIManagerError(`Persona '${requestedPersonaId}' not found.`, GMIErrorCode.PERSONA_NOT_FOUND, { requestedPersonaId });
@@ -549,6 +568,8 @@ export class GMIManager {
             this.ensureInitialized();
             deactivation = this.deactivations.get(sessionId);
         }
+        if (this.agencySeatSessions.has(sessionId))
+            throw seatSessionRefused();
         let gmiInstanceId = this.gmiSessionMap.get(sessionId);
         let gmi = gmiInstanceId ? this.activeGMIs.get(gmiInstanceId) : undefined;
         if (gmi && (gmi.getPersona().id !== requestedPersonaId || overlayChanged)) {
@@ -592,6 +613,11 @@ export class GMIManager {
                 await this.shutDownGMI(newGMI, newGmiInstanceId, sessionId);
                 throw new GMIManagerError(`GMIManager (ID: ${this.managerId}) shut down while GMI ${newGmiInstanceId} was being created for session ${sessionId}.`, GMIErrorCode.NOT_INITIALIZED, { sessionId, gmiInstanceId: newGmiInstanceId });
             }
+            if (this.agencySeatSessions.has(sessionId)) {
+                // A seat took the session while this GMI was built: it is shut down and never registered.
+                await this.shutDownGMI(newGMI, newGmiInstanceId, sessionId);
+                throw seatSessionRefused();
+            }
             gmi = newGMI;
             this.activeGMIs.set(newGmiInstanceId, gmi);
             this.gmiSessionMap.set(sessionId, newGmiInstanceId);
@@ -629,6 +655,161 @@ export class GMIManager {
         this.ensureInitialized();
         return this.deactivateSession(sessionId);
     }
+    agencySeatPromptEngine() {
+        const config = this.config.agencySeatPromptEngineConfig;
+        if (!config) {
+            return Promise.reject(new GMIManagerError('GMIManagerConfig.agencySeatPromptEngineConfig is not set; AgentOS sets it with agencies.', GMIErrorCode.CONFIGURATION_ERROR));
+        }
+        this.agencySeatEngine ?? (this.agencySeatEngine = (async () => {
+            const engine = new PromptEngine();
+            // No utility AI: the engine truncates the history and summarizes nothing, so it makes no model call.
+            await engine.initialize(config);
+            return engine;
+        })().catch((error) => {
+            this.agencySeatEngine = undefined;
+            throw error;
+        }));
+        return this.agencySeatEngine;
+    }
+    /** A seat's persona: the definition a launch made, or a registered one the user may use. */
+    async agencySeatPersona(spec) {
+        if ('definition' in spec.persona)
+            return normalizePersonaDefinition(spec.persona.definition);
+        const personaId = spec.persona.personaId;
+        const persona = this.getPersonaDefinition(personaId);
+        if (!persona) {
+            throw new GMIManagerError(`Persona '${personaId}' not found.`, GMIErrorCode.PERSONA_NOT_FOUND, { personaId });
+        }
+        const record = this.allPersonaRecords.get(personaId);
+        const strict = this.config.personaValidationStrict;
+        if (strict?.enabled && !strict.shadowMode && record?.status === 'invalid') {
+            throw new GMIManagerError(`Persona '${personaId}' is invalid and blocked by strict validation.`, GMIErrorCode.PERMISSION_DENIED, { personaId });
+        }
+        if (!(await this.userMeetsPersonaTier(spec.userId, persona))) {
+            throw new GMIManagerError(`Access denied: Persona '${personaId}' requires tier '${persona.minSubscriptionTier}'.`, GMIErrorCode.PERMISSION_DENIED, { personaId, userId: spec.userId });
+        }
+        return persona;
+    }
+    /**
+     * Builds and registers the GMI of one seat of a team a GMI launched (`launch_agency` on the full runtime): the
+     * registered persona a `personaId` seat names, checked as a session's persona is (strict validation, the user's
+     * tier), or the definition the launch made for a temporary seat. The GMI has no cognitive memory and no retrieval
+     * augmentor (its input is a manager's or a sibling's text), a prompt engine and a statistical utility that
+     * make no model call, the tool view and provider manager the launch gives it, and, with the runtime's learning layer,
+     * no learner (a workflow seat's source): it still renders its persona's traits, and with the layer off it sends no
+     * personality section. It is registered under the seat session id, so its own tool calls resolve it; `release()`
+     * shuts it down and takes it out of the manager, and a handle released after the manager shut down leaves alone
+     * whatever holds the session since. Until then the session is the seat's:
+     * `getOrCreateGMIForSession()` refuses it with `PERMISSION_DENIED`, whatever persona the request names (a request
+     * whose GMI was being built when the seat took the session included, that GMI shut down unregistered),
+     * `processUserFeedback()` records nothing for it and `cleanupInactiveGMIs()` passes it by. `shutdown()` waits for a
+     * seat being built, as it waits for a session's GMI, and the build then fails with its GMI shut down.
+     *
+     * @throws {GMIManagerError} `PERSONA_NOT_FOUND` for an unknown persona; `PERMISSION_DENIED` for one the user's tier or
+     *   strict validation refuses; `INVALID_STATE` for a session that already has a GMI; `CONFIGURATION_ERROR` without
+     *   `agencySeatPromptEngineConfig`; `NOT_INITIALIZED` when the manager is not, or shuts down while the seat is built.
+     * @throws {GMIError} `GMI_INITIALIZATION_ERROR` when the GMI does not initialize.
+     */
+    async createAgencySeat(spec) {
+        this.ensureInitialized();
+        // shutdown() waits for this build to settle, as it waits for a session's; a GMI the build makes once shutdown has
+        // begun is shut down instead of registered.
+        let settle;
+        const inFlight = new Promise((resolve) => {
+            settle = resolve;
+        });
+        this.creationsInFlight.add(inFlight);
+        try {
+            return await this.buildAgencySeat(spec);
+        }
+        finally {
+            this.creationsInFlight.delete(inFlight);
+            settle();
+        }
+    }
+    /** The work of {@link GMIManager.createAgencySeat}. */
+    async buildAgencySeat(spec) {
+        const taken = () => new GMIManagerError(`Session '${spec.seatSessionId}' already has a GMI; a seat runs in a session of its own.`, GMIErrorCode.INVALID_STATE, { sessionId: spec.seatSessionId });
+        if (this.gmiSessionMap.has(spec.seatSessionId))
+            throw taken();
+        const persona = await this.agencySeatPersona(spec);
+        const promptEngine = await this.agencySeatPromptEngine();
+        const gmiInstanceId = `gmi-instance-${uuidv4()}`;
+        const utilityAI = new StatisticalUtilityAI(`agency-seat-utility-${gmiInstanceId}`);
+        await utilityAI.initialize({ utilityId: `agency-seat-utility-${gmiInstanceId}` });
+        const config = {
+            workingMemory: new InMemoryWorkingMemory(),
+            promptEngine,
+            llmProviderManager: spec.providerManager ? spec.providerManager(this.llmProviderManager) : this.llmProviderManager,
+            utilityAI,
+            toolOrchestrator: spec.toolView(this.toolOrchestrator),
+            defaultLlmProviderId: persona.defaultProviderId || this.config.defaultGMIBaseConfigDefaults?.defaultLlmProviderId,
+            defaultLlmModelId: persona.defaultModelId || this.config.defaultGMIBaseConfigDefaults?.defaultLlmModelId,
+            defaultReasoningTraceMaxEntries: this.config.defaultGMIBaseConfigDefaults?.defaultReasoningTraceMaxEntries,
+            defaultReasoningTraceMaxMessageLength: this.config.defaultGMIBaseConfigDefaults?.defaultReasoningTraceMaxMessageLength,
+            customSettings: persona.customFields,
+            // A GMI waits as long for the turns its shutdown stops as the manager waits for the GMI.
+            shutdownTimeoutMs: this.config.shutdownTimeoutMs,
+            ...(spec.maxToolLoopIterations !== undefined ? { maxToolLoopIterations: spec.maxToolLoopIterations } : {}),
+            // A workflow seat's source: with a learning layer, the seat's turns have no learner.
+            ...(await this.assembleLearning(persona, { gmiInstanceId, sessionId: spec.seatSessionId, userId: spec.userId }, { registryPersona: persona, workflowSeat: true })),
+        };
+        const gmi = new GMI(gmiInstanceId);
+        try {
+            await gmi.initialize(persona, config);
+        }
+        catch (error) {
+            // The GMI never runs, so the learner session made for it ends here; a failure to end it is not the error.
+            await Promise.resolve()
+                .then(() => config.learning?.endSession())
+                .catch(() => undefined);
+            throw createGMIErrorFromError(error, GMIErrorCode.GMI_INITIALIZATION_ERROR, { gmiInstanceId }, `Failed to initialize the agency seat GMI ${gmiInstanceId}.`);
+        }
+        if (!this.isInitialized) {
+            // shutdown() began while the seat was built: it is shut down here and never registered.
+            await this.shutDownGMI(gmi, gmiInstanceId, spec.seatSessionId);
+            throw new GMIManagerError(`GMIManager (ID: ${this.managerId}) shut down while the agency seat ${spec.seatSessionId} was being created.`, GMIErrorCode.NOT_INITIALIZED, { sessionId: spec.seatSessionId });
+        }
+        if (this.gmiSessionMap.has(spec.seatSessionId)) {
+            // Another build took the session while this one ran: this GMI is shut down and never registered.
+            await this.shutDownGMI(gmi, gmiInstanceId, spec.seatSessionId);
+            throw taken();
+        }
+        this.activeGMIs.set(gmiInstanceId, gmi);
+        this.gmiSessionMap.set(spec.seatSessionId, gmiInstanceId);
+        this.agencySeatSessions.set(spec.seatSessionId, gmiInstanceId);
+        let released;
+        return {
+            gmi,
+            personaId: persona.id,
+            // Once: a second call waits for the first. It skips the initialization check, so a seat closed while the manager
+            // shuts down is still released. The session is the seat's until its GMI is gone.
+            release: () => (released ?? (released = this.releaseAgencySeat(spec.seatSessionId, gmiInstanceId, gmi))),
+        };
+    }
+    /**
+     * Releases one seat's GMI and then its hold on the session. Only the seat's own GMI and hold go: once the manager has
+     * shut down, the session may hold a GMI or a seat that came after it, which stays.
+     */
+    async releaseAgencySeat(sessionId, gmiInstanceId, gmi) {
+        try {
+            if (this.gmiSessionMap.get(sessionId) === gmiInstanceId) {
+                await this.deactivateSession(sessionId);
+            }
+            else if (this.activeGMIs.get(gmiInstanceId) === gmi) {
+                try {
+                    await this.shutDownGMI(gmi, gmiInstanceId, sessionId);
+                }
+                finally {
+                    this.activeGMIs.delete(gmiInstanceId);
+                }
+            }
+        }
+        finally {
+            if (this.agencySeatSessions.get(sessionId) === gmiInstanceId)
+                this.agencySeatSessions.delete(sessionId);
+        }
+    }
     /**
      * Shuts down the GMI bound to a session and removes it from both maps. It
      * skips the initialization check because `shutdown()` marks the manager
@@ -713,9 +894,9 @@ export class GMIManager {
         }
     }
     /**
-     * Waits, at most `shutdownTimeoutMs`, for the getOrCreateGMIForSession()
-     * calls in flight to settle. A call still running after that shuts down the
-     * GMI it builds once it gets that far.
+     * Waits, at most `shutdownTimeoutMs`, for the getOrCreateGMIForSession() and
+     * createAgencySeat() calls in flight to settle. A call still running after
+     * that shuts down the GMI it builds once it gets that far.
      */
     async creationsSettled() {
         if (this.creationsInFlight.size === 0)
@@ -734,6 +915,9 @@ export class GMIManager {
         const thresholdMs = threshold * 60 * 1000;
         const sessionIdsSnapshot = Array.from(this.gmiSessionMap.keys());
         for (const sessionId of sessionIdsSnapshot) {
+            // A seat's GMI lives as long as its launch, which releases it; its turns leave no conversation context here.
+            if (this.agencySeatSessions.has(sessionId))
+                continue;
             const gmiInstanceId = this.gmiSessionMap.get(sessionId);
             if (!gmiInstanceId)
                 continue;
@@ -779,9 +963,9 @@ export class GMIManager {
         this.isInitialized = false;
         // Every GMI shuts down at the same time, each within shutdownTimeoutMs, so
         // the manager takes about one bound however many GMIs are active. In the
-        // same bound it waits for the getOrCreateGMIForSession() calls in flight:
-        // one that began before the flag was cleared and has not registered its
-        // GMI shuts that GMI down itself.
+        // same bound it waits for the getOrCreateGMIForSession() and
+        // createAgencySeat() calls in flight: one that began before the flag was
+        // cleared and has not registered its GMI shuts that GMI down itself.
         const sessionIdsToDeactivate = Array.from(this.gmiSessionMap.keys());
         // A GMI in the active map that no session maps to is shut down in the same
         // pass. Two creations for one new session that race both build a GMI, and
@@ -797,12 +981,15 @@ export class GMIManager {
         ]);
         this.activeGMIs.clear();
         this.gmiSessionMap.clear();
+        this.agencySeatSessions.clear();
         this.allPersonaDefinitions.clear();
         console.log(`GMIManager (ID: ${this.managerId}): Shutdown complete.`);
     }
     /**
-     * Routes user feedback to the GMI that serves the session. The payload is
-     * normalized first (see {@link normalizeUserFeedback}): a `rating` label
+     * Routes user feedback to the GMI that serves the session; feedback that
+     * names the session of a seat of a launched team (createAgencySeat()) is not
+     * recorded. The payload is normalized first (see
+     * {@link normalizeUserFeedback}): a `rating` label
      * decides the polarity, otherwise a numeric rating is read on the 1 to 5
      * scale. The GMI then records a trace entry and, when cognitive memory is
      * configured, stores the feedback and any correction as memories of the user.
@@ -818,6 +1005,10 @@ export class GMIManager {
             fields: feedbackData && typeof feedbackData === 'object' ? Object.keys(feedbackData) : [],
             textLength: typeof feedbackData?.text === 'string' ? feedbackData.text.length : 0,
         });
+        // A seat's GMI serves its team alone: feedback that names its session reaches neither the GMI nor its trace, which
+        // the GMI's self-reflection reads.
+        if (this.agencySeatSessions.has(sessionId))
+            return;
         const gmiInstanceId = this.gmiSessionMap.get(sessionId);
         const gmi = gmiInstanceId ? this.activeGMIs.get(gmiInstanceId) : undefined;
         if (!gmi || !feedbackData || typeof feedbackData !== 'object') {