@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/vendor/@jinn-network/sdk/dist/solvernets/manifest-schema.js

@@ -0,0 +1,126 @@
+// SolverNetManifestV1 — the launched-instance authority document.
+//
+// Mirror of the TypeScript interface in
+// `spec/2026-05-05-solvernet-creation-and-launch.md` §7. The Zod validator
+// here is the daemon-side ergonomic check; the canonical wire format for
+// signing and cross-implementation verification is JSON Schema (Task 2 will
+// derive it from this Zod schema).
+//
+// Notable shape rules from §7:
+// - Fully embedded contract (no ref/embed split)
+// - `solutionPriceWei` and `verdictPriceWei` are top-level (no `economics` wrapper)
+// - `openRoles: Array<'solver' | 'evaluator'>` is top-level (no `participation` wrapper)
+// - No `recommendedHarnesses`, no `requiredRuntimePlugins`, no `defaultRuntimePlugins`
+// - `evaluationFunction.implementation` is BINDING (canonical evaluator harness reference)
+// - `signature: { alg: 'eip-191'; signer: 0x...; value: 0x... }`
+import { z } from 'zod';
+// JSON Schema is opaque to this validator — manifests carry user-authored
+// schemas whose internal shape we do not constrain here. Manifest readers
+// validate payloads against these schemas at task/solution/verdict handling
+// time. `z.record(z.string(), z.unknown())` already rejects non-object input,
+// so no further refinement is needed.
+const JsonSchemaZ = z.record(z.string(), z.unknown());
+const HexStringZ = z
+    .string()
+    .regex(/^0x[0-9a-fA-F]+$/u, {
+    message: 'must be 0x-prefixed hex with at least one hex digit',
+});
+const NumericStringZ = z
+    .string()
+    .regex(/^\d+$/u, { message: 'must be a non-negative integer string (wei)' });
+// `creator` is the launcher role and is always implicit — it never appears in
+// `openRoles` because the launcher is the SolverNet's authority document
+// signer, not a participant target advertised for join. `openRoles` is
+// constrained inline to ['solver', 'evaluator']; this enum is exposed for
+// callers that reason about all three roles (e.g., credentialRequirements
+// keying).
+const ContractRoleZ = z.enum(['creator', 'solver', 'evaluator']);
+const CredentialRequirementZ = z.object({
+    id: z.string().min(1),
+    kind: z.string().min(1),
+    required: z.boolean(),
+    description: z.string(),
+}).strict();
+const ClaimPolicyDefaultsZ = z.object({
+    mode: z.enum(['parallel', 'serial']),
+    maxClaims: z.number().int().nonnegative(),
+    maxClaimsPerOperator: z.number().int().nonnegative(),
+    claimLeaseTtlSeconds: z.number().int().nonnegative(),
+}).strict();
+const EvaluationFunctionZ = z.object({
+    id: z.string().min(1),
+    deterministic: z.boolean(),
+    inputs: z.array(z.string()),
+    output: z.string().min(1),
+    implementation: z.string().min(1), // BINDING — see §7
+}).strict();
+const AggregationFunctionZ = z.object({
+    id: z.string().min(1),
+    deterministic: z.boolean(),
+    inputs: z.array(z.string()),
+    output: z.string().min(1),
+    windowDays: z.number().int().positive().optional(),
+}).strict();
+const ContractZ = z.object({
+    id: z.string().min(1),
+    version: z.string().min(1),
+    schemas: z.object({
+        task: JsonSchemaZ,
+        solution: JsonSchemaZ,
+        verdict: JsonSchemaZ,
+    }).strict(),
+    claimPolicyDefaults: ClaimPolicyDefaultsZ,
+    credentialRequirements: z.object({
+        creator: z.array(CredentialRequirementZ),
+        solver: z.array(CredentialRequirementZ),
+        evaluator: z.array(CredentialRequirementZ),
+    }).strict(),
+    evaluationFunction: EvaluationFunctionZ,
+    aggregationFunction: AggregationFunctionZ,
+}).strict();
+const LauncherZ = z.object({
+    safeAddress: HexStringZ,
+    agentEoa: HexStringZ,
+    agentId: z.string().min(1),
+}).strict();
+const SignatureZ = z.object({
+    alg: z.literal('eip-191'),
+    signer: HexStringZ,
+    value: HexStringZ,
+}).strict();
+const RegistryZ = z.object({
+    manifestCid: z.string().min(1).optional(),
+    registryUrl: z.string().min(1).optional(),
+}).strict();
+export const SolverNetManifestV1Schema = z.object({
+    schemaVersion: z.literal('solvernet.manifest.v1'),
+    solverNetId: z.string().min(1),
+    network: z.enum(['base-sepolia', 'base']),
+    name: z.string().min(1),
+    description: z.string(),
+    launcher: LauncherZ,
+    contract: ContractZ,
+    solutionPriceWei: NumericStringZ,
+    verdictPriceWei: NumericStringZ,
+    openRoles: z.array(z.enum(['solver', 'evaluator'])).min(1),
+    registry: RegistryZ.optional(),
+    createdAt: z.string().min(1),
+    launchedAt: z.string().min(1),
+    signature: SignatureZ,
+}).strict();
+/**
+ * Validate a value against the SolverNetManifestV1 schema. Returns a tagged
+ * union with either the typed manifest or a list of validation issues with
+ * dotted paths suitable for surfacing in launcher UI.
+ */
+export function validateSolverNetManifest(value) {
+    const parsed = SolverNetManifestV1Schema.safeParse(value);
+    if (parsed.success) {
+        return { ok: true, value: parsed.data };
+    }
+    const issues = parsed.error.issues.map((issue) => ({
+        path: issue.path.length > 0 ? issue.path.join('.') : '<root>',
+        message: issue.message,
+    }));
+    return { ok: false, issues };
+}

