aec-agent 1.0.0

package/dist/components/multi-agent-orchestration/agent/agent-loop/components/tool-pairing.js

@@ -0,0 +1,56 @@
+/**
+ * True when a message carries tool results — either on `toolResults` (how the
+ * agent loop records them) or as a legacy `role: "tool"` message.
+ */
+export function carriesToolResults(message) {
+    return message.role === "tool" || (message.toolResults?.length ?? 0) > 0;
+}
+/**
+ * Make the model input well-formed with respect to tool calls: every tool
+ * result must follow the tool call it answers, and every tool call must get a
+ * result. Providers reject anything else (OpenAI: "No tool call found for
+ * function call output", Anthropic: "tool_use ids were found without
+ * tool_result blocks").
+ *
+ * The history can break this when compaction summarises a tool call but keeps
+ * its result, or when a run stops between a call and its result. Orphaned
+ * calls/results are dropped, and a message left with nothing is dropped too.
+ * Returns the input array unchanged when nothing needs repairing.
+ */
+export function repairToolPairs(messages) {
+    const answered = new Set();
+    for (const message of messages) {
+        for (const result of message.toolResults ?? [])
+            answered.add(result.toolCallId);
+    }
+    const called = new Set();
+    let changed = false;
+    const repaired = [];
+    for (const message of messages) {
+        const toolCalls = message.toolCalls?.filter((call) => answered.has(call.id));
+        // Results only count when their call came earlier in the input.
+        const toolResults = message.toolResults?.filter((result) => called.has(result.toolCallId));
+        for (const call of toolCalls ?? [])
+            called.add(call.id);
+        const droppedCalls = (message.toolCalls?.length ?? 0) !== (toolCalls?.length ?? 0);
+        const droppedResults = (message.toolResults?.length ?? 0) !== (toolResults?.length ?? 0);
+        if (!droppedCalls && !droppedResults) {
+            repaired.push(message);
+            continue;
+        }
+        changed = true;
+        const next = { ...message };
+        if (toolCalls?.length)
+            next.toolCalls = toolCalls;
+        else
+            delete next.toolCalls;
+        if (toolResults?.length)
+            next.toolResults = toolResults;
+        else
+            delete next.toolResults;
+        if (next.content || next.toolCalls || next.toolResults)
+            repaired.push(next);
+    }
+    return changed ? repaired : messages;
+}
+//# sourceMappingURL=tool-pairing.js.map

package/dist/components/multi-agent-orchestration/agent/agent-loop/components/tool-pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pairing.js","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/agent-loop/components/tool-pairing.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,QAAmB;IACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,WAAW,IAAI,EAAE;YAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7E,gEAAgE;QAChE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAC3F,KAAK,MAAM,IAAI,IAAI,SAAS,IAAI,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAExD,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACnF,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,YAAY,IAAI,CAAC,cAAc,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QAED,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,IAAI,GAAY,EAAE,GAAG,OAAO,EAAE,CAAC;QACrC,IAAI,SAAS,EAAE,MAAM;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;;YAC7C,OAAO,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,WAAW,EAAE,MAAM;YAAE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;;YACnD,OAAO,IAAI,CAAC,WAAW,CAAC;QAE7B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvC,CAAC"}

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/llm-input.d.ts

@@ -0,0 +1,23 @@
+import type { Message } from "../../../../../kernel/types.js";
+import type { ModelOptions } from "../../../../llm-provider-hub/types.js";
+import type { RecalledMemories } from "../../memory-system/memory-system.js";
+import type { ModelManager } from "../../model-manager/model-manager.js";
+import type { ContextAssemblyTraceAttributes } from "../types.js";
+import type { CompactorResult } from "../components/compactor.types.js";
+import type { Counter } from "../components/counter.js";
+/**
+ * Append recalled memories to the last system message.
+ */
+export declare function withRecalledMemories(messages: Message[], recalled: RecalledMemories | null): Message[];
+export declare function describeLlmInput(params: {
+    iteration: number;
+    prepared: Message[];
+    compactResult: CompactorResult;
+    llmMessages: Message[];
+    recalled: RecalledMemories | null;
+    options: ModelOptions;
+}, deps: {
+    modelManager: ModelManager;
+    counter: Counter;
+}): ContextAssemblyTraceAttributes;
+//# sourceMappingURL=llm-input.d.ts.map

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/llm-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-input.d.ts","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/agent-loop/functions/llm-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,8BAA8B,EAAuB,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAChC,OAAO,EAAE,CAgBX;AAMD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,eAAe,CAAC;IAC/B,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,YAAY,CAAC;CACvB,EACD,IAAI,EAAE;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACrD,8BAA8B,CAoHhC"}

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/llm-input.js

