@camstack/addon-ai 0.1.1

package/dist/execute-plan-KbxnOqY1.mjs

@@ -0,0 +1,41 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+//#region src/http/execute-plan.ts
+var execute_plan_exports = /* @__PURE__ */ __exportAll({ createFetchExecutor: () => createFetchExecutor });
+var MAX_RESPONSE_BODY_CHARS = 4 * 1024 * 1024;
+function createFetchExecutor(fetchImpl = fetch) {
+	return async (plan, timeoutMs) => {
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		try {
+			const res = await fetchImpl(plan.url, {
+				method: plan.method ?? "POST",
+				headers: plan.headers,
+				body: plan.body === void 0 ? void 0 : JSON.stringify(plan.body),
+				signal: controller.signal
+			});
+			const bodyText = (await res.text()).slice(0, MAX_RESPONSE_BODY_CHARS);
+			const headers = {};
+			res.headers.forEach((value, key) => {
+				headers[key.toLowerCase()] = value;
+			});
+			return {
+				kind: "response",
+				response: {
+					status: res.status,
+					headers,
+					bodyText
+				}
+			};
+		} catch (err) {
+			if (err instanceof Error && err.name === "AbortError") return { kind: "timeout" };
+			return {
+				kind: "network",
+				message: err instanceof Error ? err.message : String(err)
+			};
+		} finally {
+			clearTimeout(timer);
+		}
+	};
+}
+//#endregion
+export { execute_plan_exports as n, createFetchExecutor as t };

package/dist/execute-plan-gwFcJjeV.js

