openloops 0.1.0

package/dist/src/services/agent/loops/plan-execute/plan-execute-loop.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanExecuteLoop = void 0;
+const core_1 = require("../../core/index.js");
+const skills_1 = require("../shared/skills");
+const MAX_STEP_RETRIES = 2;
+class PlanExecuteLoop extends core_1.AgentLoop {
+    get initialNode() {
+        return this.nodes.fast_responder;
+    }
+    get nodes() {
+        return {
+            fast_responder: this.fastResponder,
+            strategy_engine: this.strategyEngine,
+            action_planner: this.actionPlanner,
+            execution_loop: this.executionLoop,
+            state_observer: this.executionObserver,
+            final_responder: this.finalResponder,
+            confirmation_gate: this.confirmationGate,
+        };
+    }
+    get name() {
+        return 'plan_execute';
+    }
+    get version() {
+        return '1.0.0';
+    }
+    get author() {
+        return {
+            name: 'Jose Barcos',
+            email: 'jose@openloops.xyz',
+            website: 'https://openloops.xyz/jose'
+        };
+    }
+    async fastResponder(ctx) {
+        ctx.chat.state?.setCurrentActivity('Analyzing requirement...');
+        const chat_history = ctx.chat.lastHistoryMessages();
+        const result = await skills_1.fastResponder.run({
+            ...ctx.skillParams,
+            contextInjection: {
+                ...(chat_history?.length ? { chat_history } : {}),
+            },
+        });
+        ctx.chat.state?.setLanguage(result.detected_language);
+        if (!result.can_answer) {
+            ctx.setNextNode(this.nodes.strategy_engine);
+        }
+        else {
+            ctx.chat.state?.setStatus(core_1.AgentStatus.IDLE);
+            ctx.setNextNode(this.nodes.fast_responder);
+            ctx.reply(result.answer ?? '');
+        }
+    }
+    async strategyEngine(ctx) {
+        ctx.chat.state?.setCurrentActivity('Designing strategy...');
+        const lastCompletedTask = ctx.task ? undefined : ctx.chat.lastCompletedTask();
+        const chatHistory = ctx.chat.lastHistoryMessages();
+        const result = await skills_1.strategyEngine.run({
+            ...ctx.skillParams,
+            contextInjection: {
+                user_goal: ctx.currentMessage,
+                ...(chatHistory?.length ? { chat_history: chatHistory } : {}),
+                ...(lastCompletedTask
+                    ? { last_completed_task: { goal: lastCompletedTask.goal, summary: lastCompletedTask.summary } }
+                    : {}),
+            },
+        });
+        ctx.chat.state?.setLanguage(result.detected_language);
+        const task = result.is_continuation && lastCompletedTask
+            ? ctx.chat.reopenTask(lastCompletedTask.id)
+            : ctx.chat.createTask(result.goal ?? ctx.currentMessage);
+        ctx.chat.context.addContext({
+            taskId: task.id,
+            meta: { name: 'strategy', type: 'artifact', shortDescription: 'High-level strategy for the active task' },
+            content: result,
+        });
+        ctx.setNextNode(this.nodes.action_planner);
+    }
+    async actionPlanner(ctx) {
+        ctx.chat.state?.setCurrentActivity('Creating action plan...');
+        const task = ctx.task;
+        const strategy = ctx.chat.context.lastContext({ taskId: task.id, name: 'strategy' })?.content;
+        const tools = ctx.searchTools(strategy?.tool_keywords ?? []);
+        const result = await skills_1.actionPlanner.run({
+            ...ctx.skillParams,
+            contextInjection: {
+                active_task: {
+                    user_goal: task.goal,
+                    strategy: strategy?.hypothesis,
+                    required_capabilities: strategy?.required_capabilities,
+                },
+                tools,
+            },
+        });
+        const enqueueSteps = (steps) => steps.map(step => task.addAction({
+            name: step.tool_name,
+            stepId: String(step.step_id),
+            args: step.args ?? step.arguments,
+            dependsOn: step.depends_on?.map(String),
+            author: 'action_planner',
+        }));
+        switch (result.plan_status) {
+            case 'MISSING_TOOLS':
+                ctx.chat.state?.setStatus(core_1.AgentStatus.AWAITING_USER_INPUT);
+                ctx.chat.failTask(task.id);
+                ctx.setNextNode(undefined);
+                ctx.reply(result.user_response);
+                break;
+            case 'NEEDS_CLARIFICATION':
+                ctx.chat.state?.setStatus(core_1.AgentStatus.AWAITING_USER_INPUT);
+                ctx.setNextNode(undefined);
+                ctx.reply(result.clarification_prompt);
+                break;
+            case 'NEEDS_CONFIRMATION': {
+                enqueueSteps(result.steps);
+                const actionsList = (result.confirmation_details?.actions ?? [])
+                    .map(action => `- ${action.description}`)
+                    .join('\n');
+                ctx.chat.state?.setStatus(core_1.AgentStatus.AWAITING_USER_CONFIRMATION);
+                ctx.setNextNode(this.nodes.confirmation_gate);
+                ctx.reply([
+                    result.clarification_prompt,
+                    result.confirmation_details?.impact_summary,
+                    actionsList,
+                    result.confirmation_details?.confirm_label,
+                ].filter(Boolean).join('\n\n'));
+                break;
+            }
+            case 'SUCCESS':
+                enqueueSteps(result.steps);
+                ctx.setNextNode(this.nodes.execution_loop);
+                break;
+        }
+    }
+    async executionLoop(ctx) {
+        const task = ctx.task;
+        const [next] = task.readyActions;
+        if (!next) {
+            ctx.setNextNode(this.nodes.final_responder);
+            return;
+        }
+        ctx.chat.state?.setCurrentActivity(`Running ${next.name}...`);
+        const tool = ctx.tools.find(t => t.name === next.name);
+        const executed = await task.runReadyAction(next.id, tool, ctx.chat.context, ctx.baseParams);
+        if (executed.status === 'failed' && (executed.retries ?? 0) < MAX_STEP_RETRIES) {
+            executed.incrementRetries();
+            executed.resetForRetry();
+            ctx.setNextNode(this.nodes.execution_loop);
+            return;
+        }
+        ctx.setNextNode(this.nodes.state_observer);
+    }
+    async confirmationGate(ctx) {
+        const task = ctx.task;
+        const result = await skills_1.confirmationGate.run({
+            ...ctx.skillParams,
+            contextInjection: {
+                ...(ctx.chat.lastAnswer ? { pending_confirmation: ctx.chat.lastAnswer } : {}),
+            },
+        });
+        switch (result.decision) {
+            case 'CONFIRMED':
+                ctx.chat.state?.setStatus(core_1.AgentStatus.PROCESSING);
+                ctx.setNextNode(this.nodes.execution_loop);
+                break;
+            case 'DECLINED':
+                ctx.chat.cancelTask(task.id);
+                ctx.chat.state?.setStatus(core_1.AgentStatus.IDLE);
+                ctx.setNextNode(this.nodes.fast_responder);
+                ctx.reply(result.acknowledgement);
+                break;
+            case 'UNCLEAR':
+            default:
+                ctx.chat.state?.setStatus(core_1.AgentStatus.AWAITING_USER_CONFIRMATION);
+                ctx.setNextNode(this.nodes.confirmation_gate);
+                ctx.reply(result.clarification_prompt);
+                break;
+        }
+    }
+    async executionObserver(ctx) {
+        const task = ctx.task;
+        const lastAction = task.lastExecutedAction;
+        const result = await skills_1.stateObserver.run({
+            ...ctx.skillParams,
+            contextInjection: {
+                user_intent: task.goal,
+                executed_step: lastAction?.toJSON(),
+                remaining_steps: task.readyActions.map(a => a.toJSON()),
+            },
+        });
+        ctx.chat.state?.setCurrentActivity(result.reasoning);
+        switch (result.action) {
+            case 'REPLAN':
+                ctx.setNextNode(this.nodes.action_planner);
+                break;
+            case 'ASK_USER':
+                ctx.chat.state?.setStatus(core_1.AgentStatus.AWAITING_USER_INPUT);
+                ctx.setNextNode(undefined);
+                ctx.reply(result.user_prompt ?? '');
+                break;
+            case 'CONTINUE':
+            default: {
+                const stillPending = task.actions.some(a => a.status === 'pending');
+                ctx.setNextNode(stillPending ? this.nodes.execution_loop : this.nodes.final_responder);
+                break;
+            }
+        }
+    }
+    async finalResponder(ctx) {
+        ctx.chat.state?.setCurrentActivity('Generating final response...');
+        const task = ctx.task;
+        const executionResults = task.actions
+            .map(a => ({ tool_name: a.name, args: a.args, output: a.output, status: a.status }));
+        const result = await skills_1.finalResponder.run({
+            ...ctx.skillParams,
+            contextInjection: {
+                user_goal: task.goal,
+                execution_results: executionResults,
+            },
+        });
+        ctx.reply(result.final_response ?? '');
+        ctx.chat.completeTask(task.id, result.reasoning);
+        ctx.chat.state?.setStatus(core_1.AgentStatus.IDLE);
+        ctx.setNextNode(this.nodes.fast_responder);
+    }
+}
+exports.PlanExecuteLoop = PlanExecuteLoop;
+//# sourceMappingURL=plan-execute-loop.js.map

