npm - @stackbone/sdk - Versions diffs - 0.1.0-alpha.8 → 0.1.0 - Mend

@stackbone/sdk 0.1.0-alpha.8 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/CHANGELOG.md +6 -0
package/README.md +0 -5
package/observability/index.cjs +1 -1
package/observability/index.cjs.map +1 -1
package/observability/index.js +1 -1
package/observability/index.js.map +1 -1
package/package.json +1 -1
package/stackbone-sdk-0.1.0.tgz +0 -0
package/stackbone-sdk-0.1.0-alpha.8.tgz +0 -0

package/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
+## [0.1.0] - 2026-07-01
+### Changed
+- **First stable release.** No API changes since `0.1.0-alpha.8`; promotes the SDK to a stable line so `npm i @stackbone/sdk` resolves it through the `latest` dist-tag and generated projects can pin it exactly.
 ## [0.1.0-alpha.8] - 2026-07-01
 ### Added

package/README.md CHANGED Viewed

@@ -26,11 +26,6 @@ Official TypeScript SDK for [Stackbone](https://stackbone.ai) — the marketplac
 `@stackbone/sdk` is the SDK every Stackbone workspace depends on. From a generated workspace:
 ```bash
-# Alpha (today)
-pnpm add @stackbone/sdk@alpha
-# Once we cut a stable release the unscoped tag will resolve to the latest
-# minor:
 pnpm add @stackbone/sdk
 ```

package/observability/index.cjs CHANGED Viewed

@@ -9,7 +9,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 // package.json
-var version = "0.1.0-alpha.8";
+var version = "0.1.0";
 var storage = new async_hooks.AsyncLocalStorage();
 function getInvocationContext() {
   return storage.getStore();

package/observability/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../../libs/sdk/package.json","../../../../libs/sdk/src/runtime/invocation-context.ts","../../../../libs/sdk/src/observability/logger.ts"],"names":["storage","AsyncLocalStorage","getInvocationContext","getStore","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","ctx","trace_id","invocationId","handler","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"],"mappings":"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","file":"index.cjs","sourcesContent":["{\n \"name\": \"@stackbone/sdk\",\n \"version\": \"0.1.0-alpha.8\",\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 \"./workflow\": {\n \"import\": {\n \"types\": \"./dist/workflow.d.ts\",\n \"default\": \"./dist/workflow.js\"\n },\n \"require\": {\n \"types\": \"./dist/workflow.d.cts\",\n \"default\": \"./dist/workflow.cjs\"\n }\n },\n \"./connect\": {\n \"import\": {\n \"types\": \"./dist/connect.d.ts\",\n \"default\": \"./dist/connect.js\"\n },\n \"require\": {\n \"types\": \"./dist/connect.d.cts\",\n \"default\": \"./dist/connect.cjs\"\n }\n },\n \"./eve\": {\n \"import\": {\n \"types\": \"./dist/eve.d.ts\",\n \"default\": \"./dist/eve.js\"\n },\n \"require\": {\n \"types\": \"./dist/eve.d.cts\",\n \"default\": \"./dist/eve.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/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 \"peerDependencies\": {\n \"@ai-sdk/openai-compatible\": \"\",\n \"eve\": \"\",\n \"workflow\": \"\"\n },\n \"peerDependenciesMeta\": {\n \"@ai-sdk/openai-compatible\": {\n \"optional\": true\n },\n \"eve\": {\n \"optional\": true\n },\n \"workflow\": {\n \"optional\": true\n }\n },\n \"dependencies\": {\n \"@aws-sdk/client-s3\": \"^3.1038.0\",\n \"@aws-sdk/s3-request-presigner\": \"^3.1038.0\",\n \"@stackbone/crypto\": \"workspace:\",\n \"@stackbone/prompt-compiler\": \"workspace:\",\n \"@stackbone/rag-core\": \"workspace:\",\n \"@stackbone/s3-client\": \"workspace:\",\n \"@stackbone/validators\": \"workspace:\",\n \"@testcontainers/postgresql\": \"^11.14.0\",\n \"drizzle-orm\": \"0.45.2\",\n \"openai\": \"^6.42.0\",\n \"postgres\": \"3.4.9\",\n \"unpdf\": \"^0.12.1\",\n \"zod\": \"^4.3.6\"\n }\n}\n","// Process-wide invocation context, propagated with `AsyncLocalStorage`.\n//\n// The runtime request handler wraps each `capability.run(...)` in this context\n// (see `@stackbone/agent-server`'s `request-handler`), so any code running\n// inside an invoke — the creator's handler, the SDK's own loggers, a stray\n// `console.log` — can recover the active `invocationId` / `runId` without the\n// handler having to thread them through every call.\n//\n// Why an ALS and not a plain module variable: the agent process serves invokes\n// concurrently (the node:http adapter does not serialise requests). A single\n// mutable \"current invocation\" would be clobbered the moment two invokes\n// overlap. `AsyncLocalStorage` keeps a separate store per async call tree, so\n// each invoke's logs stay correlated to the right run even under concurrency.\n//\n// `invocationId` is the value the canonical logs call `trace_id` (the control\n// plane mints it once per invoke and threads it through the envelope); `runId`\n// is the run the invoke belongs to.\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nexport interface InvocationContext {\n /** The envelope's `invocationId` — surfaced on log lines as `trace_id`. /\n readonly invocationId: string;\n /* The run this invoke belongs to — surfaced on log lines as `run_id`. /\n readonly runId: string;\n /\n The handler this invoke routed to — `invoke` for a direct entry or the\n * named job handler (e.g. `demo-log-job`) the dispatcher delivered to.\n * Surfaced on log lines as `handler` so the Studio logs trail can tell which\n * entrypoint emitted each line. Optional so a caller that binds a context\n * without routing info (older tests, lifecycle hooks) still type-checks.\n /\n readonly handler?: string;\n /\n The projected `run_steps.id` of the workflow step currently executing, when\n * the runtime can attribute the active async tree to one step. The\n * workflow-HITL helper reads it so an approval row can be anchored to the\n * exact step that requested it (`approvals.requested_by_step_id`, A6).\n \n GAP (2026-06-20): no caller populates this yet. The emulator binds the\n * invocation context once per WHOLE flow dispatch (see the runtime-mount\n * `flowPost` wrap), not per step, and the Workflow World runs as a FLAT tree\n * whose events carry `writer: null` / `executionContext: null`, so the\n * per-step World id is not visible at the point a `\"use step\"` runs. The seam\n * is threaded end-to-end (context → ambient approval client → INSERT) so the\n * column is stamped the moment a step id becomes available, without another\n * surface change. Until then it stays `undefined` and the column stays NULL.\n /\n readonly requestedByStepId?: string;\n}\n\nconst storage = new AsyncLocalStorage<InvocationContext>();\n\n/\n Runs `fn` with `context` bound as the active invocation. The context stays\n * available to every synchronous and asynchronous continuation rooted in this\n * call (i.e. across `await`s inside `fn`). Returns whatever `fn` returns.\n /\nexport function runWithInvocationContext<T>(context: InvocationContext, fn: () => T): T {\n return storage.run(context, fn);\n}\n\n/\n Returns the active invocation context, or `undefined` when called outside any\n * invoke (process boot, lifecycle events, tests that don't set one up).\n /\nexport function getInvocationContext(): InvocationContext \| undefined {\n return storage.getStore();\n}\n\n/\n Ergonomic wrapper for callers that already hold a single correlation id and\n * want to bind it as the active run/trace for `fn` — the durable workflow step\n * call-site is the first such caller (F5): it knows the projected `run_id` and\n * the World run id, and wraps a step's execution so the step's logs and SDK\n * operations correlate to its run.\n \n It does NOT generate ids — that stays a caller concern, exactly like\n * `runWithInvocationContext`. `runId` and `invocationId` default to the single\n * `id` you pass, so `runWithCallerId(runId, fn)` binds a context where the run\n * and trace share that id; pass distinct values (e.g. the World run id as the\n * trace) via the options form.\n /\nexport function runWithCallerId<T>(\n id: string,\n fn: () => T,\n options?: { readonly invocationId?: string; readonly handler?: string },\n): T {\n const context: InvocationContext = {\n runId: id,\n invocationId: options?.invocationId ?? id,\n // Only attach `handler` when supplied: `exactOptionalPropertyTypes` forbids\n // an explicit `undefined` on an optional property.\n ...(options?.handler !== undefined ? { handler: options.handler } : {}),\n };\n return runWithInvocationContext(context, fn);\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';\nimport { getInvocationContext } from '../runtime/invocation-context';\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 // Runtime code building a logger on the `@stackbone/sdk/observability`\n // subpath supplies `otelEndpoint` explicitly (typically plumbed from\n // `ResolvedConfig`). The `undefined` here means \"no `otelEndpoint` ⇒ local\n // 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 // Ambient invocation correlation: when used inside an invoke (the request\n // handler wraps `capability.run` in an AsyncLocalStorage context), stamp\n // `trace_id` / `run_id` from that context unless the caller already set them\n // explicitly via bindings or per-call meta. Outside an invoke there is no\n // context, so the records keep their previous shape.\n const ctx = getInvocationContext();\n if (ctx) {\n if (record.trace_id === undefined) record.trace_id = ctx.invocationId;\n if (!record.run_id) record.run_id = ctx.runId;\n if (record['handler'] === undefined && ctx.handler !== undefined) {\n record['handler'] = ctx.handler;\n }\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"]}
1	+ {"version":3,"sources":["../../../../libs/sdk/package.json","../../../../libs/sdk/src/runtime/invocation-context.ts","../../../../libs/sdk/src/observability/logger.ts"],"names":["storage","AsyncLocalStorage","getInvocationContext","getStore","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","ctx","trace_id","invocationId","handler","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"],"mappings":"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","file":"index.cjs","sourcesContent":["{\n \"name\": \"@stackbone/sdk\",\n \"version\": \"0.1.0\",\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 \"./workflow\": {\n \"import\": {\n \"types\": \"./dist/workflow.d.ts\",\n \"default\": \"./dist/workflow.js\"\n },\n \"require\": {\n \"types\": \"./dist/workflow.d.cts\",\n \"default\": \"./dist/workflow.cjs\"\n }\n },\n \"./connect\": {\n \"import\": {\n \"types\": \"./dist/connect.d.ts\",\n \"default\": \"./dist/connect.js\"\n },\n \"require\": {\n \"types\": \"./dist/connect.d.cts\",\n \"default\": \"./dist/connect.cjs\"\n }\n },\n \"./eve\": {\n \"import\": {\n \"types\": \"./dist/eve.d.ts\",\n \"default\": \"./dist/eve.js\"\n },\n \"require\": {\n \"types\": \"./dist/eve.d.cts\",\n \"default\": \"./dist/eve.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/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 \"peerDependencies\": {\n \"@ai-sdk/openai-compatible\": \"\",\n \"eve\": \"\",\n \"workflow\": \"\"\n },\n \"peerDependenciesMeta\": {\n \"@ai-sdk/openai-compatible\": {\n \"optional\": true\n },\n \"eve\": {\n \"optional\": true\n },\n \"workflow\": {\n \"optional\": true\n }\n },\n \"dependencies\": {\n \"@aws-sdk/client-s3\": \"^3.1038.0\",\n \"@aws-sdk/s3-request-presigner\": \"^3.1038.0\",\n \"@stackbone/crypto\": \"workspace:\",\n \"@stackbone/prompt-compiler\": \"workspace:\",\n \"@stackbone/rag-core\": \"workspace:\",\n \"@stackbone/s3-client\": \"workspace:\",\n \"@stackbone/validators\": \"workspace:\",\n \"@testcontainers/postgresql\": \"^11.14.0\",\n \"drizzle-orm\": \"0.45.2\",\n \"openai\": \"^6.42.0\",\n \"postgres\": \"3.4.9\",\n \"unpdf\": \"^0.12.1\",\n \"zod\": \"^4.3.6\"\n }\n}\n","// Process-wide invocation context, propagated with `AsyncLocalStorage`.\n//\n// The runtime request handler wraps each `capability.run(...)` in this context\n// (see `@stackbone/agent-server`'s `request-handler`), so any code running\n// inside an invoke — the creator's handler, the SDK's own loggers, a stray\n// `console.log` — can recover the active `invocationId` / `runId` without the\n// handler having to thread them through every call.\n//\n// Why an ALS and not a plain module variable: the agent process serves invokes\n// concurrently (the node:http adapter does not serialise requests). A single\n// mutable \"current invocation\" would be clobbered the moment two invokes\n// overlap. `AsyncLocalStorage` keeps a separate store per async call tree, so\n// each invoke's logs stay correlated to the right run even under concurrency.\n//\n// `invocationId` is the value the canonical logs call `trace_id` (the control\n// plane mints it once per invoke and threads it through the envelope); `runId`\n// is the run the invoke belongs to.\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nexport interface InvocationContext {\n /** The envelope's `invocationId` — surfaced on log lines as `trace_id`. /\n readonly invocationId: string;\n /* The run this invoke belongs to — surfaced on log lines as `run_id`. /\n readonly runId: string;\n /\n The handler this invoke routed to — `invoke` for a direct entry or the\n * named job handler (e.g. `demo-log-job`) the dispatcher delivered to.\n * Surfaced on log lines as `handler` so the Studio logs trail can tell which\n * entrypoint emitted each line. Optional so a caller that binds a context\n * without routing info (older tests, lifecycle hooks) still type-checks.\n /\n readonly handler?: string;\n /\n The projected `run_steps.id` of the workflow step currently executing, when\n * the runtime can attribute the active async tree to one step. The\n * workflow-HITL helper reads it so an approval row can be anchored to the\n * exact step that requested it (`approvals.requested_by_step_id`, A6).\n \n GAP (2026-06-20): no caller populates this yet. The emulator binds the\n * invocation context once per WHOLE flow dispatch (see the runtime-mount\n * `flowPost` wrap), not per step, and the Workflow World runs as a FLAT tree\n * whose events carry `writer: null` / `executionContext: null`, so the\n * per-step World id is not visible at the point a `\"use step\"` runs. The seam\n * is threaded end-to-end (context → ambient approval client → INSERT) so the\n * column is stamped the moment a step id becomes available, without another\n * surface change. Until then it stays `undefined` and the column stays NULL.\n /\n readonly requestedByStepId?: string;\n}\n\nconst storage = new AsyncLocalStorage<InvocationContext>();\n\n/\n Runs `fn` with `context` bound as the active invocation. The context stays\n * available to every synchronous and asynchronous continuation rooted in this\n * call (i.e. across `await`s inside `fn`). Returns whatever `fn` returns.\n /\nexport function runWithInvocationContext<T>(context: InvocationContext, fn: () => T): T {\n return storage.run(context, fn);\n}\n\n/\n Returns the active invocation context, or `undefined` when called outside any\n * invoke (process boot, lifecycle events, tests that don't set one up).\n /\nexport function getInvocationContext(): InvocationContext \| undefined {\n return storage.getStore();\n}\n\n/\n Ergonomic wrapper for callers that already hold a single correlation id and\n * want to bind it as the active run/trace for `fn` — the durable workflow step\n * call-site is the first such caller (F5): it knows the projected `run_id` and\n * the World run id, and wraps a step's execution so the step's logs and SDK\n * operations correlate to its run.\n \n It does NOT generate ids — that stays a caller concern, exactly like\n * `runWithInvocationContext`. `runId` and `invocationId` default to the single\n * `id` you pass, so `runWithCallerId(runId, fn)` binds a context where the run\n * and trace share that id; pass distinct values (e.g. the World run id as the\n * trace) via the options form.\n /\nexport function runWithCallerId<T>(\n id: string,\n fn: () => T,\n options?: { readonly invocationId?: string; readonly handler?: string },\n): T {\n const context: InvocationContext = {\n runId: id,\n invocationId: options?.invocationId ?? id,\n // Only attach `handler` when supplied: `exactOptionalPropertyTypes` forbids\n // an explicit `undefined` on an optional property.\n ...(options?.handler !== undefined ? { handler: options.handler } : {}),\n };\n return runWithInvocationContext(context, fn);\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';\nimport { getInvocationContext } from '../runtime/invocation-context';\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 // Runtime code building a logger on the `@stackbone/sdk/observability`\n // subpath supplies `otelEndpoint` explicitly (typically plumbed from\n // `ResolvedConfig`). The `undefined` here means \"no `otelEndpoint` ⇒ local\n // 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 // Ambient invocation correlation: when used inside an invoke (the request\n // handler wraps `capability.run` in an AsyncLocalStorage context), stamp\n // `trace_id` / `run_id` from that context unless the caller already set them\n // explicitly via bindings or per-call meta. Outside an invoke there is no\n // context, so the records keep their previous shape.\n const ctx = getInvocationContext();\n if (ctx) {\n if (record.trace_id === undefined) record.trace_id = ctx.invocationId;\n if (!record.run_id) record.run_id = ctx.runId;\n if (record['handler'] === undefined && ctx.handler !== undefined) {\n record['handler'] = ctx.handler;\n }\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"]}

package/observability/index.js CHANGED Viewed

@@ -7,7 +7,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 // package.json
-var version = "0.1.0-alpha.8";
+var version = "0.1.0";
 var storage = new AsyncLocalStorage();
 function getInvocationContext() {
   return storage.getStore();

package/observability/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../../../libs/sdk/package.json","../../../../libs/sdk/src/runtime/invocation-context.ts","../../../../libs/sdk/src/observability/logger.ts"],"names":["storage","AsyncLocalStorage","getInvocationContext","getStore","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","ctx","trace_id","invocationId","handler","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"],"mappings":";;;;;;;;;AAEE,IAAA,OAAA,GAAW,eAAA;ACiDb,IAAMA,OAAAA,GAAU,IAAIC,iBAAAA,EAAAA;AAeb,SAASC,oBAAAA,GAAAA;AACd,EAAA,OAAOF,QAAQG,QAAAA,EAAQ;AACzB;AAFgBD,MAAAA,CAAAA,oBAAAA,EAAAA,sBAAAA,CAAAA;;;ACzDT,IAAME,UAAAA,GAAa;EACxBC,KAAAA,EAAO,EAAA;EACPC,KAAAA,EAAO,EAAA;EACPC,IAAAA,EAAM,EAAA;EACNC,IAAAA,EAAM,EAAA;EACNC,KAAAA,EAAO,EAAA;EACPC,KAAAA,EAAO;AACT;AA6EA,IAAMC,kBAAAA,GAAqB,EAAA;AAC3B,IAAMC,mBAAAA,GAAsB,GAAA;AAC5B,IAAMC,uBAAAA,GAA0B,GAAA;AAOzB,SAASC,qBAAqBC,OAAAA,EAA8B;AAMjE,EAAA,MAAMC,YAAAA,GAAeD,QAAQC,YAAAA,IAAgBC,MAAAA;AAC7C,EAAA,MAAMC,IAAAA,GAA2BH,OAAAA,CAAQG,IAAAA,KAASF,YAAAA,GAAe,OAAA,GAAU,OAAA,CAAA;AAE3E,EAAA,MAAMG,YAAAA,GAAwC;AAAEC,IAAAA,MAAAA,EAAQL,OAAAA,CAAQM;AAAM,GAAA;AACtE,EAAA,IAAIN,QAAQO,cAAAA,KAAmBL,MAAAA,EAC7BE,YAAAA,CAAa,iBAAA,IAAqBJ,OAAAA,CAAQO,cAAAA;AAC5C,EAAA,IAAIP,QAAQQ,OAAAA,KAAYN,MAAAA,EAAWE,YAAAA,CAAa,UAAA,IAAcJ,OAAAA,CAAQQ,OAAAA;AAEtE,EAAA,MAAMC,WAAAA,GACJN,IAAAA,KAAS,OAAA,GACL,IAAIO,mBAAAA,CAAoB;AACtBC,IAAAA,QAAAA,EAAUV,YAAAA,IAAgB,EAAA;IAC1BW,kBAAAA,EAAoBZ,OAAAA,CAAQY,sBAAsB,EAAC;AACnDC,IAAAA,aAAAA,EAAeb,QAAQa,aAAAA,IAAiBf,uBAAAA;AACxCgB,IAAAA,cAAAA,EAAgBd,QAAQc,cAAAA,IAAkBlB,kBAAAA;AAC1CmB,IAAAA,eAAAA,EAAiBf,QAAQe,eAAAA,IAAmBlB,mBAAAA;IAC5C,GAAIG,OAAAA,CAAQgB,cAAcd,MAAAA,GAAY;AAAEc,MAAAA,SAAAA,EAAWhB,OAAAA,CAAQgB;AAAU,KAAA,GAAI;GAC3E,CAAA,GACA,IAAIC,oBAAAA,CAAqB;AACvBX,IAAAA,KAAAA,EAAON,OAAAA,CAAQM,KAAAA;IACfY,OAAAA,EAASlB,OAAAA,CAAQkB,WAAWC,cAAAA,EAAAA;IAC5B,GAAInB,OAAAA,CAAQoB,mBAAmBlB,MAAAA,GAC3B;AAAEkB,MAAAA,cAAAA,EAAgBpB,OAAAA,CAAQoB;AAAe,KAAA,GACzC,EAAC;IACL,GAAIpB,OAAAA,CAAQqB,cAAcnB,MAAAA,GAAY;AAAEmB,MAAAA,SAAAA,EAAWrB,OAAAA,CAAQqB;AAAU,KAAA,GAAI;GAC3E,CAAA;AAEN,EAAA,MAAMC,GAAAA,GAAMtB,OAAAA,CAAQsB,GAAAA,IAAOC,IAAAA,CAAKD,GAAAA;AAChC,EAAA,OAAOE,WAAAA,CAAY;AAAEf,IAAAA,WAAAA;AAAaL,IAAAA,YAAAA;AAAcD,IAAAA,IAAAA;AAAMmB,IAAAA;GAAI,CAAA;AAC5D;AAnCgBvB,MAAAA,CAAAA,oBAAAA,EAAAA,sBAAAA,CAAAA;AA4ChB,SAASyB,YAAYC,IAAAA,EAAwB;AAC3C,EAAA,MAAMC,OAAAA,mBAAU,MAAA,CAAA,CAACC,KAAAA,EAAqBC,QAAAA,EAAmBC,GAAAA,KAAAA;AACvD,IAAA,MAAMC,IAAAA,GAAOL,KAAKH,GAAAA,EAAG;AACrB,IAAA,MAAMS,WAAAA,GAAc1C,WAAWsC,KAAAA,CAAAA;AAC/B,IAAA,MAAMK,MAAAA,GAAoB;MACxBL,KAAAA,EAAOI,WAAAA;AACPD,MAAAA,IAAAA;MACAD,GAAAA,EAAK,EAAA;AACLxB,MAAAA,MAAAA,EAAQ4B,MAAAA,CAAOR,IAAAA,CAAKrB,YAAAA,CAAa,QAAA,KAAa,EAAA,CAAA;AAC9C,MAAA,GAAGqB,IAAAA,CAAKrB;AACV,KAAA;AACA,IAAA,IAAI,OAAOwB,aAAa,QAAA,EAAU;AAChCI,MAAAA,MAAAA,CAAOH,GAAAA,GAAMD,QAAAA;IACf,CAAA,MAAA,IAAWA,QAAAA,IAAY,OAAOA,QAAAA,KAAa,QAAA,EAAU;AACnDM,MAAAA,MAAAA,CAAOC,MAAAA,CAAOH,QAAQJ,QAAAA,CAAAA;AACtB,MAAA,IAAI,OAAOC,GAAAA,KAAQ,QAAA,EAAUG,MAAAA,CAAOH,GAAAA,GAAMA,GAAAA;AACjC,WAAA,IAAA,OAAOG,MAAAA,CAAOH,GAAAA,KAAQ,QAAA,EAAUG,MAAAA,CAAOH,GAAAA,GAAM,EAAA;AACxD,IAAA;AAMA,IAAA,MAAMO,MAAMjD,oBAAAA,EAAAA;AACZ,IAAA,IAAIiD,GAAAA,EAAK;AACP,MAAA,IAAIJ,MAAAA,CAAOK,QAAAA,KAAanC,MAAAA,EAAW8B,MAAAA,CAAOK,WAAWD,GAAAA,CAAIE,YAAAA;AACzD,MAAA,IAAI,CAACN,MAAAA,CAAO3B,MAAAA,EAAQ2B,MAAAA,CAAO3B,SAAS+B,GAAAA,CAAI9B,KAAAA;AACxC,MAAA,IAAI0B,OAAO,SAAA,CAAA,KAAe9B,MAAAA,IAAakC,GAAAA,CAAIG,YAAYrC,MAAAA,EAAW;AAChE8B,QAAAA,MAAAA,CAAO,SAAA,IAAaI,GAAAA,CAAIG,OAAAA;AAC1B,MAAA;AACF,IAAA;AACAd,IAAAA,IAAAA,CAAKhB,WAAAA,CAAY+B,MAAMR,MAAAA,CAAAA;EACzB,CAAA,EA/BgB,SAAA,CAAA;AAiChB,EAAA,MAAMS,KAAAA,mBAAQ,MAAA,CAAA,CAACC,QAAAA,KACblB,WAAAA,CAAY;IAAE,GAAGC,IAAAA;IAAMrB,YAAAA,EAAc;AAAE,MAAA,GAAGqB,IAAAA,CAAKrB,YAAAA;MAAc,GAAGsC;AAAS;AAAE,GAAA,CAAA,EAD/D,OAAA,CAAA;AAGd,EAAA,OAAO;AACLvC,IAAAA,IAAAA,EAAMsB,IAAAA,CAAKtB,IAAAA;AACXb,IAAAA,KAAAA,0BAAQsC,QAAAA,EAAUC,GAAAA,KAAQH,QAAQ,OAAA,EAASE,QAAAA,EAAUC,GAAAA,CAAAA,EAA9C,OAAA,CAAA;AACPtC,IAAAA,KAAAA,0BAAQqC,QAAAA,EAAUC,GAAAA,KAAQH,QAAQ,OAAA,EAASE,QAAAA,EAAUC,GAAAA,CAAAA,EAA9C,OAAA,CAAA;AACPrC,IAAAA,IAAAA,0BAAOoC,QAAAA,EAAUC,GAAAA,KAAQH,QAAQ,MAAA,EAAQE,QAAAA,EAAUC,GAAAA,CAAAA,EAA7C,MAAA,CAAA;AACNpC,IAAAA,IAAAA,0BAAOmC,QAAAA,EAAUC,GAAAA,KAAQH,QAAQ,MAAA,EAAQE,QAAAA,EAAUC,GAAAA,CAAAA,EAA7C,MAAA,CAAA;AACNnC,IAAAA,KAAAA,0BAAQkC,QAAAA,EAAUC,GAAAA,KAAQH,QAAQ,OAAA,EAASE,QAAAA,EAAUC,GAAAA,CAAAA,EAA9C,OAAA,CAAA;AACPlC,IAAAA,KAAAA,0BAAQiC,QAAAA,EAAUC,GAAAA,KAAQH,QAAQ,OAAA,EAASE,QAAAA,EAAUC,GAAAA,CAAAA,EAA9C,OAAA,CAAA;AACPY,IAAAA,KAAAA;AACAE,IAAAA,KAAAA,kBAAO,MAAA,CAAA,MAAMlB,IAAAA,CAAKhB,WAAAA,CAAYkC,KAAAA,EAAK,EAA5B,OAAA,CAAA;AACPC,IAAAA,KAAAA,kBAAO,MAAA,CAAA,MAAMnB,IAAAA,CAAKhB,WAAAA,CAAYmC,KAAAA,EAAK,EAA5B,OAAA;AACT,GAAA;AACF;AAjDSpB,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA;AA0DT,IAAMP,oBAAAA,GAAN,MAAMA,qBAAAA,CAAAA;EA5MN;;;AA6MmB4B,EAAAA,IAAAA;AACAC,EAAAA,UAAAA;AACAC,EAAAA,KAAAA;AACTC,EAAAA,QAAAA,GAA0BC,QAAQC,OAAAA,EAAO;EACzCC,QAAAA,GAAW,KAAA;AAEnB,EAAA,WAAA,CAAY1B,IAAAA,EAAmC;AAC7C,IAAA,IAAA,CAAKoB,OAAOK,OAAAA,CAAQzB,IAAAA,CAAKP,SAAS,CAAA,EAAGO,IAAAA,CAAKnB,KAAK,CAAA,MAAA,CAAQ,CAAA;AACvD,IAAA,IAAA,CAAKwC,UAAAA,GAAarB,KAAKL,cAAAA,KAAmB,CAACgC,GAAGC,CAAAA,KAAMP,UAAAA,CAAWM,CAAAA,EAAGC,CAAAA,EAAG,MAAA,CAAA,CAAA;AACrE,IAAA,IAAA,CAAKN,KAAAA,GACHtB,IAAAA,CAAKJ,SAAAA,KACJ,OAAO+B,CAAAA,KAAAA;AACN,MAAA,MAAML,MAAMK,CAAAA,EAAG;QAAEE,SAAAA,EAAW;OAAK,CAAA;AACnC,IAAA,CAAA,CAAA;AACJ,EAAA;AAEAd,EAAAA,KAAAA,CAAMR,MAAAA,EAAyB;AAC7B,IAAA,MAAMuB,IAAAA,GAAO,CAAA,EAAGC,IAAAA,CAAKC,SAAAA,CAAUzB,MAAAA,CAAAA;;AAC/B,IAAA,IAAA,CAAKgB,QAAAA,GAAW,IAAA,CAAKA,QAAAA,CAASU,IAAAA,CAAK,YAAA;AACjC,MAAA,IAAI,CAAC,KAAKP,QAAAA,EAAU;AAClB,QAAA,MAAM,IAAA,CAAKJ,KAAAA,CAAMY,OAAAA,CAAQ,IAAA,CAAKd,IAAI,CAAA,CAAA;AAClC,QAAA,IAAA,CAAKM,QAAAA,GAAW,IAAA;AAClB,MAAA;AACA,MAAA,IAAI;AACF,QAAA,MAAM,IAAA,CAAKL,UAAAA,CAAW,IAAA,CAAKD,IAAAA,EAAMU,IAAAA,CAAAA;AACnC,MAAA,CAAA,CAAA,OAAS7D,KAAAA,EAAO;AACdkE,QAAAA,OAAAA,CAAQC,MAAAA,CAAOrB,MACb,CAAA,mDAAA,EAAsD9C,KAAAA,YAAiBoE,QAAQpE,KAAAA,CAAMqE,OAAAA,GAAU9B,MAAAA,CAAOvC,KAAAA,CAAAA;AAAU,CAAA,CAAA;AAEpH,MAAA;IACF,CAAA,CAAA;AACF,EAAA;AAEA,EAAA,MAAMiD,KAAAA,GAAuB;AAC3B,IAAA,MAAM,IAAA,CAAKK,QAAAA;AACb,EAAA;AAEA,EAAA,MAAMJ,KAAAA,GAAuB;AAC3B,IAAA,MAAM,KAAKD,KAAAA,EAAK;AAClB,EAAA;AACF,CAAA;AAaA,IAAMjC,mBAAAA,GAAN,MAAMA,oBAAAA,CAAAA;EAlQN;;;AAmQmBsD,EAAAA,GAAAA;AACApD,EAAAA,kBAAAA;AACAC,EAAAA,aAAAA;AACAC,EAAAA,cAAAA;AACAC,EAAAA,eAAAA;AACAC,EAAAA,SAAAA;AACTiD,EAAAA,MAAAA,GAAsB,EAAA;EACtBC,KAAAA,GAA+B,IAAA;AAC/BlB,EAAAA,QAAAA,GAA0BC,QAAQC,OAAAA,EAAO;EACzCiB,MAAAA,GAAS,KAAA;AAEjB,EAAA,WAAA,CAAY1C,IAAAA,EAAkC;AAC5C,IAAA,IAAA,CAAKuC,MAAM,CAAA,EAAGvC,IAAAA,CAAKd,SAASyD,OAAAA,CAAQ,MAAA,EAAQ,EAAA,CAAA,CAAA,QAAA,CAAA;AAC5C,IAAA,IAAA,CAAKxD,qBAAqBa,IAAAA,CAAKb,kBAAAA;AAC/B,IAAA,IAAA,CAAKC,gBAAgBY,IAAAA,CAAKZ,aAAAA;AAC1B,IAAA,IAAA,CAAKC,iBAAiBW,IAAAA,CAAKX,cAAAA;AAC3B,IAAA,IAAA,CAAKC,kBAAkBU,IAAAA,CAAKV,eAAAA;AAC5B,IAAA,IAAA,CAAKC,SAAAA,GAAYS,KAAKT,SAAAA,IAAaqD,KAAAA;AACrC,EAAA;AAEA7B,EAAAA,KAAAA,CAAMR,MAAAA,EAAyB;AAC7B,IAAA,IAAI,KAAKmC,MAAAA,EAAQ;AACjB,IAAA,IAAA,CAAKF,MAAAA,CAAOK,KAAKtC,MAAAA,CAAAA;AACjB,IAAA,IAAI,IAAA,CAAKiC,MAAAA,CAAOM,MAAAA,IAAU,IAAA,CAAKzD,cAAAA,EAAgB;AAC7C,MAAA,KAAK,KAAK6B,KAAAA,EAAK;IACjB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK6B,QAAAA,EAAQ;AACf,IAAA;AACF,EAAA;AAEA,EAAA,MAAM7B,KAAAA,GAAuB;AAC3B,IAAA,MAAM,IAAA,CAAKK,QAAAA;AACX,IAAA,IAAI,IAAA,CAAKiB,MAAAA,CAAOM,MAAAA,KAAW,CAAA,EAAG;AAC9B,IAAA,MAAME,UAAU,IAAA,CAAKR,MAAAA,CAAOS,OAAO,CAAA,EAAG,IAAA,CAAKT,OAAOM,MAAM,CAAA;AACxD,IAAA,IAAA,CAAKI,WAAAA,EAAW;AAChB,IAAA,IAAA,CAAK3B,WAAW,IAAA,CAAK4B,IAAAA,CAAKH,OAAAA,CAAAA,CAASI,KAAAA,CAAM,CAACnF,KAAAA,KAAAA;AACxCkE,MAAAA,OAAAA,CAAQC,MAAAA,CAAOrB,MACb,CAAA,iDAAA,EAAoD9C,KAAAA,YAAiBoE,QAAQpE,KAAAA,CAAMqE,OAAAA,GAAU9B,MAAAA,CAAOvC,KAAAA,CAAAA;AAAU,CAAA,CAAA;IAElH,CAAA,CAAA;AACA,IAAA,MAAM,IAAA,CAAKsD,QAAAA;AACb,EAAA;AAEA,EAAA,MAAMJ,KAAAA,GAAuB;AAC3B,IAAA,IAAA,CAAKuB,MAAAA,GAAS,IAAA;AACd,IAAA,MAAM,KAAKxB,KAAAA,EAAK;AAClB,EAAA;EAEQ6B,QAAAA,GAAiB;AACvB,IAAA,IAAI,KAAKN,KAAAA,EAAO;AAChB,IAAA,IAAA,CAAKA,KAAAA,GAAQY,WAAW,MAAA;AACtB,MAAA,IAAA,CAAKZ,KAAAA,GAAQ,IAAA;AACb,MAAA,KAAK,KAAKvB,KAAAA,EAAK;AACjB,IAAA,CAAA,EAAG,KAAK5B,eAAe,CAAA;AACvB,IAAA,IAAA,CAAKmD,MAAMa,KAAAA,IAAK;AAClB,EAAA;EAEQJ,WAAAA,GAAoB;AAC1B,IAAA,IAAI,KAAKT,KAAAA,EAAO;AACdc,MAAAA,YAAAA,CAAa,KAAKd,KAAK,CAAA;AACvB,MAAA,IAAA,CAAKA,KAAAA,GAAQ,IAAA;AACf,IAAA;AACF,EAAA;AAEA,EAAA,MAAcU,KAAKK,OAAAA,EAAqC;AACtD,IAAA,MAAMC,OAAO1B,IAAAA,CAAKC,SAAAA,CAAU0B,kBAAkBF,OAAAA,EAAS,IAAA,CAAKrE,kBAAkB,CAAA,CAAA;AAC9E,IAAA,MAAMwE,UAAAA,GAAa,IAAIC,eAAAA,EAAAA;AACvB,IAAA,MAAMC,UAAUR,UAAAA,CAAW,MAAMM,WAAWG,KAAAA,EAAK,EAAI,KAAK1E,aAAa,CAAA;AACvE,IAAA,IAAI;AACF,MAAA,MAAM2E,IAAAA,GAAO,MAAM,IAAA,CAAKxE,SAAAA,CAAU,KAAKgD,GAAAA,EAAK;QAC1CyB,MAAAA,EAAQ,MAAA;QACRC,OAAAA,EAAS;UAAE,cAAA,EAAgB;AAAmB,SAAA;AAC9CR,QAAAA,IAAAA;AACAS,QAAAA,MAAAA,EAAQP,UAAAA,CAAWO;OACrB,CAAA;AACA,MAAA,IAAI,CAACH,KAAKI,EAAAA,EAAI;AACZ,QAAA,MAAMC,OAAO,MAAML,IAAAA,CAAKK,MAAI,CAAGhB,KAAAA,CAAM,MAAM,EAAA,CAAA;AAC3C,QAAA,MAAM,IAAIf,KAAAA,CAAM,CAAA,KAAA,EAAQ0B,IAAAA,CAAKM,MAAM,CAAA,EAAGD,IAAAA,GAAO,CAAA,EAAA,EAAKA,IAAAA,CAAKE,MAAM,CAAA,EAAG,GAAA,CAAA,CAAA,CAAA,GAAS,EAAA,CAAA,CAAI,CAAA;AAC/E,MAAA;IACF,CAAA,SAAA;AACEf,MAAAA,YAAAA,CAAaM,OAAAA,CAAAA;AACf,IAAA;AACF,EAAA;AACF,CAAA;AAiCA,IAAMU,SAAAA,GAAY;EAAEC,IAAAA,EAAM,gBAAA;AAAkBC,EAAAA;AAAqB,CAAA;AAEjE,SAASf,iBAAAA,CACPF,SACArE,kBAAAA,EAA0C;AAE1C,EAAA,OAAO;IACLuF,YAAAA,EAAc;AACZ,MAAA;QACEC,QAAAA,EAAU;AAAEC,UAAAA,UAAAA,EAAYC,iBAAiB1F,kBAAAA;AAAoB,SAAA;QAC7D2F,SAAAA,EAAW;AACT,UAAA;YACEC,KAAAA,EAAOR,SAAAA;YACPS,UAAAA,EAAYxB,OAAAA,CAAQyB,IAAIC,eAAAA;AAC1B;;AAEJ;;AAEJ,GAAA;AACF;AAjBSxB,MAAAA,CAAAA,iBAAAA,EAAAA,mBAAAA,CAAAA;AAmBT,SAASwB,gBAAgB3E,MAAAA,EAAiB;AACxC,EAAA,MAAM,EAAEL,KAAAA,EAAOG,IAAAA,EAAMD,GAAAA,EAAK,GAAG+E,MAAAA,GAAS5E,MAAAA;AACtC,EAAA,OAAO;IACL6E,YAAAA,EAAc,CAAA,EAAG/E,OAAO,GAAA,CAAA,CAAA;IACxBgF,cAAAA,EAAgBnF,KAAAA;AAChBoF,IAAAA,YAAAA,EAAcA,aAAapF,KAAAA,CAAAA;IAC3BuD,IAAAA,EAAM;MAAE8B,WAAAA,EAAanF;AAAI,KAAA;AACzBwE,IAAAA,UAAAA,EAAYY,4BAA4BL,IAAAA;AAC1C,GAAA;AACF;AATSD,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAWT,IAAMO,sBAAAA,GAAiDhF,MAAAA,CAAOiF,WAAAA,CAC5DjF,MAAAA,CAAOkF,OAAAA,CAAQ/H,UAAAA,CAAAA,CAAYqH,GAAAA,CAAI,CAAC,CAACT,IAAAA,EAAMoB,KAAAA,CAAAA,KAAW;AAACA,EAAAA,KAAAA;AAAOpB,EAAAA,IAAAA,CAAKqB,WAAAA;CAAc,CAAA,CAAA;AAG/E,SAASP,aAAapF,KAAAA,EAAa;AACjC,EAAA,OAAOuF,sBAAAA,CAAuBvF,KAAAA,CAAAA,IAAU,MAAA;AAC1C;AAFSoF,MAAAA,CAAAA,YAAAA,EAAAA,cAAAA,CAAAA;AAIT,SAAST,iBAAiBiB,KAAAA,EAA6B;AACrD,EAAA,OAAOrF,MAAAA,CAAOkF,QAAQG,KAAAA,CAAAA,CAAOb,IAAI,CAAC,CAACc,GAAAA,EAAKH,KAAAA,CAAAA,MAAY;AAClDG,IAAAA,GAAAA;IACAH,KAAAA,EAAO;MAAEL,WAAAA,EAAaK;AAAM;GAC9B,CAAA,CAAA;AACF;AALSf,MAAAA,CAAAA,gBAAAA,EAAAA,kBAAAA,CAAAA;AAOT,SAASW,4BAA4BM,KAAAA,EAA8B;AACjE,EAAA,MAAME,MAAsB,EAAA;AAC5B,EAAA,KAAA,MAAW,CAACD,GAAAA,EAAKH,KAAAA,KAAUnF,MAAAA,CAAOkF,OAAAA,CAAQG,KAAAA,CAAAA,EAAQ;AAChD,IAAA,IAAIF,KAAAA,KAAU,IAAA,IAAQA,KAAAA,KAAUnH,MAAAA,EAAW;AAC3C,IAAA,IAAI,OAAOmH,UAAU,QAAA,EAAU;AAC7BI,MAAAA,GAAAA,CAAInD,IAAAA,CAAK;AAAEkD,QAAAA,GAAAA;QAAKH,KAAAA,EAAO;UAAEL,WAAAA,EAAaK;AAAM;OAAE,CAAA;IAChD,CAAA,MAAA,IAAW,OAAOA,UAAU,QAAA,EAAU;AACpC,MAAA,IAAIK,MAAAA,CAAOC,SAAAA,CAAUN,KAAAA,CAAAA,MAAY/C,IAAAA,CAAK;AAAEkD,QAAAA,GAAAA;QAAKH,KAAAA,EAAO;AAAEO,UAAAA,QAAAA,EAAU3F,OAAOoF,KAAAA;AAAO;OAAE,CAAA;AAC3EI,WAAAA,GAAAA,CAAInD,IAAAA,CAAK;AAAEkD,QAAAA,GAAAA;QAAKH,KAAAA,EAAO;UAAEQ,WAAAA,EAAaR;AAAM;OAAE,CAAA;IACrD,CAAA,MAAA,IAAW,OAAOA,UAAU,SAAA,EAAW;AACrCI,MAAAA,GAAAA,CAAInD,IAAAA,CAAK;AAAEkD,QAAAA,GAAAA;QAAKH,KAAAA,EAAO;UAAES,SAAAA,EAAWT;AAAM;OAAE,CAAA;IAC9C,CAAA,MAAO;AACLI,MAAAA,GAAAA,CAAInD,IAAAA,CAAK;AAAEkD,QAAAA,GAAAA;QAAKH,KAAAA,EAAO;UAAEL,WAAAA,EAAaxD,IAAAA,CAAKC,UAAU4D,KAAAA;AAAO;OAAE,CAAA;AAChE,IAAA;AACF,EAAA;AACA,EAAA,OAAOI,GAAAA;AACT;AAhBSR,MAAAA,CAAAA,2BAAAA,EAAAA,6BAAAA,CAAAA;AAkBF,SAAS9F,cAAAA,GAAAA;AACd,EAAA,OAAO+B,OAAAA,CAAQ6E,OAAAA,EAAAA,EAAW,YAAA,EAAc,OAAO,MAAA,CAAA;AACjD;AAFgB5G,MAAAA,CAAAA,cAAAA,EAAAA,gBAAAA,CAAAA","file":"index.js","sourcesContent":["{\n \"name\": \"@stackbone/sdk\",\n \"version\": \"0.1.0-alpha.8\",\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 \"./workflow\": {\n \"import\": {\n \"types\": \"./dist/workflow.d.ts\",\n \"default\": \"./dist/workflow.js\"\n },\n \"require\": {\n \"types\": \"./dist/workflow.d.cts\",\n \"default\": \"./dist/workflow.cjs\"\n }\n },\n \"./connect\": {\n \"import\": {\n \"types\": \"./dist/connect.d.ts\",\n \"default\": \"./dist/connect.js\"\n },\n \"require\": {\n \"types\": \"./dist/connect.d.cts\",\n \"default\": \"./dist/connect.cjs\"\n }\n },\n \"./eve\": {\n \"import\": {\n \"types\": \"./dist/eve.d.ts\",\n \"default\": \"./dist/eve.js\"\n },\n \"require\": {\n \"types\": \"./dist/eve.d.cts\",\n \"default\": \"./dist/eve.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/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 \"peerDependencies\": {\n \"@ai-sdk/openai-compatible\": \"\",\n \"eve\": \"\",\n \"workflow\": \"\"\n },\n \"peerDependenciesMeta\": {\n \"@ai-sdk/openai-compatible\": {\n \"optional\": true\n },\n \"eve\": {\n \"optional\": true\n },\n \"workflow\": {\n \"optional\": true\n }\n },\n \"dependencies\": {\n \"@aws-sdk/client-s3\": \"^3.1038.0\",\n \"@aws-sdk/s3-request-presigner\": \"^3.1038.0\",\n \"@stackbone/crypto\": \"workspace:\",\n \"@stackbone/prompt-compiler\": \"workspace:\",\n \"@stackbone/rag-core\": \"workspace:\",\n \"@stackbone/s3-client\": \"workspace:\",\n \"@stackbone/validators\": \"workspace:\",\n \"@testcontainers/postgresql\": \"^11.14.0\",\n \"drizzle-orm\": \"0.45.2\",\n \"openai\": \"^6.42.0\",\n \"postgres\": \"3.4.9\",\n \"unpdf\": \"^0.12.1\",\n \"zod\": \"^4.3.6\"\n }\n}\n","// Process-wide invocation context, propagated with `AsyncLocalStorage`.\n//\n// The runtime request handler wraps each `capability.run(...)` in this context\n// (see `@stackbone/agent-server`'s `request-handler`), so any code running\n// inside an invoke — the creator's handler, the SDK's own loggers, a stray\n// `console.log` — can recover the active `invocationId` / `runId` without the\n// handler having to thread them through every call.\n//\n// Why an ALS and not a plain module variable: the agent process serves invokes\n// concurrently (the node:http adapter does not serialise requests). A single\n// mutable \"current invocation\" would be clobbered the moment two invokes\n// overlap. `AsyncLocalStorage` keeps a separate store per async call tree, so\n// each invoke's logs stay correlated to the right run even under concurrency.\n//\n// `invocationId` is the value the canonical logs call `trace_id` (the control\n// plane mints it once per invoke and threads it through the envelope); `runId`\n// is the run the invoke belongs to.\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nexport interface InvocationContext {\n /** The envelope's `invocationId` — surfaced on log lines as `trace_id`. /\n readonly invocationId: string;\n /* The run this invoke belongs to — surfaced on log lines as `run_id`. /\n readonly runId: string;\n /\n The handler this invoke routed to — `invoke` for a direct entry or the\n * named job handler (e.g. `demo-log-job`) the dispatcher delivered to.\n * Surfaced on log lines as `handler` so the Studio logs trail can tell which\n * entrypoint emitted each line. Optional so a caller that binds a context\n * without routing info (older tests, lifecycle hooks) still type-checks.\n /\n readonly handler?: string;\n /\n The projected `run_steps.id` of the workflow step currently executing, when\n * the runtime can attribute the active async tree to one step. The\n * workflow-HITL helper reads it so an approval row can be anchored to the\n * exact step that requested it (`approvals.requested_by_step_id`, A6).\n \n GAP (2026-06-20): no caller populates this yet. The emulator binds the\n * invocation context once per WHOLE flow dispatch (see the runtime-mount\n * `flowPost` wrap), not per step, and the Workflow World runs as a FLAT tree\n * whose events carry `writer: null` / `executionContext: null`, so the\n * per-step World id is not visible at the point a `\"use step\"` runs. The seam\n * is threaded end-to-end (context → ambient approval client → INSERT) so the\n * column is stamped the moment a step id becomes available, without another\n * surface change. Until then it stays `undefined` and the column stays NULL.\n /\n readonly requestedByStepId?: string;\n}\n\nconst storage = new AsyncLocalStorage<InvocationContext>();\n\n/\n Runs `fn` with `context` bound as the active invocation. The context stays\n * available to every synchronous and asynchronous continuation rooted in this\n * call (i.e. across `await`s inside `fn`). Returns whatever `fn` returns.\n /\nexport function runWithInvocationContext<T>(context: InvocationContext, fn: () => T): T {\n return storage.run(context, fn);\n}\n\n/\n Returns the active invocation context, or `undefined` when called outside any\n * invoke (process boot, lifecycle events, tests that don't set one up).\n /\nexport function getInvocationContext(): InvocationContext \| undefined {\n return storage.getStore();\n}\n\n/\n Ergonomic wrapper for callers that already hold a single correlation id and\n * want to bind it as the active run/trace for `fn` — the durable workflow step\n * call-site is the first such caller (F5): it knows the projected `run_id` and\n * the World run id, and wraps a step's execution so the step's logs and SDK\n * operations correlate to its run.\n \n It does NOT generate ids — that stays a caller concern, exactly like\n * `runWithInvocationContext`. `runId` and `invocationId` default to the single\n * `id` you pass, so `runWithCallerId(runId, fn)` binds a context where the run\n * and trace share that id; pass distinct values (e.g. the World run id as the\n * trace) via the options form.\n /\nexport function runWithCallerId<T>(\n id: string,\n fn: () => T,\n options?: { readonly invocationId?: string; readonly handler?: string },\n): T {\n const context: InvocationContext = {\n runId: id,\n invocationId: options?.invocationId ?? id,\n // Only attach `handler` when supplied: `exactOptionalPropertyTypes` forbids\n // an explicit `undefined` on an optional property.\n ...(options?.handler !== undefined ? { handler: options.handler } : {}),\n };\n return runWithInvocationContext(context, fn);\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';\nimport { getInvocationContext } from '../runtime/invocation-context';\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 // Runtime code building a logger on the `@stackbone/sdk/observability`\n // subpath supplies `otelEndpoint` explicitly (typically plumbed from\n // `ResolvedConfig`). The `undefined` here means \"no `otelEndpoint` ⇒ local\n // 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 // Ambient invocation correlation: when used inside an invoke (the request\n // handler wraps `capability.run` in an AsyncLocalStorage context), stamp\n // `trace_id` / `run_id` from that context unless the caller already set them\n // explicitly via bindings or per-call meta. Outside an invoke there is no\n // context, so the records keep their previous shape.\n const ctx = getInvocationContext();\n if (ctx) {\n if (record.trace_id === undefined) record.trace_id = ctx.invocationId;\n if (!record.run_id) record.run_id = ctx.runId;\n if (record['handler'] === undefined && ctx.handler !== undefined) {\n record['handler'] = ctx.handler;\n }\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"]}
1	+ {"version":3,"sources":["../../../../libs/sdk/package.json","../../../../libs/sdk/src/runtime/invocation-context.ts","../../../../libs/sdk/src/observability/logger.ts"],"names":["storage","AsyncLocalStorage","getInvocationContext","getStore","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","ctx","trace_id","invocationId","handler","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"],"mappings":"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","file":"index.js","sourcesContent":["{\n \"name\": \"@stackbone/sdk\",\n \"version\": \"0.1.0\",\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 \"./workflow\": {\n \"import\": {\n \"types\": \"./dist/workflow.d.ts\",\n \"default\": \"./dist/workflow.js\"\n },\n \"require\": {\n \"types\": \"./dist/workflow.d.cts\",\n \"default\": \"./dist/workflow.cjs\"\n }\n },\n \"./connect\": {\n \"import\": {\n \"types\": \"./dist/connect.d.ts\",\n \"default\": \"./dist/connect.js\"\n },\n \"require\": {\n \"types\": \"./dist/connect.d.cts\",\n \"default\": \"./dist/connect.cjs\"\n }\n },\n \"./eve\": {\n \"import\": {\n \"types\": \"./dist/eve.d.ts\",\n \"default\": \"./dist/eve.js\"\n },\n \"require\": {\n \"types\": \"./dist/eve.d.cts\",\n \"default\": \"./dist/eve.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/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 \"peerDependencies\": {\n \"@ai-sdk/openai-compatible\": \"\",\n \"eve\": \"\",\n \"workflow\": \"\"\n },\n \"peerDependenciesMeta\": {\n \"@ai-sdk/openai-compatible\": {\n \"optional\": true\n },\n \"eve\": {\n \"optional\": true\n },\n \"workflow\": {\n \"optional\": true\n }\n },\n \"dependencies\": {\n \"@aws-sdk/client-s3\": \"^3.1038.0\",\n \"@aws-sdk/s3-request-presigner\": \"^3.1038.0\",\n \"@stackbone/crypto\": \"workspace:\",\n \"@stackbone/prompt-compiler\": \"workspace:\",\n \"@stackbone/rag-core\": \"workspace:\",\n \"@stackbone/s3-client\": \"workspace:\",\n \"@stackbone/validators\": \"workspace:\",\n \"@testcontainers/postgresql\": \"^11.14.0\",\n \"drizzle-orm\": \"0.45.2\",\n \"openai\": \"^6.42.0\",\n \"postgres\": \"3.4.9\",\n \"unpdf\": \"^0.12.1\",\n \"zod\": \"^4.3.6\"\n }\n}\n","// Process-wide invocation context, propagated with `AsyncLocalStorage`.\n//\n// The runtime request handler wraps each `capability.run(...)` in this context\n// (see `@stackbone/agent-server`'s `request-handler`), so any code running\n// inside an invoke — the creator's handler, the SDK's own loggers, a stray\n// `console.log` — can recover the active `invocationId` / `runId` without the\n// handler having to thread them through every call.\n//\n// Why an ALS and not a plain module variable: the agent process serves invokes\n// concurrently (the node:http adapter does not serialise requests). A single\n// mutable \"current invocation\" would be clobbered the moment two invokes\n// overlap. `AsyncLocalStorage` keeps a separate store per async call tree, so\n// each invoke's logs stay correlated to the right run even under concurrency.\n//\n// `invocationId` is the value the canonical logs call `trace_id` (the control\n// plane mints it once per invoke and threads it through the envelope); `runId`\n// is the run the invoke belongs to.\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nexport interface InvocationContext {\n /** The envelope's `invocationId` — surfaced on log lines as `trace_id`. /\n readonly invocationId: string;\n /* The run this invoke belongs to — surfaced on log lines as `run_id`. /\n readonly runId: string;\n /\n The handler this invoke routed to — `invoke` for a direct entry or the\n * named job handler (e.g. `demo-log-job`) the dispatcher delivered to.\n * Surfaced on log lines as `handler` so the Studio logs trail can tell which\n * entrypoint emitted each line. Optional so a caller that binds a context\n * without routing info (older tests, lifecycle hooks) still type-checks.\n /\n readonly handler?: string;\n /\n The projected `run_steps.id` of the workflow step currently executing, when\n * the runtime can attribute the active async tree to one step. The\n * workflow-HITL helper reads it so an approval row can be anchored to the\n * exact step that requested it (`approvals.requested_by_step_id`, A6).\n \n GAP (2026-06-20): no caller populates this yet. The emulator binds the\n * invocation context once per WHOLE flow dispatch (see the runtime-mount\n * `flowPost` wrap), not per step, and the Workflow World runs as a FLAT tree\n * whose events carry `writer: null` / `executionContext: null`, so the\n * per-step World id is not visible at the point a `\"use step\"` runs. The seam\n * is threaded end-to-end (context → ambient approval client → INSERT) so the\n * column is stamped the moment a step id becomes available, without another\n * surface change. Until then it stays `undefined` and the column stays NULL.\n /\n readonly requestedByStepId?: string;\n}\n\nconst storage = new AsyncLocalStorage<InvocationContext>();\n\n/\n Runs `fn` with `context` bound as the active invocation. The context stays\n * available to every synchronous and asynchronous continuation rooted in this\n * call (i.e. across `await`s inside `fn`). Returns whatever `fn` returns.\n /\nexport function runWithInvocationContext<T>(context: InvocationContext, fn: () => T): T {\n return storage.run(context, fn);\n}\n\n/\n Returns the active invocation context, or `undefined` when called outside any\n * invoke (process boot, lifecycle events, tests that don't set one up).\n /\nexport function getInvocationContext(): InvocationContext \| undefined {\n return storage.getStore();\n}\n\n/\n Ergonomic wrapper for callers that already hold a single correlation id and\n * want to bind it as the active run/trace for `fn` — the durable workflow step\n * call-site is the first such caller (F5): it knows the projected `run_id` and\n * the World run id, and wraps a step's execution so the step's logs and SDK\n * operations correlate to its run.\n \n It does NOT generate ids — that stays a caller concern, exactly like\n * `runWithInvocationContext`. `runId` and `invocationId` default to the single\n * `id` you pass, so `runWithCallerId(runId, fn)` binds a context where the run\n * and trace share that id; pass distinct values (e.g. the World run id as the\n * trace) via the options form.\n /\nexport function runWithCallerId<T>(\n id: string,\n fn: () => T,\n options?: { readonly invocationId?: string; readonly handler?: string },\n): T {\n const context: InvocationContext = {\n runId: id,\n invocationId: options?.invocationId ?? id,\n // Only attach `handler` when supplied: `exactOptionalPropertyTypes` forbids\n // an explicit `undefined` on an optional property.\n ...(options?.handler !== undefined ? { handler: options.handler } : {}),\n };\n return runWithInvocationContext(context, fn);\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';\nimport { getInvocationContext } from '../runtime/invocation-context';\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 // Runtime code building a logger on the `@stackbone/sdk/observability`\n // subpath supplies `otelEndpoint` explicitly (typically plumbed from\n // `ResolvedConfig`). The `undefined` here means \"no `otelEndpoint` ⇒ local\n // 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 // Ambient invocation correlation: when used inside an invoke (the request\n // handler wraps `capability.run` in an AsyncLocalStorage context), stamp\n // `trace_id` / `run_id` from that context unless the caller already set them\n // explicitly via bindings or per-call meta. Outside an invoke there is no\n // context, so the records keep their previous shape.\n const ctx = getInvocationContext();\n if (ctx) {\n if (record.trace_id === undefined) record.trace_id = ctx.invocationId;\n if (!record.run_id) record.run_id = ctx.runId;\n if (record['handler'] === undefined && ctx.handler !== undefined) {\n record['handler'] = ctx.handler;\n }\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"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@stackbone/sdk",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0",
   "license": "UNLICENSED",
   "description": "Official TypeScript SDK for Stackbone — the marketplace and managed runtime for containerized AI agents.",
   "type": "module",

package/stackbone-sdk-0.1.0.tgz ADDED Viewed

Binary file

package/stackbone-sdk-0.1.0-alpha.8.tgz DELETED Viewed

Binary file