@minded-ai/mindedjs-types

Type-only contract of the MindedJS agent model — flows, nodes, edges, tools, playbooks, state, and the platform↔SDK socket payloads. Zero runtime dependencies (the only JavaScript this package emits is its enums).

Why

Platform-side consumers (octo backend, platform, agent-dev-server, agentOperationsService, …) only need to describe MindedJS agents, never run them. Depending on the full @minded-ai/mindedjs SDK for that pulls its entire runtime — langchain 0.3.x included — into every consumer: ~47MB of node_modules, >1,100 modules loaded at startup by a single enum import, and langchain-0.3 npm audit findings that have no upstream fix. This package is the same contract with none of that.

The MindedJS SDK is in maintenance mode, so this contract is effectively frozen.

Usage

import { Flow, NodeType, Environment, ProxyConfig } from '@minded-ai/mindedjs-types';

Deliberate structural deviations from the SDK sources (so the package stays dependency-free) are documented at the top of src/index.ts — Tool generics, State/StateMessage, PlaybookBlock, and the InterruptSession* message base.

Publishing

Frozen contract → manual publish on the rare change:

cd mindedjs-types
npm version <patch|minor>
npm publish   # prepublishOnly builds; publishConfig.access is public

If a MindedJS release ever changes the types in src/types/*, update src/index.ts here and republish as part of that release.