package/dist/src/services/agent/loops/plan-execute/plan-execute-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-execute-loop.js","sourceRoot":"","sources":["../../../../../../src/services/agent/loops/plan-execute/plan-execute-loop.ts"],"names":[],"mappings":"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"}

package/dist/src/services/agent/loops/shared/skills/action-planner.d.ts

@@ -0,0 +1,35 @@
+import { Skill } from '../../../skills/skill';
+interface PlanStepOutput {
+    step_id: number;
+    tool_name: string;
+    arguments: Record<string, any>;
+    expected_outcome: string;
+    status: 'READY' | 'MISSING_PARAMS' | 'REQUIRES_CONFIRMATION' | 'COMPLETED' | 'FAILED';
+    is_destructive: boolean;
+    missing_fields: string[];
+    rationale: string;
+    depends_on_steps: number[];
+    output: Record<string, any>;
+}
+interface ConfirmationDetails {
+    actions: Array<{
+        step_id: number;
+        description: string;
+    }>;
+    impact_summary: string;
+    confirm_label: string;
+}
+type ResponseSchema = {
+    plan_status: 'SUCCESS' | 'MISSING_TOOLS' | 'NEEDS_CLARIFICATION' | 'NEEDS_CONFIRMATION';
+    current_step_index: number;
+    missing_tools_explanation: string;
+    user_response: string;
+    steps: PlanStepOutput[];
+    needs_clarification: boolean;
+    missing_entities: string[];
+    clarification_prompt: string;
+    confirmation_details: ConfirmationDetails | null;
+    reasoning: string;
+};
+export declare const actionPlanner: Skill<ResponseSchema>;
+export {};

