agora-skill 1.0.0

package/dist/tools/bid.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export const bidSchema = z.object({
+    task_id: z.string().describe('ID of the task to bid on'),
+    price: z.number().positive().describe('Your asking price in USDC'),
+    estimated_hours: z.number().min(1).max(720).describe('Estimated hours to complete (1-720)'),
+    message: z.string().max(1000).optional().describe('Pitch or context for your bid'),
+});
+export async function bid(client, params) {
+    const result = await client.submitBid({
+        taskId: params.task_id,
+        price: params.price,
+        estimatedHours: params.estimated_hours,
+        message: params.message,
+    });
+    return {
+        bid_id: result.id,
+        status: result.status,
+        price: `${params.price} USDC`,
+        message: `Bid submitted at ${params.price} USDC, ${params.estimated_hours}h estimated.`,
+    };
+}
+//# sourceMappingURL=bid.js.map

package/dist/tools/bid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bid.js","sourceRoot":"","sources":["../../src/tools/bid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAClE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC3F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CACnF,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,MAAmB,EAAE,MAAiB;IAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC,OAAO;QACtB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,MAAM,CAAC,eAAe;QACtC,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAA;IACF,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,OAAO;QAC7B,OAAO,EAAE,oBAAoB,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,eAAe,cAAc;KACxF,CAAA;AACH,CAAC"}

package/dist/tools/deliver.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { AgoraClient } from '../client.js';
+export declare const deliverSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    file_references: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    task_id: string;
+    content?: string | undefined;
+    file_references?: string[] | undefined;
+    notes?: string | undefined;
+}, {
+    task_id: string;
+    content?: string | undefined;
+    file_references?: string[] | undefined;
+    notes?: string | undefined;
+}>;
+export type DeliverParams = z.infer<typeof deliverSchema>;
+export declare function deliver(client: AgoraClient, params: DeliverParams): Promise<{
+    deliverable_id: string;
+    revision: number;
+    status: string;
+    message: string;
+}>;
+//# sourceMappingURL=deliver.d.ts.map

package/dist/tools/deliver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.d.ts","sourceRoot":"","sources":["../../src/tools/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa;;;;;GAavE"}

package/dist/tools/deliver.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export const deliverSchema = z.object({
+    task_id: z.string().describe('ID of the task to deliver for'),
+    content: z.string().max(50000).optional().describe('Text content of the deliverable (max 50k chars)'),
+    file_references: z.array(z.string()).max(10).optional().describe('URLs to deliverable files (max 10)'),
+    notes: z.string().max(2000).optional().describe('Delivery notes for the publisher'),
+});
+export async function deliver(client, params) {
+    const result = await client.deliver({
+        taskId: params.task_id,
+        content: params.content,
+        fileReferences: params.file_references,
+        notes: params.notes,
+    });
+    return {
+        deliverable_id: result.id,
+        revision: result.revision,
+        status: result.status,
+        message: 'Deliverables submitted. Awaiting publisher review for escrow release.',
+    };
+}
+//# sourceMappingURL=deliver.js.map

package/dist/tools/deliver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.js","sourceRoot":"","sources":["../../src/tools/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACrG,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACtG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACpF,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAmB,EAAE,MAAqB;IACtE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,OAAO;QACtB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,cAAc,EAAE,MAAM,CAAC,eAAe;QACtC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAA;IACF,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,uEAAuE;KACjF,CAAA;AACH,CAAC"}

package/dist/tools/publish.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { AgoraClient } from '../client.js';
+export declare const publishSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodString;
+    skill: z.ZodString;
+    budget: z.ZodNumber;
+    deadline: z.ZodString;
+    executor_type: z.ZodDefault<z.ZodEnum<["agent", "human", "hybrid"]>>;
+    acceptance_criteria: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    description: string;
+    skill: string;
+    budget: number;
+    deadline: string;
+    executor_type: "agent" | "human" | "hybrid";
+    acceptance_criteria?: string | undefined;
+}, {
+    title: string;
+    description: string;
+    skill: string;
+    budget: number;
+    deadline: string;
+    executor_type?: "agent" | "human" | "hybrid" | undefined;
+    acceptance_criteria?: string | undefined;
+}>;
+export type PublishParams = z.infer<typeof publishSchema>;
+export declare function publish(client: AgoraClient, params: PublishParams): Promise<{
+    task_id: string;
+    status: string;
+    budget: string;
+    message: string;
+}>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/tools/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/tools/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa;;;;;GAgBvE"}

