agent-bundle 0.1.0

package/dist/observability/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAgCA,MAAM,UAAU,iBAAiB,CAAC,KAAY;IAC5C,OAAO;QACL,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,8BAA8B,EAAE;YACrE,WAAW,EAAE,sBAAsB;YACnC,IAAI,EAAE,IAAI;SACX,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,mBAAmB,CAAC,6BAA6B,EAAE;YACvE,WAAW,EAAE,mCAAmC;YAChD,IAAI,EAAE,WAAW;SAClB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,OAAO;QACL,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,wBAAwB,EAAE;YAC/D,WAAW,EAAE,+BAA+B;YAC5C,IAAI,EAAE,IAAI;SACX,CAAC;QACF,aAAa,EAAE,KAAK,CAAC,mBAAmB,CAAC,sBAAsB,EAAE;YAC/D,WAAW,EAAE,gCAAgC;YAC7C,IAAI,EAAE,WAAW;SAClB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAY;IAC5C,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,0BAA0B,EAAE;YAC9D,WAAW,EAAE,0BAA0B;YACvC,IAAI,EAAE,IAAI;SACX,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC,wBAAwB,EAAE;YACxD,WAAW,EAAE,6BAA6B;YAC1C,IAAI,EAAE,SAAS;SAChB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,2BAA2B,EAAE;YAC5D,WAAW,EAAE,uBAAuB;YACpC,IAAI,EAAE,SAAS;SAChB,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,aAAa,CAAC,4BAA4B,EAAE;YAC9D,WAAW,EAAE,wBAAwB;YACrC,IAAI,EAAE,SAAS;SAChB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,wBAAwB,EAAE;YAC5D,WAAW,EAAE,uBAAuB;YACpC,IAAI,EAAE,IAAI;SACX,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC,sBAAsB,EAAE;YACtD,WAAW,EAAE,iCAAiC;YAC9C,IAAI,EAAE,SAAS;SAChB,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/observability/middleware.d.ts

@@ -0,0 +1,12 @@
+import type { Context, Next } from "hono";
+import { type ObservabilityProvider } from "./types.js";
+/**
+ * Hono middleware that records HTTP request duration, active-request count,
+ * and wraps each request in a trace span.
+ *
+ * Usage:
+ * ```ts
+ * app.use("*", observabilityMiddleware(provider));
+ * ```
+ */
+export declare function observabilityMiddleware(provider: ObservabilityProvider): (c: Context, next: Next) => Promise<void>;

package/dist/observability/middleware.js

