@lowire/loop 0.0.1 → 0.0.3

package/lib/providers/registry.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProvider = getProvider;
+const openai_1 = require("./openai");
+const github_1 = require("./github");
+const anthropic_1 = require("./anthropic");
+const google_1 = require("./google");
+function getProvider(loopName) {
+    if (loopName === 'openai')
+        return new openai_1.OpenAI();
+    if (loopName === 'github')
+        return new github_1.Github();
+    if (loopName === 'anthropic')
+        return new anthropic_1.Anthropic();
+    if (loopName === 'google')
+        return new google_1.Google();
+    throw new Error(`Unknown loop LLM: ${loopName}`);
+}

package/lib/summary.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type * as types from './types';
+export declare function summarizeConversation(task: string, conversation: types.Conversation, options: Pick<types.CompletionOptions, 'debug'>): {
+    summary: string;
+    lastMessage: types.AssistantMessage;
+};

package/lib/summary.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeConversation = summarizeConversation;
+const jsx_runtime_1 = require("./jsx/jsx-runtime");
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const jsx_runtime_2 = require("./jsx/jsx-runtime");
+function summarizeConversation(task, conversation, options) {
+    const summary = ['## Task', task];
+    const combinedState = {};
+    const assistantMessages = conversation.messages.filter(message => message.role === 'assistant');
+    for (let turn = 0; turn < assistantMessages.length - 1; ++turn) {
+        if (turn === 0) {
+            summary.push('');
+            summary.push('## History');
+        }
+        summary.push(``);
+        const text = assistantMessages[turn].content.filter(part => part.type === 'text').map(part => part.text).join('\n');
+        const toolCalls = assistantMessages[turn].content.filter(part => part.type === 'tool_call');
+        for (const toolCall of toolCalls) {
+            if (toolCall.result) {
+                for (const [name, state] of Object.entries(toolCall.result._meta?.['dev.lowire/state'] || {}))
+                    combinedState[name] = state;
+            }
+        }
+        const message = assistantMessages[turn];
+        summary.push((0, jsx_runtime_1.jsxs)("step", { turn: turn + 1, children: [(0, jsx_runtime_1.jsx)("title", { children: text }), toolCalls.map(toolCall => (0, jsx_runtime_1.jsxs)("tool-call", { children: [(0, jsx_runtime_1.jsx)("name", { children: toolCall.name }), Object.keys(toolCall.arguments).length > 0 && (0, jsx_runtime_1.jsx)("arguments", { children: Object.entries(toolCall.arguments).map(([key, value]) => (0, jsx_runtime_2.jsx)(key, { children: [JSON.stringify(value)] })) })] })), toolCalls.map(toolCall => toolCall.result?._meta?.['dev.lowire/history'] || []).flat().map(h => (0, jsx_runtime_2.jsx)(h.category, { children: [h.content] })), message.toolError && (0, jsx_runtime_1.jsx)("error", { children: message.toolError })] }));
+    }
+    const lastMessage = assistantMessages[assistantMessages.length - 1];
+    if (lastMessage) { // Remove state from combined state as it'll be a part of the last assistant message.
+        for (const part of lastMessage.content.filter(part => part.type === 'tool_call')) {
+            for (const name of Object.keys(part.result?._meta?.['dev.lowire/state'] || {}))
+                delete combinedState[name];
+        }
+    }
+    for (const [name, state] of Object.entries(combinedState)) {
+        summary.push('');
+        summary.push((0, jsx_runtime_1.jsx)("state", { name: name, children: state }));
+    }
+    options.debug?.('lowire:summary')(summary.join('\n'));
+    options.debug?.('lowire:summary')(JSON.stringify(lastMessage, null, 2));
+    return { summary: summary.join('\n'), lastMessage };
+}

package/lib/types.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export type Schema = {
+    type: 'object';
+    properties?: unknown | null;
+    required?: Array<string> | null;
+};
+export type Tool = {
+    name: string;
+    description?: string;
+    inputSchema: Schema;
+};
+export type ToolCallback = (params: {
+    name: string;
+    arguments: any;
+}) => Promise<ToolResult>;
+export type BaseMessage = {
+    role: 'user' | 'assistant';
+};
+export type Message = UserMessage | AssistantMessage;
+export type UserMessage = BaseMessage & {
+    role: 'user';
+    content: string;
+};
+export type AssistantMessage = BaseMessage & {
+    role: 'assistant';
+    content: (TextContentPart | ToolCallContentPart | ThinkingContentPart)[];
+    openaiId?: string;
+    openaiStatus?: 'completed' | 'incomplete' | 'in_progress';
+    toolError?: string;
+};
+export type TextContentPart = {
+    type: 'text';
+    text: string;
+    googleThoughtSignature?: string;
+    copilotToolCallId?: string;
+};
+export type ThinkingContentPart = {
+    type: 'thinking';
+    thinking: string;
+    signature: string;
+};
+export type ToolCallContentPart = {
+    type: 'tool_call';
+    name: string;
+    arguments: any;
+    id: string;
+    googleThoughtSignature?: string;
+    openaiId?: string;
+    openaiStatus?: 'completed' | 'incomplete' | 'in_progress';
+    result?: ToolResult;
+};
+export type TextResultPart = {
+    type: 'text';
+    text: string;
+};
+export type ImageResultPart = {
+    type: 'image';
+    data: string;
+    mimeType: string;
+};
+export type ResultPart = TextResultPart | ImageResultPart;
+export type ToolResult = {
+    _meta?: {
+        'dev.lowire/history'?: {
+            category: string;
+            content: string;
+        }[];
+        'dev.lowire/state'?: Record<string, string>;
+    };
+    content: ResultPart[];
+    isError?: boolean;
+};
+export type Conversation = {
+    systemPrompt: string;
+    messages: Message[];
+    tools: Tool[];
+};
+export type Debug = (category: string) => (...args: any[]) => void;
+export type CompletionOptions = {
+    model: string;
+    maxTokens?: number;
+    reasoning?: boolean;
+    temperature?: number;
+    debug?: Debug;
+};
+export interface Provider {
+    name: string;
+    complete(conversation: Conversation, options: CompletionOptions): Promise<{
+        result: AssistantMessage;
+        usage: Usage;
+    }>;
+}
+export type Usage = {
+    input: number;
+    output: number;
+};
+export type ReplayCache = Record<string, {
+    result: AssistantMessage;
+    usage: Usage;
+}>;

package/lib/types.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,12 +1,26 @@
 {
   "name": "@lowire/loop",
-  "version": "0.0.1",
-  "main": "index.js",
+  "version": "0.0.3",
+  "description": "Small agentic loop",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pavelfeldman/lowire.git"
+  },
+  "homepage": "https://github.com/pavelfeldman/lowire",
+  "engines": {
+    "node": ">=20"
+  },
+  "author": {
+    "name": "Microsoft Corporation"
+  },
+  "license": "Apache-2.0",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "description": ""
+  "exports": {
+    ".": {
+      "import": "./index.mjs",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    }
+  }
 }