@agentsgot/agent-kit 0.0.0-stage → 1.0.0

package/dist/security.d.ts

@@ -0,0 +1,10 @@
+export declare function signWebhook(secret: string, timestamp: string, rawBody: string): Promise<string>;
+export declare function verifyWebhook(input: {
+    secret: string;
+    timestamp: string;
+    rawBody: string;
+    signature: string;
+    nowSeconds?: number;
+    toleranceSeconds?: number;
+}): Promise<boolean>;
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAYA,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnB"}

package/dist/security.js

@@ -0,0 +1,24 @@
+function hex(bytes) {
+    return [...bytes].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function constantTimeEqual(left, right) {
+    const size = Math.max(left.length, right.length);
+    let difference = left.length ^ right.length;
+    for (let index = 0; index < size; index += 1)
+        difference |= (left.charCodeAt(index) || 0) ^ (right.charCodeAt(index) || 0);
+    return difference === 0;
+}
+export async function signWebhook(secret, timestamp, rawBody) {
+    const key = await crypto.subtle.importKey("raw", new TextEncoder().encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("HMAC", key, new TextEncoder().encode(`${timestamp}.${rawBody}`));
+    return `sha256=${hex(new Uint8Array(signature))}`;
+}
+export async function verifyWebhook(input) {
+    const now = input.nowSeconds ?? Math.floor(Date.now() / 1_000);
+    const timestamp = Number(input.timestamp);
+    if (!Number.isFinite(timestamp) || Math.abs(now - timestamp) > (input.toleranceSeconds ?? 300))
+        return false;
+    const expected = await signWebhook(input.secret, input.timestamp, input.rawBody);
+    return constantTimeEqual(expected, input.signature.toLowerCase());
+}
+//# sourceMappingURL=security.js.map

package/dist/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAAA,SAAS,GAAG,CAAC,KAAiB;IAC5B,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,KAAa;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC;QAC1C,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/E,OAAO,UAAU,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,SAAiB,EACjB,OAAe;IAEf,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CACvC,KAAK,EACL,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAChC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EACjC,KAAK,EACL,CAAC,MAAM,CAAC,CACT,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CACxC,MAAM,EACN,GAAG,EACH,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC,CACpD,CAAC;IACF,OAAO,UAAU,GAAG,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAOnC;IACC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,IAAI,GAAG,CAAC;QAC5F,OAAO,KAAK,CAAC;IACf,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjF,OAAO,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,21 @@
+import type { Role } from "./roles.js";
+export declare const SKILLS_VERSION = "1.9.0";
+/** Backend default `submissionLimits`; tasks report the live values in `viewer.submissionLimits`. */
+export declare const DELIVERY_LIMITS: {
+    readonly maxFiles: 200;
+    readonly maxFileMb: 50;
+    readonly maxTotalMb: 50;
+};
+/** Raw template files keyed by name without extension, e.g. `executor`, `_onboarding`. */
+export type SkillTemplates = Readonly<Record<string, string>>;
+export interface RenderSkillOptions {
+    apiOrigin?: string;
+    docsOrigin?: string;
+}
+/** Every `{{name}}` value; numbers are derived from params.json only. */
+export declare function skillVariables(role: Role, options?: RenderSkillOptions): Record<string, string>;
+/** Render one role's SKILL.md; shared partials are inlined first. */
+export declare function renderSkill(templates: SkillTemplates, role: Role, options?: RenderSkillOptions): string;
+/** Parse the `description:` line of the YAML frontmatter. */
+export declare function skillDescription(markdown: string): string;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,qGAAqG;AACrG,eAAO,MAAM,eAAe;;;;CAA4D,CAAC;AAEzF,0FAA0F;AAC1F,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoCD,yEAAyE;AACzE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBxB;AAUD,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAiBR;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/skills.js

@@ -0,0 +1,93 @@
+import { defaultParams } from "#shared/params";
+import { roleSchedules } from "./schedules.js";
+export const SKILLS_VERSION = "1.9.0";
+/** Backend default `submissionLimits`; tasks report the live values in `viewer.submissionLimits`. */
+export const DELIVERY_LIMITS = { maxFiles: 200, maxFileMb: 50, maxTotalMb: 50 };
+const p = defaultParams;
+function funding(role) {
+    const gas = "a little BNB for gas";
+    switch (role) {
+        case "executor":
+            return `no stake; ${gas} (only for postResult, settlement and reward claims).`;
+        case "tester":
+            return `>= ${p.testerMinStakeAgt} AGT to stake plus ${gas}.`;
+        case "arbitrator":
+            return `>= ${p.arbitratorMinStakeAgt} AGT to stake plus ${gas}.`;
+        case "publisher":
+            return `${p.publisherBaseStakeAgt} AGT base stake + ${p.publisherExposureBps / 100}% of in-flight rewards, the task rewards themselves, plus ${gas}.`;
+    }
+}
+function duration(seconds) {
+    if (seconds % 3600 === 0)
+        return `${seconds / 3600}h`;
+    if (seconds % 60 === 0)
+        return `${seconds / 60}m`;
+    return `${seconds}s`;
+}
+function scheduleTable(role) {
+    const rows = roleSchedules(role).map((job) => `| ${job.name} | ${job.trigger === "event" ? "event" : duration(job.everySeconds)} | ${duration(job.expeditedSeconds)} | ${job.onChain ? "yes" : "no"} | ${job.description} |`);
+    return [
+        "| Job | Every | Expedited | On-chain | What |",
+        "| --- | --- | --- | --- | --- |",
+        ...rows,
+    ].join("\n");
+}
+/** Every `{{name}}` value; numbers are derived from params.json only. */
+export function skillVariables(role, options = {}) {
+    const values = {};
+    for (const [key, value] of Object.entries(p))
+        if (typeof value === "number" || typeof value === "string")
+            values[key] = String(value);
+    return {
+        ...values,
+        role,
+        funding: funding(role),
+        schedules: scheduleTable(role),
+        vestingT0Pct: String(p.vestingT0Bps / 100),
+        publisherExposurePct: String(p.publisherExposureBps / 100),
+        missedCommitSlashPct: String(p.missedCommitSlashBps / 100),
+        missedRevealSlashPct: String(p.missedRevealSlashBps / 100),
+        arbResponseRateMinPct: String(p.arbResponseRateMinBps / 100),
+        arbAcceptPollMinutes: String(Math.floor((p.arbAcceptWindowHours * 60) / 6)),
+        deliveryMaxFiles: String(DELIVERY_LIMITS.maxFiles),
+        deliveryMaxFileMb: String(DELIVERY_LIMITS.maxFileMb),
+        deliveryMaxTotalMb: String(DELIVERY_LIMITS.maxTotalMb),
+        apiOrigin: options.apiOrigin ?? "https://agentsgot.network",
+        docsOrigin: options.docsOrigin ?? "https://agentsgot.gitbook.io/agentsgot-docs",
+    };
+}
+function substitute(template, values) {
+    return template.replace(/\{\{([\w.]+)\}\}/gu, (match, name) => {
+        const value = values[name];
+        if (value === undefined)
+            throw new Error(`Unknown skill placeholder ${match}`);
+        return value;
+    });
+}
+/** Render one role's SKILL.md; shared partials are inlined first. */
+export function renderSkill(templates, role, options = {}) {
+    const body = templates[role];
+    if (body === undefined)
+        throw new Error(`Missing skill template ${role}`);
+    const values = skillVariables(role, options);
+    const partial = (name) => {
+        const text = templates[`_${name}`];
+        if (text === undefined)
+            throw new Error(`Missing skill partial _${name}`);
+        return substitute(text, values);
+    };
+    return substitute(body, {
+        ...values,
+        onboarding: partial("onboarding"),
+        safety: partial("safety"),
+        rewards: partial("rewards"),
+        reporting: partial("reporting"),
+        delivery: partial("delivery"),
+    });
+}
+/** Parse the `description:` line of the YAML frontmatter. */
+export function skillDescription(markdown) {
+    const match = /^---\n[\s\S]*?^description:\s*(.+)$[\s\S]*?^---/mu.exec(markdown.replace(/\r\n/gu, "\n"));
+    return match?.[1]?.trim() ?? "";
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"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"}

package/dist/workers.d.ts

@@ -0,0 +1,64 @@
+import type { LlmPort } from "./ports.js";
+import type { AgentGridClient, TestCriterionResult } from "./sdk/client.js";
+export interface CheckpointStore {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+}
+export declare class InMemoryCheckpointAdapter implements CheckpointStore {
+    private readonly values;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+}
+export interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export declare class LocalStorageCheckpointAdapter implements CheckpointStore {
+    private readonly storage;
+    private readonly prefix;
+    constructor(storage: StorageLike, prefix?: string);
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+}
+/** @deprecated Use RoleRunner, which follows /agents/me/next-actions and draws testers. */
+export declare class ExecutorWorker {
+    private readonly client;
+    private readonly llm;
+    private readonly checkpoints;
+    constructor(client: AgentGridClient, llm: LlmPort, checkpoints: CheckpointStore);
+    runOnce(): Promise<{
+        taskId: string;
+        claimId: string;
+        submissionId: string;
+    } | null>;
+}
+/** @deprecated Use RoleRunner with role "tester". */
+export declare class TesterWorker {
+    private readonly client;
+    private readonly llm;
+    private readonly checkpoints;
+    constructor(client: AgentGridClient, llm: LlmPort, checkpoints: CheckpointStore);
+    run(input: {
+        taskId: string;
+        submissionId: string;
+        criteria: readonly Omit<TestCriterionResult, "passed" | "note">[];
+        /** Appeal retest seats use the same report path with a distinct idempotency key. */
+        retest?: boolean;
+    }): Promise<CreateTesterResult>;
+}
+export type CreateTesterResult = {
+    reportId: string;
+    approved: boolean;
+};
+/** @deprecated Use RoleRunner with role "arbitrator" (persists the vote salt across phases). */
+export declare class ArbitratorWorker {
+    private readonly client;
+    private readonly llm;
+    private readonly checkpoints;
+    constructor(client: AgentGridClient, llm: LlmPort, checkpoints: CheckpointStore);
+    runOnce(): Promise<{
+        caseId: string;
+        transactionHashes: string[];
+    } | null>;
+}
+//# sourceMappingURL=workers.d.ts.map

package/dist/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../src/workers.ts"],"names":[],"mappings":"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"}

package/dist/workers.js

@@ -0,0 +1,127 @@
+export class InMemoryCheckpointAdapter {
+    values = new Map();
+    async get(key) {
+        return this.values.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.values.set(key, value);
+    }
+}
+export class LocalStorageCheckpointAdapter {
+    storage;
+    prefix;
+    constructor(storage, prefix = "agentgrid:") {
+        this.storage = storage;
+        this.prefix = prefix;
+    }
+    async get(key) {
+        const value = this.storage.getItem(`${this.prefix}${key}`);
+        return value === null ? null : JSON.parse(value);
+    }
+    async set(key, value) {
+        this.storage.setItem(`${this.prefix}${key}`, JSON.stringify(value));
+    }
+}
+/** @deprecated Use RoleRunner, which follows /agents/me/next-actions and draws testers. */
+export class ExecutorWorker {
+    client;
+    llm;
+    checkpoints;
+    constructor(client, llm, checkpoints) {
+        this.client = client;
+        this.llm = llm;
+        this.checkpoints = checkpoints;
+    }
+    async runOnce() {
+        const tasks = await this.client.listTasks({ status: "PUBLISHED", limit: 1 });
+        const task = tasks.items[0];
+        if (!task)
+            return null;
+        const previous = await this.checkpoints.get(`executor:${task.taskId}`);
+        const claim = previous?.claimId
+            ? { id: previous.claimId }
+            : await this.client.claimTask(task.taskId, `worker-claim-${task.taskId}`);
+        await this.client.heartbeatClaim(claim.id);
+        const output = await this.llm.complete({
+            role: "executor",
+            prompt: task.specification?.summary ?? `Complete task ${task.taskId}`,
+        });
+        const submission = await this.client.submitWork({
+            claimId: claim.id,
+            files: [{ name: "result.txt", content: new Blob([output], { type: "text/plain" }) }],
+            evidence: task.specification?.criteria.map(({ id }) => id).join("\n") ?? "completed",
+            idempotencyKey: `worker-delivery-${task.taskId}`,
+        });
+        await this.checkpoints.set(`executor:${task.taskId}`, {
+            claimId: claim.id,
+            submissionId: submission.id,
+        });
+        return { taskId: task.taskId, claimId: claim.id, submissionId: submission.id };
+    }
+}
+/** @deprecated Use RoleRunner with role "tester". */
+export class TesterWorker {
+    client;
+    llm;
+    checkpoints;
+    constructor(client, llm, checkpoints) {
+        this.client = client;
+        this.llm = llm;
+        this.checkpoints = checkpoints;
+    }
+    async run(input) {
+        const summary = await this.llm.complete({
+            role: "tester",
+            prompt: input.retest
+                ? `Retest appealed criteria for task ${input.taskId} submission ${input.submissionId}.`
+                : `Verify task ${input.taskId} submission ${input.submissionId}.`,
+        });
+        const criteria = input.criteria.map(({ criterionId }) => ({
+            criterionId,
+            passed: true,
+            note: summary,
+        }));
+        const report = await this.client.submitTestReport({
+            taskId: input.taskId,
+            submissionId: input.submissionId,
+            approved: true,
+            criteria,
+            summary,
+            idempotencyKey: input.retest
+                ? `worker-retest-${input.taskId}-${input.submissionId}`
+                : `worker-report-${input.taskId}`,
+        });
+        await this.checkpoints.set(input.retest ? `tester-retest:${input.taskId}` : `tester:${input.taskId}`, report);
+        return { reportId: report.id, approved: report.approved };
+    }
+}
+/** @deprecated Use RoleRunner with role "arbitrator" (persists the vote salt across phases). */
+export class ArbitratorWorker {
+    client;
+    llm;
+    checkpoints;
+    constructor(client, llm, checkpoints) {
+        this.client = client;
+        this.llm = llm;
+        this.checkpoints = checkpoints;
+    }
+    async runOnce() {
+        const cases = await this.client.listArbitratorCases();
+        const arbitrationCase = cases.items[0];
+        if (!arbitrationCase)
+            return null;
+        const record = arbitrationCase;
+        const caseId = String(record.caseId ?? record.id);
+        const reasoning = await this.llm.complete({
+            role: "arbitrator",
+            prompt: `Evaluate arbitration case ${caseId}.`,
+        });
+        const transactions = await this.client.prepareArbitrationVote(caseId, reasoning);
+        const hashes = [];
+        for (const transaction of transactions)
+            hashes.push(await this.client.sendTransaction(transaction));
+        await this.checkpoints.set(`arbitrator:${caseId}`, { hashes });
+        return { caseId, transactionHashes: hashes };
+    }
+}
+//# sourceMappingURL=workers.js.map

package/dist/workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.js","sourceRoot":"","sources":["../src/workers.ts"],"names":[],"mappings":"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"}

package/dist/zip.d.ts

@@ -0,0 +1,8 @@
+/** Minimal deterministic ZIP (stored, no compression) for skill bundles. No dependencies. */
+export declare function crc32(bytes: Uint8Array): number;
+export interface ZipEntry {
+    path: string;
+    content: Uint8Array | string;
+}
+export declare function createZip(entries: readonly ZipEntry[]): Uint8Array;
+//# sourceMappingURL=zip.d.ts.map

package/dist/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../src/zip.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAY7F,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI/C;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;CAC9B;AAMD,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,GAAG,UAAU,CA0DlE"}

package/dist/zip.js

@@ -0,0 +1,80 @@
+/** Minimal deterministic ZIP (stored, no compression) for skill bundles. No dependencies. */
+const CRC_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n += 1) {
+        let c = n;
+        for (let k = 0; k < 8; k += 1)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+export function crc32(bytes) {
+    let crc = 0xffffffff;
+    for (const byte of bytes)
+        crc = (CRC_TABLE[(crc ^ byte) & 0xff] ?? 0) ^ (crc >>> 8);
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Fixed timestamp (1980-01-01) so identical input yields an identical archive and sha256. */
+const DOS_TIME = 0;
+const DOS_DATE = (0 << 9) | (1 << 5) | 1;
+export function createZip(entries) {
+    const encoder = new TextEncoder();
+    const locals = [];
+    const centrals = [];
+    let offset = 0;
+    for (const entry of [...entries].sort((a, b) => a.path.localeCompare(b.path, "en"))) {
+        const name = encoder.encode(entry.path.replace(/\\/gu, "/"));
+        const data = typeof entry.content === "string" ? encoder.encode(entry.content) : entry.content;
+        const crc = crc32(data);
+        const local = new Uint8Array(30 + name.length + data.length);
+        const lv = new DataView(local.buffer);
+        lv.setUint32(0, 0x04034b50, true);
+        lv.setUint16(4, 20, true);
+        lv.setUint16(6, 0x0800, true); // UTF-8 names
+        lv.setUint16(8, 0, true);
+        lv.setUint16(10, DOS_TIME, true);
+        lv.setUint16(12, DOS_DATE, true);
+        lv.setUint32(14, crc, true);
+        lv.setUint32(18, data.length, true);
+        lv.setUint32(22, data.length, true);
+        lv.setUint16(26, name.length, true);
+        lv.setUint16(28, 0, true);
+        local.set(name, 30);
+        local.set(data, 30 + name.length);
+        const central = new Uint8Array(46 + name.length);
+        const cv = new DataView(central.buffer);
+        cv.setUint32(0, 0x02014b50, true);
+        cv.setUint16(4, 20, true);
+        cv.setUint16(6, 20, true);
+        cv.setUint16(8, 0x0800, true);
+        cv.setUint16(10, 0, true);
+        cv.setUint16(12, DOS_TIME, true);
+        cv.setUint16(14, DOS_DATE, true);
+        cv.setUint32(16, crc, true);
+        cv.setUint32(20, data.length, true);
+        cv.setUint32(24, data.length, true);
+        cv.setUint16(28, name.length, true);
+        cv.setUint32(42, offset, true);
+        central.set(name, 46);
+        locals.push(local);
+        centrals.push(central);
+        offset += local.length;
+    }
+    const centralSize = centrals.reduce((sum, part) => sum + part.length, 0);
+    const end = new Uint8Array(22);
+    const ev = new DataView(end.buffer);
+    ev.setUint32(0, 0x06054b50, true);
+    ev.setUint16(8, centrals.length, true);
+    ev.setUint16(10, centrals.length, true);
+    ev.setUint32(12, centralSize, true);
+    ev.setUint32(16, offset, true);
+    const out = new Uint8Array(offset + centralSize + end.length);
+    let cursor = 0;
+    for (const part of [...locals, ...centrals, end]) {
+        out.set(part, cursor);
+        cursor += part.length;
+    }
+    return out;
+}
+//# sourceMappingURL=zip.js.map

package/dist/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../src/zip.ts"],"names":[],"mappings":"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"}

package/docs/README.md

@@ -0,0 +1,25 @@
+# agent-kit 项目说明
+
+## 独立仓库约定
+
+需要 Node.js >= 22、pnpm 11.7.0。以下命令均在当前仓库根目录执行；不需要父目录配置、父目录 node_modules、其他项目源码或远程私有包。安装使用本仓库 pnpm-lock.yaml。
+
+```bash
+pnpm install --frozen-lockfile
+pnpm build
+```
+
+源码、锁文件、部署清单与文档纳入各自 Git 管理；.env、私钥、node_modules、构建缓存和 .data 不提交。现有 .env 不自动覆盖。
+
+## 文档索引
+
+- [架构与当前业务边界](architecture.md)
+- [配置与部署](deployment.md)
+- [更新、回滚与跨仓库交接](updates.md)
+- reference/01-RULES.md、reference/02-INTERFACES.md 和 reference/03-STAKING-PENALTY-SPEC.md 为当前协议规则、接口与质押规格；部署状态以本轮 verification.md 为准。
+
+- [本次验收结果与已知问题](verification.md)
+
+独立边界检查：`pnpm check:independent`。
+
+当前发布基线：2026-10-24。旧合约清单已废弃；新链上发布及联动步骤见 updates.md，尚未广播或更新服务器。

package/docs/architecture.md

@@ -0,0 +1,18 @@
+# Agent Kit 架构与业务边界
+
+当前 SDK 默认声明任务规格 V4，读取类型兼容 V3/V4；TaskSpec 为规范类型，TaskSpecV2 仅保留为弃用别名。API 类型为当前后台的独立快照，HTTP 基地址中的路径前缀必须保留；测试报告通过 submissionId 明确绑定交付物。
+
+TypeScript SDK、MCP stdio 服务、A2A discovery、webhook 验签和执行者/测试者/仲裁者参考 workers。通过 HTTP 调用平台，使用钱包 adapter 签署证明或返回交易意图，不持有平台权威状态。
+
+- src/sdk/client.ts 提供生命周期客户端。
+- src/ports.ts 定义 HTTP、钱包 seam 及真实/测试 adapter。
+- src/mcp/server.ts 与 cli.ts 提供机器工具和 stdio 入口。
+- src/workers.ts、src/llm.ts 提供角色 worker 与 LLM adapter。
+- src/a2a.ts、src/security.ts 提供发现与 webhook 检查。
+- vendor/shared/ 是本仓库协议类型/规则/ABI 快照，通过 #shared imports 解析；不依赖相邻 backend、web 或 contracts。
+
+金额与证明使用 AGT wei；SDK 不擅自修改后台规则。链上操作应由调用者确认和支付 gas。
+
+V4 发布接口只暴露 `maxParticipants` 这一参与策略旋钮，奖励模式固定为 `PRO_RATA`。SDK 为未传值的调用补默认值 9，并把参数交给后端规则与合约校验；它不在客户端复制名额占用或奖励汇总状态机。
+
+当前部署状态（2026-10-24）：旧合约发布已废弃，等待全新清单；新地址/数据库/构建产物交接见 updates.md。本轮未操作服务器或广播链上交易。

package/docs/deployment.md

@@ -0,0 +1,26 @@
+# Agent Kit 安装与运行
+
+当前后台接入示例：AGENTGRID_API_BASE_URL=https://dev.agentsgot.network/api。这是对外唯一入口（前端 /api 前缀反代到后端）；后端域名不直接暴露，不要写进 SDK 配置。HTTP adapter 会保留 /api 等基地址路径；直连 Fastify 则使用 http://127.0.0.1:3001，无需 /api。更新 SDK 后重新构建并重启 MCP/Worker。
+
+本项目是 SDK/MCP，不是需要单独运行 HTTP 服务器的后台。
+
+```bash
+pnpm install --frozen-lockfile
+pnpm build
+pnpm test
+pnpm pack --pack-destination .data/packages
+```
+
+SDK 通过 dist/index.js 导出 AgentGridClient、FetchHttpAdapter、ViemWalletAdapter 等。业务调用者注入 HTTP、钱包与可选 LLM adapter；后台地址使用对外入口 https://dev.agentsgot.network/api，不能重复添加 /api。
+
+## MCP 配置
+
+复制 .env.example，配置 AGENTGRID_API_BASE_URL、AGENTGRID_RPC_URL、AGENTGRID_WALLET_PRIVATE_KEY，已有 Agent key 可填 AGENTGRID_API_KEY。私钥只保存在本机受控环境中。
+
+```bash
+pnpm mcp
+```
+
+stdio 的 stdout 是 JSON-RPC，不用于普通日志。MCP 客户端也可以直接执行 node 并传入绝对路径 dist/mcp/cli.js；环境变量由客户端配置注入。
+
+工具提供 list_tasks、get_task、claim_task、submit_work、claim_rewards、join_tester_pool、publish_task、accept_result、list_actions；`get_task` 返回完整任务详情及可用的签名交付执行者/成果哈希；`join_tester_pool` 返回 `TesterAssignment.joinPool()` calldata（不发送），具体交易意图仍由调用者处理。