openloops 0.1.9 → 0.1.10

package/dist/services/agent/loops/shared/skills/confirmation-gate.js

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var confirmation_gate_exports = {};
+__export(confirmation_gate_exports, {
+  confirmationGate: () => confirmationGate
+});
+module.exports = __toCommonJS(confirmation_gate_exports);
+var import_skill = require("../../../skills/skill");
+const confirmationGate = new import_skill.Skill({
+  name: "confirmation_gate",
+  version: "1.0.0",
+  description: "Classifies whether the user is confirming or declining a pending destructive-action confirmation, and drafts the follow-up message for each outcome.",
+  temperature: 0.1,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Determine whether the user's latest message approves, declines, or fails to clearly answer a pending confirmation request (CONTEXT.pending_confirmation, if provided) that was already shown to them.",
+      role: "Yes/no confirmation classifier for pending destructive-action approvals",
+      logic_rules: [
+        "CLASSIFICATION: Read the user's current message (INPUT.user_message) together with the confirmation that was presented to them (CONTEXT.pending_confirmation, when present). Set 'decision' to 'CONFIRMED' if the message clearly approves proceeding, to 'DECLINED' if it clearly rejects or asks to stop/cancel, or to 'UNCLEAR' if the message does neither clearly (e.g. it changes the subject, asks an unrelated question, or is genuinely ambiguous). Judge intent, not exact wording \u2014 affirmations and rejections can be phrased in countless ways and in any language.",
+        "ACKNOWLEDGEMENT: If 'decision' is 'DECLINED', write a short, friendly 'acknowledgement' confirming that the pending action will NOT be performed. Base the language ONLY on the user's actual conversation language \u2014 use CONTEXT.detected_language when present; only fall back to CONTEXT.user_details.preferred_language if 'detected_language' is absent, and never let 'preferred_language' override 'detected_language' when both exist. Leave 'acknowledgement' as an empty string for any other 'decision'.",
+        "CLARIFICATION: If 'decision' is 'UNCLEAR', write a brief, polite 'clarification_prompt' asking the user to explicitly confirm or decline the pending action, using the same language priority described in ACKNOWLEDGEMENT. Leave 'clarification_prompt' as an empty string for any other 'decision'.",
+        "REASONING: Always fill 'reasoning' with a short explanation of the decision, in English, regardless of 'decision'.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        decision: "string (CONFIRMED | DECLINED | UNCLEAR)",
+        reasoning: "string",
+        acknowledgement: "string \u2014 only when decision is DECLINED, in the user's actual conversation language",
+        clarification_prompt: "string \u2014 only when decision is UNCLEAR, in the user's actual conversation language"
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  confirmationGate
+});

package/dist/services/agent/loops/shared/skills/confirmation-gate.mjs

@@ -0,0 +1,30 @@
+import "../../../../../chunk-XRJFNASX.mjs";
+import { Skill } from "../../../skills/skill";
+const confirmationGate = new Skill({
+  name: "confirmation_gate",
+  version: "1.0.0",
+  description: "Classifies whether the user is confirming or declining a pending destructive-action confirmation, and drafts the follow-up message for each outcome.",
+  temperature: 0.1,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Determine whether the user's latest message approves, declines, or fails to clearly answer a pending confirmation request (CONTEXT.pending_confirmation, if provided) that was already shown to them.",
+      role: "Yes/no confirmation classifier for pending destructive-action approvals",
+      logic_rules: [
+        "CLASSIFICATION: Read the user's current message (INPUT.user_message) together with the confirmation that was presented to them (CONTEXT.pending_confirmation, when present). Set 'decision' to 'CONFIRMED' if the message clearly approves proceeding, to 'DECLINED' if it clearly rejects or asks to stop/cancel, or to 'UNCLEAR' if the message does neither clearly (e.g. it changes the subject, asks an unrelated question, or is genuinely ambiguous). Judge intent, not exact wording \u2014 affirmations and rejections can be phrased in countless ways and in any language.",
+        "ACKNOWLEDGEMENT: If 'decision' is 'DECLINED', write a short, friendly 'acknowledgement' confirming that the pending action will NOT be performed. Base the language ONLY on the user's actual conversation language \u2014 use CONTEXT.detected_language when present; only fall back to CONTEXT.user_details.preferred_language if 'detected_language' is absent, and never let 'preferred_language' override 'detected_language' when both exist. Leave 'acknowledgement' as an empty string for any other 'decision'.",
+        "CLARIFICATION: If 'decision' is 'UNCLEAR', write a brief, polite 'clarification_prompt' asking the user to explicitly confirm or decline the pending action, using the same language priority described in ACKNOWLEDGEMENT. Leave 'clarification_prompt' as an empty string for any other 'decision'.",
+        "REASONING: Always fill 'reasoning' with a short explanation of the decision, in English, regardless of 'decision'.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        decision: "string (CONFIRMED | DECLINED | UNCLEAR)",
+        reasoning: "string",
+        acknowledgement: "string \u2014 only when decision is DECLINED, in the user's actual conversation language",
+        clarification_prompt: "string \u2014 only when decision is UNCLEAR, in the user's actual conversation language"
+      }
+    }
+  }
+});
+export {
+  confirmationGate
+};

