@agents24/node 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Talmudpedia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# `@agents24/node`
+
+Last Updated: 2026-07-16
+
+Trusted-server Agents24 SDK for organization-authenticated control-plane, server embed, authoring, artifact, client-deployment, and client-session mint operations. It supports Node 22 and 24 with ESM and CJS entrypoints.
+
+```ts
+import { Agents24 } from "@agents24/node";
+
+const agents24 = new Agents24({
+  baseUrl: process.env.AGENTS24_BASE_URL!,
+  apiKey: process.env.AGENTS24_API_KEY!,
+  organizationId: process.env.AGENTS24_ORGANIZATION_ID!,
+  projectId: process.env.AGENTS24_PROJECT_ID!,
+});
+```
+
+Create a browser session from a customer backend without sending customer identity to the browser runtime:
+
+```ts
+const session = await agents24.clientSessions.createBackendSession(
+  "deployment-id",
+  {
+    subject: authenticatedCustomer.id,
+    browser_origin: "https://app.example.com",
+    requested_capabilities: ["chat.stream", "threads.read"],
+  },
+  { idempotencyKey: request.id },
+);
+```
+
+Administer deployments through `agents24.clientDeployments`; use `agents24.agents`, `agents24.runs`, and `agents24.embed` for trusted Agent operations. End-user token networking remains in `@agents24/client`.
+
+Artifact source imports the transport-free declaration DSL:
+
+```ts
+import { defineArtifact, tool } from "@agents24/node/artifacts";
+```
+
+Self-hosted Node artifact servers use `@agents24/node/server`. That server subpath does not re-export the declaration DSL.
+
+This package is server-only. Never expose an organization API key to browser code. Persistent or native client-session enrollment requires DPoP; pass the proof as `dpopProof` in the mint request options and read a nonce challenge from `Agents24SDKError.responseHeaders`.

package/compatibility.json

@@ -0,0 +1,54 @@
+{
+  "contractHash": "de2b507f5d56de2bf7c4d6739c03617c4b4feef6ae827aaaac5f1d6150ec678e",
+  "contractVersion": "0.2.0",
+  "corpus": "conformance/v1/corpus.json",
+  "generatedBy": "@agents24/sdk-contract",
+  "packages": {
+    "@agents24/ai-sdk": {
+      "ai": ">=7 <8",
+      "aiSdkReact": ">=4 <5",
+      "peer": "@agents24/client"
+    },
+    "@agents24/chat-react": {
+      "peer": "@agents24/react",
+      "react": ">=19 <20",
+      "reactDom": ">=19 <20"
+    },
+    "@agents24/client": {
+      "contract": "de2b507f5d56de2bf7c4d6739c03617c4b4feef6ae827aaaac5f1d6150ec678e",
+      "runtime": "run-stream.v2"
+    },
+    "@agents24/node": {
+      "contract": "de2b507f5d56de2bf7c4d6739c03617c4b4feef6ae827aaaac5f1d6150ec678e",
+      "node": "^22.0.0 || ^24.0.0"
+    },
+    "@agents24/react": {
+      "peer": "@agents24/client",
+      "react": ">=19 <20"
+    },
+    "@talmudpedia/runtime-sdk": {
+      "contract": "de2b507f5d56de2bf7c4d6739c03617c4b4feef6ae827aaaac5f1d6150ec678e",
+      "protocolOwner": "@agents24/client"
+    },
+    "agents24": {
+      "contract": "de2b507f5d56de2bf7c4d6739c03617c4b4feef6ae827aaaac5f1d6150ec678e",
+      "python": ">=3.10"
+    }
+  },
+  "protocols": {
+    "runtime": {
+      "minimum": "2.0.0",
+      "wire": "run-stream.v2"
+    },
+    "threadSummary": {
+      "minimum": "1.0.0",
+      "wire": "agents24.thread_summary_event.v1"
+    }
+  },
+  "schemaVersion": "agents24.compatibility.v1",
+  "targetOperationCounts": {
+    "client": 19,
+    "node": 55,
+    "python": 55
+  }
+}

package/dist/artifacts.cjs

