@agents24/node 0.1.0 → 0.2.1

package/dist/index.js

@@ -8,16 +8,37 @@ export { CONTRACT_HASH, RUNTIME_PROTOCOL_VERSION, THREAD_SUMMARY_PROTOCOL_VERSIO
 var Agents24SDKError = class extends Error {
   kind;
   status;
-  details;
+  failure;
   responseHeaders;
   constructor(message, options) {
     super(message, { cause: options.cause });
     this.name = "Agents24SDKError";
     this.kind = options.kind;
     this.status = options.status;
-    this.details = options.details;
+    this.failure = options.failure;
     this.responseHeaders = options.responseHeaders;
   }
+  get code() {
+    return this.failure?.code;
+  }
+  get category() {
+    return this.failure?.category;
+  }
+  get failureId() {
+    return this.failure?.failure_id;
+  }
+  get requestId() {
+    return this.failure?.request_id ?? void 0;
+  }
+  get retryable() {
+    return this.failure?.retryable ?? false;
+  }
+  get retryAfterMs() {
+    return this.failure?.retry_after_ms ?? void 0;
+  }
+  get details() {
+    return this.failure?.details ?? {};
+  }
 };
 
 // src/http.ts
@@ -43,17 +64,10 @@ async function errorDetails(response) {
     return text;
   }
 }