package/dist/src/services/agent/loops/shared/skills/action-planner.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actionPlanner = void 0;
+const skill_1 = require("../../../skills/skill");
+exports.actionPlanner = new skill_1.Skill({
+    name: 'action_planner',
+    version: '1.6.2',
+    description: 'Generates an ordered step-by-step tool execution plan based on IntentContext and candidate tools schema. Flags missing tools, missing required execution parameters, or steps requiring user confirmation for destructive actions.',
+    temperature: 0.1,
+    systemInstructions: {
+        instruction_set: {
+            goal: "Evaluate userIntent, extracted_entities, and candidate tools to output a structured execution plan. Detect missing capabilities, missing tool arguments, or destructive tool executions and ask for clarification or confirmation when necessary.",
+            role: "Action planning, tool mapping, argument mapping, and execution strategy agent",
+            logic_rules: [
+                "TOOL_EVALUATION: Analyze available tool schemas against userIntent and extracted_entities in IntentContext. Select only the necessary tools required to achieve the goal.",
+                "MISSING_TOOLS_CHECK: If no candidate tools fit the intent, or if essential actions cannot be mapped to any available tool: 1) Set 'plan_status' to 'MISSING_TOOLS', 2) Set 'current_step_index' to 0, 3) Provide a technical explanation in 'missing_tools_explanation' in English, 4) Generate a polite message in 'user_response' written in 'detected_language' explaining that no connected tools/integrations were found to complete the request and suggest checking their active integrations, 5) Set 'steps' to [], 6) Set 'needs_clarification' to false, 'missing_entities' to [], 'clarification_prompt' to '', and 'confirmation_details' to null.",
+                "STEP_PLANNING: If tools are available, sequence them logically in 'steps'. Assign incremental 'step_id' starting at 1. Set 'current_step_index' to 0 by default. Explicitly list any prerequisite step IDs in 'depends_on_steps' if a step requires output from a prior step. Define a clear 'expected_outcome' describing the precise expected result or data state after this step runs.",
+                "ARGUMENT_MAPPING: Map extracted_entities and execution context (e.g., CONTEXT metadata like 'now_utc', 'now_local', 'timezone', user_details, and session_details) to tool parameters in 'arguments'. For relative time/date expressions (e.g., 'today', 'afternoon', 'yesterday at 4:30pm'), calculate and resolve the precise value (such as ISO 8601 strings) using the provided reference timestamp and timezone. If a parameter value comes from a future step execution output, represent it as a JSON reference string (e.g., '{{step_1.output.id}}').",
+                "PARAMETER_AND_SAFETY_VALIDATION: For each step, inspect the candidate tool schema properties and flags:",
+                "1) Set 'is_destructive' to match the candidate tool's 'destructive' boolean flag.",
+                "2) If any required parameter is MISSING and CANNOT be derived from CONTEXT: Set step 'status' to 'MISSING_PARAMS' and list the missing keys in 'missing_fields'.",
+                "3) If ALL required parameters are present BUT 'is_destructive' is true: Set step 'status' to 'REQUIRES_CONFIRMATION' and 'missing_fields' to [].",
+                "4) If ALL required parameters are present and 'is_destructive' is false: Set step 'status' to 'READY' and 'missing_fields' to [].",
+                "CLARIFICATION_CHECK: If ANY step has status 'MISSING_PARAMS': 1) Set 'plan_status' to 'NEEDS_CLARIFICATION', 2) Set 'needs_clarification' to true, 3) Collect all unresolvable parameters in 'missing_entities' in English, 4) Provide a short, direct, and polite question in 'clarification_prompt' written in 'detected_language', 5) Set 'user_response' to '', and 'confirmation_details' to null.",
+                "CONFIRMATION_CHECK: If NO step has 'MISSING_PARAMS' BUT at least one step has status 'REQUIRES_CONFIRMATION': 1) Set 'plan_status' to 'NEEDS_CONFIRMATION', 2) Set 'needs_clarification' to false, 3) Set 'missing_entities' to [], 4) Populate 'confirmation_details' with: 'actions' (one entry per step with status 'REQUIRES_CONFIRMATION', each with that step's 'step_id' and a short natural-language 'description' of exactly what it will do, naming the action and its target — never the raw tool name or parameter keys), 'impact_summary' summarizing the overall permanent changes in plain terms, and 'confirm_label' — a short call-to-action asking the user to approve or decline; this will always be shown as the LAST line of the message, so it must stand on its own as the actual yes/no ask, 5) Provide context in 'clarification_prompt' introducing why confirmation is needed — this field must NOT itself ask a yes/no question, since 'confirm_label' is the only field that does that, 6) Set 'user_response' to ''. CRITICAL: every piece of text produced in this rule ('actions[].description', 'impact_summary', 'confirm_label', 'clarification_prompt') MUST be written in 'detected_language' — never default to English here regardless of the language used anywhere else in this instruction set.",
+                "SUCCESS_STATE: If all steps are 'READY' and no tools are missing or requiring confirmation: 1) Set 'plan_status' to 'SUCCESS', 2) Set 'missing_tools_explanation' to '', 3) Set 'user_response' to '', 4) Set 'needs_clarification' to false, 'missing_entities' to [], 'clarification_prompt' to '', and 'confirmation_details' to null.",
+                "LANGUAGE_ENFORCEMENT: ONLY 'clarification_prompt', 'user_response', and every field inside 'confirmation_details' (including each entry's 'description') MUST be written in the user's actual conversation language — use CONTEXT.detected_language when present; only fall back to CONTEXT.user_details.preferred_language if 'detected_language' is absent. 'preferred_language' is the app's configured display language and does NOT necessarily match the language the user is typing in right now — never prefer it over 'detected_language' when both exist. These are the only fields the end user actually reads before approving or declining. ALL OTHER fields ('missing_tools_explanation', step 'rationale', step 'expected_outcome', 'missing_entities', and 'reasoning') MUST strictly be written in English.",
+                "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+            ],
+            response_schema: {
+                plan_status: "string (SUCCESS | MISSING_TOOLS | NEEDS_CLARIFICATION | NEEDS_CONFIRMATION)",
+                missing_tools_explanation: "string",
+                user_response: "string",
+                steps: "array of objects with fields 'step_id' (number), 'tool_name' (string), 'arguments' (object), 'expected_outcome' (string), 'status' ('READY' | 'MISSING_PARAMS' | 'REQUIRES_CONFIRMATION'), 'is_destructive' (boolean), 'missing_fields' (array of strings), 'rationale' (string), 'depends_on_steps' (array of numbers)",
+                needs_clarification: "boolean",
+                missing_entities: "array of strings",
+                clarification_prompt: "string",
+                confirmation_details: "object containing 'actions' (array of objects with 'step_id' (number) and 'description' (string, natural language, in the user's detected_language)), 'impact_summary' (string, in the user's detected_language), and 'confirm_label' (short string, in the user's detected_language) — or null",
+                reasoning: "string"
+            }
+        }
+    }
+});
+//# sourceMappingURL=action-planner.js.map

package/dist/src/services/agent/loops/shared/skills/action-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-planner.js","sourceRoot":"","sources":["../../../../../../../src/services/agent/loops/shared/skills/action-planner.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAkChC,QAAA,aAAa,GAAG,IAAI,aAAK,CAAiB;IACnD,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,oOAAoO;IACjP,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE;QAChB,eAAe,EAAE;YACb,IAAI,EAAE,mPAAmP;YACzP,IAAI,EAAE,+EAA+E;YACrF,WAAW,EAAE;gBACT,2KAA2K;gBAC3K,goBAAgoB;gBAChoB,4XAA4X;gBAC5X,+hBAA+hB;gBAC/hB,yGAAyG;gBACzG,mFAAmF;gBACnF,kKAAkK;gBAClK,kJAAkJ;gBAClJ,mIAAmI;gBACnI,yYAAyY;gBACzY,4wCAA4wC;gBAC5wC,2UAA2U;gBAC3U,8xBAA8xB;gBAC9xB,sEAAsE;aACzE;YACD,eAAe,EAAE;gBACb,WAAW,EAAE,6EAA6E;gBAE1F,yBAAyB,EAAE,QAAQ;gBACnC,aAAa,EAAE,QAAQ;gBACvB,KAAK,EAAE,yTAAyT;gBAChU,mBAAmB,EAAE,SAAS;gBAC9B,gBAAgB,EAAE,kBAAkB;gBACpC,oBAAoB,EAAE,QAAQ;gBAC9B,oBAAoB,EAAE,iSAAiS;gBACvT,SAAS,EAAE,QAAQ;aACtB;SACJ;KACJ;CACJ,CAAC,CAAA"}

package/dist/src/services/agent/loops/shared/skills/confirmation-gate.d.ts

@@ -0,0 +1,9 @@
+import { Skill } from '../../../skills/skill';
+type ResponseSchema = {
+    decision: 'CONFIRMED' | 'DECLINED' | 'UNCLEAR';
+    reasoning: string;
+    acknowledgement: string;
+    clarification_prompt: string;
+};
+export declare const confirmationGate: Skill<ResponseSchema>;
+export {};

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmationGate = void 0;
+const skill_1 = require("../../../skills/skill");
+exports.confirmationGate = new skill_1.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 — 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 — 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 — only when decision is DECLINED, in the user's actual conversation language",
+                clarification_prompt: "string — only when decision is UNCLEAR, in the user's actual conversation language",
+            }
+        }
+    }
+});
+//# sourceMappingURL=confirmation-gate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation-gate.js","sourceRoot":"","sources":["../../../../../../../src/services/agent/loops/shared/skills/confirmation-gate.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAShC,QAAA,gBAAgB,GAAG,IAAI,aAAK,CAAiB;IACtD,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,sJAAsJ;IACnK,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE;QAChB,eAAe,EAAE;YACb,IAAI,EAAE,uMAAuM;YAC7M,IAAI,EAAE,yEAAyE;YAC/E,WAAW,EAAE;gBACT,kjBAAkjB;gBACljB,qfAAqf;gBACrf,uSAAuS;gBACvS,oHAAoH;gBACpH,sEAAsE;aACzE;YACD,eAAe,EAAE;gBACb,QAAQ,EAAE,yCAAyC;gBACnD,SAAS,EAAE,QAAQ;gBACnB,eAAe,EAAE,qFAAqF;gBACtG,oBAAoB,EAAE,oFAAoF;aAC7G;SACJ;KACJ;CACJ,CAAC,CAAA"}

