@jinn-network/sdk 0.1.0

package/dist/prediction-v1.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+const WindowSchema = z.object({
+    startTs: z.number().int().nonnegative(),
+    endTs: z.number().int().nonnegative(),
+});
+export const DecimalProbabilitySchema = z
+    .string()
+    .regex(/^(0(\.\d+)?|1(\.0+)?)$/, 'must be a decimal string in [0,1]');
+export const IsoDateTimeSchema = z.string().datetime({ offset: true });
+export const PredictionV1ClaimPolicySchema = z.object({
+    kind: z.literal('parallel'),
+    maxClaims: z.number().int().positive(),
+    maxClaimsPerSolver: z.number().int().positive(),
+    claimWindow: z.literal('task-window'),
+    selection: z.literal('all-valid-solutions-scored'),
+    economics: z.literal('testnet-flat'),
+});
+export const PredictionV1SpecSchema = z.object({
+    question: z.object({
+        kind: z.literal('binary'),
+        text: z.string().min(1),
+        yesLabel: z.literal('YES'),
+        noLabel: z.literal('NO'),
+    }),
+    source: z.object({
+        type: z.literal('prediction-market'),
+        venue: z.literal('polymarket'),
+        url: z.string().url(),
+        identifiers: z.object({
+            marketId: z.string().min(1),
+            conditionId: z.string().min(1),
+            yesTokenId: z.string().min(1),
+            noTokenId: z.string().min(1),
+        }),
+    }),
+    resolution: z.object({
+        expectedResolutionTime: IsoDateTimeSchema,
+        rulesText: z.string().min(1),
+        rulesUrl: z.string().url(),
+        timezone: z.string().optional(),
+    }),
+    consensusSnapshot: z.object({
+        sampledAt: IsoDateTimeSchema,
+        probabilityYes: DecimalProbabilitySchema,
+        method: z.literal('best-bid-ask-midpoint'),
+        bestBidYes: DecimalProbabilitySchema,
+        bestAskYes: DecimalProbabilitySchema,
+        spread: DecimalProbabilitySchema,
+        source: z.literal('polymarket-clob'),
+    }),
+    eligibilitySnapshot: z.object({
+        sampledAt: IsoDateTimeSchema,
+        timeToResolutionHours: z.number(),
+        liquidityUsd: z.string().min(1),
+        volume24hUsd: z.string().min(1),
+        orderbookAgeSeconds: z.number().nonnegative(),
+        selectionReason: z.string().min(1),
+    }),
+});
+export const PredictionV1TaskSchema = z
+    .object({
+    id: z.string().min(1),
+    description: z.string().min(1),
+    solverType: z.literal('prediction.v1'),
+    role: z.enum(['restoration', 'evaluation']).optional(),
+    window: WindowSchema,
+    claimPolicy: PredictionV1ClaimPolicySchema,
+    spec: PredictionV1SpecSchema,
+    eligibility: z.record(z.unknown()).default({}),
+})
+    .refine((d) => d.window.endTs > d.window.startTs, {
+    message: 'window.endTs must be > window.startTs',
+    path: ['window'],
+})
+    .refine((d) => Date.parse(d.spec.resolution.expectedResolutionTime) > d.window.startTs, {
+    message: 'expectedResolutionTime must be after window.startTs',
+    path: ['spec', 'resolution', 'expectedResolutionTime'],
+});

package/dist/solvernets/index.d.ts

@@ -0,0 +1,2 @@
+export { PREDICTION_V1_SOLVER_NET_CONTRACT, SOLVER_NET_CONTRACTS, PayloadValidationException, getSolverNetContract, validateTask, assertTask, validateSolutionPayload, assertSolutionPayload, validateVerdictPayload, assertVerdictPayload, buildSolutionOutput, buildVerdictOutput, } from '../contracts.js';
+export type { SolverNetContractRole, PayloadKind, SupportedSolverType, CredentialRequirement, SolverNetEvaluationFunction, SolverNetAggregationFunction, SolverNetClaimPolicyDefaults, SolverNetContract, SolverNetContractMap, PayloadValidationIssue, PayloadValidationFailure, PayloadValidationSuccess, PayloadValidationResult, BuildSolutionOutputArgs, BuildVerdictOutputArgs, } from '../contracts.js';

package/dist/solvernets/index.js

@@ -0,0 +1 @@
+export { PREDICTION_V1_SOLVER_NET_CONTRACT, SOLVER_NET_CONTRACTS, PayloadValidationException, getSolverNetContract, validateTask, assertTask, validateSolutionPayload, assertSolutionPayload, validateVerdictPayload, assertVerdictPayload, buildSolutionOutput, buildVerdictOutput, } from '../contracts.js';

package/dist/solvernets/prediction-v1.d.ts

@@ -0,0 +1,6 @@
+export { DecimalProbabilitySchema, IsoDateTimeSchema, PredictionV1ClaimPolicySchema, PredictionV1SpecSchema, PredictionV1TaskSchema, } from '../prediction-v1.js';
+export type { PredictionV1Spec, PredictionV1Task } from '../prediction-v1.js';
+export { PredictionV1RestorationPayloadSchema, PredictionV1VerdictPayloadSchema, } from '../payloads/prediction-v1.js';
+export type { PredictionV1RestorationPayload, PredictionV1VerdictPayload, } from '../payloads/prediction-v1.js';
+export { PREDICTION_V1_SOLVER_NET_CONTRACT, PayloadValidationException, getSolverNetContract, validateTask, assertTask, validateSolutionPayload, assertSolutionPayload, validateVerdictPayload, assertVerdictPayload, buildSolutionOutput, buildVerdictOutput, } from '../contracts.js';
+export type { PayloadValidationIssue, PayloadValidationFailure, PayloadValidationSuccess, PayloadValidationResult, BuildSolutionOutputArgs, BuildVerdictOutputArgs, } from '../contracts.js';

