aec-agent 1.0.1 → 1.0.4

package/dist/components/multi-agent-orchestration/agent/command-manager/types.js

@@ -0,0 +1,3 @@
+// A-136: slash commands — the typed contract of a command, its context and its result.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/multi-agent-orchestration/agent/command-manager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/command-manager/types.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/dist/components/multi-agent-orchestration/agent/context-manager/context-manager.d.ts

@@ -1,5 +1,5 @@
 import type { AgentProfile } from "../types.js";
-import type { Message, ModelResponse } from "../../../../kernel/types.js";
+import type { Message, ModelResponse, Session } from "../../../../kernel/types.js";
 import type { Middleware, MiddlewareContext } from "./types.js";
 export interface ContextManagerOptions {
     /**
@@ -7,16 +7,52 @@ export interface ContextManagerOptions {
      * skills enabled or created mid-conversation show up on the next model call. Null = none.
      */
     skillIndex?: () => Promise<string | null>;
+    /**
+     * A-105: the agents this one may delegate to (<available_subagents>), resolved on every
+     * prepareMessages() for the turn's session — a child run's session gets none. Null = none.
+     */
+    subagentIndex?: (session: Session) => Promise<string | null>;
+    /**
+     * A-101: the agent's secrets (<available_secrets>: names, what they are for, where they
+     * may be used — never values), resolved on every prepareMessages(). Null = none.
+     */
+    secretIndex?: () => Promise<string | null>;
+}
+/** A-104: a labelled part of the always-loaded system message. */
+export type ContextSectionKey = "system_prompt" | "memory_files" | "skills" | "agents" | "secrets";
+export interface ContextSection {
+    key: ContextSectionKey;
+    text: string;
 }
 export declare class ContextManager {
     private middlewares;
     private alwaysLoadedContext;
+    private profileSections;
     private skillIndex?;
+    private subagentIndex?;
+    private secretIndex?;
     constructor(profile: AgentProfile, options?: ContextManagerOptions);
+    /**
+     * Rebuild the always-loaded system message from the profile — call after its
+     * system prompt or initial context files (e.g. a compacted USER.md / MEMORY.md)
+     * changed, so the next model call sees them.
+     */
+    refreshProfile(profile: AgentProfile): void;
     addMiddleware(middleware: Middleware): void;
     prepareMessages(messages: Message[], context: MiddlewareContext): Promise<Message[]>;
+    /**
+     * A-104: prepareMessages() plus the labelled sections the system message was built
+     * from (the agent loop measures them for the context breakdown). The messages are
+     * the same as prepareMessages() returns.
+     */
+    prepare(messages: Message[], context: MiddlewareContext): Promise<{
+        messages: Message[];
+        sections: ContextSection[];
+    }>;
     processResponse(response: ModelResponse, context: MiddlewareContext): Promise<ModelResponse>;
     private withSkillIndex;
+    private withIndex;
+    private buildProfileSections;
     private buildAlwaysLoaded;
 }
 //# sourceMappingURL=context-manager.d.ts.map

package/dist/components/multi-agent-orchestration/agent/context-manager/context-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/context-manager/context-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,UAAU,CAAC,CAAsC;IAEzD,YAAY,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,qBAA0B,EAGrE;IAED,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAG1C;IAEK,eAAe,CACnB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CAQpB;IAEK,eAAe,CACnB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAQxB;YAGa,cAAc;IAQ5B,OAAO,CAAC,iBAAiB;CAY1B"}
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/context-manager/context-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,iBAAiB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,UAAU,CAAC,CAAsC;IACzD,OAAO,CAAC,aAAa,CAAC,CAAyC;IAC/D,OAAO,CAAC,WAAW,CAAC,CAAuC;IAE3D,YAAY,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,qBAA0B,EAMrE;IAED;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAG1C;IAED,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAG1C;IAEK,eAAe,CACnB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CAEpB;IAED;;;;OAIG;IACG,OAAO,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAkB9D;IAEK,eAAe,CACnB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAQxB;YAKa,cAAc;IAM5B,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/components/multi-agent-orchestration/agent/context-manager/context-manager.js