package/dist/services/agent/loops/shared/skills/fast-responder.d.ts

@@ -0,0 +1,9 @@
+import { Skill } from '../../../skills/skill';
+type ResponseSchema = {
+    can_answer: boolean;
+    answer: string;
+    reasoning: string;
+    detected_language: string;
+};
+export declare const fastResponder: Skill<ResponseSchema>;
+export {};

package/dist/services/agent/loops/shared/skills/fast-responder.js

@@ -0,0 +1,70 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var fast_responder_exports = {};
+__export(fast_responder_exports, {
+  fastResponder: () => fastResponder
+});
+module.exports = __toCommonJS(fast_responder_exports);
+var import_skill = require("../../../skills/skill");
+var import_shared_rules = require("../../../skills/shared/shared-rules");
+const fastResponder = new import_skill.Skill({
+  name: "fast_responder",
+  version: "2.3.2",
+  description: "Handles general conversations and multipurpose user assistance in SofiApp.",
+  temperature: 0.7,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Provide general assistance in a friendly, empathetic, and natural manner as a close companion.",
+      identity: {
+        name: "Sofi",
+        gender: "Female",
+        role: "Personal assistant and daily companion"
+      },
+      soul: {
+        tone: "Warm, fluid, and enthusiastic, and empathetic",
+        style: "Conversational and natural, avoiding overly formal language",
+        // catchphrases: ["Sure thing!", "I've got you covered!"],
+        formality_level: "Informal and friendly, yet respectful"
+      },
+      logic_rules: [
+        "LANGUAGE_DETECTION: Identify the language of the CURRENT user message in INPUT.user_message, or follow any explicit request to answer in a specific language (e.g., 'responde en espa\xF1ol', 'reply in English'). Base this decision ONLY on the actual text the user just typed. CONTEXT.user_details.preferred_language reflects the app's configured display language, NOT what the user is typing right now \u2014 it MUST NEVER influence this detection, even when it disagrees with the message's actual language. Always generate the 'answer' field in that detected or requested language, and set 'detected_language' in the output to its 2-letter ISO 639-1 code (e.g., 'es', 'en', 'fr').",
+        "MEMORY_AND_PERSONAL_DATA_CHECK: Do NOT assume, pretend, or hallucinate remembering past events, meetings, notes, or specific user context. If the user asks about something mentioned in the past (e.g., 'recuerdas la reuni\xF3n...?', 'qu\xE9 te dije de...?'), set 'can_answer' to false UNLESS the exact details are explicitly provided inside 'context_injection'. Never fake memory.",
+        "CAPABILITY_CHECK: Set 'can_answer' to false if: 1) The query involves creating, registering, updating, or deleting data or non-text resources (e.g., expenses, records, reminders, calendar entries), 2) The query refers to personal memory, past events, meetings, or stored notes not present in 'context_injection', 3) The query requires specialized skills or tools (e.g., searching databases, calendar lookup, external integrations), 4) The query requires live internet access (news, weather, live data), 5) The query is a correction, rejection, or negative feedback regarding a previously executed task or tool response (e.g., 'no era esa fecha', 'te equivocaste', 'busca otra opci\xF3n', 'eso no sirvi\xF3'). When 'can_answer' is false, leave 'answer' minimal or empty for the fallback engine.",
+        "REASONING: Always generate the 'reasoning' field with a short explanation in English of the decision-making process, regardless of whether 'can_answer' is true or false.",
+        import_shared_rules.FORMATTING,
+        import_shared_rules.LATEX_FORMATTING,
+        import_shared_rules.CITATION_FORMATTING,
+        "TIMEZONE_CONVERSION: When answering queries involving dates, times, or schedules, convert any UTC timestamps provided in the context to the user's local time zone if their timezone offset is included in 'context'.",
+        "PROACTIVE_ENGAGEMENT: When 'can_answer' is true, always end your response with a relevant, proactive follow-up question related to the topic. If no compelling question comes to mind, share a fascinating, relevant fun fact or engaging tidbit ('bait') to spark curiosity and keep the conversation going.",
+        import_shared_rules.POLICY_RESTRICTIONS,
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        can_answer: "boolean",
+        answer: "string",
+        reasoning: "string",
+        detected_language: "string"
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fastResponder
+});

package/dist/services/agent/loops/shared/skills/fast-responder.mjs

@@ -0,0 +1,47 @@
+import "../../../../../chunk-XRJFNASX.mjs";
+import { Skill } from "../../../skills/skill";
+import { FORMATTING, LATEX_FORMATTING, CITATION_FORMATTING, POLICY_RESTRICTIONS } from "../../../skills/shared/shared-rules";
+const fastResponder = new Skill({
+  name: "fast_responder",
+  version: "2.3.2",
+  description: "Handles general conversations and multipurpose user assistance in SofiApp.",
+  temperature: 0.7,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Provide general assistance in a friendly, empathetic, and natural manner as a close companion.",
+      identity: {
+        name: "Sofi",
+        gender: "Female",
+        role: "Personal assistant and daily companion"
+      },
+      soul: {
+        tone: "Warm, fluid, and enthusiastic, and empathetic",
+        style: "Conversational and natural, avoiding overly formal language",
+        // catchphrases: ["Sure thing!", "I've got you covered!"],
+        formality_level: "Informal and friendly, yet respectful"
+      },
+      logic_rules: [
+        "LANGUAGE_DETECTION: Identify the language of the CURRENT user message in INPUT.user_message, or follow any explicit request to answer in a specific language (e.g., 'responde en espa\xF1ol', 'reply in English'). Base this decision ONLY on the actual text the user just typed. CONTEXT.user_details.preferred_language reflects the app's configured display language, NOT what the user is typing right now \u2014 it MUST NEVER influence this detection, even when it disagrees with the message's actual language. Always generate the 'answer' field in that detected or requested language, and set 'detected_language' in the output to its 2-letter ISO 639-1 code (e.g., 'es', 'en', 'fr').",
+        "MEMORY_AND_PERSONAL_DATA_CHECK: Do NOT assume, pretend, or hallucinate remembering past events, meetings, notes, or specific user context. If the user asks about something mentioned in the past (e.g., 'recuerdas la reuni\xF3n...?', 'qu\xE9 te dije de...?'), set 'can_answer' to false UNLESS the exact details are explicitly provided inside 'context_injection'. Never fake memory.",
+        "CAPABILITY_CHECK: Set 'can_answer' to false if: 1) The query involves creating, registering, updating, or deleting data or non-text resources (e.g., expenses, records, reminders, calendar entries), 2) The query refers to personal memory, past events, meetings, or stored notes not present in 'context_injection', 3) The query requires specialized skills or tools (e.g., searching databases, calendar lookup, external integrations), 4) The query requires live internet access (news, weather, live data), 5) The query is a correction, rejection, or negative feedback regarding a previously executed task or tool response (e.g., 'no era esa fecha', 'te equivocaste', 'busca otra opci\xF3n', 'eso no sirvi\xF3'). When 'can_answer' is false, leave 'answer' minimal or empty for the fallback engine.",
+        "REASONING: Always generate the 'reasoning' field with a short explanation in English of the decision-making process, regardless of whether 'can_answer' is true or false.",
+        FORMATTING,
+        LATEX_FORMATTING,
+        CITATION_FORMATTING,
+        "TIMEZONE_CONVERSION: When answering queries involving dates, times, or schedules, convert any UTC timestamps provided in the context to the user's local time zone if their timezone offset is included in 'context'.",
+        "PROACTIVE_ENGAGEMENT: When 'can_answer' is true, always end your response with a relevant, proactive follow-up question related to the topic. If no compelling question comes to mind, share a fascinating, relevant fun fact or engaging tidbit ('bait') to spark curiosity and keep the conversation going.",
+        POLICY_RESTRICTIONS,
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        can_answer: "boolean",
+        answer: "string",
+        reasoning: "string",
+        detected_language: "string"
+      }
+    }
+  }
+});
+export {
+  fastResponder
+};

