openpond-sdk 0.1.2 → 0.1.3

package/TASKSETS.md

@@ -0,0 +1,31 @@
+# Published Taskset inventory
+
+`openpond-sdk/taskset-catalog` provides authenticated, paginated metadata reads
+for the selected hosted workspace. The service applies workspace access and
+optional Model Project attachment filtering before returning records.
+
+```ts
+import { OpenPondTasksetCatalogClient } from "openpond-sdk/taskset-catalog";
+
+const tasksets = new OpenPondTasksetCatalogClient({
+  baseUrl: "https://api.openpond.ai",
+  apiKey,
+  teamId,
+});
+const page = await tasksets.list({ limit: 30, modelProjectId });
+const item = await tasksets.get(page.items[0].id);
+const selected = await tasksets.resolve(item.release);
+const next = page.nextCursor
+  ? await tasksets.list({ limit: 30, modelProjectId, afterId: page.nextCursor })
+  : null;
+```
+
+The item's `id` is the hosted inventory identity. Its `release` pins the portable
+ID, revision and content hash used in model configuration. Metadata reads contain
+no task rows, private verifier source or object-store locations. Publication and
+package byte counts do not establish grading or training readiness.
+
+The client rejects responses for a different workspace or requested resource,
+limits catalog responses to 4 MiB, supports abort signals, and does not follow
+redirects with credentials. `OpenPondTasksetCatalogError` preserves HTTP status and
+the service's error code.

package/dist/taskset-catalog.js