package/dist/tools/publish.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export const publishSchema = z.object({
+    title: z.string().min(5).max(200).describe('What you need done (5-200 chars)'),
+    description: z.string().min(20).max(5000).describe('Detailed requirements (20-5000 chars)'),
+    skill: z.string().describe('Required capability (e.g., "compute", "nlp-sentiment", "legal-review")'),
+    budget: z.number().positive().describe('Payment amount in USDC (min 0.01)'),
+    deadline: z.string().describe('Deadline — shorthand like "30m", "2h", "1d" or ISO 8601'),
+    executor_type: z.enum(['agent', 'human', 'hybrid']).default('agent').describe('Who can do this: agent, human, or hybrid'),
+    acceptance_criteria: z.string().optional().describe('How to verify completion (auto-generated if omitted)'),
+});
+export async function publish(client, params) {
+    const result = await client.publishTask({
+        title: params.title,
+        description: params.description,
+        skill: params.skill,
+        budget: params.budget,
+        deadline: params.deadline,
+        executorRequirement: params.executor_type,
+        acceptanceCriteria: params.acceptance_criteria,
+    });
+    return {
+        task_id: result.id,
+        status: result.status,
+        budget: `${params.budget} USDC`,
+        message: `Task published. Listing stake required to go live.`,
+    };
+}
+//# sourceMappingURL=publish.js.map

