daycare-cli 0.0.0-canary.00a24ac

package/dist/engine/people/peopleRootDocumentEnsure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleRootDocumentEnsure.js","sourceRoot":"","sources":["../../../sources/engine/people/peopleRootDocumentEnsure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,GAAY,EACZ,OAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC1F,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;IACnE,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE;YAChD,EAAE,EAAE,QAAQ,EAAE;YACd,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,mDAAmD;YAChE,IAAI;YACJ,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,IAAI;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;QACvF,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,KAAK,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;AACL,CAAC"}

package/dist/engine/people/peopleRootDocumentEnsure.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=peopleRootDocumentEnsure.spec.d.ts.map

package/dist/engine/people/peopleRootDocumentEnsure.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleRootDocumentEnsure.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/people/peopleRootDocumentEnsure.spec.ts"],"names":[],"mappings":""}

package/dist/engine/people/peopleRootDocumentEnsure.spec.js

@@ -0,0 +1,25 @@
+import { describe, expect, it } from "vitest";
+import { storageOpenTest } from "../../storage/storageOpenTest.js";
+import { contextForUser } from "../agents/context.js";
+import { peopleRootDocumentEnsure } from "./peopleRootDocumentEnsure.js";
+describe("peopleRootDocumentEnsure", () => {
+    it("creates ~/people when missing and is idempotent", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const ctx = contextForUser({ userId: "user-1" });
+            const first = await peopleRootDocumentEnsure(ctx, storage);
+            expect(first.created).toBe(true);
+            const created = await storage.documents.findById(ctx, first.id);
+            expect(created?.slug).toBe("people");
+            expect(created?.title).toBe("People");
+            expect(created?.body.length).toBeGreaterThan(0);
+            const second = await peopleRootDocumentEnsure(ctx, storage);
+            expect(second.created).toBe(false);
+            expect(second.id).toBe(first.id);
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+});
+//# sourceMappingURL=peopleRootDocumentEnsure.spec.js.map

package/dist/engine/people/peopleRootDocumentEnsure.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleRootDocumentEnsure.spec.js","sourceRoot":"","sources":["../../../sources/engine/people/peopleRootDocumentEnsure.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,OAAO,GAAG,MAAM,eAAe,EAAE,CAAC;QACxC,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAEjD,MAAM,KAAK,GAAG,MAAM,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAChE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAEhD,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACP,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/engine/permissions/permissionBuildUser.d.ts

@@ -0,0 +1,8 @@
+import type { SessionPermissions } from "@/types";
+import type { UserHome } from "../users/userHome.js";
+/**
+ * Builds per-user default permissions scoped to one UserHome tree.
+ * Expects: userHome points to an initialized users/<id> directory.
+ */
+export declare function permissionBuildUser(userHome: UserHome): SessionPermissions;
+//# sourceMappingURL=permissionBuildUser.d.ts.map

package/dist/engine/permissions/permissionBuildUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionBuildUser.d.ts","sourceRoot":"","sources":["../../../sources/engine/permissions/permissionBuildUser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,CAM1E"}

package/dist/engine/permissions/permissionBuildUser.js

@@ -0,0 +1,12 @@
+/**
+ * Builds per-user default permissions scoped to one UserHome tree.
+ * Expects: userHome points to an initialized users/<id> directory.
+ */
+export function permissionBuildUser(userHome) {
+    return {
+        workingDir: userHome.desktop,
+        writeDirs: [userHome.home],
+        readDirs: [userHome.home, userHome.skillsActive]
+    };
+}
+//# sourceMappingURL=permissionBuildUser.js.map

package/dist/engine/permissions/permissionBuildUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionBuildUser.js","sourceRoot":"","sources":["../../../sources/engine/permissions/permissionBuildUser.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkB;IAClD,OAAO;QACH,UAAU,EAAE,QAAQ,CAAC,OAAO;QAC5B,SAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC;KACnD,CAAC;AACN,CAAC"}

package/dist/engine/permissions/permissionBuildUser.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=permissionBuildUser.spec.d.ts.map

package/dist/engine/permissions/permissionBuildUser.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionBuildUser.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/permissions/permissionBuildUser.spec.ts"],"names":[],"mappings":""}

package/dist/engine/permissions/permissionBuildUser.spec.js

@@ -0,0 +1,13 @@
+import { describe, expect, it } from "vitest";
+import { UserHome } from "../users/userHome.js";
+import { permissionBuildUser } from "./permissionBuildUser.js";
+describe("permissionBuildUser", () => {
+    it("builds user-scoped permissions with readable home and active skills roots", () => {
+        const userHome = new UserHome("/tmp/daycare-users", "usr_001");
+        const permissions = permissionBuildUser(userHome);
+        expect(permissions.workingDir).toBe(userHome.desktop);
+        expect(permissions.writeDirs).toEqual([userHome.home]);
+        expect(permissions.readDirs).toEqual([userHome.home, userHome.skillsActive]);
+    });
+});
+//# sourceMappingURL=permissionBuildUser.spec.js.map

package/dist/engine/permissions/permissionBuildUser.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionBuildUser.spec.js","sourceRoot":"","sources":["../../../sources/engine/permissions/permissionBuildUser.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACjF,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAElD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/engine/permissions.d.ts

@@ -0,0 +1,8 @@
+export type SessionPermissions = {
+    workingDir: string;
+    writeDirs: string[];
+    readDirs?: string[];
+};
+export declare function normalizePermissions(value: unknown, defaultWorkingDir: string): SessionPermissions;
+export declare function resolveWorkspacePath(workingDir: string, target: string): string;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/engine/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../sources/engine/permissions.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,kBAAkB,CAsClG;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO/E"}

package/dist/engine/permissions.js

@@ -0,0 +1,48 @@
+import path from "node:path";
+export function normalizePermissions(value, defaultWorkingDir) {
+    let writeDirs = [];
+    let readDirs = [];
+    if (value && typeof value === "object") {
+        const candidate = value;
+        if (typeof candidate.workingDir === "string" && candidate.workingDir.trim().length > 0) {
+            if (path.isAbsolute(candidate.workingDir)) {
+                if (Array.isArray(candidate.writeDirs)) {
+                    writeDirs = candidate.writeDirs
+                        .filter((entry) => typeof entry === "string" && entry.trim().length > 0)
+                        .map((entry) => entry.trim())
+                        .filter((entry) => path.isAbsolute(entry))
+                        .map((entry) => path.resolve(entry));
+                }
+                if (Array.isArray(candidate.readDirs)) {
+                    readDirs = candidate.readDirs
+                        .filter((entry) => typeof entry === "string" && entry.trim().length > 0)
+                        .map((entry) => entry.trim())
+                        .filter((entry) => path.isAbsolute(entry))
+                        .map((entry) => path.resolve(entry));
+                }
+                return {
+                    workingDir: path.resolve(candidate.workingDir),
+                    writeDirs: dedupe(writeDirs),
+                    readDirs: dedupe(readDirs)
+                };
+            }
+        }
+    }
+    return {
+        workingDir: path.resolve(defaultWorkingDir),
+        writeDirs: [],
+        readDirs: []
+    };
+}
+export function resolveWorkspacePath(workingDir, target) {
+    const resolved = path.resolve(workingDir, target);
+    const relative = path.relative(workingDir, resolved);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new Error("Path is outside the workspace.");
+    }
+    return resolved;
+}
+function dedupe(values) {
+    return Array.from(new Set(values));
+}
+//# sourceMappingURL=permissions.js.map

