@typescript-agent-harness/core 0.15.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 typescript-agent-harness contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/context.d.ts

@@ -0,0 +1,25 @@
+import { EventBus } from "./event-bus.js";
+import type { EventHandler, EventPayload, Unsubscribe } from "./events.js";
+import { type ServiceKey } from "./service.js";
+export interface Context {
+    readonly runtimeId: string;
+    get<T>(key: ServiceKey<T>): T;
+    tryGet<T>(key: ServiceKey<T>): T | undefined;
+    provide<T>(key: ServiceKey<T>, value: T): void;
+    emit<TName extends string>(type: TName, payload: EventPayload<TName>): Promise<void>;
+    on<TName extends string>(type: TName, handler: EventHandler<EventPayload<TName>>): Unsubscribe;
+}
+export declare class RuntimeContext implements Context {
+    readonly runtimeId: string;
+    private readonly bus;
+    private readonly services;
+    constructor(runtimeId: string, bus: EventBus);
+    get<T>(key: ServiceKey<T>): T;
+    tryGet<T>(key: ServiceKey<T>): T | undefined;
+    provide<T>(key: ServiceKey<T>, value: T): void;
+    emit<TName extends string>(type: TName, payload: EventPayload<TName>): Promise<void>;
+    on<TName extends string>(type: TName, handler: EventHandler<EventPayload<TName>>): Unsubscribe;
+    /** Internal: wipe service registry on stop. */
+    clearServices(): void;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE9B,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAE7C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAE/C,IAAI,CAAC,KAAK,SAAS,MAAM,EACvB,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,EAAE,CAAC,KAAK,SAAS,MAAM,EACrB,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GACzC,WAAW,CAAC;CAChB;AAED,qBAAa,cAAe,YAAW,OAAO;IAI1C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;gBAG5C,SAAS,EAAE,MAAM,EACT,GAAG,EAAE,QAAQ;IAGhC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;IAO7B,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAI5C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAOxC,IAAI,CAAC,KAAK,SAAS,MAAM,EAC7B,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC;IAIhB,EAAE,CAAC,KAAK,SAAS,MAAM,EACrB,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GACzC,WAAW;IAId,+CAA+C;IAC/C,aAAa,IAAI,IAAI;CAGtB"}

package/dist/context.js

@@ -0,0 +1,37 @@
+import { EventBus } from "./event-bus.js";
+import { ServiceAlreadyProvidedError, ServiceNotFoundError, } from "./service.js";
+export class RuntimeContext {
+    runtimeId;
+    bus;
+    services = new Map();
+    constructor(runtimeId, bus) {
+        this.runtimeId = runtimeId;
+        this.bus = bus;
+    }
+    get(key) {
+        if (!this.services.has(key.id)) {
+            throw new ServiceNotFoundError(key.id);
+        }
+        return this.services.get(key.id);
+    }
+    tryGet(key) {
+        return this.services.get(key.id);
+    }
+    provide(key, value) {
+        if (this.services.has(key.id)) {
+            throw new ServiceAlreadyProvidedError(key.id);
+        }
+        this.services.set(key.id, value);
+    }
+    async emit(type, payload) {
+        await this.bus.emit(type, payload);
+    }
+    on(type, handler) {
+        return this.bus.on(type, handler);
+    }
+    /** Internal: wipe service registry on stop. */
+    clearServices() {
+        this.services.clear();
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GAErB,MAAM,cAAc,CAAC;AAsBtB,MAAM,OAAO,cAAc;IAId;IACQ;IAJF,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEvD,YACW,SAAiB,EACT,GAAa;QADrB,cAAS,GAAT,SAAS,CAAQ;QACT,QAAG,GAAH,GAAG,CAAU;IAC7B,CAAC;IAEJ,GAAG,CAAI,GAAkB;QACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAM,CAAC;IACxC,CAAC;IAED,MAAM,CAAI,GAAkB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAkB,CAAC;IACpD,CAAC;IAED,OAAO,CAAI,GAAkB,EAAE,KAAQ;QACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,IAAW,EACX,OAA4B;QAE5B,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,EAAE,CACA,IAAW,EACX,OAA0C;QAE1C,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,+CAA+C;IAC/C,aAAa;QACX,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/event-bus.d.ts

@@ -0,0 +1,12 @@
+import type { EventHandler, Unsubscribe } from "./events.js";
+export declare class EventBus {
+    private readonly handlers;
+    on<TPayload = unknown>(event: string, handler: EventHandler<TPayload>): Unsubscribe;
+    /**
+     * Emit an event and await all handlers sequentially.
+     * Sequential await keeps plugin side-effects predictable in Phase 1.
+     */
+    emit(event: string, payload?: unknown): Promise<void>;
+    clear(): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IAEjE,EAAE,CAAC,QAAQ,GAAG,OAAO,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC9B,WAAW;IAgBd;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,KAAK,IAAI,IAAI;CAGd"}

package/dist/event-bus.js

@@ -0,0 +1,33 @@
+export class EventBus {
+    handlers = new Map();
+    on(event, handler) {
+        let set = this.handlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(event, set);
+        }
+        set.add(handler);
+        return () => {
+            set.delete(handler);
+            if (set.size === 0) {
+                this.handlers.delete(event);
+            }
+        };
+    }
+    /**
+     * Emit an event and await all handlers sequentially.
+     * Sequential await keeps plugin side-effects predictable in Phase 1.
+     */
+    async emit(event, payload) {
+        const set = this.handlers.get(event);
+        if (!set || set.size === 0)
+            return;
+        for (const handler of [...set]) {
+            await handler(payload);
+        }
+    }
+    clear() {
+        this.handlers.clear();
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAQ;IACF,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEjE,EAAE,CACA,KAAa,EACb,OAA+B;QAE/B,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAuB,CAAC,CAAC;QAEjC,OAAO,GAAG,EAAE;YACV,GAAI,CAAC,MAAM,CAAC,OAAuB,CAAC,CAAC;YACrC,IAAI,GAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,OAAiB;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAEnC,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/events.d.ts

@@ -0,0 +1,38 @@
+export type EventHandler<TPayload = unknown> = (payload: TPayload) => void | Promise<void>;
+export type Unsubscribe = () => void;
+export interface RuntimeEventMap {
+    "runtime.starting": {
+        runtimeId: string;
+    };
+    "runtime.started": {
+        runtimeId: string;
+    };
+    "runtime.stopping": {
+        runtimeId: string;
+    };
+    "runtime.stopped": {
+        runtimeId: string;
+    };
+    "plugin.setup": {
+        name: string;
+    };
+    "plugin.dispose": {
+        name: string;
+    };
+}
+export type KnownEventName = keyof RuntimeEventMap;
+export type EventPayload<TName extends string> = TName extends KnownEventName ? RuntimeEventMap[TName] : unknown;
+/**
+ * Discriminated runtime events used by emit().
+ * Built-in names are typed; custom names accept any payload.
+ */
+export type RuntimeEvent = {
+    [K in KnownEventName]: {
+        type: K;
+        payload: RuntimeEventMap[K];
+    };
+}[KnownEventName] | {
+    type: string;
+    payload?: unknown;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,QAAQ,GAAG,OAAO,IAAI,CAC7C,OAAO,EAAE,QAAQ,KACd,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,iBAAiB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,kBAAkB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,iBAAiB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,MAAM,IAC3C,KAAK,SAAS,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;KACG,CAAC,IAAI,cAAc,GAAG;QACrB,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;KAC7B;CACF,CAAC,cAAc,CAAC,GACjB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC"}

package/dist/events.js

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

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Runtime, type RuntimeOptions, type RuntimeState } from "./runtime.js";
+export { type Context, RuntimeContext } from "./context.js";
+export { type Plugin, type PluginFactory } from "./plugin.js";
+export { createServiceKey, ServiceAlreadyProvidedError, ServiceNotFoundError, type ServiceKey, } from "./service.js";
+export { EventBus } from "./event-bus.js";
+export type { EventHandler, EventPayload, KnownEventName, RuntimeEvent, RuntimeEventMap, Unsubscribe, } from "./events.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,KAAK,UAAU,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Runtime } from "./runtime.js";
+export { RuntimeContext } from "./context.js";
+export {} from "./plugin.js";
+export { createServiceKey, ServiceAlreadyProvidedError, ServiceNotFoundError, } from "./service.js";
+export { EventBus } from "./event-bus.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0C,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAgB,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAmC,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,GAErB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "./context.js";
+/**
+ * Everything is a capability — and every capability is mounted as a Plugin.
+ */
+export interface Plugin {
+    readonly name: string;
+    setup(ctx: Context): void | Promise<void>;
+    dispose?(): void | Promise<void>;
+}
+export type PluginFactory = () => Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC"}

package/dist/plugin.js

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

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":""}

package/dist/runtime.d.ts

@@ -0,0 +1,39 @@
+import { type Context } from "./context.js";
+import type { EventHandler, EventPayload, Unsubscribe } from "./events.js";
+import type { Plugin } from "./plugin.js";
+import type { ServiceKey } from "./service.js";
+export type RuntimeState = "idle" | "starting" | "running" | "stopping" | "stopped";
+export interface RuntimeOptions {
+    /** Stable id for observability; random uuid if omitted. */
+    id?: string;
+}
+/**
+ * Agent Runtime — first-class citizen.
+ *
+ * Plugins mount capabilities into a shared Context.
+ * Nothing privileged: LLM, Tools, Session, Storage are all plugins.
+ */
+export declare class Runtime {
+    readonly id: string;
+    private readonly bus;
+    private readonly plugins;
+    private readonly pluginNames;
+    private ctx;
+    private state;
+    constructor(options?: RuntimeOptions);
+    getState(): RuntimeState;
+    /**
+     * Register a plugin. Must be called before start().
+     * Duplicate names are rejected.
+     */
+    use(plugin: Plugin): this;
+    /** Runtime-level subscribe (same bus as Context). */
+    on<TName extends string>(type: TName, handler: EventHandler<EventPayload<TName>>): Unsubscribe;
+    /** Convenience: resolve a service after start. */
+    get<T>(key: ServiceKey<T>): T;
+    context(): Context;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private assertRunning;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AASD;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,KAAK,CAAwB;gBAEzB,OAAO,GAAE,cAAmB;IAKxC,QAAQ,IAAI,YAAY;IAIxB;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAczB,qDAAqD;IACrD,EAAE,CAAC,KAAK,SAAS,MAAM,EACrB,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GACzC,WAAW;IAId,kDAAkD;IAClD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;IAK7B,OAAO,IAAI,OAAO;IAIZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,OAAO,CAAC,aAAa;CAKtB"}

package/dist/runtime.js

@@ -0,0 +1,108 @@
+import { RuntimeContext } from "./context.js";
+import { EventBus } from "./event-bus.js";
+let runtimeSeq = 0;
+function nextRuntimeId() {
+    runtimeSeq += 1;
+    return `runtime_${runtimeSeq}_${Date.now().toString(36)}`;
+}
+/**
+ * Agent Runtime — first-class citizen.
+ *
+ * Plugins mount capabilities into a shared Context.
+ * Nothing privileged: LLM, Tools, Session, Storage are all plugins.
+ */
+export class Runtime {
+    id;
+    bus = new EventBus();
+    plugins = [];
+    pluginNames = new Set();
+    ctx;
+    state = "idle";
+    constructor(options = {}) {
+        this.id = options.id ?? nextRuntimeId();
+        this.ctx = new RuntimeContext(this.id, this.bus);
+    }
+    getState() {
+        return this.state;
+    }
+    /**
+     * Register a plugin. Must be called before start().
+     * Duplicate names are rejected.
+     */
+    use(plugin) {
+        if (this.state !== "idle") {
+            throw new Error(`Cannot register plugin "${plugin.name}" after runtime has started (state=${this.state})`);
+        }
+        if (this.pluginNames.has(plugin.name)) {
+            throw new Error(`Duplicate plugin name: ${plugin.name}`);
+        }
+        this.pluginNames.add(plugin.name);
+        this.plugins.push(plugin);
+        return this;
+    }
+    /** Runtime-level subscribe (same bus as Context). */
+    on(type, handler) {
+        return this.bus.on(type, handler);
+    }
+    /** Convenience: resolve a service after start. */
+    get(key) {
+        this.assertRunning();
+        return this.ctx.get(key);
+    }
+    context() {
+        return this.ctx;
+    }
+    async start() {
+        if (this.state === "running")
+            return;
+        if (this.state !== "idle" && this.state !== "stopped") {
+            throw new Error(`Cannot start runtime from state=${this.state}`);
+        }
+        // Fresh context if restarting after stop
+        if (this.state === "stopped") {
+            this.bus.clear();
+            this.ctx = new RuntimeContext(this.id, this.bus);
+        }
+        this.state = "starting";
+        await this.bus.emit("runtime.starting", { runtimeId: this.id });
+        try {
+            for (const plugin of this.plugins) {
+                await plugin.setup(this.ctx);
+                await this.bus.emit("plugin.setup", { name: plugin.name });
+            }
+        }
+        catch (err) {
+            this.state = "idle";
+            throw err;
+        }
+        this.state = "running";
+        await this.bus.emit("runtime.started", { runtimeId: this.id });
+    }
+    async stop() {
+        if (this.state === "stopped" || this.state === "idle")
+            return;
+        if (this.state !== "running") {
+            throw new Error(`Cannot stop runtime from state=${this.state}`);
+        }
+        this.state = "stopping";
+        await this.bus.emit("runtime.stopping", { runtimeId: this.id });
+        // Dispose in reverse registration order
+        for (const plugin of [...this.plugins].reverse()) {
+            if (plugin.dispose) {
+                await plugin.dispose();
+            }
+            await this.bus.emit("plugin.dispose", { name: plugin.name });
+        }
+        this.ctx.clearServices();
+        this.state = "stopped";
+        await this.bus.emit("runtime.stopped", { runtimeId: this.id });
+        // Clear after stopped so observers can still hear the final event.
+        this.bus.clear();
+    }
+    assertRunning() {
+        if (this.state !== "running") {
+            throw new Error(`Runtime is not running (state=${this.state})`);
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Typed service keys. Plugins provide/consume capabilities without importing each other.
+ *
+ *   const LLM = createServiceKey<LLMService>("llm");
+ *   ctx.provide(LLM, impl);
+ *   const llm = ctx.get(LLM);
+ */
+export interface ServiceKey<T> {
+    readonly id: string;
+    readonly __type?: T;
+}
+export declare function createServiceKey<T>(id: string): ServiceKey<T>;
+export declare class ServiceNotFoundError extends Error {
+    readonly keyId: string;
+    constructor(keyId: string);
+}
+export declare class ServiceAlreadyProvidedError extends Error {
+    readonly keyId: string;
+    constructor(keyId: string);
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAE7D;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAInC;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAInC"}

package/dist/service.js

@@ -0,0 +1,20 @@
+export function createServiceKey(id) {
+    return { id };
+}
+export class ServiceNotFoundError extends Error {
+    keyId;
+    constructor(keyId) {
+        super(`Service not found: ${keyId}`);
+        this.keyId = keyId;
+        this.name = "ServiceNotFoundError";
+    }
+}
+export class ServiceAlreadyProvidedError extends Error {
+    keyId;
+    constructor(keyId) {
+        super(`Service already provided: ${keyId}`);
+        this.keyId = keyId;
+        this.name = "ServiceAlreadyProvidedError";
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,gBAAgB,CAAI,EAAU;IAC5C,OAAO,EAAE,EAAE,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACxB;IAArB,YAAqB,KAAa;QAChC,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;QADlB,UAAK,GAAL,KAAK,CAAQ;QAEhC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC/B;IAArB,YAAqB,KAAa;QAChC,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;QADzB,UAAK,GAAL,KAAK,CAAQ;QAEhC,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@typescript-agent-harness/core",
+  "version": "0.15.0",
+  "description": "Agent Runtime core: Runtime, Plugin, Context, Service, EventBus",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MichaelVendor/typescript-agent-harness.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://MichaelVendor.github.io/typescript-agent-harness/",
+  "bugs": {
+    "url": "https://github.com/MichaelVendor/typescript-agent-harness/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test --experimental-strip-types test/*.test.ts"
+  }
+}