@amsterdamdatalabs/traces 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0 — 2026-05-18
+
+Initial release.
+
+- Canonical trace types and payload schemas for enact-os observability
+- `LlmCallPayload`, `LLM_CALL_STAGES`, `expandMessages`, `expandTools`, `flattenPayload`
+- Sub-path exports: `@amsterdamdatalabs/traces`, `@amsterdamdatalabs/traces/conventions`, `@amsterdamdatalabs/traces/emit`, `@amsterdamdatalabs/traces/payloads`

package/README.md

@@ -0,0 +1,89 @@
+<p align="center">
+  <strong>@amsterdamdatalabs/traces</strong>
+</p>
+<p align="center">
+  Shared OpenInference tracing types, span attribute constants, and event emit for enact-os packages
+</p>
+
+## What is it?
+
+`@amsterdamdatalabs/traces` is the canonical tracing contract for the enact-os observability stack. It provides:
+
+- **Payload schemas** — typed event payloads for every span kind: LLM calls, tool calls, memory reads/writes, proc-tap, agent lifecycle, hook-fired, cache hits, and hand runs
+- **Span attribute constants** — `enact.*` and `llm.*` extension attributes on top of the OpenInference semantic conventions
+- **Emit** — a zero-dependency `emitEvent()` that writes NDJSON to the watchdog dir and publishes to Apache Iggy in parallel
+
+Used by `enact-gateway`, `enact-factory`, `enact-memory`, `enact-agent`, and `enact-watchdog`.
+
+## Installation
+
+```bash
+npm install @amsterdamdatalabs/traces
+```
+
+## Usage
+
+### Emit a trace event
+
+```typescript
+import { emitEvent } from '@amsterdamdatalabs/traces/emit';
+import type { EnactRawV1Event } from '@amsterdamdatalabs/traces';
+
+const event: EnactRawV1Event = {
+  schema: 'enact.raw.v1',
+  ts: Date.now(),
+  span_kind: 'llm_call',
+  payload: { /* ... */ },
+};
+
+await emitEvent(event, { ndjsonFile: 'factory-events.ndjson' });
+```
+
+### Use span attribute constants
+
+```typescript
+import {
+  ENACT_ROUTING_TIER,
+  ENACT_PROVIDER,
+  LLM_ENDPOINT_KEY,
+} from '@amsterdamdatalabs/traces/conventions';
+
+span.setAttribute(ENACT_ROUTING_TIER, 'standard');
+span.setAttribute(ENACT_PROVIDER, 'anthropic');
+```
+
+### Use typed payloads
+
+```typescript
+import type { LlmCallPayload } from '@amsterdamdatalabs/traces/payloads';
+
+const payload: LlmCallPayload = {
+  model: 'claude-sonnet-4-6',
+  input_tokens: 1200,
+  output_tokens: 340,
+};
+```
+
+## Sub-path exports
+
+| Import | Contents |
+|--------|----------|
+| `@amsterdamdatalabs/traces` | All types, payloads, conventions, and emit |
+| `@amsterdamdatalabs/traces/conventions` | `enact.*` and `llm.*` span attribute constants |
+| `@amsterdamdatalabs/traces/payloads` | Typed payload schemas for each span kind |
+| `@amsterdamdatalabs/traces/emit` | `emitEvent()` — NDJSON + Iggy publish |
+
+## Environment variables
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `ENACT_WATCHDOG_DIR` | `.enact/watchdog` | Directory for NDJSON output files |
+| `IGGY_HTTP_URL` | `http://127.0.0.1:43214` | Apache Iggy HTTP endpoint |
+| `IGGY_HTTP_ACCESS_TOKEN` | — | Bearer token for Iggy auth |
+| `IGGY_HTTP_USERNAME` | `iggy` | Iggy username (if no token) |
+| `IGGY_HTTP_PASSWORD` | `iggy` | Iggy password (if no token) |
+| `ENACT_OBSERVABILITY_DEBUG` | — | Log emit errors to stderr |
+
+## License
+
+Proprietary — Copyright © 2026 Amsterdam Data Labs.

package/dist/conventions/enact-extensions.d.ts