package/dist/engine/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../sources/engine/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,iBAAyB;IAC1E,IAAI,SAAS,GAAa,EAAE,CAAC;IAC7B,IAAI,QAAQ,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,KAIjB,CAAC;QACF,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrF,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;oBACrC,SAAS,GAAG,SAAS,CAAC,SAAS;yBAC1B,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;yBACxF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;yBAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;yBACzC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7C,CAAC;gBACD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACpC,QAAQ,GAAG,SAAS,CAAC,QAAQ;yBACxB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;yBACxF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;yBAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;yBACzC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7C,CAAC;gBACD,OAAO;oBACH,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC;oBAC9C,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;oBAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;iBAC7B,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO;QACH,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;QAC3C,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;KACf,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,MAAc;IACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/engine/plugins/builtins.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=builtins.spec.d.ts.map

package/dist/engine/plugins/builtins.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/plugins/builtins.spec.ts"],"names":[],"mappings":""}

package/dist/engine/plugins/builtins.spec.js

@@ -0,0 +1,103 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { AuthStore } from "../../auth/store.js";
+import { configResolve } from "../../config/configResolve.js";
+import { getLogger } from "../../log.js";
+import { plugin as braveSearch } from "../../plugins/brave-search/plugin.js";
+import { plugin as telegram } from "../../plugins/telegram/plugin.js";
+import { storageOpenTest } from "../../storage/storageOpenTest.js";
+import { FileFolder } from "../files/fileFolder.js";
+import { Processes } from "../processes/processes.js";
+const tempRoots = [];
+async function createTempDir() {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-plugin-builtin-"));
+    tempRoots.push(dir);
+    return dir;
+}
+function createRegistrar() {
+    return {
+        registerInferenceProvider: vi.fn(),
+        unregisterInferenceProvider: vi.fn(),
+        registerTool: vi.fn(),
+        unregisterTool: vi.fn(),
+        registerImageProvider: vi.fn(),
+        unregisterImageProvider: vi.fn(),
+        registerMediaAnalysisProvider: vi.fn(),
+        unregisterMediaAnalysisProvider: vi.fn(),
+        registerConnector: vi.fn(),
+        unregisterConnector: vi.fn()
+    };
+}
+async function createApi(instanceId, pluginId, settings, registrar, dir) {
+    const config = configResolve({ engine: { dataDir: dir } }, path.join(dir, "settings.json"));
+    const auth = new AuthStore(config);
+    const fileStore = new FileFolder(path.join(config.dataDir, "files"));
+    const storage = await storageOpenTest();
+    const inference = {
+        complete: async () => {
+            throw new Error("Inference not available in tests");
+        }
+    };
+    return {
+        instance: { instanceId, pluginId, enabled: true },
+        settings,
+        engineSettings: {},
+        logger: getLogger(`test.${instanceId}`),
+        auth,
+        dataDir: dir,
+        tmpDir: path.join(dir, "tmp"),
+        usersDir: path.join(dir, "users"),
+        registrar,
+        exposes: {
+            registerProvider: async () => undefined,
+            unregisterProvider: async () => undefined,
+            listProviders: () => []
+        },
+        fileStore,
+        inference,
+        processes: new Processes(dir, getLogger(`test.processes.${instanceId}`), {
+            repository: storage.processes
+        }),
+        mode: "runtime",
+        webhooks: {
+            trigger: async () => {
+                throw new Error("Webhook runtime unavailable.");
+            }
+        },
+        events: {
+            emit: () => undefined
+        }
+    };
+}
+describe("built-in plugins", () => {
+    afterEach(async () => {
+        const pending = tempRoots.splice(0, tempRoots.length);
+        await Promise.all(pending.map(async (dir) => {
+            await fs.rm(dir, { recursive: true, force: true });
+        }));
+    });
+    it("registers tools", async () => {
+        const dir = await createTempDir();
+        const registrar = createRegistrar();
+        const braveSettings = braveSearch.settingsSchema.parse({ toolName: "search_v2" });
+        const braveApi = await createApi("brave-main", "brave-search", braveSettings, registrar, dir);
+        const braveInstance = await braveSearch.create(braveApi);
+        await braveInstance.load?.();
+        expect(registrar.registerTool).toHaveBeenCalledWith(expect.objectContaining({ tool: expect.objectContaining({ name: "search_v2" }) }));
+    });
+    it("builds a telegram plugin instance without executing load", async () => {
+        const dir = await createTempDir();
+        const registrar = createRegistrar();
+        const settings = telegram.settingsSchema.parse({
+            polling: false,
+            allowedUids: ["123456789"]
+        });
+        const api = await createApi("telegram-main", "telegram", settings, registrar, dir);
+        const instance = await telegram.create(api);
+        expect(typeof instance.load).toBe("function");
+        expect(typeof instance.unload).toBe("function");
+    });
+});
+//# sourceMappingURL=builtins.spec.js.map