@@ -0,0 +1,51 @@
+//#region src/http/execute-plan.ts
+var execute_plan_exports = /* @__PURE__ */ require("./addon.js").__exportAll({ createFetchExecutor: () => createFetchExecutor });
+var MAX_RESPONSE_BODY_CHARS = 4 * 1024 * 1024;
+function createFetchExecutor(fetchImpl = fetch) {
+	return async (plan, timeoutMs) => {
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		try {
+			const res = await fetchImpl(plan.url, {
+				method: plan.method ?? "POST",
+				headers: plan.headers,
+				body: plan.body === void 0 ? void 0 : JSON.stringify(plan.body),
+				signal: controller.signal
+			});
+			const bodyText = (await res.text()).slice(0, MAX_RESPONSE_BODY_CHARS);
+			const headers = {};
+			res.headers.forEach((value, key) => {
+				headers[key.toLowerCase()] = value;
+			});
+			return {
+				kind: "response",
+				response: {
+					status: res.status,
+					headers,
+					bodyText
+				}
+			};
+		} catch (err) {
+			if (err instanceof Error && err.name === "AbortError") return { kind: "timeout" };
+			return {
+				kind: "network",
+				message: err instanceof Error ? err.message : String(err)
+			};
+		} finally {
+			clearTimeout(timer);
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "createFetchExecutor", {
+	enumerable: true,
+	get: function() {
+		return createFetchExecutor;
+	}
+});
+Object.defineProperty(exports, "execute_plan_exports", {
+	enumerable: true,
+	get: function() {
+		return execute_plan_exports;
+	}
+});

package/dist/index.js

@@ -0,0 +1,41 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_addon = require("./addon.js");
+const require_execute_plan = require("./execute-plan-gwFcJjeV.js");
+const require_usage_store = require("./usage-store-DK494_zK.js");
+const require_ensure_llama_server = require("./ensure-llama-server-CwEkUUrD.js");
+exports.AI_ADDON_ID = require_addon.AI_ADDON_ID;
+exports.AiAddon = require_addon.AiAddon;
+exports.BUDGETS_COLLECTION = require_usage_store.BUDGETS_COLLECTION;
+exports.DefaultsStore = require_addon.DefaultsStore;
+exports.LLAMA_SERVER_VERSION = require_ensure_llama_server.LLAMA_SERVER_VERSION;
+exports.LLM_MODEL_CATALOG = require_addon.LLM_MODEL_CATALOG;
+exports.LlamaSupervisor = require_addon.LlamaSupervisor;
+exports.PROFILES_COLLECTION = require_addon.PROFILES_COLLECTION;
+exports.ProfileStore = require_addon.ProfileStore;
+exports.REDACTED_MARKER = require_addon.REDACTED_MARKER;
+exports.SEED_PROFILE_ID = require_addon.SEED_PROFILE_ID;
+exports.USAGE_COLLECTION = require_usage_store.USAGE_COLLECTION;
+exports.UsageStore = require_usage_store.UsageStore;
+exports.anthropicAdapter = require_addon.anthropicAdapter;
+exports.assembleAi = require_addon.assembleAi;
+exports.catalogById = require_addon.catalogById;
+exports.createApiSettingsStorePort = require_addon.createApiSettingsStorePort;
+exports.createDefaultModelOps = require_addon.createDefaultModelOps;
+exports.createFetchExecutor = require_execute_plan.createFetchExecutor;
+exports.createLlmProvider = require_addon.createLlmProvider;
+exports.createLlmRuntimeProvider = require_addon.createLlmRuntimeProvider;
+exports.createMemorySettingsStorePort = require_addon.createMemorySettingsStorePort;
+exports.createRuntimeClient = require_addon.createRuntimeClient;
+exports.default = require_addon.AiAddon;
+exports.ensureLlamaServer = require_ensure_llama_server.ensureLlamaServer;
+exports.entryForRef = require_addon.entryForRef;
+exports.googleAdapter = require_addon.googleAdapter;
+exports.llamaServerAsset = require_ensure_llama_server.llamaServerAsset;
+exports.mergeProfileSecrets = require_addon.mergeProfileSecrets;
+exports.openAiAdapter = require_addon.openAiAdapter;
+exports.openAiCompatibleAdapter = require_addon.openAiCompatibleAdapter;
+exports.redactProfileForRead = require_addon.redactProfileForRead;
+exports.resolveProfile = require_addon.resolveProfile;

package/dist/index.mjs

@@ -0,0 +1,5 @@
+import { AiAddon, C as googleAdapter, S as openAiAdapter, T as openAiCompatibleAdapter, _ as redactProfileForRead, a as createLlmRuntimeProvider, b as SEED_PROFILE_ID, c as LLM_MODEL_CATALOG, d as createRuntimeClient, f as AI_ADDON_ID, g as mergeProfileSecrets, h as REDACTED_MARKER, i as assembleAi, l as catalogById, m as resolveProfile, n as createMemorySettingsStorePort, p as createLlmProvider, r as LlamaSupervisor, s as createDefaultModelOps, t as createApiSettingsStorePort, u as entryForRef, v as PROFILES_COLLECTION, w as anthropicAdapter, x as DefaultsStore, y as ProfileStore } from "./addon.mjs";
+import { t as createFetchExecutor } from "./execute-plan-KbxnOqY1.mjs";
+import { n as USAGE_COLLECTION, r as UsageStore, t as BUDGETS_COLLECTION } from "./usage-store-BVa_imkv.mjs";
+import { i as llamaServerAsset, n as ensureLlamaServer, t as LLAMA_SERVER_VERSION } from "./ensure-llama-server-Dmh3cZ41.mjs";
+export { AI_ADDON_ID, AiAddon, AiAddon as default, BUDGETS_COLLECTION, DefaultsStore, LLAMA_SERVER_VERSION, LLM_MODEL_CATALOG, LlamaSupervisor, PROFILES_COLLECTION, ProfileStore, REDACTED_MARKER, SEED_PROFILE_ID, USAGE_COLLECTION, UsageStore, anthropicAdapter, assembleAi, catalogById, createApiSettingsStorePort, createDefaultModelOps, createFetchExecutor, createLlmProvider, createLlmRuntimeProvider, createMemorySettingsStorePort, createRuntimeClient, ensureLlamaServer, entryForRef, googleAdapter, llamaServerAsset, mergeProfileSecrets, openAiAdapter, openAiCompatibleAdapter, redactProfileForRead, resolveProfile };

package/dist/rolldown-runtime-D7D4PA-g.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/usage-store-BVa_imkv.mjs

@@ -0,0 +1,178 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { A as object, D as LlmProfileKindSchema, E as LlmErrorCodeSchema, O as boolean, j as string, k as number } from "./addon.mjs";
+import { randomUUID } from "node:crypto";
+//#region src/usage/usage-store.ts
+/**
+* Usage store over declared settings-store collections (spec §6). The sqlite
+* backend silently drops undeclared fields, so `init()` declares explicit
+* columns for both `ai:usage` and `ai:budgets` (budget enforcement is v2 —
+* schema only). Query-then-filter/group in JS is deliberate: LLM call volume is
+* low and rows are pruned at 90d.
+*/
+var usage_store_exports = /* @__PURE__ */ __exportAll({
+	BUDGETS_COLLECTION: () => BUDGETS_COLLECTION,
+	USAGE_COLLECTION: () => USAGE_COLLECTION,
+	UsageStore: () => UsageStore
+});
+var USAGE_COLLECTION = "ai:usage";
+var BUDGETS_COLLECTION = "ai:budgets";
+var USAGE_COLUMNS = [
+	{
+		name: "ts",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "consumer",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "profileId",
+		type: "TEXT"
+	},
+	{
+		name: "kind",
+		type: "TEXT"
+	},
+	{
+		name: "model",
+		type: "TEXT"
+	},
+	{
+		name: "inputTokens",
+		type: "INTEGER"
+	},
+	{
+		name: "outputTokens",
+		type: "INTEGER"
+	},
+	{
+		name: "latencyMs",
+		type: "INTEGER"
+	},
+	{
+		name: "ok",
+		type: "BOOLEAN"
+	},
+	{
+		name: "errorCode",
+		type: "TEXT"
+	},
+	{
+		name: "imageCount",
+		type: "INTEGER"
+	}
+];
+var BUDGET_COLUMNS = [
+	{
+		name: "consumer",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "dailyTokenLimit",
+		type: "INTEGER"
+	},
+	{
+		name: "action",
+		type: "TEXT"
+	}
+];
+var UsageRowSchema = object({
+	ts: number(),
+	consumer: string(),
+	profileId: string().optional(),
+	kind: LlmProfileKindSchema.optional(),
+	model: string().optional(),
+	inputTokens: number(),
+	outputTokens: number(),
+	latencyMs: number(),
+	ok: boolean(),
+	errorCode: LlmErrorCodeSchema.optional(),
+	imageCount: number()
+});
+function dayKey(ts) {
+	return new Date(ts).toISOString().slice(0, 10);
+}
+var UsageStore = class {
+	store;
+	now;
+	constructor(store, now = Date.now) {
+		this.store = store;
+		this.now = now;
+	}
+	async init() {
+		await this.store.declareCollection(USAGE_COLLECTION, USAGE_COLUMNS);
+		await this.store.declareCollection(BUDGETS_COLLECTION, BUDGET_COLUMNS);
+	}
+	async record(row) {
+		await this.store.insert(USAGE_COLLECTION, {
+			id: randomUUID(),
+			data: { ...row }
+		});
+	}
+	async validRows() {
+		const rows = await this.store.query(USAGE_COLLECTION);
+		const out = [];
+		for (const row of rows) {
+			const parsed = UsageRowSchema.safeParse(row.data);
+			if (parsed.success) out.push(parsed.data);
+		}
+		return out;
+	}
+	async rollup(filter) {
+		const rows = (await this.validRows()).filter((r) => {
+			if (filter.since !== void 0 && r.ts < filter.since) return false;
+			if (filter.until !== void 0 && r.ts > filter.until) return false;
+			if (filter.consumer !== void 0 && r.consumer !== filter.consumer) return false;
+			if (filter.profileId !== void 0 && (r.profileId ?? "") !== filter.profileId) return false;
+			return true;
+		});
+		const groups = /* @__PURE__ */ new Map();
+		for (const r of rows) {
+			const profileId = r.profileId ?? "";
+			const day = dayKey(r.ts);
+			const key = `${day}|${r.consumer}|${profileId}`;
+			const acc = groups.get(key) ?? {
+				day,
+				consumer: r.consumer,
+				profileId,
+				calls: 0,
+				okCalls: 0,
+				errorCalls: 0,
+				inputTokens: 0,
+				outputTokens: 0,
+				latencySum: 0
+			};
+			acc.calls += 1;
+			if (r.ok) acc.okCalls += 1;
+			else acc.errorCalls += 1;
+			acc.inputTokens += r.inputTokens;
+			acc.outputTokens += r.outputTokens;
+			acc.latencySum += r.latencyMs;
+			groups.set(key, acc);
+		}
+		return [...groups.values()].map((acc) => ({
+			day: acc.day,
+			consumer: acc.consumer,
+			profileId: acc.profileId,
+			calls: acc.calls,
+			okCalls: acc.okCalls,
+			errorCalls: acc.errorCalls,
+			inputTokens: acc.inputTokens,
+			outputTokens: acc.outputTokens,
+			avgLatencyMs: acc.calls > 0 ? acc.latencySum / acc.calls : 0
+		})).sort((a, b) => a.day < b.day ? -1 : a.day > b.day ? 1 : 0);
+	}
+	async prune(retentionDays = 90) {
+		const cutoff = this.now() - retentionDays * 24 * 60 * 60 * 1e3;
+		const rows = await this.store.query(USAGE_COLLECTION);
+		for (const row of rows) {
+			const ts = row.data.ts;
+			if (typeof ts === "number" && ts < cutoff) await this.store.remove(USAGE_COLLECTION, row.id);
+		}
+	}
+};
+//#endregion
+export { usage_store_exports as i, USAGE_COLLECTION as n, UsageStore as r, BUDGETS_COLLECTION as t };

package/dist/usage-store-DK494_zK.js

@@ -0,0 +1,200 @@
+const require_addon = require("./addon.js");
+let node_crypto = require("node:crypto");
+//#region src/usage/usage-store.ts
+/**
+* Usage store over declared settings-store collections (spec §6). The sqlite
+* backend silently drops undeclared fields, so `init()` declares explicit
+* columns for both `ai:usage` and `ai:budgets` (budget enforcement is v2 —
+* schema only). Query-then-filter/group in JS is deliberate: LLM call volume is
+* low and rows are pruned at 90d.
+*/
+var usage_store_exports = /* @__PURE__ */ require_addon.__exportAll({
+	BUDGETS_COLLECTION: () => BUDGETS_COLLECTION,
+	USAGE_COLLECTION: () => USAGE_COLLECTION,
+	UsageStore: () => UsageStore
+});
+var USAGE_COLLECTION = "ai:usage";
+var BUDGETS_COLLECTION = "ai:budgets";
+var USAGE_COLUMNS = [
+	{
+		name: "ts",
+		type: "INTEGER",
+		notNull: true
+	},
+	{
+		name: "consumer",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "profileId",
+		type: "TEXT"
+	},
+	{
+		name: "kind",
+		type: "TEXT"
+	},
+	{
+		name: "model",
+		type: "TEXT"
+	},
+	{
+		name: "inputTokens",
+		type: "INTEGER"
+	},
+	{
+		name: "outputTokens",
+		type: "INTEGER"
+	},
+	{
+		name: "latencyMs",
+		type: "INTEGER"
+	},
+	{
+		name: "ok",
+		type: "BOOLEAN"
+	},
+	{
+		name: "errorCode",
+		type: "TEXT"
+	},
+	{
+		name: "imageCount",
+		type: "INTEGER"
+	}
+];
+var BUDGET_COLUMNS = [
+	{
+		name: "consumer",
+		type: "TEXT",
+		notNull: true
+	},
+	{
+		name: "dailyTokenLimit",
+		type: "INTEGER"
+	},
+	{
+		name: "action",
+		type: "TEXT"
+	}
+];
+var UsageRowSchema = require_addon.object({
+	ts: require_addon.number(),
+	consumer: require_addon.string(),
+	profileId: require_addon.string().optional(),
+	kind: require_addon.LlmProfileKindSchema.optional(),
+	model: require_addon.string().optional(),
+	inputTokens: require_addon.number(),
+	outputTokens: require_addon.number(),
+	latencyMs: require_addon.number(),
+	ok: require_addon.boolean(),
+	errorCode: require_addon.LlmErrorCodeSchema.optional(),
+	imageCount: require_addon.number()
+});
+function dayKey(ts) {
+	return new Date(ts).toISOString().slice(0, 10);
+}
+var UsageStore = class {
+	store;
+	now;
+	constructor(store, now = Date.now) {
+		this.store = store;
+		this.now = now;
+	}
+	async init() {
+		await this.store.declareCollection(USAGE_COLLECTION, USAGE_COLUMNS);
+		await this.store.declareCollection(BUDGETS_COLLECTION, BUDGET_COLUMNS);
+	}
+	async record(row) {
+		await this.store.insert(USAGE_COLLECTION, {
+			id: (0, node_crypto.randomUUID)(),
+			data: { ...row }
+		});
+	}
+	async validRows() {
+		const rows = await this.store.query(USAGE_COLLECTION);
+		const out = [];
+		for (const row of rows) {
+			const parsed = UsageRowSchema.safeParse(row.data);
+			if (parsed.success) out.push(parsed.data);
+		}
+		return out;
+	}
+	async rollup(filter) {
+		const rows = (await this.validRows()).filter((r) => {
+			if (filter.since !== void 0 && r.ts < filter.since) return false;
+			if (filter.until !== void 0 && r.ts > filter.until) return false;
+			if (filter.consumer !== void 0 && r.consumer !== filter.consumer) return false;
+			if (filter.profileId !== void 0 && (r.profileId ?? "") !== filter.profileId) return false;
+			return true;
+		});
+		const groups = /* @__PURE__ */ new Map();
+		for (const r of rows) {
+			const profileId = r.profileId ?? "";
+			const day = dayKey(r.ts);
+			const key = `${day}|${r.consumer}|${profileId}`;
+			const acc = groups.get(key) ?? {
+				day,
+				consumer: r.consumer,
+				profileId,
+				calls: 0,
+				okCalls: 0,
+				errorCalls: 0,
+				inputTokens: 0,
+				outputTokens: 0,
+				latencySum: 0
+			};
+			acc.calls += 1;
+			if (r.ok) acc.okCalls += 1;
+			else acc.errorCalls += 1;
+			acc.inputTokens += r.inputTokens;
+			acc.outputTokens += r.outputTokens;
+			acc.latencySum += r.latencyMs;
+			groups.set(key, acc);
+		}
+		return [...groups.values()].map((acc) => ({
+			day: acc.day,
+			consumer: acc.consumer,
+			profileId: acc.profileId,
+			calls: acc.calls,
+			okCalls: acc.okCalls,
+			errorCalls: acc.errorCalls,
+			inputTokens: acc.inputTokens,
+			outputTokens: acc.outputTokens,
+			avgLatencyMs: acc.calls > 0 ? acc.latencySum / acc.calls : 0
+		})).sort((a, b) => a.day < b.day ? -1 : a.day > b.day ? 1 : 0);
+	}
+	async prune(retentionDays = 90) {
+		const cutoff = this.now() - retentionDays * 24 * 60 * 60 * 1e3;
+		const rows = await this.store.query(USAGE_COLLECTION);
+		for (const row of rows) {
+			const ts = row.data.ts;
+			if (typeof ts === "number" && ts < cutoff) await this.store.remove(USAGE_COLLECTION, row.id);
+		}
+	}
+};
+//#endregion
+Object.defineProperty(exports, "BUDGETS_COLLECTION", {
+	enumerable: true,
+	get: function() {
+		return BUDGETS_COLLECTION;
+	}
+});
+Object.defineProperty(exports, "USAGE_COLLECTION", {
+	enumerable: true,
+	get: function() {
+		return USAGE_COLLECTION;
+	}
+});
+Object.defineProperty(exports, "UsageStore", {
+	enumerable: true,
+	get: function() {
+		return UsageStore;
+	}
+});
+Object.defineProperty(exports, "usage_store_exports", {
+	enumerable: true,
+	get: function() {
+		return usage_store_exports;
+	}
+});

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@camstack/addon-ai",
+  "version": "0.1.1",
+  "description": "AI addon for CamStack — the `llm` collection provider (cloud, LAN, and camstack-managed local llama.cpp profiles) plus the per-node `llm-runtime` managed executor.",
+  "keywords": [
+    "camstack",
+    "addon",
+    "camstack-addon",
+    "llm",
+    "ai"
+  ],
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "camstack": {
+    "displayName": "AI",
+    "addons": [
+      {
+        "id": "ai",
+        "category": "analytics",
+        "name": "AI",
+        "description": "LLM profiles (cloud, LAN, managed local models) + per-node managed llama.cpp runtimes",
+        "version": "0.1.0",
+        "entry": "./dist/index.js",
+        "execution": {
+          "placement": "any-node"
+        },
+        "capabilities": [
+          {
+            "name": "llm"
+          },
+          {
+            "name": "llm-runtime"
+          }
+        ],
+        "icon": "assets/icon.svg",
+        "color": "#0ea5e9"
+      }
+    ]
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "publish": "npm publish --access public"
+  },
+  "peerDependencies": {
+    "@camstack/types": "*"
+  },
+  "dependencies": {
+    "@camstack/system": "*",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@camstack/types": "*",
+    "typescript": "~6.0.3",
+    "vite": "^8.0.11",
+    "vitest": "^3.0.0"
+  }
+}