kadi-harness-runtime 0.1.8

package/dist/runtime.d.ts

@@ -0,0 +1,96 @@
+import { type HarnessAdapter, type HarnessEvent, type HarnessServices, type RunHandle, type RunInput, type RunRequest, type RunResult, type ScheduleCreateRequest, type ScheduleReference, type ScopedSchedulingService, type ServiceCapabilities } from "@kadi.build/kadi-harness-contracts";
+import type { RuntimeClient, RuntimeForkOptions, RuntimeHealth, RuntimeObserveOptions, RuntimeResumeOptions, RuntimeSessionQuery, RuntimeSessionSummary } from "./index.js";
+import { AdapterLoader, type AdapterLoaderOptions, type AdapterPackageSource } from "./adapter-loader.js";
+import { EventBus } from "./event-bus.js";
+import { type AuthorizationPolicy } from "./gateways/authorization.js";
+import { type ArtifactBackend } from "./gateways/artifacts.js";
+import { type SessionStateBackend } from "./gateways/sessions.js";
+import { type ToolRouterBackend } from "./gateways/tools.js";
+import { AdapterRegistry } from "./registry.js";
+import { RunCoordinator, type RunContextFactory, type RunCoordinatorOptions, type RunEventHandler, type RunStatusHandler } from "./run-coordinator.js";
+import { ScheduleGateway } from "./runner/runner-service.js";
+export interface RuntimeServiceFactoryInput {
+    readonly request: RunRequest;
+    readonly handle: RunHandle;
+    readonly correlationId: string;
+    readonly adapter: HarnessAdapter["identity"];
+    readonly signal: AbortSignal;
+}
+export type RuntimeServicesFactory = (input: RuntimeServiceFactoryInput) => HarnessServices | Promise<HarnessServices>;
+export interface RuntimeServiceBackends {
+    readonly tools?: ToolRouterBackend;
+    readonly sessions?: SessionStateBackend;
+    readonly artifacts?: ArtifactBackend;
+    readonly scheduling?: ScopedSchedulingService;
+    readonly authorizationPolicy?: AuthorizationPolicy;
+}
+export interface KadiRuntimeOptions {
+    readonly contractVersion?: string;
+    readonly registry?: AdapterRegistry;
+    readonly adapters?: readonly HarnessAdapter[];
+    readonly adapterPackages?: readonly (string | AdapterPackageSource)[];
+    readonly adapterLoader?: AdapterLoader;
+    readonly adapterLoaderOptions?: Omit<AdapterLoaderOptions, "packages">;
+    readonly eventBus?: EventBus;
+    readonly services?: RuntimeServiceBackends;
+    readonly servicesFactory?: RuntimeServicesFactory;
+    readonly contextFactory?: RunContextFactory;
+    readonly coordinator?: RunCoordinator;
+    readonly coordinatorOptions?: Omit<RunCoordinatorOptions, "registry" | "contextFactory" | "onEvent" | "onStatus">;
+    readonly scheduleGateway?: Pick<ScheduleGateway, "schedule" | "unschedule">;
+    readonly steer?: (runId: string, input: RunInput) => Promise<void>;
+    readonly onEvent?: RunEventHandler;
+    readonly onStatus?: RunStatusHandler;
+}
+/** Composes scoped KADI service gateways for each adapter run. */
+export declare class RuntimeServiceFacade {
+    private readonly backends;
+    private readonly eventBus;
+    private readonly contractVersion;
+    constructor(options: RuntimeServiceBackends & {
+        readonly eventBus: EventBus;
+        readonly contractVersion: string;
+    });
+    get capabilities(): ServiceCapabilities;
+    create(input: RuntimeServiceFactoryInput): Promise<HarnessServices>;
+}
+/** Concrete frontend-neutral KADI runtime assembled from explicit dependencies. */
+export declare class KadiRuntime implements RuntimeClient {
+    private readonly coordinator;
+    private readonly registry;
+    private readonly eventBus;
+    private readonly facade;
+    private readonly scheduleGateway;
+    private readonly steerHandler;
+    private readonly contractVersion;
+    private readonly requests;
+    private readonly summaries;
+    private readonly events;
+    constructor(options: {
+        readonly registry: AdapterRegistry;
+        readonly eventBus: EventBus;
+        readonly coordinator: RunCoordinator;
+        readonly facade?: RuntimeServiceFacade;
+        readonly contractVersion: string;
+        readonly scheduleGateway?: Pick<ScheduleGateway, "schedule" | "unschedule">;
+        readonly steer?: KadiRuntimeOptions["steer"];
+    });
+    execute(request: RunRequest): Promise<RunHandle>;
+    observe(runId: string, options?: RuntimeObserveOptions): AsyncIterable<HarnessEvent>;
+    getRun(runId: string): Promise<RunHandle | RunResult>;
+    cancel(runId: string, request?: Parameters<RunCoordinator["cancel"]>[1]): Promise<void>;
+    steer(runId: string, input: RunInput): Promise<void>;
+    resume(sessionId: string, options?: RuntimeResumeOptions): Promise<RunHandle>;
+    fork(runId: string, options?: RuntimeForkOptions): Promise<RunHandle>;
+    listSessions(query?: RuntimeSessionQuery): Promise<readonly RuntimeSessionSummary[]>;
+    getSessionTimeline(sessionId: string, _options?: RuntimeObserveOptions): AsyncIterable<HarnessEvent>;
+    schedule(request: ScheduleCreateRequest): Promise<ScheduleReference>;
+    unschedule(scheduleId: string): Promise<void>;
+    listAdapters(): Promise<readonly HarnessAdapter["identity"][]>;
+    health(): Promise<RuntimeHealth>;
+    waitForResult(runId: string): Promise<RunResult>;
+    recordEvent(event: HarnessEvent): void;
+    recordStatus(handle: RunHandle): void;
+}
+export declare function createKadiRuntime(options?: KadiRuntimeOptions): Promise<KadiRuntime>;
+//# 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,EAIL,KAAK,cAAc,EAEnB,KAAK,YAAY,EACjB,KAAK,eAAe,EAKpB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAIzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAC5K,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC1G,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAA8B,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACnG,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAwC,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvJ,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,KAAK,EAAE,0BAA0B,KAC9B,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CACpD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,oBAAoB,CAAC,EAAE,CAAC;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,GAAG,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;IAClH,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CACtC;AA2FD,kEAAkE;AAClE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAEtB,OAAO,EAAE,sBAAsB,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IAWtH,IAAW,YAAY,IAAI,mBAAmB,CAE7C;IAEY,MAAM,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC;CAmDjF;AAED,mFAAmF;AACnF,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA+D;IAC/F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAEzC,OAAO,EAAE;QAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;QACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;QACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;QACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;QAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;KAC9C;IAUY,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAOtD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAAC,YAAY,CAAC;IAIxF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAIrD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,SAAS,CAAC;IAWjF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC;IAUzE,YAAY,CAAC,KAAK,GAAE,mBAAwB,GAAG,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC;IAK9F,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,qBAA0B,GAAG,aAAa,CAAC,YAAY,CAAC;IAOlG,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKpE,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,YAAY,IAAI,OAAO,CAAC,SAAS,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;IAI9D,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAoBtC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIhD,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMtC,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAS7C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8C9F"}

