@aionis/manifest

Portable executable manifest runtime for agent and workflow systems.

AionisManifest is the extracted core of the old Aionis Doc workflow surface. It is not a docs site and it does not depend on the Aionis runtime server. The core package can parse, compile, validate, and run .aionis.manifest.md or legacy .aionis.md files through a local module registry.

Boundary

Core standalone features:

1. parse manifest Markdown into AST and IR
2. compile IR into execution_plan_v1
3. validate module manifests and registries
4. run execution plans through file or npm module registries
5. emit outputs, artifacts, evidence, node results, and diagnostics

Optional Aionis backend features:

1. build runtime handoff payloads
2. build handoff store requests
3. publish, recover, and resume through compatible Aionis HTTP endpoints

The execution plan still exposes compatibility fields such as doc_id and source_doc_id because focused Aionis handoff routes already understand that wire shape. New source files should use @manifest; legacy @doc remains accepted.

Install

npm i @aionis/manifest

For local focused-runtime development:

git clone https://github.com/ostinatocc/AionisManifest.git
npm i ./AionisManifest

Manifest Syntax

@manifest {
  id: "workflow-001"
  version: "1.0"
  kind: "workflow"
}

@context {
  product: "AionisManifest"
  objective: "Explain standalone execution"
}

@execute {
  module: "research.claims.v1"
  input_ref: "ctx"
  output_ref: "run.claims"
}

@execute {
  module: "copy.summary.v1"
  input_ref: "run.claims"
  output_ref: "out.summary"
  depends_on: ["run.claims"]
}

@replay {
  executable: true
  mode: "deterministic"
  expected_outputs: ["out.summary"]
}

CLI

compile-aionis-manifest ./workflow.aionis.manifest.md --emit all
run-aionis-manifest ./workflow.aionis.manifest.md --registry ./module-registry.json
validate-aionis-manifest-registry ./module-registry.json
validate-aionis-manifest-module ./modules/copy-summary.mjs --declared-module copy.summary.v1
execute-aionis-manifest ./workflow.aionis.manifest.md
build-aionis-manifest-runtime-handoff ./workflow.aionis.manifest.md --scope default
build-aionis-manifest-handoff-store-request ./runtime-handoff.json --scope default
publish-aionis-manifest-handoff ./workflow.aionis.manifest.md --base-url http://127.0.0.1:3101
recover-aionis-manifest-handoff ./workflow.aionis.manifest.md --base-url http://127.0.0.1:3101
resume-aionis-manifest-runtime ./recover-result.json --input-kind recover-result --candidate read --candidate bash

resume-aionis-manifest-runtime uses the public Aionis product loop. It sends recovered continuity and tool candidates to /v1/guide; when feedback is provided, it attributes the outcome to the guide's persisted tool-selection receipt through /v1/feedback. It does not depend on internal Runtime memory or tool routes.

Package Usage

import {
  compileAionisManifest,
  runAionisManifest,
  StaticModuleRegistry,
  ModuleRegistryExecutionRuntime,
} from "@aionis/manifest";

const compile = compileAionisManifest(sourceText);

const result = await runAionisManifest({
  inputPath: "./workflow.aionis.manifest.md",
  registryPath: "./module-registry.json",
});

const runtime = new ModuleRegistryExecutionRuntime({
  runtime_id: "custom_runtime_v1",
  registry: new StaticModuleRegistry([
    {
      manifest: {
        module: "custom.echo.v1",
        version: "1.0.0",
        deterministic: true,
        required_capabilities: ["direct_execution"],
      },
      handler: (input) => input,
    },
  ]),
});

compileAionisDoc is exported as a migration alias for older callers, but new code should use compileAionisManifest.

Module Registry

Stable local file registry:

{
  "version": "aionis_manifest_module_registry_v1",
  "modules": [
    {
      "module": "research.claims.v1",
      "entry": "./modules/research-claims.mjs"
    }
  ]
}

Experimental npm-installed registry:

{
  "version": "aionis_manifest_npm_module_registry_v1",
  "modules": [
    {
      "module": "research.claims.v1",
      "package": "@aionis/manifest-module-research-claims"
    }
  ]
}

Included official module prototypes:

1. @aionis/manifest-module-research-claims
2. @aionis/manifest-module-copy-summary
3. @aionis/manifest-module-json-transform

Verify

npm install
npm run verify
node dist/run-cli.js fixtures/standalone-runner.aionis.md --registry fixtures/standalone-module-registry.json --compact