Integration references and maintenance tools
Back to development handbook · Manual maintenance · Shared flow
This kit provides new project initialization, integration references for existing projects, copy-and-run offline code, and knowledge maintenance tools.
Integration code references
For the overall flow and call timing see How the mechanism works; the knowledge answering diagram there is an illustration of an App composing local Kit contracts.
| Reference | What it offers an existing project |
|---|---|
| Offline complete service answering | The same contract in TS/JS, from single node to tools, models, and process observation; no credentials needed |
| Basic model and tool calls | Named calls, static tool catalogs, real authorization and execution, Provider stream boundaries |
| Core API | Executor, model, tool, and cancellation/budget contracts |
| Support Context | Assembling existing knowledge and profiles into model input |
| Knowledge API | Text parsing, section reading, and snapshots |
| Knowledge answering contract | Connecting reading, generation, checks, and output through local Kit interfaces |
The above are module call references; they do not create project directories, install dependencies, or start applications. Actual side effects are still carried by the existing project's ports.
Maintenance tools
The following paths are relative to the installed package's development/. Scripts require Node 22+ and a resolvable Core build.
| Entry | Input | Output and side effects |
|---|---|---|
skills/agent-core-app/scripts/validate-knowledge.mjs PROJECT | Existing project knowledge manifest, sources, and required read references | Check results; does not modify files |
skills/agent-core-app/scripts/prepare-source.mjs PROJECT --source UTF8_FILE --id DOCUMENT_ID | Existing project, explicitly provided source, and stable document id | Source awaiting review and a proposal; does not overwrite effective knowledge or configuration |
skills/agent-core-app/scripts/plan.mjs PROJECT [--source UTF8_FILE] | Existing project, optional source path | Agent development plan; see the Skill for specific behavior |
skills/agent-core-app/scripts/create-app.mjs TARGET [--write] | Empty target directory, name and purpose, optional real source | Read-only plan by default; explicitly creates a TypeScript/Node project and unpublished source candidates |
skills/agent-core-app/scripts/create-app.mjs TARGET --check | Generation receipt, current managed files, and the selected template | Read-only diff report; does not overwrite user modifications |
Knowledge maintenance tools work from configuration explicitly provided by the project and do not scan or execute project code. For initialization and diff checks see Create an App. For knowledge format, flow, and publication responsibility see the Maintenance guide. Failures exit with a non-zero code and an error report; invalid UTF-8, budget, or section errors cannot be bypassed by relaxing validation.
The tools do not replace document review, resource authorization, database write-back, or publication, and they do not by default take on PDF/OCR, web crawling, or arbitrary material ingestion.