dominus-sdk-nodejs 1.13.1 → 1.14.0

package/README.md

@@ -1,585 +1,61 @@
-# CB Dominus SDK for Node.js
+# Dominus SDK for Node.js
 
-**TypeScript SDK for the Dominus Orchestrator Platform**
+TypeScript SDK for CareBridge Dominus services. Provides a single, async-first client that routes through the Dominus Gateway, handles JWT minting/caching, and exposes service namespaces for secrets, data, files, auth, AI workflows, and more.
 
-A unified, async-first TypeScript SDK providing seamless access to all Dominus backend services including secrets management, database operations, caching, file storage, authentication, schema management, and structured logging.
-
-## Features
-
-- **Namespace-based API** - Intuitive access via `dominus.db`, `dominus.redis`, `dominus.files`, etc.
-- **Async/Await** - Built for modern async TypeScript/JavaScript applications
-- **Automatic JWT Management** - Token minting, caching, and refresh handled transparently
-- **Resilience Built-in** - Circuit breaker, exponential backoff with jitter, retry logic
-- **Cold Start Handling** - Special retry logic for orchestrator cold starts
-- **Typed Errors** - 9 specific error classes for different failure modes
-- **Secure by Default** - Client-side password hashing, audit trail support
-- **Server-Side Only** - Designed for Next.js API routes, Express, and Node.js backends
+## What This Is
+- Server-side SDK for Node.js 18+ (ESM)
+- Default routing through the Dominus Gateway with base64-encoded JSON bodies
+- Namespace API plus root-level shortcuts for common operations
 
 ## Quick Start
 
-```typescript
+```ts
 import { dominus } from 'dominus-sdk-nodejs';
 
