@juli-os/ledger 0.1.7 → 0.3.0

package/dist/contracts/entities.d.ts

@@ -16,6 +16,7 @@ export interface Workflow {
     readonly project: string;
     readonly path: string;
     readonly threadId: string | null;
+    readonly tenant: string;
     readonly meta: JsonRecord;
     readonly createdAt: string;
     readonly updatedAt: string;

package/dist/index.d.ts

@@ -4,5 +4,3 @@ export { TERMINAL_WORKFLOW_STATUSES, STEP_KINDS, AGENT_STEP_KINDS, INSTRUCTABLE_
 export { createUsageStore, type UsageRecord, type UsageStats, type TimelinePoint, type UsageStore, } from './platform/ledger/usage.ts';
 export { findPrice, priceUsage, type TierWhen, type PriceTier, type ModelPrice, PRICING_SOURCE, PRICING_RETRIEVED_AT, BIGMODEL_PRICES, type UsageRow, type CostBreakdown, type ModelUsageCost, type UsageCost, } from './platform/ledger/pricing.ts';
 export { emptyCaseFile, parseCaseFile, serializeCaseFile, withOriginal, appendSection, appendExecution, appendDecision, appendReference, originalEmail, type CaseDecision, type ArtifactRef, type CaseFileDoc, } from './platform/ledger/casefile.ts';
-export { rfc3339, systemClock, randomIds, type Clock, type IdGen } from './platform/shared/clock.ts';
-export { asRecord, safeParse, type JsonRecord, type JsonValue } from './platform/shared/json.ts';

package/dist/index.js

@@ -241,6 +241,7 @@ var rowToWorkflow = (r) => ({
   project: str(r["project"]),
   path: str(r["path"]),
   threadId: r["thread_id"] === null ? null : str(r["thread_id"]),
+  tenant: str(r["tenant"]) || "internal",
   meta: asRecord(safeParse(str(r["meta"]))),
   createdAt: str(r["created_at"]),
   updatedAt: str(r["updated_at"])
@@ -307,7 +308,11 @@ var createLedgerStore = (dbPath, deps = {}) => {
   if (!wfCols.includes("thread_id")) {
     db.exec("ALTER TABLE workflows ADD COLUMN thread_id TEXT");
   }
+  if (!wfCols.includes("tenant")) {
+    db.exec("ALTER TABLE workflows ADD COLUMN tenant TEXT NOT NULL DEFAULT 'internal'");
+  }
   db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_thread ON workflows(thread_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_tenant ON workflows(tenant, created_at)");
   const stepCols = db.prepare("PRAGMA table_info(workflow_steps)").all().map((c) => c.name);
   if (!stepCols.includes("started_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN started_at TEXT");
   if (!stepCols.includes("completed_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN completed_at TEXT");
@@ -349,19 +354,36 @@ var createLedgerStore = (dbPath, deps = {}) => {
       const id = ids.newId("wf");
       const ts = now();
       db.prepare(
-        `INSERT INTO workflows (id, parent_id, kind, title, status, owner, meta, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-      ).run(id, w.parentId ?? null, w.kind, w.title, w.status ?? "running", w.owner ?? null, JSON.stringify(w.meta ?? {}), ts, ts);
+        `INSERT INTO workflows (id, parent_id, kind, title, status, owner, tenant, meta, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+      ).run(id, w.parentId ?? null, w.kind, w.title, w.status ?? "running", w.owner ?? null, w.tenant || "internal", JSON.stringify(w.meta ?? {}), ts, ts);
       return getWorkflowById(id);
     },
     getWorkflow(id) {
       return getWorkflowById(id);
     },
-    listWorkflows(limit = 100, status) {
+    listWorkflows(limit = 100, status, tenant) {
+      const where = [];
+      const params = [];
       if (status !== void 0 && status !== "") {
-        return db.prepare("SELECT * FROM workflows WHERE status=? ORDER BY created_at DESC, rowid DESC LIMIT ?").all(status, limit).map(rowToWorkflow);
+        where.push("status=?");
+        params.push(status);
+      }
+      if (tenant !== void 0 && tenant !== "") {
+        where.push("tenant=?");
+        params.push(tenant);
       }
-      return db.prepare("SELECT * FROM workflows ORDER BY created_at DESC, rowid DESC LIMIT ?").all(limit).map(rowToWorkflow);
+      const sql = where.length > 0 ? `SELECT * FROM workflows WHERE ${where.join(" AND ")} ORDER BY created_at DESC, rowid DESC LIMIT ?` : "SELECT * FROM workflows ORDER BY created_at DESC, rowid DESC LIMIT ?";
+      return db.prepare(sql).all(...params, limit).map(rowToWorkflow);
+    },
+    setWorkflowTenant(id, tenant) {
+      const next = tenant === "" ? "internal" : tenant;
+      const cur = getWorkflowById(id);
+      if (cur === null || cur.tenant === next) return;
+      db.prepare("UPDATE workflows SET tenant=?, updated_at=? WHERE id=?").run(next, now(), id);
+      db.prepare(
+        "INSERT INTO events (entity_type, entity_id, type, payload, ts) VALUES ('workflow', ?, 'tenant_changed', ?, ?)"
+      ).run(id, JSON.stringify({ from: cur.tenant, to: next }), now());
     },
     setWorkflowSession(id, session) {
       db.prepare("UPDATE workflows SET session=?, updated_at=? WHERE id=?").run(session, now(), id);
@@ -523,7 +545,18 @@ var createLedgerStore = (dbPath, deps = {}) => {
       ).run(now(), now(), id);
       return Number(res.changes) === 1;
     },
-    listSteps(status, limit = 100) {
+    listSteps(status, limit = 100, tenant) {
+      if (tenant !== void 0 && tenant !== "") {
+        return db.prepare(
+          `SELECT st.id AS id, st.workflow_id AS workflow_id, st.seq AS seq, st.kind AS kind,
+                  st.title AS title, st.status AS status,
+                  COALESCE(st.input,'') AS input, COALESCE(st.output,'') AS output,
+                  COALESCE(st.summary,'') AS summary, st.updated_at AS updated_at,
+                  st.started_at AS started_at, st.completed_at AS completed_at
+           FROM workflow_steps st JOIN workflows w ON w.id = st.workflow_id
+           WHERE st.status=? AND w.tenant=? ORDER BY st.updated_at DESC LIMIT ?`
+        ).all(status, tenant, limit).map(rowToStep);
+      }
       return db.prepare(
         `SELECT ${STEP_COLS} FROM workflow_steps WHERE status=? ORDER BY updated_at DESC LIMIT ?`
       ).all(status, limit).map(rowToStep);
@@ -1290,7 +1323,6 @@ export {
   appendExecution,
   appendReference,
   appendSection,
-  asRecord,
   createLedgerStore,
   createUsageStore,
   emptyCaseFile,
@@ -1298,10 +1330,6 @@ export {
   originalEmail,
   parseCaseFile,
   priceUsage,
-  randomIds,
-  rfc3339,
-  safeParse,
   serializeCaseFile,
-  systemClock,
   withOriginal
 };

package/dist/juli-ledger.js

@@ -199,6 +199,7 @@ var rowToWorkflow = (r) => ({
   project: str(r["project"]),
   path: str(r["path"]),
   threadId: r["thread_id"] === null ? null : str(r["thread_id"]),
+  tenant: str(r["tenant"]) || "internal",
   meta: asRecord(safeParse(str(r["meta"]))),
   createdAt: str(r["created_at"]),
   updatedAt: str(r["updated_at"])
@@ -265,7 +266,11 @@ var createLedgerStore = (dbPath, deps = {}) => {
   if (!wfCols.includes("thread_id")) {
     db.exec("ALTER TABLE workflows ADD COLUMN thread_id TEXT");
   }
+  if (!wfCols.includes("tenant")) {
+    db.exec("ALTER TABLE workflows ADD COLUMN tenant TEXT NOT NULL DEFAULT 'internal'");
+  }
   db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_thread ON workflows(thread_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_workflows_tenant ON workflows(tenant, created_at)");
   const stepCols = db.prepare("PRAGMA table_info(workflow_steps)").all().map((c) => c.name);
   if (!stepCols.includes("started_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN started_at TEXT");
   if (!stepCols.includes("completed_at")) db.exec("ALTER TABLE workflow_steps ADD COLUMN completed_at TEXT");
@@ -307,19 +312,36 @@ var createLedgerStore = (dbPath, deps = {}) => {
       const id = ids.newId("wf");
       const ts = now();
       db.prepare(
-        `INSERT INTO workflows (id, parent_id, kind, title, status, owner, meta, created_at, updated_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-      ).run(id, w.parentId ?? null, w.kind, w.title, w.status ?? "running", w.owner ?? null, JSON.stringify(w.meta ?? {}), ts, ts);
+        `INSERT INTO workflows (id, parent_id, kind, title, status, owner, tenant, meta, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+      ).run(id, w.parentId ?? null, w.kind, w.title, w.status ?? "running", w.owner ?? null, w.tenant || "internal", JSON.stringify(w.meta ?? {}), ts, ts);
       return getWorkflowById(id);
     },
     getWorkflow(id) {
       return getWorkflowById(id);
     },
-    listWorkflows(limit = 100, status) {
+    listWorkflows(limit = 100, status, tenant) {
+      const where = [];
+      const params = [];
       if (status !== void 0 && status !== "") {
-        return db.prepare("SELECT * FROM workflows WHERE status=? ORDER BY created_at DESC, rowid DESC LIMIT ?").all(status, limit).map(rowToWorkflow);
+        where.push("status=?");
+        params.push(status);
+      }
+      if (tenant !== void 0 && tenant !== "") {
+        where.push("tenant=?");
+        params.push(tenant);
       }
-      return db.prepare("SELECT * FROM workflows ORDER BY created_at DESC, rowid DESC LIMIT ?").all(limit).map(rowToWorkflow);
+      const sql = where.length > 0 ? `SELECT * FROM workflows WHERE ${where.join(" AND ")} ORDER BY created_at DESC, rowid DESC LIMIT ?` : "SELECT * FROM workflows ORDER BY created_at DESC, rowid DESC LIMIT ?";
+      return db.prepare(sql).all(...params, limit).map(rowToWorkflow);
+    },
+    setWorkflowTenant(id, tenant) {
+      const next = tenant === "" ? "internal" : tenant;
+      const cur = getWorkflowById(id);
+      if (cur === null || cur.tenant === next) return;
+      db.prepare("UPDATE workflows SET tenant=?, updated_at=? WHERE id=?").run(next, now(), id);
+      db.prepare(
+        "INSERT INTO events (entity_type, entity_id, type, payload, ts) VALUES ('workflow', ?, 'tenant_changed', ?, ?)"
+      ).run(id, JSON.stringify({ from: cur.tenant, to: next }), now());
     },
     setWorkflowSession(id, session) {
       db.prepare("UPDATE workflows SET session=?, updated_at=? WHERE id=?").run(session, now(), id);
@@ -481,7 +503,18 @@ var createLedgerStore = (dbPath, deps = {}) => {
       ).run(now(), now(), id);
       return Number(res.changes) === 1;
     },
-    listSteps(status, limit = 100) {
+    listSteps(status, limit = 100, tenant) {
+      if (tenant !== void 0 && tenant !== "") {
+        return db.prepare(
+          `SELECT st.id AS id, st.workflow_id AS workflow_id, st.seq AS seq, st.kind AS kind,
+                  st.title AS title, st.status AS status,
+                  COALESCE(st.input,'') AS input, COALESCE(st.output,'') AS output,
+                  COALESCE(st.summary,'') AS summary, st.updated_at AS updated_at,
+                  st.started_at AS started_at, st.completed_at AS completed_at
+           FROM workflow_steps st JOIN workflows w ON w.id = st.workflow_id
+           WHERE st.status=? AND w.tenant=? ORDER BY st.updated_at DESC LIMIT ?`
+        ).all(status, tenant, limit).map(rowToStep);
+      }
       return db.prepare(
         `SELECT ${STEP_COLS} FROM workflow_steps WHERE status=? ORDER BY updated_at DESC LIMIT ?`
       ).all(status, limit).map(rowToStep);

package/dist/platform/ledger/store.d.ts

@@ -12,11 +12,13 @@ export interface LifecycleStore {
         parentId?: string;
         status?: WorkflowStatus;
         owner?: string;
+        tenant?: string;
     }): Workflow;
     getWorkflow(id: string): Workflow | null;
-    listWorkflows(limit?: number, status?: string): readonly Workflow[];
+    listWorkflows(limit?: number, status?: string, tenant?: string): readonly Workflow[];
     setWorkflowStatus(id: string, status: WorkflowStatus): void;
     setWorkflowSession(id: string, session: string): void;
+    setWorkflowTenant(id: string, tenant: string): void;
     updateWorkflowMeta(id: string, patch: JsonRecord): JsonRecord;
     setWorkflowRouting(id: string, session: string, project: string): void;
     assignThread(workflowId: string, threadId: string): void;
@@ -64,7 +66,7 @@ export interface LifecycleStore {
     setStepOutput(id: string, patch: JsonRecord): void;
     appendStepOutputItem(id: string, key: string, entry: JsonValue, cap: number): void;
     claimRunningStep(id: string): boolean;
-    listSteps(status: StepStatus, limit?: number): readonly Step[];
+    listSteps(status: StepStatus, limit?: number, tenant?: string): readonly Step[];
     runningAgentStepForSession(session: string): Step | null;
     sessionHasOpenWork(session: string, excludeWorkflowId?: string): boolean;
     appendEvent(entityType: 'workflow' | 'step' | 'judgment' | 'agent', entityId: string, type: string, payload?: JsonRecord): LedgerEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juli-os/ledger",
-  "version": "0.1.7",
+  "version": "0.3.0",
   "description": "juli-os L1 layer: the ledger of record for agent work — workflows, steps, case files, and token usage in one zero-dependency SQLite layer.",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,11 +27,15 @@
     "build": "tsc -p tsconfig.build.json && esbuild src/index.ts --bundle --platform=node --format=esm --target=node22 --outfile=dist/index.js && esbuild bin/juli-ledger.ts --bundle --platform=node --format=esm --target=node22 --outfile=dist/juli-ledger.js && chmod +x dist/juli-ledger.js && python3 scripts/postbuild.py",
     "test": "node --test \"test/*.test.ts\"",
     "smoke:dist": "node --input-type=module -e \"import('./dist/index.js').then(async m => { const { join } = await import('node:path'); const { tmpdir } = await import('node:os'); const s = m.createLedgerStore(join(tmpdir(), 'peel-dist-' + Date.now() + '.db')); const wf = s.createWorkflow({kind:'case',title:'dist smoke'}); if (!s.getWorkflow(wf.id)) process.exit(1); console.log('DIST SMOKE OK'); })\"",
+    "docs:gen": "node scripts/gen-docs.mjs && typedoc",
+    "docs:build": "npm run docs:gen && mkdocs build --strict",
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "esbuild": "^0.24.0",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.14.1",
     "typescript": "^5.6.0"
   },
   "publishConfig": {