package/dist/runtime.js

@@ -0,0 +1,330 @@
+import { CONTRACT_VERSION, } from "@kadi.build/kadi-harness-contracts";
+import { AdapterLoader } from "./adapter-loader.js";
+import { EventBus } from "./event-bus.js";
+import { createAuthorizationGateway } from "./gateways/authorization.js";
+import { createArtifactGateway } from "./gateways/artifacts.js";
+import { createEventGateway } from "./gateways/events.js";
+import { createSessionGateway } from "./gateways/sessions.js";
+import { createToolGateway } from "./gateways/tools.js";
+import { AdapterRegistry } from "./registry.js";
+import { RunCoordinator } from "./run-coordinator.js";
+function error(code, category, message, details) {
+    const value = { code, category, message, retryable: false, ...(details === undefined ? {} : { details }) };
+    return Object.assign(new Error(message), { error: value });
+}
+function unsupported(operation) {
+    return {
+        ok: false,
+        error: {
+            code: "service_unavailable",
+            category: "service_failure",
+            message: `${operation} is not configured for this runtime`,
+            retryable: false,
+        },
+    };
+}
+class MemorySessionBackend {
+    snapshots = new Map();
+    timeline = new Map();
+    save(_scope, snapshot) {
+        this.snapshots.set(snapshot.sessionId, snapshot);
+    }
+    load(_scope, sessionId) {
+        return this.snapshots.get(sessionId);
+    }
+    appendTimeline(scope, entry) {
+        const entries = this.timeline.get(scope.sessionId) ?? [];
+        entries.push(entry);
+        this.timeline.set(scope.sessionId, entries);
+    }
+}
+class MemoryArtifactBackend {
+    values = new Map();
+    sequence = 0;
+    put(scope, request) {
+        const id = `artifact-${scope.runId}-${++this.sequence}`;
+        const reference = {
+            id,
+            kind: request.kind,
+            ...(request.name === undefined ? {} : { name: request.name }),
+            createdAt: new Date().toISOString(),
+        };
+        const value = { reference, ...(request.content === undefined ? {} : { content: request.content }) };
+        this.values.set(id, value);
+        return value;
+    }
+    get(_scope, reference) {
+        return this.values.get(reference.id);
+    }
+    list(_scope) {
+        return [...this.values.values()].map((value) => value.reference);
+    }
+}
+const EMPTY_TOOLS = {
+    getAvailableTools: () => [],
+    route: async () => ({
+        code: "tools_unavailable",
+        category: "service_failure",
+        message: "No tool router is configured for this runtime",
+        retryable: false,
+    }),
+};
+const EMPTY_SCHEDULING = {
+    create: async () => unsupported("scheduling.create"),
+    get: async () => unsupported("scheduling.get"),
+    cancel: async () => unsupported("scheduling.cancel"),
+};
+function capabilities(services) {
+    return {
+        tools: { available: services.tools !== undefined, operations: ["list", "invoke"], scopes: ["run"] },
+        events: { available: true, operations: ["publish", "subscribe"], scopes: ["run"] },
+        authorization: { available: true, operations: ["check"], scopes: ["run"] },
+        sessions: { available: services.sessions !== undefined, operations: ["load", "save", "appendTimeline"], scopes: ["session"] },
+        artifacts: { available: services.artifacts !== undefined, operations: ["put", "get", "list"], scopes: ["run"] },
+        scheduling: { available: services.scheduling !== undefined, operations: ["create", "get", "cancel"], scopes: ["session"] },
+    };
+}
+/** Composes scoped KADI service gateways for each adapter run. */
+export class RuntimeServiceFacade {
+    backends;
+    eventBus;
+    contractVersion;
+    constructor(options) {
+        this.backends = {
+            ...options,
+            tools: options.tools ?? EMPTY_TOOLS,
+            sessions: options.sessions ?? new MemorySessionBackend(),
+            artifacts: options.artifacts ?? new MemoryArtifactBackend(),
+        };
+        this.eventBus = options.eventBus;
+        this.contractVersion = options.contractVersion;
+    }
+    get capabilities() {
+        return capabilities(this.backends);
+    }
+    async create(input) {
+        const scope = {
+            adapterId: input.adapter.id,
+            contractVersion: this.contractVersion,
+            correlationId: input.correlationId,
+            runId: input.handle.runId,
+            sessionId: input.handle.sessionId,
+            signal: input.signal,
+        };
+        const authorization = createAuthorizationGateway({
+            scope,
+            principal: input.request.principal,
+            policy: this.backends.authorizationPolicy,
+        });
+        const authorize = async (request) => {
+            const result = await authorization.check({
+                action: request.operation,
+                ...(request.toolName === undefined ? {} : { resource: request.toolName }),
+                ...(request.eventType === undefined ? {} : { metadata: { eventType: request.eventType } }),
+            });
+            if (!result.ok)
+                return result;
+            if (result.value.allowed)
+                return true;
+            return {
+                ok: false,
+                error: {
+                    code: "authorization_denied",
+                    category: "authorization",
+                    message: result.value.reason ?? `Authorization denied for ${request.operation}`,
+                    retryable: false,
+                    correlationId: input.correlationId,
+                },
+            };
+        };
+        const eventBackend = {
+            publish: (event) => this.eventBus.publish(event),
+            subscribe: (runId, options) => this.eventBus.subscribe(runId, options),
+        };
+        const tools = createToolGateway({ scope, router: this.backends.tools ?? EMPTY_TOOLS, authorize });
+        const events = createEventGateway({ scope, backend: eventBackend, authorize });
+        const sessions = createSessionGateway({ scope, backend: this.backends.sessions, authorize });
+        const artifacts = createArtifactGateway({ scope, backend: this.backends.artifacts, authorize });
+        return {
+            capabilities: this.capabilities,
+            tools,
+            events,
+            authorization,
+            sessions,
+            artifacts,
+            scheduling: this.backends.scheduling ?? EMPTY_SCHEDULING,
+        };
+    }
+}
+/** Concrete frontend-neutral KADI runtime assembled from explicit dependencies. */
+export class KadiRuntime {
+    coordinator;
+    registry;
+    eventBus;
+    facade;
+    scheduleGateway;
+    steerHandler;
+    contractVersion;
+    requests = new Map();
+    summaries = new Map();
+    events = new Map();
+    constructor(options) {
+        this.registry = options.registry;
+        this.eventBus = options.eventBus;
+        this.coordinator = options.coordinator;
+        this.facade = options.facade;
+        this.contractVersion = options.contractVersion;
+        this.scheduleGateway = options.scheduleGateway;
+        this.steerHandler = options.steer;
+    }
+    async execute(request) {
+        const handle = await this.coordinator.execute(request);
+        this.requests.set(handle.runId, request);
+        this.summaries.set(handle.sessionId, { sessionId: handle.sessionId, latestRunId: handle.runId, status: handle.status, metadata: request.input.metadata });
+        return handle;
+    }
+    observe(runId, options = {}) {
+        return this.eventBus.observe(runId, options);
+    }
+    getRun(runId) {
+        return this.coordinator.getRun(runId);
+    }
+    cancel(runId, request) {
+        return this.coordinator.cancel(runId, request);
+    }
+    async steer(runId, input) {
+        if (!this.steerHandler)
+            throw error("steering_unavailable", "unsupported_capability", `Steering is not configured for run '${runId}'`);
+        await this.steerHandler(runId, input);
+    }
+    async resume(sessionId, options = {}) {
+        const runId = options.runId ?? this.summaries.get(sessionId)?.latestRunId;
+        const previous = runId === undefined ? undefined : this.requests.get(runId);
+        if (!previous)
+            throw error("session_not_found", "validation", `No resumable run was found for session '${sessionId}'`);
+        return this.execute({
+            ...previous,
+            session: { id: sessionId, mode: "resume" },
+            input: { ...previous.input, ...(options.metadata === undefined ? {} : { metadata: options.metadata }) },
+        });
+    }
+    async fork(runId, options = {}) {
+        const previous = this.requests.get(runId);
+        if (!previous)
+            throw error("run_not_found", "validation", `Run '${runId}' is not available for forking`);
+        return this.execute({
+            ...previous,
+            session: { mode: "fork", parentRunId: runId },
+            input: options.input ?? previous.input,
+        });
+    }
+    async listSessions(query = {}) {
+        const limit = query.limit ?? 100;
+        return [...this.summaries.values()].sort((left, right) => left.sessionId.localeCompare(right.sessionId)).slice(0, limit);
+    }
+    getSessionTimeline(sessionId, _options = {}) {
+        const events = [...(this.events.get(sessionId) ?? [])];
+        return (async function* timeline() {
+            for (const event of events)
+                yield event;
+        })();
+    }
+    async schedule(request) {
+        if (!this.scheduleGateway)
+            throw error("scheduling_unavailable", "service_failure", "Scheduling is not configured for this runtime");
+        return this.scheduleGateway.schedule(request);
+    }
+    async unschedule(scheduleId) {
+        if (!this.scheduleGateway)
+            throw error("scheduling_unavailable", "service_failure", "Scheduling is not configured for this runtime");
+        await this.scheduleGateway.unschedule(scheduleId);
+    }
+    async listAdapters() {
+        return this.registry.list().map((descriptor) => descriptor.identity);
+    }
+    async health() {
+        const descriptors = this.registry.list();
+        const unavailable = descriptors.filter((descriptor) => descriptor.status !== "available").length;
+        const serviceCapabilities = this.facade?.capabilities ?? {
+            tools: { available: false, operations: [], scopes: [] },
+            events: { available: true, operations: ["publish", "subscribe"], scopes: ["run"] },
+            authorization: { available: true, operations: ["check"], scopes: ["run"] },
+            sessions: { available: false, operations: [], scopes: [] },
+            artifacts: { available: false, operations: [], scopes: [] },
+            scheduling: { available: false, operations: [], scopes: [] },
+        };
+        return {
+            status: descriptors.length === 0 ? "unavailable" : unavailable === 0 ? "healthy" : "degraded",
+            contractVersion: this.contractVersion,
+            adapterCount: descriptors.filter((descriptor) => descriptor.status === "available").length,
+            services: serviceCapabilities,
+            details: { unavailableAdapters: unavailable },
+        };
+    }
+    waitForResult(runId) {
+        return this.coordinator.waitForResult(runId);
+    }
+    recordEvent(event) {
+        const entries = this.events.get(event.sessionId) ?? [];
+        entries.push(event);
+        this.events.set(event.sessionId, entries);
+    }
+    recordStatus(handle) {
+        const existing = this.summaries.get(handle.sessionId);
+        this.summaries.set(handle.sessionId, {
+            sessionId: handle.sessionId,
+            latestRunId: handle.runId,
+            status: handle.status,
+            ...(existing?.metadata === undefined ? {} : { metadata: existing.metadata }),
+        });
+    }
+}
+export async function createKadiRuntime(options = {}) {
+    const contractVersion = options.contractVersion ?? CONTRACT_VERSION;
+    const registry = options.registry ?? new AdapterRegistry({ contractVersion });
+    for (const adapter of options.adapters ?? [])
+        registry.register(adapter, "explicit");
+    if (options.adapterPackages && options.adapterPackages.length > 0) {
+        const loader = options.adapterLoader ?? new AdapterLoader({ packages: options.adapterPackages, ...options.adapterLoaderOptions });
+        await registry.discover(loader);
+    }
+    const eventBus = options.eventBus ?? new EventBus({ contractVersion });
+    const services = options.services ?? {};
+    const facade = options.servicesFactory ? undefined : new RuntimeServiceFacade({ ...services, eventBus, contractVersion });
+    const contextFactory = options.contextFactory ?? (async (input) => {
+        const serviceSet = options.servicesFactory
+            ? await options.servicesFactory(input)
+            : await facade.create(input);
+        const context = {
+            contractVersion,
+            correlationId: input.correlationId,
+            principal: input.request.principal,
+            sessionId: input.handle.sessionId,
+            runId: input.handle.runId,
+            ...(input.request.workspace === undefined ? {} : { workspace: input.request.workspace }),
+            signal: input.signal,
+            ...serviceSet,
+        };
+        return context;
+    });
+    let runtime;
+    const onEvent = async (event, handle) => {
+        runtime.recordEvent(event);
+        await eventBus.publish(event);
+        await options.onEvent?.(event, handle);
+    };
+    const onStatus = async (handle) => {
+        runtime.recordStatus(handle);
+        await options.onStatus?.(handle);
+    };
+    const coordinator = options.coordinator ?? new RunCoordinator({
+        ...options.coordinatorOptions,
+        registry,
+        contextFactory,
+        onEvent,
+        onStatus,
+    });
+    runtime = new KadiRuntime({ registry, eventBus, coordinator, facade, contractVersion, scheduleGateway: options.scheduleGateway, steer: options.steer });
+    return runtime;
+}
+//# 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/scheduling/request-store.d.ts

