{"_id":"@ar-agents/incorporate","_rev":"3-50dbc663c6bf4436f66b9ae3d21e6e62","name":"@ar-agents/incorporate","dist-tags":{"latest":"0.3.0"},"versions":{"0.2.0":{"name":"@ar-agents/incorporate","version":"0.2.0","keywords":["ar-agents","argentina","sociedad-ia","sociedades-de-ia","incorporate","auto-incorporate","agentic","ai-agent","vercel-ai-sdk","rfc-001","audit-log","hmac","client","sdk"],"author":{"name":"Nazareno Clemente","email":"naza@helloastro.co"},"license":"MIT","_id":"@ar-agents/incorporate@0.2.0","maintainers":[{"name":"naza-ar","email":"clementenaza@gmail.com"}],"homepage":"https://ar-agents.vercel.app/api/auto-incorporate","bugs":{"url":"https://github.com/ar-agents/ar-agents/issues"},"dist":{"shasum":"15f2a0c0218445d9ffc3022950d4af3ff283e2e1","tarball":"https://registry.npmjs.org/@ar-agents/incorporate/-/incorporate-0.2.0.tgz","fileCount":10,"integrity":"sha512-KzR1v8bFTiz6ha3YjPyId2TuWIt7Q63t5Vl1uCLcXgvHb1CT7volVlX86Y/GLepa3nCV0tllDzNp4TM31gujrQ==","signatures":[{"sig":"MEUCIQC2eGOc6uIWsTKkHpkXRxUuxx5Sduz+P/p4sVRFezZ5GAIgPrT+v6D8CRV2KlGgEGZ1Fws34fV9ApZbKN9l0OECEHc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ar-agents%2fincorporate@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":64766},"main":"./dist/index.cjs","type":"module","_from":"file:ar-agents-incorporate-0.2.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20.0.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"funding":{"url":"https://github.com/sponsors/naza00000","type":"github"},"scripts":{"lint":"echo 'no lint configured yet'","size":"size-limit","test":"vitest run","build":"tsup","clean":"rm -rf dist","validate":"publint && attw --pack .","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"naza-ar","email":"clementenaza@gmail.com"},"_resolved":"/tmp/35cfb5771120499ca24aeb5437aeec00/ar-agents-incorporate-0.2.0.tgz","_integrity":"sha512-KzR1v8bFTiz6ha3YjPyId2TuWIt7Q63t5Vl1uCLcXgvHb1CT7volVlX86Y/GLepa3nCV0tllDzNp4TM31gujrQ==","repository":{"url":"git+https://github.com/ar-agents/ar-agents.git","type":"git","directory":"packages/incorporate"},"size-limit":[{"name":"ESM","path":"dist/index.js","limit":"4 KB"},{"name":"CJS","path":"dist/index.cjs","limit":"4 KB"}],"_npmVersion":"10.8.2","description":"Zero-dependency TypeScript client for the ar-agents.vercel.app/api/auto-incorporate endpoint. Lets an external agent (USA-LLC, ChatGPT, Claude, Gemini) self-incorporate an Argentine sociedad-IA in one call. Returns generated source files, Vercel deploy UR","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","typescript":"^5.9.3","@types/node":"^20.19.39"},"_npmOperationalInternal":{"tmp":"tmp/incorporate_0.2.0_1778351101727_0.7843602164641925","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@ar-agents/incorporate","version":"0.2.1","keywords":["ar-agents","argentina","sociedad-ia","sociedades-de-ia","incorporate","auto-incorporate","agentic","ai-agent","vercel-ai-sdk","rfc-001","audit-log","hmac","client","sdk"],"author":{"name":"Nazareno Clemente","email":"naza@helloastro.co"},"license":"MIT","_id":"@ar-agents/incorporate@0.2.1","maintainers":[{"name":"naza-ar","email":"clementenaza@gmail.com"}],"homepage":"https://ar-agents.ar/api/auto-incorporate","bugs":{"url":"https://github.com/ar-agents/ar-agents/issues"},"dist":{"shasum":"22291f7a35716eceeaa56b85c077016c5c454e4b","tarball":"https://registry.npmjs.org/@ar-agents/incorporate/-/incorporate-0.2.1.tgz","fileCount":10,"integrity":"sha512-yhxzdHn50N1qEU5sn64Zt6mMdhgWkD42mMD5qZh+WoQq7QXteHZeqaHSvotBdaZ2NszNdxAI/97E3NAoWNh2xA==","signatures":[{"sig":"MEUCIAVaU3HLScHjZbvIcHnbcKzNKinLnxdYcr2IToITIN5HAiEA9vqGL+cYM7+gt9w651p6vl0HlLiT1dpU6jZnxDH9A4E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ar-agents%2fincorporate@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":64752},"main":"./dist/index.cjs","type":"module","_from":"file:ar-agents-incorporate-0.2.1.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20.0.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"funding":{"url":"https://github.com/sponsors/naza00000","type":"github"},"scripts":{"lint":"echo 'no lint configured yet'","size":"size-limit","test":"vitest run","build":"tsup","clean":"rm -rf dist","validate":"publint && attw --pack .","typecheck":"tsc --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"naza-ar","email":"clementenaza@gmail.com"},"_resolved":"/tmp/8c01499e7487c0916a0c80c602956512/ar-agents-incorporate-0.2.1.tgz","_integrity":"sha512-yhxzdHn50N1qEU5sn64Zt6mMdhgWkD42mMD5qZh+WoQq7QXteHZeqaHSvotBdaZ2NszNdxAI/97E3NAoWNh2xA==","repository":{"url":"git+https://github.com/ar-agents/ar-agents.git","type":"git","directory":"packages/incorporate"},"size-limit":[{"name":"ESM","path":"dist/index.js","limit":"4 KB"},{"name":"CJS","path":"dist/index.cjs","limit":"4 KB"}],"_npmVersion":"10.8.2","description":"Zero-dependency TypeScript client for the ar-agents.ar/api/auto-incorporate endpoint. Lets an external agent (USA-LLC, ChatGPT, Claude, Gemini) self-incorporate an Argentine sociedad-IA in one call. Returns generated source files, Vercel deploy URL, signe","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","typescript":"^5.9.3","@types/node":"^20.19.39"},"_npmOperationalInternal":{"tmp":"tmp/incorporate_0.2.1_1781269121395_0.7822449307145012","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@ar-agents/incorporate","version":"0.3.0","description":"Zero-dependency TypeScript client for the ar-agents.ar/api/auto-incorporate endpoint. Lets an external agent (USA-LLC, ChatGPT, Claude, Gemini) self-incorporate an Argentine sociedad-IA in one call. Returns generated source files, Vercel deploy URL, signe","keywords":["ar-agents","argentina","sociedad-ia","sociedades-de-ia","incorporate","auto-incorporate","agentic","ai-agent","vercel-ai-sdk","rfc-001","audit-log","hmac","client","sdk"],"license":"MIT","author":{"name":"Nazareno Clemente","email":"naza@naza.ar"},"funding":{"type":"github","url":"https://github.com/sponsors/naza00000"},"homepage":"https://ar-agents.ar/api/auto-incorporate","repository":{"type":"git","url":"git+https://github.com/ar-agents/ar-agents.git","directory":"packages/incorporate"},"bugs":{"url":"https://github.com/ar-agents/ar-agents/issues"},"type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"size-limit":[{"name":"ESM","path":"dist/index.js","limit":"4 KB"},{"name":"CJS","path":"dist/index.cjs","limit":"4 KB"}],"devDependencies":{"@types/node":"^20.19.39","tsup":"^8.3.5","typescript":"^5.9.3","vitest":"^2.1.8"},"publishConfig":{"access":"public","provenance":true},"engines":{"node":">=20.0.0"},"scripts":{"build":"tsup","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","typecheck":"tsc --noEmit","lint":"echo 'no lint configured yet'","validate":"publint && attw --pack .","size":"size-limit","clean":"rm -rf dist"},"_id":"@ar-agents/incorporate@0.3.0","_integrity":"sha512-eWYS+uG6aD1DTTfZQeTORRvxq8WMsHnTpoCoSY9BlIeIvE2Fmnecw3jlvJEYk0C5MOpHLSX+JSleLzbFIdUhfg==","_resolved":"/tmp/96a7ddca18e308b90df178ce4cda25a8/ar-agents-incorporate-0.3.0.tgz","_from":"file:ar-agents-incorporate-0.3.0.tgz","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-eWYS+uG6aD1DTTfZQeTORRvxq8WMsHnTpoCoSY9BlIeIvE2Fmnecw3jlvJEYk0C5MOpHLSX+JSleLzbFIdUhfg==","shasum":"d21b31fa84c4671870a43688318dadb92f02a089","tarball":"https://registry.npmjs.org/@ar-agents/incorporate/-/incorporate-0.3.0.tgz","fileCount":10,"unpackedSize":69502,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ar-agents%2fincorporate@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBXBFgqj4NB/2fm97qgMtGLhVhXaMyqqEigi7pGFxtaLAiEA5ZeJL46VwYJikrE3HCIu3k4yHWjC0MzEpZUzD9Nmkh4="}]},"_npmUser":{"name":"naza-ar","email":"clementenaza@gmail.com"},"directories":{},"maintainers":[{"name":"naza-ar","email":"clementenaza@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/incorporate_0.3.0_1783086479277_0.06562043343104684"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-09T18:25:01.662Z","modified":"2026-07-03T13:47:59.723Z","0.2.0":"2026-05-09T18:25:01.884Z","0.2.1":"2026-06-12T12:58:41.570Z","0.3.0":"2026-07-03T13:47:59.462Z"},"bugs":{"url":"https://github.com/ar-agents/ar-agents/issues"},"author":{"name":"Nazareno Clemente","email":"naza@naza.ar"},"license":"MIT","homepage":"https://ar-agents.ar/api/auto-incorporate","keywords":["ar-agents","argentina","sociedad-ia","sociedades-de-ia","incorporate","auto-incorporate","agentic","ai-agent","vercel-ai-sdk","rfc-001","audit-log","hmac","client","sdk"],"repository":{"type":"git","url":"git+https://github.com/ar-agents/ar-agents.git","directory":"packages/incorporate"},"description":"Zero-dependency TypeScript client for the ar-agents.ar/api/auto-incorporate endpoint. Lets an external agent (USA-LLC, ChatGPT, Claude, Gemini) self-incorporate an Argentine sociedad-IA in one call. Returns generated source files, Vercel deploy URL, signe","maintainers":[{"name":"naza-ar","email":"clementenaza@gmail.com"}],"readme":"# @ar-agents/incorporate\n\n> Zero-dependency TypeScript client for [`/api/auto-incorporate`](https://ar-agents.ar/api/auto-incorporate). One async call → an Argentine sociedad-IA's full incorporation kit (generated source files, Vercel deploy URL, env-var manifest, legal checklist, signed audit-log reference).\n\n[![npm version](https://img.shields.io/npm/v/@ar-agents/incorporate.svg)](https://www.npmjs.com/package/@ar-agents/incorporate)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![SLSA v1](https://img.shields.io/badge/SLSA-v1-success)](https://slsa.dev)\n\n## Why\n\nWhen the AR sociedad-IA regime ships (anuncio Sturzenegger 28-abr-2026), an external agent (USA-LLC, ChatGPT, Claude, Gemini) should be able to spin up a properly-configured AR sociedad in one programmatic call — not by clicking through a wizard. This package is the canonical surface for that, designed to fit cleanly into any agent's tool list or any orchestration script.\n\nThe companion human-facing UI is at [/incorporar](https://ar-agents.ar/incorporar). Same backend, same generated output.\n\n## Install\n\n```bash\npnpm add @ar-agents/incorporate\n```\n\nZero runtime dependencies. Works in Node 20+, Edge Runtime, Cloudflare Workers, Deno, and browsers (with CORS).\n\n## Quickstart\n\n```ts\nimport { incorporate } from \"@ar-agents/incorporate\";\n\nconst result = await incorporate({\n  denominacion: \"ACME-AI SAS\",\n  tipo: \"SOCIEDAD-IA\",\n  capitalSocial: 1,\n  objeto: \"Operación de servicios digitales y desarrollo de software propio para clientes argentinos.\",\n});\n\nif (!result.ok) {\n  for (const f of result.validation.findings) {\n    console.error(`[${f.severity}] ${f.field}: ${f.message}`);\n  }\n  process.exit(1);\n}\n\nconsole.log(\"Slug:\", result.sociedad.slug);\nconsole.log(\"Deploy:\", result.deploy.oneClickUrl);\nconsole.log(\"Audit log:\", result.audit.dashboardUrl);\n\n// Persist the four generated files\nawait Promise.all(\n  Object.entries(result.config).map(([path, content]) =>\n    Deno.writeTextFile(`./out/${path}`, content), // or fs.writeFile in Node\n  ),\n);\n```\n\n## API\n\n### `incorporate(input, options?): Promise<IncorporateResult>`\n\nReturns either:\n\n- `{ ok: true, sociedad, validation, config, envVars, checklist, deploy, audit, rfc001, generatedAt }` on success\n- `{ ok: false, validation: { findings: [...] }, rfc001 }` on validation failure (HTTP 422)\n\nThrows `IncorporateError` on network errors or unexpected HTTP statuses (5xx, 429, etc.). Validation failures are *not* exceptions — they're a normal outcome the calling agent should handle.\n\n#### Input\n\n```ts\n{\n  denominacion: string;           // 3-200 chars\n  tipo: \"SAS\" | \"SRL\" | \"SA\" | \"SOCIEDAD-IA\";\n  capitalSocial: number;          // ARS, > 0\n  objeto: string;                 // 20-2000 chars\n  representante?: { nombre: string; cuit: string };\n  emailContacto?: string;\n  piezas?: PiezaId[];             // optional subset; required pieces auto-merged\n  sessionId?: string;             // for audit-log continuity\n}\n```\n\n#### Options\n\n```ts\n{\n  baseUrl?: string;               // defaults to https://ar-agents.ar\n  fetchImpl?: typeof fetch;       // for Node 18 polyfill / instrumented fetch\n  signal?: AbortSignal;\n  headers?: Record<string, string>;\n}\n```\n\n### `incorporateOrThrow(input, options?): Promise<IncorporateSuccess>`\n\nSame as `incorporate()` but throws `IncorporateValidationError` instead of returning a failure envelope.\n\n### `describe(options?): Promise<unknown>`\n\nFetches `GET /api/auto-incorporate` — the endpoint's self-description (input schema, required piezas, RFC-001 link). Useful for capability discovery.\n\n### `fetchAudit(sessionId, options?): Promise<unknown>`\n\nFetches the audit log for a session. Pass `{ verify: true }` to also request server-side HMAC verification.\n\n## Audit log\n\nEvery incorporation request is recorded in a HMAC-SHA256-signed audit log persisted to Vercel KV (Upstash). The response includes:\n\n```ts\nresult.audit = {\n  sessionId: \"uuid\",\n  backend: \"vercel-kv\" | \"in-memory\",\n  entry: {\n    id, sessionId, ts, tool: \"auto_incorporate\", governance: \"audit-logged\",\n    input, output, hmac: \"sha256:...\"\n  },\n  url: \"https://ar-agents.ar/api/play/audit/{sessionId}\",\n  verifyUrl: \"https://ar-agents.ar/api/play/audit/{sessionId}?verify=1\",\n  dashboardUrl: \"https://ar-agents.ar/dashboard/{sessionId}\",\n};\n```\n\n`dashboardUrl` is the human-readable forensic timeline; `verifyUrl` is the JSON re-verification endpoint. RFC-001 § 9.2 covers the legal-probative-value contract.\n\n## Multi-step orchestration\n\nPass the same `sessionId` across multiple `incorporate()` + `/api/play/*` calls to chain them under a single forensic timeline:\n\n```ts\nconst sessionId = crypto.randomUUID();\n\nconst r1 = await incorporate({ ... , sessionId });\n// later\nconst r2 = await incorporate({ ... , sessionId });\n\nconst audit = await fetchAudit(sessionId, { verify: true });\n// audit.entries → all events from both calls in order\n// audit.verification.tampered → 0 if log is clean\n```\n\n## Validation rules (server-side)\n\nMirror of `@ar-agents/gde-tad`'s `validate_igj_inscription` tool:\n\n- Denominación: 3–200 chars, no IGJ-reserved words (Nacional / Estatal / Gobierno / Estado / Oficial)\n- Capital: ≥ minimum for `tipo` (SAS/SRL: 100k ARS, SA: 30M ARS, SOCIEDAD-IA: 1 ARS)\n- Objeto: 20–2000 chars, IGJ rejects generic phrasing (the 20-char floor is the conservative cutoff)\n- Representante CUIT: 11 digits if provided\n\n## Testing\n\n```bash\npnpm --filter @ar-agents/incorporate test\n```\n\nUnit tests cover every code path with mocked `fetch` — no network in CI.\n\n## License\n\nMIT © Nazareno Clemente. SLSA v1 npm provenance attestation on every release.\n","readmeFilename":"README.md"}