package/dist/engine/plugins/builtins.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.spec.js","sourceRoot":"","sources":["../../../sources/engine/plugins/builtins.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/plugins/catalog.d.ts

@@ -0,0 +1,9 @@
+import { type PluginDescriptor } from "./descriptor.js";
+export type PluginDefinition = {
+    descriptor: PluginDescriptor;
+    entryPath: string;
+    descriptorPath: string;
+    pluginDir: string;
+};
+export declare function buildPluginCatalog(): Map<string, PluginDefinition>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/engine/plugins/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../sources/engine/plugins/catalog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAA0B,MAAM,iBAAiB,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAqBF,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAiBlE"}

package/dist/engine/plugins/catalog.js

@@ -0,0 +1,37 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { pluginDescriptorSchema } from "./descriptor.js";
+const pluginsDir = fileURLToPath(new URL("../../plugins", import.meta.url));
+function collectDescriptorFiles(root) {
+    const entries = fs.readdirSync(root, { withFileTypes: true });
+    const results = [];
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            results.push(...collectDescriptorFiles(path.join(root, entry.name)));
+            continue;
+        }
+        if (entry.isFile() && entry.name === "plugin.json") {
+            results.push(path.join(root, entry.name));
+        }
+    }
+    return results;
+}
+const descriptorFiles = collectDescriptorFiles(pluginsDir);
+export function buildPluginCatalog() {
+    const catalog = new Map();
+    for (const descriptorPath of descriptorFiles) {
+        const raw = fs.readFileSync(descriptorPath, "utf8");
+        const parsed = pluginDescriptorSchema.parse(JSON.parse(raw));
+        const pluginDir = path.dirname(descriptorPath);
+        const entryPath = path.resolve(pluginDir, parsed.entry);
+        catalog.set(parsed.id, {
+            descriptor: parsed,
+            entryPath,
+            descriptorPath,
+            pluginDir
+        });
+    }
+    return catalog;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/engine/plugins/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../sources/engine/plugins/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAyB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAShF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE5E,SAAS,sBAAsB,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrE,SAAS;QACb,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,eAAe,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;AAE3D,MAAM,UAAU,kBAAkB;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEpD,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE;YACnB,UAAU,EAAE,MAAM;YAClB,SAAS;YACT,cAAc;YACd,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/engine/plugins/descriptor.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const pluginDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    entry: z.ZodString;
+    exclusive: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    id: string;
+    entry: string;
+    exclusive?: boolean | undefined;
+}, {
+    name: string;
+    description: string;
+    id: string;
+    entry: string;
+    exclusive?: boolean | undefined;
+}>;
+export type PluginDescriptor = z.infer<typeof pluginDescriptorSchema>;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/engine/plugins/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../sources/engine/plugins/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/engine/plugins/descriptor.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export const pluginDescriptorSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    description: z.string().min(1),
+    entry: z.string().min(1),
+    exclusive: z.boolean().optional()
+});
+//# sourceMappingURL=descriptor.js.map