@@ -0,0 +1,71 @@
+import { type RunRequest, type ScheduleTrigger } from "@kadi.build/kadi-harness-contracts";
+/** Maximum size of the serialized request kept in the request store. */
+export declare const MAX_REQUEST_PAYLOAD_BYTES: number;
+export interface ScheduledRunSpec {
+    readonly scheduleId?: string;
+    readonly trigger: ScheduleTrigger;
+    readonly run: RunRequest;
+    readonly idempotencyPrefix: string;
+    readonly retry?: {
+        readonly count: number;
+        readonly delay?: string;
+    };
+    readonly concurrency?: "skip" | "queue" | "allow";
+}
+export interface StoredScheduledRequest {
+    readonly requestRef: string;
+    readonly canonicalPayload: string;
+    readonly payloadDigest: string;
+    readonly spec: ScheduledRunSpec;
+    readonly createdAt: string;
+}
+export interface RequestStorePutOptions {
+    readonly requestRef?: string;
+    readonly createdAt?: Date;
+}
+export interface ScheduledRequestStore {
+    put(spec: ScheduledRunSpec, options?: RequestStorePutOptions): Promise<StoredScheduledRequest>;
+    get(requestRef: string): Promise<StoredScheduledRequest | undefined>;
+}
+export declare class ScheduledRequestStoreError extends Error {
+    readonly code: "invalid_request" | "request_too_large" | "sensitive_data";
+    constructor(code: "invalid_request" | "request_too_large" | "sensitive_data", message: string);
+}
+/**
+ * Serialize JSON with recursively sorted object keys. This produces the same
+ * bytes across processes and languages for the same scheduled request.
+ */
+export declare function canonicalizeJson(value: unknown): string;
+export declare function sha256Digest(canonicalPayload: string): string;
+/** In-memory reference store used by tests and embedders that provide a durable wrapper. */
+export declare class InMemoryScheduledRequestStore implements ScheduledRequestStore {
+    private readonly records;
+    private readonly refFactory;
+    private readonly clock;
+    constructor(options?: {
+        readonly refFactory?: () => string;
+        readonly clock?: () => Date;
+    });
+    put(spec: ScheduledRunSpec, options?: RequestStorePutOptions): Promise<StoredScheduledRequest>;
+    get(requestRef: string): Promise<StoredScheduledRequest | undefined>;
+}
+export interface FileScheduledRequestStoreOptions {
+    readonly directory: string;
+    readonly refFactory?: () => string;
+    readonly clock?: () => Date;
+}
+/**
+ * Small durable request store for a runner host. Deployments can replace this
+ * with an encrypted KADI artifact/database implementation without changing
+ * signing or verification.
+ */
+export declare class FileScheduledRequestStore implements ScheduledRequestStore {
+    private readonly directory;
+    private readonly refFactory;
+    private readonly clock;
+    constructor(options: FileScheduledRequestStoreOptions);
+    put(spec: ScheduledRunSpec, options?: RequestStorePutOptions): Promise<StoredScheduledRequest>;
+    get(requestRef: string): Promise<StoredScheduledRequest | undefined>;
+    private pathFor;
+}
+//# sourceMappingURL=request-store.d.ts.map

package/dist/scheduling/request-store.d.ts.map

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