package/dist/tools/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/tools/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC3F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;IACpG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC3E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IACxF,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACzH,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;CAC5G,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAmB,EAAE,MAAqB;IACtE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,mBAAmB,EAAE,MAAM,CAAC,aAAa;QACzC,kBAAkB,EAAE,MAAM,CAAC,mBAAmB;KAC/C,CAAC,CAAA;IACF,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,OAAO;QAC/B,OAAO,EAAE,oDAAoD;KAC9D,CAAA;AACH,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { AgoraClient } from '../client.js';
+export declare const searchSchema: z.ZodObject<{
+    skill: z.ZodOptional<z.ZodString>;
+    budget_min: z.ZodOptional<z.ZodNumber>;
+    budget_max: z.ZodOptional<z.ZodNumber>;
+    executor_type: z.ZodOptional<z.ZodEnum<["agent", "human", "hybrid"]>>;
+    keyword: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    keyword?: string | undefined;
+    skill?: string | undefined;
+    executor_type?: "agent" | "human" | "hybrid" | undefined;
+    budget_min?: number | undefined;
+    budget_max?: number | undefined;
+}, {
+    keyword?: string | undefined;
+    skill?: string | undefined;
+    executor_type?: "agent" | "human" | "hybrid" | undefined;
+    budget_min?: number | undefined;
+    budget_max?: number | undefined;
+    limit?: number | undefined;
+}>;
+export type SearchParams = z.infer<typeof searchSchema>;
+export declare function search(client: AgoraClient, params: SearchParams): Promise<{
+    count: number;
+    total: number;
+    tasks: Record<string, unknown>[];
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAOvB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,wBAAsB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;;;;GAcrE"}

package/dist/tools/search.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export const searchSchema = z.object({
+    skill: z.string().optional().describe('Filter by required skill (e.g., "compute", "design")'),
+    budget_min: z.number().optional().describe('Minimum budget in USDC'),
+    budget_max: z.number().optional().describe('Maximum budget in USDC'),
+    executor_type: z.enum(['agent', 'human', 'hybrid']).optional().describe('Filter by executor requirement'),
+    keyword: z.string().optional().describe('Full-text search in title and description'),
+    limit: z.number().default(10).describe('Max results to return (1-100)'),
+});
+export async function search(client, params) {
+    const result = await client.searchTasks({
+        skills: params.skill,
+        budgetMin: params.budget_min,
+        budgetMax: params.budget_max,
+        executorRequirement: params.executor_type,
+        keyword: params.keyword,
+        limit: params.limit,
+    });
+    return {
+        count: result.tasks.length,
+        total: result.total,
+        tasks: result.tasks,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC7F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACpE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACpE,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACzG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CACxE,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAmB,EAAE,MAAoB;IACpE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACtC,MAAM,EAAE,MAAM,CAAC,KAAK;QACpB,SAAS,EAAE,MAAM,CAAC,UAAU;QAC5B,SAAS,EAAE,MAAM,CAAC,UAAU;QAC5B,mBAAmB,EAAE,MAAM,CAAC,aAAa;QACzC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAA;IACF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAC1B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAA;AACH,CAAC"}

package/dist/tools/status.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { AgoraClient } from '../client.js';
+export declare const statusSchema: z.ZodObject<{
+    task_id: z.ZodOptional<z.ZodString>;
+    role: z.ZodDefault<z.ZodEnum<["publisher", "executor", "all"]>>;
+}, "strip", z.ZodTypeAny, {
+    role: "publisher" | "executor" | "all";
+    task_id?: string | undefined;
+}, {
+    task_id?: string | undefined;
+    role?: "publisher" | "executor" | "all" | undefined;
+}>;
+export type StatusParams = z.infer<typeof statusSchema>;
+export declare function status(client: AgoraClient, params: StatusParams): Promise<{
+    tasks: Record<string, unknown>[];
+    count?: undefined;
+} | {
+    count: number;
+    tasks: Record<string, unknown>[];
+}>;
+//# sourceMappingURL=status.d.ts.map

package/dist/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C,eAAO,MAAM,YAAY;;;;;;;;;EAGvB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD,wBAAsB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY;;;;;;GAWrE"}

package/dist/tools/status.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export const statusSchema = z.object({
+    task_id: z.string().optional().describe('Check a specific task (omit for all your tasks)'),
+    role: z.enum(['publisher', 'executor', 'all']).default('all').describe('Filter by your role'),
+});
+export async function status(client, params) {
+    if (params.task_id) {
+        const task = await client.getTaskStatus(params.task_id);
+        return { tasks: [task] };
+    }
+    const status = params.role === 'publisher' ? 'published' : undefined;
+    const result = await client.listTasks({ status });
+    return {
+        count: result.tasks.length,
+        tasks: result.tasks,
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC1F,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CAC9F,CAAC,CAAA;AAIF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAmB,EAAE,MAAoB;IACpE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACvD,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAA;IAC1B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAA;IACpE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IACjD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAC1B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "agora-skill",
+  "version": "1.0.0",
+  "description": "Agora marketplace skill — install once, your agent can publish, bid, and settle tasks",
+  "type": "module",
+  "bin": {
+    "agora-skill": "./dist/bin/agora-skill.js"
+  },
+  "main": "./dist/server.js",
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "test:unit": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@inquirer/prompts": "^7.0.0",
+    "commander": "^13.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.0"
+  }
+}

package/src/auth/credentials.ts

@@ -0,0 +1,83 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { randomBytes } from 'node:crypto'
+
+export interface AgentCredentials {
+  agent_id: string
+  agent_name: string
+  api_key: string
+  api_key_live: string | null
+  api_endpoint: string
+  wallet_address: string
+  environment: 'sandbox' | 'production'
+  created_at: string
+  key_rotated_at: string | null
+}
+
+const AGORA_DIR = join(homedir(), '.agora')
+const CREDENTIALS_DIR = join(AGORA_DIR, 'credentials')
+const WALLETS_DIR = join(AGORA_DIR, 'wallets')
+const DEFAULT_ENDPOINT = 'https://api.agora.youlidao.ai'
+
+export function getAgoraDir(): string {
+  return AGORA_DIR
+}
+
+export function ensureAgoraDirs(): void {
+  for (const dir of [AGORA_DIR, CREDENTIALS_DIR, WALLETS_DIR]) {
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true, mode: 0o700 })
+    }
+  }
+}
+
+export function loadCredentials(agentName = 'default'): AgentCredentials | null {
+  const credPath = join(CREDENTIALS_DIR, `${agentName}.json`)
+  if (!existsSync(credPath)) return null
+  try {
+    const raw = readFileSync(credPath, 'utf-8')
+    return JSON.parse(raw) as AgentCredentials
+  } catch {
+    return null
+  }
+}
+
+export function saveCredentials(creds: AgentCredentials, agentName = 'default'): void {
+  ensureAgoraDirs()
+  const credPath = join(CREDENTIALS_DIR, `${agentName}.json`)
+  writeFileSync(credPath, JSON.stringify(creds, null, 2), { mode: 0o600 })
+}
+
+export function generateApiKey(environment: 'sandbox' | 'production'): string {
+  const prefix = environment === 'sandbox' ? 'agora_sk_test_' : 'agora_sk_live_'
+  return prefix + randomBytes(24).toString('hex')
+}
+
+export function maskApiKey(key: string): string {
+  if (key.length <= 20) return key.slice(0, 10) + '****'
+  return key.slice(0, -8) + '****' + key.slice(-4)
+}
+
+export function getActiveEnvironment(creds: AgentCredentials): 'sandbox' | 'production' {
+  return creds.environment
+}
+
+export function getActiveApiKey(creds: AgentCredentials): string {
+  if (creds.environment === 'production' && creds.api_key_live) {
+    return creds.api_key_live
+  }
+  return creds.api_key
+}
+
+export function getApiEndpoint(creds: AgentCredentials): string {
+  return creds.api_endpoint || DEFAULT_ENDPOINT
+}
+
+export function listAgents(): string[] {
+  if (!existsSync(CREDENTIALS_DIR)) return []
+  const { readdirSync } = require('node:fs') as typeof import('node:fs')
+  return readdirSync(CREDENTIALS_DIR)
+    .filter((f: string) => f.endsWith('.json'))
+    .map((f: string) => f.replace('.json', ''))
+}

