@stackbone/sdk 0.1.0-alpha.1 → 0.1.0-alpha.3

package/observability/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../libs/sdk/package.json","../../../../libs/sdk/src/observability/logger.ts","../../../../libs/sdk/src/observability/run-steps-exporter.ts","../../../../libs/sdk/src/observability/aggregate-run-cost.ts"],"names":["LOG_LEVELS","trace","debug","info","warn","error","fatal","DEFAULT_BATCH_SIZE","DEFAULT_INTERVAL_MS","DEFAULT_HTTP_TIMEOUT_MS","createPlatformLogger","options","otelEndpoint","undefined","mode","baseBindings","run_id","runId","installationId","agentId","destination","OtlpHttpDestination","endpoint","resourceAttributes","httpTimeoutMs","flushBatchSize","flushIntervalMs","fetchImpl","JsonlFileDestination","runsDir","defaultRunsDir","appendFileImpl","mkdirImpl","now","Date","buildLogger","opts","writeAt","level","msgOrObj","msg","time","levelNumber","record","String","Object","assign","write","child","bindings","flush","close","path","appendFile","mkdir","inFlight","Promise","resolve","dirReady","p","d","recursive","line","JSON","stringify","then","dirname","process","stderr","Error","message","url","buffer","timer","closed","replace","fetch","push","length","armTimer","drained","splice","disarmTimer","post","catch","setTimeout","unref","clearTimeout","records","body","buildOtlpLogsBody","controller","AbortController","timeout","abort","resp","method","headers","signal","ok","text","status","slice","SDK_SCOPE","name","version","resourceLogs","resource","attributes","toOtlpAttributes","scopeLogs","scope","logRecords","map","toOtlpLogRecord","rest","timeUnixNano","severityNumber","severityText","stringValue","toOtlpAttributesFromUnknown","SEVERITY_TEXT_BY_LEVEL","fromEntries","entries","value","toUpperCase","attrs","key","out","Number","isInteger","intValue","doubleValue","boolValue","homedir","RUN_STEP_TYPES","STEP_TYPE_ATTRIBUTE","RUN_ID_ATTRIBUTE","NAME_PREFIX_MAP","RunStepsSpanProcessor","stepIdBySpanId","Map","batchSize","intervalMs","resolveStepType","newId","connectionString","ownsSql","sql","defaultStepTypeResolver","randomUUID","onStart","span","spanId","spanContext","has","set","onEnd","row","buildRow","forceFlush","shutdown","end","stepId","get","delete","readString","parentSpanId","parentSpanContext","parentStepId","startedAt","formatHrTime","startTime","finishedAt","endTime","durationMs","hrTimeToMs","duration","diffHrTime","isError","code","id","parent_step_id","type","payload","serialisablePayload","started_at","finished_at","duration_ms","writeBatch","finally","ensureSql","mod","default","rows","placeholders","params","base","join","unsafe","explicit","includes","pattern","test","hr","toISOString","seconds","nanos","Math","floor","start","SQL","aggregateRunCost","result","costEstimatedUsd","raw","cost_estimated_usd","num","isFinite"],"mappings":"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","file":"index.cjs","sourcesContent":["{\n  \"name\": \"@stackbone/sdk\",\n  \"version\": \"0.1.0-alpha.2\",\n  \"license\": \"UNLICENSED\",\n  \"description\": \"Official TypeScript SDK for Stackbone — the marketplace and managed runtime for containerized AI agents.\",\n  \"type\": \"module\",\n  \"sideEffects\": false,\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": {\n        \"types\": \"./dist/index.d.ts\",\n        \"default\": \"./dist/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/index.d.cts\",\n        \"default\": \"./dist/index.cjs\"\n      }\n    },\n    \"./db\": {\n      \"import\": {\n        \"types\": \"./dist/db/index.d.ts\",\n        \"default\": \"./dist/db/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/db/index.d.cts\",\n        \"default\": \"./dist/db/index.cjs\"\n      }\n    },\n    \"./db/testing\": {\n      \"import\": {\n        \"types\": \"./dist/db/testing/index.d.ts\",\n        \"default\": \"./dist/db/testing/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/db/testing/index.d.cts\",\n        \"default\": \"./dist/db/testing/index.cjs\"\n      }\n    },\n    \"./observability\": {\n      \"import\": {\n        \"types\": \"./dist/observability/index.d.ts\",\n        \"default\": \"./dist/observability/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/observability/index.d.cts\",\n        \"default\": \"./dist/observability/index.cjs\"\n      }\n    },\n    \"./queues/types\": {\n      \"import\": {\n        \"types\": \"./dist/queues/types.d.ts\",\n        \"default\": \"./dist/queues/types.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/queues/types.d.cts\",\n        \"default\": \"./dist/queues/types.cjs\"\n      }\n    },\n    \"./rag/migrations\": {\n      \"import\": {\n        \"types\": \"./dist/rag/migrations/index.d.ts\",\n        \"default\": \"./dist/rag/migrations/index.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/rag/migrations/index.d.cts\",\n        \"default\": \"./dist/rag/migrations/index.cjs\"\n      }\n    },\n    \"./rag/schema\": {\n      \"import\": {\n        \"types\": \"./dist/rag/schema.d.ts\",\n        \"default\": \"./dist/rag/schema.js\"\n      },\n      \"require\": {\n        \"types\": \"./dist/rag/schema.d.cts\",\n        \"default\": \"./dist/rag/schema.cjs\"\n      }\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"CHANGELOG.md\"\n  ],\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"engines\": {\n    \"node\": \">=24\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/stackbone/stackbone.git\",\n    \"directory\": \"libs/sdk\"\n  },\n  \"homepage\": \"https://stackbone.ai\",\n  \"bugs\": {\n    \"url\": \"https://github.com/stackbone/stackbone/issues\"\n  },\n  \"keywords\": [\n    \"stackbone\",\n    \"ai-agents\",\n    \"agent-sdk\",\n    \"containerized-agents\",\n    \"openrouter\",\n    \"rag\",\n    \"pgvector\",\n    \"drizzle\",\n    \"openai\",\n    \"postgres\"\n  ],\n  \"dependencies\": {\n    \"@aws-sdk/client-s3\": \"^3.1038.0\",\n    \"@aws-sdk/s3-request-presigner\": \"^3.1038.0\",\n    \"@stackbone/validators\": \"workspace:*\",\n    \"@testcontainers/postgresql\": \"^11.14.0\",\n    \"drizzle-orm\": \"0.45.2\",\n    \"openai\": \"^4.104.0\",\n    \"postgres\": \"3.4.9\",\n    \"unpdf\": \"^0.12.1\",\n    \"zod\": \"*\"\n  }\n}\n","import { appendFile, mkdir } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { dirname, resolve } from 'node:path';\n\nimport { version as SDK_VERSION } from '../../package.json';\n\n// Numeric levels match Pino so JSONL files produced in local mode work with\n// `pino-pretty` and other Pino-aware tooling without translation.\nexport const LOG_LEVELS = {\n  trace: 10,\n  debug: 20,\n  info: 30,\n  warn: 40,\n  error: 50,\n  fatal: 60,\n} as const;\n\nexport type LogLevelName = keyof typeof LOG_LEVELS;\nexport type LogLevelNumber = (typeof LOG_LEVELS)[LogLevelName];\n\nexport interface LogRecord {\n  /** Pino-style numeric level. */\n  level: LogLevelNumber;\n  /** Epoch milliseconds. Pino uses `time` as a number. */\n  time: number;\n  msg: string;\n  run_id: string;\n  trace_id?: string;\n  installation_id?: string;\n  agent_id?: string;\n  [key: string]: unknown;\n}\n\nexport interface PlatformLoggerOptions {\n  runId: string;\n  installationId?: string | undefined;\n  agentId?: string | undefined;\n  /**\n   * When set (cloud), logs are batched and POSTed to `<endpoint>/v1/logs` as\n   * OTLP/HTTP/JSON. When unset (local), logs are appended to\n   * `<runsDir>/<runId>.jsonl`. Falls back to `OTEL_EXPORTER_OTLP_ENDPOINT`.\n   */\n  otelEndpoint?: string | undefined;\n  /** Local-only: directory where JSONL files live. Defaults to `~/.stackbone/dev/runs`. */\n  runsDir?: string | undefined;\n  /** Cloud-only: extra OTel resource attributes to send with every batch. */\n  resourceAttributes?: Record<string, string> | undefined;\n  /** Cloud-only: HTTP timeout per OTLP POST in ms. Defaults to 5_000. */\n  httpTimeoutMs?: number | undefined;\n  /** Flush trigger by buffer size. Defaults to 50. */\n  flushBatchSize?: number | undefined;\n  /** Flush trigger by elapsed time (ms). Defaults to 1_000. */\n  flushIntervalMs?: number | undefined;\n  /** Test seam — fetch implementation. Defaults to global `fetch`. */\n  fetchImpl?: typeof fetch | undefined;\n  /** Test seam — `fs.appendFile`-shaped sink the local destination uses. */\n  appendFileImpl?: ((path: string, data: string) => Promise<void>) | undefined;\n  /** Test seam — `fs.mkdir`-shaped helper the local destination uses. */\n  mkdirImpl?: ((path: string) => Promise<void>) | undefined;\n  /** Test seam — clock for `time` field. Defaults to `Date.now`. */\n  now?: (() => number) | undefined;\n  /** Override mode resolution (skips the env detection). */\n  mode?: PlatformLoggerMode | undefined;\n}\n\nexport type PlatformLoggerMode = 'local' | 'cloud';\n\nexport interface PinoLike {\n  trace(msgOrObj: unknown, msg?: string): void;\n  debug(msgOrObj: unknown, msg?: string): void;\n  info(msgOrObj: unknown, msg?: string): void;\n  warn(msgOrObj: unknown, msg?: string): void;\n  error(msgOrObj: unknown, msg?: string): void;\n  fatal(msgOrObj: unknown, msg?: string): void;\n}\n\nexport interface PlatformLogger extends PinoLike {\n  readonly mode: PlatformLoggerMode;\n  /** Bind extra fields and return a child logger sharing the same destination. */\n  child(bindings: Record<string, unknown>): PlatformLogger;\n  /** Force-flush pending writes (close file handle or POST OTLP batch). */\n  flush(): Promise<void>;\n  /** Stop accepting writes and release resources. */\n  close(): Promise<void>;\n}\n\ninterface Destination {\n  write(record: LogRecord): void;\n  flush(): Promise<void>;\n  close(): Promise<void>;\n}\n\nconst DEFAULT_BATCH_SIZE = 50;\nconst DEFAULT_INTERVAL_MS = 1_000;\nconst DEFAULT_HTTP_TIMEOUT_MS = 5_000;\n\n/**\n * Creates a Pino-aligned logger that writes JSONL to disk in local mode and\n * batches OTLP/HTTP/JSON log records to an OTel collector in cloud mode. Mode\n * is resolved from `OTEL_EXPORTER_OTLP_ENDPOINT` or the explicit override.\n */\nexport function createPlatformLogger(options: PlatformLoggerOptions): PlatformLogger {\n  // The resolver is the single seam that reads `OTEL_EXPORTER_OTLP_ENDPOINT`\n  // — callers building a logger through `client.observability.logger(...)`\n  // already get the value plumbed in from `ResolvedConfig`. The `undefined`\n  // here means \"no `otelEndpoint` ⇒ local JSONL mode\" (matches the docstring).\n  const otelEndpoint = options.otelEndpoint ?? undefined;\n  const mode: PlatformLoggerMode = options.mode ?? (otelEndpoint ? 'cloud' : 'local');\n\n  const baseBindings: Record<string, unknown> = { run_id: options.runId };\n  if (options.installationId !== undefined)\n    baseBindings['installation_id'] = options.installationId;\n  if (options.agentId !== undefined) baseBindings['agent_id'] = options.agentId;\n\n  const destination: Destination =\n    mode === 'cloud'\n      ? new OtlpHttpDestination({\n          endpoint: otelEndpoint ?? '',\n          resourceAttributes: options.resourceAttributes ?? {},\n          httpTimeoutMs: options.httpTimeoutMs ?? DEFAULT_HTTP_TIMEOUT_MS,\n          flushBatchSize: options.flushBatchSize ?? DEFAULT_BATCH_SIZE,\n          flushIntervalMs: options.flushIntervalMs ?? DEFAULT_INTERVAL_MS,\n          ...(options.fetchImpl !== undefined ? { fetchImpl: options.fetchImpl } : {}),\n        })\n      : new JsonlFileDestination({\n          runId: options.runId,\n          runsDir: options.runsDir ?? defaultRunsDir(),\n          ...(options.appendFileImpl !== undefined\n            ? { appendFileImpl: options.appendFileImpl }\n            : {}),\n          ...(options.mkdirImpl !== undefined ? { mkdirImpl: options.mkdirImpl } : {}),\n        });\n\n  const now = options.now ?? Date.now;\n  return buildLogger({ destination, baseBindings, mode, now });\n}\n\ninterface LoggerBuildOptions {\n  destination: Destination;\n  baseBindings: Record<string, unknown>;\n  mode: PlatformLoggerMode;\n  now: () => number;\n}\n\nfunction buildLogger(opts: LoggerBuildOptions): PlatformLogger {\n  const writeAt = (level: LogLevelName, msgOrObj: unknown, msg?: string): void => {\n    const time = opts.now();\n    const levelNumber = LOG_LEVELS[level];\n    const record: LogRecord = {\n      level: levelNumber,\n      time,\n      msg: '',\n      run_id: String(opts.baseBindings['run_id'] ?? ''),\n      ...opts.baseBindings,\n    };\n    if (typeof msgOrObj === 'string') {\n      record.msg = msgOrObj;\n    } else if (msgOrObj && typeof msgOrObj === 'object') {\n      Object.assign(record, msgOrObj);\n      if (typeof msg === 'string') record.msg = msg;\n      else if (typeof record.msg !== 'string') record.msg = '';\n    }\n    opts.destination.write(record);\n  };\n\n  const child = (bindings: Record<string, unknown>): PlatformLogger =>\n    buildLogger({ ...opts, baseBindings: { ...opts.baseBindings, ...bindings } });\n\n  return {\n    mode: opts.mode,\n    trace: (msgOrObj, msg) => writeAt('trace', msgOrObj, msg),\n    debug: (msgOrObj, msg) => writeAt('debug', msgOrObj, msg),\n    info: (msgOrObj, msg) => writeAt('info', msgOrObj, msg),\n    warn: (msgOrObj, msg) => writeAt('warn', msgOrObj, msg),\n    error: (msgOrObj, msg) => writeAt('error', msgOrObj, msg),\n    fatal: (msgOrObj, msg) => writeAt('fatal', msgOrObj, msg),\n    child,\n    flush: () => opts.destination.flush(),\n    close: () => opts.destination.close(),\n  };\n}\n\ninterface JsonlFileDestinationOptions {\n  runId: string;\n  runsDir: string;\n  appendFileImpl?: (path: string, data: string) => Promise<void>;\n  mkdirImpl?: (path: string) => Promise<void>;\n}\n\nclass JsonlFileDestination implements Destination {\n  private readonly path: string;\n  private readonly appendFile: (path: string, data: string) => Promise<void>;\n  private readonly mkdir: (path: string) => Promise<void>;\n  private inFlight: Promise<void> = Promise.resolve();\n  private dirReady = false;\n\n  constructor(opts: JsonlFileDestinationOptions) {\n    this.path = resolve(opts.runsDir, `${opts.runId}.jsonl`);\n    this.appendFile = opts.appendFileImpl ?? ((p, d) => appendFile(p, d, 'utf8'));\n    this.mkdir =\n      opts.mkdirImpl ??\n      (async (p) => {\n        await mkdir(p, { recursive: true });\n      });\n  }\n\n  write(record: LogRecord): void {\n    const line = `${JSON.stringify(record)}\\n`;\n    this.inFlight = this.inFlight.then(async () => {\n      if (!this.dirReady) {\n        await this.mkdir(dirname(this.path));\n        this.dirReady = true;\n      }\n      try {\n        await this.appendFile(this.path, line);\n      } catch (error) {\n        process.stderr.write(\n          `[stackbone/sdk] PlatformLogger JSONL write failed: ${error instanceof Error ? error.message : String(error)}\\n`,\n        );\n      }\n    });\n  }\n\n  async flush(): Promise<void> {\n    await this.inFlight;\n  }\n\n  async close(): Promise<void> {\n    await this.flush();\n  }\n}\n\ninterface OtlpHttpDestinationOptions {\n  endpoint: string;\n  resourceAttributes: Record<string, string>;\n  httpTimeoutMs: number;\n  flushBatchSize: number;\n  flushIntervalMs: number;\n  fetchImpl?: typeof fetch;\n}\n\n// OTLP/HTTP/JSON spec: OpenTelemetry Logs Data Model §B.1. Failures log to\n// stderr — telemetry must never block agent execution.\nclass OtlpHttpDestination implements Destination {\n  private readonly url: string;\n  private readonly resourceAttributes: Record<string, string>;\n  private readonly httpTimeoutMs: number;\n  private readonly flushBatchSize: number;\n  private readonly flushIntervalMs: number;\n  private readonly fetchImpl: typeof fetch;\n  private buffer: LogRecord[] = [];\n  private timer: NodeJS.Timeout | null = null;\n  private inFlight: Promise<void> = Promise.resolve();\n  private closed = false;\n\n  constructor(opts: OtlpHttpDestinationOptions) {\n    this.url = `${opts.endpoint.replace(/\\/+$/, '')}/v1/logs`;\n    this.resourceAttributes = opts.resourceAttributes;\n    this.httpTimeoutMs = opts.httpTimeoutMs;\n    this.flushBatchSize = opts.flushBatchSize;\n    this.flushIntervalMs = opts.flushIntervalMs;\n    this.fetchImpl = opts.fetchImpl ?? fetch;\n  }\n\n  write(record: LogRecord): void {\n    if (this.closed) return;\n    this.buffer.push(record);\n    if (this.buffer.length >= this.flushBatchSize) {\n      void this.flush();\n    } else {\n      this.armTimer();\n    }\n  }\n\n  async flush(): Promise<void> {\n    await this.inFlight;\n    if (this.buffer.length === 0) return;\n    const drained = this.buffer.splice(0, this.buffer.length);\n    this.disarmTimer();\n    this.inFlight = this.post(drained).catch((error) => {\n      process.stderr.write(\n        `[stackbone/sdk] PlatformLogger OTLP POST failed: ${error instanceof Error ? error.message : String(error)}\\n`,\n      );\n    });\n    await this.inFlight;\n  }\n\n  async close(): Promise<void> {\n    this.closed = true;\n    await this.flush();\n  }\n\n  private armTimer(): void {\n    if (this.timer) return;\n    this.timer = setTimeout(() => {\n      this.timer = null;\n      void this.flush();\n    }, this.flushIntervalMs);\n    this.timer.unref?.();\n  }\n\n  private disarmTimer(): void {\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n  }\n\n  private async post(records: LogRecord[]): Promise<void> {\n    const body = JSON.stringify(buildOtlpLogsBody(records, this.resourceAttributes));\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.httpTimeoutMs);\n    try {\n      const resp = await this.fetchImpl(this.url, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body,\n        signal: controller.signal,\n      });\n      if (!resp.ok) {\n        const text = await resp.text().catch(() => '');\n        throw new Error(`HTTP ${resp.status}${text ? `: ${text.slice(0, 200)}` : ''}`);\n      }\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n\ninterface OtlpKeyValue {\n  key: string;\n  value:\n    | { stringValue: string }\n    | { intValue: string }\n    | { doubleValue: number }\n    | { boolValue: boolean };\n}\n\ninterface OtlpResource {\n  attributes: OtlpKeyValue[];\n}\n\ninterface OtlpLogRecord {\n  timeUnixNano: string;\n  severityNumber: number;\n  severityText: string;\n  body: { stringValue: string };\n  attributes: OtlpKeyValue[];\n}\n\ninterface OtlpLogsBody {\n  resourceLogs: Array<{\n    resource: OtlpResource;\n    scopeLogs: Array<{\n      scope: { name: string; version: string };\n      logRecords: OtlpLogRecord[];\n    }>;\n  }>;\n}\n\nconst SDK_SCOPE = { name: '@stackbone/sdk', version: SDK_VERSION };\n\nfunction buildOtlpLogsBody(\n  records: LogRecord[],\n  resourceAttributes: Record<string, string>,\n): OtlpLogsBody {\n  return {\n    resourceLogs: [\n      {\n        resource: { attributes: toOtlpAttributes(resourceAttributes) },\n        scopeLogs: [\n          {\n            scope: SDK_SCOPE,\n            logRecords: records.map(toOtlpLogRecord),\n          },\n        ],\n      },\n    ],\n  };\n}\n\nfunction toOtlpLogRecord(record: LogRecord): OtlpLogRecord {\n  const { level, time, msg, ...rest } = record;\n  return {\n    timeUnixNano: `${time * 1_000_000}`,\n    severityNumber: level,\n    severityText: severityText(level),\n    body: { stringValue: msg },\n    attributes: toOtlpAttributesFromUnknown(rest),\n  };\n}\n\nconst SEVERITY_TEXT_BY_LEVEL: Record<number, string> = Object.fromEntries(\n  Object.entries(LOG_LEVELS).map(([name, value]) => [value, name.toUpperCase()]),\n);\n\nfunction severityText(level: number): string {\n  return SEVERITY_TEXT_BY_LEVEL[level] ?? 'INFO';\n}\n\nfunction toOtlpAttributes(attrs: Record<string, string>): OtlpKeyValue[] {\n  return Object.entries(attrs).map(([key, value]) => ({\n    key,\n    value: { stringValue: value },\n  }));\n}\n\nfunction toOtlpAttributesFromUnknown(attrs: Record<string, unknown>): OtlpKeyValue[] {\n  const out: OtlpKeyValue[] = [];\n  for (const [key, value] of Object.entries(attrs)) {\n    if (value === null || value === undefined) continue;\n    if (typeof value === 'string') {\n      out.push({ key, value: { stringValue: value } });\n    } else if (typeof value === 'number') {\n      if (Number.isInteger(value)) out.push({ key, value: { intValue: String(value) } });\n      else out.push({ key, value: { doubleValue: value } });\n    } else if (typeof value === 'boolean') {\n      out.push({ key, value: { boolValue: value } });\n    } else {\n      out.push({ key, value: { stringValue: JSON.stringify(value) } });\n    }\n  }\n  return out;\n}\n\nexport function defaultRunsDir(): string {\n  return resolve(homedir(), '.stackbone', 'dev', 'runs');\n}\n","import { randomUUID } from 'node:crypto';\n\n// Canonical step types stored in `stackbone_platform.run_steps.type`. The list\n// has to stay in sync with the CHECK constraint in\n// `libs/platform-schema/src/migrations/0001_runs.sql`. Exported so agents\n// can discover the closed set without reaching into the migration file.\nexport const RUN_STEP_TYPES = [\n  'agent',\n  'llm_call',\n  'db_query',\n  'http_fetch',\n  'queue_publish',\n  'hitl_pause',\n  'tool_call',\n  'rag_query',\n  'storage_op',\n] as const;\nexport type RunStepType = (typeof RUN_STEP_TYPES)[number];\n\n// Span attribute we read first to pin a step type explicitly. When absent,\n// the resolver falls back to a span.name prefix mapping.\nexport const STEP_TYPE_ATTRIBUTE = 'stackbone.step.type';\n\n// Span attribute that carries the active run id. The processor drops spans\n// without it because `stackbone_platform.run_steps.run_id` is NOT NULL — there\n// is no useful row we could write otherwise.\nexport const RUN_ID_ATTRIBUTE = 'stackbone.run.id';\n\nconst NAME_PREFIX_MAP: ReadonlyArray<readonly [RegExp, RunStepType]> = [\n  [/^stackbone\\.ai\\./, 'llm_call'],\n  [/^stackbone\\.db\\./, 'db_query'],\n  [/^stackbone\\.http\\./, 'http_fetch'],\n  [/^stackbone\\.queues\\./, 'queue_publish'],\n  [/^stackbone\\.approval\\./, 'hitl_pause'],\n  [/^stackbone\\.tool\\./, 'tool_call'],\n  [/^stackbone\\.rag\\./, 'rag_query'],\n  [/^stackbone\\.storage\\./, 'storage_op'],\n];\n\n/**\n * Minimal duck-typed view of an OpenTelemetry `ReadableSpan`. We mirror the\n * shape the OTel SDK exposes on `@opentelemetry/sdk-trace-base` rather than\n * importing the package so `@stackbone/sdk` doesn't pull the OTel runtime into\n * every agent that doesn't enable Studio. Agents wire the processor with\n * `provider.addSpanProcessor(new RunStepsSpanProcessor(...))` and the\n * structural match satisfies TypeScript.\n */\nexport interface SpanContextLike {\n  spanId: string;\n  traceId: string;\n}\n\nexport interface ReadableSpanLike {\n  spanContext(): SpanContextLike;\n  parentSpanContext?: SpanContextLike | undefined;\n  parentSpanId?: string | undefined;\n  name: string;\n  attributes: Record<string, unknown>;\n  status?: { code: number; message?: string } | undefined;\n  startTime?: [number, number] | undefined;\n  endTime?: [number, number] | undefined;\n  duration?: [number, number] | undefined;\n}\n\nexport interface PostgresLike {\n  unsafe(query: string, params?: unknown[]): Promise<unknown>;\n  end?(): Promise<void>;\n}\n\nexport interface RunStepsSpanProcessorOptions {\n  /**\n   * Postgres connection string of the install (local emulator at :5433 in\n   * dev, Neon TCP/HTTP URL in cloud). Falls back to `DATABASE_URL`.\n   */\n  connectionString?: string | undefined;\n  /** Flush trigger by buffer size. Defaults to 50. */\n  flushBatchSize?: number | undefined;\n  /** Flush trigger by elapsed time (ms). Defaults to 500. */\n  flushIntervalMs?: number | undefined;\n  /** Override how a span maps to a step type. */\n  resolveStepType?: ((span: ReadableSpanLike) => RunStepType) | undefined;\n  /** Test seam — inject a postgres-js-compatible client. */\n  sql?: PostgresLike | undefined;\n  /** Test seam — deterministic UUID generator. */\n  newId?: (() => string) | undefined;\n}\n\ninterface BufferedRow {\n  id: string;\n  run_id: string;\n  parent_step_id: string | null;\n  type: RunStepType;\n  name: string;\n  status: 'ok' | 'error';\n  payload: Record<string, unknown>;\n  error: { message: string } | null;\n  started_at: string;\n  finished_at: string;\n  duration_ms: number;\n}\n\nconst DEFAULT_BATCH_SIZE = 50;\nconst DEFAULT_INTERVAL_MS = 500;\n\n/**\n * Materialises every OTel span produced by the agent into a row of\n * `stackbone_platform.run_steps`. Designed to coexist with the OTLP exporter:\n * cloud builds register both processors so Postgres feeds Studio (paridad\n * con local) and Tempo feeds Platform Ops with retention/aggregation. If a\n * write fails the processor logs to stderr and keeps accepting spans —\n * observability is never load-bearing for agent execution.\n *\n * Spec: docs/arquitectura/specs/stackbone-agent-protocol-v1.md §6.3\n * ADR:  docs/arquitectura/decisiones/2026-05-03-stackbone-studio-datapath-y-scope-mvp.md §D9\n */\nexport class RunStepsSpanProcessor {\n  private readonly buffer: BufferedRow[] = [];\n  private readonly stepIdBySpanId = new Map<string, string>();\n  private readonly batchSize: number;\n  private readonly intervalMs: number;\n  private readonly resolveStepType: (span: ReadableSpanLike) => RunStepType;\n  private readonly newId: () => string;\n  private readonly connectionString: string | undefined;\n  private readonly ownsSql: boolean;\n  private sql: PostgresLike | null;\n  private timer: NodeJS.Timeout | null = null;\n  private inFlight: Promise<void> | null = null;\n\n  constructor(options: RunStepsSpanProcessorOptions = {}) {\n    this.batchSize = options.flushBatchSize ?? DEFAULT_BATCH_SIZE;\n    this.intervalMs = options.flushIntervalMs ?? DEFAULT_INTERVAL_MS;\n    this.resolveStepType = options.resolveStepType ?? defaultStepTypeResolver;\n    this.newId = options.newId ?? randomUUID;\n    // The resolver owns reading `STACKBONE_POSTGRES_URL` — callers\n    // building the processor through `client.observability.spanProcessor()`\n    // already get the value plumbed in from `ResolvedConfig`. Direct\n    // constructions on the `@stackbone/sdk/observability` subpath must\n    // supply `connectionString` themselves.\n    this.connectionString = options.connectionString;\n    if (options.sql) {\n      this.sql = options.sql;\n      this.ownsSql = false;\n    } else {\n      this.sql = null;\n      this.ownsSql = true;\n    }\n  }\n\n  // OTel calls onStart for the parent before any child, and onEnd for\n  // children before the parent. Reserving the UUID up-front lets the child's\n  // onEnd resolve `parent_step_id` synchronously — the alternative (looking\n  // up the parent at write time) would race the buffer flush.\n  onStart(span: ReadableSpanLike): void {\n    const spanId = span.spanContext().spanId;\n    if (!this.stepIdBySpanId.has(spanId)) {\n      this.stepIdBySpanId.set(spanId, this.newId());\n    }\n  }\n\n  onEnd(span: ReadableSpanLike): void {\n    const row = this.buildRow(span);\n    if (!row) return;\n    this.buffer.push(row);\n    if (this.buffer.length >= this.batchSize) {\n      void this.flush();\n    } else {\n      this.armTimer();\n    }\n  }\n\n  async forceFlush(): Promise<void> {\n    await this.flush();\n  }\n\n  async shutdown(): Promise<void> {\n    this.disarmTimer();\n    await this.flush();\n    if (this.ownsSql && this.sql?.end) {\n      await this.sql.end().catch(() => undefined);\n    }\n  }\n\n  private buildRow(span: ReadableSpanLike): BufferedRow | null {\n    const spanId = span.spanContext().spanId;\n    // Always release the reservation from `onStart`, even when we drop the\n    // row for lack of `run_id` — otherwise spans the SDK never persists\n    // accumulate in the map.\n    const stepId = this.stepIdBySpanId.get(spanId) ?? this.newId();\n    this.stepIdBySpanId.delete(spanId);\n\n    const runId = readString(span.attributes[RUN_ID_ATTRIBUTE]);\n    if (!runId) return null;\n\n    const parentSpanId = span.parentSpanContext?.spanId ?? span.parentSpanId ?? null;\n    // Parents end after children, so the parent's UUID is still in the map\n    // when the child's onEnd runs. Once the parent ends and gets removed the\n    // child rows already reference it via `parent_step_id`.\n    const parentStepId = parentSpanId ? (this.stepIdBySpanId.get(parentSpanId) ?? null) : null;\n\n    const startedAt = formatHrTime(span.startTime);\n    const finishedAt = formatHrTime(span.endTime ?? span.startTime);\n    const durationMs = hrTimeToMs(span.duration ?? diffHrTime(span.endTime, span.startTime));\n\n    const isError = span.status?.code === 2;\n\n    return {\n      id: stepId,\n      run_id: runId,\n      parent_step_id: parentStepId,\n      type: this.resolveStepType(span),\n      name: span.name,\n      status: isError ? 'error' : 'ok',\n      payload: serialisablePayload(span.attributes),\n      error: isError ? { message: span.status?.message ?? 'span ended with ERROR status' } : null,\n      started_at: startedAt,\n      finished_at: finishedAt,\n      duration_ms: durationMs,\n    };\n  }\n\n  private armTimer(): void {\n    if (this.timer) return;\n    this.timer = setTimeout(() => {\n      this.timer = null;\n      void this.flush();\n    }, this.intervalMs);\n    // Don't keep the Node process alive just for the flush timer.\n    this.timer.unref?.();\n  }\n\n  private disarmTimer(): void {\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n  }\n\n  private async flush(): Promise<void> {\n    if (this.inFlight) {\n      await this.inFlight;\n    }\n    if (this.buffer.length === 0) return;\n    const drained = this.buffer.splice(0, this.buffer.length);\n    this.disarmTimer();\n    this.inFlight = this.writeBatch(drained).finally(() => {\n      this.inFlight = null;\n    });\n    await this.inFlight;\n  }\n\n  private async ensureSql(): Promise<PostgresLike | null> {\n    if (this.sql) return this.sql;\n    if (!this.connectionString) return null;\n    // Lazy import — agents that never enable Studio don't pay the cost of\n    // wiring a Postgres connection at boot.\n    const mod = (await import('postgres')) as { default: (url: string) => PostgresLike };\n    this.sql = mod.default(this.connectionString);\n    return this.sql;\n  }\n\n  private async writeBatch(rows: BufferedRow[]): Promise<void> {\n    try {\n      const sql = await this.ensureSql();\n      if (!sql) {\n        process.stderr.write(\n          '[stackbone/sdk] RunStepsSpanProcessor dropped batch: no DATABASE_URL configured.\\n',\n        );\n        return;\n      }\n      const placeholders: string[] = [];\n      const params: unknown[] = [];\n      for (const row of rows) {\n        const base = params.length;\n        placeholders.push(\n          `($${base + 1}::uuid, $${base + 2}::uuid, $${base + 3}::uuid, $${base + 4}, $${base + 5}, $${base + 6}, $${base + 7}::jsonb, $${base + 8}::jsonb, $${base + 9}::timestamptz, $${base + 10}::timestamptz, $${base + 11}::int)`,\n        );\n        params.push(\n          row.id,\n          row.run_id,\n          row.parent_step_id,\n          row.type,\n          row.name,\n          row.status,\n          JSON.stringify(row.payload),\n          row.error ? JSON.stringify(row.error) : null,\n          row.started_at,\n          row.finished_at,\n          row.duration_ms,\n        );\n      }\n      const text = `INSERT INTO stackbone_platform.run_steps (\n          id, run_id, parent_step_id, type, name, status, payload, error,\n          started_at, finished_at, duration_ms\n        ) VALUES ${placeholders.join(', ')}`;\n      await sql.unsafe(text, params);\n    } catch (error) {\n      process.stderr.write(\n        `[stackbone/sdk] RunStepsSpanProcessor write failed: ${error instanceof Error ? error.message : String(error)}\\n`,\n      );\n    }\n  }\n}\n\nconst defaultStepTypeResolver = (span: ReadableSpanLike): RunStepType => {\n  const explicit = readString(span.attributes[STEP_TYPE_ATTRIBUTE]);\n  if (explicit && (RUN_STEP_TYPES as readonly string[]).includes(explicit)) {\n    return explicit as RunStepType;\n  }\n  for (const [pattern, type] of NAME_PREFIX_MAP) {\n    if (pattern.test(span.name)) return type;\n  }\n  return 'agent';\n};\n\nconst readString = (value: unknown): string | undefined =>\n  typeof value === 'string' && value.length > 0 ? value : undefined;\n\nconst formatHrTime = (hr?: [number, number]): string =>\n  new Date(hr ? hrTimeToMs(hr) : Date.now()).toISOString();\n\nconst hrTimeToMs = (hr?: [number, number]): number => {\n  if (!hr) return 0;\n  const [seconds, nanos] = hr;\n  return seconds * 1_000 + Math.floor(nanos / 1_000_000);\n};\n\nconst diffHrTime = (\n  end?: [number, number],\n  start?: [number, number],\n): [number, number] | undefined => {\n  if (!end || !start) return undefined;\n  const seconds = end[0] - start[0];\n  const nanos = end[1] - start[1];\n  return [seconds, nanos];\n};\n\nconst serialisablePayload = (attributes: Record<string, unknown>): Record<string, unknown> => {\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(attributes)) {\n    if (key === RUN_ID_ATTRIBUTE) continue;\n    if (key === STEP_TYPE_ATTRIBUTE) continue;\n    out[key] = value;\n  }\n  return out;\n};\n","import type { PostgresLike } from './run-steps-exporter';\n\n// Spans without a `cost_usd` attribute (unknown model / OpenRouter response\n// without the cost header) contribute 0 — observability is best-effort and\n// must not fail the run on missing telemetry.\n\nexport interface AggregateRunCostOptions {\n  sql: PostgresLike;\n}\n\nexport interface AggregateRunCostResult {\n  costEstimatedUsd: number;\n}\n\ninterface AggregatedRow {\n  cost_estimated_usd: string | number | null;\n}\n\nconst SQL = `WITH llm_costs AS (\n    SELECT COALESCE(SUM((payload->>'cost_usd')::numeric), 0) AS total\n      FROM stackbone_platform.run_steps\n     WHERE run_id = $1::uuid\n       AND type = 'llm_call'\n  )\n  UPDATE stackbone_platform.runs\n     SET cost_estimated_usd = (SELECT total FROM llm_costs)\n   WHERE id = $1::uuid\n  RETURNING cost_estimated_usd`;\n\nexport async function aggregateRunCost(\n  runId: string,\n  options: AggregateRunCostOptions,\n): Promise<AggregateRunCostResult> {\n  const result = (await options.sql.unsafe(SQL, [runId])) as AggregatedRow[];\n  const row = result[0];\n  if (!row) {\n    return { costEstimatedUsd: 0 };\n  }\n  // postgres-js returns numerics as strings to preserve precision; coerce\n  // to a Number on the way out so callers don't need to know.\n  const raw = row.cost_estimated_usd;\n  if (raw === null || raw === undefined) return { costEstimatedUsd: 0 };\n  const num = typeof raw === 'string' ? Number(raw) : raw;\n  return { costEstimatedUsd: Number.isFinite(num) ? num : 0 };\n}\n"]}

