title: Secrets Example description: Example demonstrating two secrets flows — deterministic request/verify workflow and agentic LLM workflow using get_secret_keys, request_secrets_task tools

@loopstack/secrets-example-workflow

Demonstrates two secrets flows: a deterministic request/verify workflow and an agentic workflow where the LLM requests and validates secrets using secrets tools.

By using this example you'll get...

• SecretsExampleWorkflow for a simple request-and-verify flow
• SecretsAgentExampleWorkflow that loops with tool calling (get_secret_keys, request_secrets_task)
• UI documents showing secret requests and verification status

Installation

npm install @loopstack/secrets-example-workflow

This example depends on @loopstack/secrets-module and @loopstack/claude-module; configure secrets storage and Claude credentials before running.

Then register the module in your app:

import { StudioApp } from '@loopstack/common';
import {
  SecretsAgentExampleWorkflow,
  SecretsExampleModule,
  SecretsExampleWorkflow,
} from '@loopstack/secrets-example-workflow';

@StudioApp({
  title: 'Secrets Example',
  workflows: [SecretsExampleWorkflow, SecretsAgentExampleWorkflow],
})
@Module({
  imports: [SecretsExampleModule],
})
export class MyAppModule {}

How It Works

Deterministic flow (SecretsExampleWorkflow)

1. Calls RequestSecretsTool and saves a SecretRequestDocument.
2. Waits for user-provided secrets.
3. Calls GetSecretKeysTool to read key availability.
4. Renders verification output via MarkdownDocument.

Agentic flow (SecretsAgentExampleWorkflow)

1. Seeds hidden/system context for the LLM.
2. Runs LLM turns with Claude and allowed secrets tools.
3. Delegates tool calls and merges callback results.
4. Loops until end-turn, while supporting follow-up user messages.

Public API

• SecretsExampleModule
• SecretsExampleWorkflow
• SecretsAgentExampleWorkflow

Dependencies

• @loopstack/common
• @loopstack/secrets-module
• @loopstack/llm-provider-module
• @loopstack/claude-module