@mono-agent/observability 0.1.0

package/dist/trace-sources.js

@@ -0,0 +1,348 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { DEFAULT_MAX_EVENTS_PER_RUN, DEFAULT_MAX_STRING_BYTES, errorMessage, isErrno, isRecord, mkdir, minInteger, normalizeRunId as normalizeRunIdGuard, positiveInteger, safeJoin as safeJoinGuard, stringField, writeJsonAtomic, } from "./artifact-fs.js";
+import { listRecordedRuns, readRecordedRun } from "./recorded-runs.js";
+import { redactJsonValue } from "./recorder.js";
+const DEFAULT_STALE_AFTER_MS = 30_000;
+const MANIFEST_SUFFIX = ".json";
+const SOURCE_ID_PATTERN = /^[A-Za-z0-9._-]+$/u;
+const DEFAULT_MAX_RUNS = 100;
+export class TraceSourceRegistryError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "TraceSourceRegistryError";
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+export async function registerTraceSource(options) {
+    const normalized = normalizeRegistryOptions(options);
+    const sourceId = normalizeSourceId(options.sourceId ?? sourceIdFromLabel(options.label));
+    const label = normalizeNonEmpty(options.label, "label");
+    const artifactDir = resolvePath(options.artifactDir, "artifactDir");
+    const startedAt = options.startedAt ?? isoNow(normalized.clock);
+    let manifest = buildManifest({
+        sourceId,
+        label,
+        artifactDir,
+        status: options.status ?? "running",
+        startedAt,
+        updatedAt: isoNow(normalized.clock),
+        ...(options.pid === undefined ? {} : { pid: options.pid }),
+        ...(options.transports === undefined ? {} : { transports: options.transports }),
+        ...(options.configPath === undefined ? {} : { configPath: options.configPath }),
+        ...(options.metadata === undefined ? {} : { metadata: options.metadata }),
+    });
+    await writeManifest(normalized.registryDir, manifest);
+    let heartbeatTimer;
+    const heartbeatMs = options.heartbeatMs;
+    const writePatch = async (patch) => {
+        manifest = buildManifest({
+            ...manifest,
+            ...patch,
+            updatedAt: isoNow(normalized.clock),
+        });
+        await writeManifest(normalized.registryDir, manifest);
+        return manifest;
+    };
+    if (heartbeatMs !== undefined) {
+        if (!Number.isInteger(heartbeatMs) || heartbeatMs < 250) {
+            throw new TraceSourceRegistryError("invalid_registry_options", "heartbeatMs must be an integer of at least 250.", {
+                field: "heartbeatMs",
+            });
+        }
+        heartbeatTimer = setInterval(() => {
+            void writePatch({});
+        }, heartbeatMs);
+        heartbeatTimer.unref?.();
+    }
+    return {
+        get manifest() {
+            return manifest;
+        },
+        update: writePatch,
+        async heartbeat() {
+            return await writePatch({});
+        },
+        async stop(patch = {}) {
+            if (heartbeatTimer !== undefined) {
+                clearInterval(heartbeatTimer);
+                heartbeatTimer = undefined;
+            }
+            return await writePatch({ ...patch, status: patch.status ?? "stopped" });
+        },
+    };
+}
+export async function listTraceSources(options) {
+    const normalized = normalizeRegistryOptions(options);
+    const { manifests, warnings } = await readManifestFiles(normalized);
+    return {
+        registryDir: normalized.registryDir,
+        sources: manifests.map((manifest) => toListItem(manifest, normalized)).sort(compareSources),
+        warnings,
+    };
+}
+export async function listTraceRuns(options) {
+    const normalized = normalizeRunListOptions(options);
+    const sourceResult = await listTraceSources(normalized);
+    const warnings = [...sourceResult.warnings];
+    const runs = [];
+    for (const source of sourceResult.sources) {
+        if (!(await artifactDirExists(source.artifactDir))) {
+            warnings.push(`Source ${source.sourceId} artifact directory is missing: ${source.artifactDir}.`);
+            continue;
+        }
+        const result = await listRecordedRuns(readerOptionsForSource(source.artifactDir, normalized));
+        warnings.push(...result.warnings.map((warning) => `Source ${source.sourceId}: ${warning}`));
+        for (const run of result.runs) {
+            runs.push({ ...run, source });
+        }
+    }
+    return {
+        registryDir: normalized.registryDir,
+        sources: sourceResult.sources,
+        runs: runs
+            .sort(compareTraceRuns)
+            .slice(0, normalized.maxRuns),
+        warnings,
+    };
+}
+export async function readTraceRun(options, sourceId, runId) {
+    const normalized = normalizeRunListOptions(options);
+    const normalizedSourceId = normalizeSourceId(sourceId);
+    normalizeRunId(runId);
+    const sourceResult = await listTraceSources(normalized);
+    const source = sourceResult.sources.find((entry) => entry.sourceId === normalizedSourceId);
+    if (source === undefined) {
+        return undefined;
+    }
+    const run = await readRecordedRun(readerOptionsForSource(source.artifactDir, normalized), runId);
+    return run === undefined ? undefined : { source, run };
+}
+function buildManifest(input) {
+    return {
+        schema: "agent-runtime.trace-source.v1",
+        sourceId: normalizeSourceId(input.sourceId),
+        label: normalizeNonEmpty(input.label, "label"),
+        artifactDir: resolvePath(input.artifactDir, "artifactDir"),
+        ...(input.pid === undefined ? {} : { pid: input.pid }),
+        status: input.status,
+        startedAt: input.startedAt,
+        updatedAt: input.updatedAt,
+        ...(input.transports === undefined ? {} : { transports: input.transports.map((transport) => transport.trim()).filter(Boolean) }),
+        ...(input.configPath === undefined ? {} : { configPath: resolve(input.configPath) }),
+        ...(input.metadata === undefined ? {} : { metadata: redactJsonValue(input.metadata) }),
+    };
+}
+async function readManifestFiles(normalized) {
+    let entries;
+    try {
+        entries = await readdir(normalized.registryDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT")) {
+            return { manifests: [], warnings: [] };
+        }
+        return { manifests: [], warnings: [`Unable to read trace registry: ${errorMessage(error)}.`] };
+    }
+    const manifests = [];
+    const warnings = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith(MANIFEST_SUFFIX)) {
+            continue;
+        }
+        const path = safeJoin(normalized.registryDir, entry.name);
+        try {
+            const raw = await readFile(path, "utf8");
+            const parsed = JSON.parse(raw);
+            const manifest = coerceManifest(parsed, entry.name, warnings);
+            if (manifest !== undefined) {
+                manifests.push(manifest);
+            }
+        }
+        catch (error) {
+            warnings.push(`Skipping ${entry.name}: invalid JSON (${errorMessage(error)}).`);
+        }
+    }
+    return { manifests, warnings };
+}
+function coerceManifest(value, fileName, warnings) {
+    if (!isRecord(value)) {
+        warnings.push(`Skipping ${fileName}: manifest is not an object.`);
+        return undefined;
+    }
+    if (value.schema !== "agent-runtime.trace-source.v1") {
+        warnings.push(`Skipping ${fileName}: manifest schema is not agent-runtime.trace-source.v1.`);
+        return undefined;
+    }
+    const sourceId = stringField(value, "sourceId");
+    const label = stringField(value, "label");
+    const artifactDir = stringField(value, "artifactDir");
+    const status = sourceStatus(value.status);
+    const startedAt = stringField(value, "startedAt");
+    const updatedAt = stringField(value, "updatedAt");
+    if (sourceId === undefined ||
+        label === undefined ||
+        artifactDir === undefined ||
+        status === undefined ||
+        startedAt === undefined ||
+        updatedAt === undefined) {
+        warnings.push(`Skipping ${fileName}: manifest is missing required source metadata.`);
+        return undefined;
+    }
+    try {
+        const pid = typeof value.pid === "number" && Number.isInteger(value.pid) ? value.pid : undefined;
+        const transports = Array.isArray(value.transports) ? value.transports.filter((item) => typeof item === "string") : undefined;
+        const configPath = stringField(value, "configPath");
+        const metadata = isRecord(value.metadata) ? value.metadata : undefined;
+        return buildManifest({
+            sourceId,
+            label,
+            artifactDir,
+            status,
+            startedAt,
+            updatedAt,
+            ...(pid === undefined ? {} : { pid }),
+            ...(transports === undefined ? {} : { transports }),
+            ...(configPath === undefined ? {} : { configPath }),
+            ...(metadata === undefined ? {} : { metadata }),
+        });
+    }
+    catch (error) {
+        warnings.push(`Skipping ${fileName}: ${errorMessage(error)}.`);
+        return undefined;
+    }
+}
+function toListItem(manifest, normalized) {
+    const warnings = [];
+    const updatedAtMs = Date.parse(manifest.updatedAt);
+    const stale = manifest.status === "running" &&
+        Number.isFinite(updatedAtMs) &&
+        normalized.clock() - updatedAtMs > normalized.staleAfterMs;
+    if (stale) {
+        warnings.push(`Source ${manifest.sourceId} heartbeat is stale.`);
+    }
+    const health = manifest.status === "failed"
+        ? "failed"
+        : manifest.status === "stopped"
+            ? "stopped"
+            : stale
+                ? "stale"
+                : "running";
+    return { ...manifest, health, warnings };
+}
+async function writeManifest(registryDir, manifest) {
+    try {
+        await mkdir(registryDir, { recursive: true });
+        const path = manifestPath(registryDir, manifest.sourceId);
+        await writeJsonAtomic(path, `${JSON.stringify(manifest, null, 2)}\n`);
+    }
+    catch (error) {
+        throw new TraceSourceRegistryError("manifest_write_failed", "Unable to write trace source manifest.", {
+            cause: errorMessage(error),
+        });
+    }
+}
+function manifestPath(registryDir, sourceId) {
+    return safeJoin(registryDir, `${normalizeSourceId(sourceId)}${MANIFEST_SUFFIX}`);
+}
+function raiseRegistryOption(message, field) {
+    throw new TraceSourceRegistryError("invalid_registry_options", message, { field });
+}
+function normalizeRunListOptions(options) {
+    return {
+        ...normalizeRegistryOptions(options),
+        maxRuns: positiveInteger(options.maxRuns, DEFAULT_MAX_RUNS, "maxRuns", raiseRegistryOption),
+        maxEventsPerRun: positiveInteger(options.maxEventsPerRun, DEFAULT_MAX_EVENTS_PER_RUN, "maxEventsPerRun", raiseRegistryOption),
+        maxStringBytes: minInteger(options.maxStringBytes, DEFAULT_MAX_STRING_BYTES, 64, "maxStringBytes", raiseRegistryOption),
+    };
+}
+function normalizeRegistryOptions(options) {
+    if (typeof options.registryDir !== "string" || options.registryDir.trim().length === 0) {
+        throw new TraceSourceRegistryError("invalid_registry_options", "registryDir must be a non-empty path.");
+    }
+    return {
+        registryDir: resolve(options.registryDir),
+        staleAfterMs: positiveInteger(options.staleAfterMs, DEFAULT_STALE_AFTER_MS, "staleAfterMs", raiseRegistryOption),
+        clock: options.clock ?? (() => Date.now()),
+    };
+}
+function readerOptionsForSource(artifactDir, options) {
+    return {
+        artifactDir,
+        maxRuns: options.maxRuns,
+        maxEventsPerRun: options.maxEventsPerRun,
+        maxStringBytes: options.maxStringBytes,
+    };
+}
+function normalizeSourceId(sourceId) {
+    const normalized = normalizeNonEmpty(sourceId, "sourceId");
+    if (!SOURCE_ID_PATTERN.test(normalized) || normalized.includes("..")) {
+        throw new TraceSourceRegistryError("invalid_source_id", "sourceId must contain only letters, numbers, dot, underscore, or hyphen and cannot contain '..'.");
+    }
+    return normalized;
+}
+function normalizeRunId(runId) {
+    return normalizeRunIdGuard(runId, (message) => {
+        throw new TraceSourceRegistryError("invalid_run_id", message);
+    }, () => {
+        throw new TraceSourceRegistryError("invalid_registry_options", "runId must be a non-empty string.", { field: "runId" });
+    });
+}
+function sourceIdFromLabel(label) {
+    return label.trim().toLowerCase().replace(/[^a-z0-9._-]+/gu, "-").replace(/^-+|-+$/gu, "") || "source";
+}
+function sourceStatus(value) {
+    return value === "running" || value === "stopped" || value === "failed" ? value : undefined;
+}
+function compareSources(a, b) {
+    const byUpdated = Date.parse(b.updatedAt) - Date.parse(a.updatedAt);
+    return byUpdated === 0 ? a.sourceId.localeCompare(b.sourceId) : byUpdated;
+}
+function runUpdatedAtMs(run) {
+    const parsed = Date.parse(run.updatedAt);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function compareTraceRuns(a, b) {
+    const byUpdated = runUpdatedAtMs(b) - runUpdatedAtMs(a);
+    if (byUpdated !== 0) {
+        return byUpdated;
+    }
+    const bySource = b.source.sourceId.localeCompare(a.source.sourceId);
+    if (bySource !== 0) {
+        return bySource;
+    }
+    return b.runId.localeCompare(a.runId);
+}
+async function artifactDirExists(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory();
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT")) {
+            return false;
+        }
+        return false;
+    }
+}
+function resolvePath(path, field) {
+    return resolve(normalizeNonEmpty(path, field));
+}
+function normalizeNonEmpty(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TraceSourceRegistryError("invalid_registry_options", `${field} must be a non-empty string.`, { field });
+    }
+    return value.trim();
+}
+function safeJoin(root, fileName) {
+    return safeJoinGuard(root, fileName, () => {
+        throw new TraceSourceRegistryError("invalid_source_id", "Resolved manifest path escapes registryDir.");
+    });
+}
+function isoNow(clock) {
+    return new Date(clock()).toISOString();
+}
+//# sourceMappingURL=trace-sources.js.map