package/observability/index.d.cts

@@ -0,0 +1,175 @@
+declare const RUN_STEP_TYPES: readonly ["agent", "llm_call", "db_query", "http_fetch", "queue_publish", "hitl_pause", "tool_call", "rag_query", "storage_op"];
+type RunStepType = (typeof RUN_STEP_TYPES)[number];
+declare const STEP_TYPE_ATTRIBUTE = "stackbone.step.type";
+declare const RUN_ID_ATTRIBUTE = "stackbone.run.id";
+/**
+ * Minimal duck-typed view of an OpenTelemetry `ReadableSpan`. We mirror the
+ * shape the OTel SDK exposes on `@opentelemetry/sdk-trace-base` rather than
+ * importing the package so `@stackbone/sdk` doesn't pull the OTel runtime into
+ * every agent that doesn't enable Studio. Agents wire the processor with
+ * `provider.addSpanProcessor(new RunStepsSpanProcessor(...))` and the
+ * structural match satisfies TypeScript.
+ */
+interface SpanContextLike {
+    spanId: string;
+    traceId: string;
+}
+interface ReadableSpanLike {
+    spanContext(): SpanContextLike;
+    parentSpanContext?: SpanContextLike | undefined;
+    parentSpanId?: string | undefined;
+    name: string;
+    attributes: Record<string, unknown>;
+    status?: {
+        code: number;
+        message?: string;
+    } | undefined;
+    startTime?: [number, number] | undefined;
+    endTime?: [number, number] | undefined;
+    duration?: [number, number] | undefined;
+}
+interface PostgresLike {
+    unsafe(query: string, params?: unknown[]): Promise<unknown>;
+    end?(): Promise<void>;
+}
+interface RunStepsSpanProcessorOptions {
+    /**
+     * Postgres connection string of the install (local emulator at :5433 in
+     * dev, Neon TCP/HTTP URL in cloud). Falls back to `DATABASE_URL`.
+     */
+    connectionString?: string | undefined;
+    /** Flush trigger by buffer size. Defaults to 50. */
+    flushBatchSize?: number | undefined;
+    /** Flush trigger by elapsed time (ms). Defaults to 500. */
+    flushIntervalMs?: number | undefined;
+    /** Override how a span maps to a step type. */
+    resolveStepType?: ((span: ReadableSpanLike) => RunStepType) | undefined;
+    /** Test seam — inject a postgres-js-compatible client. */
+    sql?: PostgresLike | undefined;
+    /** Test seam — deterministic UUID generator. */
+    newId?: (() => string) | undefined;
+}
+/**
+ * Materialises every OTel span produced by the agent into a row of
+ * `stackbone_platform.run_steps`. Designed to coexist with the OTLP exporter:
+ * cloud builds register both processors so Postgres feeds Studio (paridad
+ * con local) and Tempo feeds Platform Ops with retention/aggregation. If a
+ * write fails the processor logs to stderr and keeps accepting spans —
+ * observability is never load-bearing for agent execution.
+ *
+ * Spec: docs/arquitectura/specs/stackbone-agent-protocol-v1.md §6.3
+ * ADR:  docs/arquitectura/decisiones/2026-05-03-stackbone-studio-datapath-y-scope-mvp.md §D9
+ */
+declare class RunStepsSpanProcessor {
+    private readonly buffer;
+    private readonly stepIdBySpanId;
+    private readonly batchSize;
+    private readonly intervalMs;
+    private readonly resolveStepType;
+    private readonly newId;
+    private readonly connectionString;
+    private readonly ownsSql;
+    private sql;
+    private timer;
+    private inFlight;
+    constructor(options?: RunStepsSpanProcessorOptions);
+    onStart(span: ReadableSpanLike): void;
+    onEnd(span: ReadableSpanLike): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private buildRow;
+    private armTimer;
+    private disarmTimer;
+    private flush;
+    private ensureSql;
+    private writeBatch;
+}
+
+interface AggregateRunCostOptions {
+    sql: PostgresLike;
+}
+interface AggregateRunCostResult {
+    costEstimatedUsd: number;
+}
+declare function aggregateRunCost(runId: string, options: AggregateRunCostOptions): Promise<AggregateRunCostResult>;
+
+declare const LOG_LEVELS: {
+    readonly trace: 10;
+    readonly debug: 20;
+    readonly info: 30;
+    readonly warn: 40;
+    readonly error: 50;
+    readonly fatal: 60;
+};
+type LogLevelName = keyof typeof LOG_LEVELS;
+type LogLevelNumber = (typeof LOG_LEVELS)[LogLevelName];
+interface LogRecord {
+    /** Pino-style numeric level. */
+    level: LogLevelNumber;
+    /** Epoch milliseconds. Pino uses `time` as a number. */
+    time: number;
+    msg: string;
+    run_id: string;
+    trace_id?: string;
+    installation_id?: string;
+    agent_id?: string;
+    [key: string]: unknown;
+}
+interface PlatformLoggerOptions {
+    runId: string;
+    installationId?: string | undefined;
+    agentId?: string | undefined;
+    /**
+     * When set (cloud), logs are batched and POSTed to `<endpoint>/v1/logs` as
+     * OTLP/HTTP/JSON. When unset (local), logs are appended to
+     * `<runsDir>/<runId>.jsonl`. Falls back to `OTEL_EXPORTER_OTLP_ENDPOINT`.
+     */
+    otelEndpoint?: string | undefined;
+    /** Local-only: directory where JSONL files live. Defaults to `~/.stackbone/dev/runs`. */
+    runsDir?: string | undefined;
+    /** Cloud-only: extra OTel resource attributes to send with every batch. */
+    resourceAttributes?: Record<string, string> | undefined;
+    /** Cloud-only: HTTP timeout per OTLP POST in ms. Defaults to 5_000. */
+    httpTimeoutMs?: number | undefined;
+    /** Flush trigger by buffer size. Defaults to 50. */
+    flushBatchSize?: number | undefined;
+    /** Flush trigger by elapsed time (ms). Defaults to 1_000. */
+    flushIntervalMs?: number | undefined;
+    /** Test seam — fetch implementation. Defaults to global `fetch`. */
+    fetchImpl?: typeof fetch | undefined;
+    /** Test seam — `fs.appendFile`-shaped sink the local destination uses. */
+    appendFileImpl?: ((path: string, data: string) => Promise<void>) | undefined;
+    /** Test seam — `fs.mkdir`-shaped helper the local destination uses. */
+    mkdirImpl?: ((path: string) => Promise<void>) | undefined;
+    /** Test seam — clock for `time` field. Defaults to `Date.now`. */
+    now?: (() => number) | undefined;
+    /** Override mode resolution (skips the env detection). */
+    mode?: PlatformLoggerMode | undefined;
+}
+type PlatformLoggerMode = 'local' | 'cloud';
+interface PinoLike {
+    trace(msgOrObj: unknown, msg?: string): void;
+    debug(msgOrObj: unknown, msg?: string): void;
+    info(msgOrObj: unknown, msg?: string): void;
+    warn(msgOrObj: unknown, msg?: string): void;
+    error(msgOrObj: unknown, msg?: string): void;
+    fatal(msgOrObj: unknown, msg?: string): void;
+}
+interface PlatformLogger extends PinoLike {
+    readonly mode: PlatformLoggerMode;
+    /** Bind extra fields and return a child logger sharing the same destination. */
+    child(bindings: Record<string, unknown>): PlatformLogger;
+    /** Force-flush pending writes (close file handle or POST OTLP batch). */
+    flush(): Promise<void>;
+    /** Stop accepting writes and release resources. */
+    close(): Promise<void>;
+}
+/**
+ * Creates a Pino-aligned logger that writes JSONL to disk in local mode and
+ * batches OTLP/HTTP/JSON log records to an OTel collector in cloud mode. Mode
+ * is resolved from `OTEL_EXPORTER_OTLP_ENDPOINT` or the explicit override.
+ */
+declare function createPlatformLogger(options: PlatformLoggerOptions): PlatformLogger;
+declare function defaultRunsDir(): string;
+
+export { type AggregateRunCostOptions, type AggregateRunCostResult, LOG_LEVELS, type LogLevelName, type LogLevelNumber, type LogRecord, type PinoLike, type PlatformLogger, type PlatformLoggerMode, type PlatformLoggerOptions, type PostgresLike, RUN_ID_ATTRIBUTE, RUN_STEP_TYPES, type ReadableSpanLike, type RunStepType, RunStepsSpanProcessor, type RunStepsSpanProcessorOptions, STEP_TYPE_ATTRIBUTE, type SpanContextLike, aggregateRunCost, createPlatformLogger, defaultRunsDir };

