@saccolabs/tars 1.20.2 → 1.22.0

package/dist/utils/endpoint-probe.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Result of probing a local inference endpoint.
+ */
+export interface EndpointProbeResult {
+    reachable: boolean;
+    models: string[];
+    error?: string;
+}
+/**
+ * Model info returned from the /v1/models endpoint.
+ */
+export interface LocalModelInfo {
+    id: string;
+    object?: string;
+    owned_by?: string;
+}
+/**
+ * Probes a local inference endpoint by checking /v1/models and optionally
+ * the /v1/chat/completions health endpoint.
+ *
+ * @param baseUrl - The base URL of the OpenAI-compatible endpoint
+ * @param timeoutMs - Timeout in milliseconds (default: 5000)
+ * @returns Probe result with reachability and available models
+ */
+export declare function probeEndpoint(baseUrl: string, timeoutMs?: number): Promise<EndpointProbeResult>;

package/dist/utils/endpoint-probe.js

@@ -0,0 +1,80 @@
+/**
+ * Probes a local inference endpoint by checking /v1/models and optionally
+ * the /v1/chat/completions health endpoint.
+ *
+ * @param baseUrl - The base URL of the OpenAI-compatible endpoint
+ * @param timeoutMs - Timeout in milliseconds (default: 5000)
+ * @returns Probe result with reachability and available models
+ */
+export async function probeEndpoint(baseUrl, timeoutMs = 5000) {
+    const normalizedUrl = baseUrl.replace(/\/+$/, '');
+    // Try /v1/models first
+    try {
+        const modelsUrl = normalizedUrl.endsWith('/v1')
+            ? `${normalizedUrl}/models`
+            : `${normalizedUrl}/v1/models`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await fetch(modelsUrl, {
+                method: 'GET',
+                signal: controller.signal
+            });
+            clearTimeout(timeout);
+            if (response.ok) {
+                const data = (await response.json());
+                const models = [];
+                if (data.data && Array.isArray(data.data)) {
+                    for (const model of data.data) {
+                        if (model.id) {
+                            models.push(model.id);
+                        }
+                    }
+                }
+                return { reachable: true, models };
+            }
+            // Server reachable but /v1/models not supported — still valid
+            return { reachable: true, models: [] };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    catch (error) {
+        // If /v1/models failed, try a simpler connectivity check
+        try {
+            const healthUrl = normalizedUrl.endsWith('/v1')
+                ? normalizedUrl.replace(/\/v1$/, '/health')
+                : `${normalizedUrl}/health`;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const response = await fetch(healthUrl, {
+                    method: 'GET',
+                    signal: controller.signal
+                });
+                clearTimeout(timeout);
+                if (response.ok) {
+                    return { reachable: true, models: [] };
+                }
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch {
+            // Both /v1/models and /health failed
+        }
+        const errorMessage = error.cause?.code === 'ECONNREFUSED'
+            ? `Connection refused at ${normalizedUrl}`
+            : error.name === 'AbortError'
+                ? `Connection timed out after ${timeoutMs}ms`
+                : error.message || 'Unknown error';
+        return {
+            reachable: false,
+            models: [],
+            error: errorMessage
+        };
+    }
+}
+//# sourceMappingURL=endpoint-probe.js.map

package/dist/utils/endpoint-probe.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@saccolabs/tars",
-    "version": "1.20.2",
+    "version": "1.22.0",
     "description": "Tars — Your personal AI assistant",
     "publishConfig": {
         "access": "public"

package/src/prompts/system.md

@@ -3,6 +3,10 @@
 - **Assistant Name**: {{ASSISTANT_NAME}}
 - **Instance ID**: {{INSTANCE_NAME}}
 - **Designated Role**: {{INSTANCE_ROLE}}
+- **Inference Backend**: {{INFERENCE_BACKEND}}
+- **Model**: {{MODEL_NAME}}
+- **Context Window**: {{CONTEXT_WINDOW}} tokens
+- **Inference Endpoint**: {{INFERENCE_ENDPOINT}}
 
 You are **{{ASSISTANT_NAME}}**, a personal AI assistant. You are autonomous, proactive, and capable of self-improvement. You serve one user as a trusted generalist across all domains.