@@ -0,0 +1,115 @@
+export declare const ENACT_ROUTING_TIER: "enact.routing_tier";
+export declare const ENACT_ROUTING_REASON: "enact.routing_reason";
+export declare const ENACT_SPECIFICITY_CATEGORY: "enact.specificity_category";
+export declare const ENACT_FALLBACK_FROM_MODEL: "enact.fallback_from_model";
+export declare const ENACT_AUTH_TYPE: "enact.auth_type";
+export declare const ENACT_PROVIDER: "enact.provider";
+export declare const ENACT_DURATION_MS: "enact.duration_ms";
+export declare const ENACT_SUCCESS: "enact.success";
+export declare const ENACT_ROUTING_DECISION_PATH: "enact.routing.decision_path";
+export declare const ENACT_ROUTING_CONFIDENCE: "enact.routing.confidence";
+export declare const ENACT_ROUTING_SCORE: "enact.routing.score";
+export declare const ENACT_ROUTING_IS_SPECIFICITY: "enact.routing.routing_is_specificity";
+export declare const ENACT_ROUTING_PASSTHROUGH_MATCH_SOURCE: "enact.routing.passthrough_match_source";
+export declare const ENACT_ROUTING_HEARTBEAT_DETECTED: "enact.routing.heartbeat_detected";
+export declare const ENACT_ROUTING_SCORING_MESSAGES_DROPPED: "enact.routing.scoring_messages_dropped";
+export declare const ENACT_ROUTING_SCORING_MESSAGES_TRUNCATED: "enact.routing.scoring_messages_truncated";
+export declare const ENACT_ROUTING_PROVIDER_KEY_LABEL: "enact.routing.provider_key_label";
+export declare const ENACT_ROUTING_HEADER_TIER_ID: "enact.routing.header_tier_id";
+export declare const ENACT_ROUTING_HEADER_TIER_NAME: "enact.routing.header_tier_name";
+export declare const ENACT_ROUTING_HEADER_TIER_COLOR: "enact.routing.header_tier_color";
+export declare const ENACT_ROUTING_BILLING_TYPE: "enact.routing.billing_type";
+export declare const ENACT_ROUTING_PARAM_DEFAULTS_SOURCE: "enact.routing.param_defaults_source";
+export declare const ENACT_ROUTING_PARAM_DEFAULTS_DROPPED: "enact.routing.param_defaults_dropped";
+export declare const ENACT_ROUTING_API_MODE_INBOUND: "enact.routing.api_mode_inbound";
+export declare const ENACT_ROUTING_FORWARDED_API_PATH: "enact.routing.forwarded_api_path";
+export declare const ENACT_ROUTING_ATTEMPT_INDEX: "enact.routing.attempt_index";
+export declare const ENACT_ROUTING_ATTEMPT_ROLE: "enact.routing.attempt_role";
+export declare const ENACT_ROUTING_ATTEMPT_COUNT: "enact.routing.attempt_count";
+export declare const ENACT_ROUTING_FALLBACK_CHAIN_SOURCE: "enact.routing.fallback_chain_source";
+export declare const ENACT_ROUTING_PROVIDERS_ATTEMPTED: "enact.routing.providers_attempted";
+export declare const ENACT_ROUTING_AUTH_TYPES_ATTEMPTED: "enact.routing.auth_types_attempted";
+export declare const ENACT_ROUTING_SKIPPED_ATTEMPTS: "enact.routing.skipped_attempts";
+export declare const ENACT_SPECIFICITY_CONFIDENCE: "enact.specificity.confidence";
+export declare const ENACT_SPECIFICITY_GATE_THRESHOLD: "enact.specificity.gate_threshold";
+export declare const ENACT_SPECIFICITY_MATCH_SOURCE: "enact.specificity.match_source";
+export declare const ENACT_SPECIFICITY_PENALTY_APPLIED: "enact.specificity.penalty_applied";
+export declare const ENACT_SPECIFICITY_ROUTE_SOURCE: "enact.specificity.route_source";
+export declare const ENACT_SPECIFICITY_FALLBACK_COUNT: "enact.specificity.fallback_count";
+export declare const ENACT_TIER_SLOT: "enact.tier.slot";
+export declare const ENACT_TIER_ROUTE_SOURCE: "enact.tier.route_source";
+export declare const ENACT_TIER_FALLBACK_COUNT: "enact.tier.fallback_count";
+export declare const ENACT_TIER_OVERRIDE_ACTIVE: "enact.tier.override_active";
+export declare const ENACT_TIER_AUTO_ASSIGNED_MODEL: "enact.tier.auto_assigned_model";
+export declare const ENACT_TIER_SLOTS_BACKFILLED: "enact.tier.slots_backfilled";
+export declare const ENACT_TRANSPORT_ERROR_CATEGORY: "enact.transport_error_category";
+export declare const ENACT_SSRF_REVALIDATED: "enact.ssrf_revalidated";
+export declare const ENACT_SSRF_PASSED: "enact.ssrf_passed";
+export declare const ENACT_WARMUP_OUTCOME: "enact.warmup.outcome";
+export declare const ENACT_WARMUP_DURATION_MS: "enact.warmup.duration_ms";
+export declare const ENACT_WARMUP_REASON: "enact.warmup.reason";
+export declare const ENACT_DEBUG_CAPTURE_ID: "enact.debug_capture_id";
+export declare const LLM_BODY_TRANSFORMATIONS: "llm.body.transformations";
+export declare const LLM_SYSTEM_MESSAGE_MERGE_APPLIED: "llm.system_message_merge_applied";
+export declare const LLM_CACHE_INJECTION_KIND: "llm.cache_injection.kind";
+export declare const LLM_CACHE_INJECTION_BREAKPOINT_COUNT: "llm.cache_injection.breakpoint_count";
+export declare const LLM_CODEX_RESPONSES_SHAPING_APPLIED: "llm.codex_responses_shaping_applied";
+export declare const LLM_COPILOT_FORCE_STREAM_APPLIED: "llm.copilot_force_stream_applied";
+export declare const LLM_ENDPOINT_KEY: "llm.endpoint_key";
+export declare const LLM_ENDPOINT_FORMAT: "llm.endpoint_format";
+export declare const LLM_ENDPOINT_BASE_URL_HOST: "llm.endpoint_base_url_host";
+export declare const LLM_API_VERSION: "llm.api_version";
+export declare const LLM_ENDPOINT_USED_CUSTOM: "llm.endpoint_used_custom";
+export declare const LLM_ENDPOINT_USED_REGION_OVERRIDE: "llm.endpoint_used_region_override";
+export declare const LLM_ENDPOINT_USED_SUBSCRIPTION: "llm.endpoint_used_subscription";
+export declare const ENACT_ROUTING_API_VERSION_SOURCE: "enact.routing.api_version_source";
+export declare const ENACT_CHANNEL: "enact.channel";
+export declare const ENACT_DIRECTION: "enact.direction";
+export declare const ENACT_HAND_NAME: "enact.hand_name";
+export declare const ENACT_FINDINGS_COUNT: "enact.findings_count";
+export declare const ENACT_DEPLOY_ID: "enact.deploy_id";
+export declare const ENACT_COMMIT_SHA: "enact.commit_sha";
+export declare const ENACT_REASON: "enact.reason";
+export declare const ENACT_COST_USD: "enact.cost_usd";
+export declare const ENACT_PATH: "enact.path";
+export declare const ENACT_COMMAND_HASH: "enact.command_hash";
+export declare const ENACT_TOKENS_BEFORE: "enact.tokens_before";
+export declare const ENACT_TOKENS_AFTER: "enact.tokens_after";
+export declare const ENACT_COMPRESSION_RATIO: "enact.compression_ratio";
+export declare const ENACT_PATTERN_COUNT: "enact.pattern_count";
+export declare const LLM_RESPONSE_TTFB_MS: "llm.response.ttfb_ms";
+export declare const LLM_RESPONSE_REQUEST_ID: "llm.response.request_id";
+export declare const LLM_RESPONSE_RATE_LIMIT_REMAINING_REQUESTS: "llm.response.rate_limit_remaining_requests";
+export declare const LLM_RESPONSE_RATE_LIMIT_REMAINING_TOKENS: "llm.response.rate_limit_remaining_tokens";
+export declare const LLM_RESPONSE_RATE_LIMIT_RESET: "llm.response.rate_limit_reset";
+export declare const LLM_RESPONSE_RETRY_AFTER: "llm.response.retry_after";
+export declare const LLM_RESPONSE_CONTENT_LENGTH: "llm.response.content_length";
+export declare const LLM_RESPONSE_UPSTREAM_WAS_STREAMING: "llm.response.upstream_was_streaming";
+export declare const ENACT_ACTOR: "enact.actor";
+export declare const ENACT_HOOK_EVENT: "enact.hook_event";
+export declare const ENACT_PRESET: "enact.preset";
+export declare const ENACT_OUTCOME: "enact.outcome";
+export declare const ENACT_VERDICT: "enact.verdict";
+export declare const ENACT_BLOCKERS: "enact.blockers";
+export declare const ENACT_ENTITY: "enact.entity";
+export declare const ENACT_ENTITY_ID: "enact.entity_id";
+export declare const ENACT_FROM_STATE: "enact.from_state";
+export declare const ENACT_TO_STATE: "enact.to_state";
+export declare const ENACT_TOOL: "enact.tool";
+export declare const ENACT_MODE: "enact.mode";
+export declare const ENACT_TOKENS_SAVED: "enact.tokens_saved";
+export declare const ENACT_VAULT: "enact.vault";
+export declare const ENACT_SEARCH_TYPE: "enact.search_type";
+export declare const ENACT_ITEMS_PROCESSED: "enact.items_processed";
+export declare const ENACT_QUERY_HASH: "enact.query_hash";
+export declare const ENACT_RESULTS_COUNT: "enact.results_count";
+export declare const ENACT_SLUG: "enact.slug";
+export declare const ENACT_MEMORY_TYPE: "enact.memory_type";
+export declare const ENACT_IMPORTANCE: "enact.importance";
+export declare const ENACT_SOURCE: "enact.source";
+export declare const ENACT_TOKENS_USED: "enact.tokens_used";
+export declare const ENACT_COMPONENT: "enact.component";
+export declare const ENACT_MESSAGE: "enact.message";
+export declare const ENACT_PID: "enact.pid";
+export declare const ENACT_COMMAND: "enact.command";
+export declare const ENACT_EXIT_CODE: "enact.exit_code";

