@framers/agentos 0.1.0

package/dist/core/observability/ITracer.d.ts

@@ -0,0 +1,317 @@
+/**
+ * @file ITracer.ts
+ * @description Interface for distributed tracing in AgentOS.
+ *
+ * Provides span-based tracing for tracking request flows across
+ * GMIs, agencies, tool calls, and LLM interactions.
+ *
+ * @module AgentOS/Observability
+ * @version 1.0.0
+ */
+/**
+ * Span status codes.
+ */
+export type SpanStatus = 'unset' | 'ok' | 'error';
+/**
+ * Span kind indicating the relationship.
+ */
+export type SpanKind = 'internal' | 'server' | 'client' | 'producer' | 'consumer';
+/**
+ * Attribute value types.
+ */
+export type AttributeValue = string | number | boolean | string[] | number[] | boolean[];
+/**
+ * Span attributes map.
+ */
+export type SpanAttributes = Record<string, AttributeValue>;
+/**
+ * Context for propagating trace information.
+ */
+export interface TraceContext {
+    /** Unique trace ID */
+    traceId: string;
+    /** Current span ID */
+    spanId: string;
+    /** Parent span ID if exists */
+    parentSpanId?: string;
+    /** Trace flags (e.g., sampling) */
+    traceFlags: number;
+    /** Baggage items */
+    baggage?: Record<string, string>;
+}
+/**
+ * A recorded event within a span.
+ */
+export interface SpanEvent {
+    /** Event name */
+    name: string;
+    /** Event timestamp */
+    timestamp: number;
+    /** Event attributes */
+    attributes?: SpanAttributes;
+}
+/**
+ * A link to another span.
+ */
+export interface SpanLink {
+    /** Linked trace context */
+    context: TraceContext;
+    /** Link attributes */
+    attributes?: SpanAttributes;
+}
+/**
+ * Represents a single trace span.
+ */
+export interface ISpan {
+    /** Span name */
+    name: string;
+    /** Trace context */
+    context: TraceContext;
+    /** Span kind */
+    kind: SpanKind;
+    /** Start timestamp in milliseconds */
+    startTime: number;
+    /** End timestamp in milliseconds */
+    endTime?: number;
+    /** Span status */
+    status: SpanStatus;
+    /** Status message */
+    statusMessage?: string;
+    /** Span attributes */
+    attributes: SpanAttributes;
+    /** Span events */
+    events: SpanEvent[];
+    /** Links to other spans */
+    links: SpanLink[];
+    /**
+     * Sets an attribute on the span.
+     * @param key - Attribute key
+     * @param value - Attribute value
+     */
+    setAttribute(key: string, value: AttributeValue): void;
+    /**
+     * Sets multiple attributes.
+     * @param attributes - Attributes to set
+     */
+    setAttributes(attributes: SpanAttributes): void;
+    /**
+     * Records an event.
+     * @param name - Event name
+     * @param attributes - Event attributes
+     */
+    addEvent(name: string, attributes?: SpanAttributes): void;
+    /**
+     * Sets the span status.
+     * @param status - Status code
+     * @param message - Optional message
+     */
+    setStatus(status: SpanStatus, message?: string): void;
+    /**
+     * Records an exception.
+     * @param error - The error object
+     */
+    recordException(error: Error): void;
+    /**
+     * Ends the span.
+     */
+    end(): void;
+    /**
+     * Checks if the span is recording.
+     */
+    isRecording(): boolean;
+}
+/**
+ * Options for creating a span.
+ */
+export interface SpanOptions {
+    /** Span kind */
+    kind?: SpanKind;
+    /** Initial attributes */
+    attributes?: SpanAttributes;
+    /** Links to other spans */
+    links?: SpanLink[];
+    /** Start time override */
+    startTime?: number;
+    /** Parent context */
+    parent?: TraceContext;
+}
+/**
+ * Exported span data for serialization.
+ */
+export interface ExportedSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: SpanKind;
+    startTime: number;
+    endTime?: number;
+    status: SpanStatus;
+    statusMessage?: string;
+    attributes: SpanAttributes;
+    events: SpanEvent[];
+    links: SpanLink[];
+}
+/**
+ * Span exporter interface.
+ */
+export interface ISpanExporter {
+    /**
+     * Exports spans to a backend.
+     * @param spans - Spans to export
+     */
+    export(spans: ExportedSpan[]): Promise<void>;
+    /**
+     * Shuts down the exporter.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Tracer statistics.
+ */
+export interface TracerStats {
+    /** Total spans created */
+    totalSpans: number;
+    /** Active (unfinished) spans */
+    activeSpans: number;
+    /** Error spans */
+    errorSpans: number;
+    /** Total events recorded */
+    totalEvents: number;
+    /** Spans by operation name */
+    spansByName: Record<string, number>;
+    /** Average span duration */
+    avgDurationMs: number;
+    /** Spans exported */
+    exportedSpans: number;
+}
+/**
+ * Interface for the distributed tracer.
+ *
+ * @example
+ * ```typescript
+ * const tracer = new Tracer();
+ *
+ * const span = tracer.startSpan('process-request', {
+ *   kind: 'server',
+ *   attributes: { 'gmi.id': 'gmi-123' },
+ * });
+ *
+ * try {
+ *   // Process request
+ *   span.addEvent('processing-started');
+ *   const result = await processRequest();
+ *   span.setAttribute('result.count', result.length);
+ *   span.setStatus('ok');
+ * } catch (error) {
+ *   span.recordException(error);
+ *   span.setStatus('error', error.message);
+ * } finally {
+ *   span.end();
+ * }
+ * ```
+ */
+export interface ITracer {
+    /**
+     * Gets the tracer name.
+     */
+    readonly name: string;
+    /**
+     * Gets the current trace context.
+     */
+    getCurrentContext(): TraceContext | undefined;
+    /**
+     * Starts a new span.
+     * @param name - Span name
+     * @param options - Span options
+     * @returns The created span
+     */
+    startSpan(name: string, options?: SpanOptions): ISpan;
+    /**
+     * Wraps an async function with tracing.
+     * @param name - Span name
+     * @param fn - Function to wrap
+     * @param options - Span options
+     * @returns Result of the function
+     */
+    withSpan<T>(name: string, fn: (span: ISpan) => Promise<T>, options?: SpanOptions): Promise<T>;
+    /**
+     * Injects trace context into a carrier (for propagation).
+     * @param carrier - Object to inject into
+     * @returns The carrier with injected context
+     */
+    inject<T extends Record<string, string>>(carrier: T): T;
+    /**
+     * Extracts trace context from a carrier.
+     * @param carrier - Object to extract from
+     * @returns Extracted context or undefined
+     */
+    extract(carrier: Record<string, string>): TraceContext | undefined;
+    /**
+     * Gets a span by ID.
+     * @param spanId - Span ID
+     * @returns The span or undefined
+     */
+    getSpan(spanId: string): ISpan | undefined;
+    /**
+     * Gets all active spans.
+     * @returns Array of active spans
+     */
+    getActiveSpans(): ISpan[];
+    /**
+     * Adds a span exporter.
+     * @param exporter - Exporter to add
+     */
+    addExporter(exporter: ISpanExporter): void;
+    /**
+     * Forces export of all completed spans.
+     */
+    flush(): Promise<void>;
+    /**
+     * Gets tracer statistics.
+     */
+    getStats(): TracerStats;
+    /**
+     * Resets statistics.
+     */
+    resetStats(): void;
+    /**
+     * Shuts down the tracer.
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Creates a formatted trace ID for display.
+ * @param traceId - The trace ID
+ * @param spanId - The span ID
+ * @returns Formatted string
+ */
+export declare function formatTraceId(traceId: string, spanId?: string): string;
+/**
+ * Semantic conventions for span attributes.
+ */
+export declare const SemanticAttributes: {
+    readonly SERVICE_NAME: "service.name";
+    readonly SERVICE_VERSION: "service.version";
+    readonly GMI_ID: "gmi.id";
+    readonly GMI_PERSONA_ID: "gmi.persona.id";
+    readonly GMI_CONVERSATION_ID: "gmi.conversation.id";
+    readonly AGENCY_ID: "agency.id";
+    readonly AGENCY_ROLE_ID: "agency.role.id";
+    readonly LLM_PROVIDER: "llm.provider";
+    readonly LLM_MODEL: "llm.model";
+    readonly LLM_PROMPT_TOKENS: "llm.prompt_tokens";
+    readonly LLM_COMPLETION_TOKENS: "llm.completion_tokens";
+    readonly LLM_TOTAL_TOKENS: "llm.total_tokens";
+    readonly TOOL_ID: "tool.id";
+    readonly TOOL_NAME: "tool.name";
+    readonly TOOL_RESULT_STATUS: "tool.result.status";
+    readonly EXCEPTION_TYPE: "exception.type";
+    readonly EXCEPTION_MESSAGE: "exception.message";
+    readonly EXCEPTION_STACKTRACE: "exception.stacktrace";
+    readonly HTTP_METHOD: "http.method";
+    readonly HTTP_URL: "http.url";
+    readonly HTTP_STATUS_CODE: "http.status_code";
+    readonly USER_ID: "user.id";
+};
+//# sourceMappingURL=ITracer.d.ts.map

package/dist/core/observability/ITracer.d.ts.map

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

package/dist/core/observability/ITracer.js

@@ -0,0 +1,55 @@
+/**
+ * @file ITracer.ts
+ * @description Interface for distributed tracing in AgentOS.
+ *
+ * Provides span-based tracing for tracking request flows across
+ * GMIs, agencies, tool calls, and LLM interactions.
+ *
+ * @module AgentOS/Observability
+ * @version 1.0.0
+ */
+/**
+ * Creates a formatted trace ID for display.
+ * @param traceId - The trace ID
+ * @param spanId - The span ID
+ * @returns Formatted string
+ */
+export function formatTraceId(traceId, spanId) {
+    return spanId ? `${traceId.slice(0, 8)}:${spanId.slice(0, 8)}` : traceId.slice(0, 16);
+}
+/**
+ * Semantic conventions for span attributes.
+ */
+export const SemanticAttributes = {
+    // General
+    SERVICE_NAME: 'service.name',
+    SERVICE_VERSION: 'service.version',
+    // GMI
+    GMI_ID: 'gmi.id',
+    GMI_PERSONA_ID: 'gmi.persona.id',
+    GMI_CONVERSATION_ID: 'gmi.conversation.id',
+    // Agency
+    AGENCY_ID: 'agency.id',
+    AGENCY_ROLE_ID: 'agency.role.id',
+    // LLM
+    LLM_PROVIDER: 'llm.provider',
+    LLM_MODEL: 'llm.model',
+    LLM_PROMPT_TOKENS: 'llm.prompt_tokens',
+    LLM_COMPLETION_TOKENS: 'llm.completion_tokens',
+    LLM_TOTAL_TOKENS: 'llm.total_tokens',
+    // Tool
+    TOOL_ID: 'tool.id',
+    TOOL_NAME: 'tool.name',
+    TOOL_RESULT_STATUS: 'tool.result.status',
+    // Error
+    EXCEPTION_TYPE: 'exception.type',
+    EXCEPTION_MESSAGE: 'exception.message',
+    EXCEPTION_STACKTRACE: 'exception.stacktrace',
+    // HTTP (for external calls)
+    HTTP_METHOD: 'http.method',
+    HTTP_URL: 'http.url',
+    HTTP_STATUS_CODE: 'http.status_code',
+    // User
+    USER_ID: 'user.id',
+};
+//# sourceMappingURL=ITracer.js.map

package/dist/core/observability/ITracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITracer.js","sourceRoot":"","sources":["../../../src/core/observability/ITracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA2TH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,MAAe;IAC5D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,UAAU;IACV,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAElC,MAAM;IACN,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,gBAAgB;IAChC,mBAAmB,EAAE,qBAAqB;IAE1C,SAAS;IACT,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAEhC,MAAM;IACN,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,qBAAqB,EAAE,uBAAuB;IAC9C,gBAAgB,EAAE,kBAAkB;IAEpC,OAAO;IACP,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,kBAAkB,EAAE,oBAAoB;IAExC,QAAQ;IACR,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAE5C,4BAA4B;IAC5B,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,kBAAkB;IAEpC,OAAO;IACP,OAAO,EAAE,SAAS;CACV,CAAC"}

package/dist/core/observability/Tracer.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @file Tracer.ts
+ * @description Implementation of distributed tracing for AgentOS.
+ * @module AgentOS/Observability
+ * @version 1.0.0
+ */
+import type { ITracer, ISpan, ISpanExporter, TraceContext, SpanOptions, ExportedSpan, TracerStats } from './ITracer';
+/**
+ * Simple console exporter for development.
+ */
+export declare class ConsoleSpanExporter implements ISpanExporter {
+    private readonly prefix;
+    constructor(prefix?: string);
+    export(spans: ExportedSpan[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * In-memory exporter that stores spans for retrieval.
+ */
+export declare class InMemorySpanExporter implements ISpanExporter {
+    private spans;
+    private maxSpans;
+    constructor(maxSpans?: number);
+    export(spans: ExportedSpan[]): Promise<void>;
+    getSpans(): ExportedSpan[];
+    getSpansByName(name: string): ExportedSpan[];
+    getSpansByTraceId(traceId: string): ExportedSpan[];
+    clear(): void;
+    shutdown(): Promise<void>;
+}
+/**
+ * Tracer configuration.
+ */
+export interface TracerConfig {
+    /** Tracer name */
+    name?: string;
+    /** Whether to auto-export on span end */
+    autoExport?: boolean;
+    /** Batch size for export */
+    exportBatchSize?: number;
+    /** Export interval in ms */
+    exportIntervalMs?: number;
+    /** Maximum spans to buffer */
+    maxBufferSize?: number;
+}
+/**
+ * Distributed tracer implementation.
+ */
+export declare class Tracer implements ITracer {
+    readonly name: string;
+    private readonly config;
+    private readonly activeSpans;
+    private readonly completedSpans;
+    private readonly exporters;
+    private currentContext?;
+    private exportTimer?;
+    private stats;
+    constructor(config?: Partial<TracerConfig>);
+    getCurrentContext(): TraceContext | undefined;
+    startSpan(name: string, options?: SpanOptions): ISpan;
+    withSpan<T>(name: string, fn: (span: ISpan) => Promise<T>, options?: SpanOptions): Promise<T>;
+    inject<T extends Record<string, string>>(carrier: T): T;
+    extract(carrier: Record<string, string>): TraceContext | undefined;
+    getSpan(spanId: string): ISpan | undefined;
+    getActiveSpans(): ISpan[];
+    addExporter(exporter: ISpanExporter): void;
+    flush(): Promise<void>;
+    getStats(): TracerStats;
+    resetStats(): void;
+    shutdown(): Promise<void>;
+    private onSpanEnd;
+    private startExportTimer;
+    private generateId;
+    private createEmptyStats;
+}
+//# sourceMappingURL=Tracer.d.ts.map

package/dist/core/observability/Tracer.d.ts.map

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