-// Set your token (or use DOMINUS_TOKEN environment variable)
-process.env.DOMINUS_TOKEN = "your-psk-token";
-
-// Secrets
-const dbUrl = await dominus.secrets.get("DATABASE_URL");
-
-// Database queries
-const users = await dominus.db.query("users", { filters: { status: "active" } });
-
-// Redis caching
-await dominus.redis.set("session:123", { user: "john" }, { ttl: 3600 });
-
-// File storage
-const result = await dominus.files.upload(buffer, "report.pdf", { category: "reports" });
-
-// Structured logging
-await dominus.logs.info("User logged in", { user_id: "123" });
-```
-
-## Installation
+process.env.DOMINUS_TOKEN = 'your-psk-token';
 
-```bash
-npm install dominus-sdk-nodejs
+const users = await dominus.db.query('users', { filters: { status: 'active' } });
+await dominus.redis.set('session:123', { user: 'john' }, { ttl: 3600 });
+const file = await dominus.files.upload(buffer, 'report.pdf', { category: 'reports' });
 ```
 
-Or add directly from GitHub:
-
-```bash
-npm install github:carebridgesystems/cb-dominus-sdk-nodejs
-```
-
-## Requirements
-
-- Node.js 18+ (uses native fetch)
-- TypeScript 5.0+ (optional, but recommended)
+## Architecture (SDK View)
+- DOMINUS_TOKEN (PSK) -> Gateway `/jwt/mint` -> JWT cached in `dominusCache`
+- All JSON requests/responses are base64-encoded
+- GET requests send no body; all parameters must be in path or POST body
+- SDK defaults to gateway routing (`/api/*` -> `/svc/*`)
 
 ## Namespaces
-
-| Namespace | Service | Purpose |
-|-----------|---------|---------|
-| `dominus.secrets` | Warden | Secrets management |
-| `dominus.db` | Scribe | Database CRUD operations |
-| `dominus.secure` | Scribe | Secure table access with audit logging |
-| `dominus.redis` | Whisperer | Redis caching & distributed locks |
-| `dominus.files` | Archivist | Object storage (Backblaze B2) |
-| `dominus.auth` | Guardian | Users, roles, scopes, tenants, pages, navigation |
-| `dominus.ddl` | Smith | Schema DDL & migrations |
-| `dominus.logs` | Herald | Structured logging (BetterStack) |
-| `dominus.portal` | Portal | User auth, sessions, profiles, navigation |
-| `dominus.courier` | Courier | Email delivery (Postmark) |
-| `dominus.open` | Scribe | Direct database access |
-| `dominus.health` | Health | Service health checks |
-
-## Usage Examples
-
-### Secrets Management
-
-```typescript
-// Get a secret
-const value = await dominus.secrets.get("API_KEY");
-
-// Create or update
-await dominus.secrets.upsert("API_KEY", "new-value", "Updated API key");
-
-// List secrets with prefix
-const secrets = await dominus.secrets.list("DB_");
-
-// Delete
-await dominus.secrets.delete("OLD_KEY");
-
-// Root-level shortcuts
-const dbUrl = await dominus.get("DATABASE_URL");
-await dominus.upsert("KEY", "value");
-```
-
-### Database Operations
-
-```typescript
-// List tables
-const tables = await dominus.db.tables();
-const tenantTables = await dominus.db.tables("tenant_acme");
-
-// Query with filters and pagination
-const users = await dominus.db.query("users", {
-  filters: { status: "active", role: ["admin", "manager"] },
-  sortBy: "created_at",
-  sortOrder: "DESC",
-  limit: 50,
-  offset: 0
-});
-
-// Insert
-const user = await dominus.db.insert("users", {
-  email: "john@example.com",
-  name: "John Doe"
-});
-
-// Update
-await dominus.db.update("users", { status: "inactive" }, { id: userId });
-
-// Delete
-await dominus.db.delete("users", { id: userId });
-
-// Bulk insert
-await dominus.db.bulkInsert("events", [
-  { type: "login", user_id: "123" },
-  { type: "login", user_id: "456" }
-]);
-
-// Secure table access (requires audit reason)
-const patients = await dominus.db.query("patients", {
-  schema: "tenant_acme",
-  reason: "Reviewing records for appointment #123",
-  actor: "dr.smith"
-});
-```
-
-### Redis Caching
-
-```typescript
-// Key-value operations
-await dominus.redis.set("user:123", { name: "John" }, { ttl: 3600 });
-const value = await dominus.redis.get("user:123");
-
-// Distributed locks
-const acquired = await dominus.redis.setnx("lock:job", "worker-1", { ttl: 60 });
-if (acquired) {
-  try {
-    // Do exclusive work
-  } finally {
-    await dominus.redis.delete("lock:job");
-  }
-}
-
-// Counters
-await dominus.redis.incr("page:views", 1);
-
-// Hash operations
-await dominus.redis.hset("user:123", "email", "john@example.com", { ttl: 3600 });
-const email = await dominus.redis.hget("user:123", "email");
-const allFields = await dominus.redis.hgetall("user:123");
-```
-
-### File Storage
-
-```typescript
-import { readFileSync } from 'fs';
-
-// Upload file
-const data = readFileSync("report.pdf");
-const result = await dominus.files.upload(data, "report.pdf", {
-  category: "reports",
-  contentType: "application/pdf"
-});
-
-// Get download URL
-const download = await dominus.files.download({ id: result.id });
-console.log(download.download_url);
-
-// Fetch file from URL and store
-const fetched = await dominus.files.fetch("https://example.com/doc.pdf", {
-  filename: "external-doc.pdf",
-  category: "imports"
-});
-
-// List files
-const files = await dominus.files.list({ category: "reports", prefix: "2025/" });
-
-// Delete file
-await dominus.files.delete({ id: result.id });
-```
-
-### Structured Logging
-
-```typescript
-// Simple logging (auto-captures file and function)
-await dominus.logs.info("User logged in", { user_id: "123" });
-await dominus.logs.error("Payment failed", { order_id: "456" });
-
-// All log levels
-await dominus.logs.debug("Debug message", { data: "..." });
-await dominus.logs.notice("Important notice", {});
-await dominus.logs.warn("Warning message", {});
-await dominus.logs.critical("Critical error", {});
-
-// With category
-await dominus.logs.info("Cache hit", { key: "user:123" }, "cache");
-
-// With exception
-try {
-  riskyOperation();
-} catch (error) {
-  await dominus.logs.error("Operation failed", {}, { exception: error as Error });
-}
-
-// Batch logging
-await dominus.logs.batch([
-  { level: "info", message: "Step 1 complete", data: {} },
-  { level: "info", message: "Step 2 complete", data: {} }
-]);
-
-// Query logs
-const errors = await dominus.logs.query({ level: "error", limit: 100 });
-```
-
-### Authentication & Authorization (Guardian)
-
-```typescript
-// User management
-const users = await dominus.auth.listUsers();
-const user = await dominus.auth.getUser("user-uuid");
-
-const newUser = await dominus.auth.addUser({
-  username: "john",
-  password: "secure-password",
-  email: "john@example.com"
-});
-
-await dominus.auth.updateUser("user-uuid", { status: "active" });
-await dominus.auth.deleteUser("user-uuid");
-
-// Role management
-const roles = await dominus.auth.listRoles();
-const role = await dominus.auth.addRole({
-  name: "Editor",
-  scopeSlugs: ["read", "write", "publish"]
-});
-
-// Scope management
-const scopes = await dominus.auth.listScopes();
-await dominus.auth.addScope({ name: "publish", slug: "publish" });
-
-// Tenant management
-const tenants = await dominus.auth.listTenants();
-const categories = await dominus.auth.listTenantCategories();
-
-// Page and navigation
-const pages = await dominus.auth.listPages();
-const navItems = await dominus.auth.listNavigation();
-
-// Secure tables registry
-const secureTables = await dominus.auth.listSecureTables();
-await dominus.auth.addSecureTable("patients", "tenant_acme");
-```
-
-### Schema Management (DDL)
-
-```typescript
-// Create table
-await dominus.ddl.createTable("orders", [
-  { name: "id", type: "UUID", constraints: ["PRIMARY KEY"] },
-  { name: "user_id", type: "UUID", constraints: ["NOT NULL"] },
-  { name: "total", type: "DECIMAL(10,2)" },
-  { name: "created_at", type: "TIMESTAMPTZ", default: "NOW()" }
-]);
-
-// Add column
-await dominus.ddl.addColumn("orders", {
-  name: "status",
-  type: "VARCHAR(50)",
-  default: "'pending'"
-});
-
-// Alter column
-await dominus.ddl.alterColumn("orders", "status", { type: "VARCHAR(100)" });
-
-// Create index
-await dominus.ddl.createIndex("orders", "idx_orders_user", ["user_id"]);
-
-// Migrations
-const migrations = await dominus.ddl.listMigrations();
-await dominus.ddl.applyMigration("20250101_add_orders");
-
-// Provision tenant schema from category template
-await dominus.ddl.provisionTenantFromCategory("customer_acme", "healthcare");
-```
-
-### User Authentication (Portal)
-
-```typescript
-// User login (tenant_id is optional)
-const session = await dominus.portal.login(
-  "john@example.com",
-  "secret123",
-  "tenant-uuid"  // optional
-);
-
-// Client login with PSK (for service-to-service)
-const clientSession = await dominus.portal.loginClient("psk-token");
-
-// Get current user
-const me = await dominus.portal.me();
-
-// Get navigation (access-filtered for current user)
-const nav = await dominus.portal.getNavigation();
-
-// Check page access
-const hasAccess = await dominus.portal.checkPageAccess("/dashboard/admin/users");
-
-// Switch tenant
-await dominus.portal.switchTenant("other-tenant-uuid");
-
-// Profile & preferences
-const profile = await dominus.portal.getProfile();
-await dominus.portal.updateProfile({ displayName: "John Doe" });
-
-const prefs = await dominus.portal.getPreferences();
-await dominus.portal.updatePreferences({
-  theme: "dark",
-  timezone: "America/New_York"
-});
-
-// Password management
-await dominus.portal.changePassword("old-password", "new-password");
-await dominus.portal.requestPasswordReset("john@example.com");
-await dominus.portal.confirmPasswordReset("reset-token", "new-password");
-
-// Session management
-const sessions = await dominus.portal.listSessions();
-await dominus.portal.revokeSession("session-id");
-await dominus.portal.revokeAllSessions();
-
-// Registration & email verification
-await dominus.portal.register("newuser", "new@example.com", "password", "tenant-id");
-await dominus.portal.verifyEmail("verification-token");
-await dominus.portal.resendVerification("new@example.com");
-
-// Logout
-await dominus.portal.logout();
-```
-
-### Email Delivery (Courier)
-
-```typescript
-// Send email via Postmark template
-const result = await dominus.courier.send(
-  "welcome",
-  "user@example.com",
-  "noreply@myapp.com",
-  { name: "John", product_name: "My App" }
-);
-
-// Convenience methods
-await dominus.courier.sendWelcome(
-  "user@example.com",
-  "noreply@myapp.com",
-  { name: "John", actionUrl: "https://myapp.com/start", productName: "My App" }
-);
-
-await dominus.courier.sendPasswordReset(
-  "user@example.com",
-  "noreply@myapp.com",
-  { name: "John", resetUrl: "https://myapp.com/reset?token=abc", productName: "My App" }
-);
-
-await dominus.courier.sendEmailVerification(
-  "user@example.com",
-  "noreply@myapp.com",
-  { name: "John", verifyUrl: "https://myapp.com/verify?token=xyz", productName: "My App" }
-);
-
-await dominus.courier.sendInvitation(
-  "invited@example.com",
-  "noreply@myapp.com",
-  {
-    name: "Invited User",
-    inviteUrl: "https://myapp.com/invite?token=abc",
-    inviterName: "John",
-    productName: "My App"
-  }
-);
-```
-
-### Health Checks
-
-```typescript
-// Basic health check
-const status = await dominus.health.check();
-
-// Ping (lightweight)
-await dominus.health.ping();
-
-// Warmup (for cold start tolerance)
-await dominus.health.warmup();
-```
-
-## Error Handling
-
-```typescript
-import {
-  dominus,
-  DominusError,
-  AuthenticationError,
-  AuthorizationError,
-  NotFoundError,
-  ValidationError,
-  ConflictError,
-  ServiceError,
-  SecureTableError,
-  ConnectionError,
-  TimeoutError,
-} from 'dominus-sdk-nodejs';
-
-try {
-  const user = await dominus.auth.getUser("invalid-id");
-} catch (error) {
-  if (error instanceof NotFoundError) {
-    console.log(`User not found: ${error.message}`);
-  } else if (error instanceof SecureTableError) {
-    console.log("Secure table requires 'reason' and 'actor' parameters");
-  } else if (error instanceof AuthenticationError) {
-    console.log("Invalid or expired token");
-  } else if (error instanceof AuthorizationError) {
-    console.log("Insufficient permissions");
-  } else if (error instanceof ValidationError) {
-    console.log(`Invalid request: ${error.message}`);
-  } else if (error instanceof TimeoutError) {
-    console.log("Request timed out");
-  } else if (error instanceof DominusError) {
-    console.log(`Error ${error.statusCode}: ${error.message}`);
-    if (error.details) {
-      console.log(`Details: ${JSON.stringify(error.details)}`);
-    }
-  }
-}
-```
-
-### Error Types
-
-| Error | Status | Description |
-|-------|--------|-------------|
-| `AuthenticationError` | 401 | Invalid or missing token |
-| `AuthorizationError` | 403 | Insufficient permissions |
-| `NotFoundError` | 404 | Resource not found |
-| `ValidationError` | 400 | Invalid request data |
-| `ConflictError` | 409 | Duplicate or version conflict |
-| `ServiceError` | 5xx | Backend service error |
-| `SecureTableError` | 403 | Missing reason for secure table |
-| `ConnectionError` | - | Network connection failed |
-| `TimeoutError` | 504 | Request timed out |
+- `dominus.secrets` (Warden) secrets CRUD
+- `dominus.db` / `dominus.secure` (Scribe) database CRUD + audit-logged tables
+- `dominus.redis` (Whisperer) cache, locks, counters
+- `dominus.files` (Archivist) object storage
+- `dominus.auth` (Guardian) users/roles/scopes/tenants/pages
+- `dominus.ddl` (Smith) schema DDL and migrations
+- `dominus.logs` (Herald) structured logs
+- `dominus.portal` (Portal) user sessions/profile
+- `dominus.courier` (Courier) email
+- `dominus.open` (Scribe Open) direct DB access
+- `dominus.health` health checks
+- `dominus.stt` (Oracle) streaming speech-to-text (WebSocket + VAD)
+- `dominus.admin` admin reseed/reset operations
+- `dominus.ai` agent-runtime: LLM, RAG, artifacts, results, orchestration
+- `dominus.workflow` workflow-manager CRUD and execution
 
 ## Configuration
+Required:
+- `DOMINUS_TOKEN` (PSK)
 
-### Environment Variables
-
-```bash
-# Required: PSK token for authentication
-export DOMINUS_TOKEN="your-psk-token"
-```
-
-### Resilience Configuration
-
-The SDK includes built-in resilience features:
-
-| Feature | Configuration |
-|---------|---------------|
-| Request Timeout | 30 seconds |
-| Max Retries | 3 with exponential backoff |
-| Circuit Breaker | Opens after 5 failures, resets after 30s |
-| JWT Cache TTL | Refreshes when <60 seconds remain |
-| JWT Mint Retries | 3 with backoff (handles cold starts) |
-| Backoff Delays | Base 1s, max 15s with jitter |
-
-## Architecture
-
-```
-┌─────────────────┐
-│  Your App       │
-│  (Next.js API)  │
-└────────┬────────┘
-         │ await dominus.db.query(...)
-         ▼
-┌─────────────────┐
-│  Dominus SDK    │  ← JWT caching, circuit breaker, retries
-│  (this package) │
-└────────┬────────┘
-         │ HTTPS (base64-encoded JSON)
-         ▼
-┌─────────────────────────────────┐
-│  Dominus Orchestrator           │
-│  (Cloud Run FastAPI backend)    │
-│                                 │
-│  ┌─────────┬─────────┬────────┐ │
-│  │ Warden  │Guardian │Archivist│ │
-│  │ Scribe  │ Smith   │Whisperer│ │
-│  │ Herald  │ Portal  │ Courier │ │
-│  └─────────┴─────────┴────────┘ │
-└─────────────────────────────────┘
-```
-
-## Next.js Integration
+Optional:
+- `DOMINUS_GATEWAY_URL` (defaults to production gateway)
+- `DOMINUS_BASE_URL` (override base URL; defaults to gateway)
+- `DOMINUS_DEBUG=true` (extra logs)
+- `DOMINUS_HTTP_PROXY` / `DOMINUS_HTTPS_PROXY` (proxy hints only)
 
-```typescript
-// app/api/users/route.ts
-import { dominus, NotFoundError } from 'dominus-sdk-nodejs';
-import { NextRequest, NextResponse } from 'next/server';
-
-export async function GET(request: NextRequest) {
-  try {
-    const users = await dominus.db.query("users", {
-      filters: { status: "active" },
-      limit: 50
-    });
-    return NextResponse.json(users);
-  } catch (error) {
-    if (error instanceof NotFoundError) {
-      return NextResponse.json({ error: "Not found" }, { status: 404 });
-    }
-    return NextResponse.json({ error: "Failed to fetch users" }, { status: 500 });
-  }
-}
-```
-
-## Crypto Helpers
-
-The SDK exports utility functions for password and token handling:
-
-```typescript
-import {
-  hashPassword,
-  verifyPasswordLocal,
-  hashPsk,
-  verifyPskLocal,
-  generatePskLocal,
-  hashToken,
-  generateToken
-} from 'dominus-sdk-nodejs';
-
-// Password hashing (bcrypt)
-const hash = await hashPassword("user-password");
-const isValid = await verifyPasswordLocal("user-password", hash);
-
-// PSK generation and verification
-const psk = generatePskLocal();
-const pskHash = await hashPsk(psk);
-const pskValid = await verifyPskLocal(psk, pskHash);
-
-// Token generation
-const token = generateToken(32);  // 32-byte random token
-const tokenHash = hashToken(token);  // SHA-256 hash
-```
-
-## Dependencies
-
-- `bcryptjs` - Password hashing
-
-## Version
-
-**v1.2.2** - Latest release with navigation routes fix and page scope methods
-
-### Changelog
-
-- **v1.2.2** - Fix `checkPageAccess` to send correct parameter
-- **v1.2.0** - Add navigation routes and page scope methods
-- **v1.1.6** - Add user token support for user-authenticated requests
-- **v1.1.5** - Make `tenant_id` optional in login methods
-- **v1.1.3** - Add retry with backoff for JWT mint (cold start handling)
-- **v1.1.0** - Fix SDK routes and improve error messaging
-- **v1.0.0** - Initial release with full namespace API
+## Documentation
+- `docs/architecture.md`
+- `docs/namespaces.md`
+- `docs/development.md`
 
 ## License
-
 Proprietary - CareBridge Systems

package/dist/namespaces/files.d.ts

@@ -1,5 +1,5 @@
 /**
- * Files Namespace - Archivist object storage operations.
+ * Files Namespace - B2 Worker object storage operations.
  *
  * Provides file upload, download, and management via B2 object storage.
  */