package/src/bin/agora-skill.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander'
+import { install } from '../installer.js'
+
+const program = new Command()
+  .name('agora-skill')
+  .description('Agora marketplace skill — install once, your agent can publish, bid, and settle tasks')
+  .version('1.0.0')
+
+program
+  .command('install')
+  .description('Install the Agora skill for your agent')
+  .option('--endpoint <url>', 'API endpoint override')
+  .action(async (opts: { endpoint?: string }) => {
+    await install({ endpoint: opts.endpoint })
+  })
+
+program
+  .command('serve')
+  .description('Start the Agora MCP server (used by agent platforms)')
+  .action(async () => {
+    await import('../server.js')
+  })
+
+program.parse()

package/src/client.ts

@@ -0,0 +1,186 @@
+import { randomUUID } from 'node:crypto'
+import { type AgentCredentials, getActiveApiKey, getApiEndpoint } from './auth/credentials.js'
+
+export class AgoraClient {
+  private readonly endpoint: string
+  private readonly apiKey: string
+
+  constructor(creds: AgentCredentials) {
+    this.endpoint = getApiEndpoint(creds)
+    this.apiKey = getActiveApiKey(creds)
+  }
+
+  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {
+    const url = `${this.endpoint}${path}`
+    const headers: Record<string, string> = {
+      'Authorization': `Bearer ${this.apiKey}`,
+      'Content-Type': 'application/json',
+      'X-Request-Id': randomUUID(),
+      'X-Timestamp': new Date().toISOString(),
+      'X-Protocol-Version': '1.0.0',
+    }
+
+    const res = await fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    })
+
+    if (!res.ok) {
+      const errBody = await res.text()
+      throw new Error(`Agora API error ${res.status}: ${errBody}`)
+    }
+
+    return res.json() as Promise<T>
+  }
+
+  // --- Registration (unauthenticated) ---
+
+  static async register(endpoint: string, params: {
+    name: string
+    capabilities: string[]
+    walletAddress: string
+    description?: string
+  }): Promise<{ agent: { id: string; apiKey: string; name: string }; protocol: Record<string, unknown> }> {
+    const url = `${endpoint}/v1/agents`
+    const res = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-Request-Id': randomUUID(),
+      },
+      body: JSON.stringify({
+        name: params.name,
+        capabilities: params.capabilities,
+        walletAddress: params.walletAddress,
+        description: params.description || `Agent ${params.name} on Agora`,
+      }),
+    })
+
+    if (!res.ok) {
+      const errBody = await res.text()
+      throw new Error(`Registration failed (${res.status}): ${errBody}`)
+    }
+
+    return res.json() as Promise<{ agent: { id: string; apiKey: string; name: string }; protocol: Record<string, unknown> }>
+  }
+
+  // --- Tasks ---
+
+  async publishTask(params: {
+    title: string
+    description: string
+    skill: string
+    budget: number
+    deadline: string
+    executorRequirement?: string
+    acceptanceCriteria?: string
+    executionEnvironment?: string
+  }): Promise<{ id: string; status: string }> {
+    // Convert deadline shorthand (e.g., "2h", "30m") to ISO 8601
+    const deadlineDate = resolveDeadline(params.deadline)
+
+    return this.request('POST', '/v1/tasks', {
+      title: params.title,
+      description: params.description,
+      requiredSkills: [params.skill],
+      budget: params.budget,
+      deadline: deadlineDate,
+      initiatorRole: 'AA',
+      executorRequirement: mapExecutorType(params.executorRequirement || 'agent'),
+      executionEnvironment: params.executionEnvironment || 'DIG',
+      taskComplexity: 'ATM',
+      acceptanceCriteria: params.acceptanceCriteria || `Complete the task as described: ${params.title}`,
+      paymentMethod: 'x402',
+    })
+  }
+
+  async searchTasks(params: {
+    skills?: string
+    budgetMin?: number
+    budgetMax?: number
+    executorRequirement?: string
+    keyword?: string
+    limit?: number
+  }): Promise<{ tasks: Array<Record<string, unknown>>; total: number }> {
+    const query = new URLSearchParams()
+    if (params.skills) query.set('skills', params.skills)
+    if (params.budgetMin) query.set('budgetMin', String(params.budgetMin))
+    if (params.budgetMax) query.set('budgetMax', String(params.budgetMax))
+    if (params.executorRequirement) query.set('executorRequirement', params.executorRequirement)
+    if (params.keyword) query.set('keyword', params.keyword)
+    if (params.limit) query.set('pageSize', String(params.limit))
+
+    return this.request('GET', `/v1/tasks/search?${query.toString()}`)
+  }
+
+  async submitBid(params: {
+    taskId: string
+    price: number
+    estimatedHours: number
+    message?: string
+  }): Promise<{ id: string; status: string }> {
+    return this.request('POST', `/v1/tasks/${params.taskId}/bids`, {
+      price: params.price,
+      estimatedHours: params.estimatedHours,
+      message: params.message,
+    })
+  }
+
+  async deliver(params: {
+    taskId: string
+    content?: string
+    fileReferences?: string[]
+    notes?: string
+  }): Promise<{ id: string; status: string; revision: number }> {
+    return this.request('POST', `/v1/tasks/${params.taskId}/deliverables`, {
+      content: params.content,
+      fileReferences: params.fileReferences,
+      notes: params.notes,
+    })
+  }
+
+  async getTaskStatus(taskId: string): Promise<Record<string, unknown>> {
+    return this.request('GET', `/v1/tasks/${taskId}`)
+  }
+
+  async listTasks(params?: {
+    status?: string
+    page?: number
+    pageSize?: number
+  }): Promise<{ tasks: Array<Record<string, unknown>>; total: number }> {
+    const query = new URLSearchParams()
+    if (params?.status) query.set('status', params.status)
+    if (params?.page) query.set('page', String(params.page))
+    if (params?.pageSize) query.set('pageSize', String(params.pageSize))
+    return this.request('GET', `/v1/tasks?${query.toString()}`)
+  }
+}
+
+function mapExecutorType(friendly: string): string {
+  const map: Record<string, string> = {
+    'agent': 'MX',
+    'human': 'HR',
+    'hybrid': 'FL',
+    // Also accept raw enum values
+    'MX': 'MX',
+    'HR': 'HR',
+    'FL': 'FL',
+  }
+  return map[friendly] || 'FL'
+}
+
+function resolveDeadline(shorthand: string): string {
+  const now = new Date()
+  const match = shorthand.match(/^(\d+)(m|h|d)$/)
+  if (match) {
+    const [, num, unit] = match
+    const value = parseInt(num!, 10)
+    if (unit === 'm') now.setMinutes(now.getMinutes() + value)
+    else if (unit === 'h') now.setHours(now.getHours() + value)
+    else if (unit === 'd') now.setDate(now.getDate() + value)
+    return now.toISOString()
+  }
+  // Assume ISO 8601 already
+  return shorthand
+}