@@ -0,0 +1,127 @@
+/**
+ * Append recalled memories to the last system message.
+ */
+export function withRecalledMemories(messages, recalled) {
+    if (!recalled?.content)
+        return messages;
+    let idx = -1;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i].role === "system") {
+            idx = i;
+            break;
+        }
+    }
+    if (idx === -1) {
+        return [{ role: "system", content: recalled.content }, ...messages];
+    }
+    const out = [...messages];
+    const system = out[idx];
+    out[idx] = { ...system, content: `${system.content}\n\n${recalled.content}` };
+    return out;
+}
+// Build the full breakdown of the exact LLM input for one iteration, for
+// the "context-assembly" trace span. Never throws — tracing must never
+// break the loop (e.g. hub.getPrimary() throws when no provider is
+// registered, so provider resolution is wrapped in try/catch).
+export function describeLlmInput(params, deps) {
+    const { iteration, prepared, compactResult, llmMessages, recalled, options } = params;
+    const { modelManager, counter } = deps;
+    const resolved = modelManager.resolveOptions(options) ?? {};
+    const { tools: resolvedTools, ...effectiveOptions } = resolved;
+    const tools = (resolvedTools ?? options.tools ?? []).map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: t.parameters,
+    }));
+    let provider;
+    try {
+        provider = modelManager.resolveProviderName(options.provider);
+    }
+    catch {
+        provider = undefined;
+    }
+    // Memory injection mode — mirrors withRecalledMemories's own targeting logic.
+    const hasSystemInCompacted = compactResult.messages.some((m) => m.role === "system");
+    const memoryInjection = !recalled?.content
+        ? "none"
+        : hasSystemInCompacted
+            ? "appended-to-system"
+            : "new-system-message";
+    const memoryBlock = recalled?.content ?? undefined;
+    // Index of the LAST system message in the actual model input.
+    let systemMessageIndex;
+    for (let i = llmMessages.length - 1; i >= 0; i--) {
+        if (llmMessages[i].role === "system") {
+            systemMessageIndex = i;
+            break;
+        }
+    }
+    // Base system prompt: last system message BEFORE memory injection.
+    let baseSystemPrompt;
+    for (let i = compactResult.messages.length - 1; i >= 0; i--) {
+        if (compactResult.messages[i].role === "system") {
+            baseSystemPrompt = compactResult.messages[i].content;
+            break;
+        }
+    }
+    // The summary's index shifts by +1 when a brand-new system message was
+    // prepended by memory injection.
+    let summaryIndex;
+    if (compactResult.compacted && compactResult.summaryIndex !== undefined) {
+        summaryIndex =
+            compactResult.summaryIndex +
+                (memoryInjection === "new-system-message" ? 1 : 0);
+    }
+    const messages = llmMessages.map((m) => ({
+        role: m.role,
+        content: m.content,
+        timestamp: m.timestamp,
+        toolCalls: m.toolCalls?.map((tc) => ({
+            id: tc.id,
+            name: tc.name,
+            arguments: tc.arguments,
+        })),
+        toolResults: m.toolResults?.map((tr) => ({
+            toolCallId: tr.toolCallId,
+            content: tr.content,
+            isError: tr.isError,
+        })),
+        estimatedTokens: counter.countTokens(m),
+    }));
+    const memoryTokens = memoryBlock
+        ? counter.countTokens({ role: "system", content: memoryBlock })
+        : 0;
+    const toolTokens = tools.length
+        ? counter.countTokens({
+            role: "system",
+            content: JSON.stringify(tools),
+        })
+        : 0;
+    const messagesTokens = messages.reduce((sum, m) => sum + m.estimatedTokens, 0);
+    return {
+        iteration,
+        messageCount: llmMessages.length,
+        preparedMessageCount: prepared.length,
+        compacted: compactResult.compacted,
+        summaryIndex,
+        recalledMemories: recalled?.recordIds.length ?? 0,
+        memoryRecordIds: recalled?.recordIds ?? [],
+        memoryBlock,
+        memoryInjection,
+        memoryTokens,
+        systemMessageIndex,
+        baseSystemPrompt,
+        messages,
+        tools,
+        toolNames: tools.map((t) => t.name),
+        provider,
+        options: effectiveOptions,
+        estimatedTokens: {
+            messages: messagesTokens,
+            memory: memoryTokens,
+            tools: toolTokens,
+            total: messagesTokens + toolTokens,
+        },
+    };
+}
+//# sourceMappingURL=llm-input.js.map

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/llm-input.js.map

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

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/memory-recall.d.ts

