@askverdict/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,227 @@
+export interface AskVerdictClientConfig {
+    /** Base URL for the AskVerdict API. Defaults to https://api.askverdict.ai */
+    baseUrl?: string;
+    /** API key for programmatic access (vrd_* prefix, sent via X-Api-Key) */
+    apiKey?: string;
+    /** Session/auth token (Authorization: Bearer header) — for internal app use */
+    authToken?: string;
+}
+export type DebateMode = "fast" | "balanced" | "thorough" | "analytical";
+export type DebateStatus = "active" | "completed" | "failed" | "paused" | "pending" | "running";
+export interface CreateDebateParams {
+    question: string;
+    mode?: DebateMode;
+    agentCount?: number;
+    maxRounds?: number;
+    enableSearch?: boolean;
+    context?: string;
+    preset?: string;
+    skipCache?: boolean;
+}
+export interface CreateDebateResult {
+    id: string;
+    status: string;
+    streamUrl: string;
+    /** @deprecated Use `id` instead */
+    debateId?: string;
+}
+export interface VerdictRecommendation {
+    recommendation: string;
+    confidence: number;
+    rationale: string;
+}
+export interface DecisionMatrixEntry {
+    criterion: string;
+    forScore: number;
+    againstScore: number;
+    weight: number;
+}
+export interface Verdict {
+    summary: string;
+    recommendation: VerdictRecommendation;
+    confidence: number;
+    keyFindings: string[];
+    totalRounds?: number;
+    agentsUsed?: string[];
+}
+export interface DebateCostRecord {
+    totalUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export type FundingSource = "free_tier" | "user_credits" | "byok" | null;
+export interface DebateResponse {
+    id: string;
+    question: string;
+    status: DebateStatus;
+    verdict: Verdict | null;
+    cost: DebateCostRecord | null;
+    mode: string | null;
+    agentCount: number | null;
+    roundCount: number | null;
+    fundingSource: FundingSource;
+    isPublic: boolean;
+    createdAt: string;
+    completedAt: string | null;
+}
+export interface ListDebatesParams {
+    limit?: number;
+    offset?: number;
+    status?: DebateStatus;
+    page?: number;
+    pageSize?: number;
+}
+export interface ListDebatesResult {
+    debates: DebateResponse[];
+    total: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+}
+export type VoteValue = "agree" | "disagree" | "neutral";
+export interface ClaimVoteTally {
+    agree: number;
+    disagree: number;
+    userVote?: VoteValue;
+}
+/** Map of claimId → tally */
+export type VoteMap = Record<string, ClaimVoteTally>;
+export interface PollOption {
+    id: string;
+    label: string;
+}
+export interface Poll {
+    id: string;
+    debateId: string;
+    question: string;
+    options: PollOption[];
+    status: "open" | "closed";
+    createdAt: string;
+    closedAt: string | null;
+    tallies: Record<string, number>;
+    totalVotes: number;
+    userVote: string | null;
+}
+export interface HealthResponse {
+    status: "ok" | "degraded" | "down";
+    service: string;
+    timestamp: string;
+    version: string;
+}
+export interface StreamEvent {
+    id: string;
+    type: string;
+    data: unknown;
+    timestamp: number;
+}
+export interface UserProfile {
+    id: string;
+    name: string;
+    email: string;
+    image: string | null;
+    plan: string;
+    bio: string | null;
+    location: string | null;
+    createdAt: string;
+}
+export interface UsageInfo {
+    plan: string;
+    debatesThisMonth: number;
+    debatesLimit: number | null;
+    creditsRemaining: number;
+    freeDebateResetAt: string | null;
+}
+export interface BalanceInfo {
+    creditBalance: number;
+    plan: string;
+}
+export type CheckoutPlan = "starter" | "pro" | "byok" | "byok_pro";
+export type CheckoutInterval = "monthly" | "annual";
+export type CreditPack = "credits_50" | "credits_200" | "credits_600";
+export interface CheckoutUrlResult {
+    url: string;
+}
+export interface PortalUrlResult {
+    url: string;
+}
+export interface DashboardStats {
+    totalDebates: number;
+    debatesThisWeek: number;
+    weeklyActivity: number[];
+    modeDistribution: Record<string, number>;
+    averageCost: number;
+    currentStreak: number;
+}
+export interface SearchParams {
+    type?: "debates" | "verdicts";
+    sort?: "relevance" | "date" | "popularity";
+    page?: number;
+    limit?: number;
+    status?: string;
+    mode?: string;
+}
+export interface SearchResultItem {
+    id: string;
+    question: string;
+    status: string;
+    mode: string | null;
+    confidence: number | null;
+    recommendation: string | null;
+    createdAt: string;
+}
+export interface SearchResult {
+    results: SearchResultItem[];
+    total: number;
+    page: number;
+    totalPages: number;
+}
+export interface OutcomeRecord {
+    id: string;
+    debateId: string;
+    actualOutcome: string;
+    notes: string | null;
+    verdictWasCorrect: boolean | null;
+    recordedAt: string;
+}
+export interface SubmitOutcomeParams {
+    actualOutcome: string;
+    notes?: string;
+    verdictWasCorrect?: boolean;
+}
+export interface DecisionScore {
+    overallAccuracy: number;
+    totalDecisions: number;
+    correctPredictions: number;
+    brierScore: number | null;
+    calibrationScore: number | null;
+}
+export interface StreakInfo {
+    currentStreak: number;
+    longestStreak: number;
+    totalDebates: number;
+    milestones: Array<{
+        count: number;
+        reached: boolean;
+        reachedAt?: string;
+    }>;
+}
+export interface ApiKeyUsage {
+    keyId: string;
+    period: string;
+    totalRequests: number;
+    byEndpoint: Record<string, number>;
+    rateLimit: number;
+}
+export interface SdkError {
+    code: string;
+    message: string;
+    status?: number;
+    details?: Record<string, unknown>;
+}
+export declare class AskVerdictError extends Error {
+    readonly code: string;
+    readonly status: number | undefined;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(error: SdkError);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/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/types.js

@@ -0,0 +1,16 @@
+// @askverdict/sdk — SDK-specific types (re-exported shapes aligned with API)
+// Note: We intentionally define these inline rather than re-exporting from
+// @askverdict/types to keep the published SDK self-contained.
+export class AskVerdictError extends Error {
+    code;
+    status;
+    details;
+    constructor(error) {
+        super(error.message);
+        this.name = "AskVerdictError";
+        this.code = error.code;
+        this.status = error.status;
+        this.details = error.details;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,8DAA8D;AAyR9D,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,MAAM,CAAqB;IAC3B,OAAO,CAAsC;IAEtD,YAAY,KAAe;QACzB,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@askverdict/sdk",
+  "version": "0.1.0",
+  "description": "AskVerdict TypeScript SDK — API client for askverdict.ai",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "keywords": [
+    "askverdict",
+    "ai",
+    "debate",
+    "verdict",
+    "decision-making",
+    "multi-agent",
+    "sdk",
+    "api-client"
+  ],
+  "homepage": "https://askverdict.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/askverdict/askverdict",
+    "directory": "packages/sdk"
+  },
+  "license": "MIT",
+  "author": "AskVerdict <hello@askverdict.ai>",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build"
+  },
+  "dependencies": {
+    "@askverdict/types": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.0"
+  }
+}