@@ -0,0 +1,138 @@
+'use strict';
+
+// src/artifacts-runtime.mjs
+function schema(value) {
+  if (value == null) return {};
+  if (typeof value.toJSONSchema === "function") return value.toJSONSchema();
+  if (typeof value.toJsonSchema === "function") return value.toJsonSchema();
+  if (typeof value === "object") {
+    if (typeof value.parse === "function" && typeof value.safeParse === "function" && value._zod) {
+      throw new TypeError("Zod schemas must expose toJSONSchema(); install Zod v4 or pass z.toJSONSchema(schema)");
+    }
+    return value;
+  }
+  throw new TypeError("schema must be a JSON Schema object or expose toJSONSchema()");
+}
+function normalize(kind, definition = {}, handler) {
+  const actualHandler = handler || definition.handler || definition.execute;
+  const explicitName = String(definition.name || "").trim();
+  const name = explicitName || String(actualHandler?.name || "").trim();
+  const value = {
+    name,
+    kind,
+    description: definition.description || "",
+    input_schema: schema(definition.input_schema || definition.inputSchema || definition.input),
+    output_schema: schema(definition.output_schema || definition.outputSchema || definition.output),
+    config_schema: schema(definition.config_schema || definition.configSchema || definition.config),
+    ui_schema: definition.ui_schema || definition.uiSchema || definition.ui || {},
+    side_effects: definition.side_effects || definition.sideEffects || [],
+    execution_mode: definition.execution_mode || definition.executionMode || "interactive",
+    handler_ref: definition.handler_ref || definition.handlerRef || actualHandler?.name || name,
+    handler: actualHandler
+  };
+  Object.defineProperty(value, "__agents24ExplicitName", { value: Boolean(explicitName), enumerable: false });
+  return value;
+}
+function tool(definition = {}, handler) {
+  return normalize("tool", definition, handler);
+}
+function agentNode(definition = {}, handler) {
+  return normalize("agent_node", definition, handler);
+}
+function ragOperator(definition = {}, handler) {
+  return normalize("rag_operator", definition, handler);
+}
+function toolset(definition = {}) {
+  return {
+    __agents24Toolset: true,
+    name: String(definition.name || "").trim(),
+    description: String(definition.description || "").trim(),
+    tools: Array.isArray(definition.tools) ? definition.tools : []
+  };
+}
+function entries(input) {
+  if (Array.isArray(input)) return input.map((item) => [null, item]);
+  return input && typeof input === "object" ? Object.entries(input) : [];
+}
+function normalizedExports(definition) {
+  const exports = [];
+  const namesByObject = /* @__PURE__ */ new Map();
+  for (const source of [definition.tools, definition.agentNodes, definition.ragOperators]) {
+    for (const [mappedName, raw] of entries(source)) {
+      if (!raw || typeof raw !== "object") throw new TypeError("Artifact exports must use tool, agentNode, or ragOperator");
+      const name = raw.__agents24ExplicitName ? raw.name.trim() : String(mappedName || raw.name || "").trim();
+      if (!name) throw new TypeError("Artifact exports require a name");
+      exports.push({ ...raw, name, handler_ref: raw.handler_ref || name });
+      namesByObject.set(raw, [...namesByObject.get(raw) || [], name]);
+    }
+  }
+  const names = exports.map((item) => item.name);
+  const duplicate = names.find((name, index) => names.indexOf(name) !== index);
+  if (duplicate) throw new TypeError(`Duplicate artifact export name '${duplicate}'`);
+  return { exports, namesByObject };
+}
+function normalizedToolsets(input, exports, namesByObject) {
+  if (input == null) return [];
+  if (Array.isArray(input) || typeof input !== "object") {
+    throw new TypeError("TypeScript artifact toolsets must be an object keyed by stable source key");
+  }
+  const tools = new Set(exports.filter((item) => item.kind === "tool").map((item) => item.name));
+  const seenNames = /* @__PURE__ */ new Set();
+  return Object.entries(input).map(([key, value]) => {
+    if (!key.trim()) throw new TypeError("Artifact toolset keys cannot be empty");
+    if (!value?.__agents24Toolset) throw new TypeError(`Toolset '${key}' must use toolset()`);
+    if (!value.name || !value.description || !value.tools.length) {
+      throw new TypeError(`Toolset '${key}' requires a name, description, and tool`);
+    }
+    const folded = value.name.toLocaleLowerCase();
+    if (seenNames.has(folded)) throw new TypeError(`Duplicate artifact toolset name '${value.name}'`);
+    seenNames.add(folded);
+    const members = value.tools.map((reference) => {
+      if (typeof reference === "string") return reference.trim();
+      const aliases = namesByObject.get(reference) || [];
+      if (aliases.length !== 1) throw new TypeError(`Toolset '${key}' contains an unresolved or ambiguous tool reference`);
+      return aliases[0];
+    });
+    if (new Set(members).size !== members.length) throw new TypeError(`Toolset '${key}' contains duplicate tools`);
+    for (const member of members) {
+      if (!tools.has(member)) throw new TypeError(`Toolset '${key}' references missing or non-tool export '${member}'`);
+    }
+    return { key, name: value.name, description: value.description, tools: members };
+  });
+}
+function defineArtifact(definition = {}) {
+  const normalized = normalizedExports(definition);
+  return {
+    __agents24Artifact: true,
+    exports: normalized.exports,
+    toolsets: normalizedToolsets(definition.toolsets, normalized.exports, normalized.namesByObject),
+    __agents24ToolsetsDeclared: definition.toolsets != null
+  };
+}
+function describeArtifact(value) {
+  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});
+  return artifact.exports.map(({ handler: _handler, ...item }) => item);
+}
+function describeArtifactContract(value) {
+  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});
+  return { exports: describeArtifact(artifact), toolsets: artifact.toolsets.map((item) => ({ ...item })) };
+}
+
+// src/artifacts.ts
+var tool2 = tool;
+var agentNode2 = agentNode;
+var ragOperator2 = ragOperator;
+var toolset2 = toolset;
+var defineArtifact2 = defineArtifact;
+var describeArtifact2 = describeArtifact;
+var describeArtifactContract2 = describeArtifactContract;
+
+exports.agentNode = agentNode2;
+exports.defineArtifact = defineArtifact2;
+exports.describeArtifact = describeArtifact2;
+exports.describeArtifactContract = describeArtifactContract2;
+exports.ragOperator = ragOperator2;
+exports.tool = tool2;
+exports.toolset = toolset2;
+//# sourceMappingURL=artifacts.cjs.map
+//# sourceMappingURL=artifacts.cjs.map

