agentic-pi 0.2.4 → 0.2.5

package/dist/telemetry/semconv.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Centralized OpenTelemetry attribute keys, span names, and metric names.
+ *
+ * Single source of truth so the still-evolving GenAI semantic conventions
+ * (`gen_ai.*`) are pinned in exactly one place. We hand-define the `gen_ai.*`
+ * keys as literals rather than importing them from
+ * `@opentelemetry/semantic-conventions/incubating`, because that incubating
+ * export path is unstable across minor releases — depending on the runtime
+ * values, not the package's export surface, keeps us insulated from churn.
+ */
+/** Stable GenAI semantic-convention attribute keys. */
+export declare const GenAI: {
+    readonly SYSTEM: "gen_ai.system";
+    readonly OPERATION_NAME: "gen_ai.operation.name";
+    readonly CONVERSATION_ID: "gen_ai.conversation.id";
+    readonly REQUEST_MODEL: "gen_ai.request.model";
+    readonly RESPONSE_MODEL: "gen_ai.response.model";
+    readonly RESPONSE_ID: "gen_ai.response.id";
+    readonly RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons";
+    readonly USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens";
+    readonly USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens";
+    readonly TOOL_NAME: "gen_ai.tool.name";
+    readonly TOOL_CALL_ID: "gen_ai.tool.call.id";
+    /** Metric-only dimension: which token bucket a measurement belongs to. */
+    readonly TOKEN_TYPE: "gen_ai.token.type";
+    /** Content-gated span attributes (only set when includeContent is on). */
+    readonly PROMPT: "gen_ai.prompt";
+    readonly COMPLETION: "gen_ai.completion";
+};
+/**
+ * agentic-pi-specific attribute keys, namespaced under `agentic_pi.*` to
+ * avoid colliding with any future standard key. Used where no stable GenAI
+ * equivalent exists yet (cache tokens, cost, tool error/args/result).
+ */
+export declare const AgenticPi: {
+    readonly CACHE_READ_TOKENS: "agentic_pi.usage.cache_read_tokens";
+    readonly CACHE_WRITE_TOKENS: "agentic_pi.usage.cache_write_tokens";
+    readonly COST_USD: "agentic_pi.usage.cost_usd";
+    readonly TOTAL_TOKENS: "agentic_pi.usage.total_tokens";
+    readonly TOOL_IS_ERROR: "agentic_pi.tool.is_error";
+    readonly TURN_INDEX: "agentic_pi.turn.index";
+    readonly SANDBOX_BACKEND: "agentic_pi.sandbox.backend";
+    /** Content-gated tool span attributes. */
+    readonly TOOL_ARGUMENTS: "agentic_pi.tool.arguments";
+    readonly TOOL_RESULT: "agentic_pi.tool.result";
+};
+/** Metric dimension value for {@link GenAI.TOKEN_TYPE}. */
+export declare const TokenType: {
+    readonly INPUT: "input";
+    readonly OUTPUT: "output";
+    readonly CACHE_READ: "cache_read";
+    readonly CACHE_WRITE: "cache_write";
+};
+/** Span names. Tool/LLM names embed the tool/model per GenAI span-naming guidance. */
+export declare const SpanName: {
+    readonly SESSION: "agentic_pi.session";
+    readonly TURN: "agentic_pi.turn";
+    readonly tool: (toolName: string) => string;
+    readonly llm: (model: string) => string;
+};
+/** Metric instrument names. */
+export declare const MetricName: {
+    readonly LLM_TOKENS: "gen_ai.client.token.usage";
+    readonly LLM_DURATION: "gen_ai.client.operation.duration";
+    readonly COST: "agentic_pi.cost.usd";
+    readonly TOOL_DURATION: "agentic_pi.tool.duration";
+    readonly TOOL_INVOCATIONS: "agentic_pi.tool.invocations";
+    readonly TOOL_FAILURES: "agentic_pi.tool.failures";
+    readonly TURNS: "agentic_pi.turns";
+};
+/** Default OTEL resource service name when neither flag nor env overrides it. */
+export declare const DEFAULT_SERVICE_NAME = "agentic-pi";

package/dist/telemetry/semconv.js

