clawd-automaton 0.1.0

package/dist/clawd/convex-client.d.ts

@@ -0,0 +1,130 @@
+/**
+ * CLAWD Convex Client
+ *
+ * Lightweight HTTP client for the automaton to communicate with
+ * the CLAWD Convex backend for agent tracking, heartbeats, and
+ * key-value data storage.
+ *
+ * Uses the Convex HTTP actions defined in convex/clawd/http.ts.
+ * No external dependencies needed — just uses fetch.
+ */
+export interface ConvexClientOptions {
+    /** Base URL of the Convex deployment (e.g. https://giddy-dragon-7.convex.site) */
+    siteUrl: string;
+    /** Optional agent identifier */
+    agentId?: string;
+}
+/**
+ * Result of registering an agent.
+ */
+export interface RegisterResult {
+    registered: boolean;
+    agentId: string;
+    firstSeen: number;
+}
+/**
+ * Result of recording a heartbeat.
+ */
+export interface HeartbeatResult {
+    recorded: boolean;
+    timestamp: number;
+}
+/**
+ * Result of storing data.
+ */
+export interface DataResult {
+    stored: boolean;
+    key: string;
+    updatedAt: number;
+}
+/**
+ * Agent data entry returned from Convex.
+ */
+export interface AgentDataEntry {
+    _id: string;
+    agentId: string;
+    key: string;
+    value: string;
+    contentType?: string;
+    tags?: string[];
+    updatedAt: number;
+    _creationTime: number;
+}
+/**
+ * Agent info returned from Convex.
+ */
+export interface AgentInfo {
+    _id: string;
+    agentId: string;
+    name: string;
+    installMethod: string;
+    active: boolean;
+    firstSeen: number;
+    lastSeen: number;
+    metadata?: string;
+    address?: string;
+    source?: string;
+    tags?: string[];
+    latestHeartbeat?: {
+        state?: string;
+        creditsCents?: number;
+        uptimeSeconds?: number;
+        timestamp?: number;
+        tier?: string;
+    };
+}
+/**
+ * Creates a CLAWD Convex client for the automaton.
+ */
+export declare function createConvexClient(options: ConvexClientOptions): {
+    registerAgent: (params: {
+        agentId: string;
+        name: string;
+        installMethod?: string;
+        source?: string;
+        metadata?: string;
+        address?: string;
+        tags?: string[];
+    }) => Promise<RegisterResult>;
+    sendHeartbeat: (params: {
+        agentId: string;
+        state?: string;
+        creditsCents?: number;
+        usdcBalance?: number;
+        uptimeSeconds?: number;
+        version?: string;
+        sandboxId?: string;
+        turnCount?: number;
+        skillCount?: number;
+        tier?: string;
+        statusPayload?: Record<string, any>;
+    }) => Promise<HeartbeatResult>;
+    setData: (params: {
+        agentId: string;
+        key: string;
+        value: string;
+        contentType?: string;
+        tags?: string[];
+    }) => Promise<DataResult>;
+    getData: (params: {
+        agentId: string;
+        key: string;
+    }) => Promise<AgentDataEntry | null>;
+    listData: (params: {
+        agentId: string;
+    }) => Promise<Array<{
+        key: string;
+        contentType?: string;
+        tags?: string[];
+        updatedAt: number;
+        valuePreview: string;
+    }>>;
+    getAgent: (params: {
+        agentId: string;
+    }) => Promise<AgentInfo | null>;
+    listAgents: (params?: {
+        activeOnly?: boolean;
+    }) => Promise<AgentInfo[]>;
+};
+export type ConvexAgentClient = ReturnType<typeof createConvexClient>;
+//# sourceMappingURL=convex-client.d.ts.map

package/dist/clawd/convex-client.d.ts.map

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

package/dist/clawd/convex-client.js

