@nebulaos/core 0.2.2 → 0.2.4

package/dist/agent/Agent.js

@@ -397,7 +397,17 @@ class Agent extends BaseAgent_js_1.BaseAgent {
                         durationMs: Date.now() - startTime,
                     },
                 });
-                await agentSpan.end({ status: "error" });
+                await agentSpan.end({
+                    status: "error",
+                    data: {
+                        error: {
+                            message: error.message,
+                            name: error.name,
+                            code: error.code,
+                            status: error.status,
+                        },
+                    },
+                });
                 throw err;
             }
         });

package/dist/tracing/index.d.ts

@@ -85,5 +85,14 @@ export declare class Tracing {
      * ITelemetryExporter.
      */
     static withSpan<T, K extends TelemetrySpanKind>(input: SpanStartInput<K>, fn: (span: ActiveSpan<K>) => Promise<T>): Promise<T>;
+    /**
+     * Starts a new span without requiring a callback.
+     * Useful for async generators or cases where withSpan is not applicable.
+     * The caller is responsible for ending the span.
+     *
+     * Returns undefined if tracing is not configured.
+     */
+    static startSpan<K extends TelemetrySpanKind>(input: SpanStartInput<K>): Promise<ActiveSpan<K> | undefined>;
+    private static defaultStartSpan;
     private static defaultWithSpan;
 }

package/dist/tracing/index.js

@@ -133,6 +133,50 @@ class Tracing {
         }
         return this.defaultWithSpan(input, fn);
     }
+    /**
+     * Starts a new span without requiring a callback.
+     * Useful for async generators or cases where withSpan is not applicable.
+     * The caller is responsible for ending the span.
+     *
+     * Returns undefined if tracing is not configured.
+     */
+    static async startSpan(input) {
+        if (this.provider) {
+            return this.provider.startSpan(input);
+        }
+        return this.defaultStartSpan(input);
+    }
+    static async defaultStartSpan(input) {
+        const parent = storage.getStore();
+        const traceId = parent?.traceId ?? generateTraceId();
+        const parentSpanId = parent?.spanId;
+        const spanId = generateSpanId();
+        const startedAt = new Date().toISOString();
+        const startEvent = {
+            v: 1,
+            type: "telemetry:span:start",
+            timestamp: startedAt,
+            trace: {
+                traceId,
+                spanId,
+                parentSpanId,
+            },
+            correlationId: input.correlationId,
+            executionId: input.executionId,
+            span: {
+                kind: input.kind,
+                name: input.name,
+                data: (input.data ?? {}),
+            },
+        };
+        try {
+            await this.exporter.exportBatch([startEvent]);
+        }
+        catch {
+            // Telemetry must never break execution.
+        }
+        return new ActiveSpan(traceId, spanId, parentSpanId, input.kind, input.name, input.correlationId, input.executionId, this.exporter);
+    }
     // ---------------------------------------------------------------------------
     // Default (built-in) implementation – used when no provider is set
     // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulaos/core",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Core primitives for NebulaOS (Agent, Workflow, Providers)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,7 +33,7 @@
     "uuid": "^9.0.1",
     "zod": "^3.0.0",
     "zod-to-json-schema": "^3.0.0",
-    "@nebulaos/types": "0.1.1"
+    "@nebulaos/types": "^0.1.3"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
@@ -44,8 +44,8 @@
     "ts-jest": "^29.4.6",
     "typescript": "^5.0.0",
     "@nebulaos/oci": "0.0.1",
-    "@nebulaos/openai": "0.1.0",
-    "@nebulaos/google-gemini": "0.0.1"
+    "@nebulaos/google-gemini": "0.0.1",
+    "@nebulaos/openai": "0.1.0"
   },
   "scripts": {
     "build": "tsc",