@@ -0,0 +1,73 @@
+/**
+ * Centralized OpenTelemetry attribute keys, span names, and metric names.
+ *
+ * Single source of truth so the still-evolving GenAI semantic conventions
+ * (`gen_ai.*`) are pinned in exactly one place. We hand-define the `gen_ai.*`
+ * keys as literals rather than importing them from
+ * `@opentelemetry/semantic-conventions/incubating`, because that incubating
+ * export path is unstable across minor releases — depending on the runtime
+ * values, not the package's export surface, keeps us insulated from churn.
+ */
+/** Stable GenAI semantic-convention attribute keys. */
+export const GenAI = {
+    SYSTEM: "gen_ai.system",
+    OPERATION_NAME: "gen_ai.operation.name",
+    CONVERSATION_ID: "gen_ai.conversation.id",
+    REQUEST_MODEL: "gen_ai.request.model",
+    RESPONSE_MODEL: "gen_ai.response.model",
+    RESPONSE_ID: "gen_ai.response.id",
+    RESPONSE_FINISH_REASONS: "gen_ai.response.finish_reasons",
+    USAGE_INPUT_TOKENS: "gen_ai.usage.input_tokens",
+    USAGE_OUTPUT_TOKENS: "gen_ai.usage.output_tokens",
+    TOOL_NAME: "gen_ai.tool.name",
+    TOOL_CALL_ID: "gen_ai.tool.call.id",
+    /** Metric-only dimension: which token bucket a measurement belongs to. */
+    TOKEN_TYPE: "gen_ai.token.type",
+    /** Content-gated span attributes (only set when includeContent is on). */
+    PROMPT: "gen_ai.prompt",
+    COMPLETION: "gen_ai.completion",
+};
+/**
+ * agentic-pi-specific attribute keys, namespaced under `agentic_pi.*` to
+ * avoid colliding with any future standard key. Used where no stable GenAI
+ * equivalent exists yet (cache tokens, cost, tool error/args/result).
+ */
+export const AgenticPi = {
+    CACHE_READ_TOKENS: "agentic_pi.usage.cache_read_tokens",
+    CACHE_WRITE_TOKENS: "agentic_pi.usage.cache_write_tokens",
+    COST_USD: "agentic_pi.usage.cost_usd",
+    TOTAL_TOKENS: "agentic_pi.usage.total_tokens",
+    TOOL_IS_ERROR: "agentic_pi.tool.is_error",
+    TURN_INDEX: "agentic_pi.turn.index",
+    SANDBOX_BACKEND: "agentic_pi.sandbox.backend",
+    /** Content-gated tool span attributes. */
+    TOOL_ARGUMENTS: "agentic_pi.tool.arguments",
+    TOOL_RESULT: "agentic_pi.tool.result",
+};
+/** Metric dimension value for {@link GenAI.TOKEN_TYPE}. */
+export const TokenType = {
+    INPUT: "input",
+    OUTPUT: "output",
+    CACHE_READ: "cache_read",
+    CACHE_WRITE: "cache_write",
+};
+/** Span names. Tool/LLM names embed the tool/model per GenAI span-naming guidance. */
+export const SpanName = {
+    SESSION: "agentic_pi.session",
+    TURN: "agentic_pi.turn",
+    tool: (toolName) => `execute_tool ${toolName}`,
+    llm: (model) => `chat ${model}`,
+};
+/** Metric instrument names. */
+export const MetricName = {
+    LLM_TOKENS: "gen_ai.client.token.usage",
+    LLM_DURATION: "gen_ai.client.operation.duration",
+    COST: "agentic_pi.cost.usd",
+    TOOL_DURATION: "agentic_pi.tool.duration",
+    TOOL_INVOCATIONS: "agentic_pi.tool.invocations",
+    TOOL_FAILURES: "agentic_pi.tool.failures",
+    TURNS: "agentic_pi.turns",
+};
+/** Default OTEL resource service name when neither flag nor env overrides it. */
+export const DEFAULT_SERVICE_NAME = "agentic-pi";
+//# sourceMappingURL=semconv.js.map

package/dist/telemetry/semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.js","sourceRoot":"","sources":["../../src/telemetry/semconv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,MAAM,EAAE,eAAe;IACvB,cAAc,EAAE,uBAAuB;IACvC,eAAe,EAAE,wBAAwB;IACzC,aAAa,EAAE,sBAAsB;IACrC,cAAc,EAAE,uBAAuB;IACvC,WAAW,EAAE,oBAAoB;IACjC,uBAAuB,EAAE,gCAAgC;IACzD,kBAAkB,EAAE,2BAA2B;IAC/C,mBAAmB,EAAE,4BAA4B;IACjD,SAAS,EAAE,kBAAkB;IAC7B,YAAY,EAAE,qBAAqB;IACnC,0EAA0E;IAC1E,UAAU,EAAE,mBAAmB;IAC/B,0EAA0E;IAC1E,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,mBAAmB;CACvB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iBAAiB,EAAE,oCAAoC;IACvD,kBAAkB,EAAE,qCAAqC;IACzD,QAAQ,EAAE,2BAA2B;IACrC,YAAY,EAAE,+BAA+B;IAC7C,aAAa,EAAE,0BAA0B;IACzC,UAAU,EAAE,uBAAuB;IACnC,eAAe,EAAE,4BAA4B;IAC7C,0CAA0C;IAC1C,cAAc,EAAE,2BAA2B;IAC3C,WAAW,EAAE,wBAAwB;CAC7B,CAAC;AAEX,2DAA2D;AAC3D,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;CAClB,CAAC;AAEX,sFAAsF;AACtF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,oBAAoB;IAC7B,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,CAAC,QAAgB,EAAU,EAAE,CAAC,gBAAgB,QAAQ,EAAE;IAC9D,GAAG,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,QAAQ,KAAK,EAAE;CACvC,CAAC;AAEX,+BAA+B;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU,EAAE,2BAA2B;IACvC,YAAY,EAAE,kCAAkC;IAChD,IAAI,EAAE,qBAAqB;IAC3B,aAAa,EAAE,0BAA0B;IACzC,gBAAgB,EAAE,6BAA6B;IAC/C,aAAa,EAAE,0BAA0B;IACzC,KAAK,EAAE,kBAAkB;CACjB,CAAC;AAEX,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-pi",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "A drop-in coding-agent harness built on earendil-works/pi, designed to replace opencode in workflow-driven systems like lastlight.",
   "license": "MIT",
   "repository": {
@@ -49,6 +49,15 @@
     "@ff-labs/pi-fff": "^0.9.4",
     "@octokit/auth-app": "^7.1.4",
     "@octokit/rest": "^21.0.2",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^2.8.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.219.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
+    "@opentelemetry/resources": "^2.8.0",
+    "@opentelemetry/sdk-metrics": "^2.8.0",
+    "@opentelemetry/sdk-trace-base": "^2.8.0",
+    "@opentelemetry/sdk-trace-node": "^2.8.0",
+    "@opentelemetry/semantic-conventions": "^1.41.0",
     "@sinclair/typebox": "^0.34.0",
     "@types/jsonwebtoken": "^9.0.10",
     "jsonwebtoken": "^9.0.3"