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

package/index.d.cts

@@ -19,10 +19,9 @@ interface ClientConfig {
     agentId?: string;
     /**
      * Postgres connection string consumed by `client.rag` and the platform
-     * observability exporter. Falls back to `DATABASE_URL`. Note: `client.database`
-     * uses `STACKBONE_POSTGRES_URL` instead — the two env vars are intentionally
-     * different so that the SDK's own DB pool stays decoupled from the legacy
-     * `DATABASE_URL` consumers until `feature 30` consolidates them.
+     * observability exporter. Falls back to `STACKBONE_POSTGRES_URL` — the same
+     * env var `client.database` reads, so a single connection string covers
+     * every SDK consumer that talks to the agent's Postgres.
      */
     databaseUrl?: string;
     openrouterKey?: string;
@@ -46,14 +45,16 @@ interface ClientConfig {
      */
     installationId?: string;
     s3?: {
-        /** Falls back to `AWS_ACCESS_KEY_ID`. */
+        /** Falls back to `STACKBONE_S3_ACCESS_KEY`. */
         accessKeyId?: string;
-        /** Falls back to `AWS_SECRET_ACCESS_KEY`. */
+        /** Falls back to `STACKBONE_S3_SECRET_KEY`. */
         secretAccessKey?: string;
-        /** Falls back to `S3_ENDPOINT`. */
+        /** Falls back to `STACKBONE_S3_ENDPOINT`. */
         endpoint?: string;
-        /** Physical R2/S3 bucket scoped to the agent. Falls back to `S3_BUCKET`. */
+        /** Physical R2/S3 bucket scoped to the agent. Falls back to `STACKBONE_S3_BUCKET`. */
         bucket?: string;
+        /** AWS region. Falls back to `STACKBONE_S3_REGION`, defaults to `'auto'` (R2/MinIO). */
+        region?: string;
     };
     otel?: {
         exporterOtlpEndpoint?: string;

package/index.d.ts

@@ -19,10 +19,9 @@ interface ClientConfig {
     agentId?: string;
     /**
      * Postgres connection string consumed by `client.rag` and the platform
-     * observability exporter. Falls back to `DATABASE_URL`. Note: `client.database`
-     * uses `STACKBONE_POSTGRES_URL` instead — the two env vars are intentionally
-     * different so that the SDK's own DB pool stays decoupled from the legacy
-     * `DATABASE_URL` consumers until `feature 30` consolidates them.
+     * observability exporter. Falls back to `STACKBONE_POSTGRES_URL` — the same
+     * env var `client.database` reads, so a single connection string covers
+     * every SDK consumer that talks to the agent's Postgres.
      */
     databaseUrl?: string;
     openrouterKey?: string;
@@ -46,14 +45,16 @@ interface ClientConfig {
      */
     installationId?: string;
     s3?: {
-        /** Falls back to `AWS_ACCESS_KEY_ID`. */
+        /** Falls back to `STACKBONE_S3_ACCESS_KEY`. */
         accessKeyId?: string;
-        /** Falls back to `AWS_SECRET_ACCESS_KEY`. */
+        /** Falls back to `STACKBONE_S3_SECRET_KEY`. */
         secretAccessKey?: string;
-        /** Falls back to `S3_ENDPOINT`. */
+        /** Falls back to `STACKBONE_S3_ENDPOINT`. */
         endpoint?: string;
-        /** Physical R2/S3 bucket scoped to the agent. Falls back to `S3_BUCKET`. */
+        /** Physical R2/S3 bucket scoped to the agent. Falls back to `STACKBONE_S3_BUCKET`. */
         bucket?: string;
+        /** AWS region. Falls back to `STACKBONE_S3_REGION`, defaults to `'auto'` (R2/MinIO). */
+        region?: string;
     };
     otel?: {
         exporterOtlpEndpoint?: string;

package/index.js

@@ -15553,6 +15553,13 @@ external_exports.object({
   nextCursor: external_exports.string().nullable(),
   prevCursor: external_exports.string().nullable()
 });
+external_exports.object({
+  fxtId: external_exports.uuid()
+});
+external_exports.object({
+  input: jsonObject().nullable(),
+  output: jsonObject().nullable()
+});
 
 // ../validators/src/lib/auth/session.ts
 var sessionUserSchema = external_exports.object({
@@ -18113,7 +18120,7 @@ var RunStepsSpanProcessor = class {
     this.intervalMs = options.flushIntervalMs ?? DEFAULT_INTERVAL_MS2;
     this.resolveStepType = options.resolveStepType ?? defaultStepTypeResolver;
     this.newId = options.newId ?? randomUUID;
-    this.connectionString = options.connectionString ?? process.env["DATABASE_URL"];
+    this.connectionString = options.connectionString ?? process.env["STACKBONE_POSTGRES_URL"];
     if (options.sql) {
       this.sql = options.sql;
       this.ownsSql = false;
@@ -18297,7 +18304,7 @@ var ObservabilityModule = class {
     if (!this._processor) {
       const merged = {
         ...options,
-        connectionString: options.connectionString ?? this._resolved.config.databaseUrl ?? this._resolved.env["DATABASE_URL"]
+        connectionString: options.connectionString ?? this._resolved.config.databaseUrl ?? this._resolved.env["STACKBONE_POSTGRES_URL"]
       };
       this._processor = new RunStepsSpanProcessor(merged);
     }
@@ -18356,7 +18363,7 @@ var ObservabilityModule = class {
     if (!sql) {
       return err({
         code: "database_url_missing",
-        message: "Cannot reach the agent Postgres \u2014 set `DATABASE_URL` in the container or pass `databaseUrl` to `createClient({...})`."
+        message: "Cannot reach the agent Postgres \u2014 set `STACKBONE_POSTGRES_URL` in the container or pass `databaseUrl` to `createClient({...})`."
       });
     }
     try {
@@ -18377,7 +18384,7 @@ var ObservabilityModule = class {
   // don't pay the dep cost.
   async resolveSql() {
     if (this._sqlResolved) return this._sql;
-    const connectionString = this._resolved.config.databaseUrl ?? this._resolved.env["DATABASE_URL"];
+    const connectionString = this._resolved.config.databaseUrl ?? this._resolved.env["STACKBONE_POSTGRES_URL"];
     if (!connectionString) {
       this._sqlResolved = true;
       return null;
@@ -19573,11 +19580,12 @@ var StorageModule = class {
     return new StorageBucket(bucket, () => this.settings(), this._gate);
   }
   settings() {
-    const accessKeyId = this._resolved.config.s3?.accessKeyId ?? this._resolved.env["AWS_ACCESS_KEY_ID"];
-    const secretAccessKey = this._resolved.config.s3?.secretAccessKey ?? this._resolved.env["AWS_SECRET_ACCESS_KEY"];
-    const endpoint = this._resolved.config.s3?.endpoint ?? this._resolved.env["S3_ENDPOINT"];
-    const bucket = this._resolved.config.s3?.bucket ?? this._resolved.env["S3_BUCKET"];
+    const accessKeyId = this._resolved.config.s3?.accessKeyId ?? this._resolved.env["STACKBONE_S3_ACCESS_KEY"];
+    const secretAccessKey = this._resolved.config.s3?.secretAccessKey ?? this._resolved.env["STACKBONE_S3_SECRET_KEY"];
+    const endpoint = this._resolved.config.s3?.endpoint ?? this._resolved.env["STACKBONE_S3_ENDPOINT"];
+    const bucket = this._resolved.config.s3?.bucket ?? this._resolved.env["STACKBONE_S3_BUCKET"];
     const agentId = this._resolved.config.agentId ?? this._resolved.env["STACKBONE_AGENT_ID"];
+    const region = this._resolved.config.s3?.region ?? this._resolved.env["STACKBONE_S3_REGION"] ?? "auto";
     if (!accessKeyId || !secretAccessKey || !endpoint) {
       return err({
         code: "s3_credentials_missing",
@@ -19598,7 +19606,7 @@ var StorageModule = class {
     }
     this._s3 ??= new S3Client({
       endpoint,
-      region: "auto",
+      region,
       forcePathStyle: true,
       credentials: {
         accessKeyId,
@@ -19824,8 +19832,8 @@ var StorageBucket = class {
     });
   }
 };
-var S3_CREDENTIALS_MISSING_MESSAGE = "Cannot reach object storage \u2014 set `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, and `S3_ENDPOINT` in the container or pass `s3` to `createClient({...})`.";
-var S3_BUCKET_MISSING_MESSAGE = "No storage bucket configured \u2014 set `S3_BUCKET` in the container or pass `s3.bucket` to `createClient({...})`.";
+var S3_CREDENTIALS_MISSING_MESSAGE = "Cannot reach object storage \u2014 set `STACKBONE_S3_ACCESS_KEY`, `STACKBONE_S3_SECRET_KEY`, and `STACKBONE_S3_ENDPOINT` in the container or pass `s3` to `createClient({...})`.";
+var S3_BUCKET_MISSING_MESSAGE = "No storage bucket configured \u2014 set `STACKBONE_S3_BUCKET` in the container or pass `s3.bucket` to `createClient({...})`.";
 var AGENT_ID_MISSING_MESSAGE = "No agent identity configured \u2014 set `STACKBONE_AGENT_ID` in the container or pass `agentId` to `createClient({...})`.";
 function stripEtag(etag) {
   return etag?.replace(/^"|"$/g, "");