@o-lang/llm-groq 1.0.4 → 1.0.5

package/README.md

@@ -0,0 +1,14 @@
+# @o-lang/llm-groq
+
+O-Lang resolver for Groq LLM API
+
+## Requirements
+- `GROQ_API_KEY` environment variable
+
+## Usage
+```yaml
+Allow resolvers:
+- llm-groq
+
+Step 1: Ask llm-groq "What is the capital of France?"
+Save as response

package/badges/llm-groq-badge.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="346" height="20">
+  <!-- Left segment: O-lang (purple) -->
+  <rect x="0" y="0" width="54" height="20" fill="#8A2BE2" rx="3" ry="3"/>
+  <text x="27" y="14"
+        fill="#fff"
+        font-family="Verdana, DejaVu Sans, sans-serif"
+        font-size="11"
+        font-weight="bold"
+        text-anchor="middle">
+    O-lang
+  </text>
+
+  <!-- Right segment: status info (green/red) -->
+  <rect x="54" y="0" width="292" height="20" fill="#4CAF50" rx="3" ry="3"/>
+  <text x="200" y="14"
+        fill="#fff"
+        font-family="Verdana, DejaVu Sans, sans-serif"
+        font-size="11"
+        text-anchor="middle">
+    llm-groq v1.0.5 — Certified (2026-02-02)
+  </text>
+</svg>

package/capability.js

@@ -0,0 +1,37 @@
+// resolver-llm-groq/capability.js
+const Groq = require('groq-sdk');
+
+// Initialize client once
+let groqClient = null;
+try {
+  require('dotenv').config();
+  const GROQ_API_KEY = process.env.GROQ_API_KEY;
+  if (GROQ_API_KEY) {
+    groqClient = new Groq({ apiKey: GROQ_API_KEY });
+  }
+} catch (e) {
+  // Silent fail - handled by caller
+}
+
+/**
+ * Pure LLM execution function
+ * @param {string} prompt - Clean prompt without unresolved placeholders
+ * @returns {Promise<string>} LLM response
+ */
+async function executeLLM(prompt) {
+  if (!groqClient) {
+    throw new Error("MISSING_API_KEY");
+  }
+
+  const response = await groqClient.chat.completions.create({
+    messages: [{ role: 'user', content: prompt }],
+    model: 'llama-3.1-8b-instant',
+    temperature: 0.3,
+    max_tokens: 250,
+    top_p: 0.9
+  });
+
+  return response.choices[0].message.content.trim();
+}
+
+module.exports = executeLLM;

package/conformance.json

@@ -0,0 +1,42 @@
+{
+  "resolver": "llm-groq",
+  "timestamp": "2026-02-02T13:21:31.867Z",
+  "results": [
+    {
+      "suite": "R-005-resolver-metadata-contract",
+      "status": "pass"
+    },
+    {
+      "suite": "R-006-resolver-runtime-shape",
+      "status": "pass"
+    },
+    {
+      "suite": "R-007-resolver-failure-contract",
+      "status": "pass"
+    },
+    {
+      "suite": "R-008-resolver-input-validation",
+      "status": "pass"
+    },
+    {
+      "suite": "R-009-resolver-retry-semantics",
+      "status": "pass"
+    },
+    {
+      "suite": "R-010-resolver-output-contract",
+      "status": "pass"
+    },
+    {
+      "suite": "R-011-resolver-determinism",
+      "status": "pass"
+    },
+    {
+      "suite": "R-012-resolver-side-effects",
+      "status": "pass"
+    },
+    {
+      "suite": "R-013-resolver-kernel-bypass",
+      "status": "pass"
+    }
+  ]
+}

package/index.js

@@ -1,80 +1,64 @@
-// @o-lang/llm-groq
-try { require('dotenv').config(); } catch {}
-
-const Groq = require('groq-sdk');
-const GROQ_API_KEY = process.env.GROQ_API_KEY;
-const groq = GROQ_API_KEY ? new Groq({ apiKey: GROQ_API_KEY }) : null;
+// resolver-llm-groq/index.js
+const capability = require('./capability');
+const declaration = require('./resolver');
 
 /**
- * Process any prompt using Groq LLM
+ * O-Lang Resolver Entry Point
+ * Handles validation, error wrapping, and kernel compliance
  */
-async function processPrompt(prompt, context) {
-  if (!groq) {
-    throw new Error('GROQ_API_KEY is required but not set');
+module.exports = async (input, context = {}) => {
+  // Handle empty input (R-008 compliance)
+  if (!input || (typeof input === 'object' && Object.keys(input).length === 0)) {
+    return { error: "INVALID_INPUT" };
   }
 
-  // Replace any leftover {placeholders} in prompt
-  prompt = prompt.replace(/\{([^\}]+)\}/g, (_, k) => {
-    const v = context[k.trim()];
-    if (v === undefined) {
-      return `{${k}}`;
-    }
-    // ✅ CRITICAL: Convert objects/arrays to JSON strings for proper LLM consumption
-    if (typeof v === 'object') {
-      return JSON.stringify(v);
-    }
-    return String(v);
-  });
+  // Extract action string
+  const action = typeof input === 'string' 
+    ? input 
+    : (typeof input === 'object' && typeof input.action === 'string' 
+        ? input.action 
+        : '');
 
-  if (context?.__verbose) {
-    console.log('📨 [GroqLLM] Sending prompt:\n', prompt);
+  // Must be an Ask action
+  if (!action || !action.startsWith('Ask llm-groq ')) {
+    return undefined; // Not our action
   }
 
-  const response = await groq.chat.completions.create({
-    messages: [{ role: 'user', content: prompt }],
-    model: 'llama-3.1-8b-instant',
-    temperature: 0.3,
-    max_tokens: 250,
-    top_p: 0.9
-  });
-
-  const output = response.choices[0].message.content.trim();
-
-  if (context?.__verbose) {
-    console.log('📬 [GroqLLM] Response:\n', output);
+  // Extract clean prompt
+  const promptMatch = action.match(/^Ask\s+llm-groq\s+(.+)$/i);
+  if (!promptMatch) {
+    return { error: "INVALID_INPUT" };
   }
 
-  return output;
-}
+  let cleanPrompt = promptMatch[1].trim();
+  // Remove surrounding quotes if present
+  if (cleanPrompt.startsWith('"') && cleanPrompt.endsWith('"')) {
+    cleanPrompt = cleanPrompt.slice(1, -1);
+  }
 
-// ✅ O-Lang Resolver Interface
-module.exports = async (action, context) => {
-  // Handle: "Ask llm-groq ..."
-  if (action.startsWith('Ask llm-groq ')) {
-    // Extract everything after "Ask llm-groq" (including quoted strings)
-    const prompt = action.replace(/^Ask\s+llm-groq\s+/i, '').trim();
-    
-    // Remove surrounding quotes if present
-    const cleanPrompt = prompt.startsWith('"') && prompt.endsWith('"')
-      ? prompt.slice(1, -1)
-      : prompt;
+  if (!cleanPrompt) {
+    return { error: "INVALID_INPUT" };
+  }
 
-    if (!cleanPrompt) {
-      return undefined;
-    }
+  // ✅ CRITICAL: Block unresolved placeholders
+  if (/{[^}]+}/.test(cleanPrompt)) {
+    return { error: "UNRESOLVED_VARIABLES" };
+  }
 
-    try {
-      return await processPrompt(cleanPrompt, context);
-    } catch (error) {
-      if (context?.__verbose) {
-        console.error('💥 [GroqLLM] Error:', error.message);
-      }
-      throw error;
+  try {
+    const response = await capability(cleanPrompt);
+    return { output: { response } };
+  } catch (err) {
+    if (err.message === "MISSING_API_KEY") {
+      return { error: "MISSING_API_KEY" };
     }
+    return { error: "LLM_ERROR" };
   }
-
-  return undefined;
 };
 
-// ✅ Required for O-Lang allowlist policy
-module.exports.resolverName = 'llm-groq';
+// Attach metadata
+module.exports.resolverName = declaration.resolverName;
+module.exports.version = declaration.version;
+module.exports.resolverDeclaration = declaration;
+module.exports.deterministic = declaration.properties.deterministic;
+module.exports.sideEffects = declaration.properties.sideEffects;

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@o-lang/llm-groq",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "O-Lang resolver for Groq (Llama 3.1) LLM",
   "main": "index.js",
-  "scripts": {},
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
   "keywords": [
-    "olang",
+    "o-lang",
     "groq",
     "llm",
     "resolver",
@@ -13,7 +15,7 @@
     "agent",
     "governance"
   ],
-  "author": "O-lang team <info@workfily.com.com>",
+  "author": "O-lang team <info@workfily.com>",
   "license": "MIT",
   "repository": {
     "type": "git",

package/resolver.js

@@ -0,0 +1,42 @@
+// resolver-llm-groq/resolver.js
+module.exports = {
+  resolverName: "llm-groq",
+  version: "1.0.5",
+  specVersion: "O-Lang/1.1",
+
+  inputs: [
+    {
+      name: "action",
+      type: "string",
+      required: true,
+      description: "O-Lang action string (e.g., 'Ask llm-groq \"prompt\"')"
+    },
+    {
+      name: "context",
+      type: "object",
+      required: false,
+      description: "Execution context with interpolated variables"
+    }
+  ],
+
+  outputs: [
+    {
+      name: "response",
+      type: "string"
+    }
+  ],
+
+  exampleAction: 'Ask llm-groq "What is 2+2?"',
+
+  failures: [
+    { code: "MISSING_API_KEY", retries: 0 },
+    { code: "LLM_ERROR", retries: 1 },
+    { code: "UNRESOLVED_VARIABLES", retries: 0 }
+  ],
+
+  properties: {
+    handlesTemplatedPrompts: true,  // ✅ NEW: Enables R-013 testing
+    deterministic: false,
+    sideEffects: true
+  }
+};

package/npmignore

@@ -1,7 +0,0 @@
-.env
-.env.keys
-.env.vault
-.env.example
-node_modules/
-*.md
-.git