-function detailMessage(details) {
-  if (typeof details === "string" && details.trim()) return details.trim();
-  if (!details || typeof details !== "object" || Array.isArray(details)) return void 0;
-  const detail = details.detail;
-  if (typeof detail === "string" && detail.trim()) return detail.trim();
-  if (detail && typeof detail === "object" && !Array.isArray(detail)) {
-    const message2 = detail.message;
-    if (typeof message2 === "string" && message2.trim()) return message2.trim();
-  }
-  const message = details.message;
-  return typeof message === "string" && message.trim() ? message.trim() : void 0;
+function failureView(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const candidate = value;
+  return candidate.schema_version === "agents24.failure.v1" && typeof candidate.failure_id === "string" && typeof candidate.code === "string" && typeof candidate.category === "string" && typeof candidate.message === "string" && typeof candidate.retryable === "boolean" && candidate.details !== null && typeof candidate.details === "object" && !Array.isArray(candidate.details) ? candidate : void 0;
 }
 function responseHeaders(response) {
   const headers = {};
@@ -65,19 +79,17 @@ function responseHeaders(response) {
 }
 async function assertOk(response) {
   if (response.ok) return;
-  const details = await errorDetails(response);
-  throw new Agents24SDKError(detailMessage(details) || response.statusText || "Agents24 request failed.", {
+  const failure = failureView(await errorDetails(response));
+  throw new Agents24SDKError(failure?.message || "Agents24 request failed.", {
     kind: "http",
     status: response.status,
-    details,
+    failure,
     responseHeaders: responseHeaders(response)
   });
 }
 var Agents24HttpClient = class {
   base;
   apiKey;
-  organizationId;
-  projectId;
   fetchImpl;
   constructor(options) {
     if (typeof process === "undefined" || process.release?.name !== "node") {
@@ -85,8 +97,6 @@ var Agents24HttpClient = class {
     }
     this.base = normalizeBaseUrl(options.baseUrl);
     this.apiKey = required(options.apiKey, "apiKey");
-    this.organizationId = required(options.organizationId, "organizationId");
-    this.projectId = required(options.projectId, "projectId");
     if (typeof options.fetchImpl !== "function" && typeof fetch !== "function") {
       throw new Agents24SDKError("No fetch implementation is available. Use Node 22 or 24.", { kind: "protocol" });
     }
@@ -111,8 +121,6 @@ var Agents24HttpClient = class {
       Authorization: `Bearer ${this.apiKey}`,
       Accept: "application/json",
       "Content-Type": "application/json",
-      "X-Organization-ID": this.organizationId,
-      "X-Project-ID": this.projectId,
       "X-SDK-Contract": "1",
       ...mutation ? { "Idempotency-Key": options?.idempotencyKey || randomUUID() } : {},
       ...options?.requestMetadata ? { "X-Request-Metadata": JSON.stringify(options.requestMetadata) } : {},
@@ -126,8 +134,6 @@ var Agents24HttpClient = class {
     return {
       Authorization: `Bearer ${this.apiKey}`,
       Accept: "application/json",
-      "X-Organization-ID": this.organizationId,
-      "X-Project-ID": this.projectId,
       "X-SDK-Contract": "1",
       ...mutation ? { "Idempotency-Key": options?.idempotencyKey || randomUUID() } : {},
       ...extra || {}
@@ -252,6 +258,7 @@ var AgentsNamespace = class {
   async uploadAttachments(agentId, options) {
     const form = new FormData();
     if (options.threadId) form.set("thread_id", options.threadId);
+    if (options.agentVersionId) form.set("agent_version_id", options.agentVersionId);
     for (const file of options.files) form.append("files", file, file.name);
     const response = await this.http.fetchOrThrow(this.http.url(`/agents/${agentId}/attachments/upload`), {
       method: "POST",
@@ -261,6 +268,12 @@ var AgentsNamespace = class {
     await assertOk(response);
     return await response.json();
   }
+  createAttachmentContentAccess(agentId, attachmentId, request, options) {
+    return this.http.requestJson(
+      `/agents/${agentId}/attachments/${attachmentId}/content-access`,
+      { method: "POST", body: request, options, mutation: true }
+    );
+  }
 };
 
 // src/builders.ts
@@ -279,12 +292,15 @@ function toolsetAttachments(options) {
     const id = refId(attachment.toolset);
     if (!id || seen.has(id)) return [];
     seen.add(id);
-    const policy = attachment.versionPolicy || { mode: "latest" };
-    return [{
+    const normalized = {
       toolset_id: id,
-      loading_mode: attachment.loadingMode || "static",
-      version_policy: policy.mode === "pinned" ? { mode: "pinned", version_id: policy.versionId } : { mode: "latest" }
-    }];
+      loading_mode: attachment.loadingMode || "static"
+    };
+    const policy = attachment.versionPolicy;
+    if (policy) {
+      normalized.version_policy = policy.mode === "pinned" ? { mode: "pinned", version_id: policy.versionId } : { mode: "latest_published" };
+    }
+    return [normalized];
   });
 }
 var AgentDefinitionBuilder = class {
@@ -362,9 +378,10 @@ var GraphBuilder = class {
       id: options.id || `${sourceId}-${targetId}`,
       source: sourceId,
       target: targetId,
-      type: "control",
+      type: options.type || "control",
       source_handle: options.sourceHandle,
-      target_handle: options.targetHandle
+      target_handle: options.targetHandle,
+      condition: options.condition
     });
     return this;
   }
@@ -394,6 +411,15 @@ var ClientDeploymentsNamespace = class {
       mutation: true
     });
   }
+  list(query) {
+    const params = new URLSearchParams({ agent_id: query.agentId });
+    if (query.lifecycleStatus) params.set("lifecycle_status", query.lifecycleStatus);
+    if (query.cursor) params.set("cursor", query.cursor);
+    if (query.limit !== void 0) params.set("limit", String(query.limit));
+    return this.http.requestJson(
+      `/client-runtime/deployments?${params.toString()}`
+    );
+  }
   get(deploymentId) {
     return this.http.requestJson(`/client-runtime/deployments/${deploymentId}`);
   }
@@ -405,15 +431,7 @@ var ClientDeploymentsNamespace = class {
       mutation: true
     });
   }
-  promote(deploymentId, request, options) {
-    return this.http.requestJson(`/client-runtime/deployments/${deploymentId}/promote`, {
-      method: "POST",
-      body: request,
-      options,
-      mutation: true
-    });
-  }
-  revoke(deploymentId, options) {
+  delete(deploymentId, options) {
     return this.http.requestJson(`/client-runtime/deployments/${deploymentId}`, {
       method: "DELETE",
       options,
@@ -473,8 +491,10 @@ var EmbedNamespace = class {
   startAgentRunMcpAuth(agentId, runId, serverId, payload, options) {
     return this.http.requestJson(`/public/embed/agents/${agentId}/runs/${runId}/mcp/servers/${serverId}/auth/start`, { method: "POST", body: payload, options, mutation: true });
   }
-  getRuntimeBootstrap(agentId) {
-    return this.http.requestJson(`/public/embed/agents/${agentId}/runtime/bootstrap`);
+  getRuntimeBootstrap(agentId, agentVersionId) {
+    return this.http.requestJson(`/public/embed/agents/${agentId}/runtime/bootstrap`, {
+      query: { agent_version_id: agentVersionId }
+    });
   }
   listAgentThreads(agentId, options) {
     return this.http.requestJson(`/public/embed/agents/${agentId}/threads`, { query: {
@@ -512,18 +532,17 @@ var EmbedNamespace = class {
       external_session_id: options.externalSessionId,
       before_turn_index: options.beforeTurnIndex,
       limit: options.limit,
-      include_run_events: options.includeRunEvents,
       include_subthreads: options.includeSubthreads,
       subthread_depth: options.subthreadDepth,
       subthread_turn_limit: options.subthreadTurnLimit,
       subthread_child_limit: options.subthreadChildLimit
     } });
   }
-  deleteAgentThread(agentId, threadId, options) {
+  deleteAgentThread(agentId, threadId, options, requestOptions) {
     return this.http.requestJson(`/public/embed/agents/${agentId}/threads/${threadId}`, { method: "DELETE", query: {
       external_user_id: options.externalUserId,
       external_session_id: options.externalSessionId
-    }, mutation: true });
+    }, options: requestOptions, mutation: true });
   }
   getAgentRunContext(agentId, runId, options) {
     return this.http.requestJson(`/public/embed/agents/${agentId}/runs/${runId}/context`, { query: {
@@ -531,11 +550,17 @@ var EmbedNamespace = class {
       external_session_id: options.externalSessionId
     } });
   }
-  cancelAgentRun(agentId, runId, options) {
+  cancelAgentRun(agentId, runId, options, requestOptions) {
     return this.http.requestJson(`/public/embed/agents/${agentId}/runs/${runId}/cancel`, { method: "POST", query: {
       external_user_id: options.externalUserId,
       external_session_id: options.externalSessionId
-    }, body: {}, mutation: true });
+    }, body: {}, options: requestOptions, mutation: true });
+  }
+  setAgentRunFeedback(agentId, runId, payload) {
+    return this.http.requestJson(
+      `/public/embed/agents/${agentId}/runs/${runId}/feedback`,
+      { method: "PUT", body: payload, mutation: true }
+    );
   }
   async uploadAgentAttachments(agentId, options) {
     const form = new FormData();
@@ -551,6 +576,105 @@ var EmbedNamespace = class {
     await assertOk(response);
     return await response.json();
   }
+  createAttachmentContentAccess(agentId, attachmentId, request, options) {
+    return this.http.requestJson(
+      `/public/embed/agents/${agentId}/attachments/${attachmentId}/content-access`,
+      { method: "POST", body: request, options, mutation: true }
+    );
+  }
+};
+
+// src/generated/resourceBundles.ts
+var ResourceBundlesNamespace = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  exportPlan(request) {
+    return this.http.requestJson("/resource-bundles/export/plan", {
+      method: "POST",
+      body: request
+    });
+  }
+  exportBundle(request) {
+    return this.http.requestJson("/resource-bundles/export", {
+      method: "POST",
+      body: request
+    });
+  }
+  candidates(options) {
+    return this.http.requestJson("/resource-bundles/candidates", {
+      query: {
+        kind: options.kind,
+        q: options.query,
+        limit: options.limit,
+        offset: options.offset,
+        required_capability: options.requiredCapability
+      }
+    });
+  }
+  importPreview(request) {
+    return this.http.requestJson("/resource-bundles/import/preview", {
+      method: "POST",
+      body: request
+    });
+  }
+  importBundle(request, options) {
+    return this.http.requestJson("/resource-bundles/import", {
+      method: "POST",
+      body: request,
+      options,
+      mutation: true
+    });
+  }
+};
+
+// src/generated/resourcePackages.ts
+var ResourcePackagesNamespace = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  async exportPackage(request) {
+    const response = await this.http.fetchOrThrow(
+      this.http.url("/resource-packages/export"),
+      { method: "POST", headers: this.http.jsonHeaders(), body: JSON.stringify(request) },
+      "Failed to export the Agents24 resource package."
+    );
+    await assertOk(response);
+    const disposition = response.headers.get("content-disposition") || "";
+    const candidate = /filename="?([^";]+)"?/i.exec(disposition)?.[1] || "";
+    const filename = /^[A-Za-z0-9][A-Za-z0-9._-]{0,200}\.zip$/.test(candidate) ? candidate : "resource.agents24.zip";
+    return { data: new Uint8Array(await response.arrayBuffer()), filename };
+  }
+  async validatePackage(upload) {
+    const formData = new FormData();
+    const archiveBytes = upload.data.slice().buffer;
+    const candidate = upload.filename || "";
+    const filename = /^[A-Za-z0-9][A-Za-z0-9._-]{0,200}\.zip$/.test(candidate) ? candidate : "resource.agents24.zip";
+    formData.append("file", new Blob([archiveBytes]), filename);
+    const response = await this.http.fetchOrThrow(
+      this.http.url("/resource-packages/validate"),
+      { method: "POST", headers: this.http.multipartHeaders(), body: formData },
+      "Failed to upload the Agents24 resource package."
+    );
+    await assertOk(response);
+    return await response.json();
+  }
+  async compilePackage(upload) {
+    const formData = new FormData();
+    const archiveBytes = upload.data.slice().buffer;
+    const candidate = upload.filename || "";
+    const filename = /^[A-Za-z0-9][A-Za-z0-9._-]{0,200}\.zip$/.test(candidate) ? candidate : "resource.agents24.zip";
+    formData.append("file", new Blob([archiveBytes]), filename);
+    const response = await this.http.fetchOrThrow(
+      this.http.url("/resource-packages/compile"),
+      { method: "POST", headers: this.http.multipartHeaders(), body: formData },
+      "Failed to upload the Agents24 resource package."
+    );
+    await assertOk(response);
+    return await response.json();
+  }
 };
 
 // src/runs.ts
@@ -571,12 +695,81 @@ var RunsNamespace = class {
   getContext(runId) {
     return this.http.requestJson(`/agents/runs/${runId}/context`);
   }
-  async getTrace(runId) {
-    const run = await this.get(runId);
-    const tree = await this.getTree(runId);
-    const events = await this.getEvents(runId);
-    const context = await this.getContext(runId);
-    return { run, tree, events, context };
+  getTrace(runId, options = {}) {
+    return this.http.requestJson(`/agents/runs/${runId}/trace`, {
+      query: { include_diagnostics: options.includeDiagnostics }
+    });
+  }
+};
+
+// src/generated/instructions.ts
+var InstructionsNamespace = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  publish(instructionId, options) {
+    return this.http.requestJson(`/prompts/${instructionId}/publish`, {
+      method: "POST",
+      body: {},
+      options,
+      mutation: true
+    });
+  }
+};
+
+// src/generated/resourcePolicies.ts
+var ResourcePoliciesNamespace = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  list() {
+    return this.http.requestJson("/admin/security/resource-policies/sets");
+  }
+  setCustomerAssignment(request, options) {
+    return this.http.requestJson("/admin/security/resource-policies/customer-assignments/set", {
+      method: "POST",
+      body: request,
+      options,
+      mutation: true
+    });
+  }
+  getCustomerAssignment(request) {
+    return this.http.requestJson("/admin/security/resource-policies/customer-assignments/get", {
+      method: "POST",
+      body: request
+    });
+  }
+  clearCustomerAssignment(request, options) {
+    return this.http.requestJson("/admin/security/resource-policies/customer-assignments/clear", {
+      method: "POST",
+      body: request,
+      options,
+      mutation: true
+    });
+  }
+  getEffectiveCustomerPolicy(request) {
+    return this.http.requestJson("/admin/security/resource-policies/customers/effective", {
+      method: "POST",
+      body: request
+    });
+  }
+  setQuotaSchedule(request, options) {
+    return this.http.requestJson("/admin/security/resource-policies/quota-schedules/set", {
+      method: "POST",
+      body: request,
+      options,
+      mutation: true
+    });
+  }
+  resetQuotaNow(request, options) {
+    return this.http.requestJson("/admin/security/resource-policies/quota-schedules/reset-now", {
+      method: "POST",
+      body: request,
+      options,
+      mutation: true
+    });
   }
 };
 
@@ -585,15 +778,23 @@ var Agents24 = class {
   agents;
   embed;
   runs;
+  resourceBundles;
+  resourcePackages;
   clientDeployments;
   clientSessions;
+  instructions;
+  resourcePolicies;
   constructor(options) {
     const http = new Agents24HttpClient(options);
     this.agents = new AgentsNamespace(http);
     this.embed = new EmbedNamespace(http);
     this.runs = new RunsNamespace(http);
+    this.resourceBundles = new ResourceBundlesNamespace(http);
+    this.resourcePackages = new ResourcePackagesNamespace(http);
     this.clientDeployments = new ClientDeploymentsNamespace(http);
     this.clientSessions = new ClientSessionsNamespace(http);
+    this.instructions = new InstructionsNamespace(http);
+    this.resourcePolicies = new ResourcePoliciesNamespace(http);
   }
   agent(options) {
     return new AgentDefinitionBuilder(this.agents, options);
@@ -608,6 +809,7 @@ var SDK_OPERATION_IDS = [
   "agents.cancel_run",
   "agents.catalog",
   "agents.create",
+  "agents.create_attachment_content_access",
   "agents.delete",
   "agents.get",
   "agents.list",
@@ -620,20 +822,23 @@ var SDK_OPERATION_IDS = [
   "agents.update_graph",
   "agents.upload_attachments",
   "agents.validate",
+  "client.attachments.create_content_access",
   "client.attachments.upload",
   "client.bootstrap",
   "client.chat.stream",
   "client.deployments.create",
+  "client.deployments.delete",
   "client.deployments.get",
-  "client.deployments.promote",
-  "client.deployments.revoke",
+  "client.deployments.list",
   "client.deployments.update",
   "client.hitl.resume",
   "client.jwks",
   "client.mcp.redeem",
   "client.mcp.start",
+  "client.resource_policy",
   "client.runs.attach",
   "client.runs.cancel",
+  "client.runs.set_feedback",
   "client.sessions.anonymous",
   "client.sessions.backendExchange",
   "client.sessions.refresh",
@@ -644,6 +849,7 @@ var SDK_OPERATION_IDS = [
   "client.threads.list",
   "embed.attach_agent_run",
   "embed.cancel_agent_run",
+  "embed.create_attachment_content_access",
   "embed.delete_agent_thread",
   "embed.get_agent_run_context",
   "embed.get_agent_thread",
@@ -651,14 +857,32 @@ var SDK_OPERATION_IDS = [
   "embed.list_agent_threads",
   "embed.list_agent_threads_multi",
   "embed.resume_agent_run",
+  "embed.set_agent_run_feedback",
   "embed.start_agent_run_mcp_auth",
   "embed.stream_agent",
   "embed.stream_agent_thread_events",
   "embed.stream_agent_thread_events_multi",
   "embed.upload_agent_attachments",
+  "instructions.publish",
+  "resource_bundles.candidates",
+  "resource_bundles.export",
+  "resource_bundles.export_plan",
+  "resource_bundles.import",
+  "resource_bundles.import_preview",
+  "resource_packages.compile",
+  "resource_packages.export",
+  "resource_packages.validate",
+  "resource_policies.clear_customer_assignment",
+  "resource_policies.get_customer_assignment",
+  "resource_policies.get_effective_customer_policy",
+  "resource_policies.list",
+  "resource_policies.reset_quota_now",
+  "resource_policies.set_customer_assignment",
+  "resource_policies.set_quota_schedule",
   "runs.get",
   "runs.get_context",
   "runs.get_events",
+  "runs.get_trace",
   "runs.get_tree"
 ];