@agents24/cli 0.1.0

package/dist/cli.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+import {
+  assertImportAllowed,
+  createRemoteClient,
+  initializePackage,
+  packPackage,
+  parseMappings,
+  validatePackage
+} from "./chunk-I2XQSX32.js";
+
+// src/cli.ts
+import { basename, resolve } from "path";
+import { writeFile } from "fs/promises";
+import { createInterface } from "readline/promises";
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["json", "remote", "yes", "allow-incomplete"]);
+function parse(argv) {
+  if (argv[0] !== "package" || !argv[1]) throw new Error("Usage: agents24 package <init|validate|pack|export|compile|preview|import>");
+  const flags = /* @__PURE__ */ new Map();
+  const positionals = [];
+  for (let index = 2; index < argv.length; index += 1) {
+    const current = argv[index];
+    if (!current.startsWith("--")) {
+      positionals.push(current);
+      continue;
+    }
+    const [rawName, inline] = current.slice(2).split("=", 2);
+    if (!rawName) throw new Error("Invalid option");
+    const value = inline ?? (BOOLEAN_FLAGS.has(rawName) ? "true" : argv[++index]);
+    if (value === void 0 || value.startsWith("--")) throw new Error(`--${rawName} requires a value`);
+    flags.set(rawName, [...flags.get(rawName) || [], value]);
+  }
+  return { command: argv[1], positionals, flags };
+}
+function flag(parsed, name) {
+  return parsed.flags.get(name)?.at(-1);
+}
+function values(parsed, name) {
+  return parsed.flags.get(name) || [];
+}
+function mappings(parsed) {
+  return parseMappings(values(parsed, "map"));
+}
+function upload(data, input) {
+  return { data, filename: basename(input).endsWith(".zip") ? basename(input) : "resource.agents24.zip" };
+}
+function safeResult(result) {
+  return result;
+}
+async function confirmation(parsed, preview) {
+  const resources = Array.isArray(preview.resources) ? preview.resources : [];
+  const yes = flag(parsed, "yes") === "true";
+  assertImportAllowed(preview, {
+    allowIncomplete: flag(parsed, "allow-incomplete") === "true",
+    yes,
+    interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY)
+  });
+  if (yes) return;
+  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await prompt.question(`Import ${resources.length} resource draft(s)? [y/N] `);
+  prompt.close();
+  if (!/^y(?:es)?$/i.test(answer.trim())) throw new Error("Import cancelled");
+}
+async function compiledPackage(parsed) {
+  const input = parsed.positionals[0];
+  if (!input) throw new Error(`${parsed.command} requires a package directory or ZIP`);
+  const local = await validatePackage(input);
+  if (!local.valid) throw Object.assign(new Error("Resource package is invalid"), { diagnostics: local.diagnostics });
+  const data = await packPackage(input);
+  const client = await createRemoteClient();
+  const result = await client.resourcePackages.compilePackage(upload(data, input));
+  return { data, result };
+}
+async function execute(parsed) {
+  if (parsed.command === "init") {
+    const directory = resolve(parsed.positionals[0] || ".");
+    const name = flag(parsed, "name") || basename(directory);
+    const packageName = await initializePackage(directory, name);
+    return { ok: true, directory, package: packageName };
+  }
+  if (parsed.command === "validate") {
+    const input = parsed.positionals[0];
+    if (!input) throw new Error("validate requires a package directory or ZIP");
+    const local = await validatePackage(input);
+    let remote;
+    if (flag(parsed, "remote") === "true" && local.valid) {
+      const data = await packPackage(input);
+      remote = await (await createRemoteClient()).resourcePackages.validatePackage(upload(data, input));
+    }
+    return { ok: local.valid && (!remote || remote.valid === true), local: { ...local, files: void 0 }, ...remote ? { remote } : {} };
+  }
+  if (parsed.command === "pack") {
+    const input = parsed.positionals[0];
+    if (!input) throw new Error("pack requires a package directory");
+    const data = await packPackage(input);
+    const output = resolve(flag(parsed, "output") || `${basename(resolve(input))}.agents24.zip`);
+    await writeFile(output, data);
+    return { ok: true, output, bytes: data.byteLength };
+  }
+  if (parsed.command === "export") {
+    const kind = flag(parsed, "kind");
+    const id = flag(parsed, "id");
+    if (!kind || !id) throw new Error("export requires --kind and --id");
+    const target = flag(parsed, "target") || "draft";
+    const request = {
+      root: { kind, id, target, ...flag(parsed, "version-id") ? { version_id: flag(parsed, "version-id") } : {} }
+    };
+    const archive = await (await createRemoteClient()).resourcePackages.exportPackage(request);
+    const output = resolve(flag(parsed, "output") || archive.filename);
+    await writeFile(output, archive.data);
+    return { ok: true, output, bytes: archive.data.byteLength };
+  }
+  if (parsed.command === "compile") {
+    const { result } = await compiledPackage(parsed);
+    const output = flag(parsed, "output");
+    if (output) await writeFile(resolve(output), `${JSON.stringify(result.bundle, null, 2)}
+`);
+    return { ok: result.valid === true, ...output ? { output: resolve(output) } : {}, result: safeResult(result) };
+  }
+  if (parsed.command === "preview" || parsed.command === "import") {
+    const { result } = await compiledPackage(parsed);
+    if (result.valid !== true || !result.bundle || typeof result.bundle !== "object") throw new Error("Remote compilation did not produce a bundle");
+    const request = {
+      bundle: result.bundle,
+      mappings: mappings(parsed)
+    };
+    const client = await createRemoteClient();
+    const preview = await client.resourceBundles.importPreview(request);
+    if (parsed.command === "preview") return { ok: preview.can_import === true, preview };
+    if (preview.can_import !== true) return { ok: false, preview };
+    await confirmation(parsed, preview);
+    return { ok: true, preview, result: await client.resourceBundles.importBundle(request) };
+  }
+  throw new Error(`Unknown package command: ${parsed.command}`);
+}
+function diagnostics(error) {
+  if (!error || typeof error !== "object") return void 0;
+  const record = error;
+  if (Array.isArray(record.diagnostics)) return record.diagnostics;
+  if (!record.details || typeof record.details !== "object" || Array.isArray(record.details)) return void 0;
+  const detail = record.details.detail;
+  if (!detail || typeof detail !== "object" || Array.isArray(detail)) return void 0;
+  const value = detail.diagnostics;
+  return Array.isArray(value) ? value : void 0;
+}
+async function run(argv = process.argv.slice(2)) {
+  let parsed;
+  try {
+    parsed = parse(argv);
+    const result = await execute(parsed);
+    if (flag(parsed, "json") === "true") process.stdout.write(`${JSON.stringify(result)}
+`);
+    else if (result.ok === false) process.stderr.write(`${JSON.stringify(result, null, 2)}
+`);
+    else process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+    return result.ok === false ? 1 : 0;
+  } catch (error) {
+    const payload = {
+      ok: false,
+      error: error instanceof Error ? error.message : "Unexpected CLI failure",
+      ...diagnostics(error) ? { diagnostics: diagnostics(error) } : {}
+    };
+    const body = parsed && flag(parsed, "json") === "true" ? JSON.stringify(payload) : JSON.stringify(payload, null, 2);
+    process.stderr.write(`${body}
+`);
+    return 1;
+  }
+}
+process.exitCode = await run();
+export {
+  run
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { basename, resolve } from \"node:path\";\nimport { writeFile } from \"node:fs/promises\";\nimport { createInterface } from \"node:readline/promises\";\n\nimport { initializePackage, packPackage, validatePackage, type Diagnostic } from \"./package-source.js\";\nimport { createRemoteClient } from \"./remote.js\";\nimport { assertImportAllowed, parseMappings } from \"./import-guards.js\";\n\ntype Parsed = {\n  command: string;\n  positionals: string[];\n  flags: Map<string, string[]>;\n};\n\nconst BOOLEAN_FLAGS = new Set([\"json\", \"remote\", \"yes\", \"allow-incomplete\"]);\n\nfunction parse(argv: string[]): Parsed {\n  if (argv[0] !== \"package\" || !argv[1]) throw new Error(\"Usage: agents24 package <init|validate|pack|export|compile|preview|import>\");\n  const flags = new Map<string, string[]>();\n  const positionals: string[] = [];\n  for (let index = 2; index < argv.length; index += 1) {\n    const current = argv[index];\n    if (!current.startsWith(\"--\")) { positionals.push(current); continue; }\n    const [rawName, inline] = current.slice(2).split(\"=\", 2);\n    if (!rawName) throw new Error(\"Invalid option\");\n    const value = inline ?? (BOOLEAN_FLAGS.has(rawName) ? \"true\" : argv[++index]);\n    if (value === undefined || value.startsWith(\"--\")) throw new Error(`--${rawName} requires a value`);\n    flags.set(rawName, [...(flags.get(rawName) || []), value]);\n  }\n  return { command: argv[1], positionals, flags };\n}\n\nfunction flag(parsed: Parsed, name: string): string | undefined {\n  return parsed.flags.get(name)?.at(-1);\n}\n\nfunction values(parsed: Parsed, name: string): string[] {\n  return parsed.flags.get(name) || [];\n}\n\nfunction mappings(parsed: Parsed): Record<string, string> {\n  return parseMappings(values(parsed, \"map\"));\n}\n\nfunction upload(data: Uint8Array, input: string): { data: Uint8Array; filename: string } {\n  return { data, filename: basename(input).endsWith(\".zip\") ? basename(input) : \"resource.agents24.zip\" };\n}\n\nfunction safeResult(result: Record<string, unknown>): Record<string, unknown> {\n  return result;\n}\n\nasync function confirmation(parsed: Parsed, preview: Record<string, unknown>): Promise<void> {\n  const resources = Array.isArray(preview.resources) ? preview.resources as Array<Record<string, unknown>> : [];\n  const yes = flag(parsed, \"yes\") === \"true\";\n  assertImportAllowed(preview, {\n    allowIncomplete: flag(parsed, \"allow-incomplete\") === \"true\",\n    yes,\n    interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),\n  });\n  if (yes) return;\n  const prompt = createInterface({ input: process.stdin, output: process.stdout });\n  const answer = await prompt.question(`Import ${resources.length} resource draft(s)? [y/N] `);\n  prompt.close();\n  if (!/^y(?:es)?$/i.test(answer.trim())) throw new Error(\"Import cancelled\");\n}\n\nasync function compiledPackage(parsed: Parsed): Promise<{ data: Uint8Array; result: Record<string, unknown> }> {\n  const input = parsed.positionals[0];\n  if (!input) throw new Error(`${parsed.command} requires a package directory or ZIP`);\n  const local = await validatePackage(input);\n  if (!local.valid) throw Object.assign(new Error(\"Resource package is invalid\"), { diagnostics: local.diagnostics });\n  const data = await packPackage(input);\n  const client = await createRemoteClient();\n  const result = await client.resourcePackages.compilePackage(upload(data, input));\n  return { data, result };\n}\n\nasync function execute(parsed: Parsed): Promise<Record<string, unknown>> {\n  if (parsed.command === \"init\") {\n    const directory = resolve(parsed.positionals[0] || \".\");\n    const name = flag(parsed, \"name\") || basename(directory);\n    const packageName = await initializePackage(directory, name);\n    return { ok: true, directory, package: packageName };\n  }\n  if (parsed.command === \"validate\") {\n    const input = parsed.positionals[0];\n    if (!input) throw new Error(\"validate requires a package directory or ZIP\");\n    const local = await validatePackage(input);\n    let remote: Record<string, unknown> | undefined;\n    if (flag(parsed, \"remote\") === \"true\" && local.valid) {\n      const data = await packPackage(input);\n      remote = await (await createRemoteClient()).resourcePackages.validatePackage(upload(data, input));\n    }\n    return { ok: local.valid && (!remote || remote.valid === true), local: { ...local, files: undefined }, ...(remote ? { remote } : {}) };\n  }\n  if (parsed.command === \"pack\") {\n    const input = parsed.positionals[0];\n    if (!input) throw new Error(\"pack requires a package directory\");\n    const data = await packPackage(input);\n    const output = resolve(flag(parsed, \"output\") || `${basename(resolve(input))}.agents24.zip`);\n    await writeFile(output, data);\n    return { ok: true, output, bytes: data.byteLength };\n  }\n  if (parsed.command === \"export\") {\n    const kind = flag(parsed, \"kind\");\n    const id = flag(parsed, \"id\");\n    if (!kind || !id) throw new Error(\"export requires --kind and --id\");\n    const target = flag(parsed, \"target\") || \"draft\";\n    const request = {\n      root: { kind, id, target, ...(flag(parsed, \"version-id\") ? { version_id: flag(parsed, \"version-id\") } : {}) },\n    };\n    const archive = await (await createRemoteClient()).resourcePackages.exportPackage(request);\n    const output = resolve(flag(parsed, \"output\") || archive.filename);\n    await writeFile(output, archive.data);\n    return { ok: true, output, bytes: archive.data.byteLength };\n  }\n  if (parsed.command === \"compile\") {\n    const { result } = await compiledPackage(parsed);\n    const output = flag(parsed, \"output\");\n    if (output) await writeFile(resolve(output), `${JSON.stringify(result.bundle, null, 2)}\\n`);\n    return { ok: result.valid === true, ...(output ? { output: resolve(output) } : {}), result: safeResult(result) };\n  }\n  if (parsed.command === \"preview\" || parsed.command === \"import\") {\n    const { result } = await compiledPackage(parsed);\n    if (result.valid !== true || !result.bundle || typeof result.bundle !== \"object\") throw new Error(\"Remote compilation did not produce a bundle\");\n    const request = {\n      bundle: result.bundle as Record<string, unknown>,\n      mappings: mappings(parsed),\n    };\n    const client = await createRemoteClient();\n    const preview = await client.resourceBundles.importPreview(request);\n    if (parsed.command === \"preview\") return { ok: preview.can_import === true, preview };\n    if (preview.can_import !== true) return { ok: false, preview };\n    await confirmation(parsed, preview);\n    return { ok: true, preview, result: await client.resourceBundles.importBundle(request) };\n  }\n  throw new Error(`Unknown package command: ${parsed.command}`);\n}\n\nfunction diagnostics(error: unknown): Diagnostic[] | undefined {\n  if (!error || typeof error !== \"object\") return undefined;\n  const record = error as { diagnostics?: unknown; details?: unknown };\n  if (Array.isArray(record.diagnostics)) return record.diagnostics as Diagnostic[];\n  if (!record.details || typeof record.details !== \"object\" || Array.isArray(record.details)) return undefined;\n  const detail = (record.details as Record<string, unknown>).detail;\n  if (!detail || typeof detail !== \"object\" || Array.isArray(detail)) return undefined;\n  const value = (detail as Record<string, unknown>).diagnostics;\n  return Array.isArray(value) ? value as Diagnostic[] : undefined;\n}\n\nexport async function run(argv = process.argv.slice(2)): Promise<number> {\n  let parsed: Parsed | undefined;\n  try {\n    parsed = parse(argv);\n    const result = await execute(parsed);\n    if (flag(parsed, \"json\") === \"true\") process.stdout.write(`${JSON.stringify(result)}\\n`);\n    else if (result.ok === false) process.stderr.write(`${JSON.stringify(result, null, 2)}\\n`);\n    else process.stdout.write(`${JSON.stringify(result, null, 2)}\\n`);\n    return result.ok === false ? 1 : 0;\n  } catch (error) {\n    const payload = {\n      ok: false,\n      error: error instanceof Error ? error.message : \"Unexpected CLI failure\",\n      ...(diagnostics(error) ? { diagnostics: diagnostics(error) } : {}),\n    };\n    const body = parsed && flag(parsed, \"json\") === \"true\" ? JSON.stringify(payload) : JSON.stringify(payload, null, 2);\n    process.stderr.write(`${body}\\n`);\n    return 1;\n  }\n}\n\nprocess.exitCode = await run();\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+declare function packFiles(files: Map<string, string>): Uint8Array;
+declare function unpackFiles(value: Uint8Array): Map<string, string>;
+
+type Diagnostic = {
+    severity: "error" | "warning";
+    code: string;
+    path: string;
+    message: string;
+};
+type ValidationResult = {
+    valid: boolean;
+    package: Record<string, unknown>;
+    resources: Array<Record<string, unknown>>;
+    requirements: string[];
+    diagnostics: Diagnostic[];
+    files: Map<string, string>;
+};
+declare function loadPackageFiles(input: string): Promise<Map<string, string>>;
+declare function validateFiles(files: Map<string, string>): ValidationResult;
+declare function validatePackage(input: string): Promise<ValidationResult>;
+declare function packPackage(input: string): Promise<Uint8Array>;
+declare function initializePackage(directory: string, packageName: string): Promise<string>;
+
+declare function parseMappings(items: string[]): Record<string, string>;
+declare function assertImportAllowed(preview: Record<string, unknown>, options: {
+    allowIncomplete: boolean;
+    yes: boolean;
+    interactive: boolean;
+}): void;
+
+type ResourcePackageUpload = {
+    data: Uint8Array;
+    filename?: string;
+};
+type ResourceBundleRequest = {
+    bundle: Record<string, unknown>;
+    selected_resource_keys?: string[];
+    mappings?: Record<string, string>;
+};
+type RemoteClient = {
+    resourcePackages: {
+        exportPackage(request: Record<string, unknown>): Promise<{
+            data: Uint8Array;
+            filename: string;
+        }>;
+        validatePackage(upload: ResourcePackageUpload): Promise<Record<string, unknown>>;
+        compilePackage(upload: ResourcePackageUpload): Promise<Record<string, unknown>>;
+    };
+    resourceBundles: {
+        importPreview(request: ResourceBundleRequest): Promise<Record<string, unknown>>;
+        importBundle(request: ResourceBundleRequest): Promise<Record<string, unknown>>;
+    };
+};
+declare function createRemoteClient(environment?: NodeJS.ProcessEnv): Promise<RemoteClient>;
+
+export { type Diagnostic, type RemoteClient, type ValidationResult, assertImportAllowed, createRemoteClient, initializePackage, loadPackageFiles, packFiles, packPackage, parseMappings, unpackFiles, validateFiles, validatePackage };

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  assertImportAllowed,
+  createRemoteClient,
+  initializePackage,
+  loadPackageFiles,
+  packFiles,
+  packPackage,
+  parseMappings,
+  unpackFiles,
+  validateFiles,
+  validatePackage
+} from "./chunk-I2XQSX32.js";
+export {
+  assertImportAllowed,
+  createRemoteClient,
+  initializePackage,
+  loadPackageFiles,
+  packFiles,
+  packPackage,
+  parseMappings,
+  unpackFiles,
+  validateFiles,
+  validatePackage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/generated/schemas/resource-package/1.0/agent.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.agents24.dev/schemas/resource-package/1.0/agent.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "name",
+    "description",
+    "model"
+  ],
+  "properties": {
+    "schema": {
+      "const": "agents24.agent/v1"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1
+    },
+    "model": {
+      "type": "string"
+    },
+    "instructions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "kind",
+          "uses"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "kind": {
+            "enum": [
+              "agent",
+              "rag",
+              "tool",
+              "toolset",
+              "integration"
+            ]
+          },
+          "uses": {
+            "type": "string"
+          },
+          "load": {
+            "enum": [
+              "static",
+              "dynamic"
+            ]
+          }
+        }
+      }
+    },
+    "reasoning": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "effort": {
+          "enum": [
+            "low",
+            "medium",
+            "high"
+          ]
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "tool_mode": {
+          "enum": [
+            "sequential",
+            "parallel_safe"
+          ]
+        },
+        "max_tool_iterations": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "max_parallel_tools": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "chat_history": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        }
+      }
+    },
+    "structured_output": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "format": {
+          "enum": [
+            "text",
+            "json"
+          ]
+        },
+        "schema": {
+          "type": "object"
+        }
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/generated/schemas/resource-package/1.0/manifest.schema.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.agents24.dev/schemas/resource-package/1.0/manifest.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "name",
+    "entrypoint"
+  ],
+  "$defs": {
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "type": "string",
+          "maxLength": 2000
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "match": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            }
+          }
+        }
+      }
+    }
+  },
+  "properties": {
+    "schema": {
+      "const": "agents24.package/v1"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 2000
+    },
+    "version": {
+      "type": "string"
+    },
+    "entrypoint": {
+      "type": "string",
+      "pattern": "^(workflows|rag|skills)/[a-z0-9][a-z0-9-]*\\.(yaml|md)$"
+    },
+    "requires": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "workflows": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "rag": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "skills": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "models": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "stores": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "tools": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "toolsets": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "artifacts": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "integrations": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        },
+        "secrets": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/requirement"
+          }
+        }
+      }
+    }
+  }
+}

package/generated/schemas/resource-package/1.0/rag.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://docs.agents24.dev/schemas/resource-package/1.0/rag.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "name",
+    "mode",
+    "steps"
+  ],
+  "properties": {
+    "schema": {
+      "const": "agents24.rag/v1"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "mode": {
+      "enum": [
+        "ingestion",
+        "retrieval"
+      ]
+    },
+    "inputs": {
+      "type": "object"
+    },
+    "outputs": {
+      "type": "object"
+    },
+    "steps": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "uses"
+        ],
+        "properties": {
+          "uses": {
+            "type": "string"
+          },
+          "with": {
+            "type": "object"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "flow": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "from",
+          "to"
+        ],
+        "properties": {
+          "from": {
+            "type": "string"
+          },
+          "to": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "tool": {
+      "type": "object",
+      "required": [
+        "name",
+        "description"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}