needware-cli 1.2.7 → 1.2.9

package/dist/types/index.d.ts

@@ -5,4 +5,5 @@ export * from './command.js';
 export * from './config.js';
 export * from './error.js';
 export type { SDKConfig, SDKHealthStatus, SDKMetadata } from './sdk.js';
+export * from './prompt.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxE,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -4,4 +4,5 @@
 export * from './command.js';
 export * from './config.js';
 export * from './error.js';
+export * from './prompt.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,cAAc,aAAa,CAAC"}

package/dist/types/prompt.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Prompt 类型定义
+ */
+import { SDKUserMessage } from '@anthropic-ai/claude-agent-sdk';
+/**
+ * Prompt 输入类型
+ *
+ * 支持两种格式：
+ * 1. string - 普通文本或文件路径（自动识别）
+ * 2. SDKUserMessage - 符合 SDK 标准的消息对象
+ */
+export type PromptInput = string | SDKUserMessage | AsyncIterable<SDKUserMessage>;
+/**
+ * Prompt 解析结果
+ */
+export interface ParsedPrompt {
+    /**
+     * 解析后的 prompt（可以是字符串或消息流）
+     */
+    prompt: string | AsyncIterable<SDKUserMessage>;
+    /**
+     * 会话 ID（从 SDKUserMessage 中提取）
+     */
+    sessionId?: string;
+    /**
+     * 是否为交互式模式
+     */
+    isInteractive: boolean;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/types/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/types/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,cAAc,GACd,aAAa,CAAC,cAAc,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAE/C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB"}

package/dist/types/prompt.js

@@ -0,0 +1,5 @@
+/**
+ * Prompt 类型定义
+ */
+export {};
+//# sourceMappingURL=prompt.js.map

package/dist/types/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/types/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/prompt-parser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Prompt 解析工具
+ */
+import { SDKUserMessage } from '@anthropic-ai/claude-agent-sdk';
+import { PromptInput, ParsedPrompt } from '../types/prompt.js';
+/**
+ * 解析 Prompt 输入（自动判断类型）
+ *
+ * 支持两种格式：
+ * 1. 字符串 - 普通文本或文件路径（自动识别）
+ * 2. SDKUserMessage JSON - 符合 SDK 标准的消息对象
+ */
+export declare function parsePrompt(input: PromptInput): Promise<ParsedPrompt>;
+/**
+ * 将字符串转换为消息流（用于交互式模式）
+ */
+export declare function createMessageStream(sessionId: string, initialPrompt?: string): AsyncGenerator<SDKUserMessage>;
+/**
+ * 从命令行参数解析 Prompt（自动判断类型）
+ */
+export declare function parsePromptFromArgs(args: string[]): Promise<ParsedPrompt>;
+//# sourceMappingURL=prompt-parser.d.ts.map

package/dist/utils/prompt-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-parser.d.ts","sourceRoot":"","sources":["../../src/utils/prompt-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI/D;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA2C3E;AA8DD;;GAEG;AACH,wBAAuB,mBAAmB,CACxC,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,cAAc,CAAC,cAAc,CAAC,CAShC;AAyBD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAS/E"}

package/dist/utils/prompt-parser.js

@@ -0,0 +1,148 @@
+/**
+ * Prompt 解析工具
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * 解析 Prompt 输入（自动判断类型）
+ *
+ * 支持两种格式：
+ * 1. 字符串 - 普通文本或文件路径（自动识别）
+ * 2. SDKUserMessage JSON - 符合 SDK 标准的消息对象
+ */
+export async function parsePrompt(input) {
+    // 如果是异步迭代器（交互式模式），直接返回
+    if (isAsyncIterable(input)) {
+        return {
+            prompt: input,
+            isInteractive: true,
+        };
+    }
+    // 如果是字符串，进一步判断
+    if (typeof input === 'string') {
+        // 检查是否是文件路径
+        if (input.endsWith('.txt') || input.endsWith('.json') || input.endsWith('.md')) {
+            if (fs.existsSync(path.resolve(input))) {
+                return await parsePromptFromFile(input);
+            }
+        }
+        // 尝试解析为 SDKUserMessage JSON
+        if (input.trim().startsWith('{')) {
+            try {
+                const data = JSON.parse(input);
+                if (isSDKUserMessage(data)) {
+                    return parseSDKUserMessage(data);
+                }
+            }
+            catch {
+                // 不是有效的 JSON，继续作为普通字符串处理
+            }
+        }
+        // 作为普通字符串处理
+        return {
+            prompt: input.trim(),
+            isInteractive: false,
+        };
+    }
+    // 如果是 SDKUserMessage 对象
+    if (isSDKUserMessage(input)) {
+        return parseSDKUserMessage(input);
+    }
+    throw new Error(`Unsupported prompt input type: ${typeof input}`);
+}
+/**
+ * 从文件读取 Prompt
+ */
+async function parsePromptFromFile(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`Prompt file not found: ${resolvedPath}`);
+    }
+    const content = fs.readFileSync(resolvedPath, 'utf-8').trim();
+    const ext = path.extname(filePath).toLowerCase();
+    // 如果是 JSON 文件，尝试解析为 SDKUserMessage
+    if (ext === '.json') {
+        try {
+            const data = JSON.parse(content);
+            if (isSDKUserMessage(data)) {
+                return parseSDKUserMessage(data);
+            }
+            throw new Error('JSON file must contain a valid SDKUserMessage object');
+        }
+        catch (error) {
+            throw new Error(`Invalid JSON in prompt file: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    // 否则作为纯文本处理
+    return {
+        prompt: content,
+        isInteractive: false,
+    };
+}
+/**
+ * 解析 SDKUserMessage
+ */
+function parseSDKUserMessage(data) {
+    // 从 message 中提取文本内容
+    const message = data.message;
+    let promptText = '';
+    if (typeof message.content === 'string') {
+        promptText = message.content;
+    }
+    else if (Array.isArray(message.content)) {
+        // 如果 content 是数组，提取文本部分
+        promptText = message.content
+            .filter((item) => item.type === 'text')
+            .map((item) => item.text)
+            .join('\n');
+    }
+    return {
+        prompt: promptText.trim(),
+        sessionId: data.session_id,
+        isInteractive: false,
+    };
+}
+/**
+ * 将字符串转换为消息流（用于交互式模式）
+ */
+export async function* createMessageStream(sessionId, initialPrompt) {
+    if (initialPrompt) {
+        yield {
+            session_id: sessionId,
+            type: 'user',
+            message: { role: 'user', content: initialPrompt.trim() },
+            parent_tool_use_id: null,
+        };
+    }
+}
+/**
+ * 类型守卫：检查是否为 AsyncIterable
+ */
+function isAsyncIterable(obj) {
+    return obj && typeof obj[Symbol.asyncIterator] === 'function';
+}
+/**
+ * 类型守卫：检查是否为 SDKUserMessage
+ */
+function isSDKUserMessage(obj) {
+    return (obj &&
+        typeof obj === 'object' &&
+        'type' in obj &&
+        obj.type === 'user' &&
+        'message' in obj &&
+        typeof obj.message === 'object' &&
+        'session_id' in obj &&
+        typeof obj.session_id === 'string');
+}
+/**
+ * 从命令行参数解析 Prompt（自动判断类型）
+ */
+export async function parsePromptFromArgs(args) {
+    if (args.length === 0) {
+        throw new Error('No prompt provided');
+    }
+    const firstArg = args[0];
+    // 使用统一的 parsePrompt 函数，它会自动判断类型
+    return parsePrompt(firstArg);
+}
+//# sourceMappingURL=prompt-parser.js.map

package/dist/utils/prompt-parser.js.map

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

package/examples/sdk-message-example.json

@@ -0,0 +1,10 @@
+{
+  "type": "user",
+  "session_id": "my-session-123",
+  "message": {
+    "role": "user",
+    "content": "创建一个简单的计数器组件，包含增加、减少和重置按钮"
+  },
+  "parent_tool_use_id": null
+}
+