@modular-prompt/process 0.1.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 otolab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+# @modular-prompt/process
+
+プロンプトモジュールとワークフローを提供するパッケージ。
+
+## インストール
+
+```bash
+npm install @modular-prompt/process
+```
+
+## ワークフロー
+
+### チャンク処理ワークフロー
+
+- **`streamProcess`** - ステートを保持しながらチャンクを逐次処理
+- **`concatProcess`** - 各チャンクを独立して処理し、結果を結合
+
+### エージェント型ワークフロー
+
+- **`agenticProcess`** - 自律的な複数ステップ処理（計画→実行→統合）
+- **`agentProcess`** - シンプルな計画→実行→統合ワークフロー
+
+## モジュール
+
+- **`streamProcessing`** - チャンク単位の逐次処理と状態管理
+- **`withMaterials`** - 資料をプロンプトに含める
+- **`dialogueモジュール群`** - 対話処理用モジュール
+- **`summarizeモジュール群`** - 要約処理用モジュール
+- **`agenticモジュール群`** - エージェント型ワークフロー用モジュール
+
+## 使用例
+
+### チャンク処理
+
+```typescript
+import { streamProcess } from '@modular-prompt/process';
+import { streamProcessing } from '@modular-prompt/process';
+import { TestDriver } from '@modular-prompt/driver';
+
+const driver = new TestDriver(['response1', 'response2']);
+
+const result = await streamProcess(
+  driver,
+  streamProcessing,
+  {
+    chunks: [{ content: 'text1' }, { content: 'text2' }],
+    state: { content: '', usage: 0 }
+  },
+  { tokenLimit: 1000 }
+);
+```
+
+### エージェント型ワークフロー
+
+```typescript
+import { agenticProcess } from '@modular-prompt/process';
+import { AnthropicDriver } from '@modular-prompt/driver';
+
+const driver = new AnthropicDriver({
+  apiKey: process.env.ANTHROPIC_API_KEY,
+  model: 'claude-3-5-sonnet-20241022'
+});
+
+// ユーザー定義のプロンプトモジュール
+const userModule = {
+  objective: ['今日の夕飯の献立を決定する'],
+  instructions: [
+    '- 冷蔵庫の材料から作れる主菜候補を検討する',
+    '- 過去の献立と比較し、似たものが続かないようにする',
+    '- 選んだ主菜に合う副菜を提案する',
+    '- 不足している材料があれば買い出しリストを作成する'
+  ]
+};
+
+// コンテキスト（初期データ）
+const context = {
+  objective: '今日の夕飯の献立を決定する',
+  inputs: {
+    refrigerator: {
+      proteins: ['鶏もも肉 300g', '豚バラ肉 200g', '卵 6個'],
+      vegetables: ['キャベツ', '人参', '玉ねぎ', 'じゃがいも']
+    },
+    pastMeals: [
+      { date: '昨日', mainDish: 'カレーライス' },
+      { date: '一昨日', mainDish: '生姜焼き' }
+    ]
+  }
+};
+
+// ワークフロー実行（計画→実行→統合）
+const result = await agenticProcess(driver, userModule, context, {
+  maxSteps: 5  // 最大5ステップまで
+});
+
+console.log(result.output);  // 最終的な献立提案
+console.log(result.metadata); // { planSteps: 5, executedSteps: 5, actionsUsed: 0 }
+```
+
+### 簡易エージェントワークフロー
+
+```typescript
+import { agentProcess } from '@modular-prompt/process';
+import { TestDriver } from '@modular-prompt/driver';
+
+const driver = new TestDriver();
+
+const userModule = {
+  objective: ['週末旅行プランを提案する'],
+  instructions: [
+    '- 交通手段・宿泊先・食事プランを検討する',
+    '- 入力データに応じて実行計画を自律的に組み立てる'
+  ]
+};
+
+const context = {
+  objective: '週末旅行プランを提案する',
+  inputs: {
+    budget: '50,000円',
+    city: '箱根'
+  }
+};
+
+const actions = {
+  lookupHotel: async (params: { city: string }) => {
+    return { recommended: [`${params.city} 温泉旅館`] };
+  }
+};
+
+const result = await agentProcess(driver, userModule, context, {
+  maxSteps: 4,
+  actions
+});
+
+console.log(result.output);
+console.log(result.metadata); // { planSteps: 3, executedSteps: 3, actionsUsed: 1 }
+```
+
+### アクション（外部ツール）の使用
+
+```typescript
+import { agenticProcess } from '@modular-prompt/process';
+
+// 外部ツール/APIの定義
+const actions = {
+  fetchWeather: async (params: { location: string }) => {
+    const response = await fetch(`https://api.weather.com/${params.location}`);
+    return response.json();
+  },
+  searchRecipes: async (params: { ingredients: string[] }) => {
+    // レシピ検索APIを呼び出し
+    return { recipes: [...] };
+  }
+};
+
+const result = await agenticProcess(driver, userModule, context, {
+  maxSteps: 5,
+  actions  // アクションを渡す
+});
+
+// AIが計画フェーズで必要なアクションを判断し、実行フェーズで自動的に呼び出す
+```
+
+
+## ライセンス
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './modules/index.js';
+export * from './workflows/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Re-export modules
+export * from './modules/index.js';
+// Re-export workflows
+export * from './workflows/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,cAAc,oBAAoB,CAAC;AAEnC,sBAAsB;AACtB,cAAc,sBAAsB,CAAC"}

package/dist/modules/dialogue.d.ts

@@ -0,0 +1,39 @@
+import type { PromptModule } from '@modular-prompt/core';
+/**
+ * Context for dialogue modules
+ */
+export interface DialogueContext {
+    messages?: Array<{
+        content: string;
+        role: 'system' | 'assistant' | 'user';
+        name?: string;
+    }>;
+    state?: {
+        content: string;
+        usage?: number;
+    };
+    preparationNote?: {
+        content: string;
+    };
+    range?: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * Base dialogue module - defines dialogue environment and basic conversation rules
+ */
+export declare const dialogueBase: PromptModule<DialogueContext>;
+/**
+ * First pass of two-pass response - creates Response Preparation Notes
+ */
+export declare const firstOfTwoPassResponse: PromptModule<DialogueContext>;
+/**
+ * Second pass of two-pass response - creates the Response Statement
+ */
+export declare const secondOfTwoPassResponse: PromptModule<DialogueContext>;
+/**
+ * Module for maintaining conversation state
+ */
+export declare const withTalkState: PromptModule<DialogueContext>;
+//# sourceMappingURL=dialogue.d.ts.map

package/dist/modules/dialogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue.d.ts","sourceRoot":"","sources":["../../src/modules/dialogue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAqC,MAAM,sBAAsB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;QACtC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,eAAe,CAAC,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,eAAe,CA0BtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,eAAe,CAkChE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,eAAe,CAwBjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,eAAe,CAcvD,CAAC"}

package/dist/modules/dialogue.js

@@ -0,0 +1,106 @@
+/**
+ * Base dialogue module - defines dialogue environment and basic conversation rules
+ */
+export const dialogueBase = {
+    objective: [
+        'You are the main assistant of the dialogue system, and your name is Nano.'
+    ],
+    terms: [
+        'Dialogue Environment: The environment in which the user and the assistants are interacting, as defined by the current prompt, including the Dialogue Theme, the set of materials, and a history or summary of the conversation.',
+        'Messages: These are the logs of messages from the user, assistant, and system. They are arranged in chronological order, with the most recent message at the end. The entire exchange of messages forms one context.'
+    ],
+    messages: [
+        (context) => {
+            if (!context.messages)
+                return null;
+            const messages = context.range
+                ? context.messages.slice(context.range.start, context.range.end)
+                : context.messages;
+            return messages.map(msg => ({
+                type: 'message',
+                content: msg.content,
+                role: msg.role,
+                name: msg.name
+            }));
+        }
+    ]
+};
+/**
+ * First pass of two-pass response - creates Response Preparation Notes
+ */
+export const firstOfTwoPassResponse = {
+    objective: [
+        "Assistant's task is to create responses in a two-pass process. The first pass is to create the Response Preparation Notes filled with sufficient information.",
+        'Note that at this stage, which is a non-interactive stage, we are not yet creating the final Response Statement text.'
+    ],
+    terms: [
+        "Response Preparation Notes: This is a document created during the initial phase of preparing a response to the user's message. It's not a prompt, nor the response statement itself, but a detailed record of the analysis conducted in accordance with the provided instructions. It serves as a roadmap for crafting the final response statement.",
+        'Response Statement: A response provided to the user. It is crafted with reference to the Response Preparation Notes, which are created in the preliminary stage of formulating the response statement.'
+    ],
+    instructions: [
+        'Start by thoroughly reading the exchange of messages to understand the overall topic and context. Summarize it concisely.',
+        "Next, focus on the user's most recent message. Conduct a detailed analysis of the implicit context and what the pronouns refer to. Interpret the user's request and elaborate on their intent. Look for any unresolved requests or questions.",
+        'Then, make a judgment on what you should do and set a goal. Look for what can be done in response to it.',
+        'Finally, compile the information necessary to create a response to the user.'
+    ],
+    guidelines: [
+        'Since the note is a text for the Assistant to read, "you" should refer to the Assistant.',
+        'Remember that there are three roles of speakers in the dialogue environment: user, assistant, and system. Each statement should be interpreted separately.',
+        "The key part of the Response Preparation Notes is understanding the user's question intent. Make sure to quote the user's message that needs to be responded to and create explanations for any pronouns or parts that implicitly refer to something.",
+        "Based on the user's most recent message complexity, indicate in your Response Preparation Notes whether a concise or detailed response should be prepared."
+    ],
+    cue: [
+        'The required output at this stage is the content of the Response Preparation Notes. As this is the first stage of the 2-pass process, do not output the response statement.',
+        {
+            type: 'subsection',
+            content: '',
+            title: 'Response Preparation Notes',
+            items: ['']
+        }
+    ]
+};
+/**
+ * Second pass of two-pass response - creates the Response Statement
+ */
+export const secondOfTwoPassResponse = {
+    objective: [
+        'Your task is to create responses in a two-pass process. The second pass is to create the Response Statement, referencing but not including the content of the Response Preparation Notes.'
+    ],
+    terms: [
+        'Response Statement: A response statement to the user.',
+        "Response Preparation Note: The initial output of the first pass in the two-pass process of creating responses. They are a detailed analysis and interpretation of the user's most recent message, including the implicit context and what the pronouns refer to. The purpose of these notes is to prepare for the creation of the Response Statement."
+    ],
+    instructions: [
+        'Consider the Response Preparation Notes as a special part of the dialogue environment. Use them, along with the rest of the dialogue environment, to create a response statement.',
+        'The output should be the response statement only.'
+    ],
+    preparationNote: [
+        (context) => {
+            if (!context.preparationNote?.content)
+                return null;
+            return {
+                type: 'text',
+                content: context.preparationNote.content
+            };
+        }
+    ]
+};
+/**
+ * Module for maintaining conversation state
+ */
+export const withTalkState = {
+    terms: [
+        'Current State: It is information about the context in which the dialogue environment exists; besides state, reference materials and logs of the last few conversations may be provided, but state is there to remember the state of the dialogue otherwise. These include "things to remember," "themes of the dialogue," and "summary of the conversation.".'
+    ],
+    state: [
+        (context) => {
+            if (!context.state?.content)
+                return null;
+            return {
+                type: 'text',
+                content: context.state.content
+            };
+        }
+    ]
+};
+//# sourceMappingURL=dialogue.js.map

package/dist/modules/dialogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogue.js","sourceRoot":"","sources":["../../src/modules/dialogue.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkC;IACzD,SAAS,EAAE;QACT,2EAA2E;KAC5E;IAED,KAAK,EAAE;QACL,iOAAiO;QACjO,sNAAsN;KACvN;IAED,QAAQ,EAAE;QACR,CAAC,OAAO,EAAE,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAEnC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK;gBAC5B,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;gBAChE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YAErB,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1B,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;aACI,CAAA,CAAC,CAAC;QACxB,CAAC;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkC;IACnE,SAAS,EAAE;QACT,+JAA+J;QAC/J,uHAAuH;KACxH;IAED,KAAK,EAAE;QACL,sVAAsV;QACtV,wMAAwM;KACzM;IAED,YAAY,EAAE;QACZ,2HAA2H;QAC3H,+OAA+O;QAC/O,0GAA0G;QAC1G,8EAA8E;KAC/E;IAED,UAAU,EAAE;QACV,0FAA0F;QAC1F,4JAA4J;QAC5J,uPAAuP;QACvP,4JAA4J;KAC7J;IAED,GAAG,EAAE;QACH,6KAA6K;QAC7K;YACE,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,4BAA4B;YACnC,KAAK,EAAE,CAAC,EAAE,CAAC;SACS;KACvB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC;IACpE,SAAS,EAAE;QACT,2LAA2L;KAC5L;IAED,KAAK,EAAE;QACL,uDAAuD;QACvD,uVAAuV;KACxV;IAED,YAAY,EAAE;QACZ,mLAAmL;QACnL,mDAAmD;KACpD;IAED,eAAe,EAAE;QACf,CAAC,OAAO,EAAE,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO;gBAAE,OAAO,IAAI,CAAC;YACnD,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO;aACzC,CAAC;QACJ,CAAC;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,KAAK,EAAE;QACL,+VAA+V;KAChW;IAED,KAAK,EAAE;QACL,CAAC,OAAO,EAAE,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO;aAC/B,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/dist/modules/index.d.ts

@@ -0,0 +1,9 @@
+export { withMaterials, answerWithReferences } from './material.js';
+export type { MaterialContext } from './material.js';
+export { streamProcessing } from './stream-processing.js';
+export type { StreamProcessingContext } from './stream-processing.js';
+export { dialogueBase, firstOfTwoPassResponse, secondOfTwoPassResponse, withTalkState } from './dialogue.js';
+export type { DialogueContext } from './dialogue.js';
+export { summarizeBase, analyzeForSummary, contentSummarize } from './summarize.js';
+export type { SummarizeContext } from './summarize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/modules/index.js

@@ -0,0 +1,5 @@
+export { withMaterials, answerWithReferences } from './material.js';
+export { streamProcessing } from './stream-processing.js';
+export { dialogueBase, firstOfTwoPassResponse, secondOfTwoPassResponse, withTalkState } from './dialogue.js';
+export { summarizeBase, analyzeForSummary, contentSummarize } from './summarize.js';
+//# sourceMappingURL=index.js.map

package/dist/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC"}

package/dist/modules/material.d.ts

@@ -0,0 +1,21 @@
+import type { PromptModule } from '@modular-prompt/core';
+/**
+ * Material context interface
+ */
+export interface MaterialContext {
+    materials?: Array<{
+        id: string;
+        title: string;
+        content: string;
+        usage?: number;
+    }>;
+}
+/**
+ * Material module - handles external materials/documents
+ */
+export declare const withMaterials: PromptModule<MaterialContext>;
+/**
+ * Material module with reference citation requirements
+ */
+export declare const answerWithReferences: PromptModule<MaterialContext>;
+//# sourceMappingURL=material.d.ts.map

package/dist/modules/material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../src/modules/material.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,eAAe,CAuBvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,eAAe,CAW9D,CAAC"}

package/dist/modules/material.js

@@ -0,0 +1,41 @@
+import { merge } from '@modular-prompt/core';
+/**
+ * Material module - handles external materials/documents
+ */
+export const withMaterials = {
+    terms: [
+        'Materials: the content of a web page or other text that has been imported into the system.',
+        'Material ID: An ID representing a material used for manipulating the material, described as "[<title>](<material ID>)".',
+        'The Learned Knowledge: Knowledge that you, the Assistant, have already learned.',
+        'Prepared Contextual Materials: Materials retrieved from the DB and explicitly provided. Materials that are not prepared cannot be accessed.'
+    ],
+    materials: [
+        (context) => {
+            if (!context.materials || context.materials.length === 0)
+                return null;
+            return context.materials.map(material => {
+                const { id, title, content, usage } = material;
+                return {
+                    type: 'material',
+                    id,
+                    title,
+                    content,
+                    usage
+                };
+            });
+        }
+    ]
+};
+/**
+ * Material module with reference citation requirements
+ */
+export const answerWithReferences = merge(withMaterials, {
+    instructions: [
+        'Ensure that responses to questions clearly distinguish between information derived from prepared materials and learned knowledge.',
+        'Always include the ID of the material when referencing information from prepared materials, using the format "(refs:<Material ID>)".',
+        'Even in the absence of prepared materials or specific references, or when the response is based on learned knowledge, always indicate the source of the information as "(refs:learned-knowledge)".',
+        'If information from multiple sources is used, each source should be cited accordingly.',
+        'If materials present different perspectives or conflicting information, report the facts that can be inferred from the materials. Avoid forcing a summary.'
+    ]
+});
+//# sourceMappingURL=material.js.map

package/dist/modules/material.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.js","sourceRoot":"","sources":["../../src/modules/material.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAe7C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,KAAK,EAAE;QACL,4FAA4F;QAC5F,yHAAyH;QACzH,iFAAiF;QACjF,6IAA6I;KAC9I;IACD,SAAS,EAAE;QACT,CAAC,OAAO,EAAE,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAEtE,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;gBACtC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;gBAC/C,OAAO;oBACL,IAAI,EAAE,UAAmB;oBACzB,EAAE;oBACF,KAAK;oBACL,OAAO;oBACP,KAAK;iBACN,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAkC,KAAK,CACtE,aAAa,EACb;IACE,YAAY,EAAE;QACZ,mIAAmI;QACnI,sIAAsI;QACtI,oMAAoM;QACpM,wFAAwF;QACxF,4JAA4J;KAC7J;CACF,CACF,CAAC"}

package/dist/modules/stream-processing.d.ts

@@ -0,0 +1,26 @@
+import type { PromptModule } from '@modular-prompt/core';
+/**
+ * Stream processing context interface
+ */
+export interface StreamProcessingContext {
+    chunks?: Array<{
+        content: string;
+        partOf?: string;
+        usage?: number;
+        attachments?: any[];
+    }>;
+    state?: {
+        content: string;
+        usage?: number;
+    };
+    range?: {
+        start?: number;
+        end?: number;
+    };
+    targetTokens?: number;
+}
+/**
+ * Stream processing module - for processing large texts in chunks
+ */
+export declare const streamProcessing: PromptModule<StreamProcessingContext>;
+//# sourceMappingURL=stream-processing.d.ts.map

package/dist/modules/stream-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-processing.d.ts","sourceRoot":"","sources":["../../src/modules/stream-processing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,uBAAuB,CAmIlE,CAAC"}

package/dist/modules/stream-processing.js

@@ -0,0 +1,128 @@
+/**
+ * Stream processing module - for processing large texts in chunks
+ */
+export const streamProcessing = {
+    objective: [
+        'The assistant functions as a non-interactive system that processes each iteration of stream processing.',
+        'The goal of the overall stream processing is to process the entire Source Text by dividing it into manageable chunks.',
+        'In this iteration, perform the specified processing on the Input Chunks and Current State, producing the Next State as output.',
+        (context) => {
+            // Detect if this is the first or last iteration based on range
+            if (!context.chunks || !context.range)
+                return null;
+            const isFirst = context.range.start === 0 || context.range.start === undefined;
+            const isLast = context.range.end === context.chunks.length;
+            if (isFirst && isLast) {
+                return {
+                    type: 'text',
+                    content: 'This is a single-iteration processing. Complete all processing in this iteration.'
+                };
+            }
+            else if (isFirst) {
+                return {
+                    type: 'text',
+                    content: 'This is the first iteration. Initialize the state with foundational information.'
+                };
+            }
+            else if (isLast) {
+                return {
+                    type: 'text',
+                    content: 'This is the final iteration. Ensure the Next State represents the complete processing result.'
+                };
+            }
+            return null;
+        }
+    ],
+    terms: [
+        'Stream Processing: A process of obtaining the final output by dividing the input data (the Source Text in this system) and performing iterative sequential processing.',
+        'Source Text: The text to be processed. It is divided into chunks, and several chunks are provided in each iteration.',
+        'Iteration: A unit of processing in stream processing. It is repeated to process time-series data or large segmented processing targets.',
+        'Chunk: A part of the source text divided based on chapter structure or text volume.',
+        'State: The text data updated in each iteration. The processing result of each iteration is retained.',
+        'Current State: The state at the beginning of an iteration, containing results from previous iterations.',
+        'Next State: The state produced by the current iteration, which becomes the Current State for the next iteration.'
+    ],
+    methodology: [
+        'Read the Current State, which contains the processing results from previous iterations.',
+        'Process the provided Input Chunks according to the specified processing logic.',
+        'Merge the processing results with the Current State to create the Next State.',
+        'Ensure the Next State integrates all information processed so far.',
+        'Output only the Next State content without any formatting or metadata.',
+        (context) => {
+            // Add size control instructions if targetTokens is specified
+            if (!context.targetTokens)
+                return null;
+            const sizePrompt = `Control the Next State size to target ${context.targetTokens} tokens.`;
+            if (context.state?.usage && context.state.usage > context.targetTokens * 0.8) {
+                return {
+                    type: 'text',
+                    content: `${sizePrompt} Current size is ${context.state.usage} tokens - aggressively reduce size while preserving key information.`
+                };
+            }
+            return {
+                type: 'text',
+                content: `${sizePrompt} Aim for this target without exceeding it.`
+            };
+        },
+        {
+            type: 'subsection',
+            title: 'State Management',
+            items: [
+                'The Current State represents cumulative results from all previous iterations.',
+                'Each iteration processes only a portion of the entire Source Text.',
+                'The Next State must preserve important information from the Current State.',
+                'Merge new information with existing state rather than replacing it.',
+                'The final state after all iterations should represent the complete processing result.'
+            ]
+        }
+    ],
+    instructions: [
+        'The Source Text is divided into chunks and processed iteratively.',
+        'In each iteration, you receive the Current State (previous results) and new Input Chunks.',
+        'Your task is to process the chunks and update the state accordingly.',
+        'The output should be the Next State that will serve as input for the next iteration.'
+    ],
+    state: [
+        (context) => {
+            if (!context.state?.content)
+                return null;
+            return {
+                type: 'chunk',
+                content: context.state.content,
+                partOf: 'state',
+                usage: context.state.usage
+            };
+        }
+    ],
+    materials: [
+        (context) => {
+            if (!context.chunks || context.chunks.length === 0)
+                return null;
+            const chunks = context.chunks.slice(context.range?.start, context.range?.end);
+            if (chunks.length === 0)
+                return null;
+            return chunks.map((chunk, index) => ({
+                type: 'chunk',
+                content: chunk.content,
+                partOf: chunk.partOf || 'input',
+                index,
+                usage: chunk.usage
+            }));
+        }
+    ],
+    cue: [
+        'Below is the output for the Next State:'
+    ],
+    guidelines: [
+        (context) => {
+            if (!context.targetTokens)
+                return null;
+            return {
+                type: 'text',
+                content: 'If the Target Size limit is likely to be exceeded, boldly discard information without fear of missing information. Simplify the presentation, remove duplicate content, remove non-obvious items.'
+            };
+        },
+        'Source text chunks provided in previous iterations are not accessible in the current iteration, so information extraction and importance review can only be done for a given chunk.'
+    ]
+};
+//# sourceMappingURL=stream-processing.js.map

package/dist/modules/stream-processing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-processing.js","sourceRoot":"","sources":["../../src/modules/stream-processing.ts"],"names":[],"mappings":"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"}