@@ -0,0 +1,9 @@
+import type { MemorySystem, RecalledMemories } from "../../memory-system/memory-system.js";
+import type { Counter } from "../components/counter.js";
+import type { RunTrace } from "../components/run-trace.js";
+export declare function recallMemories(deps: {
+    memorySystem: MemorySystem;
+    counter: Counter;
+    agentId: string;
+}, userMessage: string, sessionId: string, trace: RunTrace): Promise<RecalledMemories | null>;
+//# sourceMappingURL=memory-recall.d.ts.map

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/memory-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recall.d.ts","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/agent-loop/functions/memory-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAK3D,wBAAsB,cAAc,CAClC,IAAI,EAAE;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACvE,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoClC"}

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/memory-recall.js

@@ -0,0 +1,40 @@
+// Recall failures must never block the turn — log and continue without memories.
+// Traced as a "memory-recall" span (child of the run span) so recall latency,
+// hit rate, scores and injected size can be measured per turn.
+export async function recallMemories(deps, userMessage, sessionId, trace) {
+    if (!deps.memorySystem.recallForTurn)
+        return null;
+    const recallSpan = trace.span("memory-recall", "memory-recall", {
+        queryLength: userMessage.length,
+        queryPreview: userMessage,
+    });
+    try {
+        const recalled = await deps.memorySystem.recallForTurn(userMessage, sessionId);
+        recallSpan?.end({
+            recalledCount: recalled.recordIds.length,
+            maxResults: recalled.maxResults,
+            hit: recalled.recordIds.length > 0,
+            skipped: recalled.skipped,
+            indexRebuilt: recalled.indexRebuilt,
+            indexRebuildMs: recalled.indexRebuildMs,
+            indexedCount: recalled.indexedCount,
+            injectedChars: recalled.content?.length ?? 0,
+            injectedTokens: recalled.content
+                ? deps.counter.countTokens({
+                    role: "system",
+                    content: recalled.content,
+                })
+                : 0,
+            topScore: recalled.memories[0]?.combinedScore,
+            memories: recalled.memories,
+        });
+        return recalled;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        recallSpan?.end({ error: message });
+        console.warn(`[memory] recall failed for agent ${deps.agentId} session ${sessionId}:`, message);
+        return null;
+    }
+}
+//# sourceMappingURL=memory-recall.js.map

package/dist/components/multi-agent-orchestration/agent/agent-loop/functions/memory-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recall.js","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/agent-loop/functions/memory-recall.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,8EAA8E;AAC9E,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAuE,EACvE,WAAmB,EACnB,SAAiB,EACjB,KAAe;IAEf,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,EAAE;QAC9D,WAAW,EAAE,WAAW,CAAC,MAAM;QAC/B,YAAY,EAAE,WAAW;KAC1B,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC/E,UAAU,EAAE,GAAG,CAAC;YACd,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM;YACxC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YAClC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;YAC5C,cAAc,EAAE,QAAQ,CAAC,OAAO;gBAC9B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;oBACvB,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,QAAQ,CAAC,OAAO;iBAC1B,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa;YAC7C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,UAAU,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CACV,oCAAoC,IAAI,CAAC,OAAO,YAAY,SAAS,GAAG,EACxE,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/components/multi-agent-orchestration/agent/agent-loop/types.d.ts

