@loopstack/hitl-examples 0.1.1

package/src/workflows/meeting-notes/meeting-notes-example.workflow.ts

@@ -0,0 +1,75 @@
+import { join } from 'node:path';
+import { z } from 'zod';
+import { BaseWorkflow, Transition, Workflow } from '@loopstack/common';
+import type { RunContext, TransitionInput } from '@loopstack/common';
+import { LlmGenerateObjectTool } from '@loopstack/llm-provider-module';
+import { MeetingNotesDocument, MeetingNotesDocumentSchema } from './documents/meeting-notes-document';
+import { OptimizedMeetingNotesDocumentSchema, OptimizedNotesDocument } from './documents/optimized-notes-document';
+
+interface MeetingNotesState {
+  meetingNotes?: z.infer<typeof MeetingNotesDocumentSchema>;
+  optimizedNotes?: z.infer<typeof OptimizedMeetingNotesDocumentSchema>;
+}
+
+const MeetingNotesArgsSchema = z.object({
+  inputText: z
+    .string()
+    .default(
+      '- meeting 1.1.2025\n- budget: need 2 cut costs sarah said\n- hire new person?? --> marketing\n- vendor pricing - follow up needed by anna',
+    ),
+});
+
+type MeetingNotesArgs = z.infer<typeof MeetingNotesArgsSchema>;
+
+@Workflow({
+  title: 'HITL - Meeting Notes Example',
+  description: 'A demo workflow showing how to use AI to structure meeting notes, with HITL review steps.',
+  schema: MeetingNotesArgsSchema,
+})
+export class MeetingNotesExampleWorkflow extends BaseWorkflow<MeetingNotesArgs> {
+  constructor(private readonly llmGenerateObject: LlmGenerateObjectTool) {
+    super();
+  }
+
+  @Transition({ to: 'waiting_for_response' })
+  async createForm(state: MeetingNotesState, ctx: RunContext<MeetingNotesArgs>) {
+    await this.documentStore.save(
+      MeetingNotesDocument,
+      { text: `Unstructured Notes:\n\n${ctx.args.inputText}` },
+      { key: 'input' },
+    );
+  }
+
+  @Transition({ from: 'waiting_for_response', to: 'response_received', wait: true, schema: MeetingNotesDocumentSchema })
+  async userResponse(state: MeetingNotesState, input: TransitionInput<z.infer<typeof MeetingNotesDocumentSchema>>) {
+    const result = await this.documentStore.save(MeetingNotesDocument, input.data, { key: 'input' });
+    this.assignState({ meetingNotes: result.content as z.infer<typeof MeetingNotesDocumentSchema> });
+  }
+
+  @Transition({ from: 'response_received', to: 'notes_optimized' })
+  async optimizeNotes(state: MeetingNotesState) {
+    const result = await this.llmGenerateObject.call(
+      {
+        outputSchema: OptimizedMeetingNotesDocumentSchema,
+        prompt: this.render(join(__dirname, 'templates', 'extract-notes.md'), {
+          text: state.meetingNotes?.text,
+        }),
+      },
+      { config: { provider: 'claude', model: 'claude-sonnet-4-6' } },
+    );
+
+    await this.documentStore.save(
+      OptimizedNotesDocument,
+      result.data.data as z.infer<typeof OptimizedMeetingNotesDocumentSchema>,
+      { key: 'final' },
+    );
+  }
+
+  @Transition({ from: 'notes_optimized', to: 'end', wait: true, schema: OptimizedMeetingNotesDocumentSchema })
+  async confirm(state: MeetingNotesState, input: TransitionInput<z.infer<typeof OptimizedMeetingNotesDocumentSchema>>) {
+    const result = await this.documentStore.save(OptimizedNotesDocument, input.data, { key: 'final' });
+    this.setResult({
+      optimizedNotes: result.content as z.infer<typeof OptimizedMeetingNotesDocumentSchema>,
+    } as unknown as Record<string, unknown>);
+  }
+}

package/src/workflows/meeting-notes/templates/extract-notes.md

@@ -0,0 +1,5 @@
+Extract all information from the provided meeting notes into the structured document.
+
+<Meeting Notes>
+{{text}}
+</Meeting Notes>

package/src/workflows/prompt-input-chat/prompt-input-chat-example.workflow.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { BaseWorkflow, MessageDocument, Transition, Workflow } from '@loopstack/common';
+import type { TransitionInput } from '@loopstack/common';
+
+@Workflow({
+  title: 'HITL - Prompt Input Chat Example',
+  description:
+    'Predefined-workflow HITL via the prompt-input widget. The workflow loops: it waits for a user ' +
+    'message, echoes back a reply, and re-enters the waiting state. No LLM and no sub-workflow involved.',
+  widget: './prompt-input-chat-example.workflow.yaml',
+})
+export class PromptInputChatExampleWorkflow extends BaseWorkflow {
+  @Transition({ to: 'waiting_for_user' })
+  async greet(_state: Record<string, unknown>) {
+    await this.documentStore.save(MessageDocument, {
+      role: 'assistant',
+      text: 'Hi! Send me a message and I will echo it back.',
+    });
+  }
+
+  @Transition({ from: 'waiting_for_user', to: 'reply_sent', wait: true, schema: z.string() })
+  async userMessage(state: Record<string, unknown>, input: TransitionInput<string>) {
+    const payload = input.data;
+    await this.documentStore.save(MessageDocument, { role: 'user', text: payload });
+    await this.documentStore.save(MessageDocument, { role: 'assistant', text: `You said: ${payload}` });
+  }
+
+  @Transition({ from: 'reply_sent', to: 'waiting_for_user' })
+  loop(_state: Record<string, unknown>) {}
+}

package/src/workflows/prompt-input-chat/prompt-input-chat-example.workflow.yaml

@@ -0,0 +1,6 @@
+widget: prompt-input
+enabledWhen:
+  - waiting_for_user
+options:
+  transition: userMessage
+  label: Send