@@ -0,0 +1,118 @@
+/**
+ * CLAWD Convex Client
+ *
+ * Lightweight HTTP client for the automaton to communicate with
+ * the CLAWD Convex backend for agent tracking, heartbeats, and
+ * key-value data storage.
+ *
+ * Uses the Convex HTTP actions defined in convex/clawd/http.ts.
+ * No external dependencies needed — just uses fetch.
+ */
+/**
+ * Creates a CLAWD Convex client for the automaton.
+ */
+export function createConvexClient(options) {
+    const baseUrl = options.siteUrl.replace(/\/$/, '');
+    const defaultAgentId = options.agentId;
+    /**
+     * Make an HTTP request to a CLAWD endpoint.
+     */
+    async function request(method, path, body) {
+        const url = `${baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (defaultAgentId) {
+            headers['X-Agent-Id'] = defaultAgentId;
+        }
+        const resp = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`Convex API error: ${method} ${path} -> ${resp.status}: ${text}`);
+        }
+        return resp.json();
+    }
+    /**
+     * Register / install an agent.
+     */
+    async function registerAgent(params) {
+        return request('POST', '/clawd/register', {
+            agentId: params.agentId,
+            name: params.name,
+            installMethod: params.installMethod || 'automaton',
+            source: params.source,
+            metadata: params.metadata,
+            address: params.address,
+            tags: params.tags,
+        });
+    }
+    /**
+     * Push a heartbeat.
+     */
+    async function sendHeartbeat(params) {
+        return request('POST', '/clawd/heartbeat', {
+            agentId: params.agentId,
+            state: params.state,
+            creditsCents: params.creditsCents,
+            usdcBalance: params.usdcBalance,
+            uptimeSeconds: params.uptimeSeconds,
+            version: params.version,
+            sandboxId: params.sandboxId,
+            turnCount: params.turnCount,
+            skillCount: params.skillCount,
+            tier: params.tier,
+            statusPayload: params.statusPayload,
+        });
+    }
+    /**
+     * Store key-value data for an agent.
+     */
+    async function setData(params) {
+        return request('POST', '/clawd/data', {
+            agentId: params.agentId,
+            key: params.key,
+            value: params.value,
+            contentType: params.contentType,
+            tags: params.tags,
+        });
+    }
+    /**
+     * Retrieve data for an agent by key.
+     */
+    async function getData(params) {
+        return request('GET', `/clawd/data?agentId=${encodeURIComponent(params.agentId)}&key=${encodeURIComponent(params.key)}`);
+    }
+    /**
+     * List all data keys for an agent.
+     */
+    async function listData(params) {
+        return request('GET', `/clawd/data/list?agentId=${encodeURIComponent(params.agentId)}`);
+    }
+    /**
+     * Get agent info + latest heartbeat.
+     */
+    async function getAgent(params) {
+        return request('GET', `/clawd/agent?agentId=${encodeURIComponent(params.agentId)}`);
+    }
+    /**
+     * List all agents (optionally only active ones).
+     */
+    async function listAgents(params) {
+        const activeParam = params?.activeOnly ? '?active=true' : '';
+        return request('GET', `/clawd/agents${activeParam}`);
+    }
+    return {
+        registerAgent,
+        sendHeartbeat,
+        setData,
+        getData,
+        listData,
+        getAgent,
+        listAgents,
+    };
+}
+//# sourceMappingURL=convex-client.js.map

package/dist/clawd/convex-client.js.map

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

package/dist/clawd/credits.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CLAWD Credits Management
+ *
+ * Monitors the automaton's compute credit balance and triggers
+ * survival mode transitions.
+ */
+import type { ClawdRuntimeClient, FinancialState, SurvivalTier, AutomatonDatabase } from "../types.js";
+/**
+ * Check the current financial state of the automaton.
+ */
+export declare function checkFinancialState(runtime: ClawdRuntimeClient, usdcBalance: number): Promise<FinancialState>;
+/**
+ * Determine the survival tier based on current credits.
+ */
+export declare function getSurvivalTier(creditsCents: number): SurvivalTier;
+/**
+ * Format a credit amount for display.
+ */
+export declare function formatCredits(cents: number): string;
+/**
+ * Log a credit check to the database.
+ */
+export declare function logCreditCheck(db: AutomatonDatabase, state: FinancialState): void;
+//# sourceMappingURL=credits.d.ts.map

package/dist/clawd/credits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../../src/clawd/credits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAMlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,cAAc,GACpB,IAAI,CASN"}

package/dist/clawd/credits.js

@@ -0,0 +1,64 @@
+/**
+ * CLAWD Credits Management
+ *
+ * Monitors the automaton's compute credit balance and triggers
+ * survival mode transitions.
+ */
+import { SURVIVAL_THRESHOLDS } from "../types.js";
+/**
+ * Check the current financial state of the automaton.
+ */
+export async function checkFinancialState(runtime, usdcBalance) {
+    const creditsCents = await runtime.getCreditsBalance();
+    return {
+        creditsCents,
+        usdcBalance,
+        lastChecked: new Date().toISOString(),
+    };
+}
+/**
+ * Determine the survival tier based on current credits.
+ */
+export function getSurvivalTier(creditsCents) {
+    if (creditsCents > SURVIVAL_THRESHOLDS.normal)
+        return "normal";
+    if (creditsCents > SURVIVAL_THRESHOLDS.low_compute)
+        return "low_compute";
+    if (creditsCents > SURVIVAL_THRESHOLDS.dead)
+        return "critical";
+    return "dead";
+}
+/**
+ * Format a credit amount for display.
+ */
+export function formatCredits(cents) {
+    return `$${(cents / 100).toFixed(2)}`;
+}
+/**
+ * Log a credit check to the database.
+ */
+export function logCreditCheck(db, state) {
+    const { ulid } = await_ulid();
+    db.insertTransaction({
+        id: ulid(),
+        type: "credit_check",
+        amountCents: state.creditsCents,
+        description: `Balance check: ${formatCredits(state.creditsCents)} credits, ${state.usdcBalance.toFixed(4)} USDC`,
+        timestamp: state.lastChecked,
+    });
+}
+// Lazy ulid import helper
+function await_ulid() {
+    // Dynamic import would be async; for synchronous usage in better-sqlite3
+    // we use a simple counter-based ID as fallback
+    let counter = 0;
+    return {
+        ulid: () => {
+            const timestamp = Date.now().toString(36);
+            const random = Math.random().toString(36).substring(2, 8);
+            counter++;
+            return `${timestamp}-${random}-${counter.toString(36)}`;
+        },
+    };
+}
+//# sourceMappingURL=credits.js.map

package/dist/clawd/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/clawd/credits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA2B,EAC3B,WAAmB;IAEnB,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAEvD,OAAO;QACL,YAAY;QACZ,WAAW;QACX,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,IAAI,YAAY,GAAG,mBAAmB,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC/D,IAAI,YAAY,GAAG,mBAAmB,CAAC,WAAW;QAChD,OAAO,aAAa,CAAC;IACvB,IAAI,YAAY,GAAG,mBAAmB,CAAC,IAAI;QAAE,OAAO,UAAU,CAAC;IAC/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,EAAqB,EACrB,KAAqB;IAErB,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;IAC9B,EAAE,CAAC,iBAAiB,CAAC;QACnB,EAAE,EAAE,IAAI,EAAE;QACV,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,KAAK,CAAC,YAAY;QAC/B,WAAW,EAAE,kBAAkB,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QAChH,SAAS,EAAE,KAAK,CAAC,WAAW;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,0BAA0B;AAC1B,SAAS,UAAU;IACjB,yEAAyE;IACzE,+CAA+C;IAC/C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1D,OAAO,EAAE,CAAC;YACV,OAAO,GAAG,SAAS,IAAI,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/clawd/deepseek-inference.d.ts

@@ -0,0 +1,40 @@
+/**
+ * DeepSeek Inference Client
+ *
+ * Implements the InferenceClient interface using DeepSeek's OpenAI-compatible API.
+ * Supports thinking mode via reasoning_effort and extra_body.
+ * Replaces CLAWD Runtime's default inference when using DeepSeek models.
+ */
+import type { InferenceClient } from "../types.js";
+export declare const DEEPSEEK_BASE_URL = "https://api.deepseek.com";
+export declare const DEEPSEEK_MODEL_PRO = "deepseek-v4-pro";
+export declare const DEEPSEEK_MODEL_FLASH = "deepseek-v4-flash";
+interface DeepSeekInferenceClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    maxTokens?: number;
+    flashModel?: string;
+    proModel?: string;
+}
+/**
+ * Create a DeepSeek inference client that conforms to the
+ * InferenceClient interface used throughout the automaton.
+ */
+export declare function createDeepSeekInferenceClient(options: DeepSeekInferenceClientOptions): InferenceClient;
+/**
+ * DeepSeek cost estimation in cents per million tokens.
+ */
+export declare const DEEPSEEK_PRICING: Record<string, {
+    input: number;
+    output: number;
+}>;
+/**
+ * Estimate cost in cents for a DeepSeek inference call.
+ */
+export declare function estimateDeepSeekCostCents(usage: {
+    promptTokens: number;
+    completionTokens: number;
+}, model: string): number;
+export {};
+//# sourceMappingURL=deepseek-inference.d.ts.map

package/dist/clawd/deepseek-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseek-inference.d.ts","sourceRoot":"","sources":["../../src/clawd/deepseek-inference.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EAOhB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAC5D,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AACpD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,UAAU,8BAA8B;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,eAAe,CA6HjB;AAoBD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAG9E,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EACzD,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR"}

package/dist/clawd/deepseek-inference.js

@@ -0,0 +1,143 @@
+/**
+ * DeepSeek Inference Client
+ *
+ * Implements the InferenceClient interface using DeepSeek's OpenAI-compatible API.
+ * Supports thinking mode via reasoning_effort and extra_body.
+ * Replaces CLAWD Runtime's default inference when using DeepSeek models.
+ */
+export const DEEPSEEK_BASE_URL = "https://api.deepseek.com";
+export const DEEPSEEK_MODEL_PRO = "deepseek-v4-pro";
+export const DEEPSEEK_MODEL_FLASH = "deepseek-v4-flash";
+/**
+ * Create a DeepSeek inference client that conforms to the
+ * InferenceClient interface used throughout the automaton.
+ */
+export function createDeepSeekInferenceClient(options) {
+    const { apiKey, baseUrl = DEEPSEEK_BASE_URL, defaultModel = DEEPSEEK_MODEL_PRO, maxTokens: defaultMaxTokens = 4096, flashModel = DEEPSEEK_MODEL_FLASH, proModel = DEEPSEEK_MODEL_PRO, } = options;
+    let currentModel = defaultModel;
+    let maxTokens = defaultMaxTokens;
+    let lowCompute = false;
+    const chat = async (messages, opts) => {
+        const model = opts?.model || currentModel;
+        const tokenLimit = opts?.maxTokens || maxTokens;
+        const body = {
+            model,
+            messages: messages.map(formatMessage),
+            max_tokens: tokenLimit,
+            stream: false,
+        };
+        if (opts?.temperature !== undefined) {
+            body.temperature = opts.temperature;
+        }
+        const tools = opts?.tools;
+        if (tools && tools.length > 0) {
+            body.tools = tools;
+            body.tool_choice = "auto";
+        }
+        // DeepSeek thinking mode: enable reasoning with high effort
+        body.reasoning_effort = "high";
+        body.extra_body = { thinking: { type: "enabled" } };
+        const resp = await fetch(`${baseUrl}/v1/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`DeepSeek inference error: ${resp.status}: ${text}`);
+        }
+        const data = (await resp.json());
+        const choice = data.choices?.[0];
+        if (!choice) {
+            throw new Error("No completion choice returned from DeepSeek inference");
+        }
+        const message = choice.message;
+        const usage = {
+            promptTokens: data.usage?.prompt_tokens || 0,
+            completionTokens: data.usage?.completion_tokens || 0,
+            totalTokens: data.usage?.total_tokens || 0,
+        };
+        // Extract reasoning_content if available (DeepSeek thinking mode)
+        const reasoningContent = message.reasoning_content || "";
+        const toolCalls = message.tool_calls?.map((tc) => ({
+            id: tc.id,
+            type: "function",
+            function: {
+                name: tc.function.name,
+                arguments: tc.function.arguments,
+            },
+        }));
+        // Prepend reasoning content to the message if present
+        let content = message.content || "";
+        if (reasoningContent) {
+            content = `[Thinking]\n${reasoningContent}\n\n[Response]\n${content}`;
+        }
+        return {
+            id: data.id || "",
+            model: data.model || model,
+            message: {
+                role: message.role,
+                content,
+                tool_calls: toolCalls,
+            },
+            toolCalls,
+            usage,
+            finishReason: choice.finish_reason || "stop",
+        };
+    };
+    const setLowComputeMode = (enabled) => {
+        lowCompute = enabled;
+        if (enabled) {
+            currentModel = flashModel;
+            maxTokens = 2048;
+        }
+        else {
+            currentModel = defaultModel;
+            maxTokens = defaultMaxTokens;
+        }
+    };
+    const getDefaultModel = () => {
+        return currentModel;
+    };
+    return {
+        chat,
+        setLowComputeMode,
+        getDefaultModel,
+    };
+}
+/**
+ * Format a ChatMessage to the DeepSeek/OpenAI API format.
+ */
+function formatMessage(msg) {
+    const formatted = {
+        role: msg.role,
+        content: msg.content,
+    };
+    if (msg.name)
+        formatted.name = msg.name;
+    if (msg.tool_calls)
+        formatted.tool_calls = msg.tool_calls;
+    if (msg.tool_call_id)
+        formatted.tool_call_id = msg.tool_call_id;
+    return formatted;
+}
+/**
+ * DeepSeek cost estimation in cents per million tokens.
+ */
+export const DEEPSEEK_PRICING = {
+    "deepseek-v4-pro": { input: 200, output: 800 },
+    "deepseek-v4-flash": { input: 15, output: 60 },
+};
+/**
+ * Estimate cost in cents for a DeepSeek inference call.
+ */
+export function estimateDeepSeekCostCents(usage, model) {
+    const p = DEEPSEEK_PRICING[model] || DEEPSEEK_PRICING["deepseek-v4-pro"];
+    const inputCost = (usage.promptTokens / 1_000_000) * p.input;
+    const outputCost = (usage.completionTokens / 1_000_000) * p.output;
+    return Math.ceil(inputCost + outputCost);
+}
+//# sourceMappingURL=deepseek-inference.js.map

package/dist/clawd/deepseek-inference.js.map

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

package/dist/clawd/inference.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLAWD Inference Client
+ *
+ * Wraps CLAWD Runtime's /v1/chat/completions endpoint (OpenAI-compatible).
+ * The automaton pays for its own thinking through CLAWD credits.
+ */
+import type { InferenceClient } from "../types.js";
+interface InferenceClientOptions {
+    apiUrl: string;
+    apiKey: string;
+    defaultModel: string;
+    maxTokens: number;
+    lowComputeModel?: string;
+}
+export declare function createInferenceClient(options: InferenceClientOptions): InferenceClient;
+export {};
+//# sourceMappingURL=inference.d.ts.map

package/dist/clawd/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/clawd/inference.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EAOhB,MAAM,aAAa,CAAC;AAErB,UAAU,sBAAsB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAkHjB"}