@nekutima/provili-sdk 0.2.0

package/dist/llm-engines/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Vendor-neutral LLM Engine access layer.
+ *
+ * This module is the SDK's translation layer between a product and an LLM
+ * vendor (Ollama, DeepSeek, OpenAI, Anthropic, Gemini, xAI, OpenRouter, or any
+ * OpenAI-compatible "custom" endpoint). Callers configure an engine once and
+ * then use the same `chat` / `embed` / `health` surface regardless of vendor.
+ *
+ * It is deliberately dependency-free and isomorphic (browser + Node): the only
+ * requirement is a `fetch` implementation, which is injected (defaults to the
+ * global `fetch`).
+ */
+/** The closed set of vendor types an engine can be. */
+export declare const ENGINE_TYPES: readonly ["ollama", "deepseek", "openai", "anthropic", "gemini", "xai", "openrouter", "custom"];
+export type EngineType = (typeof ENGINE_TYPES)[number];
+/** Runtime guard for the closed vendor set. */
+export declare function isEngineType(value: string | null | undefined): value is EngineType;
+/** How the vendor expects the credential to be attached to a request. */
+export interface EngineAuthSpec {
+    kind: 'bearer' | 'x-api-key' | 'none';
+    /** Header carrying the key when `kind === 'x-api-key'`. */
+    headerName?: string;
+    /** Extra static headers the vendor requires (e.g. Anthropic version, OpenRouter attribution). */
+    extraHeaders?: Record<string, string>;
+    /** Where the key goes in the URL query for query-auth vendors (reserved). */
+    queryParam?: string;
+}
+/** Everything that differs between vendors, in one place. */
+export interface EngineTypeDescriptor {
+    type: EngineType;
+    label: string;
+    defaultEndpoint: string;
+    endpointRequired: boolean;
+    apiKeyRequired: boolean;
+    supportsChat: boolean;
+    supportsEmbed: boolean;
+    defaultModel: string;
+    modelRequired: boolean;
+    auth: EngineAuthSpec;
+    /** Path appended to the endpoint for a chat completion. */
+    chatPath: string;
+    /** Path appended to the endpoint for embeddings (absent when unsupported). */
+    embedPath?: string;
+    /** Primary health/models probe path. */
+    healthPath: string;
+    /** Optional fallback probe path (e.g. Ollama native tags vs OpenAI models). */
+    healthFallbackPath?: string;
+    /** How to read chat responses and stream chunks from this vendor. */
+    responseStyle: 'openai' | 'anthropic';
+}
+/** Normalized engine configuration used by the access layer. */
+export interface EngineConfig {
+    type: EngineType;
+    /** Overrides the descriptor default when provided. */
+    endpoint?: string;
+    apiKey?: string;
+    model?: string;
+}
+export interface EngineConfigFieldError {
+    field: 'type' | 'endpoint' | 'apiKey' | 'model';
+    message: string;
+}
+export interface EngineMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChatOptions {
+    /** Ask the vendor to stream (used by `chatStream`). */
+    stream?: boolean;
+    signal?: AbortSignal;
+    temperature?: number;
+}
+export interface ChatResult {
+    content: string;
+    finishReason?: string;
+}
+export interface EmbedResult {
+    embeddings: number[][];
+}
+/** Stable error taxonomy across vendors and transport failures. */
+export type EngineErrorCategory = 'unreachable' | 'auth' | 'rate_limited' | 'bad_request' | 'server' | 'timeout' | 'unknown';
+export interface EngineHealth {
+    ok: boolean;
+    latencyMs: number;
+    status?: number;
+    error?: string;
+    category?: EngineErrorCategory;
+}
+/** Minimal isomorphic `Response` shape (avoids depending on DOM/Node lib types). */
+export interface EngineFetchResponse {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+    body?: ReadableStreamLike | null;
+}
+export interface ReadableStreamLike {
+    getReader(): ReadableStreamReaderLike;
+}
+export interface ReadableStreamReaderLike {
+    read(): Promise<{
+        done: boolean;
+        value?: Uint8Array;
+    }>;
+    releaseLock?(): void;
+    cancel?(): Promise<void> | void;
+}
+export type EngineFetch = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<EngineFetchResponse>;
+export interface EngineClientDeps {
+    fetch?: EngineFetch;
+}
+/**
+ * The uniform facade every product uses. No method requires knowing the vendor.
+ */
+export interface EngineClient {
+    /** Resolved configuration (with descriptor defaults applied). */
+    readonly config: Required<Pick<EngineConfig, 'type' | 'endpoint' | 'model'>> & {
+        apiKey?: string;
+    };
+    chat(messages: EngineMessage[], options?: ChatOptions): Promise<ChatResult>;
+    chatStream(messages: EngineMessage[], options?: ChatOptions): AsyncIterable<string>;
+    embed(input: string[]): Promise<EmbedResult>;
+    health(): Promise<EngineHealth>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm-engines/types.d.ts.map

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

package/dist/llm-engines/types.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Vendor-neutral LLM Engine access layer.
+ *
+ * This module is the SDK's translation layer between a product and an LLM
+ * vendor (Ollama, DeepSeek, OpenAI, Anthropic, Gemini, xAI, OpenRouter, or any
+ * OpenAI-compatible "custom" endpoint). Callers configure an engine once and
+ * then use the same `chat` / `embed` / `health` surface regardless of vendor.
+ *
+ * It is deliberately dependency-free and isomorphic (browser + Node): the only
+ * requirement is a `fetch` implementation, which is injected (defaults to the
+ * global `fetch`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENGINE_TYPES = void 0;
+exports.isEngineType = isEngineType;
+/** The closed set of vendor types an engine can be. */
+exports.ENGINE_TYPES = [
+    'ollama',
+    'deepseek',
+    'openai',
+    'anthropic',
+    'gemini',
+    'xai',
+    'openrouter',
+    'custom',
+];
+/** Runtime guard for the closed vendor set. */
+function isEngineType(value) {
+    return typeof value === 'string' && exports.ENGINE_TYPES.includes(value);
+}
+//# sourceMappingURL=types.js.map

package/dist/llm-engines/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm-engines/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAiBH,oCAEC;AAjBD,uDAAuD;AAC1C,QAAA,YAAY,GAAG;IACxB,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,KAAK;IACL,YAAY;IACZ,QAAQ;CACF,CAAC;AAIX,+CAA+C;AAC/C,SAAgB,YAAY,CAAC,KAAgC;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,oBAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5F,CAAC"}

package/dist/mcp/host.d.ts

@@ -0,0 +1,13 @@
+import type { McpCallRequest, McpCallResult, McpHost, McpTool, McpToolHandler } from './types';
+/**
+ * In-memory MCP host for frontend tool packs and tests.
+ * Backend packs are executed by provili-be; FE registers research (and future) packs here.
+ */
+export declare class InMemoryMcpHost implements McpHost {
+    private readonly tools;
+    register(handler: McpToolHandler): void;
+    registerAll(handlers: McpToolHandler[]): void;
+    listTools(): McpTool[];
+    callTool(req: McpCallRequest): Promise<McpCallResult>;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/mcp/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/mcp/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,OAAO,EACP,OAAO,EACP,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAWvC,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI;IAM7C,SAAS,IAAI,OAAO,EAAE;IAIhB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAwC5D"}

package/dist/mcp/host.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryMcpHost = void 0;
+/**
+ * In-memory MCP host for frontend tool packs and tests.
+ * Backend packs are executed by provili-be; FE registers research (and future) packs here.
+ */
+class InMemoryMcpHost {
+    constructor() {
+        this.tools = new Map();
+    }
+    register(handler) {
+        const name = handler.definition.name;
+        if (!name) {
+            throw new Error('MCP tool definition requires a name');
+        }
+        if (this.tools.has(name)) {
+            throw new Error(`MCP tool already registered: ${name}`);
+        }
+        this.tools.set(name, handler);
+    }
+    registerAll(handlers) {
+        for (const h of handlers) {
+            this.register(h);
+        }
+    }
+    listTools() {
+        return [...this.tools.values()].map((h) => h.definition);
+    }
+    async callTool(req) {
+        const started = Date.now();
+        const handler = this.tools.get(req.name);
+        if (!handler) {
+            return {
+                ok: false,
+                isError: true,
+                error: `unknown tool: ${req.name}`,
+                content: [{ type: 'text', text: `unknown tool: ${req.name}` }],
+                meta: { duration_ms: Date.now() - started, call_id: req.call_id },
+            };
+        }
+        try {
+            const args = req.arguments ?? {};
+            const result = await handler.call(args);
+            return {
+                ...result,
+                meta: {
+                    pack: handler.definition.pack,
+                    call_id: req.call_id,
+                    duration_ms: Date.now() - started,
+                    ...result.meta,
+                },
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                ok: false,
+                isError: true,
+                error: message,
+                content: [{ type: 'text', text: message }],
+                meta: {
+                    pack: handler.definition.pack,
+                    call_id: req.call_id,
+                    duration_ms: Date.now() - started,
+                },
+            };
+        }
+    }
+}
+exports.InMemoryMcpHost = InMemoryMcpHost;
+//# sourceMappingURL=host.js.map

package/dist/mcp/host.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './host';
+export * from './mcp.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./host"), exports);
+tslib_1.__exportStar(require("./mcp.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,iDAAuB;AACvB,wDAA8B"}

package/dist/mcp/mcp.service.d.ts

@@ -0,0 +1,21 @@
+import { ProviliHttpClient } from '../core/http-client';
+import type { McpCallRequest, McpCallResult, McpTool } from './types';
+/**
+ * HTTP client for backend MCP host (list + call + research proxy).
+ */
+export declare class ProviliMcpService {
+    private httpClient;
+    constructor(httpClient: ProviliHttpClient);
+    listTools(): Promise<McpTool[]>;
+    callTool(req: McpCallRequest): Promise<McpCallResult>;
+    /**
+     * Convenience for research pack: same as callTool({ name: 'research.fetch', ... }).
+     * Available once the research pack is registered on the backend.
+     */
+    researchFetch(args: {
+        url: string;
+        method?: string;
+        max_bytes?: number;
+    }): Promise<McpCallResult>;
+}
+//# sourceMappingURL=mcp.service.d.ts.map

package/dist/mcp/mcp.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.service.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,OAAO,EACR,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,iBAAiB;IAE3C,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAK/B,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAS3D;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE;QACxB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,aAAa,CAAC;CAM3B"}

package/dist/mcp/mcp.service.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviliMcpService = void 0;
+/**
+ * HTTP client for backend MCP host (list + call + research proxy).
+ */
+class ProviliMcpService {
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    async listTools() {
+        const response = await this.httpClient.get('/mcp/tools');
+        return response.tools ?? [];
+    }
+    async callTool(req) {
+        return this.httpClient.post('/mcp/call', {
+            name: req.name,
+            arguments: req.arguments ?? {},
+            call_id: req.call_id,
+            timeout_ms: req.timeout_ms,
+        });
+    }
+    /**
+     * Convenience for research pack: same as callTool({ name: 'research.fetch', ... }).
+     * Available once the research pack is registered on the backend.
+     */
+    async researchFetch(args) {
+        return this.callTool({
+            name: 'research.fetch',
+            arguments: args,
+        });
+    }
+}
+exports.ProviliMcpService = ProviliMcpService;
+//# sourceMappingURL=mcp.service.js.map

package/dist/mcp/mcp.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.service.js","sourceRoot":"","sources":["../../src/mcp/mcp.service.ts"],"names":[],"mappings":";;;AAQA;;GAEG;AACH,MAAa,iBAAiB;IAC5B,YAAoB,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAErD,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAuB,YAAY,CAAC,CAAC;QAC/E,OAAO,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAmB;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAgB,WAAW,EAAE;YACtD,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;YAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,IAInB;QACC,OAAO,IAAI,CAAC,QAAQ,CAAC;YACnB,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,IAA+B;SAC3C,CAAC,CAAC;IACL,CAAC;CACF;AA/BD,8CA+BC"}

package/dist/mcp/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Product MCP shapes (ADR-0017).
+ * Compatible enough with Model Context Protocol tool descriptors for later export.
+ */
+/** Minimal JSON Schema object for tool inputs. */
+export type JsonSchemaObject = {
+    type?: string | string[];
+    properties?: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean | Record<string, unknown>;
+    description?: string;
+    items?: unknown;
+    enum?: unknown[];
+    [key: string]: unknown;
+};
+export type McpSide = 'backend' | 'frontend';
+export interface McpTool {
+    /** Dotted name, e.g. time.now, math.eval */
+    name: string;
+    description: string;
+    inputSchema: JsonSchemaObject;
+    pack: string;
+    side: McpSide;
+}
+export interface McpCallRequest {
+    name: string;
+    arguments?: Record<string, unknown>;
+    call_id?: string;
+    timeout_ms?: number;
+}
+export type McpContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'json';
+    json: unknown;
+};
+export interface McpCallResult {
+    ok: boolean;
+    content: McpContentPart[];
+    isError?: boolean;
+    meta?: {
+        duration_ms?: number;
+        pack?: string;
+        call_id?: string;
+    };
+    error?: string;
+}
+export interface McpToolHandler {
+    definition: McpTool;
+    call(args: Record<string, unknown>): Promise<McpCallResult> | McpCallResult;
+}
+export interface McpHost {
+    listTools(): Promise<McpTool[]> | McpTool[];
+    callTool(req: McpCallRequest): Promise<McpCallResult>;
+}
+export interface ListMcpToolsResponse {
+    tools: McpTool[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7C,MAAM,WAAW,OAAO;IACtB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;CAC7E;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB"}

package/dist/mcp/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Product MCP shapes (ADR-0017).
+ * Compatible enough with Model Context Protocol tool descriptors for later export.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/models/agent.model.d.ts

@@ -0,0 +1,62 @@
+export type ImaginationLevel = 'none' | 'grounded' | 'balanced' | 'creative' | 'wild' | 'borderline';
+export interface Agent {
+    id: number;
+    name: string;
+    personality: string;
+    background: string;
+    allow_nsfw: boolean;
+    avatar_url: string;
+    color: string;
+    temperature: number;
+    imagination_level: ImaginationLevel;
+    about_me: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateAgentRequest {
+    name: string;
+    personality?: string;
+    background?: string;
+    allow_nsfw?: boolean;
+    avatar_url?: string;
+    color?: string;
+    imagination_level?: ImaginationLevel;
+}
+export interface UpdateAgentRequest {
+    name?: string;
+    personality?: string;
+    background?: string;
+    allow_nsfw?: boolean;
+    avatar_url?: string;
+    color?: string;
+    imagination_level?: ImaginationLevel;
+}
+/** Per-agent product MCP allowlist (ADR-0017). mode all = no restriction. */
+export interface AgentMcpToolsConfig {
+    mode: 'all' | 'allowlist';
+    patterns: string[];
+    catalog?: Array<{
+        name: string;
+        description: string;
+        pack: string;
+        side: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+}
+/** POST /agents/{id}/wake — defrost + tool discovery. */
+export interface AgentWakeResponse {
+    agent_id: number;
+    status: string;
+    defrosted_at: string;
+    awake_at: string;
+    tools: Array<{
+        name: string;
+        description: string;
+        pack: string;
+        side: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+    tool_count: number;
+    cached?: boolean;
+}
+//# sourceMappingURL=agent.model.d.ts.map

package/dist/models/agent.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.model.d.ts","sourceRoot":"","sources":["../../src/models/agent.model.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;AAErG,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,KAAK,GAAG,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC,CAAC;CACJ;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/models/agent.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent.model.js.map

package/dist/models/agent.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.model.js","sourceRoot":"","sources":["../../src/models/agent.model.ts"],"names":[],"mappings":""}

package/dist/models/ai-chat.model.d.ts

@@ -0,0 +1,27 @@
+export interface AiChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface AiChatRequest {
+    model: string;
+    messages: AiChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    stream?: boolean;
+}
+export interface AiChatChunk {
+    content: string;
+    done: boolean;
+}
+export interface AiChatCallbacks {
+    onChunk: (chunk: AiChatChunk) => void;
+    onComplete: (fullContent: string) => void;
+    onError: (error: Error) => void;
+}
+export interface AiChatConfig {
+    baseUrl: string;
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+//# sourceMappingURL=ai-chat.model.d.ts.map

package/dist/models/ai-chat.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat.model.d.ts","sourceRoot":"","sources":["../../src/models/ai-chat.model.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/models/ai-chat.model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ai-chat.model.js.map

package/dist/models/ai-chat.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat.model.js","sourceRoot":"","sources":["../../src/models/ai-chat.model.ts"],"names":[],"mappings":""}

package/dist/models/api-error.model.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Unified API Error model for Pro.vi.li platform
+ * This model is shared between frontend and backend
+ */
+export declare enum API_ERROR_TYPE {
+    BAD_REQUEST = "BAD_REQUEST",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    NOT_FOUND = "NOT_FOUND",
+    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    CONFLICT = "CONFLICT",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR"
+}
+export interface ApiError {
+    type: API_ERROR_TYPE;
+    message: string;
+    details?: Record<string, unknown>;
+    statusCode: number;
+}
+/**
+ * API Error helper class for client-side usage
+ */
+export declare class ApiStandardError extends Error {
+    type: API_ERROR_TYPE;
+    statusCode: number;
+    details?: Record<string, unknown>;
+    constructor(type: API_ERROR_TYPE, message: string, details?: Record<string, unknown>);
+    private getStatusCode;
+}
+//# sourceMappingURL=api-error.model.d.ts.map

package/dist/models/api-error.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.model.d.ts","sourceRoot":"","sources":["../../src/models/api-error.model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,cAAc;IACtB,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,qBAAqB,0BAA0B;IAC/C,gBAAgB,qBAAqB;IACrC,QAAQ,aAAa;IACrB,mBAAmB,wBAAwB;IAC3C,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;CAClC;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE7B,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQpF,OAAO,CAAC,aAAa;CAyBxB"}

package/dist/models/api-error.model.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Unified API Error model for Pro.vi.li platform
+ * This model is shared between frontend and backend
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiStandardError = exports.API_ERROR_TYPE = void 0;
+var API_ERROR_TYPE;
+(function (API_ERROR_TYPE) {
+    API_ERROR_TYPE["BAD_REQUEST"] = "BAD_REQUEST";
+    API_ERROR_TYPE["UNAUTHORIZED"] = "UNAUTHORIZED";
+    API_ERROR_TYPE["FORBIDDEN"] = "FORBIDDEN";
+    API_ERROR_TYPE["NOT_FOUND"] = "NOT_FOUND";
+    API_ERROR_TYPE["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+    API_ERROR_TYPE["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    API_ERROR_TYPE["CONFLICT"] = "CONFLICT";
+    API_ERROR_TYPE["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    API_ERROR_TYPE["NETWORK_ERROR"] = "NETWORK_ERROR";
+    API_ERROR_TYPE["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+})(API_ERROR_TYPE || (exports.API_ERROR_TYPE = API_ERROR_TYPE = {}));
+/**
+ * API Error helper class for client-side usage
+ */
+class ApiStandardError extends Error {
+    constructor(type, message, details) {
+        super(message);
+        this.type = type;
+        this.message = message;
+        this.details = details;
+        this.statusCode = this.getStatusCode(type);
+    }
+    getStatusCode(type) {
+        switch (type) {
+            case API_ERROR_TYPE.BAD_REQUEST:
+                return 400;
+            case API_ERROR_TYPE.UNAUTHORIZED:
+                return 401;
+            case API_ERROR_TYPE.FORBIDDEN:
+                return 403;
+            case API_ERROR_TYPE.NOT_FOUND:
+                return 404;
+            case API_ERROR_TYPE.CONFLICT:
+                return 409;
+            case API_ERROR_TYPE.RATE_LIMIT_EXCEEDED:
+                return 429;
+            case API_ERROR_TYPE.VALIDATION_ERROR:
+                return 422;
+            case API_ERROR_TYPE.NETWORK_ERROR:
+                return 0; // Network errors don't have HTTP status codes
+            case API_ERROR_TYPE.TIMEOUT_ERROR:
+                return 408;
+            case API_ERROR_TYPE.INTERNAL_SERVER_ERROR:
+            default:
+                return 500;
+        }
+    }
+}
+exports.ApiStandardError = ApiStandardError;
+//# sourceMappingURL=api-error.model.js.map