Skip to Content

Registry

The Loopstack Registry is a collection of npm packages (@loopstack/*) providing pre-built tools, feature modules, and example workflows.

Discovering Packages

Browse the registry at loopstack.ai/registry  to find available packages.

Installing Packages

All registry packages are installed via npm:

npm install @loopstack/<package-name>

Then import the module in your NestJS app:

import { MyFeatureModule } from '@loopstack/<package-name>'; @Module({ imports: [MyFeatureModule], }) export class AppModule {}

If the package provides workflows or tools, register them in your app:

import { Injectable } from '@nestjs/common'; import { App, InjectWorkflow, InjectTool } from '@loopstack/common'; import { MyWorkflow } from '@loopstack/<package-name>'; @Injectable() @App({ uiConfig: { title: 'My App' } }) export class MyApp { @InjectWorkflow() myWorkflow: MyWorkflow; }

See Modules & Apps for details.

Package Structure

Registry packages ship a consistent layout:

PathDescription
README.mdUsage documentation
SETUP.mdSetup instructions and required config
dist/Compiled JavaScript
src/Full TypeScript source (examples and templates only — features/tools omit it)
package.jsonPackage metadata

Inspect a package

Runtime API — install into a throwaway project and read docs in node_modules:

mkdir -p /tmp/loopstack-inspect && cd /tmp/loopstack-inspect npm init -y && npm install @loopstack/<package-name>

Implementation — use the GitHub link on the registry entry. For tools, look for @Tool({ schema }), the call() method, and ToolResult return values.

Example packages

PackagePattern
chat-example-workflow Multi-turn chat
prompt-example-workflow Single-turn prompt
prompt-structured-output-example-workflow AI structured output
tool-call-example-workflow LLM tool calling
custom-tool-example-module Custom tools with services
dynamic-routing-example-workflow Guard-based routing
workflow-state-example-workflow State management
accessing-tool-results-example-workflow Tool result access
meeting-notes-example-workflow Human-in-the-loop
run-sub-workflow-example Sub-workflows
sandbox-example-workflow Docker sandbox
secrets-example-workflow Secrets management
google-oauth-example Google OAuth
github-oauth-example GitHub OAuth
Last updated on