package/dist/vendor/@jinn-network/sdk/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/vendor/@jinn-network/sdk/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/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.d.ts

@@ -0,0 +1,4 @@
+export { SweRebenchV2LanguageSchema, SweRebenchV2TaskSchema, } from '../swe-rebench-v2.js';
+export type { SweRebenchV2Task } from '../swe-rebench-v2.js';
+export { SweRebenchV2SolutionPayloadSchema, SweRebenchV2VerdictPayloadSchema, } from '../payloads/swe-rebench-v2.js';
+export type { SweRebenchV2SolutionPayload, SweRebenchV2VerdictPayload, } from '../payloads/swe-rebench-v2.js';

package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.js

@@ -0,0 +1,2 @@
+export { SweRebenchV2LanguageSchema, SweRebenchV2TaskSchema, } from '../swe-rebench-v2.js';
+export { SweRebenchV2SolutionPayloadSchema, SweRebenchV2VerdictPayloadSchema, } from '../payloads/swe-rebench-v2.js';

package/dist/vendor/@jinn-network/sdk/dist/swe-rebench-v2.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SWE-rebench v2 Task schema. The on-chain JinnRouter Task payload references
+ * a HuggingFace dataset row by `(hf_dataset, hf_split, instance_id)`; the
+ * Solver and Evaluator fetch the full row at solve / grade time.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §3.3
+ */
+import { z } from 'zod';
+export declare const SweRebenchV2LanguageSchema: z.ZodEnum<["python", "javascript", "typescript", "go", "c", "cpp", "cs", "java", "rust", "dart"]>;
+export declare const SweRebenchV2TaskSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"swe-rebench-v2.v1">;
+    /**
+     * The SWE-rebench v2 instance identifier. Format: <org>__<repo>-<issue-or-pr-number>,
+     * e.g. "unidata__netcdf-c-1925".
+     */
+    instance_id: z.ZodString;
+    /** GitHub repo path (org/repo). */
+    repo: z.ZodString;
+    /** Git commit SHA at which the issue was reported. */
+    base_commit: z.ZodString;
+    /** Programming language of the underlying repo. */
+    language: z.ZodEnum<["python", "javascript", "typescript", "go", "c", "cpp", "cs", "java", "rust", "dart"]>;
+    /** Issue or PR description. */
+    problem_statement: z.ZodString;
+    /**
+     * v2 auxiliary interface info (function names, signatures, descriptions for
+     * touched symbols). Empty string when no interface is provided.
+     */
+    interface: z.ZodString;
+    /** HuggingFace dataset id, e.g. 'nebius/SWE-rebench-leaderboard'. */
+    hf_dataset: z.ZodString;
+    /** HF split identifier, e.g. '2026_02'. */
+    hf_split: z.ZodString;
+    /** Unix epoch (seconds) deadline for Solution submission. */
+    deadline_unix: z.ZodNumber;
+    /**
+     * Round identifier for the launched SolverNet manifest. Format YYYY-MM.
+     * Used for per-round dashboard rollups and per-round reward distribution.
+     */
+    round_month: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: "swe-rebench-v2.v1";
+    instance_id: string;
+    repo: string;
+    base_commit: string;
+    language: "python" | "javascript" | "typescript" | "go" | "c" | "cpp" | "cs" | "java" | "rust" | "dart";
+    problem_statement: string;
+    interface: string;
+    hf_dataset: string;
+    hf_split: string;
+    deadline_unix: number;
+    round_month: string;
+}, {
+    schemaVersion: "swe-rebench-v2.v1";
+    instance_id: string;
+    repo: string;
+    base_commit: string;
+    language: "python" | "javascript" | "typescript" | "go" | "c" | "cpp" | "cs" | "java" | "rust" | "dart";
+    problem_statement: string;
+    interface: string;
+    hf_dataset: string;
+    hf_split: string;
+    deadline_unix: number;
+    round_month: string;
+}>;
+export type SweRebenchV2Task = z.infer<typeof SweRebenchV2TaskSchema>;

