{"_id":"@agent-creator/core","_rev":"4-aa008dc75572fca65d6c9aa28034ffb1","name":"@agent-creator/core","dist-tags":{"latest":"0.6.1"},"versions":{"0.4.2":{"name":"@agent-creator/core","version":"0.4.2","_id":"@agent-creator/core@0.4.2","maintainers":[{"name":"frivolous","email":"642935965@qq.com"}],"dist":{"shasum":"d66b0f3b9dc44b1e8c325ea9873e2449314e6905","tarball":"https://registry.npmjs.org/@agent-creator/core/-/core-0.4.2.tgz","fileCount":14,"integrity":"sha512-WjTY9tkwQ8EvwVpZjroLI04IE+TStPooRoWIjg4BFoacozVj37y72kfHlvNSxyzjZyhlvpnVbTSPfRsH+zzAvw==","signatures":[{"sig":"MEYCIQDtdHk7/n3yItgkeO1p0XHXOwzHbgGoHbXrxMaFHMLVpQIhAM33UE6t7dNStE73u/r+BVoPRkKFPLAowermmbUUGQIW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25964},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"4bfa05d5e71610b802fb65bdcedc361ffc47dc23","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","check:package":"npm pack --dry-run --json"},"_npmUser":{"name":"frivolous","email":"642935965@qq.com"},"_npmVersion":"10.9.2","description":"Composable Agent runtime with skills, memory, planning, execution, and OpenAI-compatible models.","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.23.8"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.5","typescript":"^5.9.3","@types/node":"^20.14.12"},"_npmOperationalInternal":{"tmp":"tmp/core_0.4.2_1780656688428_0.17081018321213537","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@agent-creator/core","version":"0.5.0","_id":"@agent-creator/core@0.5.0","maintainers":[{"name":"frivolous","email":"642935965@qq.com"}],"dist":{"shasum":"93164e97a8ca12c0104562da0c252508e76892b5","tarball":"https://registry.npmjs.org/@agent-creator/core/-/core-0.5.0.tgz","fileCount":16,"integrity":"sha512-JHz54cXy+mIwTAB+Xq6glCjLjXat3h8pwMixG8jFZhKjU3fW+mTf0XzSC8Il7liue5rDO2IBsV4KtNEO2Pchgg==","signatures":[{"sig":"MEUCIQC712nQmhCtnERHoBhZzvzH/RxZXPyEx0fqgeKjA5VTnwIgEXvCXbXL1PYjxFWbRwrLMkUi5PmC/O9Gdu1aEs9iXr4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52282},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"cd7ed20c55ce5efc943e26b5929e81dfdcdf4795","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","check:package":"npm pack --dry-run --json"},"_npmUser":{"name":"frivolous","email":"642935965@qq.com"},"_npmVersion":"10.9.2","description":"Composable Agent runtime with skills, memory, planning, execution, and OpenAI-compatible models.","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.23.8"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.5","typescript":"^5.9.3","@types/node":"^20.14.12"},"_npmOperationalInternal":{"tmp":"tmp/core_0.5.0_1781065486499_0.2023675935252054","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@agent-creator/core","version":"0.6.0","_id":"@agent-creator/core@0.6.0","maintainers":[{"name":"frivolous","email":"642935965@qq.com"}],"dist":{"shasum":"7a2aa31468ab1ee77084be4d3162e96d7d7c4041","tarball":"https://registry.npmjs.org/@agent-creator/core/-/core-0.6.0.tgz","fileCount":16,"integrity":"sha512-hFgUaIMWbAetlxwomMipFGX2C6ytJyE8oQ1Vsp5/fs0LgpR3gHUuVmNAENu15T5EpBdRJGsWXCSu22PnQe/ugQ==","signatures":[{"sig":"MEUCIQC0SAB1uFmPjL/rsSZL0aIcKhB7ZQLk7oECj4zvFfpwIQIgTghr9WRNLPTuIrDLooEYsOPaIKID4XV7jpn77/M7VfI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36398},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"ab0389cd762bdd80c803aec2cab7b6b31fd0a7ed","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json && node ../../scripts/minify-dist.mjs dist","check:package":"npm pack --dry-run --json"},"_npmUser":{"name":"frivolous","email":"642935965@qq.com"},"_npmVersion":"10.9.2","description":"Composable Agent runtime with skills, memory, planning, execution, and OpenAI-compatible models.","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.23.8"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.5","typescript":"^5.9.3","@types/node":"^20.14.12"},"_npmOperationalInternal":{"tmp":"tmp/core_0.6.0_1781143689801_0.6268588010105014","host":"s3://npm-registry-packages-npm-production"}},"0.6.1":{"name":"@agent-creator/core","version":"0.6.1","description":"Composable Agent runtime with skills, memory, planning, execution, and OpenAI-compatible models.","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc -p tsconfig.json && node ../../scripts/minify-dist.mjs dist","test":"vitest run","check:package":"npm pack --dry-run --json"},"dependencies":{"zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.14.12","typescript":"^5.9.3","vitest":"^2.0.5"},"engines":{"node":">=18"},"_id":"@agent-creator/core@0.6.1","gitHead":"82335c8fd8a189035bfc01ce6e2d623012341637","_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-EcBtSYXIiUMjGx5NSXxKrBvfQwIjvnQe2Diyl+/jgXfqumoV/pAp0xbx3REVXPFs4Jm0W8XddOVyvlkx/L5ZGg==","shasum":"b236aebfbfa287310b19ae6a87900394f6dedbc2","tarball":"https://registry.npmjs.org/@agent-creator/core/-/core-0.6.1.tgz","fileCount":16,"unpackedSize":36398,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEbMk9DrTt1/BKWuljr2oKUsNZEwaDVWEugKpAjeOfLhAiEAvc8TTzudEIE6a3pp6AiXk3gS2Wua07VFmf6zuwx2m+Q="}]},"_npmUser":{"name":"frivolous","email":"642935965@qq.com"},"directories":{},"maintainers":[{"name":"frivolous","email":"642935965@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/core_0.6.1_1781144117949_0.025400731563822276"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-05T10:51:28.216Z","modified":"2026-06-11T02:15:18.275Z","0.4.2":"2026-06-05T10:51:28.586Z","0.5.0":"2026-06-10T04:24:46.630Z","0.6.0":"2026-06-11T02:08:09.933Z","0.6.1":"2026-06-11T02:15:18.130Z"},"description":"Composable Agent runtime with skills, memory, planning, execution, and OpenAI-compatible models.","maintainers":[{"name":"frivolous","email":"642935965@qq.com"}],"readme":"# @agent-creator/core\n\nComposable Agent runtime for skills, memory, planning, execution, guards, traces, and OpenAI-compatible models.\n\n```ts\nimport { createAgent } from '@agent-creator/core';\n\nconst agent = createAgent({\n  model: {\n    baseUrl: 'https://api.openai.com/v1',\n    apiKey: process.env.OPENAI_API_KEY!,\n    model: 'gpt-4o-mini',\n  },\n})\n  .useSkill(mySkill)\n  .useMemory(myMemory)\n  .usePlanner(myPlanner)\n  .useExecutor(myExecutor)\n  .build();\n\nawait agent.run({ input: 'Run my task', sessionId: 'session-1' });\n```\n\n`baseUrl`, `apiKey`, and `model` are required. The package does not read environment variables automatically.\n\n## Built-In Modules\n\n`@agent-creator/core` includes lightweight defaults that can be replaced one at a time:\n\n- `InMemoryProvider`: process-local session memory with optional message/session limits and TTL.\n- `BasicGuard` / `DefaultGuard`: configurable max input length, blocklist, and allowlist checks.\n- `DefaultPlanner`: explicit skill routing via `metadata.skill`, single-skill auto routing, and `skill.name:` prefix routing.\n- `ModelSkillPlanner`: optional model-driven skill selection that falls back to normal model responses.\n- `DefaultExecutor`: validates skill I/O, applies optional skill `timeoutMs` and `retry`, and emits progress events.\n- `ConsoleTraceProvider` and `InMemoryTraceProvider`: built-in tracing for development and tests.\n- `HttpWebhookService` / `NoopWebhookService`: optional webhook notifications available from planners and skills.\n\nSkills can declare optional execution metadata:\n\n```ts\nconst skill = {\n  name: 'calendar.search',\n  description: 'Search calendar events',\n  inputSchema,\n  outputSchema,\n  permission: 'user_private',\n  timeoutMs: 5000,\n  retry: 1,\n  tags: ['calendar'],\n  async execute(input, context) {\n    return searchCalendar(input, context.userId);\n  },\n};\n```\n\n`metadata.skill` and `metadata.skillInput` are stable default-planner conventions for directly invoking a skill:\n\n```ts\nawait agent.run({\n  input: 'Search calendar',\n  metadata: {\n    skill: 'calendar.search',\n    skillInput: { query: 'today' },\n  },\n});\n```\n\nOpenAI-compatible models also support optional generation parameters:\n\n```ts\ncreateAgent({\n  model: {\n    baseUrl: 'https://api.openai.com/v1',\n    apiKey: process.env.OPENAI_API_KEY!,\n    model: 'gpt-4o-mini',\n    systemPrompt: 'You are a concise assistant.',\n    temperature: 0.2,\n    maxTokens: 512,\n    responseFormat: 'json_object',\n  },\n});\n```\n\n## Webhook Notifications\n\nWebhook is a runtime service for developer-controlled side effects. Configure the URL in code or environment, then call it from a planner or skill through context:\n\n```ts\nconst agent = createAgent({\n  model,\n  webhook: {\n    url: process.env.WEBHOOK_URL ?? '',\n  },\n})\n  .useSkill({\n    name: 'build.run',\n    description: 'Run a build',\n    inputSchema,\n    outputSchema,\n    async execute(input, context) {\n      await context.webhook?.notify({\n        event: 'build.completed',\n        message: `Build completed for ${input.project}`,\n      });\n      return { ok: true };\n    },\n  })\n  .build();\n```\n\nWebhook delivery is best-effort by default: missing URLs, HTTP failures, and network errors do not fail the Agent run. The webhook URL is developer configuration and should not come from model output or user input.\n\nFor explicit Agent-triggered notifications, register the optional webhook skill:\n\n```ts\nimport { createWebhookSkill } from '@agent-creator/core';\n\nbuilder.useSkill(createWebhookSkill({\n  url: process.env.WEBHOOK_URL ?? '',\n}));\n```\n","readmeFilename":"README.md"}