package/dist/src/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/src/services/agent/loops/shared/skills/fast-responder.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fastResponder = void 0;
+const skill_1 = require("../../../skills/skill");
+const shared_rules_1 = require("../../../skills/shared/shared-rules");
+exports.fastResponder = new skill_1.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",
+                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ñol', '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 — 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ón...?', 'qué 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ón', 'eso no sirvió'). 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.",
+                shared_rules_1.FORMATTING,
+                shared_rules_1.LATEX_FORMATTING,
+                shared_rules_1.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.",
+                shared_rules_1.POLICY_RESTRICTIONS,
+                "STRICT_OUTPUT: Return ONLY the JSON object matching response_schema."
+            ],
+            response_schema: {
+                can_answer: "boolean",
+                answer: "string",
+                reasoning: "string",
+                detected_language: "string",
+            }
+        }
+    }
+});
+//# sourceMappingURL=fast-responder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fast-responder.js","sourceRoot":"","sources":["../../../../../../../src/services/agent/loops/shared/skills/fast-responder.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAC7C,sEAA4H;AAS/G,QAAA,aAAa,GAAG,IAAI,aAAK,CAAiB;IACnD,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,4EAA4E;IACzF,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE;QAChB,eAAe,EAAE;YACb,IAAI,EAAE,gGAAgG;YACtG,QAAQ,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,wCAAwC;aACjD;YACD,IAAI,EAAE;gBACF,IAAI,EAAE,+CAA+C;gBACrD,KAAK,EAAE,6DAA6D;gBAEpE,eAAe,EAAE,uCAAuC;aAC3D;YACD,WAAW,EAAE;gBACT,kqBAAkqB;gBAClqB,uXAAuX;gBACvX,qxBAAqxB;gBACrxB,2KAA2K;gBAC3K,yBAAU;gBACV,+BAAgB;gBAChB,kCAAmB;gBACnB,uNAAuN;gBACvN,+SAA+S;gBAC/S,kCAAmB;gBACnB,sEAAsE;aACzE;YACD,eAAe,EAAE;gBACb,UAAU,EAAE,SAAS;gBACrB,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,QAAQ;gBACnB,iBAAiB,EAAE,QAAQ;aAC9B;SACJ;KACJ;CACJ,CAAC,CAAA"}