package/dist/vendor/@jinn-network/sdk/dist/swe-rebench-v2.js

@@ -0,0 +1,44 @@
+/**
+ * SWE-rebench v2 Task schema. The on-chain JinnRouter Task payload references
+ * a HuggingFace dataset row by `(hf_dataset, hf_split, instance_id)`; the
+ * Solver and Evaluator fetch the full row at solve / grade time.
+ *
+ * Spec: docs/superpowers/specs/2026-05-06-agent-harness-solvernet-design.md §3.3
+ */
+import { z } from 'zod';
+export const SweRebenchV2LanguageSchema = z.enum([
+    'python', 'javascript', 'typescript', 'go',
+    'c', 'cpp', 'cs', 'java', 'rust', 'dart',
+]);
+export const SweRebenchV2TaskSchema = z.object({
+    schemaVersion: z.literal('swe-rebench-v2.v1'),
+    /**
+     * The SWE-rebench v2 instance identifier. Format: <org>__<repo>-<issue-or-pr-number>,
+     * e.g. "unidata__netcdf-c-1925".
+     */
+    instance_id: z.string().min(1),
+    /** GitHub repo path (org/repo). */
+    repo: z.string().regex(/^[^/]+\/[^/]+$/),
+    /** Git commit SHA at which the issue was reported. */
+    base_commit: z.string().regex(/^[0-9a-f]{40}$/),
+    /** Programming language of the underlying repo. */
+    language: SweRebenchV2LanguageSchema,
+    /** Issue or PR description. */
+    problem_statement: z.string(),
+    /**
+     * v2 auxiliary interface info (function names, signatures, descriptions for
+     * touched symbols). Empty string when no interface is provided.
+     */
+    interface: z.string(),
+    /** HuggingFace dataset id, e.g. 'nebius/SWE-rebench-leaderboard'. */
+    hf_dataset: z.string().regex(/^[^/]+\/[^/]+$/),
+    /** HF split identifier, e.g. '2026_02'. */
+    hf_split: z.string().regex(/^\d{4}_\d{2}$/),
+    /** Unix epoch (seconds) deadline for Solution submission. */
+    deadline_unix: z.number().int().positive(),
+    /**
+     * Round identifier for the launched SolverNet manifest. Format YYYY-MM.
+     * Used for per-round dashboard rollups and per-round reward distribution.
+     */
+    round_month: z.string().regex(/^\d{4}-\d{2}$/),
+});

