cognitive-modules 0.6.0

package/dist/providers/openai.js

@@ -0,0 +1,67 @@
+/**
+ * OpenAI Provider - OpenAI API (and compatible APIs)
+ */
+import { BaseProvider } from './base.js';
+export class OpenAIProvider extends BaseProvider {
+    name = 'openai';
+    apiKey;
+    model;
+    baseUrl;
+    constructor(apiKey, model = 'gpt-5.2', baseUrl = 'https://api.openai.com/v1') {
+        super();
+        this.apiKey = apiKey || process.env.OPENAI_API_KEY || '';
+        this.model = model;
+        this.baseUrl = baseUrl;
+    }
+    isConfigured() {
+        return !!this.apiKey;
+    }
+    async invoke(params) {
+        if (!this.isConfigured()) {
+            throw new Error('OpenAI API key not configured. Set OPENAI_API_KEY environment variable.');
+        }
+        const url = `${this.baseUrl}/chat/completions`;
+        const body = {
+            model: this.model,
+            messages: params.messages,
+            temperature: params.temperature ?? 0.7,
+            max_tokens: params.maxTokens ?? 4096,
+        };
+        // Add JSON mode if schema provided
+        if (params.jsonSchema) {
+            body.response_format = { type: 'json_object' };
+            // Append schema instruction to last user message
+            const lastUserIdx = params.messages.findLastIndex(m => m.role === 'user');
+            if (lastUserIdx >= 0) {
+                const messages = [...params.messages];
+                messages[lastUserIdx] = {
+                    ...messages[lastUserIdx],
+                    content: messages[lastUserIdx].content + this.buildJsonPrompt(params.jsonSchema),
+                };
+                body.messages = messages;
+            }
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        const content = data.choices?.[0]?.message?.content || '';
+        return {
+            content,
+            usage: data.usage ? {
+                promptTokens: data.usage.prompt_tokens || 0,
+                completionTokens: data.usage.completion_tokens || 0,
+                totalTokens: data.usage.total_tokens || 0,
+            } : undefined,
+        };
+    }
+}

package/dist/providers/qwen.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Qwen Provider - Alibaba Tongyi Qianwen (通义千问) via DashScope API
+ */
+import { BaseProvider } from './base.js';
+import type { InvokeParams, InvokeResult } from '../types.js';
+export declare class QwenProvider extends BaseProvider {
+    name: string;
+    private apiKey;
+    private model;
+    private baseUrl;
+    constructor(apiKey?: string, model?: string);
+    isConfigured(): boolean;
+    invoke(params: InvokeParams): Promise<InvokeResult>;
+}

package/dist/providers/qwen.js

@@ -0,0 +1,65 @@
+/**
+ * Qwen Provider - Alibaba Tongyi Qianwen (通义千问) via DashScope API
+ */
+import { BaseProvider } from './base.js';
+export class QwenProvider extends BaseProvider {
+    name = 'qwen';
+    apiKey;
+    model;
+    baseUrl = 'https://dashscope.aliyuncs.com/compatible-mode/v1';
+    constructor(apiKey, model = 'qwen3-max') {
+        super();
+        this.apiKey = apiKey || process.env.DASHSCOPE_API_KEY || process.env.QWEN_API_KEY || '';
+        this.model = model;
+    }
+    isConfigured() {
+        return !!this.apiKey;
+    }
+    async invoke(params) {
+        if (!this.isConfigured()) {
+            throw new Error('Qwen API key not configured. Set DASHSCOPE_API_KEY or QWEN_API_KEY environment variable.');
+        }
+        const url = `${this.baseUrl}/chat/completions`;
+        const body = {
+            model: this.model,
+            messages: params.messages.map(m => ({ role: m.role, content: m.content })),
+            temperature: params.temperature ?? 0.7,
+            max_tokens: params.maxTokens ?? 4096,
+        };
+        // Add JSON mode if schema provided
+        if (params.jsonSchema) {
+            body.response_format = { type: 'json_object' };
+            const lastUserIdx = params.messages.findLastIndex(m => m.role === 'user');
+            if (lastUserIdx >= 0) {
+                const messages = [...params.messages];
+                messages[lastUserIdx] = {
+                    ...messages[lastUserIdx],
+                    content: messages[lastUserIdx].content + this.buildJsonPrompt(params.jsonSchema),
+                };
+                body.messages = messages.map(m => ({ role: m.role, content: m.content }));
+            }
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Qwen API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        const content = data.choices?.[0]?.message?.content || '';
+        return {
+            content,
+            usage: data.usage ? {
+                promptTokens: data.usage.prompt_tokens || 0,
+                completionTokens: data.usage.completion_tokens || 0,
+                totalTokens: data.usage.total_tokens || 0,
+            } : undefined,
+        };
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Cognitive Runtime - Core Types
+ * Version 2.1 - With envelope format, tools policy, failure contract
+ */
+export interface Provider {
+    name: string;
+    invoke(params: InvokeParams): Promise<InvokeResult>;
+    isConfigured(): boolean;
+}
+export interface InvokeParams {
+    messages: Message[];
+    jsonSchema?: object;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface Message {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface InvokeResult {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export interface CognitiveModule {
+    name: string;
+    version: string;
+    responsibility: string;
+    excludes: string[];
+    constraints?: ModuleConstraints;
+    policies?: ModulePolicies;
+    tools?: ToolsPolicy;
+    output?: OutputContract;
+    failure?: FailureContract;
+    runtimeRequirements?: RuntimeRequirements;
+    context?: 'fork' | 'main';
+    prompt: string;
+    inputSchema?: object;
+    outputSchema?: object;
+    errorSchema?: object;
+    location: string;
+    format: 'v1' | 'v2';
+}
+export interface ModuleConstraints {
+    no_network?: boolean;
+    no_side_effects?: boolean;
+    no_file_write?: boolean;
+    no_inventing_data?: boolean;
+    behavior_equivalence_false_max_confidence?: number;
+}
+export interface ModulePolicies {
+    network?: 'allow' | 'deny';
+    filesystem_write?: 'allow' | 'deny';
+    side_effects?: 'allow' | 'deny';
+    code_execution?: 'allow' | 'deny';
+}
+export interface ToolsPolicy {
+    policy?: 'allow_by_default' | 'deny_by_default';
+    allowed: string[];
+    denied?: string[];
+}
+export interface OutputContract {
+    format?: 'json_strict' | 'json_lenient' | 'text';
+    envelope?: boolean;
+    require?: string[];
+    require_confidence?: boolean;
+    require_rationale?: boolean;
+    require_behavior_equivalence?: boolean;
+}
+export interface FailureContract {
+    contract?: 'error_union' | 'throw';
+    partial_allowed?: boolean;
+    must_return_error_schema?: boolean;
+    schema?: object;
+}
+export interface RuntimeRequirements {
+    structured_output?: boolean;
+    max_input_tokens?: number;
+    preferred_capabilities?: string[];
+}
+export interface EnvelopeSuccess<T = unknown> {
+    ok: true;
+    data: T;
+}
+export interface EnvelopeError {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+    partial_data?: unknown;
+}
+export type EnvelopeResponse<T = unknown> = EnvelopeSuccess<T> | EnvelopeError;
+export interface ModuleResultData {
+    [key: string]: unknown;
+    confidence: number;
+    rationale: string;
+    behavior_equivalence?: boolean;
+}
+export interface ModuleResult {
+    ok: boolean;
+    data?: ModuleResultData;
+    error?: {
+        code: string;
+        message: string;
+    };
+    partial_data?: unknown;
+    raw?: string;
+}
+export interface LegacyModuleResult {
+    output: unknown;
+    confidence: number;
+    rationale: string;
+    behaviorEquivalence?: boolean;
+    raw?: string;
+}
+export interface CommandContext {
+    cwd: string;
+    provider: Provider;
+    verbose?: boolean;
+}
+export interface CommandResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export interface ModuleInput {
+    code?: string;
+    query?: string;
+    language?: string;
+    options?: Record<string, unknown>;
+    [key: string]: unknown;
+}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Cognitive Runtime - Core Types
+ * Version 2.1 - With envelope format, tools policy, failure contract
+ */
+export {};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "cognitive-modules",
+  "version": "0.6.0",
+  "description": "Cognitive Modules - Structured AI Task Execution with version management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "cog": "dist/cli.js",
+    "cognitive": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cognitive",
+    "ai",
+    "llm",
+    "structured",
+    "modules",
+    "cli",
+    "npx"
+  ],
+  "license": "MIT",
+  "author": "ziel-io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ziel-io/cognitive-modules.git"
+  },
+  "homepage": "https://ziel-io.github.io/cognitive-modules/",
+  "bugs": {
+    "url": "https://github.com/ziel-io/cognitive-modules/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.1"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}