@yagr/agent 0.1.0

package/dist/runtime/context-compaction.js

@@ -0,0 +1,197 @@
+import { generateText } from 'ai';
+import { createLanguageModel } from '../llm/create-language-model.js';
+import { analyzeRunOutcome, formatObservedAction } from './outcome.js';
+import { collectRequiredActions } from './required-actions.js';
+const DEFAULT_CHARS_PER_TOKEN = 4;
+const DEFAULT_THRESHOLD_PERCENT = 70;
+const DEFAULT_PRESERVE_RECENT_MESSAGES = 6;
+const MAX_TRANSCRIPT_CHARS = 24_000;
+function contentToText(content) {
+    if (typeof content === 'string') {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => {
+            if (typeof part === 'string') {
+                return part;
+            }
+            if (part && typeof part === 'object') {
+                if ('text' in part && typeof part.text === 'string') {
+                    return part.text;
+                }
+                return JSON.stringify(part);
+            }
+            return String(part ?? '');
+        })
+            .join('\n');
+    }
+    return '';
+}
+function estimateTokensFromText(text, charsPerToken) {
+    if (!text) {
+        return 0;
+    }
+    return Math.ceil(text.length / charsPerToken);
+}
+function estimateMessageTokens(messages, charsPerToken) {
+    return messages.reduce((total, message) => total + estimateTokensFromText(contentToText(message.content), charsPerToken), 0);
+}
+function buildAllowedTokenThreshold(budget) {
+    const thresholdPercent = budget.thresholdPercent ?? DEFAULT_THRESHOLD_PERCENT;
+    const cappedThreshold = Math.max(5, Math.min(95, thresholdPercent));
+    const thresholdBudget = Math.floor((budget.contextWindowTokens * cappedThreshold) / 100);
+    return Math.max(0, thresholdBudget - budget.reservedOutputTokens);
+}
+function sanitizeTranscriptText(text) {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        return '';
+    }
+    if (trimmed.startsWith('Yagr internal phase:')) {
+        return '';
+    }
+    if (trimmed.startsWith('Original request:')) {
+        return '';
+    }
+    if (trimmed === 'Do not claim completion in this phase.') {
+        return '';
+    }
+    return trimmed;
+}
+function transcriptAsText(messages) {
+    const lines = messages
+        .map((message) => {
+        const text = sanitizeTranscriptText(contentToText(message.content));
+        if (!text) {
+            return '';
+        }
+        return `[${message.role}]\n${text}`;
+    })
+        .filter((line) => line.length > 0)
+        .join('\n\n');
+    if (lines.length <= MAX_TRANSCRIPT_CHARS) {
+        return lines;
+    }
+    return `${lines.slice(0, MAX_TRANSCRIPT_CHARS)}\n\n[Transcript truncated for condensation]`;
+}
+function buildJournalDigest(prompt, journal) {
+    const outcome = analyzeRunOutcome(journal);
+    const requiredActions = collectRequiredActions(journal);
+    const lines = [];
+    lines.push(`Original request: ${prompt}`);
+    if (outcome.writtenFiles.length > 0) {
+        lines.push(`Written files: ${outcome.writtenFiles.join(', ')}`);
+    }
+    if (outcome.updatedFiles.length > 0) {
+        lines.push(`Updated files: ${outcome.updatedFiles.join(', ')}`);
+    }
+    if (outcome.successfulActions.length > 0) {
+        lines.push(`Successful actions: ${outcome.successfulActions.map(formatObservedAction).join(', ')}`);
+    }
+    if (outcome.unresolvedFailedActions.length > 0) {
+        lines.push(`Unresolved failures: ${outcome.unresolvedFailedActions.map(formatObservedAction).join(', ')}`);
+    }
+    if (requiredActions.length > 0) {
+        lines.push(`Open required actions: ${requiredActions.map((action) => `${action.title} [${action.kind}]`).join(', ')}`);
+    }
+    return lines.join('\n');
+}
+function buildFallbackSummary(prompt, journal, compactedMessages) {
+    const transcript = transcriptAsText(compactedMessages)
+        .split('\n')
+        .slice(-12)
+        .join('\n');
+    return [
+        '## Yagr Context Checkpoint',
+        buildJournalDigest(prompt, journal),
+        transcript ? `Compressed transcript excerpts:\n${transcript}` : '',
+        'Continue from this checkpoint without redoing completed work. Re-read files or instructions if exact wording or structure is needed.',
+    ].filter(Boolean).join('\n\n');
+}
+function buildSummaryPrompt(prompt, journal, compactedMessages) {
+    return [
+        'You are condensing Yagr runtime context for continuation inside the same task.',
+        'Produce a concise but loss-aware checkpoint summary.',
+        'Keep facts that are necessary for the next agent call: user objective, confirmed decisions, files created or modified, validated or pushed actions, unresolved failures, open blockers, and any exact constraints that must continue to govern the work.',
+        'Do not repeat generic boilerplate. Do not invent facts. Do not mention that you are an AI model.',
+        'Preserve actionable exactness when a rule, filename, identifier, or required next step matters.',
+        'Output plain text only. Start with the heading "## Yagr Context Checkpoint".',
+        '',
+        'Journal digest:',
+        buildJournalDigest(prompt, journal),
+        '',
+        'Conversation to condense:',
+        transcriptAsText(compactedMessages),
+    ].join('\n');
+}
+async function generateCheckpointSummary(prompt, journal, compactedMessages, abortSignal, llmConfig, condense) {
+    try {
+        const summaryPrompt = buildSummaryPrompt(prompt, journal, compactedMessages);
+        const summary = condense
+            ? (await condense(summaryPrompt)).trim()
+            : (await generateText({
+                abortSignal,
+                model: createLanguageModel(llmConfig),
+                system: 'This is a context condensation operation. Do not call tools. Return only the checkpoint summary text.',
+                messages: [
+                    {
+                        role: 'user',
+                        content: summaryPrompt,
+                    },
+                ],
+                maxSteps: 1,
+            })).text.trim();
+        if (summary.length > 0) {
+            return { summary, source: 'llm' };
+        }
+        return {
+            summary: buildFallbackSummary(prompt, journal, compactedMessages),
+            source: 'fallback',
+            fallbackReason: 'LLM condensation returned empty text.',
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw error;
+        }
+        return {
+            summary: buildFallbackSummary(prompt, journal, compactedMessages),
+            source: 'fallback',
+            fallbackReason: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function compactConversationContext(input) {
+    const charsPerToken = input.budget.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;
+    const preserveRecentMessages = Math.max(2, input.budget.preserveRecentMessages ?? DEFAULT_PRESERVE_RECENT_MESSAGES);
+    const estimatedTokens = estimateTokensFromText(input.systemPrompt, charsPerToken) + estimateMessageTokens(input.messages, charsPerToken);
+    const thresholdTokens = buildAllowedTokenThreshold(input.budget);
+    if (estimatedTokens <= thresholdTokens) {
+        return { messages: input.messages };
+    }
+    if (input.messages.length <= preserveRecentMessages + 1) {
+        return { messages: input.messages };
+    }
+    const splitIndex = Math.max(1, input.messages.length - preserveRecentMessages);
+    const compactedMessages = input.messages.slice(0, splitIndex);
+    const recentMessages = input.messages.slice(splitIndex);
+    const checkpoint = await generateCheckpointSummary(input.prompt, input.journal, compactedMessages, input.abortSignal, input.llmConfig, input.condense);
+    const summaryMessage = {
+        role: 'user',
+        content: checkpoint.summary,
+    };
+    return {
+        messages: [summaryMessage, ...recentMessages],
+        event: {
+            summary: checkpoint.summary,
+            source: checkpoint.source,
+            fallbackReason: checkpoint.fallbackReason,
+            estimatedTokens,
+            thresholdTokens,
+            messagesCompacted: compactedMessages.length,
+            preservedRecentMessages: recentMessages.length,
+        },
+    };
+}
+//# sourceMappingURL=context-compaction.js.map

package/dist/runtime/context-compaction.js.map

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

package/dist/runtime/outcome.d.ts

@@ -0,0 +1,23 @@
+import type { YagrRunJournalEntry } from '../types.js';
+export type ObservedN8nacAction = {
+    action: string;
+    success: boolean;
+    filename?: string;
+    workflowId?: string;
+    validateFile?: string;
+    exitCode?: number;
+};
+export type RunOutcome = {
+    writtenFiles: string[];
+    updatedFiles: string[];
+    successfulActions: ObservedN8nacAction[];
+    failedActions: ObservedN8nacAction[];
+    unresolvedFailedActions: ObservedN8nacAction[];
+    successfulValidate?: ObservedN8nacAction;
+    successfulPush?: ObservedN8nacAction;
+    successfulVerify?: ObservedN8nacAction;
+    hasWorkflowWrites: boolean;
+};
+export declare function formatObservedAction(action: ObservedN8nacAction): string;
+export declare function analyzeRunOutcome(journal: YagrRunJournalEntry[]): RunOutcome;
+//# sourceMappingURL=outcome.d.ts.map

package/dist/runtime/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/runtime/outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;IACzC,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,uBAAuB,EAAE,mBAAmB,EAAE,CAAC;IAC/C,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AA6EF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAGxE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,UAAU,CAsB5E"}

package/dist/runtime/outcome.js

@@ -0,0 +1,89 @@
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : undefined;
+}
+function asString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function asNumber(value) {
+    return typeof value === 'number' ? value : undefined;
+}
+function extractObservedFacts(journal) {
+    const writtenFiles = new Set();
+    const updatedFiles = new Set();
+    const n8nacActions = [];
+    for (const entry of journal) {
+        if (entry.type !== 'step' || !entry.step) {
+            continue;
+        }
+        const step = entry.step;
+        for (let index = 0; index < step.toolCalls.length; index += 1) {
+            const toolCall = step.toolCalls[index];
+            const toolResult = step.toolResults[index];
+            const args = asRecord(toolCall.args);
+            const result = asRecord(toolResult?.result);
+            if (toolCall.toolName === 'writeWorkspaceFile') {
+                const filePath = asString(result?.path) ?? asString(args?.path);
+                if (filePath) {
+                    writtenFiles.add(filePath);
+                }
+                continue;
+            }
+            if (toolCall.toolName === 'replaceInWorkspaceFile') {
+                const filePath = asString(result?.path) ?? asString(args?.path);
+                if (filePath) {
+                    updatedFiles.add(filePath);
+                }
+                continue;
+            }
+            if (toolCall.toolName === 'n8nac') {
+                const action = asString(args?.action) ?? 'unknown';
+                n8nacActions.push({
+                    action,
+                    success: (asNumber(result?.exitCode) ?? 1) === 0,
+                    filename: asString(args?.filename),
+                    workflowId: asString(args?.workflowId),
+                    validateFile: asString(args?.validateFile),
+                    exitCode: asNumber(result?.exitCode),
+                });
+            }
+        }
+    }
+    return {
+        writtenFiles: [...writtenFiles],
+        updatedFiles: [...updatedFiles],
+        n8nacActions,
+    };
+}
+function findSuccessfulAction(actions, actionName) {
+    return actions.find((action) => action.action === actionName && action.success);
+}
+function actionKey(action) {
+    return `${action.action}::${action.filename ?? action.validateFile ?? action.workflowId ?? ''}`;
+}
+export function formatObservedAction(action) {
+    const target = action.filename ?? action.validateFile ?? action.workflowId;
+    return target ? `${action.action} (${target})` : action.action;
+}
+export function analyzeRunOutcome(journal) {
+    const facts = extractObservedFacts(journal);
+    const successfulActions = facts.n8nacActions.filter((action) => action.success);
+    const failedActions = facts.n8nacActions.filter((action) => !action.success);
+    const resolvedFailureKeys = new Set(successfulActions.map(actionKey));
+    const unresolvedFailedActions = failedActions.filter((action) => !resolvedFailureKeys.has(actionKey(action)));
+    const hasWorkflowWrites = [...facts.writtenFiles, ...facts.updatedFiles].some((filePath) => filePath.endsWith('.workflow.ts'));
+    const successfulPush = findSuccessfulAction(facts.n8nacActions, 'push');
+    const successfulValidate = findSuccessfulAction(facts.n8nacActions, 'validate') ?? successfulPush;
+    const successfulVerify = findSuccessfulAction(facts.n8nacActions, 'verify') ?? successfulPush;
+    return {
+        writtenFiles: facts.writtenFiles,
+        updatedFiles: facts.updatedFiles,
+        successfulActions,
+        failedActions,
+        unresolvedFailedActions,
+        successfulValidate,
+        successfulPush,
+        successfulVerify,
+        hasWorkflowWrites,
+    };
+}
+//# sourceMappingURL=outcome.js.map

package/dist/runtime/outcome.js.map

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

package/dist/runtime/policy-hooks.d.ts

@@ -0,0 +1,15 @@
+import type { YagrAgentState, YagrRunPhase, YagrRuntimeHook } from '../types.js';
+type ToolLike = {
+    description?: string;
+    parameters: any;
+    experimental_toToolResultContent?: ((result: any) => any) | undefined;
+    execute?: (args: any, options: any) => PromiseLike<any>;
+};
+type ToolMap = Record<string, ToolLike>;
+export declare function wrapToolsWithRuntimeHooks<T extends ToolMap>(tools: T, hooks: YagrRuntimeHook[] | undefined, getContext: () => {
+    runId: string;
+    phase: YagrRunPhase | null;
+    state: YagrAgentState;
+}, satisfiedRequiredActionIds?: string[] | undefined): T;
+export {};
+//# sourceMappingURL=policy-hooks.d.ts.map

package/dist/runtime/policy-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-hooks.d.ts","sourceRoot":"","sources":["../../src/runtime/policy-hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAsB,eAAe,EAAE,MAAM,aAAa,CAAC;AAErG,KAAK,QAAQ,GAAG;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC;IAChB,gCAAgC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;IACtE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC;CACzD,CAAC;AAEF,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAExC,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,OAAO,EACzD,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,eAAe,EAAE,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,EACtF,0BAA0B,GAAE,MAAM,EAAE,GAAG,SAAc,GACpD,CAAC,CA6DH"}

package/dist/runtime/policy-hooks.js

@@ -0,0 +1,54 @@
+import { tool } from 'ai';
+export function wrapToolsWithRuntimeHooks(tools, hooks, getContext, satisfiedRequiredActionIds = []) {
+    if (!hooks || hooks.length === 0) {
+        return tools;
+    }
+    const approvedActionIds = new Set(satisfiedRequiredActionIds);
+    const wrappedEntries = Object.entries(tools).map(([toolName, originalTool]) => {
+        if (typeof originalTool.execute !== 'function') {
+            return [toolName, originalTool];
+        }
+        const wrappedTool = tool({
+            description: originalTool.description,
+            parameters: originalTool.parameters,
+            experimental_toToolResultContent: originalTool.experimental_toToolResultContent,
+            execute: async (args, toolOptions) => {
+                const runtimeContext = {
+                    runId: getContext().runId,
+                    phase: getContext().phase ?? undefined,
+                    state: getContext().state,
+                };
+                const hookContext = {
+                    ...runtimeContext,
+                    toolName,
+                    args,
+                };
+                for (const hook of hooks) {
+                    const decision = await hook.beforeTool?.(hookContext);
+                    if (decision && decision.allowed === false) {
+                        if (decision.requiredAction && approvedActionIds.has(decision.requiredAction.id)) {
+                            continue;
+                        }
+                        return {
+                            ok: false,
+                            blocked: true,
+                            error: decision.message ?? `Tool ${toolName} blocked by runtime policy.`,
+                            requiredAction: decision.requiredAction,
+                        };
+                    }
+                }
+                const result = await originalTool.execute?.(args, toolOptions);
+                for (const hook of hooks) {
+                    await hook.afterTool?.({
+                        ...hookContext,
+                        result,
+                    });
+                }
+                return result;
+            },
+        });
+        return [toolName, wrappedTool];
+    });
+    return Object.fromEntries(wrappedEntries);
+}
+//# sourceMappingURL=policy-hooks.js.map

package/dist/runtime/policy-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-hooks.js","sourceRoot":"","sources":["../../src/runtime/policy-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAY1B,MAAM,UAAU,yBAAyB,CACvC,KAAQ,EACR,KAAoC,EACpC,UAAsF,EACtF,6BAAmD,EAAE;IAErD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAE9D,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,EAAE;QAC5E,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC/C,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC;YACvB,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,gCAAgC,EAAE,YAAY,CAAC,gCAAgC;YAC/E,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,WAAgB,EAAE,EAAE;gBAC7C,MAAM,cAAc,GAAuB;oBACzC,KAAK,EAAE,UAAU,EAAE,CAAC,KAAK;oBACzB,KAAK,EAAE,UAAU,EAAE,CAAC,KAAK,IAAI,SAAS;oBACtC,KAAK,EAAE,UAAU,EAAE,CAAC,KAAK;iBAC1B,CAAC;gBACF,MAAM,WAAW,GAAG;oBAClB,GAAG,cAAc;oBACjB,QAAQ;oBACR,IAAI;iBACL,CAAC;gBAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAC;oBACtD,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;wBAC3C,IAAI,QAAQ,CAAC,cAAc,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;4BACjF,SAAS;wBACX,CAAC;wBAED,OAAO;4BACL,EAAE,EAAE,KAAK;4BACT,OAAO,EAAE,IAAI;4BACb,KAAK,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,QAAQ,6BAA6B;4BACxE,cAAc,EAAE,QAAQ,CAAC,cAAc;yBACxC,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAE/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;wBACrB,GAAG,WAAW;wBACd,MAAM;qBACP,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;SACK,CAAC,CAAC;QAEV,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,WAAW,CAAC,cAAc,CAAM,CAAC;AACjD,CAAC"}

package/dist/runtime/required-actions.d.ts

@@ -0,0 +1,5 @@
+import type { YagrAgentState, YagrRequiredAction, YagrRunJournalEntry } from '../types.js';
+export declare function collectRequiredActions(journal: YagrRunJournalEntry[]): YagrRequiredAction[];
+export declare function agentStateForRequiredAction(action: YagrRequiredAction): YagrAgentState;
+export declare function blockingStateForRequiredActions(actions: YagrRequiredAction[]): YagrAgentState | null;
+//# sourceMappingURL=required-actions.d.ts.map

package/dist/runtime/required-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-actions.d.ts","sourceRoot":"","sources":["../../src/runtime/required-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAsC3F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,kBAAkB,EAAE,CA4B3F;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAUtF;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,cAAc,GAAG,IAAI,CAgBpG"}

package/dist/runtime/required-actions.js

@@ -0,0 +1,77 @@
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : undefined;
+}
+function asString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function asBoolean(value) {
+    return typeof value === 'boolean' ? value : undefined;
+}
+function normalizeRequiredAction(value, fallbackId) {
+    const record = asRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const kind = asString(record.kind);
+    const title = asString(record.title);
+    const message = asString(record.message);
+    if (!kind || !title || !message || (kind !== 'input' && kind !== 'permission' && kind !== 'external')) {
+        return undefined;
+    }
+    return {
+        id: asString(record.id) ?? fallbackId,
+        kind,
+        title,
+        message,
+        detail: asString(record.detail),
+        resumable: asBoolean(record.resumable) ?? true,
+    };
+}
+export function collectRequiredActions(journal) {
+    const actions = new Map();
+    for (const entry of journal) {
+        if (entry.requiredAction) {
+            actions.set(entry.requiredAction.id, entry.requiredAction);
+        }
+        if (entry.type !== 'step' || !entry.step) {
+            continue;
+        }
+        for (let index = 0; index < entry.step.toolCalls.length; index += 1) {
+            const toolCall = entry.step.toolCalls[index];
+            if (toolCall.toolName !== 'requestRequiredAction') {
+                continue;
+            }
+            const toolResult = entry.step.toolResults[index];
+            const fallbackId = `${entry.step.stepNumber}:${index}`;
+            const action = normalizeRequiredAction(toolResult?.result ?? toolCall.args, fallbackId);
+            if (action) {
+                actions.set(action.id, action);
+            }
+        }
+    }
+    return [...actions.values()];
+}
+export function agentStateForRequiredAction(action) {
+    if (action.kind === 'permission') {
+        return 'waiting_for_permission';
+    }
+    if (action.kind === 'input') {
+        return 'waiting_for_input';
+    }
+    return action.resumable ? 'resumable' : 'failed_terminal';
+}
+export function blockingStateForRequiredActions(actions) {
+    if (actions.length === 0) {
+        return null;
+    }
+    const permissionAction = actions.find((action) => action.kind === 'permission');
+    if (permissionAction) {
+        return agentStateForRequiredAction(permissionAction);
+    }
+    const inputAction = actions.find((action) => action.kind === 'input');
+    if (inputAction) {
+        return agentStateForRequiredAction(inputAction);
+    }
+    return agentStateForRequiredAction(actions[0]);
+}
+//# sourceMappingURL=required-actions.js.map

package/dist/runtime/required-actions.js.map

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

package/dist/runtime/run-engine.d.ts

@@ -0,0 +1,15 @@
+import { type CoreMessage } from 'ai';
+import type { Engine } from '../engine/engine.js';
+import type { YagrRunOptions, YagrRunResult } from '../types.js';
+type ExecuteRunResult = {
+    result: YagrRunResult;
+    persistedMessages: CoreMessage[];
+};
+export declare class YagrRunEngine {
+    private readonly engine;
+    private readonly history;
+    constructor(engine: Engine, history: readonly CoreMessage[]);
+    execute(prompt: string, options?: YagrRunOptions): Promise<ExecuteRunResult>;
+}
+export {};
+//# sourceMappingURL=run-engine.d.ts.map

package/dist/runtime/run-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-engine.d.ts","sourceRoot":"","sources":["../../src/runtime/run-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,IAAI,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EAOV,cAAc,EAEd,aAAa,EAId,MAAM,aAAa,CAAC;AAerB,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,iBAAiB,EAAE,WAAW,EAAE,CAAC;CAClC,CAAC;AAqiBF,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,WAAW,EAAE;IAG5C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAoOvF"}