package/dist/engine/plugins/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../../sources/engine/plugins/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}

package/dist/engine/plugins/events.d.ts

@@ -0,0 +1,15 @@
+export type PluginEventInput = {
+    type: string;
+    payload?: unknown;
+};
+export type PluginEvent = PluginEventInput & {
+    id: string;
+    pluginId: string;
+    instanceId: string;
+    createdAt: string;
+};
+export type PluginEventSource = {
+    pluginId: string;
+    instanceId: string;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/engine/plugins/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../sources/engine/plugins/events.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/engine/plugins/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/engine/plugins/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../sources/engine/plugins/events.ts"],"names":[],"mappings":""}

package/dist/engine/plugins/exclusive.d.ts

@@ -0,0 +1,9 @@
+import type { PluginInstanceSettings } from "../../settings.js";
+import type { PluginDefinition } from "./catalog.js";
+export type ExclusiveResolution = {
+    allowed: PluginInstanceSettings[];
+    exclusive: PluginInstanceSettings | null;
+    skipped: PluginInstanceSettings[];
+};
+export declare function resolveExclusivePlugins(enabled: PluginInstanceSettings[], catalog: Map<string, PluginDefinition>): ExclusiveResolution;
+//# sourceMappingURL=exclusive.d.ts.map

package/dist/engine/plugins/exclusive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusive.d.ts","sourceRoot":"","sources":["../../../sources/engine/plugins/exclusive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACzC,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACrC,CAAC;AAEF,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,sBAAsB,EAAE,EACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACvC,mBAAmB,CAqBrB"}

package/dist/engine/plugins/exclusive.js

@@ -0,0 +1,20 @@
+export function resolveExclusivePlugins(enabled, catalog) {
+    const exclusive = enabled.filter((plugin) => catalog.get(plugin.pluginId)?.descriptor.exclusive === true);
+    if (exclusive.length === 0) {
+        return { allowed: enabled, exclusive: null, skipped: [] };
+    }
+    const primary = exclusive[0];
+    if (!primary) {
+        return { allowed: enabled, exclusive: null, skipped: [] };
+    }
+    if (enabled.length <= 1) {
+        return { allowed: enabled, exclusive: primary, skipped: [] };
+    }
+    const skipped = enabled.filter((plugin) => plugin.instanceId !== primary.instanceId);
+    return {
+        allowed: [primary],
+        exclusive: primary,
+        skipped
+    };
+}
+//# sourceMappingURL=exclusive.js.map

package/dist/engine/plugins/exclusive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusive.js","sourceRoot":"","sources":["../../../sources/engine/plugins/exclusive.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,uBAAuB,CACnC,OAAiC,EACjC,OAAsC;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;IAE1G,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACjE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACrF,OAAO;QACH,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO;QAClB,OAAO;KACV,CAAC;AACN,CAAC"}

package/dist/engine/plugins/inference.d.ts

@@ -0,0 +1,31 @@
+import type { AssistantMessage, Context } from "@mariozechner/pi-ai";
+import type { ConfigModule } from "../config/configModule.js";
+import type { InferenceRouter } from "../modules/inference/router.js";
+export type PluginInferenceStrategy = "default" | string;
+export type PluginInferenceRequest = {
+    systemPrompt?: string;
+    messages: Context["messages"];
+    providerId?: string;
+    strategy?: PluginInferenceStrategy;
+};
+export type PluginInferenceResult = {
+    message: AssistantMessage;
+    providerId: string;
+    modelId: string;
+};
+export type PluginInference = {
+    complete: (request: PluginInferenceRequest) => Promise<PluginInferenceResult>;
+};
+type PluginInferenceServiceOptions = {
+    router: InferenceRouter;
+    config: ConfigModule;
+};
+export declare class PluginInferenceService {
+    private router;
+    private config;
+    constructor(options: PluginInferenceServiceOptions);
+    createClient(instanceId: string): PluginInference;
+    private complete;
+}
+export {};
+//# sourceMappingURL=inference.d.ts.map

package/dist/engine/plugins/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../../sources/engine/plugins/inference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAarE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,sBAAsB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACjF,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;CACxB,CAAC;AAIF,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE,6BAA6B;IAKlD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;YAMnC,QAAQ;CAkCzB"}

package/dist/engine/plugins/inference.js

@@ -0,0 +1,126 @@
+import { createId } from "@paralleldrive/cuid2";
+import { getLogger } from "../../log.js";
+import { getProviderDefinition, listActiveInferenceProviders } from "../../providers/catalog.js";
+import { modelRoleApply } from "../../providers/modelRoleApply.js";
+import { providerModelSelectBySize } from "../../providers/providerModelSelectBySize.js";
+import { BUILTIN_MODEL_FLAVORS } from "../../settings.js";
+const logger = getLogger("plugins.inference");
+export class PluginInferenceService {
+    router;
+    config;
+    constructor(options) {
+        this.router = options.router;
+        this.config = options.config;
+    }
+    createClient(instanceId) {
+        return {
+            complete: async (request) => this.complete(request, instanceId)
+        };
+    }
+    async complete(request, instanceId) {
+        const settings = this.config.current.settings;
+        const providers = listActiveInferenceProviders(settings);
+        if (providers.length === 0) {
+            throw new Error("No inference provider available");
+        }
+        const strategy = request.strategy ?? "default";
+        const context = {
+            messages: request.messages,
+            systemPrompt: request.systemPrompt
+        };
+        const agentId = `plugin:${instanceId}:${createId()}`;
+        if (strategy === "default") {
+            const providersOverride = resolveProvidersOverride(providers, request.providerId);
+            return this.router.complete(context, agentId, {
+                providersOverride
+            });
+        }
+        const providersOverride = resolveProvidersForStrategy(providers, request.providerId, strategy, settings.modelFlavors);
+        logger.debug(`event: Plugin inference selection providerId=${providersOverride[0]?.id ?? "unknown"} strategy=${strategy} model=${providersOverride[0]?.model ?? "default"}`);
+        return this.router.complete(context, agentId, {
+            providersOverride
+        });
+    }
+}
+function resolveProvidersOverride(providers, providerId) {
+    if (!providerId) {
+        return providers;
+    }
+    const provider = providers.find((entry) => entry.id === providerId);
+    if (!provider) {
+        throw new Error(`Unknown inference provider: ${providerId}`);
+    }
+    return [provider];
+}
+function resolveSelectedProvider(providers, providerId) {
+    if (providerId) {
+        const provider = providers.find((entry) => entry.id === providerId);
+        if (!provider) {
+            throw new Error(`Unknown inference provider: ${providerId}`);
+        }
+        return provider;
+    }
+    return providers[0];
+}
+function resolveModelForStrategy(providerId, defaultModel, strategy) {
+    const definition = getProviderDefinition(providerId);
+    const models = definition?.models ?? [];
+    if (models.length === 0) {
+        return defaultModel;
+    }
+    const match = providerModelSelectBySize(models, strategy);
+    if (match) {
+        return match;
+    }
+    return defaultModel ?? models[0]?.id;
+}
+function resolveProvidersForStrategy(providers, providerId, strategy, modelFlavors) {
+    const builtinFlavor = builtinModelFlavorParse(strategy);
+    if (builtinFlavor) {
+        const provider = resolveSelectedProvider(providers, providerId);
+        const resolvedModel = resolveModelForStrategy(provider.id, provider.model, builtinFlavor);
+        return [
+            {
+                ...provider,
+                model: resolvedModel ?? provider.model
+            }
+        ];
+    }
+    const customFlavor = customFlavorResolve(strategy, modelFlavors);
+    if (!customFlavor) {
+        throw new Error(`Unknown inference strategy: ${strategy}`);
+    }
+    const candidates = providerId ? [resolveSelectedProvider(providers, providerId)] : providers;
+    const applied = modelRoleApply(candidates, customFlavor.model);
+    if (applied.providerId) {
+        const selected = applied.providers.find((entry) => entry.id === applied.providerId);
+        if (selected) {
+            return [selected];
+        }
+    }
+    return [resolveSelectedProvider(providers, providerId)];
+}
+function builtinModelFlavorParse(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized in BUILTIN_MODEL_FLAVORS) {
+        return normalized;
+    }
+    return null;
+}
+function customFlavorResolve(strategy, modelFlavors) {
+    if (!modelFlavors) {
+        return null;
+    }
+    const trimmed = strategy.trim();
+    const exact = modelFlavors[trimmed];
+    if (exact) {
+        return { model: exact.model };
+    }
+    const normalized = trimmed.toLowerCase();
+    const flavorKey = Object.keys(modelFlavors).find((key) => key.toLowerCase() === normalized);
+    if (!flavorKey) {
+        return null;
+    }
+    return { model: modelFlavors[flavorKey].model };
+}
+//# sourceMappingURL=inference.js.map