@@ -52,7 +52,12 @@ export interface BrowseFileInfo {
 export interface StorageStats {
     total_objects: number;
     total_size_bytes: number;
-    by_category: Record<string, CategoryStats>;
+    categories: Array<{
+        name: string;
+        object_count: number;
+        total_size_bytes: number;
+    }>;
+    total_categories: number;
 }
 export interface CategoryStats {
     count: number;
@@ -71,27 +76,22 @@ export interface CreateFolderResult {
     exists?: boolean;
     path: string;
     placeholder_id?: string;
+    folder_id?: string;
     message?: string;
 }
 export interface DeleteFolderResult {
     deleted: boolean;
     path: string;
-    deleted_count?: number;
-    retained_count?: number;
-    has_compliance?: boolean;
-    compliance_count?: number;
+    objects_deleted?: number;
+    b2_errors?: number;
     message?: string;
     errors?: string[];
 }
 export interface FactoryResetResult {
     reset: boolean;
-    deleted_count: number;
-    retained_count: number;
-    by_category: Record<string, {
-        deleted: number;
-        retained: number;
-    }>;
-    initialized_folders?: string[];
+    db_objects_deleted: number;
+    b2_objects_deleted: number;
+    b2_errors: number;
     message?: string;
     errors?: string[];
 }
@@ -246,7 +246,6 @@ export declare class FilesNamespace {
      * Factory reset - delete ALL objects in the project/environment.
      *
      * WARNING: This will permanently delete all files in storage.
-     * Compliance objects will be moved to retention unless force=true.
      *
      * @param options - Reset options
      * @param options.force - If true, hard delete even compliance objects

package/dist/namespaces/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/namespaces/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/namespaces/files.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/files.js

@@ -1,5 +1,5 @@
 /**
- * Files Namespace - Archivist object storage operations.
+ * Files Namespace - B2 Worker object storage operations.
  *
  * Provides file upload, download, and management via B2 object storage.
  */
@@ -16,24 +16,16 @@ export class FilesNamespace {
      * @param options - Upload options
      */
     async upload(data, filename, options = {}) {
-        const { contentType, category = 'general', path, tags, compliance = false, actor, retentionDays = 90, } = options;
+        const { contentType, category = 'general', path, } = options;
         const fileB64 = data.toString('base64');
         const body = {
-            file_content: fileB64,
-            filename,
+            content_b64: fileB64,
+            path: path || filename,
             category,
-            logical_path: path || filename,
+            filename,
         };
         if (contentType)
             body.content_type = contentType;
-        if (tags)
-            body.tags = tags;
-        if (compliance) {
-            body.is_compliance = true;
-            body.retention_days = retentionDays;
-            if (actor)
-                body.owner_user_id = actor;
-        }
         return this.client.request({
             endpoint: '/api/archivist/upload',
             body,
@@ -45,16 +37,14 @@ export class FilesNamespace {
      * @param options - File identifier and options
      */
     async download(options) {
-        const { id, category, path, actor, expiresSeconds = 3600 } = options;
+        const { id, category, path, expiresSeconds = 3600 } = options;
         const body = { expires_seconds: expiresSeconds };
         if (id)
-            body.id = id;
+            body.object_id = id;
         if (category)
             body.category = category;
         if (path)
-            body.logical_path = path;
-        if (actor)
-            body.actor_user_id = actor;
+            body.path = path;
         return this.client.request({
             endpoint: '/api/archivist/download',
             body,
@@ -66,16 +56,14 @@ export class FilesNamespace {
      * @param options - File identifier
      */
     async fetch(options) {
-        const { id, category, path, actor } = options;
-        const body = {};
+        const { id, category, path } = options;
+        const body = { return_data: true };
         if (id)
-            body.id = id;
+            body.object_id = id;
         if (category)
             body.category = category;
         if (path)
-            body.logical_path = path;
-        if (actor)
-            body.actor_user_id = actor;
+            body.path = path;
         return this.client.request({
             endpoint: '/api/archivist/fetch',
             body,
@@ -106,16 +94,14 @@ export class FilesNamespace {
      * @param options - File identifier
      */
     async delete(options) {
-        const { id, category, path, actor } = options;
+        const { id, category, path } = options;
         const body = {};
         if (id)
-            body.id = id;
+            body.object_id = id;
         if (category)
             body.category = category;
         if (path)
-            body.logical_path = path;
-        if (actor)
-            body.actor_user_id = actor;
+            body.path = path;
         return this.client.request({
             endpoint: '/api/archivist/delete',
             body,
@@ -129,11 +115,11 @@ export class FilesNamespace {
      */
     async move(fileId, options) {
         const { newCategory, newPath } = options;
-        const body = { id: fileId };
+        const body = { object_id: fileId };
         if (newCategory)
             body.new_category = newCategory;
         if (newPath)
-            body.new_logical_path = newPath;
+            body.new_path = newPath;
         return this.client.request({
             endpoint: '/api/archivist/move',
             body,
@@ -147,7 +133,7 @@ export class FilesNamespace {
      */
     async updateMeta(fileId, options) {
         const { tags, description } = options;
-        const body = { id: fileId };
+        const body = { object_id: fileId };
         if (tags !== undefined)
             body.tags = tags;
         if (description !== undefined)
@@ -183,7 +169,7 @@ export class FilesNamespace {
     async getStorageStats() {
         return this.client.request({
             endpoint: '/api/archivist/stats',
-            method: 'GET',
+            body: {},
         });
     }
     /**
@@ -192,7 +178,7 @@ export class FilesNamespace {
     async listCategories() {
         return this.client.request({
             endpoint: '/api/archivist/categories',
-            method: 'GET',
+            body: {},
         });
     }
     /**
@@ -211,10 +197,8 @@ export class FilesNamespace {
      * @param options.activeTenant - User's active tenant slug
      */
     async listViews(options) {
-        // Use POST with base64-encoded body (consistent with all other orchestrator endpoints)
         return this.client.request({
             endpoint: '/api/archivist/views',
-            method: 'POST',
             body: {
                 user_scopes: options?.userScopes || [],
                 active_tenant: options?.activeTenant || null,
@@ -228,8 +212,8 @@ export class FilesNamespace {
      */
     async listCategoriesInView(view) {
         return this.client.request({
-            endpoint: `/api/archivist/views/${encodeURIComponent(view)}/categories`,
-            method: 'GET',
+            endpoint: '/api/archivist/view-categories',
+            body: { view },
         });
     }
     /**
@@ -266,7 +250,6 @@ export class FilesNamespace {
      * Factory reset - delete ALL objects in the project/environment.
      *
      * WARNING: This will permanently delete all files in storage.
-     * Compliance objects will be moved to retention unless force=true.
      *
      * @param options - Reset options
      * @param options.force - If true, hard delete even compliance objects

package/dist/namespaces/files.js.map

@@ -1 +1 @@
-{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/namespaces/files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/namespaces/files.ts"],"names":[],"mappings":"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"}

package/docs/architecture.md

@@ -0,0 +1,34 @@
+# Architecture
+
+## Request Flow
+1. SDK reads `DOMINUS_TOKEN` (PSK) from env or constructor.
+2. Gateway JWT minted via `POST /jwt/mint` (base64 body).
+3. JWT is cached in `dominusCache` (encrypted with PSK) and refreshed before expiry.
+4. All JSON requests are base64-encoded; responses are decoded.
+5. SDK routes `/api/*` to `/svc/*` when using the gateway.
+
+## Gateway Routing
+- Default base URL is the gateway (`DOMINUS_GATEWAY_URL`).
+- `DOMINUS_BASE_URL` can override the base (defaults to gateway).
+- `useGateway: true` forces gateway base URL for a request.
+
+## Resilience
+- Retries: 3 attempts with exponential backoff + jitter.
+- Circuit breaker: opens after 5 failures, 30s recovery.
+- JWT mint retries on gateway cold starts (401/5xx).
+- Default request timeout: 30s (max 5 min when overridden).
+
+## Local JWT Verification
+- `verifyJwtLocally()` fetches JWKS from gateway `/jwt/jwks` and verifies signatures.
+- JWKS cached for 1 hour; stale cache used if refresh fails.
+
+## Streaming and Binary
+- SSE streaming via `streamRequest()` (Agent/LLM workflows).
+- Binary uploads/downloads via `binaryUpload()` / `binaryDownload()` for STT/TTS and RAG ingest.
+
+## Environment Variables
+- `DOMINUS_TOKEN` (required)
+- `DOMINUS_GATEWAY_URL` (optional)
+- `DOMINUS_BASE_URL` (optional)
+- `DOMINUS_DEBUG=true` (optional)
+- `DOMINUS_HTTP_PROXY` / `DOMINUS_HTTPS_PROXY` (optional, informational)

package/docs/development.md

@@ -0,0 +1,30 @@
+# Development
+
+## Requirements
+- Node.js 18+ (native fetch)
+- TypeScript 5.6+
+
+## Commands
+```bash
+npm install
+npm run lint   # type-check
+npm run test   # node --test
+npm run build  # tsc
+```
+
+## Publishing
+Publishing is handled by GitHub Actions on branch push:
+- `development` -> publishes as `dominus-sdk-nodejs-dev`
+- `staging` -> publishes as `dominus-sdk-nodejs-staging`
+- `production` -> publishes as `dominus-sdk-nodejs`
+
+Before publishing:
+1. Bump `package.json` version
+2. Ensure `dist/` builds cleanly
+3. Update docs under `docs/`
+
+## Adding APIs
+- Add methods in the relevant `src/namespaces/*.ts` file
+- Export types and helpers from `src/index.ts`
+- Use `client.request()` for JSON, `streamRequest()` for SSE, `binaryUpload/Download()` for bytes
+- Always set `method: 'GET'` for GET endpoints

package/docs/namespaces.md

@@ -0,0 +1,35 @@
+# Namespaces
+
+## Core Services
+- `secrets` (Warden): secrets CRUD
+- `db` (Scribe): database CRUD, filters, pagination
+- `secure` (Scribe): secure-table access with audit `reason` + `actor`
+- `redis` (Whisperer): cache, locks, counters, hashes (TTL required)
+- `files` (Archivist): upload/download/list/move/update metadata
+- `auth` (Guardian): users, roles, scopes, tenants, pages/navigation
+- `ddl` (Smith): schema DDL, migrations, provisioning
+- `logs` (Herald): structured logs + queries
+- `portal` (Portal): user login, sessions, profile, navigation
+- `courier` (Courier): email delivery
+- `open` (Scribe Open): direct SQL execution / DSN
+- `health`: service health/ping/warmup
+
+## AI + Orchestration
+- `ai.runAgent`, `ai.streamAgent`, `ai.runAgentAsync`
+- `ai.complete`, `ai.completeStream` (multi-provider LLM completions)
+- `ai.rag` (list/ensure/stats/upsert/search/ingest)
+- `ai.artifacts` (create/fetch/list/delete)
+- `ai.results` (async result polling)
+- `ai.workflow` (workflow orchestration in agent-runtime)
+- `ai.tools` (tool registry, default-deny)
+- `ai.stt` / `ai.tts` (speech services)
+- `ai.setup` (pre-flight session setup)
+
+## Workflow Manager
+- `workflow` namespace manages workflow CRUD, categories, templates, and execution
+
+## Streaming STT
+- `stt` (Oracle) creates streaming transcription sessions with VAD
+
+## Admin
+- `admin.reseedAdminCategory()` and `admin.resetAdminCategory()` (destructive)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dominus-sdk-nodejs",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "description": "Node.js SDK for the Dominus Orchestrator Platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",