package/dist/vendor/@jinn-network/sdk/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/vendor/@jinn-network/sdk/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/dist/vendor/@jinn-network/sdk/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@jinn-network/sdk",
+  "version": "0.1.0",
+  "description": "Stable SDK surface for Jinn SolverNets, Harnesses, plugins, and typed payloads.",
+  "type": "module",
+  "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"
+    },
+    "./solvernets/swe-rebench-v2": {
+      "import": "./dist/solvernets/swe-rebench-v2.js",
+      "types": "./dist/solvernets/swe-rebench-v2.d.ts"
+    },
+    "./checkpoint": {
+      "import": "./dist/checkpoint.js",
+      "types": "./dist/checkpoint.d.ts"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.22.0",
+    "zod-to-json-schema": "^3.23.0"
+  }
+}

package/dist/venues/hyperliquid/account-value.d.ts

@@ -3,7 +3,7 @@
  *
  * Returns a single equity figure that sums perps margin + spot USDC. This
  * matches HL's `portfolio` endpoint `accountValueHistory` (which also
- * reports the unified view), so restorer-claimed equity and evaluator-
+ * reports the unified view), so harness-claimed equity and evaluator-
  * rederived grid points compare cleanly.
  *
  * Non-USDC spot tokens are NOT valued in v0 — their midprice lookup and

package/dist/venues/hyperliquid/account-value.js

@@ -3,7 +3,7 @@
  *
  * Returns a single equity figure that sums perps margin + spot USDC. This
  * matches HL's `portfolio` endpoint `accountValueHistory` (which also
- * reports the unified view), so restorer-claimed equity and evaluator-
+ * reports the unified view), so harness-claimed equity and evaluator-
  * rederived grid points compare cleanly.
  *
  * Non-USDC spot tokens are NOT valued in v0 — their midprice lookup and

package/dist/venues/polymarket/client.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Public Polymarket data client for prediction.v1.
+ *
+ * Uses only unauthenticated Gamma / CLOB market-data endpoints. No trading,
+ * signing, order placement, or wallet surface belongs in this module.
+ */
+export interface PolymarketClientConfig {
+    gammaBaseUrl?: string;
+    clobBaseUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+export interface ListMarketCandidatesArgs extends PolymarketClientConfig {
+    limit?: number;
+    offset?: number;
+}
+export interface GetMarketArgs extends PolymarketClientConfig {
+    marketId?: string;
+    slug?: string;
+    conditionId?: string;
+}
+export interface GetOrderbookArgs extends PolymarketClientConfig {
+    marketId: string;
+    conditionId: string;
+    yesTokenId: string;
+}
+export interface GetResolutionArgs extends PolymarketClientConfig {
+    marketId?: string;
+    slug?: string;
+    conditionId?: string;
+    sourceUrl?: string;
+}
+export interface MarketCandidate {
+    venue: 'polymarket';
+    marketId: string;
+    conditionId: string;
+    slug: string;
+    url: string;
+    question: string;
+    description?: string;
+    rulesText: string;
+    endTime: string;
+    active: boolean;
+    closed: boolean;
+    archived: boolean;
+    outcomes: ['YES', 'NO'];
+    tokenIds: {
+        yes: string;
+        no: string;
+    };
+    liquidityUsd: string;
+    volume24hUsd: string;
+}
+export interface OrderbookSnapshot {
+    venue: 'polymarket';
+    marketId: string;
+    conditionId: string;
+    sampledAt: string;
+    bestBidYes: string;
+    bestAskYes: string;
+    midpointYes: string;
+    spread: string;
+    source: 'polymarket-clob';
+}
+export interface ResolutionSnapshot {
+    venue: 'polymarket';
+    marketId: string;
+    conditionId: string;
+    status: 'unresolved' | 'resolved' | 'invalid' | 'cancelled' | 'ambiguous';
+    outcome?: 'YES' | 'NO';
+    resolvedAt?: string;
+    sourceUrl: string;
+}
+export declare function normalizeMarketCandidate(raw: unknown): MarketCandidate | null;
+export declare function listMarketCandidates(args?: ListMarketCandidatesArgs): Promise<MarketCandidate[]>;
+export declare function getMarket(args: GetMarketArgs): Promise<MarketCandidate>;
+export declare function getOrderbook(args: GetOrderbookArgs): Promise<OrderbookSnapshot>;
+export declare function getResolution(args: GetResolutionArgs): Promise<ResolutionSnapshot>;