@@ -0,0 +1,114 @@
+// src/taskset-catalog.ts
+import { z } from "zod";
+var IdSchema = z.string().trim().min(1).max(500);
+var HashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+var TasksetCatalogReleaseRefSchema = z.object({ id: IdSchema, revision: z.number().int().positive(), contentHash: HashSchema }).strict();
+var HostedTasksetSummarySchema = z.object({
+  schemaVersion: z.literal("openpond.hostedTasksetSummary.v1"),
+  id: IdSchema,
+  teamId: IdSchema,
+  release: TasksetCatalogReleaseRefSchema,
+  name: z.string().min(1).max(500),
+  description: z.string().max(2e4),
+  taskCount: z.number().int().nonnegative(),
+  buildIntent: z.string().min(1).max(100),
+  methodHint: z.string().min(1).max(100).nullable(),
+  packageBytes: z.number().int().nonnegative().nullable(),
+  storedBytes: z.number().int().nonnegative().nullable(),
+  createdAt: z.string().datetime({ offset: true })
+}).strict();
+var TasksetCatalogQuerySchema = z.object({
+  afterId: IdSchema.optional(),
+  limit: z.number().int().min(1).max(100).default(30),
+  modelProjectId: IdSchema.optional()
+}).strict();
+var TasksetCatalogPageSchema = z.object({
+  items: z.array(HostedTasksetSummarySchema).max(100),
+  nextCursor: IdSchema.nullable()
+}).strict();
+var TasksetCatalogErrorSchema = z.object({
+  code: z.string().min(1),
+  message: z.string().min(1)
+}).strict();
+var OpenPondTasksetCatalogError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "OpenPondTasksetCatalogError";
+  }
+  status;
+  code;
+};
+var OpenPondTasksetCatalogClient = class {
+  #options;
+  constructor(options) {
+    if (!options.apiKey.trim() || !options.teamId.trim()) throw new Error("Taskset API key and workspace are required.");
+    const url = new URL(options.baseUrl);
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash) throw new Error("Taskset base URL must be an HTTP(S) endpoint without credentials, query, or fragment.");
+    this.#options = { ...options, baseUrl: url.toString().replace(/\/+$/, "") };
+  }
+  async list(query = {}, options = {}) {
+    const parsed = TasksetCatalogQuerySchema.parse(query);
+    const search = new URLSearchParams({ limit: String(parsed.limit) });
+    if (parsed.afterId) search.set("afterId", parsed.afterId);
+    if (parsed.modelProjectId) search.set("modelProjectId", parsed.modelProjectId);
+    const page = TasksetCatalogPageSchema.parse(await this.#request(`?${search}`, options.signal));
+    if (page.items.length > parsed.limit || page.items.some((item) => item.teamId !== this.#options.teamId)) throw new OpenPondTasksetCatalogError(502, "catalog_scope_mismatch", "Taskset inventory did not match the requested workspace or page size.");
+    return page;
+  }
+  async get(id, options = {}) {
+    const parsed = IdSchema.parse(id);
+    const item = HostedTasksetSummarySchema.parse(await this.#request(`/${encodeURIComponent(parsed)}`, options.signal));
+    if (item.id !== parsed || item.teamId !== this.#options.teamId) throw new OpenPondTasksetCatalogError(502, "catalog_identity_mismatch", "Taskset metadata did not match the requested identity.");
+    return item;
+  }
+  /** Resolve a saved portable reference without scanning inventory pages. */
+  async resolve(release, options = {}) {
+    const parsed = TasksetCatalogReleaseRefSchema.parse(release);
+    const item = HostedTasksetSummarySchema.parse(await this.#request(`/releases/${encodeURIComponent(parsed.id)}/${parsed.revision}/${parsed.contentHash}`, options.signal));
+    if (item.teamId !== this.#options.teamId || item.release.id !== parsed.id || item.release.revision !== parsed.revision || item.release.contentHash !== parsed.contentHash) throw new OpenPondTasksetCatalogError(502, "catalog_release_mismatch", "Taskset metadata did not match the requested immutable release.");
+    return item;
+  }
+  async #request(path, signal) {
+    const response = await (this.#options.fetch ?? globalThis.fetch)(`${this.#options.baseUrl}/v1/taskset-catalog${path}`, {
+      headers: { Authorization: `Bearer ${this.#options.apiKey}`, "X-OpenPond-Team-Id": this.#options.teamId, Accept: "application/json" },
+      signal,
+      redirect: "error"
+    });
+    const reader = response.body?.getReader();
+    if (!reader) throw new OpenPondTasksetCatalogError(response.status, "empty_response", "Taskset catalog response was empty.");
+    const decoder = new TextDecoder();
+    let bytes = 0;
+    let text = "";
+    try {
+      while (true) {
+        const chunk = await reader.read();
+        if (chunk.done) break;
+        bytes += chunk.value.byteLength;
+        if (bytes > 4194304) throw new OpenPondTasksetCatalogError(response.status, "response_too_large", "Taskset catalog response exceeded 4 MiB.");
+        text += decoder.decode(chunk.value, { stream: true });
+      }
+      text += decoder.decode();
+    } finally {
+      await reader.cancel();
+      reader.releaseLock();
+    }
+    const payload = JSON.parse(text);
+    if (!response.ok) {
+      const error = TasksetCatalogErrorSchema.safeParse(payload);
+      throw new OpenPondTasksetCatalogError(response.status, error.success ? error.data.code : "invalid_error_response", error.success ? error.data.message : `Taskset catalog request failed (${response.status}).`);
+    }
+    return payload;
+  }
+};
+export {
+  HostedTasksetSummarySchema,
+  OpenPondTasksetCatalogClient,
+  OpenPondTasksetCatalogError,
+  TasksetCatalogErrorSchema,
+  TasksetCatalogPageSchema,
+  TasksetCatalogQuerySchema,
+  TasksetCatalogReleaseRefSchema
+};
+//# sourceMappingURL=taskset-catalog.js.map

package/dist/taskset-catalog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/taskset-catalog.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nconst IdSchema = z.string().trim().min(1).max(500);\nconst HashSchema = z.string().regex(/^[a-f0-9]{64}$/);\nexport const TasksetCatalogReleaseRefSchema = z.object({ id: IdSchema, revision: z.number().int().positive(), contentHash: HashSchema }).strict();\n\n/** Inventory metadata only. Task rows, evaluator source, and object locations\n * are resolved separately by an authorized package operation. */\nexport const HostedTasksetSummarySchema = z.object({\n  schemaVersion: z.literal(\"openpond.hostedTasksetSummary.v1\"),\n  id: IdSchema,\n  teamId: IdSchema,\n  release: TasksetCatalogReleaseRefSchema,\n  name: z.string().min(1).max(500),\n  description: z.string().max(20_000),\n  taskCount: z.number().int().nonnegative(),\n  buildIntent: z.string().min(1).max(100),\n  methodHint: z.string().min(1).max(100).nullable(),\n  packageBytes: z.number().int().nonnegative().nullable(),\n  storedBytes: z.number().int().nonnegative().nullable(),\n  createdAt: z.string().datetime({ offset: true }),\n}).strict();\nexport const TasksetCatalogQuerySchema = z.object({\n  afterId: IdSchema.optional(),\n  limit: z.number().int().min(1).max(100).default(30),\n  modelProjectId: IdSchema.optional(),\n}).strict();\nexport const TasksetCatalogPageSchema = z.object({\n  items: z.array(HostedTasksetSummarySchema).max(100),\n  nextCursor: IdSchema.nullable(),\n}).strict();\nexport const TasksetCatalogErrorSchema = z.object({\n  code: z.string().min(1),\n  message: z.string().min(1),\n}).strict();\nexport type HostedTasksetSummary = z.infer<typeof HostedTasksetSummarySchema>;\nexport type TasksetCatalogPage = z.infer<typeof TasksetCatalogPageSchema>;\n\nexport class OpenPondTasksetCatalogError extends Error {\n  constructor(readonly status: number, readonly code: string, message: string) {\n    super(message);\n    this.name = \"OpenPondTasksetCatalogError\";\n  }\n}\n\nexport interface TasksetCatalogClientOptions {\n  baseUrl: string;\n  apiKey: string;\n  teamId: string;\n  fetch?: typeof globalThis.fetch;\n}\n\nexport class OpenPondTasksetCatalogClient {\n  readonly #options: TasksetCatalogClientOptions;\n  constructor(options: TasksetCatalogClientOptions) {\n    if (!options.apiKey.trim() || !options.teamId.trim()) throw new Error(\"Taskset API key and workspace are required.\");\n    const url = new URL(options.baseUrl);\n    if (![\"http:\", \"https:\"].includes(url.protocol) || url.username || url.password || url.search || url.hash) throw new Error(\"Taskset base URL must be an HTTP(S) endpoint without credentials, query, or fragment.\");\n    this.#options = { ...options, baseUrl: url.toString().replace(/\\/+$/, \"\") };\n  }\n\n  async list(query: z.input<typeof TasksetCatalogQuerySchema> = {}, options: { signal?: AbortSignal } = {}): Promise<TasksetCatalogPage> {\n    const parsed = TasksetCatalogQuerySchema.parse(query);\n    const search = new URLSearchParams({ limit: String(parsed.limit) });\n    if (parsed.afterId) search.set(\"afterId\", parsed.afterId);\n    if (parsed.modelProjectId) search.set(\"modelProjectId\", parsed.modelProjectId);\n    const page = TasksetCatalogPageSchema.parse(await this.#request(`?${search}`, options.signal));\n    if (page.items.length > parsed.limit || page.items.some((item) => item.teamId !== this.#options.teamId)) throw new OpenPondTasksetCatalogError(502, \"catalog_scope_mismatch\", \"Taskset inventory did not match the requested workspace or page size.\");\n    return page;\n  }\n\n  async get(id: string, options: { signal?: AbortSignal } = {}): Promise<HostedTasksetSummary> {\n    const parsed = IdSchema.parse(id);\n    const item = HostedTasksetSummarySchema.parse(await this.#request(`/${encodeURIComponent(parsed)}`, options.signal));\n    if (item.id !== parsed || item.teamId !== this.#options.teamId) throw new OpenPondTasksetCatalogError(502, \"catalog_identity_mismatch\", \"Taskset metadata did not match the requested identity.\");\n    return item;\n  }\n\n  /** Resolve a saved portable reference without scanning inventory pages. */\n  async resolve(release: z.infer<typeof TasksetCatalogReleaseRefSchema>, options: { signal?: AbortSignal } = {}): Promise<HostedTasksetSummary> {\n    const parsed = TasksetCatalogReleaseRefSchema.parse(release);\n    const item = HostedTasksetSummarySchema.parse(await this.#request(`/releases/${encodeURIComponent(parsed.id)}/${parsed.revision}/${parsed.contentHash}`, options.signal));\n    if (item.teamId !== this.#options.teamId || item.release.id !== parsed.id || item.release.revision !== parsed.revision || item.release.contentHash !== parsed.contentHash) throw new OpenPondTasksetCatalogError(502, \"catalog_release_mismatch\", \"Taskset metadata did not match the requested immutable release.\");\n    return item;\n  }\n\n  async #request(path: string, signal?: AbortSignal): Promise<unknown> {\n    const response = await (this.#options.fetch ?? globalThis.fetch)(`${this.#options.baseUrl}/v1/taskset-catalog${path}`, {\n      headers: { Authorization: `Bearer ${this.#options.apiKey}`, \"X-OpenPond-Team-Id\": this.#options.teamId, Accept: \"application/json\" },\n      signal, redirect: \"error\",\n    });\n    const reader = response.body?.getReader();\n    if (!reader) throw new OpenPondTasksetCatalogError(response.status, \"empty_response\", \"Taskset catalog response was empty.\");\n    const decoder = new TextDecoder();\n    let bytes = 0;\n    let text = \"\";\n    try {\n      while (true) {\n        const chunk = await reader.read();\n        if (chunk.done) break;\n        bytes += chunk.value.byteLength;\n        if (bytes > 4_194_304) throw new OpenPondTasksetCatalogError(response.status, \"response_too_large\", \"Taskset catalog response exceeded 4 MiB.\");\n        text += decoder.decode(chunk.value, { stream: true });\n      }\n      text += decoder.decode();\n    } finally { await reader.cancel(); reader.releaseLock(); }\n    const payload: unknown = JSON.parse(text);\n    if (!response.ok) {\n      const error = TasksetCatalogErrorSchema.safeParse(payload);\n      throw new OpenPondTasksetCatalogError(response.status, error.success ? error.data.code : \"invalid_error_response\", error.success ? error.data.message : `Taskset catalog request failed (${response.status}).`);\n    }\n    return payload;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/types/packages/sdk/src/taskset-catalog.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+export declare const TasksetCatalogReleaseRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+/** Inventory metadata only. Task rows, evaluator source, and object locations
+ * are resolved separately by an authorized package operation. */
+export declare const HostedTasksetSummarySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.hostedTasksetSummary.v1">;
+    id: z.ZodString;
+    teamId: z.ZodString;
+    release: z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    name: z.ZodString;
+    description: z.ZodString;
+    taskCount: z.ZodNumber;
+    buildIntent: z.ZodString;
+    methodHint: z.ZodNullable<z.ZodString>;
+    packageBytes: z.ZodNullable<z.ZodNumber>;
+    storedBytes: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export declare const TasksetCatalogQuerySchema: z.ZodObject<{
+    afterId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    modelProjectId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const TasksetCatalogPageSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"openpond.hostedTasksetSummary.v1">;
+        id: z.ZodString;
+        teamId: z.ZodString;
+        release: z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+        }, z.core.$strict>;
+        name: z.ZodString;
+        description: z.ZodString;
+        taskCount: z.ZodNumber;
+        buildIntent: z.ZodString;
+        methodHint: z.ZodNullable<z.ZodString>;
+        packageBytes: z.ZodNullable<z.ZodNumber>;
+        storedBytes: z.ZodNullable<z.ZodNumber>;
+        createdAt: z.ZodString;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const TasksetCatalogErrorSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type HostedTasksetSummary = z.infer<typeof HostedTasksetSummarySchema>;
+export type TasksetCatalogPage = z.infer<typeof TasksetCatalogPageSchema>;
+export declare class OpenPondTasksetCatalogError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface TasksetCatalogClientOptions {
+    baseUrl: string;
+    apiKey: string;
+    teamId: string;
+    fetch?: typeof globalThis.fetch;
+}
+export declare class OpenPondTasksetCatalogClient {
+    #private;
+    constructor(options: TasksetCatalogClientOptions);
+    list(query?: z.input<typeof TasksetCatalogQuerySchema>, options?: {
+        signal?: AbortSignal;
+    }): Promise<TasksetCatalogPage>;
+    get(id: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<HostedTasksetSummary>;
+    /** Resolve a saved portable reference without scanning inventory pages. */
+    resolve(release: z.infer<typeof TasksetCatalogReleaseRefSchema>, options?: {
+        signal?: AbortSignal;
+    }): Promise<HostedTasksetSummary>;
+}
+//# sourceMappingURL=taskset-catalog.d.ts.map

package/dist/types/packages/sdk/src/taskset-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskset-catalog.d.ts","sourceRoot":"","sources":["../../../../../src/taskset-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,8BAA8B;;;;kBAAsG,CAAC;AAElJ;iEACiE;AACjE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;kBAa5B,CAAC;AACZ,eAAO,MAAM,yBAAyB;;;;kBAI3B,CAAC;AACZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;kBAG1B,CAAC;AACZ,eAAO,MAAM,yBAAyB;;;kBAG3B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,qBAAa,2BAA4B,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAArC,MAAM,EAAE,MAAM,EAAW,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI5E;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,qBAAa,4BAA4B;;gBAE3B,OAAO,EAAE,2BAA2B;IAO1C,IAAI,CAAC,KAAK,GAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUhI,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAO5F,2EAA2E;IACrE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAkC9I"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpond-sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Server-side TypeScript SDK for OpenPond sandboxes and agentic work",
   "license": "MIT",
   "type": "module",
@@ -13,9 +13,14 @@
     "TRAINING_PROTOCOL.md",
     "LICENSE",
     "examples",
-    "LEARNING.md"
+    "LEARNING.md",
+    "TASKSETS.md"
   ],
   "exports": {
+    "./taskset-catalog": {
+      "types": "./dist/types/packages/sdk/src/taskset-catalog.d.ts",
+      "import": "./dist/taskset-catalog.js"
+    },
     "./learning": {
       "types": "./dist/types/packages/sdk/src/learning.d.ts",
       "import": "./dist/learning.js"