package/dist/artifacts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/artifacts-runtime.mjs","../src/artifacts.ts"],"names":["tool","agentNode","ragOperator","toolset","defineArtifact","describeArtifact","describeArtifactContract"],"mappings":"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","file":"artifacts.cjs","sourcesContent":["function schema(value) {\n  if (value == null) return {};\n  if (typeof value.toJSONSchema === \"function\") return value.toJSONSchema();\n  if (typeof value.toJsonSchema === \"function\") return value.toJsonSchema();\n  if (typeof value === \"object\") {\n    if (typeof value.parse === \"function\" && typeof value.safeParse === \"function\" && value._zod) {\n      throw new TypeError(\"Zod schemas must expose toJSONSchema(); install Zod v4 or pass z.toJSONSchema(schema)\");\n    }\n    return value;\n  }\n  throw new TypeError(\"schema must be a JSON Schema object or expose toJSONSchema()\");\n}\n\nfunction normalize(kind, definition = {}, handler) {\n  const actualHandler = handler || definition.handler || definition.execute;\n  const explicitName = String(definition.name || \"\").trim();\n  const name = explicitName || String(actualHandler?.name || \"\").trim();\n  const value = {\n    name,\n    kind,\n    description: definition.description || \"\",\n    input_schema: schema(definition.input_schema || definition.inputSchema || definition.input),\n    output_schema: schema(definition.output_schema || definition.outputSchema || definition.output),\n    config_schema: schema(definition.config_schema || definition.configSchema || definition.config),\n    ui_schema: definition.ui_schema || definition.uiSchema || definition.ui || {},\n    side_effects: definition.side_effects || definition.sideEffects || [],\n    execution_mode: definition.execution_mode || definition.executionMode || \"interactive\",\n    handler_ref: definition.handler_ref || definition.handlerRef || actualHandler?.name || name,\n    handler: actualHandler,\n  };\n  Object.defineProperty(value, \"__agents24ExplicitName\", { value: Boolean(explicitName), enumerable: false });\n  return value;\n}\n\nexport function tool(definition = {}, handler) {\n  return normalize(\"tool\", definition, handler);\n}\n\nexport function agentNode(definition = {}, handler) {\n  return normalize(\"agent_node\", definition, handler);\n}\n\nexport function ragOperator(definition = {}, handler) {\n  return normalize(\"rag_operator\", definition, handler);\n}\n\nexport function toolset(definition = {}) {\n  return {\n    __agents24Toolset: true,\n    name: String(definition.name || \"\").trim(),\n    description: String(definition.description || \"\").trim(),\n    tools: Array.isArray(definition.tools) ? definition.tools : [],\n  };\n}\n\nfunction entries(input) {\n  if (Array.isArray(input)) return input.map((item) => [null, item]);\n  return input && typeof input === \"object\" ? Object.entries(input) : [];\n}\n\nfunction normalizedExports(definition) {\n  const exports = [];\n  const namesByObject = new Map();\n  for (const source of [definition.tools, definition.agentNodes, definition.ragOperators]) {\n    for (const [mappedName, raw] of entries(source)) {\n      if (!raw || typeof raw !== \"object\") throw new TypeError(\"Artifact exports must use tool, agentNode, or ragOperator\");\n      const name = raw.__agents24ExplicitName ? raw.name.trim() : String(mappedName || raw.name || \"\").trim();\n      if (!name) throw new TypeError(\"Artifact exports require a name\");\n      exports.push({ ...raw, name, handler_ref: raw.handler_ref || name });\n      namesByObject.set(raw, [...(namesByObject.get(raw) || []), name]);\n    }\n  }\n  const names = exports.map((item) => item.name);\n  const duplicate = names.find((name, index) => names.indexOf(name) !== index);\n  if (duplicate) throw new TypeError(`Duplicate artifact export name '${duplicate}'`);\n  return { exports, namesByObject };\n}\n\nfunction normalizedToolsets(input, exports, namesByObject) {\n  if (input == null) return [];\n  if (Array.isArray(input) || typeof input !== \"object\") {\n    throw new TypeError(\"TypeScript artifact toolsets must be an object keyed by stable source key\");\n  }\n  const tools = new Set(exports.filter((item) => item.kind === \"tool\").map((item) => item.name));\n  const seenNames = new Set();\n  return Object.entries(input).map(([key, value]) => {\n    if (!key.trim()) throw new TypeError(\"Artifact toolset keys cannot be empty\");\n    if (!value?.__agents24Toolset) throw new TypeError(`Toolset '${key}' must use toolset()`);\n    if (!value.name || !value.description || !value.tools.length) {\n      throw new TypeError(`Toolset '${key}' requires a name, description, and tool`);\n    }\n    const folded = value.name.toLocaleLowerCase();\n    if (seenNames.has(folded)) throw new TypeError(`Duplicate artifact toolset name '${value.name}'`);\n    seenNames.add(folded);\n    const members = value.tools.map((reference) => {\n      if (typeof reference === \"string\") return reference.trim();\n      const aliases = namesByObject.get(reference) || [];\n      if (aliases.length !== 1) throw new TypeError(`Toolset '${key}' contains an unresolved or ambiguous tool reference`);\n      return aliases[0];\n    });\n    if (new Set(members).size !== members.length) throw new TypeError(`Toolset '${key}' contains duplicate tools`);\n    for (const member of members) {\n      if (!tools.has(member)) throw new TypeError(`Toolset '${key}' references missing or non-tool export '${member}'`);\n    }\n    return { key, name: value.name, description: value.description, tools: members };\n  });\n}\n\nexport function defineArtifact(definition = {}) {\n  const normalized = normalizedExports(definition);\n  return {\n    __agents24Artifact: true,\n    exports: normalized.exports,\n    toolsets: normalizedToolsets(definition.toolsets, normalized.exports, normalized.namesByObject),\n    __agents24ToolsetsDeclared: definition.toolsets != null,\n  };\n}\n\nexport function describeArtifact(value) {\n  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});\n  return artifact.exports.map(({ handler: _handler, ...item }) => item);\n}\n\nexport function describeArtifactContract(value) {\n  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});\n  return { exports: describeArtifact(artifact), toolsets: artifact.toolsets.map((item) => ({ ...item })) };\n}\n","// The executable implementation is JavaScript so the platform can inject the\n// exact same source into Worker describe/build sandboxes without transpilation.\n// @ts-expect-error package-internal JavaScript runtime has typed bindings below\nimport * as runtime from \"./artifacts-runtime.mjs\";\n\nexport type JsonSchemaSource = Record<string, unknown> | {\n  toJSONSchema?: () => Record<string, unknown>;\n  toJsonSchema?: () => Record<string, unknown>;\n};\n\nexport type ArtifactHandler = (\n  input: unknown,\n  config: Record<string, unknown>,\n  context: Record<string, unknown>,\n) => unknown | Promise<unknown>;\n\nexport type ArtifactExportDefinition = {\n  name?: string;\n  description?: string;\n  input_schema?: JsonSchemaSource;\n  inputSchema?: JsonSchemaSource;\n  input?: JsonSchemaSource;\n  output_schema?: JsonSchemaSource;\n  outputSchema?: JsonSchemaSource;\n  output?: JsonSchemaSource;\n  config_schema?: JsonSchemaSource;\n  configSchema?: JsonSchemaSource;\n  config?: JsonSchemaSource;\n  ui_schema?: Record<string, unknown>;\n  uiSchema?: Record<string, unknown>;\n  ui?: Record<string, unknown>;\n  side_effects?: string[];\n  sideEffects?: string[];\n  execution_mode?: string;\n  executionMode?: string;\n  handler_ref?: string;\n  handlerRef?: string;\n  handler?: ArtifactHandler;\n  execute?: ArtifactHandler;\n};\n\nexport type ArtifactExport = {\n  name: string;\n  kind: \"tool\" | \"agent_node\" | \"rag_operator\";\n  description: string;\n  input_schema: Record<string, unknown>;\n  output_schema: Record<string, unknown>;\n  config_schema: Record<string, unknown>;\n  ui_schema: Record<string, unknown>;\n  side_effects: string[];\n  execution_mode: string;\n  handler_ref: string;\n  handler?: ArtifactHandler;\n  readonly __agents24ExplicitName?: boolean;\n};\n\nexport type ArtifactToolset = {\n  readonly __agents24Toolset: true;\n  name: string;\n  description: string;\n  tools: Array<string | ArtifactExport>;\n};\n\nexport type ArtifactDefinition = {\n  readonly __agents24Artifact: true;\n  exports: ArtifactExport[];\n  toolsets: Array<{ key: string; name: string; description: string; tools: string[] }>;\n  readonly __agents24ToolsetsDeclared: boolean;\n};\n\nexport const tool = runtime.tool as (\n  definition?: ArtifactExportDefinition,\n  handler?: ArtifactHandler,\n) => ArtifactExport;\nexport const agentNode = runtime.agentNode as (\n  definition?: ArtifactExportDefinition,\n  handler?: ArtifactHandler,\n) => ArtifactExport;\nexport const ragOperator = runtime.ragOperator as (\n  definition?: ArtifactExportDefinition,\n  handler?: ArtifactHandler,\n) => ArtifactExport;\nexport const toolset = runtime.toolset as (\n  definition?: { name?: string; description?: string; tools?: Array<string | ArtifactExport> },\n) => ArtifactToolset;\nexport const defineArtifact = runtime.defineArtifact as (\n  definition?: Record<string, unknown>,\n) => ArtifactDefinition;\nexport const describeArtifact = runtime.describeArtifact as (\n  value: ArtifactDefinition | Record<string, unknown>,\n) => Array<Omit<ArtifactExport, \"handler\">>;\nexport const describeArtifactContract = runtime.describeArtifactContract as (\n  value: ArtifactDefinition | Record<string, unknown>,\n) => {\n  exports: Array<Omit<ArtifactExport, \"handler\">>;\n  toolsets: ArtifactDefinition[\"toolsets\"];\n};\n"]}