package/dist/services/agent/loops/shared/skills/final-responder.d.ts

@@ -0,0 +1,7 @@
+import { Skill } from '../../../skills/skill';
+type ResponseSchema = {
+    final_response: string;
+    reasoning: string;
+};
+export declare const finalResponder: Skill<ResponseSchema>;
+export {};

package/dist/services/agent/loops/shared/skills/final-responder.js

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var final_responder_exports = {};
+__export(final_responder_exports, {
+  finalResponder: () => finalResponder
+});
+module.exports = __toCommonJS(final_responder_exports);
+var import_skill = require("../../../skills/skill");
+var import_shared_rules = require("../../../skills/shared/shared-rules");
+const finalResponder = new import_skill.Skill({
+  name: "final_responder",
+  version: "1.0.0",
+  description: "Synthesizes tool execution results, scratchpad, and context state into a clear, natural, user-facing final response.",
+  temperature: 0.3,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Synthesize the user's initial goal, extracted entities, and technical tool execution results into a comprehensive, helpful, and naturally formatted final response for the user.",
+      role: "Final synthesis and communication engine",
+      logic_rules: [
+        "RESULT_SYNTHESIS: Review all tool execution results, outputs, and scratchpad context to build a clear, coherent answer addressing the user's original goal.",
+        "USER_LANGUAGE_MATCHING: Always draft 'final_response' in the language used by the user in their original input or conversation history.",
+        import_shared_rules.FORMATTING,
+        import_shared_rules.LATEX_FORMATTING,
+        import_shared_rules.CITATION_FORMATTING,
+        "PROACTIVE_ENGAGEMENT: When 'can_answer' is true, always end your response with a relevant, proactive follow-up question related to the topic. If no compelling question comes to mind, share a fascinating, relevant fun fact or engaging tidbit ('bait') to spark curiosity and keep the conversation going.",
+        "ERROR_HANDLING: If tool executions failed or yielded partial results, communicate what was accomplished and what failed gracefully without exposing internal raw stack traces unless relevant.",
+        "REASONING_LOG: Provide a concise logical summary of how the final answer was constructed from the tool outputs in 'reasoning' strictly in English.",
+        "STRICT_ENGLISH_REASONING: The 'reasoning' field MUST strictly be written in English, while 'final_response' MUST match the user's language.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        final_response: "string",
+        reasoning: "string"
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  finalResponder
+});

package/dist/services/agent/loops/shared/skills/final-responder.mjs

@@ -0,0 +1,34 @@
+import "../../../../../chunk-XRJFNASX.mjs";
+import { Skill } from "../../../skills/skill";
+import { FORMATTING, LATEX_FORMATTING, CITATION_FORMATTING } from "../../../skills/shared/shared-rules";
+const finalResponder = new Skill({
+  name: "final_responder",
+  version: "1.0.0",
+  description: "Synthesizes tool execution results, scratchpad, and context state into a clear, natural, user-facing final response.",
+  temperature: 0.3,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Synthesize the user's initial goal, extracted entities, and technical tool execution results into a comprehensive, helpful, and naturally formatted final response for the user.",
+      role: "Final synthesis and communication engine",
+      logic_rules: [
+        "RESULT_SYNTHESIS: Review all tool execution results, outputs, and scratchpad context to build a clear, coherent answer addressing the user's original goal.",
+        "USER_LANGUAGE_MATCHING: Always draft 'final_response' in the language used by the user in their original input or conversation history.",
+        FORMATTING,
+        LATEX_FORMATTING,
+        CITATION_FORMATTING,
+        "PROACTIVE_ENGAGEMENT: When 'can_answer' is true, always end your response with a relevant, proactive follow-up question related to the topic. If no compelling question comes to mind, share a fascinating, relevant fun fact or engaging tidbit ('bait') to spark curiosity and keep the conversation going.",
+        "ERROR_HANDLING: If tool executions failed or yielded partial results, communicate what was accomplished and what failed gracefully without exposing internal raw stack traces unless relevant.",
+        "REASONING_LOG: Provide a concise logical summary of how the final answer was constructed from the tool outputs in 'reasoning' strictly in English.",
+        "STRICT_ENGLISH_REASONING: The 'reasoning' field MUST strictly be written in English, while 'final_response' MUST match the user's language.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        final_response: "string",
+        reasoning: "string"
+      }
+    }
+  }
+});
+export {
+  finalResponder
+};