package/observability/index.d.ts

@@ -0,0 +1,175 @@
+declare const RUN_STEP_TYPES: readonly ["agent", "llm_call", "db_query", "http_fetch", "queue_publish", "hitl_pause", "tool_call", "rag_query", "storage_op"];
+type RunStepType = (typeof RUN_STEP_TYPES)[number];
+declare const STEP_TYPE_ATTRIBUTE = "stackbone.step.type";
+declare const RUN_ID_ATTRIBUTE = "stackbone.run.id";
+/**
+ * Minimal duck-typed view of an OpenTelemetry `ReadableSpan`. We mirror the
+ * shape the OTel SDK exposes on `@opentelemetry/sdk-trace-base` rather than
+ * importing the package so `@stackbone/sdk` doesn't pull the OTel runtime into
+ * every agent that doesn't enable Studio. Agents wire the processor with
+ * `provider.addSpanProcessor(new RunStepsSpanProcessor(...))` and the
+ * structural match satisfies TypeScript.
+ */
+interface SpanContextLike {
+    spanId: string;
+    traceId: string;
+}
+interface ReadableSpanLike {
+    spanContext(): SpanContextLike;
+    parentSpanContext?: SpanContextLike | undefined;
+    parentSpanId?: string | undefined;
+    name: string;
+    attributes: Record<string, unknown>;
+    status?: {
+        code: number;
+        message?: string;
+    } | undefined;
+    startTime?: [number, number] | undefined;
+    endTime?: [number, number] | undefined;
+    duration?: [number, number] | undefined;
+}
+interface PostgresLike {
+    unsafe(query: string, params?: unknown[]): Promise<unknown>;
+    end?(): Promise<void>;
+}
+interface RunStepsSpanProcessorOptions {
+    /**
+     * Postgres connection string of the install (local emulator at :5433 in
+     * dev, Neon TCP/HTTP URL in cloud). Falls back to `DATABASE_URL`.
+     */
+    connectionString?: string | undefined;
+    /** Flush trigger by buffer size. Defaults to 50. */
+    flushBatchSize?: number | undefined;
+    /** Flush trigger by elapsed time (ms). Defaults to 500. */
+    flushIntervalMs?: number | undefined;
+    /** Override how a span maps to a step type. */
+    resolveStepType?: ((span: ReadableSpanLike) => RunStepType) | undefined;
+    /** Test seam — inject a postgres-js-compatible client. */
+    sql?: PostgresLike | undefined;
+    /** Test seam — deterministic UUID generator. */
+    newId?: (() => string) | undefined;
+}
+/**
+ * Materialises every OTel span produced by the agent into a row of
+ * `stackbone_platform.run_steps`. Designed to coexist with the OTLP exporter:
+ * cloud builds register both processors so Postgres feeds Studio (paridad
+ * con local) and Tempo feeds Platform Ops with retention/aggregation. If a
+ * write fails the processor logs to stderr and keeps accepting spans —
+ * observability is never load-bearing for agent execution.
+ *
+ * Spec: docs/arquitectura/specs/stackbone-agent-protocol-v1.md §6.3
+ * ADR:  docs/arquitectura/decisiones/2026-05-03-stackbone-studio-datapath-y-scope-mvp.md §D9
+ */
+declare class RunStepsSpanProcessor {
+    private readonly buffer;
+    private readonly stepIdBySpanId;
+    private readonly batchSize;
+    private readonly intervalMs;
+    private readonly resolveStepType;
+    private readonly newId;
+    private readonly connectionString;
+    private readonly ownsSql;
+    private sql;
+    private timer;
+    private inFlight;
+    constructor(options?: RunStepsSpanProcessorOptions);
+    onStart(span: ReadableSpanLike): void;
+    onEnd(span: ReadableSpanLike): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private buildRow;
+    private armTimer;
+    private disarmTimer;
+    private flush;
+    private ensureSql;
+    private writeBatch;
+}
+
+interface AggregateRunCostOptions {
+    sql: PostgresLike;
+}
+interface AggregateRunCostResult {
+    costEstimatedUsd: number;
+}
+declare function aggregateRunCost(runId: string, options: AggregateRunCostOptions): Promise<AggregateRunCostResult>;
+
+declare const LOG_LEVELS: {
+    readonly trace: 10;
+    readonly debug: 20;
+    readonly info: 30;
+    readonly warn: 40;
+    readonly error: 50;
+    readonly fatal: 60;
+};
+type LogLevelName = keyof typeof LOG_LEVELS;
+type LogLevelNumber = (typeof LOG_LEVELS)[LogLevelName];
+interface LogRecord {
+    /** Pino-style numeric level. */
+    level: LogLevelNumber;
+    /** Epoch milliseconds. Pino uses `time` as a number. */
+    time: number;
+    msg: string;
+    run_id: string;
+    trace_id?: string;
+    installation_id?: string;
+    agent_id?: string;
+    [key: string]: unknown;
+}
+interface PlatformLoggerOptions {
+    runId: string;
+    installationId?: string | undefined;
+    agentId?: string | undefined;
+    /**
+     * When set (cloud), logs are batched and POSTed to `<endpoint>/v1/logs` as
+     * OTLP/HTTP/JSON. When unset (local), logs are appended to
+     * `<runsDir>/<runId>.jsonl`. Falls back to `OTEL_EXPORTER_OTLP_ENDPOINT`.
+     */
+    otelEndpoint?: string | undefined;
+    /** Local-only: directory where JSONL files live. Defaults to `~/.stackbone/dev/runs`. */
+    runsDir?: string | undefined;
+    /** Cloud-only: extra OTel resource attributes to send with every batch. */
+    resourceAttributes?: Record<string, string> | undefined;
+    /** Cloud-only: HTTP timeout per OTLP POST in ms. Defaults to 5_000. */
+    httpTimeoutMs?: number | undefined;
+    /** Flush trigger by buffer size. Defaults to 50. */
+    flushBatchSize?: number | undefined;
+    /** Flush trigger by elapsed time (ms). Defaults to 1_000. */
+    flushIntervalMs?: number | undefined;
+    /** Test seam — fetch implementation. Defaults to global `fetch`. */
+    fetchImpl?: typeof fetch | undefined;
+    /** Test seam — `fs.appendFile`-shaped sink the local destination uses. */
+    appendFileImpl?: ((path: string, data: string) => Promise<void>) | undefined;
+    /** Test seam — `fs.mkdir`-shaped helper the local destination uses. */
+    mkdirImpl?: ((path: string) => Promise<void>) | undefined;
+    /** Test seam — clock for `time` field. Defaults to `Date.now`. */
+    now?: (() => number) | undefined;
+    /** Override mode resolution (skips the env detection). */
+    mode?: PlatformLoggerMode | undefined;
+}
+type PlatformLoggerMode = 'local' | 'cloud';
+interface PinoLike {
+    trace(msgOrObj: unknown, msg?: string): void;
+    debug(msgOrObj: unknown, msg?: string): void;
+    info(msgOrObj: unknown, msg?: string): void;
+    warn(msgOrObj: unknown, msg?: string): void;
+    error(msgOrObj: unknown, msg?: string): void;
+    fatal(msgOrObj: unknown, msg?: string): void;
+}
+interface PlatformLogger extends PinoLike {
+    readonly mode: PlatformLoggerMode;
+    /** Bind extra fields and return a child logger sharing the same destination. */
+    child(bindings: Record<string, unknown>): PlatformLogger;
+    /** Force-flush pending writes (close file handle or POST OTLP batch). */
+    flush(): Promise<void>;
+    /** Stop accepting writes and release resources. */
+    close(): Promise<void>;
+}
+/**
+ * Creates a Pino-aligned logger that writes JSONL to disk in local mode and
+ * batches OTLP/HTTP/JSON log records to an OTel collector in cloud mode. Mode
+ * is resolved from `OTEL_EXPORTER_OTLP_ENDPOINT` or the explicit override.
+ */
+declare function createPlatformLogger(options: PlatformLoggerOptions): PlatformLogger;
+declare function defaultRunsDir(): string;
+
+export { type AggregateRunCostOptions, type AggregateRunCostResult, LOG_LEVELS, type LogLevelName, type LogLevelNumber, type LogRecord, type PinoLike, type PlatformLogger, type PlatformLoggerMode, type PlatformLoggerOptions, type PostgresLike, RUN_ID_ATTRIBUTE, RUN_STEP_TYPES, type ReadableSpanLike, type RunStepType, RunStepsSpanProcessor, type RunStepsSpanProcessorOptions, STEP_TYPE_ATTRIBUTE, type SpanContextLike, aggregateRunCost, createPlatformLogger, defaultRunsDir };