cortico
v0.1.6
Published
A TypeScript framework for event-driven, long-running persona bots
Maintainers
Readme
cortico
Framework sources for Cortico, published so that an
extension package resolves cortico/* while it is being written.
An extension supplies one World, one provider or one bot, and imports the framework by its path
under src/:
import type { WorldDefinition } from 'cortico/world.ts';
import type { EventEnvelope, WorldHost } from 'cortico/core/types.ts';Inside a running instance those specifiers are resolved by the host's module hook to the framework that instance runs. This package supplies the same files to the editor, the type checker and the test runner. It has no entry point and starts nothing.
Install
pnpm add -D corticoEach extension kind has its own contract version — world 5, provider 5, bot 5 — and a package
declares its own as "cortico": { "kind": "world", "api": 5 } in its package.json. This
package's minor version tracks the framework, so pin the range your extension was written against.
templates/extension/ in the repository holds a ready package for each kind, and
docs/extensions.md states
the packaging rules.
Running a bot
Deployments, bot packages and the web console live in a checkout of the repository, which is where a bot runs from: Quick Start.
MIT licensed.