package/dist/artifacts.d.cts

@@ -0,0 +1,76 @@
+type JsonSchemaSource = Record<string, unknown> | {
+    toJSONSchema?: () => Record<string, unknown>;
+    toJsonSchema?: () => Record<string, unknown>;
+};
+type ArtifactHandler = (input: unknown, config: Record<string, unknown>, context: Record<string, unknown>) => unknown | Promise<unknown>;
+type ArtifactExportDefinition = {
+    name?: string;
+    description?: string;
+    input_schema?: JsonSchemaSource;
+    inputSchema?: JsonSchemaSource;
+    input?: JsonSchemaSource;
+    output_schema?: JsonSchemaSource;
+    outputSchema?: JsonSchemaSource;
+    output?: JsonSchemaSource;
+    config_schema?: JsonSchemaSource;
+    configSchema?: JsonSchemaSource;
+    config?: JsonSchemaSource;
+    ui_schema?: Record<string, unknown>;
+    uiSchema?: Record<string, unknown>;
+    ui?: Record<string, unknown>;
+    side_effects?: string[];
+    sideEffects?: string[];
+    execution_mode?: string;
+    executionMode?: string;
+    handler_ref?: string;
+    handlerRef?: string;
+    handler?: ArtifactHandler;
+    execute?: ArtifactHandler;
+};
+type ArtifactExport = {
+    name: string;
+    kind: "tool" | "agent_node" | "rag_operator";
+    description: string;
+    input_schema: Record<string, unknown>;
+    output_schema: Record<string, unknown>;
+    config_schema: Record<string, unknown>;
+    ui_schema: Record<string, unknown>;
+    side_effects: string[];
+    execution_mode: string;
+    handler_ref: string;
+    handler?: ArtifactHandler;
+    readonly __agents24ExplicitName?: boolean;
+};
+type ArtifactToolset = {
+    readonly __agents24Toolset: true;
+    name: string;
+    description: string;
+    tools: Array<string | ArtifactExport>;
+};
+type ArtifactDefinition = {
+    readonly __agents24Artifact: true;
+    exports: ArtifactExport[];
+    toolsets: Array<{
+        key: string;
+        name: string;
+        description: string;
+        tools: string[];
+    }>;
+    readonly __agents24ToolsetsDeclared: boolean;
+};
+declare const tool: (definition?: ArtifactExportDefinition, handler?: ArtifactHandler) => ArtifactExport;
+declare const agentNode: (definition?: ArtifactExportDefinition, handler?: ArtifactHandler) => ArtifactExport;
+declare const ragOperator: (definition?: ArtifactExportDefinition, handler?: ArtifactHandler) => ArtifactExport;
+declare const toolset: (definition?: {
+    name?: string;
+    description?: string;
+    tools?: Array<string | ArtifactExport>;
+}) => ArtifactToolset;
+declare const defineArtifact: (definition?: Record<string, unknown>) => ArtifactDefinition;
+declare const describeArtifact: (value: ArtifactDefinition | Record<string, unknown>) => Array<Omit<ArtifactExport, "handler">>;
+declare const describeArtifactContract: (value: ArtifactDefinition | Record<string, unknown>) => {
+    exports: Array<Omit<ArtifactExport, "handler">>;
+    toolsets: ArtifactDefinition["toolsets"];
+};
+
+export { type ArtifactDefinition, type ArtifactExport, type ArtifactExportDefinition, type ArtifactHandler, type ArtifactToolset, type JsonSchemaSource, agentNode, defineArtifact, describeArtifact, describeArtifactContract, ragOperator, tool, toolset };