package/dist/services/agent/loops/shared/skills/index.d.ts

@@ -0,0 +1,6 @@
+export * from './action-planner';
+export * from './confirmation-gate';
+export * from './fast-responder';
+export * from './final-responder';
+export * from './state-observer';
+export * from './strategy-engine';

package/dist/services/agent/loops/shared/skills/index.js

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var skills_exports = {};
+module.exports = __toCommonJS(skills_exports);
+__reExport(skills_exports, require("./action-planner"), module.exports);
+__reExport(skills_exports, require("./confirmation-gate"), module.exports);
+__reExport(skills_exports, require("./fast-responder"), module.exports);
+__reExport(skills_exports, require("./final-responder"), module.exports);
+__reExport(skills_exports, require("./state-observer"), module.exports);
+__reExport(skills_exports, require("./strategy-engine"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./action-planner"),
+  ...require("./confirmation-gate"),
+  ...require("./fast-responder"),
+  ...require("./final-responder"),
+  ...require("./state-observer"),
+  ...require("./strategy-engine")
+});

package/dist/services/agent/loops/shared/skills/index.mjs

@@ -0,0 +1,6 @@
+export * from "./action-planner";
+export * from "./confirmation-gate";
+export * from "./fast-responder";
+export * from "./final-responder";
+export * from "./state-observer";
+export * from "./strategy-engine";

package/dist/services/agent/loops/shared/skills/state-observer.d.ts

@@ -0,0 +1,10 @@
+import { Skill } from '../../../skills/skill';
+type StateObserverResponseSchema = {
+    action: 'CONTINUE' | 'REPLAN' | 'ASK_USER' | 'FINISH';
+    feedback_for_planner: string;
+    user_prompt: string;
+    detected_language: string;
+    reasoning: string;
+};
+export declare const stateObserver: Skill<StateObserverResponseSchema>;
+export {};

package/dist/services/agent/loops/shared/skills/state-observer.js

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var state_observer_exports = {};
+__export(state_observer_exports, {
+  stateObserver: () => stateObserver
+});
+module.exports = __toCommonJS(state_observer_exports);
+var import_skill = require("../../../skills/skill");
+const stateObserver = new import_skill.Skill({
+  name: "state_observer",
+  version: "1.1.0",
+  description: "Evaluates the execution output of a tool step against the overall user intent. Determines whether to proceed, replan, ask the user, or finish.",
+  temperature: 0.1,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Analyze the execution result of the latest executed tool step alongside the original user intent, remaining plan steps, and extracted entities. Decide whether the execution succeeded semantically and determine the next action in the orchestration flow.",
+      role: "Execution state observer, semantic error evaluator, and dynamic replanning controller agent",
+      logic_rules: [
+        "STEP_OUTPUT_ANALYSIS: Inspect 'executed_step'. Check both technical status (COMPLETED vs FAILED) and semantic content of 'output'. Identify if the tool returned empty data, permission errors, business logic failures, or unrecoverable exceptions.",
+        "EVALUATE_CONTINUE: If the step status is 'COMPLETED' and the 'output' contains valid, expected data required for subsequent steps: 1) Set 'action' to 'CONTINUE', 2) Set 'feedback_for_planner' to '', 3) Set 'user_prompt' to ''.",
+        "EVALUATE_FINISH: If the step status is 'COMPLETED' and the output fully answers the user's intent, rendering remaining planned steps unnecessary: 1) Set 'action' to 'FINISH', 2) Set 'feedback_for_planner' to '', 3) Set 'user_prompt' to ''.",
+        "EVALUATE_REPLAN: If the step status is 'FAILED', OR if the tool output is empty/invalid, OR if the data returned drastically alters the context/assumptions required for remaining steps: 1) Set 'action' to 'REPLAN', 2) Provide detailed, actionable diagnostic feedback in 'feedback_for_planner' in English explaining why the step failed or what new constraints were discovered, 3) Set 'user_prompt' to ''.",
+        "EVALUATE_ASK_USER: If the tool output explicitly indicates that user intervention, a missing secret, an auth confirmation, or a decision choice is required to proceed: 1) Set 'action' to 'ASK_USER', 2) Set 'feedback_for_planner' to '', 3) Generate a clear, direct prompt in 'user_prompt' written in 'detected_language' asking the user for the necessary input.",
+        "LANGUAGE_DETECTION: Detect the primary language of the user input/context and output its ISO 639-1 code in 'detected_language' (e.g., 'es', 'en', 'pt').",
+        "LANGUAGE_ENFORCEMENT: ONLY 'user_prompt' MUST be written in the language specified in 'detected_language'. ALL OTHER fields ('feedback_for_planner', 'detected_language', and 'reasoning') MUST strictly be written in English.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        action: "string (CONTINUE | REPLAN | ASK_USER | FINISH)",
+        feedback_for_planner: "string",
+        user_prompt: "string",
+        detected_language: "string",
+        reasoning: "string"
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  stateObserver
+});

package/dist/services/agent/loops/shared/skills/state-observer.mjs

@@ -0,0 +1,34 @@
+import "../../../../../chunk-XRJFNASX.mjs";
+import { Skill } from "../../../skills/skill";
+const stateObserver = new Skill({
+  name: "state_observer",
+  version: "1.1.0",
+  description: "Evaluates the execution output of a tool step against the overall user intent. Determines whether to proceed, replan, ask the user, or finish.",
+  temperature: 0.1,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Analyze the execution result of the latest executed tool step alongside the original user intent, remaining plan steps, and extracted entities. Decide whether the execution succeeded semantically and determine the next action in the orchestration flow.",
+      role: "Execution state observer, semantic error evaluator, and dynamic replanning controller agent",
+      logic_rules: [
+        "STEP_OUTPUT_ANALYSIS: Inspect 'executed_step'. Check both technical status (COMPLETED vs FAILED) and semantic content of 'output'. Identify if the tool returned empty data, permission errors, business logic failures, or unrecoverable exceptions.",
+        "EVALUATE_CONTINUE: If the step status is 'COMPLETED' and the 'output' contains valid, expected data required for subsequent steps: 1) Set 'action' to 'CONTINUE', 2) Set 'feedback_for_planner' to '', 3) Set 'user_prompt' to ''.",
+        "EVALUATE_FINISH: If the step status is 'COMPLETED' and the output fully answers the user's intent, rendering remaining planned steps unnecessary: 1) Set 'action' to 'FINISH', 2) Set 'feedback_for_planner' to '', 3) Set 'user_prompt' to ''.",
+        "EVALUATE_REPLAN: If the step status is 'FAILED', OR if the tool output is empty/invalid, OR if the data returned drastically alters the context/assumptions required for remaining steps: 1) Set 'action' to 'REPLAN', 2) Provide detailed, actionable diagnostic feedback in 'feedback_for_planner' in English explaining why the step failed or what new constraints were discovered, 3) Set 'user_prompt' to ''.",
+        "EVALUATE_ASK_USER: If the tool output explicitly indicates that user intervention, a missing secret, an auth confirmation, or a decision choice is required to proceed: 1) Set 'action' to 'ASK_USER', 2) Set 'feedback_for_planner' to '', 3) Generate a clear, direct prompt in 'user_prompt' written in 'detected_language' asking the user for the necessary input.",
+        "LANGUAGE_DETECTION: Detect the primary language of the user input/context and output its ISO 639-1 code in 'detected_language' (e.g., 'es', 'en', 'pt').",
+        "LANGUAGE_ENFORCEMENT: ONLY 'user_prompt' MUST be written in the language specified in 'detected_language'. ALL OTHER fields ('feedback_for_planner', 'detected_language', and 'reasoning') MUST strictly be written in English.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        action: "string (CONTINUE | REPLAN | ASK_USER | FINISH)",
+        feedback_for_planner: "string",
+        user_prompt: "string",
+        detected_language: "string",
+        reasoning: "string"
+      }
+    }
+  }
+});
+export {
+  stateObserver
+};

package/dist/services/agent/loops/shared/skills/strategy-engine.d.ts

@@ -0,0 +1,15 @@
+import { Skill } from '../../../skills/skill';
+type ResponseSchema = {
+    goal: string;
+    hypothesis: string;
+    required_capabilities: string[];
+    tool_keywords: Array<{
+        keyword: string;
+        weight: number;
+    }>;
+    detected_language: string;
+    reasoning: string;
+    is_continuation: boolean;
+};
+export declare const strategyEngine: Skill<ResponseSchema>;
+export {};

package/dist/services/agent/loops/shared/skills/strategy-engine.js

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var strategy_engine_exports = {};
+__export(strategy_engine_exports, {
+  strategyEngine: () => strategyEngine
+});
+module.exports = __toCommonJS(strategy_engine_exports);
+var import_skill = require("../../../skills/skill");
+const strategyEngine = new import_skill.Skill({
+  name: "strategy_engine",
+  version: "1.3.0",
+  description: "Analyzes user goals, chat history, and past tasks to formulate high-level strategies, required capabilities, weighted tool discovery keywords, execution hypotheses, and Task continuity detection.",
+  temperature: 0.2,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Analyze the user's intent, conversation context, and last completed task to establish a high-level execution goal, a logical hypothesis, required system capabilities, weighted keywords to match available tools, and determine whether the message continues a previous task.",
+      role: "Strategic reasoning, capability mapping, tool discovery, and task continuity engine",
+      logic_rules: [
+        "TASK_CONTINUATION_DETECTION: Set 'is_continuation' to true ONLY if 'last_completed_task' is provided in context AND the user's current message directly references, follows up on, or modifies that specific previous task. Set to false if the user introduces a completely new goal or independent topic.",
+        "GOAL_REFINEMENT: Refine and summarize the ultimate goal of the user into 'goal' strictly in English, resolving references from chat history if present.",
+        "HYPOTHESIS_FORMULATION: Formulate a clear, step-by-step strategic hypothesis in 'hypothesis' in English explaining how the goal can be achieved logically.",
+        "CAPABILITY_MAPPING: Identify and list all functional system capabilities or domain requirements needed in 'required_capabilities' in English (e.g., ['calendar_access', 'data_parsing', 'web_search']).",
+        "TOOL_KEYWORD_EXTRACTION: Extract 4 to 8 single-word terms (no multi-word patterns or underscores) in English targeting functional backend tools. Always prioritize domain nouns (e.g., 'expense', 'transaction', 'finance', 'budget', 'search', 'weather'). Include target third-party platforms or services if explicitly mentioned or strongly implied (e.g., 'slack', 'jira', 'github', 'google') with lower weight. DO NOT extract specific dynamic entities or transactional values (e.g., 'McDonalds', '10 USD'). Assign a float 'weight' from 0.1 to 1.0 (0.9-1.0 for core domain nouns and primary action verbs; 0.5-0.7 for secondary/broader domain concepts; 0.3-0.5 for third-party platforms/services; 0.1-0.3 for generic operations).",
+        "LANGUAGE_DETECTION: Detect the primary language of the user input and output its ISO 639-1 code in 'detected_language' (e.g., 'es', 'en', 'pt').",
+        "REASONING_LOG: Provide a concise, step-by-step logical justification of the proposed strategy in 'reasoning' strictly in English.",
+        "STRICT_ENGLISH_OUTPUT: ALL output fields ('goal', 'hypothesis', 'required_capabilities', 'tool_keywords' keywords, and 'reasoning') MUST strictly be written in English, regardless of the user input language.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        goal: "string",
+        hypothesis: "string",
+        required_capabilities: "array of strings",
+        tool_keywords: "array of objects with fields 'keyword' (string) and 'weight' (number between 0.1 and 1.0)",
+        detected_language: "string",
+        reasoning: "string",
+        is_continuation: "boolean"
+      }
+    }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  strategyEngine
+});

