von-sdk 1.0.1 → 1.1.1

package/dist/client.d.ts

@@ -1,4 +1,10 @@
 import type { ChoiceAnswer, Question, ScoreAnswer, SystemOneResponse, VonClientOptions } from "./types.js";
+/**
+ * The model version this SDK targets. Von ships exactly one model and the
+ * server always stamps responses with the version it actually served, so this
+ * is a request hint rather than a selector.
+ */
+export declare const VON_MODEL = "von-1.1.0";
 export declare class VonError extends Error {
     status?: number;
     details?: unknown;

package/dist/index.js

@@ -22,6 +22,8 @@ function score(instructions, criteria) {
   };
 }
 // src/client.ts
+var VON_MODEL = "von-1.1.0";
+
 class VonError extends Error {
   status;
   details;
@@ -47,7 +49,7 @@ class VonClient {
   async systemOne({
     state,
     questions,
-    model = "von-1.0.0"
+    model = VON_MODEL
   }) {
     const url = `${this.baseURL}/v1/systemone`;
     const headers = {
@@ -86,7 +88,7 @@ class VonClient {
       clearTimeout(timer);
     }
   }
-  async decide(state, choices, instructions = "Which option best describes the state?", model = "von-1.0.0") {
+  async decide(state, choices, instructions = "Which option best describes the state?", model = VON_MODEL) {
     const q = choice(instructions, choices);
     const resp = await this.systemOne({
       state,
@@ -95,7 +97,7 @@ class VonClient {
     });
     return resp.answers["decision"];
   }
-  async judge(state, instructions, posCriteria, negCriteria, model = "von-1.0.0") {
+  async judge(state, instructions, posCriteria, negCriteria, model = VON_MODEL) {
     const criteria = posCriteria || negCriteria ? { pos: posCriteria, neg: negCriteria } : undefined;
     const q = noul(instructions, criteria);
     const resp = await this.systemOne({
@@ -105,7 +107,7 @@ class VonClient {
     });
     return resp.answers["verdict"].noul;
   }
-  async rate(state, levels, instructions = "Rate the severity or level:", model = "von-1.0.0") {
+  async rate(state, levels, instructions = "Rate the severity or level:", model = VON_MODEL) {
     const q = score(instructions, levels);
     const resp = await this.systemOne({
       state,
@@ -118,6 +120,7 @@ class VonClient {
 var TypeSafeClient = VonClient;
 export {
   TypeSafeClient,
+  VON_MODEL,
   VonClient,
   VonError,
   choice,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "von-sdk",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "Official TypeScript/JavaScript SDK for Von - The Open-Source System One Decision Model",
   "author": "Victor Hugo <victor.panisa@gmail.com>",
   "license": "Apache-2.0",
@@ -16,7 +16,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/wfzyx/von.git",
+    "url": "git+https://github.com/wfzyx/von.git",
     "directory": "js"
   },
   "homepage": "https://github.com/wfzyx/von#readme",
@@ -42,5 +42,8 @@
   "devDependencies": {
     "@types/node": "^26.6.2",
     "typescript": "^7.0.2"
+  },
+  "bugs": {
+    "url": "https://github.com/wfzyx/von/issues"
   }
 }

package/dist/src/client.d.ts

@@ -1,34 +0,0 @@
-import type { ChoiceAnswer, Question, ScoreAnswer, SystemOneResponse, VonClientOptions } from "./types.js";
-export declare class VonError extends Error {
-    status?: number;
-    details?: unknown;
-    constructor(message: string, status?: number, details?: unknown);
-}
-export declare class VonClient {
-    baseURL: string;
-    apiKey?: string;
-    timeout: number;
-    constructor(options?: VonClientOptions);
-    /**
-     * Evaluates state and questions via System One wire protocol (POST /v1/systemone).
-     */
-    systemOne({ state, questions, model, }: {
-        state: unknown;
-        questions: Record<string, Question>;
-        model?: string;
-    }): Promise<SystemOneResponse>;
-    /**
-     * Convenience helper for discrete categorical choice classification.
-     */
-    decide(state: unknown, choices: Record<string, string | null> | string[], instructions?: string, model?: string): Promise<ChoiceAnswer>;
-    /**
-     * Convenience helper for binary verification (Noul probability).
-     */
-    judge(state: unknown, instructions: string, posCriteria?: string, negCriteria?: string, model?: string): Promise<number>;
-    /**
-     * Convenience helper for ordinal multi-level rating (Score).
-     */
-    rate(state: unknown, levels: string[] | Record<string, string>, instructions?: string, model?: string): Promise<ScoreAnswer>;
-}
-/** Drop-in alias for TypeSafe Jev SDK migration */
-export declare const TypeSafeClient: typeof VonClient;

package/dist/src/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./types.js";
-export * from "./primitives.js";
-export * from "./client.js";

package/dist/src/primitives.d.ts

@@ -1,16 +0,0 @@
-import type { ChoiceQuestion, NoulQuestion, ScoreQuestion } from "./types.js";
-/**
- * Build a discrete categorical Choice question.
- */
-export declare function choice(instructions: string, criteria: Record<string, string | null> | string[]): ChoiceQuestion;
-/**
- * Build a binary verification Noul (Yes/No probability) question.
- */
-export declare function noul(instructions: string, criteria?: {
-    pos?: string;
-    neg?: string;
-} | null): NoulQuestion;
-/**
- * Build an ordinal multi-level Score question.
- */
-export declare function score(instructions: string, criteria: string[] | Record<string, string>): ScoreQuestion;

package/dist/src/types.d.ts

@@ -1,56 +0,0 @@
-/**
- * Core type definitions for Von System One decisions.
- */
-export type QuestionType = "noul" | "choice" | "score";
-export interface BaseQuestion {
-    type: QuestionType;
-    instructions: string;
-}
-export interface NoulQuestion extends BaseQuestion {
-    type: "noul";
-    criteria?: {
-        pos?: string;
-        neg?: string;
-    } | null;
-}
-export interface ChoiceQuestion extends BaseQuestion {
-    type: "choice";
-    criteria: Record<string, string | null>;
-}
-export interface ScoreQuestion extends BaseQuestion {
-    type: "score";
-    criteria: string[] | Record<string, string>;
-}
-export type Question = NoulQuestion | ChoiceQuestion | ScoreQuestion;
-export interface NoulAnswer {
-    type: "noul";
-    noul: number;
-}
-export interface ChoiceAnswer {
-    type: "choice";
-    choice: string;
-    probabilities: Record<string, number>;
-    confidence: number;
-}
-export interface ScoreAnswer {
-    type: "score";
-    score: number;
-    confidence: number;
-    legend: Record<string, string>;
-    probabilities: Record<string, number>;
-}
-export type Answer = NoulAnswer | ChoiceAnswer | ScoreAnswer;
-export interface Usage {
-    input_tokens: number;
-    output_tokens: number;
-}
-export interface SystemOneResponse {
-    model: string;
-    answers: Record<string, Answer>;
-    usage: Usage;
-}
-export interface VonClientOptions {
-    baseURL?: string;
-    apiKey?: string;
-    timeout?: number;
-}