package/dist/conventions/enact-extensions.js

@@ -0,0 +1,135 @@
+// enact.* extension attributes — gateway routing (existing)
+export const ENACT_ROUTING_TIER = 'enact.routing_tier';
+export const ENACT_ROUTING_REASON = 'enact.routing_reason';
+export const ENACT_SPECIFICITY_CATEGORY = 'enact.specificity_category';
+export const ENACT_FALLBACK_FROM_MODEL = 'enact.fallback_from_model';
+export const ENACT_AUTH_TYPE = 'enact.auth_type';
+export const ENACT_PROVIDER = 'enact.provider';
+export const ENACT_DURATION_MS = 'enact.duration_ms';
+export const ENACT_SUCCESS = 'enact.success';
+// enact.routing.* — routing decision detail (new, from gap analysis)
+export const ENACT_ROUTING_DECISION_PATH = 'enact.routing.decision_path';
+export const ENACT_ROUTING_CONFIDENCE = 'enact.routing.confidence';
+export const ENACT_ROUTING_SCORE = 'enact.routing.score';
+export const ENACT_ROUTING_IS_SPECIFICITY = 'enact.routing.routing_is_specificity';
+export const ENACT_ROUTING_PASSTHROUGH_MATCH_SOURCE = 'enact.routing.passthrough_match_source';
+export const ENACT_ROUTING_HEARTBEAT_DETECTED = 'enact.routing.heartbeat_detected';
+export const ENACT_ROUTING_SCORING_MESSAGES_DROPPED = 'enact.routing.scoring_messages_dropped';
+export const ENACT_ROUTING_SCORING_MESSAGES_TRUNCATED = 'enact.routing.scoring_messages_truncated';
+// enact.routing.* — route metadata
+export const ENACT_ROUTING_PROVIDER_KEY_LABEL = 'enact.routing.provider_key_label';
+export const ENACT_ROUTING_HEADER_TIER_ID = 'enact.routing.header_tier_id';
+export const ENACT_ROUTING_HEADER_TIER_NAME = 'enact.routing.header_tier_name';
+export const ENACT_ROUTING_HEADER_TIER_COLOR = 'enact.routing.header_tier_color';
+export const ENACT_ROUTING_BILLING_TYPE = 'enact.routing.billing_type';
+export const ENACT_ROUTING_PARAM_DEFAULTS_SOURCE = 'enact.routing.param_defaults_source';
+export const ENACT_ROUTING_PARAM_DEFAULTS_DROPPED = 'enact.routing.param_defaults_dropped';
+export const ENACT_ROUTING_API_MODE_INBOUND = 'enact.routing.api_mode_inbound';
+export const ENACT_ROUTING_FORWARDED_API_PATH = 'enact.routing.forwarded_api_path';
+// enact.routing.* — per-attempt detail
+export const ENACT_ROUTING_ATTEMPT_INDEX = 'enact.routing.attempt_index';
+export const ENACT_ROUTING_ATTEMPT_ROLE = 'enact.routing.attempt_role';
+export const ENACT_ROUTING_ATTEMPT_COUNT = 'enact.routing.attempt_count';
+export const ENACT_ROUTING_FALLBACK_CHAIN_SOURCE = 'enact.routing.fallback_chain_source';
+export const ENACT_ROUTING_PROVIDERS_ATTEMPTED = 'enact.routing.providers_attempted';
+export const ENACT_ROUTING_AUTH_TYPES_ATTEMPTED = 'enact.routing.auth_types_attempted';
+export const ENACT_ROUTING_SKIPPED_ATTEMPTS = 'enact.routing.skipped_attempts';
+// enact.specificity.* — specificity gate detail
+export const ENACT_SPECIFICITY_CONFIDENCE = 'enact.specificity.confidence';
+export const ENACT_SPECIFICITY_GATE_THRESHOLD = 'enact.specificity.gate_threshold';
+export const ENACT_SPECIFICITY_MATCH_SOURCE = 'enact.specificity.match_source';
+export const ENACT_SPECIFICITY_PENALTY_APPLIED = 'enact.specificity.penalty_applied';
+export const ENACT_SPECIFICITY_ROUTE_SOURCE = 'enact.specificity.route_source';
+export const ENACT_SPECIFICITY_FALLBACK_COUNT = 'enact.specificity.fallback_count';
+// enact.tier.* — tier state
+export const ENACT_TIER_SLOT = 'enact.tier.slot';
+export const ENACT_TIER_ROUTE_SOURCE = 'enact.tier.route_source';
+export const ENACT_TIER_FALLBACK_COUNT = 'enact.tier.fallback_count';
+export const ENACT_TIER_OVERRIDE_ACTIVE = 'enact.tier.override_active';
+export const ENACT_TIER_AUTO_ASSIGNED_MODEL = 'enact.tier.auto_assigned_model';
+export const ENACT_TIER_SLOTS_BACKFILLED = 'enact.tier.slots_backfilled';
+// enact.* — transport / SSRF / warmup
+export const ENACT_TRANSPORT_ERROR_CATEGORY = 'enact.transport_error_category';
+export const ENACT_SSRF_REVALIDATED = 'enact.ssrf_revalidated';
+export const ENACT_SSRF_PASSED = 'enact.ssrf_passed';
+export const ENACT_WARMUP_OUTCOME = 'enact.warmup.outcome';
+export const ENACT_WARMUP_DURATION_MS = 'enact.warmup.duration_ms';
+export const ENACT_WARMUP_REASON = 'enact.warmup.reason';
+export const ENACT_DEBUG_CAPTURE_ID = 'enact.debug_capture_id';
+// llm.* gateway extensions — body transformation (not in core OpenInference spec)
+export const LLM_BODY_TRANSFORMATIONS = 'llm.body.transformations';
+export const LLM_SYSTEM_MESSAGE_MERGE_APPLIED = 'llm.system_message_merge_applied';
+export const LLM_CACHE_INJECTION_KIND = 'llm.cache_injection.kind';
+export const LLM_CACHE_INJECTION_BREAKPOINT_COUNT = 'llm.cache_injection.breakpoint_count';
+export const LLM_CODEX_RESPONSES_SHAPING_APPLIED = 'llm.codex_responses_shaping_applied';
+export const LLM_COPILOT_FORCE_STREAM_APPLIED = 'llm.copilot_force_stream_applied';
+// llm.* gateway extensions — endpoint resolution
+export const LLM_ENDPOINT_KEY = 'llm.endpoint_key';
+export const LLM_ENDPOINT_FORMAT = 'llm.endpoint_format';
+export const LLM_ENDPOINT_BASE_URL_HOST = 'llm.endpoint_base_url_host';
+export const LLM_API_VERSION = 'llm.api_version';
+export const LLM_ENDPOINT_USED_CUSTOM = 'llm.endpoint_used_custom';
+export const LLM_ENDPOINT_USED_REGION_OVERRIDE = 'llm.endpoint_used_region_override';
+export const LLM_ENDPOINT_USED_SUBSCRIPTION = 'llm.endpoint_used_subscription';
+export const ENACT_ROUTING_API_VERSION_SOURCE = 'enact.routing.api_version_source';
+// enact.* extension attributes — agent channel messages
+export const ENACT_CHANNEL = 'enact.channel';
+export const ENACT_DIRECTION = 'enact.direction';
+// enact.* extension attributes — hand runs
+export const ENACT_HAND_NAME = 'enact.hand_name';
+export const ENACT_FINDINGS_COUNT = 'enact.findings_count';
+// enact.* extension attributes — deployments
+export const ENACT_DEPLOY_ID = 'enact.deploy_id';
+export const ENACT_COMMIT_SHA = 'enact.commit_sha';
+export const ENACT_REASON = 'enact.reason';
+// enact.* extension attributes — cost
+export const ENACT_COST_USD = 'enact.cost_usd';
+// enact.* extension attributes — context compression
+export const ENACT_PATH = 'enact.path';
+export const ENACT_COMMAND_HASH = 'enact.command_hash';
+export const ENACT_TOKENS_BEFORE = 'enact.tokens_before';
+export const ENACT_TOKENS_AFTER = 'enact.tokens_after';
+export const ENACT_COMPRESSION_RATIO = 'enact.compression_ratio';
+export const ENACT_PATTERN_COUNT = 'enact.pattern_count';
+// llm.* gateway extensions — upstream response metadata
+export const LLM_RESPONSE_TTFB_MS = 'llm.response.ttfb_ms';
+export const LLM_RESPONSE_REQUEST_ID = 'llm.response.request_id';
+export const LLM_RESPONSE_RATE_LIMIT_REMAINING_REQUESTS = 'llm.response.rate_limit_remaining_requests';
+export const LLM_RESPONSE_RATE_LIMIT_REMAINING_TOKENS = 'llm.response.rate_limit_remaining_tokens';
+export const LLM_RESPONSE_RATE_LIMIT_RESET = 'llm.response.rate_limit_reset';
+export const LLM_RESPONSE_RETRY_AFTER = 'llm.response.retry_after';
+export const LLM_RESPONSE_CONTENT_LENGTH = 'llm.response.content_length';
+export const LLM_RESPONSE_UPSTREAM_WAS_STREAMING = 'llm.response.upstream_was_streaming';
+// enact.* extension attributes — factory / hooks
+export const ENACT_ACTOR = 'enact.actor';
+export const ENACT_HOOK_EVENT = 'enact.hook_event';
+export const ENACT_PRESET = 'enact.preset';
+export const ENACT_OUTCOME = 'enact.outcome';
+export const ENACT_VERDICT = 'enact.verdict';
+export const ENACT_BLOCKERS = 'enact.blockers';
+export const ENACT_ENTITY = 'enact.entity';
+export const ENACT_ENTITY_ID = 'enact.entity_id';
+export const ENACT_FROM_STATE = 'enact.from_state';
+export const ENACT_TO_STATE = 'enact.to_state';
+// enact.* extension attributes — context
+export const ENACT_TOOL = 'enact.tool';
+export const ENACT_MODE = 'enact.mode';
+export const ENACT_TOKENS_SAVED = 'enact.tokens_saved';
+// enact.* extension attributes — memory
+export const ENACT_VAULT = 'enact.vault';
+export const ENACT_SEARCH_TYPE = 'enact.search_type';
+export const ENACT_ITEMS_PROCESSED = 'enact.items_processed';
+export const ENACT_QUERY_HASH = 'enact.query_hash';
+export const ENACT_RESULTS_COUNT = 'enact.results_count';
+export const ENACT_SLUG = 'enact.slug';
+export const ENACT_MEMORY_TYPE = 'enact.memory_type';
+export const ENACT_IMPORTANCE = 'enact.importance';
+// enact.* extension attributes — agent
+export const ENACT_SOURCE = 'enact.source';
+export const ENACT_TOKENS_USED = 'enact.tokens_used';
+export const ENACT_COMPONENT = 'enact.component';
+export const ENACT_MESSAGE = 'enact.message';
+// enact.* extension attributes — proc-tap
+export const ENACT_PID = 'enact.pid';
+export const ENACT_COMMAND = 'enact.command';
+export const ENACT_EXIT_CODE = 'enact.exit_code';

