Skip to content
ActiveInferenceInstitutePublic

About

Typed TypeScript runtime for coordinating executable agents with durable task state, explicit LLM providers, and observable lifecycle behavior, exposed via an HTTP task API.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

2 watching

Forks

Latest commit

 

History

70 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NoOrg

NoOrg is a typed TypeScript runtime for coordinating executable agents with durable task state, explicit language-model providers, and observable lifecycle behavior. It is developed and maintained by the Active Inference Institute.

Status

NoOrg is an active research runtime at working-copy maturity. The default development profile runs fully offline against the deterministic local provider; the OpenAI provider and the live test suite require an OPENAI_API_KEY. Container deployment uses the committed Dockerfile and docker-compose.yml. External agent modules require explicit trust configuration.

Contents

Requirements

  • Node.js 22 or newer
  • npm
  • An OpenAI API key only when using the explicit openai provider

Quick start

npm install
cp .env.example .env
npm run validate
node --env-file=.env --import tsx src/index.ts

Configuration reads process.env: a cwd .env is not loaded automatically by npm start or npm run start:dev. Node's explicit --env-file loads it, and inherited environment values take precedence. After a separately verified build, the corresponding launch is node --env-file=.env dist/index.js.

Keep NOORG_LLM_PROVIDER explicit. The local development profile needs no model credentials; OPENAI_API_KEY is required only for openai. Production also requires NOORG_HTTP_AUTH_TOKEN. Blank optional key/base URL/host/auth/budget values mean absent, not an implicit provider or permission to omit production authentication. Nonempty invalid values still fail validation.

Runtime surface

  • GET /health reports process health.
  • GET /ready reports coordinator readiness.
  • GET /metrics exposes runtime counters when metrics are enabled.
  • POST /v1/tasks, GET /v1/tasks, GET /v1/tasks/:id, and POST /v1/tasks/:id/cancel expose the authenticated task API.
  • The generated OpenAPI contract is checked against the implemented routes.
  • Coordinator.submitTask() queues a typed task for a registered executable agent.
  • Optional agent modules are explicitly configured with NOORG_AGENT_MODULES; organizational Markdown is available only through the opt-in UnitCorpus adapter and its reviewed manifest.
  • External agent modules require NOORG_AGENT_MODULE_TRUSTED_SHA256 provenance allowlisting.

Example

npm run example

The example uses the local provider, executes a real analysis agent, and prints the completed task result.

Architecture

The composition root creates configuration, state, provider, event bus, metrics, registry, agents, coordinator, and HTTP server. Dependencies are injected into each component, and shutdown disposes them in reverse order.

HTTP or library caller
        |
    Coordinator
     /       \
Task store   Agent registry
                 |
             Agent.execute
                 |
          Local or OpenAI provider

See the documentation index, architecture, configuration, operations, and testing. The reproducible manuscript documents the executable contracts, task semantics, and claim boundaries.

Development commands

./run.sh is the single gate entry point; every arm is defined once and CI runs the same arms. ./run.sh --list prints the authoritative table, and the validation gate documents each arm.

./run.sh            # fast arm: types, lint, format, unit tests, docs
./run.sh all        # ordinary gate (the same set as npm run validate)
./run.sh test:full  # one arm; ./run.sh --list shows them all
./run.sh manuscript # evidence, figures, hydration, render check
./run.sh report     # refresh docs/_generated/gate-timings.md
npm run release:check

Underlying npm scripts remain available for single steps and for tools that call them directly (npm run type-check, npm run lint, npm test, npm run validate:*, npm run units:manifest:*, npm run api:openapi:*, npm run build, npm run manuscript:*).

Generated files belong in ignored build, coverage, runtime-data, log, and docs/manuscript/output/ directories. The repository stores source, tests, configuration, manuscript source, documentation, and domain unit content.

Use npm run release:check before publishing or pushing release work. It composes the local validation gate, executable example, dependency audit, manuscript rendering and inspection, and whitespace checks. Use npm run clean only for generated build, coverage, and manuscript-output directories; runtime state under data/ is not deleted by the cleanup command.

Project guides

Each maintained directory carries a local guide:

  • docs/ — documentation index, with per-topic and manuscript pages.
  • src/ — source modules and runtime conventions.
  • tests/ — unit, integration, and live suites.
  • scripts/ — repository validation and generation gates.
  • units/ — reviewed organizational corpus and its integrity manifest.
  • examples/ — the runnable executable example.

License

NoOrg is published under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. See Contributing, Security, and the Code of Conduct for collaboration guidelines. To cite this repository, use the CITATION.cff metadata.

InstituteOS sidecar

This repository carries a committed .aii/ sidecar with curated InstituteOS metadata (aii-sidecar/v1): category, maturity, ecosystem relations, key artifacts, provenance, and portable tasks. It is read by InstituteOS tooling and does not affect the project's build or runtime.

About

Typed TypeScript runtime for coordinating executable agents with durable task state, explicit LLM providers, and observable lifecycle behavior, exposed via an HTTP task API.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages