@autobe/agent 0.30.0-dev.20260315 → 0.30.0

package/src/describe/imageDescribe.ts

@@ -1,64 +1,64 @@
-import {
-  AutoBeImageDescribeCompleteEvent,
-  AutoBeImageDescribeDraft,
-  AutoBeUserConversateContent,
-  AutoBeUserImageConversateContent,
-  AutoBeUserMessageContent,
-  AutoBeUserMessageHistory,
-} from "@autobe/interface";
-import { v7 } from "uuid";
-
-import { AutoBeContext } from "../context/AutoBeContext";
-import { createAutoBeUserMessageContent } from "../factory/createAutoBeMessageContent";
-import { orchestrateImageDescribeDrafts } from "./image/orchestrateImageDescribeDraft";
-
-export const imageDescribe = async (
-  ctx: AutoBeContext,
-  props: {
-    content: AutoBeUserConversateContent[];
-  },
-): Promise<AutoBeUserMessageHistory> => {
-  const start: Date = new Date();
-
-  const imageContents: AutoBeUserImageConversateContent[] =
-    props.content.filter((m) => m.type === "image");
-  const imageCount: number = imageContents.length;
-  if (imageCount === 0) throw new Error("No image content found");
-  ctx.dispatch({
-    type: "imageDescribeStart",
-    id: v7(),
-    imageCount,
-    created_at: new Date().toISOString(),
-  });
-
-  const drafts: AutoBeImageDescribeDraft[] =
-    await orchestrateImageDescribeDrafts(ctx, { content: props.content });
-  const draftContents: AutoBeUserMessageContent[] = drafts.map((d) =>
-    createAutoBeUserMessageContent({
-      content: d.image,
-      description: d.description,
-    }),
-  );
-  const userInput: AutoBeUserMessageContent[] = props.content
-    .filter((c) => c.type !== "image")
-    .map((c) => createAutoBeUserMessageContent({ content: c }));
-  const query: AutoBeUserMessageContent = {
-    type: "text",
-    text:
-      userInput.length > 0
-        ? "Please analyze the user's input and the image descriptions provided, and write a comprehensive requirements specification document."
-        : "Please analyze the image descriptions provided and write a comprehensive requirements specification document.",
-  };
-  const complete: AutoBeImageDescribeCompleteEvent = {
-    type: "imageDescribeComplete",
-    id: v7(),
-    contents: [...userInput, ...draftContents, query],
-    elapsed: new Date().getTime() - start.getTime(),
-    created_at: new Date().toISOString(),
-  };
-  ctx.dispatch(complete);
-  return {
-    ...complete,
-    type: "userMessage",
-  } satisfies AutoBeUserMessageHistory;
-};
+import {
+  AutoBeImageDescribeCompleteEvent,
+  AutoBeImageDescribeDraft,
+  AutoBeUserConversateContent,
+  AutoBeUserImageConversateContent,
+  AutoBeUserMessageContent,
+  AutoBeUserMessageHistory,
+} from "@autobe/interface";
+import { v7 } from "uuid";
+
+import { AutoBeContext } from "../context/AutoBeContext";
+import { createAutoBeUserMessageContent } from "../factory/createAutoBeMessageContent";
+import { orchestrateImageDescribeDrafts } from "./image/orchestrateImageDescribeDraft";
+
+export const imageDescribe = async (
+  ctx: AutoBeContext,
+  props: {
+    content: AutoBeUserConversateContent[];
+  },
+): Promise<AutoBeUserMessageHistory> => {
+  const start: Date = new Date();
+
+  const imageContents: AutoBeUserImageConversateContent[] =
+    props.content.filter((m) => m.type === "image");
+  const imageCount: number = imageContents.length;
+  if (imageCount === 0) throw new Error("No image content found");
+  ctx.dispatch({
+    type: "imageDescribeStart",
+    id: v7(),
+    imageCount,
+    created_at: new Date().toISOString(),
+  });
+
+  const drafts: AutoBeImageDescribeDraft[] =
+    await orchestrateImageDescribeDrafts(ctx, { content: props.content });
+  const draftContents: AutoBeUserMessageContent[] = drafts.map((d) =>
+    createAutoBeUserMessageContent({
+      content: d.image,
+      description: d.description,
+    }),
+  );
+  const userInput: AutoBeUserMessageContent[] = props.content
+    .filter((c) => c.type !== "image")
+    .map((c) => createAutoBeUserMessageContent({ content: c }));
+  const query: AutoBeUserMessageContent = {
+    type: "text",
+    text:
+      userInput.length > 0
+        ? "Please analyze the user's input and the image descriptions provided, and write a comprehensive requirements specification document."
+        : "Please analyze the image descriptions provided and write a comprehensive requirements specification document.",
+  };
+  const complete: AutoBeImageDescribeCompleteEvent = {
+    type: "imageDescribeComplete",
+    id: v7(),
+    contents: [...userInput, ...draftContents, query],
+    elapsed: new Date().getTime() - start.getTime(),
+    created_at: new Date().toISOString(),
+  };
+  ctx.dispatch(complete);
+  return {
+    ...complete,
+    type: "userMessage",
+  } satisfies AutoBeUserMessageHistory;
+};

package/src/factory/consentFunctionCall.ts

@@ -1,141 +1,141 @@
-import {
-  IAgenticaHistoryJson,
-  MicroAgentica,
-  MicroAgenticaHistory,
-} from "@agentica/core";
-import {
-  AutoBeConsentFunctionCallEvent,
-  AutoBeEvent,
-  AutoBeEventSource,
-} from "@autobe/interface";
-import { StringUtil } from "@autobe/utils";
-import { IPointer } from "tstl";
-import typia from "typia";
-import { v7 } from "uuid";
-
-import { AutoBeConfigConstant } from "../constants/AutoBeConfigConstant";
-import { AutoBeSystemPromptConstant } from "../constants/AutoBeSystemPromptConstant";
-import { IAutoBeConfig } from "../structures/IAutoBeConfig";
-import { IAutoBeVendor } from "../structures/IAutoBeVendor";
-import { mergeSystemMessages } from "./mergeSystemMessages";
-// import { supportFunctionCallFallback } from "./supportFunctionCallFallback";
-import { supportMistral } from "./supportMistral";
-
-/**
- * Generates automatic consent messages when AI hesitates and seeks permission
- * before function calling.
- *
- * Uses fast LLM (chatgpt) to analyze assistant messages and determine if
- * they're seeking function execution approval. Returns strong directive consent
- * message to break permission-seeking loops, or `null` if not applicable.
- *
- * @returns Consent message if applicable, `null` otherwise
- */
-export const consentFunctionCall = async (props: {
-  dispatch: (event: AutoBeEvent) => void;
-  source: AutoBeEventSource;
-  config: IAutoBeConfig;
-  vendor: IAutoBeVendor;
-  assistantMessage: string; // trimmed
-}): Promise<string | null> => {
-  const dispatch = (result: AutoBeConsentFunctionCallEvent.IResult | null) =>
-    props.dispatch({
-      type: "consentFunctionCall",
-      id: v7(),
-      source: props.source,
-      assistantMessage: props.assistantMessage,
-      result,
-      created_at: new Date().toISOString(),
-    });
-  if (props.assistantMessage.length === 0) {
-    const message: string = StringUtil.trim`
-      You sent me an empty assistant message.
-
-      Don't do such foolish thing again, and do the function calling properly.
-    `;
-    dispatch({
-      type: "consent",
-      message,
-    });
-    return message;
-  }
-
-  const pointer: IPointer<AutoBeConsentFunctionCallEvent.IResult | null> = {
-    value: null,
-  };
-  const agent: MicroAgentica = new MicroAgentica({
-    vendor: props.vendor,
-    config: {
-      ...(props.config ?? []),
-      executor: {
-        describe: false,
-      },
-      retry: props.config?.retry ?? AutoBeConfigConstant.VALIDATION_RETRY,
-      // stream: false,
-    },
-    histories: [
-      {
-        id: v7(),
-        type: "systemMessage",
-        text: AutoBeSystemPromptConstant.CONSENT_FUNCTION_CALL,
-        created_at: new Date().toISOString(),
-      } satisfies IAgenticaHistoryJson.ISystemMessage,
-      {
-        id: v7(),
-        type: "assistantMessage",
-        text: props.assistantMessage,
-        created_at: new Date().toISOString(),
-      } satisfies IAgenticaHistoryJson.IAssistantMessage,
-    ],
-    controllers: [
-      typia.llm.controller<IConsentApplication>("consent", {
-        consent: (props) => {
-          pointer.value = {
-            type: "consent",
-            message: props.message,
-          };
-        },
-        notApplicable: () => {
-          pointer.value = {
-            type: "notApplicable",
-          };
-        },
-      } satisfies IConsentApplication),
-    ],
-  });
-  supportMistral(agent, props.vendor);
-  // supportFunctionCallFallback(agent, props.vendor);
-  mergeSystemMessages(agent, props.vendor);
-
-  const histories: MicroAgenticaHistory[] = await agent.conversate(
-    "Analyze and judge this assistant message please.",
-  );
-  if (pointer.value === null) {
-    const last: MicroAgenticaHistory | undefined =
-      histories[histories.length - 1];
-    if (last?.type === "assistantMessage")
-      pointer.value = {
-        type: "assistantMessage",
-        message: last.text,
-      };
-  }
-  dispatch(pointer.value);
-  return pointer.value?.type === "consent" ? pointer.value.message : null;
-};
-
-interface IConsentApplication {
-  /**
-   * Generate authoritative consent message when assistant seeks function
-   * execution approval.
-   *
-   * @param props.message Strong directive (1-2 sentences). E.g., "Execute
-   *   immediately. Do not ask again."
-   */
-  consent(props: { message: string }): void;
-
-  /**
-   * Indicate assistant message doesn't require function calling consent (e.g.,
-   * general conversation, asking for parameters, etc.).
-   */
-  notApplicable(): void;
-}
+import {
+  IAgenticaHistoryJson,
+  MicroAgentica,
+  MicroAgenticaHistory,
+} from "@agentica/core";
+import {
+  AutoBeConsentFunctionCallEvent,
+  AutoBeEvent,
+  AutoBeEventSource,
+} from "@autobe/interface";
+import { StringUtil } from "@autobe/utils";
+import { IPointer } from "tstl";
+import typia from "typia";
+import { v7 } from "uuid";
+
+import { AutoBeConfigConstant } from "../constants/AutoBeConfigConstant";
+import { AutoBeSystemPromptConstant } from "../constants/AutoBeSystemPromptConstant";
+import { IAutoBeConfig } from "../structures/IAutoBeConfig";
+import { IAutoBeVendor } from "../structures/IAutoBeVendor";
+import { mergeSystemMessages } from "./mergeSystemMessages";
+// import { supportFunctionCallFallback } from "./supportFunctionCallFallback";
+import { supportMistral } from "./supportMistral";
+
+/**
+ * Generates automatic consent messages when AI hesitates and seeks permission
+ * before function calling.
+ *
+ * Uses fast LLM (chatgpt) to analyze assistant messages and determine if
+ * they're seeking function execution approval. Returns strong directive consent
+ * message to break permission-seeking loops, or `null` if not applicable.
+ *
+ * @returns Consent message if applicable, `null` otherwise
+ */
+export const consentFunctionCall = async (props: {
+  dispatch: (event: AutoBeEvent) => void;
+  source: AutoBeEventSource;
+  config: IAutoBeConfig;
+  vendor: IAutoBeVendor;
+  assistantMessage: string; // trimmed
+}): Promise<string | null> => {
+  const dispatch = (result: AutoBeConsentFunctionCallEvent.IResult | null) =>
+    props.dispatch({
+      type: "consentFunctionCall",
+      id: v7(),
+      source: props.source,
+      assistantMessage: props.assistantMessage,
+      result,
+      created_at: new Date().toISOString(),
+    });
+  if (props.assistantMessage.length === 0) {
+    const message: string = StringUtil.trim`
+      You sent me an empty assistant message.
+
+      Don't do such foolish thing again, and do the function calling properly.
+    `;
+    dispatch({
+      type: "consent",
+      message,
+    });
+    return message;
+  }
+
+  const pointer: IPointer<AutoBeConsentFunctionCallEvent.IResult | null> = {
+    value: null,
+  };
+  const agent: MicroAgentica = new MicroAgentica({
+    vendor: props.vendor,
+    config: {
+      ...(props.config ?? []),
+      executor: {
+        describe: false,
+      },
+      retry: props.config?.retry ?? AutoBeConfigConstant.VALIDATION_RETRY,
+      // stream: false,
+    },
+    histories: [
+      {
+        id: v7(),
+        type: "systemMessage",
+        text: AutoBeSystemPromptConstant.CONSENT_FUNCTION_CALL,
+        created_at: new Date().toISOString(),
+      } satisfies IAgenticaHistoryJson.ISystemMessage,
+      {
+        id: v7(),
+        type: "assistantMessage",
+        text: props.assistantMessage,
+        created_at: new Date().toISOString(),
+      } satisfies IAgenticaHistoryJson.IAssistantMessage,
+    ],
+    controllers: [
+      typia.llm.controller<IConsentApplication>("consent", {
+        consent: (props) => {
+          pointer.value = {
+            type: "consent",
+            message: props.message,
+          };
+        },
+        notApplicable: () => {
+          pointer.value = {
+            type: "notApplicable",
+          };
+        },
+      } satisfies IConsentApplication),
+    ],
+  });
+  supportMistral(agent, props.vendor);
+  // supportFunctionCallFallback(agent, props.vendor);
+  mergeSystemMessages(agent, props.vendor);
+
+  const histories: MicroAgenticaHistory[] = await agent.conversate(
+    "Analyze and judge this assistant message please.",
+  );
+  if (pointer.value === null) {
+    const last: MicroAgenticaHistory | undefined =
+      histories[histories.length - 1];
+    if (last?.type === "assistantMessage")
+      pointer.value = {
+        type: "assistantMessage",
+        message: last.text,
+      };
+  }
+  dispatch(pointer.value);
+  return pointer.value?.type === "consent" ? pointer.value.message : null;
+};
+
+interface IConsentApplication {
+  /**
+   * Generate authoritative consent message when assistant seeks function
+   * execution approval.
+   *
+   * @param props.message Strong directive (1-2 sentences). E.g., "Execute
+   *   immediately. Do not ask again."
+   */
+  consent(props: { message: string }): void;
+
+  /**
+   * Indicate assistant message doesn't require function calling consent (e.g.,
+   * general conversation, asking for parameters, etc.).
+   */
+  notApplicable(): void;
+}

