aec-agent 1.0.0

package/dist/components/multi-agent-orchestration/agent/memory-system/types/config.d.ts

@@ -0,0 +1,29 @@
+import type { DreamingConfig } from "../components/dreaming.js";
+export interface ConsolidationTrigger {
+    /** Run consolidation on a recurring interval in minutes (0 = disabled). */
+    intervalMinutes?: number;
+}
+export interface MemoryRecallConfig {
+    /** Max memories injected into the model context per turn (default 8, 0 = recall disabled). */
+    maxResults?: number;
+}
+export interface MemoryConfig {
+    /**
+     * enable memory system or not
+     */
+    enabled: boolean;
+    /**
+     * update soul by the time or not (in some case user want it will be fixed)
+     */
+    updateSoul: boolean;
+    /**
+     * update user by the time or not (in some case user want it will be fixed)
+     */
+    updateUser: boolean;
+    /** When to auto-trigger consolidation (dreaming pass). */
+    consolidation?: ConsolidationTrigger;
+    dreaming?: DreamingConfig;
+    /** How recalled memories are injected into the agent loop. */
+    recall?: MemoryRecallConfig;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/components/multi-agent-orchestration/agent/memory-system/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/memory-system/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAE3E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B"}

package/dist/components/multi-agent-orchestration/agent/memory-system/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/components/multi-agent-orchestration/agent/memory-system/types/config.js.map

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

package/dist/components/multi-agent-orchestration/agent/memory-system/types/pipeline.d.ts

@@ -0,0 +1,33 @@
+import type { MemoryKind, MemoryScope, MemoryRecord } from "./record.js";
+export type ConsolidationAction = "keep" | "merge" | "supersede" | "expire" | "delete" | "promote";
+export interface ConsolidationResult {
+    recordId: string;
+    action: ConsolidationAction;
+    reason: string;
+    mergedWith?: string;
+    supersededBy?: string;
+}
+export interface RetrievalQuery {
+    agentId: string;
+    sessionId: string;
+    currentContext: string;
+    scope?: MemoryScope;
+    kinds?: MemoryKind[];
+    maxResults?: number;
+}
+export interface RetrievalResult {
+    record: MemoryRecord;
+    relevanceScore: number;
+    recencyScore: number;
+    importanceScore: number;
+    combinedScore: number;
+}
+export type FeedbackSignalType = "accepted" | "corrected" | "cited" | "task_succeeded" | "task_failed" | "never_retrieved" | "contradicted";
+export interface FeedbackSignal {
+    memoryId: string;
+    signalType: FeedbackSignalType;
+    sessionId: string;
+    timestamp: string;
+    detail?: string;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/components/multi-agent-orchestration/agent/memory-system/types/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/memory-system/types/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AAMrB,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,OAAO,GACP,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,WAAW,GACX,OAAO,GACP,gBAAgB,GAChB,aAAa,GACb,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/components/multi-agent-orchestration/agent/memory-system/types/pipeline.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline.js.map

package/dist/components/multi-agent-orchestration/agent/memory-system/types/pipeline.js.map

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

package/dist/components/multi-agent-orchestration/agent/memory-system/types/record.d.ts

@@ -0,0 +1,27 @@
+export type MemoryKind = "user_preference" | "fact" | "decision" | "procedure" | "task_state" | "source_reference";
+export type MemoryScope = "user" | "project" | "profile" | "organization" | "task";
+export type MemoryStatus = "active" | "superseded" | "disputed" | "expired";
+export type MemoryConfidence = "explicit" | "verified" | "inferred" | "unverified";
+export type SourceTrust = "user_approved" | "verified_internal" | "team_authored" | "external_document" | "untrusted" | "model_speculation";
+export interface MemoryRecord {
+    id: string;
+    /** Owning agent (AgentProfile.id). Every memory belongs to exactly one agent; all reads are filtered by it. */
+    agentId: string;
+    kind: MemoryKind;
+    scope: MemoryScope;
+    subject: string;
+    key: string;
+    value: string;
+    status: MemoryStatus;
+    confidence: MemoryConfidence;
+    source: string;
+    sourceTrust: SourceTrust;
+    observedAt: string;
+    updatedAt?: string;
+    /** Last time recall returned this record. Keeps memories in active use from expiring; does not affect recency ranking. */
+    lastRecalledAt?: string;
+    supersededBy?: string;
+    expiresAt?: string;
+    tags?: string[];
+}
+//# sourceMappingURL=record.d.ts.map

package/dist/components/multi-agent-orchestration/agent/memory-system/types/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/memory-system/types/record.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,MAAM,GACN,UAAU,GACV,WAAW,GACX,YAAY,GACZ,kBAAkB,CAAC;AAEvB,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,SAAS,GACT,SAAS,GACT,cAAc,GACd,MAAM,CAAC;AAEX,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,UAAU,GACV,UAAU,GACV,YAAY,CAAC;AAGjB,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,mBAAmB,GACnB,WAAW,GACX,mBAAmB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,+GAA+G;IAC/G,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0HAA0H;IAC1H,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/components/multi-agent-orchestration/agent/memory-system/types/record.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Core memory record — the typed unit every pipeline stage operates on
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=record.js.map

package/dist/components/multi-agent-orchestration/agent/memory-system/types/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../../../../src/components/multi-agent-orchestration/agent/memory-system/types/record.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E"}

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

@@ -0,0 +1,39 @@
+import type { Message, ModelResponse, StreamChunk } from "../../../../kernel/types.js";
+import type { ModelOptions } from "../../../llm-provider-hub/types.js";
+import type { LLMProviderHub } from "../../../llm-provider-hub/llm-provider-hub.js";
+import type { AgentProfile } from "../types.js";
+type DefaultInferenceConfig = {
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    stopSequences?: string[];
+} | undefined;
+export declare class ModelManager {
+    private hub;
+    private defaultProvider;
+    private defaultLLMModel;
+    private defaultInferenceConfig;
+    constructor(providerHub: LLMProviderHub, profile: AgentProfile);
+    chat(messages: Message[], options?: ModelOptions): Promise<ModelResponse>;
+    stream(messages: Message[], options?: ModelOptions): AsyncIterable<StreamChunk>;
+    countTokens(messages: Message[]): Promise<number>;
+    listProviders(): string[];
+    setDefaultProvider(provider: string | undefined): void;
+    setDefaultModel(model: string | undefined): void;
+    setDefaultInferenceConfig(config: DefaultInferenceConfig): void;
+    /**
+     * The effective options a chat()/stream() call would send — same merge as
+     * the private withDefaults(), exposed publicly so tracing can describe the
+     * exact options the provider receives without re-implementing the merge.
+     */
+    resolveOptions(options?: ModelOptions): ModelOptions | undefined;
+    /**
+     * The provider name a chat()/stream() call would resolve to — same lookup
+     * as the private resolve(), exposed publicly for tracing.
+     */
+    resolveProviderName(provider?: string): string;
+    private resolve;
+    private withDefaults;
+}
+export {};
+//# sourceMappingURL=model-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/model-manager/model-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,KAAK,sBAAsB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,SAAS,CAAC;AAEd,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,sBAAsB,CAAyB;IAEvD,YACE,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAC,YAAY,EAMrB;IAEK,IAAI,CACR,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,aAAa,CAAC,CAExB;IAED,MAAM,CACJ,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,aAAa,CAAC,WAAW,CAAC,CAE5B;IAEK,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtD;IAED,aAAa,IAAI,MAAM,EAAE,CAExB;IAED,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAErD;IAED,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE/C;IAED,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAE9D;IAED;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,CAE/D;IAED;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;IAED,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,YAAY;CAYrB"}

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

@@ -0,0 +1,70 @@
+export class ModelManager {
+    hub;
+    defaultProvider;
+    defaultLLMModel;
+    defaultInferenceConfig;
+    constructor(providerHub, profile) {
+        this.hub = providerHub;
+        this.defaultProvider = profile.provider;
+        this.defaultLLMModel = profile.llmModel;
+        this.defaultInferenceConfig = profile.inferenceConfig;
+    }
+    async chat(messages, options) {
+        return this.resolve(options?.provider).chat(messages, this.withDefaults(options));
+    }
+    stream(messages, options) {
+        return this.resolve(options?.provider).stream(messages, this.withDefaults(options));
+    }
+    async countTokens(messages) {
+        return this.resolve().countTokens(messages);
+    }
+    listProviders() {
+        return this.hub.list().map((a) => a.name);
+    }
+    setDefaultProvider(provider) {
+        this.defaultProvider = provider;
+    }
+    setDefaultModel(model) {
+        this.defaultLLMModel = model;
+    }
+    setDefaultInferenceConfig(config) {
+        this.defaultInferenceConfig = config;
+    }
+    /**
+     * The effective options a chat()/stream() call would send — same merge as
+     * the private withDefaults(), exposed publicly so tracing can describe the
+     * exact options the provider receives without re-implementing the merge.
+     */
+    resolveOptions(options) {
+        return this.withDefaults(options);
+    }
+    /**
+     * The provider name a chat()/stream() call would resolve to — same lookup
+     * as the private resolve(), exposed publicly for tracing.
+     */
+    resolveProviderName(provider) {
+        return this.resolve(provider).name;
+    }
+    resolve(provider) {
+        const name = provider ?? this.defaultProvider;
+        if (name) {
+            const adapter = this.hub.get(name);
+            if (adapter)
+                return adapter;
+        }
+        return this.hub.getPrimary();
+    }
+    withDefaults(options) {
+        // Base layer: per-agent inferenceConfig defaults, then caller-provided
+        // options on top (caller wins on any overlapping field).
+        const merged = this.defaultInferenceConfig || options
+            ? { ...this.defaultInferenceConfig, ...options }
+            : options;
+        if (!this.defaultLLMModel)
+            return merged;
+        if (merged?.model)
+            return merged;
+        return { ...merged, model: this.defaultLLMModel };
+    }
+}
+//# sourceMappingURL=model-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/model-manager/model-manager.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,YAAY;IACf,GAAG,CAAiB;IACpB,eAAe,CAAqB;IACpC,eAAe,CAAqB;IACpC,sBAAsB,CAAyB;IAEvD,YACE,WAA2B,EAC3B,OAAoB;QAEpB,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;QACxC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;QACxC,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAAmB,EACnB,OAAsB;QAEtB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,CACJ,QAAmB,EACnB,OAAsB;QAEtB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAmB;QACnC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,kBAAkB,CAAC,QAA4B;QAC7C,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,eAAe,CAAC,KAAyB;QACvC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,yBAAyB,CAAC,MAA8B;QACtD,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,OAAsB;QACnC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,QAAiB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAEO,OAAO,CAAC,QAAiB;QAC/B,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,eAAe,CAAC;QAC9C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;IAC/B,CAAC;IAEO,YAAY,CAAC,OAAsB;QACzC,uEAAuE;QACvE,yDAAyD;QACzD,MAAM,MAAM,GACV,IAAI,CAAC,sBAAsB,IAAI,OAAO;YACpC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,sBAAsB,EAAE,GAAG,OAAO,EAAE;YAChD,CAAC,CAAC,OAAO,CAAC;QAEd,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,OAAO,MAAM,CAAC;QACzC,IAAI,MAAM,EAAE,KAAK;YAAE,OAAO,MAAM,CAAC;QACjC,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;IACpD,CAAC;CACF"}

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

@@ -0,0 +1,43 @@
+import type { SandboxHub } from "../../../sandbox-hub/sandbox-hub.js";
+import type { SandboxView } from "../../../sandbox-hub/types/sandbox.js";
+import type { SandboxOperation, SandboxSelection } from "../../../sandbox-hub/types/policy.js";
+import type { AgentProfile } from "../types.js";
+/**
+ * Per-agent sandbox lifecycle manager.
+ *
+ * The shared sandbox is managed by the global SandboxHub.
+ * Own sandboxes are managed here — created lazily on first use, cached,
+ * and recreated if the agent's profile config changes. Their data is deleted here too
+ * (release({ removeData: true })) — the hub only checks own specs against its policy.
+ */
+export declare class SandboxManager {
+    private hub;
+    private profile;
+    private ownSandbox?;
+    /**
+     * in case agent will remote to somewhere to process something;
+     */
+    private remoteSandbox?;
+    private ownSandboxFingerprint?;
+    constructor(hub: SandboxHub, profile: AgentProfile);
+    /** The profile's selection; omitted means the shared sandbox. */
+    get selection(): SandboxSelection;
+    /**
+     * Get existed or create new
+     * @returns
+     */
+    getSandbox(): Promise<SandboxView>;
+    /** Does this operation need user approval in `env`? (host folders: writes/commands do by default) */
+    requiresApproval(env: SandboxView, operation: SandboxOperation): boolean;
+    /** Validate a new selection before it is saved on the profile. */
+    validate(selection: SandboxSelection | undefined): void;
+    /**
+     * Stop this agent's own sandbox (if any); `removeData` also deletes its files — including
+     * cold data (a volume/folder left from an earlier run, or from a selection since switched away from).
+     */
+    release(opts?: {
+        removeData?: boolean;
+    }): Promise<void>;
+    private resolveOwn;
+}
+//# sourceMappingURL=sandbox-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/sandbox-manager/sandbox-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEtE,OAAO,KAAK,EAAe,WAAW,EAAW,MAAM,uCAAuC,CAAC;AAC/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,qBAAa,cAAc;IASvB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,OAAO;IATjB,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC;;OAEG;IACH,OAAO,CAAC,aAAa,CAAC,CAAmB;IACzC,OAAO,CAAC,qBAAqB,CAAC,CAAS;IAEvC,YACU,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,YAAY,EAC3B;IAEJ,iEAAiE;IACjE,IAAI,SAAS,IAAI,gBAAgB,CAEhC;IAED;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,CAkBvC;IAED,qGAAqG;IACrG,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAEvE;IAED,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAEtD;IAED;;;OAGG;IACG,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB5D;YAIa,UAAU;CAqCzB"}

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

@@ -0,0 +1,126 @@
+import { SandboxError, asSandboxError } from "../../../../kernel/errors/sandbox-error.js";
+import { assertSafeAgentId } from "../../../sandbox-hub/logical-path.js";
+/**
+ * Per-agent sandbox lifecycle manager.
+ *
+ * The shared sandbox is managed by the global SandboxHub.
+ * Own sandboxes are managed here — created lazily on first use, cached,
+ * and recreated if the agent's profile config changes. Their data is deleted here too
+ * (release({ removeData: true })) — the hub only checks own specs against its policy.
+ */
+export class SandboxManager {
+    hub;
+    profile;
+    ownSandbox;
+    /**
+     * in case agent will remote to somewhere to process something;
+     */
+    remoteSandbox;
+    ownSandboxFingerprint;
+    constructor(hub, profile) {
+        this.hub = hub;
+        this.profile = profile;
+    }
+    /** The profile's selection; omitted means the shared sandbox. */
+    get selection() {
+        return this.profile.sandbox ?? "shared";
+    }
+    /**
+     * Get existed or create new
+     * @returns
+     */
+    async getSandbox() {
+        const selection = this.selection;
+        if (selection === "none") {
+            throw new SandboxError('This agent has no sandbox (sandbox: "none")', "disabled");
+        }
+        // The shared sandbox is managed by the hub
+        if (selection === "shared") {
+            return this.hub.resolve(this.profile.id, selection);
+        }
+        // Own sandbox — managed here
+        if (typeof selection === "object" && "own" in selection) {
+            return this.resolveOwn(selection.own ?? {});
+        }
+        throw new SandboxError("Unrecognised sandbox selection", "policy_denied");
+    }
+    /** Does this operation need user approval in `env`? (host folders: writes/commands do by default) */
+    requiresApproval(env, operation) {
+        return this.hub.requiresApproval(env.traits, operation);
+    }
+    /** Validate a new selection before it is saved on the profile. */
+    validate(selection) {
+        this.hub.validateSelection(this.profile.id, selection);
+    }
+    /**
+     * Stop this agent's own sandbox (if any); `removeData` also deletes its files — including
+     * cold data (a volume/folder left from an earlier run, or from a selection since switched away from).
+     */
+    async release(opts) {
+        const running = this.ownSandbox;
+        this.ownSandbox = undefined;
+        this.ownSandboxFingerprint = undefined;
+        const managed = await running?.catch(() => null);
+        if (managed)
+            await managed.dispose({ removeData: opts?.removeData });
+        if (!opts?.removeData)
+            return;
+        // Not running in this process — remove the cold own-sandbox data through the provider,
+        // for every kind the agent may have used (it can switch kinds; each keeps its own files).
+        const agentId = this.profile.id;
+        assertSafeAgentId(agentId);
+        const failures = [];
+        for (const kind of this.hub.allowedOwnKinds()) {
+            if (managed?.traits.kind === kind)
+                continue;
+            try {
+                await this.hub.getSandboxProvider(kind)?.removeData?.({ kind }, { id: ownSandboxId(kind, agentId), tenancy: "own", agentId });
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        if (failures.length > 0)
+            throw failures[0];
+    }
+    // ── Own sandbox lifecycle ──
+    async resolveOwn(config) {
+        const spec = this.hub.buildOwnSandboxSpec(config);
+        const fingerprint = JSON.stringify(spec);
+        const agentId = this.profile.id;
+        const sandboxId = ownSandboxId(spec.kind, agentId);
+        // Config changed → dispose old sandbox, build a new one (files are kept)
+        if (this.ownSandboxFingerprint !== undefined && this.ownSandboxFingerprint !== fingerprint) {
+            const stale = this.ownSandbox;
+            this.ownSandbox = undefined;
+            await (await stale?.catch(() => null))?.dispose({ removeData: false }).catch(() => { });
+        }
+        this.ownSandboxFingerprint = fingerprint;
+        if (!this.ownSandbox) {
+            const provider = this.hub.getSandboxProvider(spec.kind);
+            if (!provider) {
+                throw new SandboxError(`No sandbox provider is registered for "${spec.kind}"`, "provider_unavailable", sandboxId);
+            }
+            const creating = provider
+                .create(spec, { id: sandboxId, tenancy: "own", agentId })
+                .catch((error) => {
+                // Not cached — the next call retries (e.g. Docker Desktop was still starting).
+                if (this.ownSandbox === creating)
+                    this.ownSandbox = undefined;
+                throw asSandboxError(error, sandboxId);
+            });
+            this.ownSandbox = creating;
+        }
+        const managed = await this.ownSandbox;
+        try {
+            return await managed.forAgent(agentId);
+        }
+        catch (error) {
+            throw asSandboxError(error, sandboxId);
+        }
+    }
+}
+function ownSandboxId(kind, agentId) {
+    return `${kind}:own:${agentId}`;
+}
+//# sourceMappingURL=sandbox-manager.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { EventBus } from "../../../event-handler/types.js";
+import type { ScheduledJobHandler } from "./types.js";
+/**
+ * Per-agent manager for scheduled jobs — cron-style or interval-based tasks
+ * that this specific agent can run autonomously.
+ * Like Hermes cron jobs: each agent profile owns its own set of scheduled jobs
+ * (e.g. wiki digests, report generation, health checks).
+ */
+export declare class ScheduledJobManager {
+    private agentId;
+    private eventBus;
+    private jobs;
+    private running;
+    constructor(agentId: string, eventBus: EventBus);
+    register(job: ScheduledJobHandler): void;
+    get(name: string): ScheduledJobHandler | undefined;
+    list(): ScheduledJobHandler[];
+    /** Start a registered job by name. No-op if already running. */
+    start(name: string): void;
+    /** Stop a running job by name. No-op if not running. */
+    stop(name: string): void;
+    /** Start all registered jobs. */
+    startAll(): void;
+    /** Stop all running jobs. */
+    stopAll(): void;
+    listRunning(): string[];
+    isRunning(name: string): boolean;
+    private fire;
+    private armCron;
+    /**
+     * Minimal cron parser: supports "minute hour dayOfMonth month dayOfWeek".
+     * For production use, plug in a library like `cron-parser` or `croner`.
+     * This built-in handles simple patterns (exact values and wildcards).
+     */
+    private computeNextCronMs;
+    private cronMatches;
+}
+//# sourceMappingURL=scheduled-job-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-job-manager.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/scheduled-job-manager/scheduled-job-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAuB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAS3E;;;;;GAKG;AACH,qBAAa,mBAAmB;IAK5B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;IALlB,OAAO,CAAC,IAAI,CAA0C;IACtD,OAAO,CAAC,OAAO,CAAiC;IAEhD,YACU,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EACxB;IAEJ,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAOvC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEjD;IAED,IAAI,IAAI,mBAAmB,EAAE,CAE5B;IAED,gEAAgE;IAChE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAexB;IAED,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMvB;IAED,iCAAiC;IACjC,QAAQ,IAAI,IAAI,CAIf;IAED,6BAA6B;IAC7B,OAAO,IAAI,IAAI,CAId;IAED,WAAW,IAAI,MAAM,EAAE,CAEtB;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/B;YAEa,IAAI;IAiClB,OAAO,CAAC,OAAO;IAiBf;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,WAAW;CAapB"}

package/dist/components/multi-agent-orchestration/agent/scheduled-job-manager/scheduled-job-manager.js

@@ -0,0 +1,155 @@
+import { SDKEventType } from "../../../event-handler/events.js";
+/**
+ * Per-agent manager for scheduled jobs — cron-style or interval-based tasks
+ * that this specific agent can run autonomously.
+ * Like Hermes cron jobs: each agent profile owns its own set of scheduled jobs
+ * (e.g. wiki digests, report generation, health checks).
+ */
+export class ScheduledJobManager {
+    agentId;
+    eventBus;
+    jobs = new Map();
+    running = new Map();
+    constructor(agentId, eventBus) {
+        this.agentId = agentId;
+        this.eventBus = eventBus;
+    }
+    register(job) {
+        if (this.jobs.has(job.definition.name)) {
+            throw new Error(`Scheduled job "${job.definition.name}" already registered on agent "${this.agentId}"`);
+        }
+        this.jobs.set(job.definition.name, job);
+    }
+    get(name) {
+        return this.jobs.get(name);
+    }
+    list() {
+        return [...this.jobs.values()];
+    }
+    /** Start a registered job by name. No-op if already running. */
+    start(name) {
+        if (this.running.has(name))
+            return;
+        const handler = this.jobs.get(name);
+        if (!handler) {
+            throw new Error(`Scheduled job "${name}" not registered on agent "${this.agentId}"`);
+        }
+        const { schedule } = handler.definition;
+        if (typeof schedule === "number") {
+            const timer = setInterval(() => this.fire(name), schedule);
+            this.running.set(name, { handler, timer, nextRun: -1 });
+        }
+        else {
+            this.armCron(name, handler);
+        }
+    }
+    /** Stop a running job by name. No-op if not running. */
+    stop(name) {
+        const entry = this.running.get(name);
+        if (!entry)
+            return;
+        clearInterval(entry.timer);
+        clearTimeout(entry.timer);
+        this.running.delete(name);
+    }
+    /** Start all registered jobs. */
+    startAll() {
+        for (const name of this.jobs.keys()) {
+            this.start(name);
+        }
+    }
+    /** Stop all running jobs. */
+    stopAll() {
+        for (const name of [...this.running.keys()]) {
+            this.stop(name);
+        }
+    }
+    listRunning() {
+        return [...this.running.keys()];
+    }
+    isRunning(name) {
+        return this.running.has(name);
+    }
+    async fire(name) {
+        const entry = this.running.get(name);
+        if (!entry)
+            return;
+        const context = {
+            agentId: this.agentId,
+            firedAt: Date.now(),
+            emit: (partial) => {
+                this.eventBus.emit({
+                    ...partial,
+                    sessionId: `scheduled-job:${this.agentId}:${name}`,
+                });
+            },
+        };
+        try {
+            const output = await entry.handler.execute(context);
+            context.emit({
+                type: SDKEventType.JobCompleted,
+                payload: { agentId: this.agentId, jobName: name, output },
+            });
+        }
+        catch (error) {
+            context.emit({
+                type: SDKEventType.JobFailed,
+                payload: {
+                    agentId: this.agentId,
+                    jobName: name,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            });
+        }
+    }
+    armCron(name, handler) {
+        const nextMs = this.computeNextCronMs(handler.definition.schedule, handler.definition.timezone);
+        if (nextMs <= 0)
+            return;
+        const timer = setTimeout(async () => {
+            await this.fire(name);
+            if (this.running.has(name)) {
+                this.armCron(name, handler);
+            }
+        }, nextMs);
+        this.running.set(name, { handler, timer, nextRun: Date.now() + nextMs });
+    }
+    /**
+     * Minimal cron parser: supports "minute hour dayOfMonth month dayOfWeek".
+     * For production use, plug in a library like `cron-parser` or `croner`.
+     * This built-in handles simple patterns (exact values and wildcards).
+     */
+    computeNextCronMs(expression, _timezone) {
+        const parts = expression.trim().split(/\s+/);
+        if (parts.length !== 5) {
+            throw new Error(`Invalid cron expression "${expression}" — expected 5 fields (minute hour dom month dow)`);
+        }
+        const now = new Date();
+        const candidate = new Date(now);
+        candidate.setSeconds(0, 0);
+        candidate.setMinutes(candidate.getMinutes() + 1);
+        const maxIterations = 48 * 60;
+        for (let i = 0; i < maxIterations; i++) {
+            if (this.cronMatches(parts, candidate)) {
+                return candidate.getTime() - now.getTime();
+            }
+            candidate.setMinutes(candidate.getMinutes() + 1);
+        }
+        return 24 * 60 * 60 * 1000;
+    }
+    cronMatches(parts, date) {
+        const checks = [
+            { value: date.getMinutes(), field: parts[0] },
+            { value: date.getHours(), field: parts[1] },
+            { value: date.getDate(), field: parts[2] },
+            { value: date.getMonth() + 1, field: parts[3] },
+            { value: date.getDay(), field: parts[4] },
+        ];
+        return checks.every(({ value, field }) => {
+            if (!field || field === "*")
+                return true;
+            return field.split(",").some((f) => parseInt(f, 10) === value);
+        });
+    }
+}
+//# sourceMappingURL=scheduled-job-manager.js.map

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

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