@@ -0,0 +1,45 @@
+import { createHttpMetrics } from "./metrics.js";
+import { elapsed, now, withSpan } from "./tracing.js";
+import { HttpAttributes } from "./types.js";
+/**
+ * Hono middleware that records HTTP request duration, active-request count,
+ * and wraps each request in a trace span.
+ *
+ * Usage:
+ * ```ts
+ * app.use("*", observabilityMiddleware(provider));
+ * ```
+ */
+export function observabilityMiddleware(provider) {
+    const httpMetrics = createHttpMetrics(provider.meter);
+    return async function otelMiddleware(c, next) {
+        const method = c.req.method;
+        const path = c.req.path;
+        const startMs = now();
+        httpMetrics.activeRequests.add(1, { [HttpAttributes.METHOD]: method });
+        try {
+            await withSpan(provider.tracer, `HTTP ${method}`, {
+                [HttpAttributes.METHOD]: method,
+                [HttpAttributes.URL_PATH]: path,
+            }, async (span) => {
+                await next();
+                const route = c.req.routePath;
+                span.setAttributes({
+                    [HttpAttributes.STATUS_CODE]: c.res.status,
+                    [HttpAttributes.ROUTE]: route,
+                });
+            });
+        }
+        finally {
+            const status = c.res.status;
+            const route = c.req.routePath;
+            httpMetrics.requestDuration.record(elapsed(startMs), {
+                [HttpAttributes.METHOD]: method,
+                [HttpAttributes.STATUS_CODE]: status,
+                [HttpAttributes.ROUTE]: route,
+            });
+            httpMetrics.activeRequests.add(-1, { [HttpAttributes.METHOD]: method });
+        }
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/observability/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/observability/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAA8B,MAAM,YAAY,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAA+B;IACrE,MAAM,WAAW,GAAgB,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEnE,OAAO,KAAK,UAAU,cAAc,CAAC,CAAU,EAAE,IAAU;QACzD,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QAExB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;QACtB,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,QAAQ,CACZ,QAAQ,CAAC,MAAM,EACf,QAAQ,MAAM,EAAE,EAChB;gBACE,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM;gBAC/B,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI;aAChC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;gBACb,MAAM,IAAI,EAAE,CAAC;gBAEb,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC9B,IAAI,CAAC,aAAa,CAAC;oBACjB,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM;oBAC1C,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK;iBAC9B,CAAC,CAAC;YACL,CAAC,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;YAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;YAC9B,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;gBACnD,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM;gBAC/B,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM;gBACpC,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK;aAC9B,CAAC,CAAC;YACH,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/observability/otel-harness.test-util.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared OTEL test harness: sets up in-memory exporters and SDK providers
+ * for asserting on emitted spans and metrics in e2e tests.
+ */
+import { type Attributes } from "@opentelemetry/api";
+import { BasicTracerProvider, InMemorySpanExporter, type ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import { InMemoryMetricExporter, MeterProvider, PeriodicExportingMetricReader, type MetricData } from "@opentelemetry/sdk-metrics";
+import type { ObservabilityProvider } from "./types.js";
+export type OtelTestHarness = {
+    provider: ObservabilityProvider;
+    spanExporter: InMemorySpanExporter;
+    metricExporter: InMemoryMetricExporter;
+    metricReader: PeriodicExportingMetricReader;
+    tracerProvider: BasicTracerProvider;
+    meterProvider: MeterProvider;
+    /** Flush metrics so they appear in the exporter, then return all collected metric data. */
+    collectMetrics: () => Promise<MetricData[]>;
+    /** Return all finished spans. */
+    getSpans: () => ReadableSpan[];
+    /** Find spans by name substring. */
+    findSpans: (nameSubstr: string) => ReadableSpan[];
+    /** Find metric data by descriptor name. */
+    findMetric: (name: string) => MetricData | undefined;
+    /** Shut down providers cleanly. */
+    shutdown: () => Promise<void>;
+};
+export declare function createOtelTestHarness(): OtelTestHarness;
+/** Assert that a span has a specific attribute value. */
+export declare function expectSpanAttribute(span: ReadableSpan, key: string, expected: unknown): void;
+/** Assert that a span has OK status. */
+export declare function expectSpanOk(span: ReadableSpan): void;
+/** Assert that a span has ERROR status. */
+export declare function expectSpanError(span: ReadableSpan): void;
+/** Get sum of all data point values for a SUM metric. */
+export declare function sumMetricValue(metric: MetricData, filterAttrs?: Attributes): number;
+/** Check that the metric has at least one data point matching the given attributes. */
+export declare function hasDataPoint(metric: MetricData, attrs: Attributes): boolean;

package/dist/observability/otel-harness.test-util.js

@@ -0,0 +1,96 @@
+/**
+ * Shared OTEL test harness: sets up in-memory exporters and SDK providers
+ * for asserting on emitted spans and metrics in e2e tests.
+ */
+import { SpanStatusCode } from "@opentelemetry/api";
+import { BasicTracerProvider, InMemorySpanExporter, SimpleSpanProcessor, } from "@opentelemetry/sdk-trace-base";
+import { AggregationTemporality, InMemoryMetricExporter, MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
+export function createOtelTestHarness() {
+    const spanExporter = new InMemorySpanExporter();
+    const tracerProvider = new BasicTracerProvider({
+        spanProcessors: [new SimpleSpanProcessor(spanExporter)],
+    });
+    const metricExporter = new InMemoryMetricExporter(AggregationTemporality.CUMULATIVE);
+    const metricReader = new PeriodicExportingMetricReader({
+        exporter: metricExporter,
+        // Very long interval; we will call forceFlush manually.
+        exportIntervalMillis: 60_000,
+    });
+    const meterProvider = new MeterProvider({ readers: [metricReader] });
+    const provider = {
+        tracer: tracerProvider.getTracer("agent-bundle-e2e-test"),
+        meter: meterProvider.getMeter("agent-bundle-e2e-test"),
+    };
+    async function collectMetrics() {
+        await metricReader.forceFlush();
+        const allResourceMetrics = metricExporter.getMetrics();
+        return allResourceMetrics.flatMap((rm) => rm.scopeMetrics.flatMap((sm) => sm.metrics));
+    }
+    function getSpans() {
+        return spanExporter.getFinishedSpans();
+    }
+    function findSpans(nameSubstr) {
+        return getSpans().filter((s) => s.name.includes(nameSubstr));
+    }
+    function findMetric(name) {
+        // Collect synchronously from what is already flushed.
+        const allResourceMetrics = metricExporter.getMetrics();
+        const allMetrics = allResourceMetrics.flatMap((rm) => rm.scopeMetrics.flatMap((sm) => sm.metrics));
+        return allMetrics.find((m) => m.descriptor.name === name);
+    }
+    async function shutdown() {
+        await tracerProvider.shutdown();
+        await meterProvider.shutdown();
+    }
+    return {
+        provider,
+        spanExporter,
+        metricExporter,
+        metricReader,
+        tracerProvider,
+        meterProvider,
+        collectMetrics,
+        getSpans,
+        findSpans,
+        findMetric,
+        shutdown,
+    };
+}
+/** Assert that a span has a specific attribute value. */
+export function expectSpanAttribute(span, key, expected) {
+    const actual = span.attributes[key];
+    if (actual !== expected) {
+        throw new Error(`Expected span "${span.name}" attribute "${key}" to be ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
+    }
+}
+/** Assert that a span has OK status. */
+export function expectSpanOk(span) {
+    if (span.status.code !== SpanStatusCode.OK) {
+        throw new Error(`Expected span "${span.name}" to have OK status, got code=${span.status.code}`);
+    }
+}
+/** Assert that a span has ERROR status. */
+export function expectSpanError(span) {
+    if (span.status.code !== SpanStatusCode.ERROR) {
+        throw new Error(`Expected span "${span.name}" to have ERROR status, got code=${span.status.code}`);
+    }
+}
+/** Get sum of all data point values for a SUM metric. */
+export function sumMetricValue(metric, filterAttrs) {
+    let total = 0;
+    for (const dp of metric.dataPoints) {
+        if (filterAttrs && !matchesAttributes(dp.attributes, filterAttrs)) {
+            continue;
+        }
+        total += dp.value;
+    }
+    return total;
+}
+/** Check that the metric has at least one data point matching the given attributes. */
+export function hasDataPoint(metric, attrs) {
+    return metric.dataPoints.some((dp) => matchesAttributes(dp.attributes, attrs));
+}
+function matchesAttributes(actual, expected) {
+    return Object.entries(expected).every(([key, value]) => actual[key] === value);
+}
+//# sourceMappingURL=otel-harness.test-util.js.map

package/dist/observability/otel-harness.test-util.js.map

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

package/dist/observability/provider.d.ts

@@ -0,0 +1,8 @@
+import type { ObservabilityProvider } from "./types.js";
+/**
+ * Create an {@link ObservabilityProvider} from the OpenTelemetry global API.
+ *
+ * If no SDK is registered the returned tracer/meter are no-ops (zero overhead).
+ * Callers can also supply an explicit provider to override the globals.
+ */
+export declare function createObservabilityProvider(override?: Partial<ObservabilityProvider>): ObservabilityProvider;

package/dist/observability/provider.js

@@ -0,0 +1,19 @@
+import { trace, metrics } from "@opentelemetry/api";
+const LIBRARY_NAME = "agent-bundle";
+// TODO: keep in sync with package.json version or read dynamically
+const LIBRARY_VERSION = "0.1.0";
+/**
+ * Create an {@link ObservabilityProvider} from the OpenTelemetry global API.
+ *
+ * If no SDK is registered the returned tracer/meter are no-ops (zero overhead).
+ * Callers can also supply an explicit provider to override the globals.
+ */
+export function createObservabilityProvider(override) {
+    return {
+        tracer: override?.tracer ??
+            trace.getTracer(LIBRARY_NAME, LIBRARY_VERSION),
+        meter: override?.meter ??
+            metrics.getMeter(LIBRARY_NAME, LIBRARY_VERSION),
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/observability/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/observability/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIpD,MAAM,YAAY,GAAG,cAAc,CAAC;AACpC,mEAAmE;AACnE,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAyC;IAEzC,OAAO;QACL,MAAM,EACJ,QAAQ,EAAE,MAAM;YAChB,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,eAAe,CAAC;QAChD,KAAK,EACH,QAAQ,EAAE,KAAK;YACf,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;KAClD,CAAC;AACJ,CAAC"}

package/dist/observability/tracing.d.ts

@@ -0,0 +1,14 @@
+import { type Attributes, type Span, type Tracer } from "@opentelemetry/api";
+/**
+ * Run `fn` inside a new span. The span is ended automatically and any thrown
+ * error is recorded before re-throwing.
+ */
+export declare function withSpan<T>(tracer: Tracer, name: string, attributes: Attributes, fn: (span: Span) => Promise<T>): Promise<T>;
+/**
+ * Record an error on an existing span without ending it.
+ */
+export declare function recordSpanError(span: Span, error: unknown): void;
+/** Return milliseconds elapsed since `startMs` (monotonic clock). */
+export declare function elapsed(startMs: number): number;
+/** Return a monotonic timestamp in milliseconds. */
+export declare function now(): number;

package/dist/observability/tracing.js

@@ -0,0 +1,40 @@
+import { SpanStatusCode } from "@opentelemetry/api";
+/**
+ * Run `fn` inside a new span. The span is ended automatically and any thrown
+ * error is recorded before re-throwing.
+ */
+export async function withSpan(tracer, name, attributes, fn) {
+    return tracer.startActiveSpan(name, { attributes }, async (span) => {
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (error) {
+            recordSpanError(span, error);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+/**
+ * Record an error on an existing span without ending it.
+ */
+export function recordSpanError(span, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    span.setStatus({ code: SpanStatusCode.ERROR, message });
+    if (error instanceof Error) {
+        span.recordException(error);
+    }
+}
+/** Return milliseconds elapsed since `startMs` (monotonic clock). */
+export function elapsed(startMs) {
+    return performance.now() - startMs;
+}
+/** Return a monotonic timestamp in milliseconds. */
+export function now() {
+    return performance.now();
+}
+//# sourceMappingURL=tracing.js.map

package/dist/observability/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2C,MAAM,oBAAoB,CAAC;AAE7F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,IAAY,EACZ,UAAsB,EACtB,EAA8B;IAE9B,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACjE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7B,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,KAAc;IACxD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAExD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;AACrC,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,GAAG;IACjB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;AAC3B,CAAC"}

package/dist/observability/types.d.ts

@@ -0,0 +1,39 @@
+import type { Tracer, Meter } from "@opentelemetry/api";
+/**
+ * Minimal observability surface injected into agent-bundle components.
+ *
+ * When the user registers an OpenTelemetry SDK at startup, the tracer and meter
+ * will emit real telemetry. Otherwise the OTEL API returns built-in no-ops
+ * with zero measurable overhead.
+ */
+export type ObservabilityProvider = {
+    readonly tracer: Tracer;
+    readonly meter: Meter;
+};
+/** HTTP server attributes (OTEL semantic conventions). */
+export declare const HttpAttributes: {
+    readonly METHOD: "http.request.method";
+    readonly STATUS_CODE: "http.response.status_code";
+    readonly ROUTE: "http.route";
+    readonly URL_PATH: "url.path";
+};
+/** Agent lifecycle attributes. */
+export declare const AgentAttributes: {
+    readonly AGENT_NAME: "agent.name";
+    readonly AGENT_STATUS: "agent.status";
+    readonly TOOL_NAME: "agent.tool.name";
+    readonly TOOL_ERROR: "agent.tool.error";
+};
+/** GenAI semantic conventions. */
+export declare const GenAiAttributes: {
+    readonly INPUT_TOKENS: "gen_ai.usage.input_tokens";
+    readonly OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
+    readonly MODEL: "gen_ai.request.model";
+    readonly PROVIDER: "gen_ai.system";
+};
+/** MCP attributes. */
+export declare const McpAttributes: {
+    readonly SERVER_NAME: "mcp.server.name";
+    readonly TOOL_NAME: "mcp.tool.name";
+    readonly TOOL_ERROR: "mcp.tool.error";
+};

package/dist/observability/types.js

@@ -0,0 +1,31 @@
+/* ------------------------------------------------------------------ */
+/*  Semantic attribute constants                                       */
+/* ------------------------------------------------------------------ */
+/** HTTP server attributes (OTEL semantic conventions). */
+export const HttpAttributes = {
+    METHOD: "http.request.method",
+    STATUS_CODE: "http.response.status_code",
+    ROUTE: "http.route",
+    URL_PATH: "url.path",
+};
+/** Agent lifecycle attributes. */
+export const AgentAttributes = {
+    AGENT_NAME: "agent.name",
+    AGENT_STATUS: "agent.status",
+    TOOL_NAME: "agent.tool.name",
+    TOOL_ERROR: "agent.tool.error",
+};
+/** GenAI semantic conventions. */
+export const GenAiAttributes = {
+    INPUT_TOKENS: "gen_ai.usage.input_tokens",
+    OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+    MODEL: "gen_ai.request.model",
+    PROVIDER: "gen_ai.system",
+};
+/** MCP attributes. */
+export const McpAttributes = {
+    SERVER_NAME: "mcp.server.name",
+    TOOL_NAME: "mcp.tool.name",
+    TOOL_ERROR: "mcp.tool.error",
+};
+//# sourceMappingURL=types.js.map

package/dist/observability/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAcA,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EAAE,2BAA2B;IACxC,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,kBAAkB;CACtB,CAAC;AAEX,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY,EAAE,2BAA2B;IACzC,aAAa,EAAE,4BAA4B;IAC3C,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,eAAe;CACjB,CAAC;AAEX,sBAAsB;AACtB,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,WAAW,EAAE,iBAAiB;IAC9B,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,gBAAgB;CACpB,CAAC"}

package/dist/personalized-recommend/bundle.json

@@ -0,0 +1,64 @@
+{
+  "name": "personalized-recommend",
+  "namePascal": "PersonalizedRecommend",
+  "model": {
+    "provider": "openai",
+    "model": "gpt-5.3-codex"
+  },
+  "sandbox": {
+    "provider": "e2b",
+    "timeout": 300,
+    "resources": {
+      "cpu": 1,
+      "memory": "256MB"
+    },
+    "e2b": {
+      "template": "base",
+      "build": {
+        "dockerfile": "./Dockerfile"
+      }
+    }
+  },
+  "prompt": {
+    "system": "You are a personalization assistant.\nUse memory tools to keep track of user preferences and events.\nUse product tools to recommend relevant products with concise reasons.\nPrefer tool-backed answers over assumptions.\n",
+    "variables": []
+  },
+  "systemPrompt": "You are a personalization assistant.\nUse memory tools to keep track of user preferences and events.\nUse product tools to recommend relevant products with concise reasons.\nPrefer tool-backed answers over assumptions.\n\n## Skills\n\n### update-memory\n---\nname: update-memory\ndescription: Update a user profile memory from a new user event.\n---\n\n# Update Memory\n\nWhen the user provides a new event or preference update:\n\n1. Call `mcp__memory__memory_read` with the user id.\n2. Merge the new event details into the existing profile object.\n3. Call `mcp__memory__memory_write` with the merged profile.\n4. Return a brief confirmation describing what was updated.\n\nRules:\n\n- Never overwrite unrelated fields with empty values.\n- Preserve existing profile keys unless the user explicitly changes them.\n- Include the user id in all memory tool calls.\n\n### recommend\n---\nname: recommend\ndescription: Generate ranked product recommendations from user profile memory.\n---\n\n# Recommend\n\nWhen asked for recommendations:\n\n1. Read the user profile with `mcp__memory__memory_read`.\n2. Search candidate products with `mcp__products__product_search`.\n3. Fetch specific product details with `mcp__products__product_detail` as needed.\n4. Return a ranked list of 3-5 recommendations with clear reasons.\n\nRules:\n\n- Match recommendations to the user profile preferences and recent events.\n- Exclude products that conflict with explicit dislikes when provided.\n- Prefer concise, actionable explanations.",
+  "skills": [
+    {
+      "name": "update-memory",
+      "description": "Update a user profile memory from a new user event.",
+      "sourcePath": "/Users/yujiachen/Projects/agent-bundle/demo/personalized-recommend/skills/update-memory/SKILL.md",
+      "content": "---\nname: update-memory\ndescription: Update a user profile memory from a new user event.\n---\n\n# Update Memory\n\nWhen the user provides a new event or preference update:\n\n1. Call `mcp__memory__memory_read` with the user id.\n2. Merge the new event details into the existing profile object.\n3. Call `mcp__memory__memory_write` with the merged profile.\n4. Return a brief confirmation describing what was updated.\n\nRules:\n\n- Never overwrite unrelated fields with empty values.\n- Preserve existing profile keys unless the user explicitly changes them.\n- Include the user id in all memory tool calls.\n"
+    },
+    {
+      "name": "recommend",
+      "description": "Generate ranked product recommendations from user profile memory.",
+      "sourcePath": "/Users/yujiachen/Projects/agent-bundle/demo/personalized-recommend/skills/recommend/SKILL.md",
+      "content": "---\nname: recommend\ndescription: Generate ranked product recommendations from user profile memory.\n---\n\n# Recommend\n\nWhen asked for recommendations:\n\n1. Read the user profile with `mcp__memory__memory_read`.\n2. Search candidate products with `mcp__products__product_search`.\n3. Fetch specific product details with `mcp__products__product_detail` as needed.\n4. Return a ranked list of 3-5 recommendations with clear reasons.\n\nRules:\n\n- Match recommendations to the user profile preferences and recent events.\n- Exclude products that conflict with explicit dislikes when provided.\n- Prefer concise, actionable explanations.\n"
+    }
+  ],
+  "commands": [],
+  "mcp": {
+    "servers": [
+      {
+        "transport": "stdio",
+        "name": "memory",
+        "command": "node",
+        "args": [
+          "/mcp/memory-server.mjs"
+        ]
+      },
+      {
+        "transport": "http",
+        "name": "products",
+        "url": "http://127.0.0.1:3102/mcp",
+        "auth": "bearer"
+      }
+    ]
+  },
+  "sandboxImage": {
+    "provider": "e2b",
+    "ref": "base"
+  }
+}

package/dist/personalized-recommend/index.ts

@@ -0,0 +1,41 @@
+import { defineAgent } from "agent-bundle/runtime";
+
+export const PersonalizedRecommend = defineAgent({
+    name: "personalized-recommend",
+    sandbox: {
+        provider: "e2b",
+        timeout: 300,
+        resources: {
+            cpu: 1,
+            memory: "256MB"
+        },
+        e2b: {
+            template: "base",
+            build: {
+                dockerfile: "./Dockerfile"
+            }
+        }
+    },
+    model: {
+        provider: "openai",
+        model: "gpt-5.3-codex"
+    },
+    systemPrompt: "You are a personalization assistant.\nUse memory tools to keep track of user preferences and events.\nUse product tools to recommend relevant products with concise reasons.\nPrefer tool-backed answers over assumptions.\n\n## Skills\n\n### update-memory\n---\nname: update-memory\ndescription: Update a user profile memory from a new user event.\n---\n\n# Update Memory\n\nWhen the user provides a new event or preference update:\n\n1. Call `mcp__memory__memory_read` with the user id.\n2. Merge the new event details into the existing profile object.\n3. Call `mcp__memory__memory_write` with the merged profile.\n4. Return a brief confirmation describing what was updated.\n\nRules:\n\n- Never overwrite unrelated fields with empty values.\n- Preserve existing profile keys unless the user explicitly changes them.\n- Include the user id in all memory tool calls.\n\n### recommend\n---\nname: recommend\ndescription: Generate ranked product recommendations from user profile memory.\n---\n\n# Recommend\n\nWhen asked for recommendations:\n\n1. Read the user profile with `mcp__memory__memory_read`.\n2. Search candidate products with `mcp__products__product_search`.\n3. Fetch specific product details with `mcp__products__product_detail` as needed.\n4. Return a ranked list of 3-5 recommendations with clear reasons.\n\nRules:\n\n- Match recommendations to the user profile preferences and recent events.\n- Exclude products that conflict with explicit dislikes when provided.\n- Prefer concise, actionable explanations.",
+    variables: [] as const,
+    mcp: [
+        {
+            transport: "stdio",
+            name: "memory",
+            command: "node",
+            args: [
+                "/mcp/memory-server.mjs"
+            ]
+        },
+        {
+            transport: "http",
+            name: "products",
+            url: "http://127.0.0.1:3102/mcp",
+            auth: "bearer"
+        }
+    ]
+});

package/dist/personalized-recommend/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@agent-bundle/personalized-recommend",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./index.ts",
+  "types": "./index.ts",
+  "dependencies": {
+    "agent-bundle": "*"
+  }
+}

package/dist/personalized-recommend/types.ts

@@ -0,0 +1,2 @@
+export interface PersonalizedRecommendVariables {
+}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,11 @@
+import type { PluginEntry } from "../schema/bundle.js";
+import type { PluginComponents } from "./types.js";
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+export type LoadPluginOptions = {
+    cache?: boolean;
+    cacheDir?: string;
+    fetchImpl?: FetchLike;
+};
+export declare function loadPlugin(entry: PluginEntry, options?: LoadPluginOptions): Promise<PluginComponents>;
+export declare function loadAllPlugins(entries: PluginEntry[], options?: LoadPluginOptions): Promise<PluginComponents[]>;
+export {};

package/dist/plugins/loader.js

@@ -0,0 +1,100 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parseCommandMarkdown, parseGitHubDirectoryListing, parseGitHubFileListing, parseMcpJson, parsePluginManifest, parseSkillMarkdown, } from "./parse.js";
+import { toPluginCommandsApiUrl, toPluginCommandUrl, toPluginManifestUrl, toPluginMcpJsonUrl, toPluginSkillsApiUrl, toPluginSkillUrl, } from "./urls.js";
+const DEFAULT_CACHE_DIR = "node_modules/.cache/agent-bundle/plugins";
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+function createCachePath(url, cacheDir) {
+    const hash = createHash("sha256").update(url).digest("hex");
+    return join(cacheDir, hash);
+}
+async function readCachedContent(cachePath) {
+    try {
+        return await readFile(cachePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+async function fetchRemoteContent(url, options) {
+    const shouldCache = options.cache ?? true;
+    const cacheDir = options.cacheDir ?? DEFAULT_CACHE_DIR;
+    const cachePath = createCachePath(url, cacheDir);
+    if (shouldCache) {
+        const cached = await readCachedContent(cachePath);
+        if (cached !== null) {
+            return cached;
+        }
+    }
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`.trim());
+    }
+    const content = await response.text();
+    if (shouldCache) {
+        await mkdir(dirname(cachePath), { recursive: true });
+        await writeFile(cachePath, content, "utf8");
+    }
+    return content;
+}
+async function fetchOptionalContent(url, options) {
+    try {
+        return await fetchRemoteContent(url, options);
+    }
+    catch {
+        return null;
+    }
+}
+async function resolveSkillNames(entry, options) {
+    if (entry.skills && entry.skills.length > 0) {
+        return entry.skills;
+    }
+    const apiUrl = toPluginSkillsApiUrl(entry);
+    const content = await fetchRemoteContent(apiUrl, { ...options, cache: false });
+    return parseGitHubDirectoryListing(content, apiUrl);
+}
+async function resolveCommandNames(entry, options) {
+    if (entry.commands) {
+        return entry.commands;
+    }
+    const apiUrl = toPluginCommandsApiUrl(entry);
+    try {
+        const content = await fetchRemoteContent(apiUrl, { ...options, cache: false });
+        return parseGitHubFileListing(content, apiUrl);
+    }
+    catch {
+        return [];
+    }
+}
+export async function loadPlugin(entry, options = {}) {
+    const manifestUrl = toPluginManifestUrl(entry);
+    const manifestJson = await fetchRemoteContent(manifestUrl, options);
+    const metadata = parsePluginManifest(manifestJson, manifestUrl);
+    const skillNames = await resolveSkillNames(entry, options);
+    const skills = await Promise.all(skillNames.map(async (skillName) => {
+        const skillUrl = toPluginSkillUrl(entry, skillName);
+        const markdown = await fetchRemoteContent(skillUrl, options);
+        return parseSkillMarkdown(markdown, skillUrl);
+    }));
+    const commandNames = await resolveCommandNames(entry, options);
+    const commands = await Promise.all(commandNames.map(async (commandName) => {
+        const commandUrl = toPluginCommandUrl(entry, commandName);
+        const markdown = await fetchRemoteContent(commandUrl, options);
+        return parseCommandMarkdown(markdown, commandUrl);
+    }));
+    const mcpJsonUrl = toPluginMcpJsonUrl(entry);
+    const mcpJson = await fetchOptionalContent(mcpJsonUrl, options);
+    const mcpServers = mcpJson !== null ? parseMcpJson(mcpJson, mcpJsonUrl) : [];
+    return { skills, commands, mcpServers, metadata };
+}
+export async function loadAllPlugins(entries, options = {}) {
+    return await Promise.all(entries.map(async (entry) => loadPlugin(entry, options)));
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/merge.d.ts

@@ -0,0 +1,10 @@
+import type { McpServerConfig } from "../agent/types.js";
+import type { Command } from "../commands/types.js";
+import type { Skill } from "../skills/loader.js";
+import type { PluginComponents } from "./types.js";
+export type MergedPluginResult = {
+    skills: Skill[];
+    commands: Command[];
+    mcpServers: McpServerConfig[];
+};
+export declare function mergePluginComponents(existingSkills: readonly Skill[], existingCommands: readonly Command[], existingMcpServers: readonly McpServerConfig[], pluginResults: readonly PluginComponents[]): MergedPluginResult;