package/dist/conventions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './openinference.js';
+export * from './enact-extensions.js';

package/dist/conventions/index.js

@@ -0,0 +1,2 @@
+export * from './openinference.js';
+export * from './enact-extensions.js';

package/dist/conventions/openinference.d.ts

@@ -0,0 +1 @@
+export { SemanticConventions, OpenInferenceSpanKind, MimeType, LLMSystem, LLMProvider, SemanticAttributePrefixes, LLMAttributePostfixes, LLM_MODEL_NAME, LLM_SYSTEM, LLM_PROVIDER, LLM_INPUT_MESSAGES, LLM_OUTPUT_MESSAGES, LLM_INVOCATION_PARAMETERS, LLM_TOKEN_COUNT_PROMPT, LLM_TOKEN_COUNT_COMPLETION, LLM_TOKEN_COUNT_TOTAL, LLM_TOKEN_COUNT_PROMPT_DETAILS_CACHE_WRITE, LLM_TOKEN_COUNT_PROMPT_DETAILS_CACHE_READ, LLM_TOKEN_COUNT_COMPLETION_DETAILS_REASONING, LLM_FINISH_REASON, LLM_TOOLS, LLM_PROMPTS, LLM_COST, LLM_COST_PROMPT, LLM_COST_COMPLETION, LLM_COST_TOTAL, INPUT_VALUE, INPUT_MIME_TYPE, OUTPUT_VALUE, OUTPUT_MIME_TYPE, MESSAGE_ROLE, MESSAGE_CONTENT, MESSAGE_CONTENTS, MESSAGE_NAME, MESSAGE_TOOL_CALLS, MESSAGE_TOOL_CALL_ID, TOOL_CALL_FUNCTION_NAME, TOOL_CALL_FUNCTION_ARGUMENTS_JSON, TOOL_CALL_ID, TOOL_NAME, TOOL_DESCRIPTION, TOOL_PARAMETERS, TOOL_JSON_SCHEMA, TOOL_ID, RETRIEVAL_DOCUMENTS, DOCUMENT_ID, DOCUMENT_CONTENT, DOCUMENT_SCORE, DOCUMENT_METADATA, EMBEDDING_EMBEDDINGS, EMBEDDING_TEXT, EMBEDDING_MODEL_NAME, EMBEDDING_VECTOR, SESSION_ID, USER_ID, METADATA, TAG_TAGS, PROMPT_TEMPLATE_VARIABLES, PROMPT_TEMPLATE_TEMPLATE, PROMPT_TEMPLATE_VERSION, AGENT_NAME, GRAPH_NODE_ID, GRAPH_NODE_NAME, GRAPH_NODE_PARENT_ID, } from '@arizeai/openinference-semantic-conventions';