package/dist/trace-sources.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,171 @@
+export interface RuntimeEventLike {
+    readonly type?: string;
+    readonly [key: string]: unknown;
+}
+export interface RuntimeResultLike {
+    readonly cancelled?: boolean;
+    readonly error?: string | null;
+    readonly failureKind?: string | null;
+    readonly usage?: unknown;
+    readonly cost?: unknown;
+    readonly durationMs?: number;
+    readonly providerSessionId?: string | null;
+    readonly runtimeWarnings?: unknown;
+    readonly diagnostics?: unknown;
+    readonly capabilitiesUsed?: unknown;
+    readonly [key: string]: unknown;
+}
+export type RunSummaryStatus = "running" | "succeeded" | "failed" | "cancelled";
+export interface RunSummary {
+    readonly runId: string;
+    readonly conversationId: string;
+    readonly status: RunSummaryStatus;
+    readonly failureKind?: string;
+    readonly startedAt?: string;
+    readonly endedAt?: string;
+    readonly updatedAt?: string;
+    readonly durationMs: number;
+    readonly usage?: unknown;
+    readonly cost?: unknown;
+    readonly providerSessionId?: string | null;
+    readonly eventCount: number;
+    readonly artifactPaths: readonly string[];
+    readonly runtimeWarnings?: unknown;
+    readonly diagnostics?: unknown;
+    readonly capabilitiesUsed?: unknown;
+}
+export interface RunRecorder {
+    start?(): Promise<RunSummary>;
+    onEvent(event: RuntimeEventLike): void;
+    finish(result: RuntimeResultLike): Promise<RunSummary>;
+    fail(error: unknown): Promise<RunSummary>;
+}
+export interface JsonlRunRecorderOptions {
+    readonly runId: string;
+    readonly conversationId: string;
+    readonly artifactDir: string;
+    readonly clock?: () => number;
+    readonly maxStringBytes?: number;
+}
+export type RecordedRunEventCategory = "tool" | "thinking" | "message" | "runtime" | "error";
+export interface RecordedRunListItem {
+    readonly runId: string;
+    readonly conversationId: string;
+    readonly status: RunSummaryStatus;
+    readonly failureKind?: string;
+    readonly startedAt?: string;
+    readonly endedAt?: string;
+    readonly durationMs: number;
+    readonly eventCount: number;
+    readonly updatedAt: string;
+    readonly usage?: unknown;
+    readonly cost?: unknown;
+    readonly providerSessionId?: string | null;
+    readonly runtimeWarnings?: unknown;
+    readonly diagnostics?: unknown;
+    readonly capabilitiesUsed?: unknown;
+}
+export interface RecordedRunEvent {
+    readonly index: number;
+    readonly type?: string;
+    readonly category: RecordedRunEventCategory;
+    readonly timestamp?: string;
+    readonly label: string;
+    readonly summary: string;
+    readonly payload: unknown;
+}
+export interface RecordedRunTimelineItem extends RecordedRunEvent {
+    readonly sourceEventCount: number;
+    readonly sourceEventStartIndex: number;
+    readonly sourceEventEndIndex: number;
+}
+export interface RecordedRunDetail {
+    readonly summary: RecordedRunListItem;
+    readonly events: readonly RecordedRunEvent[];
+    readonly warnings: readonly string[];
+}
+export interface RecordedRunListResult {
+    readonly runs: readonly RecordedRunListItem[];
+    readonly warnings: readonly string[];
+}
+export interface JsonlRunReaderOptions {
+    readonly artifactDir: string;
+    readonly maxRuns?: number;
+    readonly maxEventsPerRun?: number;
+    readonly maxStringBytes?: number;
+}
+export type TraceSourceStatus = "running" | "stopped" | "failed";
+export type TraceSourceHealth = "running" | "stale" | "stopped" | "failed";
+export interface TraceSourceManifest {
+    readonly schema: "agent-runtime.trace-source.v1";
+    readonly sourceId: string;
+    readonly label: string;
+    readonly artifactDir: string;
+    readonly pid?: number;
+    readonly status: TraceSourceStatus;
+    readonly startedAt: string;
+    readonly updatedAt: string;
+    readonly transports?: readonly string[];
+    readonly configPath?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface TraceSourceListItem extends TraceSourceManifest {
+    readonly health: TraceSourceHealth;
+    readonly warnings: readonly string[];
+}
+export interface TraceRunListItem extends RecordedRunListItem {
+    readonly source: TraceSourceListItem;
+}
+export interface TraceRunDetail {
+    readonly source: TraceSourceListItem;
+    readonly run: RecordedRunDetail;
+}
+export interface TraceSourceRegistryOptions {
+    readonly registryDir: string;
+    readonly staleAfterMs?: number;
+    readonly clock?: () => number;
+}
+export interface RegisterTraceSourceOptions extends TraceSourceRegistryOptions {
+    readonly sourceId?: string;
+    readonly label: string;
+    readonly artifactDir: string;
+    readonly pid?: number;
+    readonly status?: TraceSourceStatus;
+    readonly startedAt?: string;
+    readonly heartbeatMs?: number;
+    readonly transports?: readonly string[];
+    readonly configPath?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface UpdateTraceSourceOptions {
+    readonly status?: TraceSourceStatus;
+    readonly artifactDir?: string;
+    readonly transports?: readonly string[];
+    readonly configPath?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface TraceSourceHandle {
+    readonly manifest: TraceSourceManifest;
+    update(patch: UpdateTraceSourceOptions): Promise<TraceSourceManifest>;
+    heartbeat(): Promise<TraceSourceManifest>;
+    stop(patch?: Omit<UpdateTraceSourceOptions, "status"> & {
+        readonly status?: "stopped" | "failed";
+    }): Promise<TraceSourceManifest>;
+}
+export interface TraceSourceListResult {
+    readonly registryDir: string;
+    readonly sources: readonly TraceSourceListItem[];
+    readonly warnings: readonly string[];
+}
+export interface TraceRunListOptions extends TraceSourceRegistryOptions {
+    readonly maxRuns?: number;
+    readonly maxEventsPerRun?: number;
+    readonly maxStringBytes?: number;
+}
+export interface TraceRunListResult {
+    readonly registryDir: string;
+    readonly sources: readonly TraceSourceListItem[];
+    readonly runs: readonly TraceRunListItem[];
+    readonly warnings: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,MAAM,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtE,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,CAAC,GAAG;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnI;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,mBAAoB,SAAQ,0BAA0B;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@mono-agent/observability",
+  "version": "0.1.0",
+  "description": "Run event recording and artifact summaries for agent hosts.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "private": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./event-timeline": {
+      "types": "./dist/event-timeline.d.ts",
+      "import": "./dist/event-timeline.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}