package/dist/artifacts.d.ts

@@ -0,0 +1,76 @@
+type JsonSchemaSource = Record<string, unknown> | {
+    toJSONSchema?: () => Record<string, unknown>;
+    toJsonSchema?: () => Record<string, unknown>;
+};
+type ArtifactHandler = (input: unknown, config: Record<string, unknown>, context: Record<string, unknown>) => unknown | Promise<unknown>;
+type ArtifactExportDefinition = {
+    name?: string;
+    description?: string;
+    input_schema?: JsonSchemaSource;
+    inputSchema?: JsonSchemaSource;
+    input?: JsonSchemaSource;
+    output_schema?: JsonSchemaSource;
+    outputSchema?: JsonSchemaSource;
+    output?: JsonSchemaSource;
+    config_schema?: JsonSchemaSource;
+    configSchema?: JsonSchemaSource;
+    config?: JsonSchemaSource;
+    ui_schema?: Record<string, unknown>;
+    uiSchema?: Record<string, unknown>;
+    ui?: Record<string, unknown>;
+    side_effects?: string[];
+    sideEffects?: string[];
+    execution_mode?: string;
+    executionMode?: string;
+    handler_ref?: string;
+    handlerRef?: string;
+    handler?: ArtifactHandler;
+    execute?: ArtifactHandler;
+};
+type ArtifactExport = {
+    name: string;
+    kind: "tool" | "agent_node" | "rag_operator";
+    description: string;
+    input_schema: Record<string, unknown>;
+    output_schema: Record<string, unknown>;
+    config_schema: Record<string, unknown>;
+    ui_schema: Record<string, unknown>;
+    side_effects: string[];
+    execution_mode: string;
+    handler_ref: string;
+    handler?: ArtifactHandler;
+    readonly __agents24ExplicitName?: boolean;
+};
+type ArtifactToolset = {
+    readonly __agents24Toolset: true;
+    name: string;
+    description: string;
+    tools: Array<string | ArtifactExport>;
+};
+type ArtifactDefinition = {
+    readonly __agents24Artifact: true;
+    exports: ArtifactExport[];
+    toolsets: Array<{
+        key: string;
+        name: string;
+        description: string;
+        tools: string[];
+    }>;
+    readonly __agents24ToolsetsDeclared: boolean;
+};
+declare const tool: (definition?: ArtifactExportDefinition, handler?: ArtifactHandler) => ArtifactExport;
+declare const agentNode: (definition?: ArtifactExportDefinition, handler?: ArtifactHandler) => ArtifactExport;
+declare const ragOperator: (definition?: ArtifactExportDefinition, handler?: ArtifactHandler) => ArtifactExport;
+declare const toolset: (definition?: {
+    name?: string;
+    description?: string;
+    tools?: Array<string | ArtifactExport>;
+}) => ArtifactToolset;
+declare const defineArtifact: (definition?: Record<string, unknown>) => ArtifactDefinition;
+declare const describeArtifact: (value: ArtifactDefinition | Record<string, unknown>) => Array<Omit<ArtifactExport, "handler">>;
+declare const describeArtifactContract: (value: ArtifactDefinition | Record<string, unknown>) => {
+    exports: Array<Omit<ArtifactExport, "handler">>;
+    toolsets: ArtifactDefinition["toolsets"];
+};
+
+export { type ArtifactDefinition, type ArtifactExport, type ArtifactExportDefinition, type ArtifactHandler, type ArtifactToolset, type JsonSchemaSource, agentNode, defineArtifact, describeArtifact, describeArtifactContract, ragOperator, tool, toolset };

