@vouched-dev/schema 0.1.0

package/dist/api.d.ts

@@ -0,0 +1,475 @@
+import { z } from 'zod';
+export declare const MAX_EVENTS_PER_BATCH = 500;
+export declare const MAX_ENVELOPE_CHARS = 4096;
+export declare const MAX_TASK_SPEC_BYTES = 16384;
+export declare const MAX_SUBMISSION_BYTES = 65536;
+export declare const MAX_TASK_ENVELOPE_CHARS = 131072;
+export declare const TASK_DEFAULT_TTL_HOURS = 24;
+export declare const TASK_MAX_TTL_DAYS = 7;
+export declare const AgentParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strict>;
+export declare const TaskParams: z.ZodObject<{
+    id: z.ZodUUID;
+}, z.core.$strict>;
+export declare const SignedTaskRequest: z.ZodObject<{
+    envelope: z.ZodString;
+}, z.core.$strict>;
+export type SignedTaskRequest = z.infer<typeof SignedTaskRequest>;
+export declare const RegisterAgentRequest: z.ZodObject<{
+    publicKey: z.ZodString;
+    githubToken: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strict>;
+export type RegisterAgentRequest = z.infer<typeof RegisterAgentRequest>;
+export declare const AgentResponse: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    operator: z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type AgentResponse = z.infer<typeof AgentResponse>;
+export declare const AgentCardResponse: z.ZodObject<{
+    name: z.ZodString;
+    capabilities: z.ZodObject<{
+        extensions: z.ZodArray<z.ZodObject<{
+            uri: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+export type AgentCardResponse = z.infer<typeof AgentCardResponse>;
+export declare const EventsBatchRequest: z.ZodObject<{
+    envelopes: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type EventsBatchRequest = z.infer<typeof EventsBatchRequest>;
+export declare const EventsBatchResponse: z.ZodObject<{
+    accepted: z.ZodInt;
+    duplicates: z.ZodInt;
+}, z.core.$strict>;
+export type EventsBatchResponse = z.infer<typeof EventsBatchResponse>;
+export declare const PostTaskRequest: z.ZodObject<{
+    taskId: z.ZodUUID;
+    taskType: z.ZodString;
+    spec: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    verification: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"hash">;
+        sha256: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"schema">;
+        jsonSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"counterparty">;
+    }, z.core.$strict>], "kind">;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type PostTaskRequest = z.infer<typeof PostTaskRequest>;
+export declare const TaskResponse: z.ZodObject<{
+    id: z.ZodUUID;
+    posterAgentId: z.ZodString;
+    claimantAgentId: z.ZodNullable<z.ZodString>;
+    taskType: z.ZodString;
+    spec: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    verification: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"hash">;
+        sha256: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"schema">;
+        jsonSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"counterparty">;
+    }, z.core.$strict>], "kind">;
+    state: z.ZodEnum<{
+        claimed: "claimed";
+        expired: "expired";
+        open: "open";
+        submitted: "submitted";
+        verified: "verified";
+    }>;
+    postedAt: z.ZodISODateTime;
+    claimedAt: z.ZodNullable<z.ZodISODateTime>;
+    submittedAt: z.ZodNullable<z.ZodISODateTime>;
+    verifiedAt: z.ZodNullable<z.ZodISODateTime>;
+    expiresAt: z.ZodISODateTime;
+    submission: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TaskResponse = z.infer<typeof TaskResponse>;
+export declare const ClaimTaskRequest: z.ZodObject<{
+    taskId: z.ZodUUID;
+}, z.core.$strict>;
+export type ClaimTaskRequest = z.infer<typeof ClaimTaskRequest>;
+export declare const SubmitTaskRequest: z.ZodObject<{
+    taskId: z.ZodUUID;
+    submission: z.ZodString;
+}, z.core.$strict>;
+export type SubmitTaskRequest = z.infer<typeof SubmitTaskRequest>;
+export declare const TaskOutcomeRequest: z.ZodObject<{
+    taskId: z.ZodUUID;
+    outcome: z.ZodEnum<{
+        failure: "failure";
+        success: "success";
+    }>;
+    evidenceHash: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type TaskOutcomeRequest = z.infer<typeof TaskOutcomeRequest>;
+export declare const ListTasksQuery: z.ZodObject<{
+    state: z.ZodDefault<z.ZodEnum<{
+        claimed: "claimed";
+        expired: "expired";
+        open: "open";
+        submitted: "submitted";
+        verified: "verified";
+    }>>;
+    taskType: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type ListTasksQuery = z.infer<typeof ListTasksQuery>;
+export declare const ListTasksResponse: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        posterAgentId: z.ZodString;
+        claimantAgentId: z.ZodNullable<z.ZodString>;
+        taskType: z.ZodString;
+        spec: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        verification: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"hash">;
+            sha256: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"schema">;
+            jsonSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"counterparty">;
+        }, z.core.$strict>], "kind">;
+        state: z.ZodEnum<{
+            claimed: "claimed";
+            expired: "expired";
+            open: "open";
+            submitted: "submitted";
+            verified: "verified";
+        }>;
+        postedAt: z.ZodISODateTime;
+        claimedAt: z.ZodNullable<z.ZodISODateTime>;
+        submittedAt: z.ZodNullable<z.ZodISODateTime>;
+        verifiedAt: z.ZodNullable<z.ZodISODateTime>;
+        expiresAt: z.ZodISODateTime;
+        submission: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ListTasksResponse = z.infer<typeof ListTasksResponse>;
+export declare const SignedRatingRequest: z.ZodObject<{
+    envelope: z.ZodString;
+}, z.core.$strict>;
+export type SignedRatingRequest = z.infer<typeof SignedRatingRequest>;
+export declare const RatingValue: z.ZodInt;
+export type RatingValue = z.infer<typeof RatingValue>;
+export declare const RatingRequest: z.ZodObject<{
+    rateeAgentId: z.ZodString;
+    dimension: z.ZodUnion<readonly [z.ZodEnum<{
+        cost_latency: "cost_latency";
+        provenance: "provenance";
+        reliability: "reliability";
+        safety: "safety";
+    }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+    value: z.ZodInt;
+    issuedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type RatingRequest = z.infer<typeof RatingRequest>;
+export declare const RatingResponse: z.ZodObject<{
+    rateeAgentId: z.ZodString;
+    dimension: z.ZodUnion<readonly [z.ZodEnum<{
+        cost_latency: "cost_latency";
+        provenance: "provenance";
+        reliability: "reliability";
+        safety: "safety";
+    }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+    value: z.ZodInt;
+    raterScoreAtTime: z.ZodNumber;
+}, z.core.$strict>;
+export type RatingResponse = z.infer<typeof RatingResponse>;
+export declare const ScoreEntry: z.ZodObject<{
+    version: z.ZodString;
+    dimension: z.ZodUnion<readonly [z.ZodEnum<{
+        cost_latency: "cost_latency";
+        provenance: "provenance";
+        reliability: "reliability";
+        safety: "safety";
+    }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+    value: z.ZodNullable<z.ZodNumber>;
+    windowStart: z.ZodNullable<z.ZodISODateTime>;
+    windowEnd: z.ZodNullable<z.ZodISODateTime>;
+    computedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type ScoreEntry = z.infer<typeof ScoreEntry>;
+export declare const ScoreResponse: z.ZodObject<{
+    agentId: z.ZodString;
+    scores: z.ZodArray<z.ZodObject<{
+        version: z.ZodString;
+        dimension: z.ZodUnion<readonly [z.ZodEnum<{
+            cost_latency: "cost_latency";
+            provenance: "provenance";
+            reliability: "reliability";
+            safety: "safety";
+        }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+        value: z.ZodNullable<z.ZodNumber>;
+        windowStart: z.ZodNullable<z.ZodISODateTime>;
+        windowEnd: z.ZodNullable<z.ZodISODateTime>;
+        computedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ScoreResponse = z.infer<typeof ScoreResponse>;
+export declare const CredentialResponse: z.ZodObject<{
+    credential: z.ZodString;
+    payload: z.ZodObject<{
+        iss: z.ZodLiteral<"vouched.run">;
+        sub: z.ZodString;
+        iat: z.ZodInt;
+        exp: z.ZodInt;
+        version: z.ZodString;
+        scores: z.ZodRecord<z.ZodUnion<readonly [z.ZodEnum<{
+            cost_latency: "cost_latency";
+            provenance: "provenance";
+            reliability: "reliability";
+            safety: "safety";
+        }>, z.ZodTemplateLiteral<`competence:${string}`>]> & z.core.$partial, z.ZodNullable<z.ZodNumber>>;
+        counts: z.ZodObject<{
+            events: z.ZodInt;
+            verified_tasks: z.ZodInt;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type CredentialResponse = z.infer<typeof CredentialResponse>;
+export declare const LeaderboardQuery: z.ZodObject<{
+    dimension: z.ZodUnion<readonly [z.ZodEnum<{
+        cost_latency: "cost_latency";
+        provenance: "provenance";
+        reliability: "reliability";
+        safety: "safety";
+    }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type LeaderboardQuery = z.infer<typeof LeaderboardQuery>;
+export declare const LeaderboardEntry: z.ZodObject<{
+    rank: z.ZodInt;
+    agentId: z.ZodString;
+    name: z.ZodString;
+    operator: z.ZodObject<{
+        login: z.ZodString;
+    }, z.core.$strict>;
+    version: z.ZodString;
+    value: z.ZodNumber;
+    verifiedTasks: z.ZodInt;
+}, z.core.$strict>;
+export type LeaderboardEntry = z.infer<typeof LeaderboardEntry>;
+export declare const LeaderboardResponse: z.ZodObject<{
+    dimension: z.ZodUnion<readonly [z.ZodEnum<{
+        cost_latency: "cost_latency";
+        provenance: "provenance";
+        reliability: "reliability";
+        safety: "safety";
+    }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+    entries: z.ZodArray<z.ZodObject<{
+        rank: z.ZodInt;
+        agentId: z.ZodString;
+        name: z.ZodString;
+        operator: z.ZodObject<{
+            login: z.ZodString;
+        }, z.core.$strict>;
+        version: z.ZodString;
+        value: z.ZodNumber;
+        verifiedTasks: z.ZodInt;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type LeaderboardResponse = z.infer<typeof LeaderboardResponse>;
+export declare const FeedKind: z.ZodEnum<{
+    flag: "flag";
+    registration: "registration";
+    score_change: "score_change";
+    task_verified: "task_verified";
+}>;
+export type FeedKind = z.infer<typeof FeedKind>;
+export declare const FeedFlagCode: z.ZodEnum<{
+    outcome_disagreement: "outcome_disagreement";
+}>;
+export type FeedFlagCode = z.infer<typeof FeedFlagCode>;
+export declare const FeedPayloads: {
+    registration: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    task_verified: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        taskId: z.ZodUUID;
+        taskType: z.ZodString;
+    }, z.core.$strict>;
+    score_change: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+        dimension: z.ZodUnion<readonly [z.ZodEnum<{
+            cost_latency: "cost_latency";
+            provenance: "provenance";
+            reliability: "reliability";
+            safety: "safety";
+        }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+        old: z.ZodNullable<z.ZodNumber>;
+        new: z.ZodNumber;
+    }, z.core.$strict>;
+    flag: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        code: z.ZodEnum<{
+            outcome_disagreement: "outcome_disagreement";
+        }>;
+        taskId: z.ZodUUID;
+    }, z.core.$strict>;
+};
+export type FeedPayload<K extends FeedKind> = z.infer<(typeof FeedPayloads)[K]>;
+export declare const FeedItem: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodInt;
+    kind: z.ZodLiteral<"registration">;
+    agentId: z.ZodNullable<z.ZodString>;
+    payload: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodInt;
+    kind: z.ZodLiteral<"task_verified">;
+    agentId: z.ZodNullable<z.ZodString>;
+    payload: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        taskId: z.ZodUUID;
+        taskType: z.ZodString;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodInt;
+    kind: z.ZodLiteral<"score_change">;
+    agentId: z.ZodNullable<z.ZodString>;
+    payload: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+        dimension: z.ZodUnion<readonly [z.ZodEnum<{
+            cost_latency: "cost_latency";
+            provenance: "provenance";
+            reliability: "reliability";
+            safety: "safety";
+        }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+        old: z.ZodNullable<z.ZodNumber>;
+        new: z.ZodNumber;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    id: z.ZodInt;
+    kind: z.ZodLiteral<"flag">;
+    agentId: z.ZodNullable<z.ZodString>;
+    payload: z.ZodObject<{
+        agentId: z.ZodString;
+        name: z.ZodString;
+        code: z.ZodEnum<{
+            outcome_disagreement: "outcome_disagreement";
+        }>;
+        taskId: z.ZodUUID;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>], "kind">;
+export type FeedItem = z.infer<typeof FeedItem>;
+export declare const FEED_RECENT_MAX = 200;
+export declare const FeedRecentQuery: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type FeedRecentQuery = z.infer<typeof FeedRecentQuery>;
+export declare const FeedRecentResponse: z.ZodObject<{
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodInt;
+        kind: z.ZodLiteral<"registration">;
+        agentId: z.ZodNullable<z.ZodString>;
+        payload: z.ZodObject<{
+            agentId: z.ZodString;
+            name: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strict>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodInt;
+        kind: z.ZodLiteral<"task_verified">;
+        agentId: z.ZodNullable<z.ZodString>;
+        payload: z.ZodObject<{
+            agentId: z.ZodString;
+            name: z.ZodString;
+            taskId: z.ZodUUID;
+            taskType: z.ZodString;
+        }, z.core.$strict>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodInt;
+        kind: z.ZodLiteral<"score_change">;
+        agentId: z.ZodNullable<z.ZodString>;
+        payload: z.ZodObject<{
+            agentId: z.ZodString;
+            name: z.ZodString;
+            version: z.ZodString;
+            dimension: z.ZodUnion<readonly [z.ZodEnum<{
+                cost_latency: "cost_latency";
+                provenance: "provenance";
+                reliability: "reliability";
+                safety: "safety";
+            }>, z.ZodTemplateLiteral<`competence:${string}`>]>;
+            old: z.ZodNullable<z.ZodNumber>;
+            new: z.ZodNumber;
+        }, z.core.$strict>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodInt;
+        kind: z.ZodLiteral<"flag">;
+        agentId: z.ZodNullable<z.ZodString>;
+        payload: z.ZodObject<{
+            agentId: z.ZodString;
+            name: z.ZodString;
+            code: z.ZodEnum<{
+                outcome_disagreement: "outcome_disagreement";
+            }>;
+            taskId: z.ZodUUID;
+        }, z.core.$strict>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+export type FeedRecentResponse = z.infer<typeof FeedRecentResponse>;
+export declare const StatsResponse: z.ZodObject<{
+    agents: z.ZodInt;
+    verifiedTasks: z.ZodInt;
+    eventsLast24h: z.ZodInt;
+}, z.core.$strict>;
+export type StatsResponse = z.infer<typeof StatsResponse>;
+export declare const ScoreRunResponse: z.ZodObject<{
+    scored: z.ZodInt;
+}, z.core.$strict>;
+export type ScoreRunResponse = z.infer<typeof ScoreRunResponse>;
+export declare const ErrorIssue: z.ZodObject<{
+    path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const ErrorResponse: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ErrorResponse = z.infer<typeof ErrorResponse>;