@@ -0,0 +1,135 @@
+import type { AgentProfile } from "../types.js";
+import type { EventBus } from "../../../event-handler/types.js";
+import type { Message, TokenUsage } from "../../../../kernel/types.js";
+import type { ModelOptions } from "../../../llm-provider-hub/types.js";
+import type { InteractionHandler, ToolPolicy } from "../../../tool-hub/types.js";
+import { SDKEventType } from "../../../event-handler/events.js";
+import type { TraceService } from "../../../trace-service/trace-service.js";
+import type { ContextManager } from "../context-manager/context-manager.js";
+import type { MemorySystem } from "../memory-system/memory-system.js";
+import type { ConversationManager } from "../conversation-manager/conversation-manager.js";
+import type { ModelManager } from "../model-manager/model-manager.js";
+import type { SkillManager } from "../skill-manager/skill-manager.js";
+import type { ToolManager } from "../tool-manager/tool-manager.js";
+import type { SandboxManager } from "../sandbox-manager/sandbox-manager.js";
+import type { ArtifactManager } from "../artifact-manager/artifact-manager.js";
+export declare const MAX_ITERATIONS = 10;
+export declare const MAX_TOOL_RETRIES = 2;
+export declare const RETRY_BACKOFF_MS = 500;
+/** Agent-loop limits fully resolved for a single run/dispatch — no optional fields. */
+export interface ResolvedLoopConfig {
+    maxIterations: number;
+    maxToolRetries: number;
+    retryBackoffMs: number;
+}
+/**
+ * Resolve an agent's optional loopConfig into concrete limits, falling back
+ * to the SDK defaults per-field when a value is missing, non-finite, or
+ * below the field's minimum. One invalid field does not reset the others.
+ */
+export declare function resolveLoopConfig(config: AgentProfile["loopConfig"] | undefined): ResolvedLoopConfig;
+export { SDKEventType };
+export interface AgentLoopDeps {
+    modelManager: ModelManager;
+    toolManager: ToolManager;
+    skillManager: SkillManager;
+    contextManager: ContextManager;
+    conversationManager: ConversationManager;
+    eventBus: EventBus;
+    profile: AgentProfile;
+    /** Tool policy for authorization checks before dispatch (optional — no policy = allow all) */
+    toolPolicy?: ToolPolicy;
+    /** Resolved on every dispatch (wins over `toolPolicy`) so ToolHub.setPolicy() applies to running agents. */
+    getToolPolicy?: () => ToolPolicy | undefined;
+    /** Tools allowed for this agent (from AgentProfile.tools). Empty = no restriction. */
+    allowedTools?: string[];
+    /** Centralized trace service for span-tree observability (optional — no tracing when absent) */
+    traceService?: TraceService;
+    memorySystem: MemorySystem;
+    /**
+     * Host channel to the human user (clarify / approval), resolved lazily on every tool
+     * dispatch so a handler registered after the agent was spawned is still picked up.
+     * Absent = no interactive user: clarify reports an error and consequential tools are denied.
+     */
+    getInteractionHandler?: () => InteractionHandler | undefined;
+    /** Resolves the agent's sandbox for file/terminal tools (absent = none). */
+    sandboxManager?: SandboxManager;
+    /** Scopes the artifact store to this agent for the artifact tools (absent = no artifacts). */
+    artifactManager?: ArtifactManager;
+}
+export interface RunResult {
+    message: Message;
+    usage: TokenUsage;
+    iterations: number;
+    /** True when the run was stopped through RunOptions.signal instead of ending naturally (A-65). */
+    aborted?: boolean;
+}
+export type EmitFn = (type: string, payload: unknown) => void;
+/**
+ * Per-run control for Agent.chat/chatStream. Aborting `signal` stops the run
+ * at the next safe point, saves what it has so far, and ends a stream with a
+ * done chunk marked `aborted: true` (a blocking chat() call resolves with
+ * `aborted: true` instead).
+ */
+export interface RunOptions {
+    signal?: AbortSignal;
+}
+/** A single message as it appears in the exact array sent to the model. */
+export interface ContextTraceMessage {
+    role: Message["role"];
+    content: string;
+    timestamp?: string;
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    toolResults?: Array<{
+        toolCallId: string;
+        content: string;
+        isError?: boolean;
+    }>;
+    estimatedTokens: number;
+}
+/**
+ * Full breakdown of the exact input handed to ModelManager.chat()/stream()
+ * for one iteration. Recorded on the "context-assembly" span so the trace
+ * equals the model input, not a stale pre-compaction/pre-memory snapshot.
+ */
+export interface ContextAssemblyTraceAttributes {
+    iteration: number;
+    /** length of `messages` — the array sent to the model */
+    messageCount: number;
+    /** length after context middleware, before compaction */
+    preparedMessageCount: number;
+    compacted: boolean;
+    /** index of the summary message in `messages`, set only when compacted */
+    summaryIndex?: number;
+    recalledMemories: number;
+    memoryRecordIds: string[];
+    memoryBlock?: string;
+    memoryInjection: "appended-to-system" | "new-system-message" | "none";
+    memoryTokens: number;
+    /** index of the LAST system message in `messages` — the one withRecalledMemories targets or creates */
+    systemMessageIndex?: number;
+    /** content of the last system message in the post-compaction array, BEFORE memory injection */
+    baseSystemPrompt?: string;
+    messages: ContextTraceMessage[];
+    tools: Array<{
+        name: string;
+        description: string;
+        parameters: unknown;
+    }>;
+    toolNames: string[];
+    provider?: string;
+    /** effective ModelOptions after ModelManager's defaults merge, without `tools` */
+    options: Omit<ModelOptions, "tools">;
+    estimatedTokens: {
+        messages: number;
+        memory: number;
+        tools: number;
+        /** messages + tools — memory is already counted inside messages */
+        total: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/multi-agent-orchestration/agent/agent-loop/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/agent-loop/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EACV,OAAO,EAIP,UAAU,EACX,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EACV,kBAAkB,EAElB,UAAU,EACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAO/E,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,CAAC,YAAY,CAAC,GAAG,SAAS,GAC7C,kBAAkB,CAgBpB;AAMD,OAAO,EAAE,YAAY,EAAE,CAAC;AAMxB,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4GAA4G;IAC5G,aAAa,CAAC,EAAE,MAAM,UAAU,GAAG,SAAS,CAAC;IAC7C,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gGAAgG;IAChG,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAC;IAC7D,4EAA4E;IAC5E,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8FAA8F;IAC9F,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAM9D;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,MAAM,CAAC;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,mEAAmE;QACnE,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/components/multi-agent-orchestration/agent/agent-loop/types.js

@@ -0,0 +1,31 @@
+import { SDKEventType } from "../../../event-handler/events.js";
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+// Defaults — overridable per agent via AgentProfile.loopConfig (see resolveLoopConfig below).
+export const MAX_ITERATIONS = 10;
+export const MAX_TOOL_RETRIES = 2;
+export const RETRY_BACKOFF_MS = 500;
+/**
+ * Resolve an agent's optional loopConfig into concrete limits, falling back
+ * to the SDK defaults per-field when a value is missing, non-finite, or
+ * below the field's minimum. One invalid field does not reset the others.
+ */
+export function resolveLoopConfig(config) {
+    const resolveField = (value, min, fallback) => {
+        if (typeof value !== "number" || !Number.isFinite(value))
+            return fallback;
+        const floored = Math.floor(value);
+        return floored >= min ? floored : fallback;
+    };
+    return {
+        maxIterations: resolveField(config?.maxIterations, 1, MAX_ITERATIONS),
+        maxToolRetries: resolveField(config?.maxToolRetries, 0, MAX_TOOL_RETRIES),
+        retryBackoffMs: resolveField(config?.retryBackoffMs, 0, RETRY_BACKOFF_MS),
+    };
+}
+// ---------------------------------------------------------------------------
+// SDKEventType re-exported for convenience within agent-loop
+// ---------------------------------------------------------------------------
+export { SDKEventType };
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/agent-loop/types.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAehE,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,8FAA8F;AAC9F,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AASpC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA8C;IAE9C,MAAM,YAAY,GAAG,CACnB,KAAyB,EACzB,GAAW,EACX,QAAgB,EACR,EAAE;QACV,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7C,CAAC,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,CAAC;QACrE,cAAc,EAAE,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,CAAC;QACzE,cAAc,EAAE,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1,93 @@
+import type { AgentProfile } from "./types.js";
+import type { ModelOptions } from "../../llm-provider-hub/types.js";
+import type { ScheduledJobHandler } from "./scheduled-job-manager/types.js";
+import type { Message, ModelResponse, Session, SessionFilter, StreamChunk } from "../../../kernel/types.js";
+import type { AgentCore } from "../../../agent-core.js";
+import type { RunOptions, RunResult } from "./agent-loop/types.js";
+import type { SandboxSelection } from "../../sandbox-hub/types/policy.js";
+import type { SandboxView } from "../../sandbox-hub/types/sandbox.js";
+import type { ArtifactView } from "../../artifact-hub/types/artifact.js";
+/**
+ * The minimum unit and the most important concept here, this Agent will get everything done here.
+ * This is the harness layer wrap around LLM
+ */
+export declare class Agent {
+    readonly profile: AgentProfile;
+    private agentLoop;
+    private contextManager;
+    private conversationManager;
+    private modelManager;
+    private scheduledJobManager;
+    private skillManager;
+    private toolManager;
+    private sandboxManager;
+    private artifactManager;
+    private memorySystem;
+    constructor(agentCore: AgentCore, profile: AgentProfile);
+    startSession(metadata?: Record<string, unknown>, llmModel?: string): Promise<Session>;
+    loadSession(sessionId: string): Promise<Session | null>;
+    listSessions(filter?: SessionFilter): Promise<Session[]>;
+    listProviders(): string[];
+    /**
+     * `runOptions` (A-65) is a per-call control, separate from `options`
+     * (model/inference overrides) — aborting `runOptions.signal` stops this
+     * run at the next safe point instead of letting it run to completion.
+     */
+    chat(message: string, options?: ModelOptions, runOptions?: RunOptions): Promise<RunResult>;
+    /** `runOptions` (A-65): see chat()'s doc comment above. */
+    chatStream(message: string, options?: ModelOptions, runOptions?: RunOptions): AsyncIterable<StreamChunk>;
+    /**
+     * One model call with this agent's provider, model and inference defaults —
+     * the same resolution chat()/chatStream() use — but outside the agent loop:
+     * no system prompt, tools, skills, memory, conversation history or trace
+     * spans, and nothing is added to any session.
+     * For side tasks such as writing a session title or a summary.
+     *
+     * `session` applies that session's model override, as chat() does for the
+     * active session; it does not have to be the active one.
+     */
+    complete(messages: Message[], options?: ModelOptions, session?: Session): Promise<ModelResponse>;
+    private mergeSessionModel;
+    /** Replace the agent's tool allowlist and propagate to the internal ToolManager. */
+    updateTools(toolNames: string[]): void;
+    /** Update the agent's default provider at runtime. */
+    updateProvider(provider: string | undefined): void;
+    /** Update the agent's default LLM model at runtime. */
+    updateModel(model: string | undefined): void;
+    /** Update the agent's default inference config (maxTokens/temperature/topP/stopSequences) at runtime. */
+    updateInferenceConfig(config: AgentProfile["inferenceConfig"]): void;
+    /** Update the agent's loop limits (maxIterations/maxToolRetries/retryBackoffMs) at runtime. */
+    updateLoopConfig(config: AgentProfile["loopConfig"]): void;
+    /** Update the agent's memory config and propagate to the live MemorySystem. */
+    updateMemoryConfig(config: AgentProfile["memory"]): void;
+    /** Replace the agent's skill allowlist and propagate to the internal SkillManager. */
+    updateSkills(skillNames: string[]): void;
+    /**
+     * Get existed or create new
+     * @returns
+     */
+    getSandbox(): Promise<SandboxView>;
+    /**
+     * Change where the agent's file/terminal tools run. Validated against the hub policy
+     * first (throws SandboxError); applies to the next tool call. An own sandbox whose
+     * config changed is recreated on next use, keeping its files.
+     */
+    updateSandbox(selection: SandboxSelection | undefined): void;
+    /**
+     * This agent's artifacts. Pass the session doing the writing to stamp it on new
+     * versions; reads never depend on it (artifacts outlive the session that made them).
+     */
+    artifacts(sessionId?: string): ArtifactView;
+    useScheduledJob(job: ScheduledJobHandler): void;
+    getScheduledJob(name: string): ScheduledJobHandler | undefined;
+    getScheduledJobs(): ScheduledJobHandler[];
+    startScheduledJob(name: string): void;
+    stopScheduledJob(name: string): void;
+    startAllScheduledJobs(): void;
+    stopAllScheduledJobs(): void;
+    /** Stop the agent. `removeData` (the agent is being deleted) also deletes its own sandbox's files. */
+    dispose(opts?: {
+        removeData?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=agent.d.ts.map

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

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