package/dist/artifacts.js

@@ -0,0 +1,130 @@
+// src/artifacts-runtime.mjs
+function schema(value) {
+  if (value == null) return {};
+  if (typeof value.toJSONSchema === "function") return value.toJSONSchema();
+  if (typeof value.toJsonSchema === "function") return value.toJsonSchema();
+  if (typeof value === "object") {
+    if (typeof value.parse === "function" && typeof value.safeParse === "function" && value._zod) {
+      throw new TypeError("Zod schemas must expose toJSONSchema(); install Zod v4 or pass z.toJSONSchema(schema)");
+    }
+    return value;
+  }
+  throw new TypeError("schema must be a JSON Schema object or expose toJSONSchema()");
+}
+function normalize(kind, definition = {}, handler) {
+  const actualHandler = handler || definition.handler || definition.execute;
+  const explicitName = String(definition.name || "").trim();
+  const name = explicitName || String(actualHandler?.name || "").trim();
+  const value = {
+    name,
+    kind,
+    description: definition.description || "",
+    input_schema: schema(definition.input_schema || definition.inputSchema || definition.input),
+    output_schema: schema(definition.output_schema || definition.outputSchema || definition.output),
+    config_schema: schema(definition.config_schema || definition.configSchema || definition.config),
+    ui_schema: definition.ui_schema || definition.uiSchema || definition.ui || {},
+    side_effects: definition.side_effects || definition.sideEffects || [],
+    execution_mode: definition.execution_mode || definition.executionMode || "interactive",
+    handler_ref: definition.handler_ref || definition.handlerRef || actualHandler?.name || name,
+    handler: actualHandler
+  };
+  Object.defineProperty(value, "__agents24ExplicitName", { value: Boolean(explicitName), enumerable: false });
+  return value;
+}
+function tool(definition = {}, handler) {
+  return normalize("tool", definition, handler);
+}
+function agentNode(definition = {}, handler) {
+  return normalize("agent_node", definition, handler);
+}
+function ragOperator(definition = {}, handler) {
+  return normalize("rag_operator", definition, handler);
+}
+function toolset(definition = {}) {
+  return {
+    __agents24Toolset: true,
+    name: String(definition.name || "").trim(),
+    description: String(definition.description || "").trim(),
+    tools: Array.isArray(definition.tools) ? definition.tools : []
+  };
+}
+function entries(input) {
+  if (Array.isArray(input)) return input.map((item) => [null, item]);
+  return input && typeof input === "object" ? Object.entries(input) : [];
+}
+function normalizedExports(definition) {
+  const exports = [];
+  const namesByObject = /* @__PURE__ */ new Map();
+  for (const source of [definition.tools, definition.agentNodes, definition.ragOperators]) {
+    for (const [mappedName, raw] of entries(source)) {
+      if (!raw || typeof raw !== "object") throw new TypeError("Artifact exports must use tool, agentNode, or ragOperator");
+      const name = raw.__agents24ExplicitName ? raw.name.trim() : String(mappedName || raw.name || "").trim();
+      if (!name) throw new TypeError("Artifact exports require a name");
+      exports.push({ ...raw, name, handler_ref: raw.handler_ref || name });
+      namesByObject.set(raw, [...namesByObject.get(raw) || [], name]);
+    }
+  }
+  const names = exports.map((item) => item.name);
+  const duplicate = names.find((name, index) => names.indexOf(name) !== index);
+  if (duplicate) throw new TypeError(`Duplicate artifact export name '${duplicate}'`);
+  return { exports, namesByObject };
+}
+function normalizedToolsets(input, exports, namesByObject) {
+  if (input == null) return [];
+  if (Array.isArray(input) || typeof input !== "object") {
+    throw new TypeError("TypeScript artifact toolsets must be an object keyed by stable source key");
+  }
+  const tools = new Set(exports.filter((item) => item.kind === "tool").map((item) => item.name));
+  const seenNames = /* @__PURE__ */ new Set();
+  return Object.entries(input).map(([key, value]) => {
+    if (!key.trim()) throw new TypeError("Artifact toolset keys cannot be empty");
+    if (!value?.__agents24Toolset) throw new TypeError(`Toolset '${key}' must use toolset()`);
+    if (!value.name || !value.description || !value.tools.length) {
+      throw new TypeError(`Toolset '${key}' requires a name, description, and tool`);
+    }
+    const folded = value.name.toLocaleLowerCase();
+    if (seenNames.has(folded)) throw new TypeError(`Duplicate artifact toolset name '${value.name}'`);
+    seenNames.add(folded);
+    const members = value.tools.map((reference) => {
+      if (typeof reference === "string") return reference.trim();
+      const aliases = namesByObject.get(reference) || [];
+      if (aliases.length !== 1) throw new TypeError(`Toolset '${key}' contains an unresolved or ambiguous tool reference`);
+      return aliases[0];
+    });
+    if (new Set(members).size !== members.length) throw new TypeError(`Toolset '${key}' contains duplicate tools`);
+    for (const member of members) {
+      if (!tools.has(member)) throw new TypeError(`Toolset '${key}' references missing or non-tool export '${member}'`);
+    }
+    return { key, name: value.name, description: value.description, tools: members };
+  });
+}
+function defineArtifact(definition = {}) {
+  const normalized = normalizedExports(definition);
+  return {
+    __agents24Artifact: true,
+    exports: normalized.exports,
+    toolsets: normalizedToolsets(definition.toolsets, normalized.exports, normalized.namesByObject),
+    __agents24ToolsetsDeclared: definition.toolsets != null
+  };
+}
+function describeArtifact(value) {
+  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});
+  return artifact.exports.map(({ handler: _handler, ...item }) => item);
+}
+function describeArtifactContract(value) {
+  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});
+  return { exports: describeArtifact(artifact), toolsets: artifact.toolsets.map((item) => ({ ...item })) };
+}
+
+// src/artifacts.ts
+var tool2 = tool;
+var agentNode2 = agentNode;
+var ragOperator2 = ragOperator;
+var toolset2 = toolset;
+var defineArtifact2 = defineArtifact;
+var describeArtifact2 = describeArtifact;
+var describeArtifactContract2 = describeArtifactContract;
+
+export { agentNode2 as agentNode, defineArtifact2 as defineArtifact, describeArtifact2 as describeArtifact, describeArtifactContract2 as describeArtifactContract, ragOperator2 as ragOperator, tool2 as tool, toolset2 as toolset };
+//# sourceMappingURL=artifacts.js.map
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/artifacts-runtime.mjs","../src/artifacts.ts"],"names":["tool","agentNode","ragOperator","toolset","defineArtifact","describeArtifact","describeArtifactContract"],"mappings":"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","file":"artifacts.js","sourcesContent":["function schema(value) {\n  if (value == null) return {};\n  if (typeof value.toJSONSchema === \"function\") return value.toJSONSchema();\n  if (typeof value.toJsonSchema === \"function\") return value.toJsonSchema();\n  if (typeof value === \"object\") {\n    if (typeof value.parse === \"function\" && typeof value.safeParse === \"function\" && value._zod) {\n      throw new TypeError(\"Zod schemas must expose toJSONSchema(); install Zod v4 or pass z.toJSONSchema(schema)\");\n    }\n    return value;\n  }\n  throw new TypeError(\"schema must be a JSON Schema object or expose toJSONSchema()\");\n}\n\nfunction normalize(kind, definition = {}, handler) {\n  const actualHandler = handler || definition.handler || definition.execute;\n  const explicitName = String(definition.name || \"\").trim();\n  const name = explicitName || String(actualHandler?.name || \"\").trim();\n  const value = {\n    name,\n    kind,\n    description: definition.description || \"\",\n    input_schema: schema(definition.input_schema || definition.inputSchema || definition.input),\n    output_schema: schema(definition.output_schema || definition.outputSchema || definition.output),\n    config_schema: schema(definition.config_schema || definition.configSchema || definition.config),\n    ui_schema: definition.ui_schema || definition.uiSchema || definition.ui || {},\n    side_effects: definition.side_effects || definition.sideEffects || [],\n    execution_mode: definition.execution_mode || definition.executionMode || \"interactive\",\n    handler_ref: definition.handler_ref || definition.handlerRef || actualHandler?.name || name,\n    handler: actualHandler,\n  };\n  Object.defineProperty(value, \"__agents24ExplicitName\", { value: Boolean(explicitName), enumerable: false });\n  return value;\n}\n\nexport function tool(definition = {}, handler) {\n  return normalize(\"tool\", definition, handler);\n}\n\nexport function agentNode(definition = {}, handler) {\n  return normalize(\"agent_node\", definition, handler);\n}\n\nexport function ragOperator(definition = {}, handler) {\n  return normalize(\"rag_operator\", definition, handler);\n}\n\nexport function toolset(definition = {}) {\n  return {\n    __agents24Toolset: true,\n    name: String(definition.name || \"\").trim(),\n    description: String(definition.description || \"\").trim(),\n    tools: Array.isArray(definition.tools) ? definition.tools : [],\n  };\n}\n\nfunction entries(input) {\n  if (Array.isArray(input)) return input.map((item) => [null, item]);\n  return input && typeof input === \"object\" ? Object.entries(input) : [];\n}\n\nfunction normalizedExports(definition) {\n  const exports = [];\n  const namesByObject = new Map();\n  for (const source of [definition.tools, definition.agentNodes, definition.ragOperators]) {\n    for (const [mappedName, raw] of entries(source)) {\n      if (!raw || typeof raw !== \"object\") throw new TypeError(\"Artifact exports must use tool, agentNode, or ragOperator\");\n      const name = raw.__agents24ExplicitName ? raw.name.trim() : String(mappedName || raw.name || \"\").trim();\n      if (!name) throw new TypeError(\"Artifact exports require a name\");\n      exports.push({ ...raw, name, handler_ref: raw.handler_ref || name });\n      namesByObject.set(raw, [...(namesByObject.get(raw) || []), name]);\n    }\n  }\n  const names = exports.map((item) => item.name);\n  const duplicate = names.find((name, index) => names.indexOf(name) !== index);\n  if (duplicate) throw new TypeError(`Duplicate artifact export name '${duplicate}'`);\n  return { exports, namesByObject };\n}\n\nfunction normalizedToolsets(input, exports, namesByObject) {\n  if (input == null) return [];\n  if (Array.isArray(input) || typeof input !== \"object\") {\n    throw new TypeError(\"TypeScript artifact toolsets must be an object keyed by stable source key\");\n  }\n  const tools = new Set(exports.filter((item) => item.kind === \"tool\").map((item) => item.name));\n  const seenNames = new Set();\n  return Object.entries(input).map(([key, value]) => {\n    if (!key.trim()) throw new TypeError(\"Artifact toolset keys cannot be empty\");\n    if (!value?.__agents24Toolset) throw new TypeError(`Toolset '${key}' must use toolset()`);\n    if (!value.name || !value.description || !value.tools.length) {\n      throw new TypeError(`Toolset '${key}' requires a name, description, and tool`);\n    }\n    const folded = value.name.toLocaleLowerCase();\n    if (seenNames.has(folded)) throw new TypeError(`Duplicate artifact toolset name '${value.name}'`);\n    seenNames.add(folded);\n    const members = value.tools.map((reference) => {\n      if (typeof reference === \"string\") return reference.trim();\n      const aliases = namesByObject.get(reference) || [];\n      if (aliases.length !== 1) throw new TypeError(`Toolset '${key}' contains an unresolved or ambiguous tool reference`);\n      return aliases[0];\n    });\n    if (new Set(members).size !== members.length) throw new TypeError(`Toolset '${key}' contains duplicate tools`);\n    for (const member of members) {\n      if (!tools.has(member)) throw new TypeError(`Toolset '${key}' references missing or non-tool export '${member}'`);\n    }\n    return { key, name: value.name, description: value.description, tools: members };\n  });\n}\n\nexport function defineArtifact(definition = {}) {\n  const normalized = normalizedExports(definition);\n  return {\n    __agents24Artifact: true,\n    exports: normalized.exports,\n    toolsets: normalizedToolsets(definition.toolsets, normalized.exports, normalized.namesByObject),\n    __agents24ToolsetsDeclared: definition.toolsets != null,\n  };\n}\n\nexport function describeArtifact(value) {\n  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});\n  return artifact.exports.map(({ handler: _handler, ...item }) => item);\n}\n\nexport function describeArtifactContract(value) {\n  const artifact = value && value.__agents24Artifact ? value : defineArtifact(value || {});\n  return { exports: describeArtifact(artifact), toolsets: artifact.toolsets.map((item) => ({ ...item })) };\n}\n","// The executable implementation is JavaScript so the platform can inject the\n// exact same source into Worker describe/build sandboxes without transpilation.\n// @ts-expect-error package-internal JavaScript runtime has typed bindings below\nimport * as runtime from \"./artifacts-runtime.mjs\";\n\nexport type JsonSchemaSource = Record<string, unknown> | {\n  toJSONSchema?: () => Record<string, unknown>;\n  toJsonSchema?: () => Record<string, unknown>;\n};\n\nexport type ArtifactHandler = (\n  input: unknown,\n  config: Record<string, unknown>,\n  context: Record<string, unknown>,\n) => unknown | Promise<unknown>;\n\nexport type ArtifactExportDefinition = {\n  name?: string;\n  description?: string;\n  input_schema?: JsonSchemaSource;\n  inputSchema?: JsonSchemaSource;\n  input?: JsonSchemaSource;\n  output_schema?: JsonSchemaSource;\n  outputSchema?: JsonSchemaSource;\n  output?: JsonSchemaSource;\n  config_schema?: JsonSchemaSource;\n  configSchema?: JsonSchemaSource;\n  config?: JsonSchemaSource;\n  ui_schema?: Record<string, unknown>;\n  uiSchema?: Record<string, unknown>;\n  ui?: Record<string, unknown>;\n  side_effects?: string[];\n  sideEffects?: string[];\n  execution_mode?: string;\n  executionMode?: string;\n  handler_ref?: string;\n  handlerRef?: string;\n  handler?: ArtifactHandler;\n  execute?: ArtifactHandler;\n};\n\nexport type ArtifactExport = {\n  name: string;\n  kind: \"tool\" | \"agent_node\" | \"rag_operator\";\n  description: string;\n  input_schema: Record<string, unknown>;\n  output_schema: Record<string, unknown>;\n  config_schema: Record<string, unknown>;\n  ui_schema: Record<string, unknown>;\n  side_effects: string[];\n  execution_mode: string;\n  handler_ref: string;\n  handler?: ArtifactHandler;\n  readonly __agents24ExplicitName?: boolean;\n};\n\nexport type ArtifactToolset = {\n  readonly __agents24Toolset: true;\n  name: string;\n  description: string;\n  tools: Array<string | ArtifactExport>;\n};\n\nexport type ArtifactDefinition = {\n  readonly __agents24Artifact: true;\n  exports: ArtifactExport[];\n  toolsets: Array<{ key: string; name: string; description: string; tools: string[] }>;\n  readonly __agents24ToolsetsDeclared: boolean;\n};\n\nexport const tool = runtime.tool as (\n  definition?: ArtifactExportDefinition,\n  handler?: ArtifactHandler,\n) => ArtifactExport;\nexport const agentNode = runtime.agentNode as (\n  definition?: ArtifactExportDefinition,\n  handler?: ArtifactHandler,\n) => ArtifactExport;\nexport const ragOperator = runtime.ragOperator as (\n  definition?: ArtifactExportDefinition,\n  handler?: ArtifactHandler,\n) => ArtifactExport;\nexport const toolset = runtime.toolset as (\n  definition?: { name?: string; description?: string; tools?: Array<string | ArtifactExport> },\n) => ArtifactToolset;\nexport const defineArtifact = runtime.defineArtifact as (\n  definition?: Record<string, unknown>,\n) => ArtifactDefinition;\nexport const describeArtifact = runtime.describeArtifact as (\n  value: ArtifactDefinition | Record<string, unknown>,\n) => Array<Omit<ArtifactExport, \"handler\">>;\nexport const describeArtifactContract = runtime.describeArtifactContract as (\n  value: ArtifactDefinition | Record<string, unknown>,\n) => {\n  exports: Array<Omit<ArtifactExport, \"handler\">>;\n  toolsets: ArtifactDefinition[\"toolsets\"];\n};\n"]}