package/dist/src/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/src/services/agent/loops/shared/skills/final-responder.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.finalResponder = void 0;
+const skill_1 = require("../../../skills/skill");
+const shared_rules_1 = require("../../../skills/shared/shared-rules");
+exports.finalResponder = new skill_1.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.",
+                shared_rules_1.FORMATTING,
+                shared_rules_1.LATEX_FORMATTING,
+                shared_rules_1.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"
+            }
+        }
+    }
+});
+//# sourceMappingURL=final-responder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"final-responder.js","sourceRoot":"","sources":["../../../../../../../src/services/agent/loops/shared/skills/final-responder.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAC7C,sEAAuG;AAO1F,QAAA,cAAc,GAAG,IAAI,aAAK,CAAiB;IACpD,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,sHAAsH;IACnI,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE;QAChB,eAAe,EAAE;YACb,IAAI,EAAE,kLAAkL;YACxL,IAAI,EAAE,0CAA0C;YAChD,WAAW,EAAE;gBACT,6JAA6J;gBAC7J,yIAAyI;gBACzI,yBAAU;gBACV,+BAAgB;gBAChB,kCAAmB;gBACnB,+SAA+S;gBAC/S,gMAAgM;gBAChM,oJAAoJ;gBACpJ,6IAA6I;gBAC7I,sEAAsE;aACzE;YACD,eAAe,EAAE;gBACb,cAAc,EAAE,QAAQ;gBACxB,SAAS,EAAE,QAAQ;aACtB;SACJ;KACJ;CACJ,CAAC,CAAA"}