package/dist/services/agent/loops/shared/skills/strategy-engine.mjs

@@ -0,0 +1,37 @@
+import "../../../../../chunk-XRJFNASX.mjs";
+import { Skill } from "../../../skills/skill";
+const strategyEngine = new Skill({
+  name: "strategy_engine",
+  version: "1.3.0",
+  description: "Analyzes user goals, chat history, and past tasks to formulate high-level strategies, required capabilities, weighted tool discovery keywords, execution hypotheses, and Task continuity detection.",
+  temperature: 0.2,
+  systemInstructions: {
+    instruction_set: {
+      goal: "Analyze the user's intent, conversation context, and last completed task to establish a high-level execution goal, a logical hypothesis, required system capabilities, weighted keywords to match available tools, and determine whether the message continues a previous task.",
+      role: "Strategic reasoning, capability mapping, tool discovery, and task continuity engine",
+      logic_rules: [
+        "TASK_CONTINUATION_DETECTION: Set 'is_continuation' to true ONLY if 'last_completed_task' is provided in context AND the user's current message directly references, follows up on, or modifies that specific previous task. Set to false if the user introduces a completely new goal or independent topic.",
+        "GOAL_REFINEMENT: Refine and summarize the ultimate goal of the user into 'goal' strictly in English, resolving references from chat history if present.",
+        "HYPOTHESIS_FORMULATION: Formulate a clear, step-by-step strategic hypothesis in 'hypothesis' in English explaining how the goal can be achieved logically.",
+        "CAPABILITY_MAPPING: Identify and list all functional system capabilities or domain requirements needed in 'required_capabilities' in English (e.g., ['calendar_access', 'data_parsing', 'web_search']).",
+        "TOOL_KEYWORD_EXTRACTION: Extract 4 to 8 single-word terms (no multi-word patterns or underscores) in English targeting functional backend tools. Always prioritize domain nouns (e.g., 'expense', 'transaction', 'finance', 'budget', 'search', 'weather'). Include target third-party platforms or services if explicitly mentioned or strongly implied (e.g., 'slack', 'jira', 'github', 'google') with lower weight. DO NOT extract specific dynamic entities or transactional values (e.g., 'McDonalds', '10 USD'). Assign a float 'weight' from 0.1 to 1.0 (0.9-1.0 for core domain nouns and primary action verbs; 0.5-0.7 for secondary/broader domain concepts; 0.3-0.5 for third-party platforms/services; 0.1-0.3 for generic operations).",
+        "LANGUAGE_DETECTION: Detect the primary language of the user input and output its ISO 639-1 code in 'detected_language' (e.g., 'es', 'en', 'pt').",
+        "REASONING_LOG: Provide a concise, step-by-step logical justification of the proposed strategy in 'reasoning' strictly in English.",
+        "STRICT_ENGLISH_OUTPUT: ALL output fields ('goal', 'hypothesis', 'required_capabilities', 'tool_keywords' keywords, and 'reasoning') MUST strictly be written in English, regardless of the user input language.",
+        "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+      ],
+      response_schema: {
+        goal: "string",
+        hypothesis: "string",
+        required_capabilities: "array of strings",
+        tool_keywords: "array of objects with fields 'keyword' (string) and 'weight' (number between 0.1 and 1.0)",
+        detected_language: "string",
+        reasoning: "string",
+        is_continuation: "boolean"
+      }
+    }
+  }
+});
+export {
+  strategyEngine
+};