package/dist/conventions/openinference.js

@@ -0,0 +1,19 @@
+export { SemanticConventions, OpenInferenceSpanKind, MimeType, LLMSystem, LLMProvider, SemanticAttributePrefixes, LLMAttributePostfixes, 
+// Individual attribute constants — llm.*
+LLM_MODEL_NAME, LLM_SYSTEM, LLM_PROVIDER, LLM_INPUT_MESSAGES, LLM_OUTPUT_MESSAGES, LLM_INVOCATION_PARAMETERS, LLM_TOKEN_COUNT_PROMPT, LLM_TOKEN_COUNT_COMPLETION, LLM_TOKEN_COUNT_TOTAL, LLM_TOKEN_COUNT_PROMPT_DETAILS_CACHE_WRITE, LLM_TOKEN_COUNT_PROMPT_DETAILS_CACHE_READ, LLM_TOKEN_COUNT_COMPLETION_DETAILS_REASONING, LLM_FINISH_REASON, LLM_TOOLS, LLM_PROMPTS, LLM_COST, LLM_COST_PROMPT, LLM_COST_COMPLETION, LLM_COST_TOTAL, 
+// input / output
+INPUT_VALUE, INPUT_MIME_TYPE, OUTPUT_VALUE, OUTPUT_MIME_TYPE, 
+// message attributes
+MESSAGE_ROLE, MESSAGE_CONTENT, MESSAGE_CONTENTS, MESSAGE_NAME, MESSAGE_TOOL_CALLS, MESSAGE_TOOL_CALL_ID, 
+// tool call attributes
+TOOL_CALL_FUNCTION_NAME, TOOL_CALL_FUNCTION_ARGUMENTS_JSON, TOOL_CALL_ID, TOOL_NAME, TOOL_DESCRIPTION, TOOL_PARAMETERS, TOOL_JSON_SCHEMA, TOOL_ID, 
+// document / retrieval
+RETRIEVAL_DOCUMENTS, DOCUMENT_ID, DOCUMENT_CONTENT, DOCUMENT_SCORE, DOCUMENT_METADATA, 
+// embedding
+EMBEDDING_EMBEDDINGS, EMBEDDING_TEXT, EMBEDDING_MODEL_NAME, EMBEDDING_VECTOR, 
+// session / user / metadata
+SESSION_ID, USER_ID, METADATA, TAG_TAGS, 
+// prompt template
+PROMPT_TEMPLATE_VARIABLES, PROMPT_TEMPLATE_TEMPLATE, PROMPT_TEMPLATE_VERSION, 
+// agent / graph
+AGENT_NAME, GRAPH_NODE_ID, GRAPH_NODE_NAME, GRAPH_NODE_PARENT_ID, } from '@arizeai/openinference-semantic-conventions';

package/dist/emit/emit.d.ts

@@ -0,0 +1,11 @@
+import type { EnactRawV1Event } from '../types/envelope.js';
+export type { EnactRawV1Event };
+export interface EmitOptions {
+    /** NDJSON filename within the watchdog dir, e.g. 'factory-events.ndjson' */
+    ndjsonFile: string;
+    /** Override ENACT_WATCHDOG_DIR env var */
+    watchdogDir?: string;
+    /** Override IGGY_HTTP_URL env var */
+    iggyUrl?: string;
+}
+export declare function emitEvent(event: EnactRawV1Event, opts: EmitOptions): Promise<void>;

package/dist/emit/emit.js