package/dist/src/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/src/services/agent/loops/shared/skills/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./action-planner"), exports);
+__exportStar(require("./confirmation-gate"), exports);
+__exportStar(require("./fast-responder"), exports);
+__exportStar(require("./final-responder"), exports);
+__exportStar(require("./state-observer"), exports);
+__exportStar(require("./strategy-engine"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/services/agent/loops/shared/skills/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,sDAAmC;AACnC,mDAAgC;AAChC,oDAAiC;AACjC,mDAAgC;AAChC,oDAAiC"}

package/dist/src/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/src/services/agent/loops/shared/skills/state-observer.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stateObserver = void 0;
+const skill_1 = require("../../../skills/skill");
+exports.stateObserver = new skill_1.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"
+            }
+        }
+    }
+});
+//# sourceMappingURL=state-observer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-observer.js","sourceRoot":"","sources":["../../../../../../../src/services/agent/loops/shared/skills/state-observer.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAUhC,QAAA,aAAa,GAAG,IAAI,aAAK,CAA8B;IAChE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,gJAAgJ;IAC7J,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE;QAChB,eAAe,EAAE;YACb,IAAI,EAAE,8PAA8P;YACpQ,IAAI,EAAE,6FAA6F;YACnG,WAAW,EAAE;gBACT,uPAAuP;gBACvP,oOAAoO;gBACpO,iPAAiP;gBACjP,qZAAqZ;gBACrZ,yWAAyW;gBACzW,0JAA0J;gBAC1J,iOAAiO;gBACjO,sEAAsE;aACzE;YACD,eAAe,EAAE;gBACb,MAAM,EAAE,gDAAgD;gBACxD,oBAAoB,EAAE,QAAQ;gBAC9B,WAAW,EAAE,QAAQ;gBACrB,iBAAiB,EAAE,QAAQ;gBAC3B,SAAS,EAAE,QAAQ;aACtB;SACJ;KACJ;CACJ,CAAC,CAAA"}

package/dist/src/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 {};