{"_id":"@agent-ix/spec-objects-architecture","_rev":"3-fb417ce5f1cd022dd980ea1230cbe347","name":"@agent-ix/spec-objects-architecture","dist-tags":{"latest":"0.6.0"},"versions":{"0.5.0":{"name":"@agent-ix/spec-objects-architecture","version":"0.5.0","keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"license":"MIT","_id":"@agent-ix/spec-objects-architecture@0.5.0","maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"homepage":"https://github.com/agent-ix/spec-objects-architecture#readme","bugs":{"url":"https://github.com/agent-ix/spec-objects-architecture/issues"},"dist":{"shasum":"7820a9a9e44605117ae27c7e1ff966650c81ebea","tarball":"https://registry.npmjs.org/@agent-ix/spec-objects-architecture/-/spec-objects-architecture-0.5.0.tgz","fileCount":14,"integrity":"sha512-SBaZ/T/RUk/BVgQSesBlRlmXOEh48LmX+BKUkdHB+USrPX4fiu/a1YhRDv3Qd6EmWNvfvSZGXFE4FliT1gD2AA==","signatures":[{"sig":"MEUCIQCivxtFMaTc2ac1ZBPTYZKn2b0yhGGewbAtKYWZG6m3mQIgKYHtRRU9pJ+n2MoObuLEA3GoZLJUWTHNbOs4gfbA0Ag=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68801},"gitHead":"4c8e0349678b0166fabe8dcad8e8ed92139a4395","scripts":{"prepack":"node scripts/stage-npm.mjs"},"_npmUser":{"name":"agent-ix","email":"peter@agent-ix.ai"},"repository":{"url":"git+https://github.com/agent-ix/spec-objects-architecture.git","type":"git"},"_npmVersion":"10.9.8","description":"Filament Module: tier-2 architecture ObjectTypes (api_endpoint, ui_component, data_schema, action, queue, integration, dto, middleware)","directories":{},"_nodeVersion":"22.23.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/spec-objects-architecture_0.5.0_1782529023035_0.22393085510876776","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@agent-ix/spec-objects-architecture","version":"0.5.1","keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"license":"AGPL-3.0-or-later","_id":"@agent-ix/spec-objects-architecture@0.5.1","maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"homepage":"https://github.com/agent-ix/spec-objects-architecture#readme","bugs":{"url":"https://github.com/agent-ix/spec-objects-architecture/issues"},"dist":{"shasum":"d5b26c58088e84a027a60565cdef4b06e338f204","tarball":"https://registry.npmjs.org/@agent-ix/spec-objects-architecture/-/spec-objects-architecture-0.5.1.tgz","fileCount":14,"integrity":"sha512-BHs1R4xX0chTBmmxbQFyRW0T4fU/CrdC+ultw5CkrpLRTxmgRTRlOdgh7+jTk+VknViBXeYm5G+LqDzgefQ9zQ==","signatures":[{"sig":"MEUCIHdBbSgZAbA/Y4DPEgS2mnAd+p9tLxpdiu83sHVrqUsAAiEA7nHUFxHeA1Bk1R/C9EYFlJnIwHJnfzpqc3aZEByUa7E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68815},"gitHead":"ecb57405ebbf720b283fab0caa37eb4f3e90ae46","scripts":{"prepack":"node scripts/stage-npm.mjs"},"_npmUser":{"name":"agent-ix","email":"peter@agent-ix.ai"},"repository":{"url":"git+https://github.com/agent-ix/spec-objects-architecture.git","type":"git"},"_npmVersion":"10.9.8","description":"Filament Module: tier-2 architecture ObjectTypes (api_endpoint, ui_component, data_schema, action, queue, integration, dto, middleware)","directories":{},"_nodeVersion":"22.23.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/spec-objects-architecture_0.5.1_1782538119112_0.18510672565165853","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@agent-ix/spec-objects-architecture","version":"0.6.0","description":"Filament Module: tier-2 architecture ObjectTypes (api_endpoint, ui_component, data_schema, action, queue, integration, dto, middleware)","license":"AGPL-3.0-or-later","author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"scripts":{"prepack":"node scripts/stage-npm.mjs"},"publishConfig":{"registry":"https://registry.npmjs.org/","access":"public"},"repository":{"type":"git","url":"git+https://github.com/agent-ix/spec-objects-architecture.git"},"gitHead":"0093e9c108541ecfcad454202f0231ff6c27c9ca","_id":"@agent-ix/spec-objects-architecture@0.6.0","bugs":{"url":"https://github.com/agent-ix/spec-objects-architecture/issues"},"homepage":"https://github.com/agent-ix/spec-objects-architecture#readme","_nodeVersion":"22.23.1","_npmVersion":"12.0.2","dist":{"integrity":"sha512-RDdiIlMFImig7qU2EnlP6OLb/ELaEzzR0aB4IK3U32SCRd2ZvHP2lRo27EAeMD6rWFiUk42FaCaV5BHTZ9BbEQ==","shasum":"f32807ffb27867d5ae8c8f8ec85eba5c4c2befa9","tarball":"https://registry.npmjs.org/@agent-ix/spec-objects-architecture/-/spec-objects-architecture-0.6.0.tgz","fileCount":14,"unpackedSize":68815,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDY3DF8JKBzyppJ5wl6GuTL8htxj+S7OqTmaF+udb7iYAIgNs26AWZ6MRV8JUQfLTkZGSVJs5/6iEvclsRDWb9V0rc="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9c721a61-637b-4083-a1c1-209b954b8a4f"}},"directories":{},"maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/spec-objects-architecture_0.6.0_1786207963495_0.3594714409313804"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-27T02:57:02.839Z","modified":"2026-08-08T16:52:43.781Z","0.5.0":"2026-06-27T02:57:03.170Z","0.5.1":"2026-06-27T05:28:39.248Z","0.6.0":"2026-08-08T16:52:43.643Z"},"bugs":{"url":"https://github.com/agent-ix/spec-objects-architecture/issues"},"author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"license":"AGPL-3.0-or-later","homepage":"https://github.com/agent-ix/spec-objects-architecture#readme","keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"repository":{"type":"git","url":"git+https://github.com/agent-ix/spec-objects-architecture.git"},"description":"Filament Module: tier-2 architecture ObjectTypes (api_endpoint, ui_component, data_schema, action, queue, integration, dto, middleware)","maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"readme":"# spec-objects-architecture\n\n> Filament Module: tier-2 architecture ObjectTypes (api_endpoint, data_schema, queue, action, ui_component, rate_limit, interface, external_contract, extension_point, binary_format)\n\nThis is an Agent-IX Filament module loaded by [`quire-cli`](https://github.com/agent-ix/quire-cli) and [`quoin`](https://github.com/agent-ix/quoin). It provides tier-2 embedded `object_types` — a `manifest.yaml` plus per-kind authoring `skeletons/` used to author and validate Markdown spec artifacts.\n\n## Installing quire-cli\n\n`@agent-ix` packages are published to public npm. Install the CLI globally:\n\n```bash\nnpm install -g @agent-ix/quire-cli\n```\n\nSee https://github.com/agent-ix/quire-cli#install for details.\n\n## Install this module via npm\n\nThis module is also published as a config-only npm package: `@agent-ix/spec-objects-architecture`.\nThe package root **is** the Filament module (`manifest.yaml` + schemas/skeletons),\nso it works directly as a `--module` target or via quoin's `package:` source.\n\n```bash\nnpm install @agent-ix/spec-objects-architecture\n```\n\n```bash\n# quoin — resolve the module from npm by name\nquoin plugin install package:@agent-ix/spec-objects-architecture\n\n# or point any tool at the installed package root\nquire validate spec/**/*.md --module node_modules/@agent-ix/spec-objects-architecture\n```\n\n## Object types provided\n\n| Object | `type:` | Description |\n|:-------|:--------|:------------|\n| API endpoint | `api_endpoint` | An HTTP endpoint surface: a required `Endpoint` section describing what it does plus its method/path routes, and an optional `2. API Contract` section for request/response/auth detail. |\n| Data schema | `data_schema` | A JSON-shaped record defined by a required `Schema` section holding a JSON Schema (draft 2020-12) code block. |\n| Queue | `queue` | A message queue defined by a required `Message Format` section holding an example JSON message payload (or its schema). |\n| Action | `action` | A discrete action/task defined by a required `Inputs` section listing every input it consumes, with type and source. |\n| UI component | `ui_component` | A frontend component defined by a required `Props` section enumerating every prop with name, type, and behavior. |\n| Rate limit | `rate_limit` | A throttling policy defined by a required `Thresholds` section listing the concrete limits, windows, and the response when a limit is exceeded. |\n| Interface | `interface` | A language-neutral operations contract *within* the system, defined by a required `Contract` section holding a YAML code block (name, types, operations, invariants). |\n| External contract | `external_contract` | A contract with a system *outside* this one, with a required `Contract` section plus optional `Endpoints` and `Behavior` sections for the consumed/exposed surface and interaction semantics. |\n| Extension point | `extension_point` | First-class pluggability: a required `Contract` section naming the interface it exposes, plus optional `Registration` and `Stability` sections for discovery and compatibility guarantees. |\n| Binary format | `binary_format` | A persisted binary layout defined by a required `Layout` section holding a YAML code block of record types with per-field name/offset/size/type/endianness. |\n\n## How this module is used\n\n### With quoin (recommended)\n\nInstall this module as a plugin, then author and review spec artifacts:\n\n```bash\nquoin plugin install path:../spec-objects-architecture\nquoin catalog list\nquoin write . --types api_endpoint,data_schema\nquoin review\n```\n\nSee [quoin](https://github.com/agent-ix/quoin) for details.\n\n### With quire-cli directly\n\nPoint `quire` at this module's package directory to fetch a skeleton, validate documents, or extract a document's structured body:\n\n```bash\nquire schema api_endpoint --module ./spec_objects_architecture\nquire validate spec/**/*.md --module ./spec_objects_architecture\nquire extract spec/upload-artifact.md --module ./spec_objects_architecture\n```\n\nSee [quire-cli#usage-instructions](https://github.com/agent-ix/quire-cli#usage-instructions) for details.\n\n## Development\n\n- **Library name:** `spec_objects_architecture` (flat layout, package at repo root)\n- **Language / tooling:** Python 3.13+, [Poetry](https://python-poetry.org/), GitHub Actions CI\n- **Versioning:** dynamic, Git-tag-based\n- **Publishing:** Google Artifact Registry (PyPI-compatible) via `twine upload -r internal-pypi` in CI on `tag v*.*.*`\n\nCommon Makefile targets:\n\n| Target | Description |\n|:-------|:------------|\n| `install` | Install dependencies in Poetry venv |\n| `test` | Run tests (pytest) |\n| `lint` | Run linting (Ruff + Black check) |\n| `format` | Auto-format code (Ruff + Black) |\n| `build` | Build wheel and sdist under `dist/` |\n| `update-lock` | Update `poetry.lock` |\n| `update-packages` | Update all dependencies |\n| `add-package p=<name>` | Add a runtime dependency |\n| `add-dev-package p=<name>` | Add a dev dependency |\n| `use-local p=<name>` | Switch a dep to local `pypi.ix` |\n| `use-upstream p=<name>` | Switch a dep back to upstream |\n| `local-publish` | Build and publish to local PyPI (`pypi.ix`) |\n","readmeFilename":"README.md"}