@@ -0,0 +1,80 @@
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_IGGY_URL = 'http://127.0.0.1:43214';
+export async function emitEvent(event, opts) {
+    const watchdogDir = opts.watchdogDir ?? process.env.ENACT_WATCHDOG_DIR ?? '.enact/watchdog';
+    mkdirSync(watchdogDir, { recursive: true });
+    const ndjsonPath = join(watchdogDir, opts.ndjsonFile);
+    const rawIggyUrl = opts.iggyUrl ?? process.env.IGGY_HTTP_URL;
+    const iggyUrl = !rawIggyUrl || rawIggyUrl === 'undefined' || rawIggyUrl === 'null'
+        ? DEFAULT_IGGY_URL
+        : rawIggyUrl;
+    const results = await Promise.allSettled([
+        Promise.resolve().then(() => {
+            appendFileSync(ndjsonPath, `${JSON.stringify(event)}\n`, 'utf8');
+        }),
+        publishToIggy(iggyUrl, event),
+    ]);
+    for (const result of results) {
+        if (result.status === 'rejected') {
+            if (process.env.ENACT_OBSERVABILITY_DEBUG) {
+                console.error(`[enact-traces] emit error: ${String(result.reason)}`);
+            }
+        }
+    }
+}
+async function publishToIggy(baseUrl, event) {
+    const authHeader = await resolveIggyAuthHeader(baseUrl);
+    const payload = {
+        partitioning: { kind: 'balanced', value: '' },
+        messages: [
+            {
+                id: 0,
+                payload: Buffer.from(JSON.stringify(event)).toString('base64'),
+            },
+        ],
+    };
+    try {
+        const response = await fetch(`${baseUrl}/streams/enact-telemetry/topics/worker_telemetry/messages`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: authHeader,
+            },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(500),
+        });
+        if (!response.ok) {
+            throw new Error(`Iggy publish failed: ${response.status}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('ECONNREFUSED') || message.includes('fetch failed')) {
+            return;
+        }
+        throw error;
+    }
+}
+async function resolveIggyAuthHeader(baseUrl) {
+    const rawToken = process.env.IGGY_HTTP_ACCESS_TOKEN ?? process.env.IGGY_ACCESS_TOKEN;
+    if (rawToken?.trim()) {
+        return `Bearer ${rawToken.trim()}`;
+    }
+    const username = process.env.IGGY_HTTP_USERNAME ?? process.env.IGGY_ROOT_USERNAME ?? 'iggy';
+    const password = process.env.IGGY_HTTP_PASSWORD ?? process.env.IGGY_ROOT_PASSWORD ?? 'iggy';
+    const response = await fetch(`${baseUrl}/users/login`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ username, password }),
+        signal: AbortSignal.timeout(500),
+    });
+    if (!response.ok) {
+        throw new Error(`Iggy login failed: ${response.status}`);
+    }
+    const data = (await response.json());
+    const token = data.access_token?.token;
+    if (!token)
+        throw new Error('Iggy login response missing access token');
+    return `Bearer ${token}`;
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './conventions/index.js';
+export * from './types/index.js';
+export * from './payloads/index.js';
+export * from './emit/emit.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './conventions/index.js';
+export * from './types/index.js';
+export * from './payloads/index.js';
+export * from './emit/emit.js';

package/dist/payloads/agent-lifecycle.d.ts

@@ -0,0 +1,27 @@
+export interface AgentThreadStartedPayload {
+    'openinference.span.kind': 'AGENT';
+    'enact.source'?: string;
+    'session.id'?: string;
+    [key: string]: unknown;
+}
+export interface AgentTurnPayload {
+    'openinference.span.kind': 'AGENT';
+    'enact.source'?: string;
+    turn_index?: number;
+    [key: string]: unknown;
+}
+export interface AgentTokenUsagePayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.source'?: string;
+    'enact.tokens_used'?: number;
+    'llm.token_count.prompt'?: number;
+    'llm.token_count.completion'?: number;
+    'llm.token_count.total'?: number;
+}
+export interface AgentErrorPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.component'?: string;
+    'enact.message'?: string;
+    error_type?: string;
+}
+export type AgentLifecyclePayload = AgentThreadStartedPayload | AgentTurnPayload | AgentTokenUsagePayload | AgentErrorPayload;

package/dist/payloads/agent-lifecycle.js

@@ -0,0 +1 @@
+export {};

package/dist/payloads/cache-hit.d.ts

@@ -0,0 +1,17 @@
+export interface CacheHitPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.tool'?: string;
+    'enact.mode'?: string;
+    'enact.tokens_saved'?: number;
+}
+export interface CacheMissPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.tool'?: string;
+    'enact.mode'?: string;
+}
+export interface ShellCompressedPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.tool'?: string;
+    'enact.tokens_saved'?: number;
+    command?: string;
+}

package/dist/payloads/cache-hit.js

@@ -0,0 +1 @@
+export {};

package/dist/payloads/hand.d.ts

@@ -0,0 +1,8 @@
+export interface HandPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.hand_name': string;
+    'enact.success': boolean;
+    'enact.findings_count'?: number;
+    'enact.duration_ms'?: number;
+    'exception.message'?: string;
+}

package/dist/payloads/hand.js

@@ -0,0 +1 @@
+export {};

package/dist/payloads/hook-fired.d.ts

@@ -0,0 +1,21 @@
+export interface HookFiredPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.hook_event': string;
+    'enact.preset'?: string;
+    'enact.outcome': string;
+    'enact.duration_ms'?: number;
+    'input.value'?: string;
+    'output.value'?: string;
+}
+export interface StopVerdictPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.verdict': string;
+    'enact.blockers'?: string[];
+}
+export interface StateTransitionPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.entity': string;
+    'enact.entity_id'?: string;
+    'enact.from_state': string;
+    'enact.to_state': string;
+}

package/dist/payloads/hook-fired.js

@@ -0,0 +1 @@
+export {};

package/dist/payloads/index.d.ts

@@ -0,0 +1,9 @@
+export * from './llm-call.js';
+export * from './hook-fired.js';
+export * from './tool-call.js';
+export * from './memory-search.js';
+export * from './memory-write.js';
+export * from './cache-hit.js';
+export * from './agent-lifecycle.js';
+export * from './proc-tap.js';
+export * from './hand.js';

package/dist/payloads/index.js

@@ -0,0 +1,9 @@
+export * from './llm-call.js';
+export * from './hook-fired.js';
+export * from './tool-call.js';
+export * from './memory-search.js';
+export * from './memory-write.js';
+export * from './cache-hit.js';
+export * from './agent-lifecycle.js';
+export * from './proc-tap.js';
+export * from './hand.js';

package/dist/payloads/llm-call.d.ts

@@ -0,0 +1,135 @@
+export declare const LLM_CALL_STAGES: readonly ["request.received", "request.normalized", "request.scored", "request.limit_blocked", "request.credentials_missing", "request.provider-bound", "request.warmup_failed", "routing.attempt.started", "routing.attempt.skipped", "routing.attempt.failed", "routing.attempt.succeeded", "routing.fallback.chain_resolved", "routing.fallback.exhausted", "provider.endpoint.resolved", "provider.body.transformed", "provider.model.normalized", "provider.fetch.completed", "provider.fetch.transport_failed", "response.headers", "response.body.observed", "response.streaming.partial", "response.transformed", "response.completed", "response.interrupted"];
+export type LlmCallStage = (typeof LLM_CALL_STAGES)[number];
+export interface LlmToolCallInMessage {
+    'tool_call.id'?: string;
+    'tool_call.function.name': string;
+    'tool_call.function.arguments': string;
+}
+export interface LlmMessage {
+    'message.role': 'system' | 'user' | 'assistant' | 'tool';
+    'message.content'?: string | null;
+    /** For assistant messages that request tool calls */
+    'message.tool_calls'?: LlmToolCallInMessage[];
+    /** For tool result messages (role=tool) */
+    'message.tool_call_id'?: string;
+    /** For tool result messages — the function name that produced this result */
+    'message.name'?: string;
+}
+export interface LlmToolDefinition {
+    'tool.json_schema': string;
+}
+export interface LlmCallPayload {
+    stage: LlmCallStage;
+    'llm.system'?: string;
+    'llm.model_name'?: string;
+    'llm.provider'?: string;
+    'llm.invocation_parameters'?: string;
+    'llm.finish_reason'?: string;
+    'llm.token_count.prompt'?: number;
+    'llm.token_count.completion'?: number;
+    'llm.token_count.total'?: number;
+    'llm.token_count.prompt_details.cache_write'?: number;
+    'llm.token_count.prompt_details.cache_read'?: number;
+    'llm.token_count.prompt_details.audio'?: number;
+    'llm.token_count.completion_details.reasoning'?: number;
+    'llm.token_count.completion_details.audio'?: number;
+    'llm.cost.prompt'?: number;
+    'llm.cost.completion'?: number;
+    'llm.cost.total'?: number;
+    'llm.cost.prompt_details.input'?: number;
+    'llm.cost.prompt_details.cache_write'?: number;
+    'llm.cost.prompt_details.cache_read'?: number;
+    'llm.cost.prompt_details.cache_input'?: number;
+    'llm.cost.prompt_details.audio'?: number;
+    'llm.cost.completion_details.output'?: number;
+    'llm.cost.completion_details.reasoning'?: number;
+    'llm.cost.completion_details.audio'?: number;
+    'openinference.span.kind'?: string;
+    'input.value'?: string;
+    'input.mime_type'?: string;
+    'output.value'?: string;
+    'output.mime_type'?: string;
+    'enact.routing_tier'?: string;
+    'enact.routing_reason'?: string;
+    'enact.specificity_category'?: string | null;
+    'enact.fallback_from_model'?: string | null;
+    'enact.auth_type'?: string;
+    'enact.provider'?: string;
+    'enact.duration_ms'?: number;
+    'enact.success'?: boolean;
+    'enact.routing.decision_path'?: string;
+    'enact.routing.confidence'?: number;
+    'enact.routing.score'?: number;
+    'enact.routing.routing_is_specificity'?: boolean;
+    'enact.routing.passthrough_match_source'?: string;
+    'enact.routing.heartbeat_detected'?: boolean;
+    'enact.routing.scoring_messages_dropped'?: number;
+    'enact.routing.scoring_messages_truncated'?: number;
+    'enact.routing.provider_key_label'?: string;
+    'enact.routing.header_tier_id'?: string;
+    'enact.routing.header_tier_name'?: string;
+    'enact.routing.header_tier_color'?: string;
+    'enact.routing.billing_type'?: string;
+    'enact.routing.param_defaults_source'?: string;
+    'enact.routing.param_defaults_dropped'?: number;
+    'enact.routing.api_mode_inbound'?: string;
+    'enact.routing.forwarded_api_path'?: string;
+    'enact.routing.attempt_index'?: number;
+    'enact.routing.attempt_role'?: 'primary' | 'fallback';
+    'enact.routing.attempt_count'?: number;
+    'enact.routing.fallback_chain_source'?: string;
+    'enact.routing.providers_attempted'?: string[];
+    'enact.routing.auth_types_attempted'?: string[];
+    'enact.routing.skipped_attempts'?: number;
+    'enact.specificity.confidence'?: number;
+    'enact.specificity.gate_threshold'?: number;
+    'enact.specificity.match_source'?: string;
+    'enact.specificity.penalty_applied'?: boolean;
+    'enact.specificity.route_source'?: string;
+    'enact.specificity.fallback_count'?: number;
+    'enact.tier.slot'?: string;
+    'enact.tier.route_source'?: string;
+    'enact.tier.fallback_count'?: number;
+    'enact.tier.override_active'?: boolean;
+    'enact.tier.auto_assigned_model'?: string;
+    'enact.tier.slots_backfilled'?: string[];
+    'llm.body.transformations'?: string[];
+    'llm.system_message_merge_applied'?: boolean;
+    'llm.cache_injection.kind'?: string;
+    'llm.cache_injection.breakpoint_count'?: number;
+    'llm.codex_responses_shaping_applied'?: boolean;
+    'llm.copilot_force_stream_applied'?: boolean;
+    'llm.endpoint_key'?: string;
+    'llm.endpoint_format'?: string;
+    'llm.endpoint_base_url_host'?: string;
+    'llm.api_version'?: string;
+    'llm.endpoint_used_custom'?: boolean;
+    'llm.endpoint_used_region_override'?: boolean;
+    'llm.endpoint_used_subscription'?: boolean;
+    'enact.routing.api_version_source'?: string;
+    'llm.response.ttfb_ms'?: number;
+    'llm.response.request_id'?: string;
+    'llm.response.rate_limit_remaining_requests'?: number;
+    'llm.response.rate_limit_remaining_tokens'?: number;
+    'llm.response.rate_limit_reset'?: string;
+    'llm.response.retry_after'?: number;
+    'llm.response.content_length'?: number;
+    'llm.response.upstream_was_streaming'?: boolean;
+    'enact.transport_error_category'?: string;
+    'enact.ssrf_revalidated'?: boolean;
+    'enact.ssrf_passed'?: boolean;
+    'enact.warmup.outcome'?: string;
+    'enact.warmup.duration_ms'?: number;
+    'enact.warmup.reason'?: string;
+    'enact.debug_capture_id'?: string;
+    _input_messages?: LlmMessage[];
+    _output_messages?: LlmMessage[];
+    _tools?: LlmToolDefinition[];
+    request_message_count?: number;
+    stream?: boolean;
+    extras?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare function expandMessages(prefix: 'llm.input_messages' | 'llm.output_messages', messages: LlmMessage[]): Record<string, unknown>;
+export declare function expandTools(tools: LlmToolDefinition[]): Record<string, unknown>;
+export declare function flattenPayload(payload: LlmCallPayload): LlmCallPayload;

package/dist/payloads/llm-call.js

@@ -0,0 +1,84 @@
+export const LLM_CALL_STAGES = [
+    // Request lifecycle
+    'request.received',
+    'request.normalized',
+    'request.scored',
+    'request.limit_blocked',
+    'request.credentials_missing',
+    'request.provider-bound',
+    'request.warmup_failed',
+    // Routing attempt lifecycle (emitted once per upstream call)
+    'routing.attempt.started',
+    'routing.attempt.skipped',
+    'routing.attempt.failed',
+    'routing.attempt.succeeded',
+    'routing.fallback.chain_resolved',
+    'routing.fallback.exhausted',
+    // Provider-side events
+    'provider.endpoint.resolved',
+    'provider.body.transformed',
+    'provider.model.normalized',
+    'provider.fetch.completed',
+    'provider.fetch.transport_failed',
+    // Response lifecycle
+    'response.headers',
+    'response.body.observed',
+    'response.streaming.partial',
+    'response.transformed',
+    'response.completed',
+    'response.interrupted',
+];
+// ── Helpers: expand structured messages/tools into flat indexed OI attributes ──
+export function expandMessages(prefix, messages) {
+    const attrs = {};
+    messages.forEach((msg, i) => {
+        const base = `${prefix}.${i}.message`;
+        attrs[`${base}.role`] = msg['message.role'];
+        if (msg['message.content'] !== undefined) {
+            attrs[`${base}.content`] = msg['message.content'];
+        }
+        if (msg['message.tool_call_id'] !== undefined) {
+            attrs[`${base}.tool_call_id`] = msg['message.tool_call_id'];
+        }
+        if (msg['message.name'] !== undefined) {
+            attrs[`${base}.name`] = msg['message.name'];
+        }
+        if (msg['message.tool_calls']) {
+            msg['message.tool_calls'].forEach((tc, j) => {
+                const tcBase = `${base}.tool_calls.${j}.tool_call`;
+                if (tc['tool_call.id'])
+                    attrs[`${tcBase}.id`] = tc['tool_call.id'];
+                attrs[`${tcBase}.function.name`] = tc['tool_call.function.name'];
+                attrs[`${tcBase}.function.arguments`] = tc['tool_call.function.arguments'];
+            });
+        }
+    });
+    return attrs;
+}
+export function expandTools(tools) {
+    const attrs = {};
+    tools.forEach((t, i) => {
+        attrs[`llm.tools.${i}.tool.json_schema`] = t['tool.json_schema'];
+    });
+    return attrs;
+}
+export function flattenPayload(payload) {
+    const { _input_messages, _output_messages, _tools, ...rest } = payload;
+    const flat = { ...rest };
+    if (_input_messages?.length) {
+        Object.assign(flat, expandMessages('llm.input_messages', _input_messages));
+        const lastUser = [..._input_messages].reverse().find((m) => m['message.role'] === 'user');
+        if (lastUser?.['message.content'])
+            flat['input.value'] = lastUser['message.content'];
+    }
+    if (_output_messages?.length) {
+        Object.assign(flat, expandMessages('llm.output_messages', _output_messages));
+        const assistant = _output_messages.find((m) => m['message.role'] === 'assistant');
+        if (assistant?.['message.content'])
+            flat['output.value'] = assistant['message.content'];
+    }
+    if (_tools?.length) {
+        Object.assign(flat, expandTools(_tools));
+    }
+    return flat;
+}

package/dist/payloads/memory-search.d.ts

@@ -0,0 +1,21 @@
+export interface MemorySearchPayload {
+    'openinference.span.kind': 'RETRIEVER';
+    'input.value'?: string;
+    'retrieval.documents'?: unknown[];
+    'enact.query_hash'?: string;
+    'enact.results_count'?: number;
+    'enact.duration_ms'?: number;
+}
+export interface MemoryWritePayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.slug'?: string;
+    'enact.memory_type'?: string;
+    'enact.importance'?: number;
+    'input.value'?: string;
+}
+export interface MemoryLifecyclePayload {
+    'openinference.span.kind': 'CHAIN';
+    lifecycle_event: string;
+    'enact.memory_type'?: string;
+    [key: string]: unknown;
+}

package/dist/payloads/memory-search.js

@@ -0,0 +1 @@
+export {};

package/dist/payloads/memory-write.d.ts

@@ -0,0 +1 @@
+export { MemoryWritePayload, MemoryLifecyclePayload } from './memory-search.js';

package/dist/payloads/memory-write.js

@@ -0,0 +1 @@
+export {};

package/dist/payloads/proc-tap.d.ts

@@ -0,0 +1,20 @@
+export interface ProcessStartPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.pid'?: number;
+    'enact.command'?: string;
+    cwd?: string;
+    args?: string[];
+}
+export interface ProcessExitPayload {
+    'openinference.span.kind': 'CHAIN';
+    'enact.pid'?: number;
+    'enact.exit_code'?: number;
+    'enact.duration_ms'?: number;
+}
+export interface ProcessMetricsPayload {
+    'openinference.span.kind': 'CHAIN';
+    metric_type: 'cpu' | 'memory' | 'idle';
+    'enact.pid'?: number;
+    value?: number;
+    [key: string]: unknown;
+}

package/dist/payloads/proc-tap.js

@@ -0,0 +1 @@
+export {};

package/dist/payloads/tool-call.d.ts

@@ -0,0 +1,11 @@
+export interface ToolCallPayload {
+    'openinference.span.kind': 'TOOL';
+    'tool.name': string;
+    'tool.description'?: string;
+    'tool.parameters'?: string;
+    'input.value'?: string;
+    'output.value'?: string;
+    'enact.duration_ms'?: number;
+    'enact.success'?: boolean;
+    caller?: string;
+}

package/dist/payloads/tool-call.js

@@ -0,0 +1 @@
+export {};

package/dist/types/context.d.ts

@@ -0,0 +1,16 @@
+export interface LlmCallContext {
+    sessionId: string;
+    runId: string;
+    correlationId: string;
+    authType?: string;
+    agentId?: string;
+    startedAt: number;
+    _seq: {
+        value: number;
+    };
+}
+export interface EventContext {
+    sessionId: string;
+    runId: string;
+    source: string;
+}

package/dist/types/context.js

@@ -0,0 +1 @@
+export {};

package/dist/types/envelope.d.ts

@@ -0,0 +1,15 @@
+import type { LlmCallPayload, HookFiredPayload, ToolCallPayload, MemorySearchPayload, MemoryWritePayload, CacheHitPayload, AgentLifecyclePayload } from '../payloads/index.js';
+export type EventPayload = LlmCallPayload | HookFiredPayload | ToolCallPayload | MemorySearchPayload | MemoryWritePayload | CacheHitPayload | AgentLifecyclePayload | Record<string, unknown>;
+export interface EnactRawV1Event {
+    schema_version: 'enact.raw.v1';
+    source: string;
+    event_type: string;
+    ts: string;
+    session_id: string;
+    run_id: string;
+    seq?: number;
+    pid?: number;
+    parent_pid?: number;
+    correlation_id?: string;
+    payload: EventPayload;
+}

package/dist/types/envelope.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './envelope.js';
+export * from './context.js';
+export * from './span-kinds.js';

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export * from './envelope.js';
+export * from './context.js';
+export * from './span-kinds.js';

package/dist/types/span-kinds.d.ts

@@ -0,0 +1,14 @@
+export { OpenInferenceSpanKind } from '@arizeai/openinference-semantic-conventions';
+export declare const OPENINFERENCE_SPAN_KIND: "openinference.span.kind";
+export declare const SpanKindMap: {
+    readonly llmCall: "LLM";
+    readonly agent: "AGENT";
+    readonly tool: "TOOL";
+    readonly chain: "CHAIN";
+    readonly retriever: "RETRIEVER";
+    readonly reranker: "RERANKER";
+    readonly embedding: "EMBEDDING";
+    readonly guardrail: "GUARDRAIL";
+    readonly evaluator: "EVALUATOR";
+    readonly prompt: "PROMPT";
+};

package/dist/types/span-kinds.js

@@ -0,0 +1,14 @@
+export { OpenInferenceSpanKind } from '@arizeai/openinference-semantic-conventions';
+export const OPENINFERENCE_SPAN_KIND = 'openinference.span.kind';
+export const SpanKindMap = {
+    llmCall: 'LLM',
+    agent: 'AGENT',
+    tool: 'TOOL',
+    chain: 'CHAIN',
+    retriever: 'RETRIEVER',
+    reranker: 'RERANKER',
+    embedding: 'EMBEDDING',
+    guardrail: 'GUARDRAIL',
+    evaluator: 'EVALUATOR',
+    prompt: 'PROMPT',
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@amsterdamdatalabs/traces",
+  "version": "0.1.0",
+  "description": "Shared OpenInference tracing types and emit for enact-os packages",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./conventions": {
+      "import": "./dist/conventions/index.js",
+      "types": "./dist/conventions/index.d.ts"
+    },
+    "./payloads": {
+      "import": "./dist/payloads/index.js",
+      "types": "./dist/payloads/index.d.ts"
+    },
+    "./emit": {
+      "import": "./dist/emit/emit.js",
+      "types": "./dist/emit/emit.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "dev": "tsc --watch",
+    "lint": "oxlint src/"
+  },
+  "dependencies": {
+    "@arizeai/openinference-semantic-conventions": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.0",
+    "oxlint": "^0.13.0",
+    "typescript": "^5.4.5"
+  }
+}