@@ -1,23 +1,59 @@
 export class ContextManager {
     middlewares = [];
     alwaysLoadedContext = [];
+    profileSections = [];
     skillIndex;
+    subagentIndex;
+    secretIndex;
     constructor(profile, options = {}) {
         this.alwaysLoadedContext = this.buildAlwaysLoaded(profile);
+        this.profileSections = this.buildProfileSections(profile);
         this.skillIndex = options.skillIndex;
+        this.subagentIndex = options.subagentIndex;
+        this.secretIndex = options.secretIndex;
+    }
+    /**
+     * Rebuild the always-loaded system message from the profile — call after its
+     * system prompt or initial context files (e.g. a compacted USER.md / MEMORY.md)
+     * changed, so the next model call sees them.
+     */
+    refreshProfile(profile) {
+        this.alwaysLoadedContext = this.buildAlwaysLoaded(profile);
+        this.profileSections = this.buildProfileSections(profile);
     }
     addMiddleware(middleware) {
         this.middlewares.push(middleware);
         this.middlewares.sort((a, b) => a.priority - b.priority);
     }
     async prepareMessages(messages, context) {
-        let prepared = [...(await this.withSkillIndex(this.alwaysLoadedContext)), ...messages];
+        return (await this.prepare(messages, context)).messages;
+    }
+    /**
+     * A-104: prepareMessages() plus the labelled sections the system message was built
+     * from (the agent loop measures them for the context breakdown). The messages are
+     * the same as prepareMessages() returns.
+     */
+    async prepare(messages, context) {
+        const { messages: withSkills, index: skills } = await this.withSkillIndex(this.alwaysLoadedContext);
+        const agents = (await this.subagentIndex?.(context.session)) ?? null;
+        const secrets = (await this.secretIndex?.()) ?? null;
+        let prepared = [
+            ...this.withIndex(this.withIndex(withSkills, agents), secrets),
+            ...messages,
+        ];
         for (const mw of this.middlewares) {
             if (mw.beforeModel) {
                 prepared = await mw.beforeModel(prepared, context);
             }
         }
-        return prepared;
+        const sections = [...this.profileSections];
+        if (skills)
+            sections.push({ key: "skills", text: skills });
+        if (agents)
+            sections.push({ key: "agents", text: agents });
+        if (secrets)
+            sections.push({ key: "secrets", text: secrets });
+        return { messages: prepared, sections };
     }
     async processResponse(response, context) {
         let processed = response;
@@ -29,8 +65,14 @@ export class ContextManager {
         return processed;
     }
     // The skill index goes at the end of the always-loaded system message.
+    // Update (A-104): also returns the index it added (null for none), so prepare() can
+    // report it as a section.
     async withSkillIndex(alwaysLoaded) {
         const index = this.skillIndex ? await this.skillIndex() : null;
+        return { messages: this.withIndex(alwaysLoaded, index), index };
+    }
+    // An index (skills, A-105 subagents, A-101 secrets) goes at the end of the always-loaded system message.
+    withIndex(alwaysLoaded, index) {
         if (!index)
             return alwaysLoaded;
         const [system, ...rest] = alwaysLoaded;
@@ -38,6 +80,16 @@ export class ContextManager {
             return [{ role: "system", content: index }];
         return [{ ...system, content: system.content ? `${system.content}\n\n${index}` : index }, ...rest];
     }
+    // A-104: the profile's parts of the always-loaded system message, labelled.
+    buildProfileSections(profile) {
+        const sections = [{ key: "system_prompt", text: profile.systemPrompt }];
+        const files = [profile.initialContext?.userMd, profile.initialContext?.memoryMd, profile.initialContext?.soulMd]
+            .filter((f) => !!f)
+            .join("\n\n");
+        if (files)
+            sections.push({ key: "memory_files", text: files });
+        return sections;
+    }
     buildAlwaysLoaded(profile) {
         const parts = [profile.systemPrompt];
         if (profile.initialContext?.userMd)

package/dist/components/multi-agent-orchestration/agent/context-manager/context-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/context-manager/context-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/context-manager/context-manager.ts"],"names":[],"mappings":"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"}

package/dist/components/multi-agent-orchestration/agent/conversation-manager/conversation-manager.d.ts

@@ -1,25 +1,129 @@
-import type { Message, Session, SessionFilter } from "../../../../kernel/types.js";
+import type { ApprovalMode, Message, Session, SessionFilter } from "../../../../kernel/types.js";
+import type { EventBus } from "../../../event-handler/types.js";
 import type { PersistenceHub } from "../../../persistence-hub/persistence-hub.js";
+import type { RunResult } from "../agent-loop/types.js";
+import { Conversation } from "./conversation.js";
+import type { TurnHandle } from "./turn-gate.js";
+/**
+ * An agent's sessions (A-97).
+ *
+ * Every turn runs in a session named by id and works on its own Conversation,
+ * loaded from the stores when the turn starts — so turns in different sessions
+ * share no in-memory state and can run in parallel (the TurnGate keeps
+ * turns of the same session in order).
+ *
+ * The "default session" set by startSession()/loadSession() is only the
+ * session a chat()/chatStream() call uses when it names none (the API before
+ * A-97). It no longer holds any history in memory.
+ */
 export declare class ConversationManager {
     private persistence;
-    private currentSession;
-    private _messages;
-    private _compactedMessages;
-    constructor(persistence: PersistenceHub);
+    /** A-135: where SessionApprovalModeChanged is emitted (absent = no event). */
+    private events?;
+    /** Session used by turns that name none — set by startSession()/loadSession(). */
+    private defaultSessionId;
+    /**
+     * A-97: when turns may run — sessions in parallel, one turn at a time per session,
+     * capped by `getMaxConcurrentTurns` (read on every turn, so updateLoopConfig applies).
+     */
+    private turnGate;
+    /**
+     * A-135: the Conversation of each session a turn is running in (at most one per session,
+     * the TurnGate sees to that). setApprovalMode() changes its Session too, so the turn's
+     * own session writes never put the old mode back.
+     */
+    private openTurns;
+    /**
+     * A-136: sessions whose running turn is read-only (RunOptions.readOnly, e.g. /review):
+     * that turn runs in plan mode whatever the session's own approval mode.
+     */
+    private readOnlyTurns;
+    constructor(persistence: PersistenceHub, getMaxConcurrentTurns?: () => number, 
+    /** A-135: where SessionApprovalModeChanged is emitted (absent = no event). */
+    events?: {
+        eventBus: EventBus;
+        agentId: string;
+    } | undefined);
     startSession(metadata?: Record<string, unknown>, llmModel?: string): Promise<Session>;
-    loadSession(sessionId: string): Promise<Session | null>;
-    addMessage(message: Message): Promise<void>;
     /**
-     * Replace the LLM working set after compaction.
-     * Only the agent loop should call this — the UI always reads `messages`.
+     * Make an existing session the default for turns that name none. Returns the
+     * session as stored, or null (and clears the default) when it does not exist.
      */
-    setCompactedMessages(compacted: Message[]): Promise<void>;
+    loadSession(sessionId: string): Promise<Session | null>;
+    /** The session turns that name none run in, or null before startSession()/loadSession(). */
+    getDefaultSessionId(): string | null;
     /**
-     * Returns the LLM working set (compacted if available, full otherwise).
+     * Load a session's conversation for one turn. Call it once the turn holds the
+     * session's slot, so no other turn of that session is writing.
+     * Null when the session does not exist.
      */
-    getLlmMessages(): Message[];
-    getMessages(): Message[];
-    getSession(): Session | null;
+    open(sessionId: string): Promise<Conversation | null>;
+    /** A-136: a session — the running turn's copy when there is one (it is the newest), else as stored; null when none. */
+    getSession(sessionId: string): Promise<Session | null>;
+    /** A session's full history, read from the message store. */
+    getMessages(sessionId: string): Promise<Message[]>;
     listSessions(filter?: SessionFilter): Promise<Session[]>;
+    /**
+     * Start a turn (A-97): resolve its session, wait for that session's slot (and one
+     * under the agent cap), then load the session's conversation.
+     * Resolves null when `signal` aborted while waiting — nothing ran or was saved.
+     * The caller must release() the returned turn when it ends.
+     */
+    beginTurn(sessionId?: string, signal?: AbortSignal, 
+    /** A-136: readOnly = the turn runs in plan mode (only read-only tool calls). */
+    options?: {
+        readOnly?: boolean;
+    }): Promise<ConversationTurn | null>;
+    /** A-136: is a turn running in the session now? */
+    isBusy(sessionId: string): boolean;
+    /**
+     * A-135: a session's approval mode — from the running turn's session when there is one
+     * (it holds the latest value), else from the store. "ask" when unset, for an unknown
+     * session, and always for a job's session (nobody is there to have chosen YOLO).
+     */
+    approvalMode(sessionId: string): Promise<ApprovalMode>;
+    /**
+     * A-135: set a session's approval mode. It does not wait for a running turn of the
+     * session: that turn's next call that needs approval already uses the new mode.
+     * Returns the session as saved, or null when it does not exist. Throws
+     * SessionError "not_allowed" for YOLO in a job's session.
+     */
+    setApprovalMode(sessionId: string, mode: ApprovalMode): Promise<Session | null>;
+    /**
+     * A-136: change a session's settings outside a turn (/rename, /model). Like setApprovalMode
+     * it does not wait for a running turn: it changes that turn's copy of the session (so the
+     * turn's own writes keep the change) and saves it. `fields` names what changed, for the
+     * SessionUpdated event. Returns the session as saved, or null when it does not exist.
+     */
+    updateSession(sessionId: string, fields: string[], change: (session: Session) => void): Promise<Session | null>;
+    /**
+     * A-136: start a fresh session next to `fromSessionId` (/clear): same metadata (so a host
+     * or chat app finds it where it found the old one) without the title, and the same model
+     * and context window. The old session stays as it was, resumable. It becomes the default
+     * session when the old one was. Null when `fromSessionId` does not exist.
+     */
+    startSessionFrom(fromSessionId: string): Promise<Session | null>;
+    /** A-136: emit SessionUpdated for a change made outside a turn (absent bus = nothing). */
+    emitUpdated(sessionId: string, fields: string[]): void;
+    /**
+     * Add a message to a session outside a model turn (A-100 phase 3: a scheduled job's
+     * result posted in a chat joins that chat's conversation, so a reply there has it).
+     * It waits for the session like a turn does, so it lands between turns, never inside one.
+     */
+    appendMessage(sessionId: string, message: Message): Promise<void>;
+    /** A-97: how many turns are running now, across all sessions. */
+    get runningTurns(): number;
+    /** A-97: aborts every running turn (in any session), waits for them, and refuses new ones. */
+    dispose(): Promise<void>;
+    /** The session a turn runs in: the one named, else the startSession/loadSession default. */
+    private resolveSessionId;
+    private openConversation;
+}
+/** A turn that holds its session (from ConversationManager.beginTurn): the gate's handle plus the session's conversation. */
+export interface ConversationTurn extends TurnHandle {
+    /** The session's conversation, loaded for this turn. */
+    conversation: Conversation;
 }
+/** A-97: the result of a turn whose signal aborted while it waited for its session — nothing ran or was saved. */
+export declare function abortedBeforeStart(): RunResult;
 //# sourceMappingURL=conversation-manager.d.ts.map

package/dist/components/multi-agent-orchestration/agent/conversation-manager/conversation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/conversation-manager/conversation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAIlF,qBAAa,mBAAmB;IAO5B,OAAO,CAAC,WAAW;IANrB,OAAO,CAAC,cAAc,CAAwB;IAE9C,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,kBAAkB,CAA0B;IAEpD,YACU,WAAW,EAAE,cAAc,EAAI;IAEnC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS1F;IAEK,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAY5D;IAEK,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhD;IAED;;;OAGG;IACG,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9D;IAED;;OAEG;IACH,cAAc,IAAI,OAAO,EAAE,CAE1B;IAED,WAAW,IAAI,OAAO,EAAE,CAEvB;IAED,UAAU,IAAI,OAAO,GAAG,IAAI,CAE3B;IAEK,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAE7D;CACF"}
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/conversation-manager/conversation-manager.ts"],"names":[],"mappings":"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"}