package/dist/solvernets/prediction-v1.js

@@ -0,0 +1,3 @@
+export { DecimalProbabilitySchema, IsoDateTimeSchema, PredictionV1ClaimPolicySchema, PredictionV1SpecSchema, PredictionV1TaskSchema, } from '../prediction-v1.js';
+export { PredictionV1RestorationPayloadSchema, PredictionV1VerdictPayloadSchema, } from '../payloads/prediction-v1.js';
+export { PREDICTION_V1_SOLVER_NET_CONTRACT, PayloadValidationException, getSolverNetContract, validateTask, assertTask, validateSolutionPayload, assertSolutionPayload, validateVerdictPayload, assertVerdictPayload, buildSolutionOutput, buildVerdictOutput, } from '../contracts.js';

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+export type Hex = `0x${string}`;
+export type Address = Hex;
+export interface IntentWindow {
+    startTs: number;
+    endTs: number;
+}
+export interface Task {
+    id: string;
+    description: string;
+    solverType: string;
+    role?: 'restoration' | 'evaluation';
+    context?: Record<string, unknown>;
+    spec?: Record<string, unknown>;
+    window?: IntentWindow;
+    eligibility?: Record<string, unknown>;
+    attemptId?: string;
+    attemptNumber?: number;
+    restorationRequestId?: string;
+}
+export interface OutputArtifact {
+    artifactType: string;
+    type?: string;
+    path?: string;
+    cid?: string;
+    [key: string]: unknown;
+}
+export interface RationaleEntry {
+    message: string;
+    [key: string]: unknown;
+}
+export interface Solution {
+    venueRef: {
+        name: string;
+    };
+    preSnapshot?: Record<string, unknown>;
+    postSnapshot?: Record<string, unknown>;
+    fills?: unknown[];
+    gating: Record<string, unknown>;
+    informational?: Record<string, unknown>;
+    solutionPayload?: Record<string, unknown>;
+    verdictPayload?: Record<string, unknown>;
+    artifacts?: OutputArtifact[];
+    rationale?: RationaleEntry[];
+}
+export interface TrajectorySpanInput {
+    name: string;
+    kind: string;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: Record<string, unknown>;
+    events: Array<{
+        name: string;
+        timeUnixNano: string;
+        attributes?: Record<string, unknown>;
+    }>;
+    status: {
+        code: 'OK' | 'ERROR' | 'UNSET';
+        message?: string;
+    };
+    parentSpanId?: string | null;
+}
+export interface TrajectoryCollector {
+    addSpan(input: TrajectorySpanInput): unknown;
+}
+export interface ReadyStatus {
+    ready: boolean;
+    reason?: string;
+    nextStep?: {
+        description: string;
+        cli?: string;
+        url?: string;
+    };
+}
+export declare const REQUIRES_LIVE_DAEMON_READINESS: ReadyStatus;
+export interface EnableArgDef {
+    name: string;
+    description: string;
+    required: boolean;
+}
+export interface IntentEnableMetadata {
+    description: string;
+    requiredArgs?: EnableArgDef[];
+    externalResources?: Array<{
+        name: string;
+        url: string;
+    }>;
+}
+export type EnableResult = {
+    status: 'ready';
+    details?: Record<string, unknown>;
+} | {
+    status: 'waiting_for_external_action';
+    action: {
+        description: string;
+        url?: string;
+    };
+    details?: Record<string, unknown>;
+    nextInvocation: {
+        cli: string;
+        purpose: string;
+    };
+} | {
+    status: 'missing_args';
+    required: EnableArgDef[];
+    example: {
+        cli: string;
+    };
+} | {
+    status: 'error';
+    message: string;
+    details?: Record<string, unknown>;
+};
+export declare class SkippableError extends Error {
+    readonly reason: string;
+    constructor(reason: string, message?: string);
+}

package/dist/types.js

@@ -0,0 +1,21 @@
+// Public contract surface for Jinn external Harness authors.
+//
+// These types are mirrored from `client/src/harnesses/types.ts` at SDK
+// publish time. The SDK is the stable boundary; @jinn-network/client
+// internals are not.
+export const REQUIRES_LIVE_DAEMON_READINESS = {
+    ready: false,
+    reason: 'requires live daemon',
+    nextStep: {
+        description: 'Run the daemon with a configured fleet and wallet',
+        cli: 'jinn run',
+    },
+};
+export class SkippableError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message ?? reason);
+        this.name = 'SkippableError';
+        this.reason = reason;
+    }
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@jinn-network/sdk",
+  "version": "0.1.0",
+  "description": "Stable SDK surface for Jinn SolverNets, Harnesses, plugins, and typed payloads.",
+  "type": "module",
+  "packageManager": "yarn@4.13.0",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./harness": {
+      "import": "./dist/harness.js",
+      "types": "./dist/harness.d.ts"
+    },
+    "./plugins": {
+      "import": "./dist/plugins.js",
+      "types": "./dist/plugins.d.ts"
+    },
+    "./solvernets": {
+      "import": "./dist/solvernets/index.js",
+      "types": "./dist/solvernets/index.d.ts"
+    },
+    "./solvernets/prediction-v1": {
+      "import": "./dist/solvernets/prediction-v1.js",
+      "types": "./dist/solvernets/prediction-v1.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "yarn build && yarn test",
+    "pack:smoke": "yarn pack -o jinn-sdk.tgz && node scripts/smoke-test-pack.mjs",
+    "release:sdk": "node scripts/release-sdk.mjs"
+  },
+  "dependencies": {
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.9"
+  }
+}