decisionmemos 1.1.0

package/dist/src/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Core types for the multi-model decision framework
+ */
+export interface ModelConfig {
+    name: string;
+    provider: 'openai' | 'xai' | 'anthropic' | 'google';
+    model: string;
+    apiKey: string;
+    enabled: boolean;
+}
+export interface DecisionContext {
+    projectBrief: string;
+    constraints: string;
+    examples: string;
+    specificContext?: string;
+    /** Compiled context from the dynamic briefing intake */
+    briefingContext?: string;
+}
+export interface DecisionCriteria {
+    name: string;
+    description: string;
+}
+export interface DecisionQuery {
+    question: string;
+    context: DecisionContext;
+    criteria: DecisionCriteria[];
+    category?: string;
+    /** Optional localisation hints derived from the request (OS, locale, timezone). */
+    hiddenContext?: HiddenPromptContext;
+}
+export interface ModelResponse {
+    modelName: string;
+    provider: string;
+    response: string;
+    timestamp: Date;
+    tokensUsed?: number;
+    latency: number;
+    error?: string;
+    /** Persona title (e.g. "The Strategist") — set by the aggregator */
+    persona?: string;
+}
+export interface ConsensusAnalysis {
+    agreements: string[];
+    divergences: {
+        aspect: string;
+        positions: Record<string, string>;
+    }[];
+    uniqueInsights: Record<string, string[]>;
+}
+export type ConsensusLevel = 'strong' | 'moderate' | 'weak';
+export interface DecisionRecommendation {
+    decision: string;
+    rationale: string;
+    consensusLevel: ConsensusLevel;
+    tradeoffs: string[];
+    implementation: string[];
+    risks: string[];
+}
+export interface ComparisonMatrix {
+    query: DecisionQuery;
+    responses: ModelResponse[];
+    consensus: ConsensusAnalysis;
+    recommendation: DecisionRecommendation;
+    timestamp: Date;
+}
+export interface DecisionMemo {
+    /** Short title derived from the question */
+    title: string;
+    /** The original question asked */
+    question: string;
+    /** The panel's synthesised verdict */
+    verdict: {
+        decision: string;
+        rationale: string;
+        consensusLevel: ConsensusLevel;
+        /** Human-readable consensus string, e.g. "The panel is united." */
+        consensusDisplay: string;
+    };
+    /** Individual advisor perspectives, labelled by archetype title */
+    perspectives: {
+        advisor: string;
+        /** e.g. "strategist", "analyst", "challenger", "architect" */
+        advisorId: string;
+        response: string;
+        latency: number;
+        tokensUsed?: number;
+    }[];
+    /** Points all advisors agree on */
+    agreements: string[];
+    /** Areas where advisors disagree */
+    divergences: {
+        aspect: string;
+        positions: {
+            [advisor: string]: string;
+        };
+    }[];
+    /** Identified trade-offs */
+    tradeoffs: string[];
+    /** Identified risks and mitigations */
+    risks: string[];
+    /** Concrete next steps */
+    implementationSteps: string[];
+    /** Metadata for transparency and cost tracking */
+    metadata: {
+        timestamp: string;
+        totalLatency: number;
+        advisorLatencies: {
+            advisor: string;
+            latency: number;
+        }[];
+        modelsUsed: {
+            advisor: string;
+            provider: string;
+            model: string;
+        }[];
+        estimatedCost?: number;
+        mode: 'standard' | 'deep';
+    };
+}
+export interface HiddenPromptContext {
+    /** Client IP (consider redacting or omitting in logs; useful for regional tailoring) */
+    clientIp?: string;
+    /** Inferred OS from User-Agent (e.g. Windows, macOS, Linux, iOS, Android) */
+    inferredOs?: string;
+    /** Inferred browser from User-Agent (e.g. Chrome, Safari, Firefox) */
+    inferredBrowser?: string;
+    /** Raw Accept-Language header (e.g. "en-US,en;q=0.9") */
+    acceptLanguage?: string;
+    /** Primary locale hint (e.g. "en-US") derived from Accept-Language */
+    inferredLocale?: string;
+    /** Client-reported timezone (e.g. "America/New_York") if sent via header or body */
+    timezone?: string;
+    /** Referer URL if present (can indicate in-app vs external) */
+    referer?: string;
+    /** Request ID for tracing (already in use elsewhere) */
+    requestId?: string;
+    /** ISO 3166-1 alpha-2 country code from IP geolocation (e.g. "AU") */
+    geoCountry?: string;
+    /** Full country name resolved from geoCountry (e.g. "Australia") */
+    geoCountryName?: string;
+    /** Region / state from IP geolocation (e.g. "New South Wales") */
+    geoRegion?: string;
+    /** City from IP geolocation (e.g. "Sydney") */
+    geoCity?: string;
+    /** Timezone from IP geolocation (e.g. "Australia/Sydney") */
+    geoTimezone?: string;
+    /** Whether the IP is located in an EU member state */
+    geoIsEU?: boolean;
+}
+export interface DecisionBrief {
+    /** Structured situational context: what, who, domain, stakes */
+    projectBrief: string;
+    /** Extracted constraints: timeline, budget, team, risk, dependencies */
+    constraints: string;
+    /** Inferred decision framework: type, dimensions, success criteria */
+    decisionFramework: string;
+    /** The original question rewritten for maximum clarity (same intent, better structure) */
+    reengineeredQuestion: string;
+}
+export interface BriefingQuestion {
+    id: string;
+    prompt: string;
+    options: {
+        id: string;
+        label: string;
+    }[];
+    allowMultiple: boolean;
+}
+export interface BriefingAnswers {
+    [questionId: string]: string[];
+}
+export interface DecisionLog {
+    id: string;
+    category: string;
+    query: DecisionQuery;
+    matrix: ComparisonMatrix;
+    memo?: DecisionMemo;
+    finalDecision: string;
+    decisionMaker: 'ai' | 'chairman';
+    implementationStatus: 'pending' | 'in-progress' | 'completed';
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for the multi-model decision framework
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "decisionmemos",
+  "version": "1.1.0",
+  "description": "Query multiple AI models in parallel — GPT, Claude, Grok, and Gemini in one call. Typed responses, zero boilerplate.",
+  "private": false,
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist/src/index.*",
+    "dist/src/multi-model-query.*",
+    "dist/src/types.*",
+    "dist/src/clients/**/*",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "consultation": "tsx bin/run-consultation.ts",
+    "generate-examples": "tsx scripts/generate-example-consultations.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "ai",
+    "multi-model",
+    "decisionmemos",
+    "decision-support",
+    "ai-consultation",
+    "consensus",
+    "advisory-panel",
+    "gpt",
+    "claude",
+    "grok",
+    "gemini",
+    "openai",
+    "anthropic",
+    "structured-output"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/decisionmemos/decisionmemos"
+  },
+  "homepage": "https://decisionmemos.com",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.72.1",
+    "@google/generative-ai": "^0.24.1",
+    "dotenv": "^16.4.7",
+    "openai": "^6.17.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}