package/src/factory/createAgenticaHistory.ts

@@ -1,71 +1,71 @@
-import {
-  AgenticaExecuteHistory,
-  AgenticaOperation,
-  AgenticaUserMessageContent,
-  IAgenticaHistoryJson,
-  MicroAgenticaHistory,
-} from "@agentica/core";
-import {
-  AutoBeAssistantMessageHistory,
-  AutoBeHistory,
-} from "@autobe/interface";
-
-export function createAgenticaHistory(props: {
-  operations: readonly AgenticaOperation[];
-  history: AutoBeHistory;
-}): MicroAgenticaHistory | null {
-  if (props.history.type === "userMessage") {
-    // @todo Seems to need more explanation that
-    //       this is not a pure text
-    //       but a text by analyzing an image
-    const history: IAgenticaHistoryJson.IUserMessage = {
-      ...props.history,
-      contents: props.history.contents.map((c) => {
-        if (c.type === "image") {
-          return {
-            type: "text",
-            text: c.description,
-          } satisfies AgenticaUserMessageContent;
-        } else return c;
-      }),
-    };
-    return { ...history, toJSON: () => history };
-  } else if (props.history.type === "assistantMessage")
-    return {
-      ...props.history,
-      toJSON: () => props.history as AutoBeAssistantMessageHistory,
-    };
-
-  const operation: AgenticaOperation | undefined = props.operations.find(
-    (op) => op.function.name === props.history.type,
-  );
-  if (operation === undefined) return null;
-  const partial = {
-    id: props.history.id,
-    created_at: props.history.created_at,
-    type: "execute" as const,
-    arguments: {
-      instruction:
-        props.history.type === "analyze"
-          ? undefined
-          : props.history.instruction,
-    },
-    value: {
-      success:
-        props.history.type === "analyze" || props.history.type === "interface"
-          ? true
-          : props.history.compiled.type === "success",
-    },
-    success: true,
-  } satisfies Partial<AgenticaExecuteHistory>;
-  return {
-    ...partial,
-    protocol: operation.protocol as "class",
-    operation: operation as AgenticaOperation.Class,
-    toJSON: () => ({
-      ...partial,
-      protocol: operation.protocol as "class",
-      operation: operation.toJSON(),
-    }),
-  } satisfies AgenticaExecuteHistory;
-}
+import {
+  AgenticaExecuteHistory,
+  AgenticaOperation,
+  AgenticaUserMessageContent,
+  IAgenticaHistoryJson,
+  MicroAgenticaHistory,
+} from "@agentica/core";
+import {
+  AutoBeAssistantMessageHistory,
+  AutoBeHistory,
+} from "@autobe/interface";
+
+export function createAgenticaHistory(props: {
+  operations: readonly AgenticaOperation[];
+  history: AutoBeHistory;
+}): MicroAgenticaHistory | null {
+  if (props.history.type === "userMessage") {
+    // @todo Seems to need more explanation that
+    //       this is not a pure text
+    //       but a text by analyzing an image
+    const history: IAgenticaHistoryJson.IUserMessage = {
+      ...props.history,
+      contents: props.history.contents.map((c) => {
+        if (c.type === "image") {
+          return {
+            type: "text",
+            text: c.description,
+          } satisfies AgenticaUserMessageContent;
+        } else return c;
+      }),
+    };
+    return { ...history, toJSON: () => history };
+  } else if (props.history.type === "assistantMessage")
+    return {
+      ...props.history,
+      toJSON: () => props.history as AutoBeAssistantMessageHistory,
+    };
+
+  const operation: AgenticaOperation | undefined = props.operations.find(
+    (op) => op.function.name === props.history.type,
+  );
+  if (operation === undefined) return null;
+  const partial = {
+    id: props.history.id,
+    created_at: props.history.created_at,
+    type: "execute" as const,
+    arguments: {
+      instruction:
+        props.history.type === "analyze"
+          ? undefined
+          : props.history.instruction,
+    },
+    value: {
+      success:
+        props.history.type === "analyze" || props.history.type === "interface"
+          ? true
+          : props.history.compiled.type === "success",
+    },
+    success: true,
+  } satisfies Partial<AgenticaExecuteHistory>;
+  return {
+    ...partial,
+    protocol: operation.protocol as "class",
+    operation: operation as AgenticaOperation.Class,
+    toJSON: () => ({
+      ...partial,
+      protocol: operation.protocol as "class",
+      operation: operation.toJSON(),
+    }),
+  } satisfies AgenticaExecuteHistory;
+}