@a5c-ai/agent-runtime 5.0.1-staging.04ca6ab00d21

package/dist/telemetry/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * OpenTelemetry-aligned structured telemetry interfaces for Babysitter Agent Runtime.
+ *
+ * These are interface-only type stubs — implementations will follow in issue #217.
+ */
+/** Status of a telemetry span, aligned with OpenTelemetry StatusCode. */
+export declare enum TelemetrySpanStatus {
+    /** The span completed without error. */
+    Ok = "Ok",
+    /** The span ended with an error. */
+    Error = "Error",
+    /** Status has not been explicitly set (default). */
+    Unset = "Unset"
+}
+/** A discrete event recorded within a span. */
+export interface TelemetryEvent {
+    /** Human-readable event name. */
+    readonly name: string;
+    /** ISO-8601 timestamp of when the event occurred. */
+    readonly timestamp: string;
+    /** Optional key-value attributes attached to the event. */
+    readonly attributes?: Record<string, string | number | boolean>;
+}
+/** A unit of work within a trace, aligned with the OpenTelemetry Span model. */
+export interface TelemetrySpan {
+    /** Human-readable span name. */
+    readonly name: string;
+    /** Trace identifier shared across the entire distributed trace. */
+    readonly traceId: string;
+    /** Unique identifier for this span within the trace. */
+    readonly spanId: string;
+    /** Span ID of the parent span, if this is a child span. */
+    readonly parentSpanId?: string;
+    /** ISO-8601 timestamp when the span started. */
+    readonly startTime: string;
+    /** ISO-8601 timestamp when the span ended; undefined while in-flight. */
+    readonly endTime?: string;
+    /** Terminal status of the span. */
+    readonly status: TelemetrySpanStatus;
+    /** Key-value attributes attached to the span. */
+    readonly attributes: Record<string, string | number | boolean>;
+    /** Discrete events recorded during the span's lifetime. */
+    readonly events: TelemetryEvent[];
+}
+/** Abstraction over a telemetry backend (e.g. OTLP exporter, console, no-op). */
+export interface TelemetryProvider {
+    /**
+     * Begin a new span.
+     *
+     * @param name - Human-readable span name.
+     * @param parentSpanId - Optional parent span to nest under.
+     * @returns The newly created span.
+     */
+    startSpan(name: string, parentSpanId?: string): Promise<TelemetrySpan>;
+    /**
+     * End an in-flight span.
+     *
+     * @param spanId - ID of the span to end.
+     * @param status - Terminal status; defaults to `Ok` if omitted.
+     */
+    endSpan(spanId: string, status?: TelemetrySpanStatus): Promise<void>;
+    /**
+     * Record a discrete event on an active span.
+     *
+     * @param spanId - ID of the span to attach the event to.
+     * @param event - The event payload.
+     */
+    recordEvent(spanId: string, event: TelemetryEvent): Promise<void>;
+    /**
+     * Flush any buffered telemetry data to the configured exporters.
+     */
+    flush(): Promise<void>;
+}
+/** Configuration for the telemetry subsystem. */
+export interface TelemetryConfig {
+    /** Whether telemetry collection is enabled. */
+    readonly enabled: boolean;
+    /** Provider implementation to use; when absent a no-op provider is assumed. */
+    readonly provider?: TelemetryProvider;
+    /** Sampling rate between 0 (none) and 1 (all traces). */
+    readonly sampleRate?: number;
+    /** Named exporters to send telemetry data to (e.g. "otlp", "console", "file"). */
+    readonly exporters?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,yEAAyE;AACzE,oBAAY,mBAAmB;IAC7B,wCAAwC;IACxC,EAAE,OAAO;IACT,oCAAoC;IACpC,KAAK,UAAU;IACf,oDAAoD;IACpD,KAAK,UAAU;CAChB;AAMD,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACjE;AAMD,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/D,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;CACnC;AAMD,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvE;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B"}

package/dist/telemetry/types.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * OpenTelemetry-aligned structured telemetry interfaces for Babysitter Agent Runtime.
+ *
+ * These are interface-only type stubs — implementations will follow in issue #217.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetrySpanStatus = void 0;
+// ---------------------------------------------------------------------------
+// Span Status
+// ---------------------------------------------------------------------------
+/** Status of a telemetry span, aligned with OpenTelemetry StatusCode. */
+var TelemetrySpanStatus;
+(function (TelemetrySpanStatus) {
+    /** The span completed without error. */
+    TelemetrySpanStatus["Ok"] = "Ok";
+    /** The span ended with an error. */
+    TelemetrySpanStatus["Error"] = "Error";
+    /** Status has not been explicitly set (default). */
+    TelemetrySpanStatus["Unset"] = "Unset";
+})(TelemetrySpanStatus || (exports.TelemetrySpanStatus = TelemetrySpanStatus = {}));

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@a5c-ai/agent-runtime",
+  "version": "5.0.1-staging.04ca6ab00d21",
+  "description": "Agent runtime layer (L5) — daemon, session, resource management, telemetry",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./daemon": {
+      "types": "./dist/daemon/index.d.ts",
+      "require": "./dist/daemon/index.js",
+      "default": "./dist/daemon/index.js"
+    },
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "require": "./dist/session/index.js",
+      "default": "./dist/session/index.js"
+    },
+    "./cost": {
+      "types": "./dist/cost/index.d.ts",
+      "require": "./dist/cost/index.js",
+      "default": "./dist/cost/index.js"
+    },
+    "./observability": {
+      "types": "./dist/observability/index.d.ts",
+      "require": "./dist/observability/index.js",
+      "default": "./dist/observability/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "daemon": [
+        "dist/daemon/index.d.ts"
+      ],
+      "session": [
+        "dist/session/index.d.ts"
+      ],
+      "cost": [
+        "dist/cost/index.d.ts"
+      ],
+      "observability": [
+        "dist/observability/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "npm run build:sdk --prefix ../.. && tsc --build --force tsconfig.json",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "test": "vitest run --config vitest.config.ts"
+  },
+  "dependencies": {
+    "@a5c-ai/agent-comm-mux": "5.0.1-staging.04ca6ab00d21",
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.04ca6ab00d21"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "rimraf": "^6.1.3",
+    "typescript": "^5.4.2",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a5c-ai/babysitter.git",
+    "directory": "packages/agent-runtime"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/packages/agent-runtime#readme",
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter/issues"
+  },
+  "atlas": {
+    "layers": [
+      "L5"
+    ],
+    "muxes": []
+  }
+}