@memberjunction/ai-agents 5.43.0 → 5.45.0

package/dist/SkillImportExportService.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Orchestrates SKILL.md export/import against the database: resolves Action/Agent
+ * names to IDs (import) and IDs back to names (export), and creates/updates the MJ: AI Skills +
+ * junction entities. Builds on the pure {@link SkillMarkdownConverter} for the text<->data
+ * transformation itself.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { MJAISkillEntity } from '@memberjunction/core-entities';
+/**
+ * Options for {@link SkillImportExportService.ImportSkill}.
+ */
+export interface ImportSkillOptions {
+    /**
+     * When provided, updates this existing skill (and resyncs its Action/sub-agent bundling)
+     * instead of creating a new one. The caller is responsible for confirming the current user is
+     * allowed to edit this skill (e.g. it's their own, per the "own skills" RLS filter).
+     */
+    updateSkillId?: string;
+}
+/**
+ * Result of {@link SkillImportExportService.ImportSkill}.
+ */
+export interface ImportSkillResult {
+    skill: MJAISkillEntity;
+    /** Action/sub-agent names from the SKILL.md that couldn't be resolved — the skill is still
+     *  created/updated with whatever DID resolve, so the caller can surface these as non-fatal
+     *  warnings rather than failing the whole import. */
+    warnings: string[];
+}
+/**
+ * Result of {@link SkillImportExportService.ExportSkill}.
+ */
+export interface ExportSkillResult {
+    markdown: string;
+    /** The skill's Name — returned alongside the markdown so callers don't need a second load. */
+    skillName: string;
+}
+export declare class SkillImportExportService {
+    /**
+     * Exports a skill to a portable SKILL.md string: Action/sub-agent IDs are resolved to their
+     * current Names (not IDs, for cross-instance portability) via the AI/Action engine caches.
+     */
+    static ExportSkill(skillId: string, contextUser: UserInfo, provider?: IMetadataProvider): Promise<ExportSkillResult>;
+    /**
+     * Imports a SKILL.md document, resolving Action/sub-agent names against the current instance's
+     * catalog (unresolvable names are dropped and reported as warnings, not fatal errors — a skill
+     * authored against a different MJ instance may reference actions that don't exist here yet).
+     */
+    static ImportSkill(markdownText: string, contextUser: UserInfo, options?: ImportSkillOptions, provider?: IMetadataProvider): Promise<ImportSkillResult>;
+    /**
+     * Loads the AI + Action engine caches that name/ID resolution depends on. Both `Config()` calls
+     * are idempotent — a no-op when the engine is already loaded (the common server case) — so this
+     * is cheap insurance against a cold caller producing empty resolutions.
+     */
+    private static ensureEnginesConfigured;
+    /** Resolves a list of names against a cached entity array (by ID+Name), collecting a warning for each miss. */
+    private static resolveNames;
+    /** Deletes existing junction rows for the skill and recreates them from the resolved ID set — the simplest correct resync for a small bounded set of rows. */
+    private static resyncJunction;
+}
+//# sourceMappingURL=SkillImportExportService.d.ts.map

package/dist/SkillImportExportService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillImportExportService.d.ts","sourceRoot":"","sources":["../src/SkillImportExportService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAqB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAkD,MAAM,+BAA+B,CAAC;AAKhH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB;;yDAEqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,wBAAwB;IACjC;;;OAGG;WACiB,WAAW,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,QAAQ,EACrB,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IA6C7B;;;;OAIG;WACiB,WAAW,CAC3B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,QAAQ,EACrB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAiD7B;;;;OAIG;mBACkB,uBAAuB;IAK5C,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,YAAY;IAkB3B,8JAA8J;mBACzI,cAAc;CAmCtC"}

package/dist/SkillImportExportService.js

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Orchestrates SKILL.md export/import against the database: resolves Action/Agent
+ * names to IDs (import) and IDs back to names (export), and creates/updates the MJ: AI Skills +
+ * junction entities. Builds on the pure {@link SkillMarkdownConverter} for the text<->data
+ * transformation itself.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { Metadata, RunView } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { AIEngine } from '@memberjunction/aiengine';
+import { ActionEngineServer } from '@memberjunction/actions';
+import { SkillMarkdownConverter } from './SkillMarkdownConverter.js';
+export class SkillImportExportService {
+    /**
+     * Exports a skill to a portable SKILL.md string: Action/sub-agent IDs are resolved to their
+     * current Names (not IDs, for cross-instance portability) via the AI/Action engine caches.
+     */
+    static async ExportSkill(skillId, contextUser, provider) {
+        const md = provider ?? Metadata.Provider;
+        // Name resolution below reads the AI/Action engine caches — ensure they're loaded (idempotent
+        // no-op when already configured). Without this, a cold caller resolves every ID to no name.
+        await this.ensureEnginesConfigured(contextUser, md);
+        const skill = await md.GetEntityObject('MJ: AI Skills', contextUser);
+        const loaded = await skill.Load(skillId);
+        if (!loaded) {
+            throw new Error(`Skill ${skillId} not found`);
+        }
+        const rv = new RunView();
+        const [actionRows, subAgentRows] = await rv.RunViews([
+            {
+                EntityName: 'MJ: AI Skill Actions',
+                ExtraFilter: `SkillID='${skillId}'`,
+                ResultType: 'simple'
+            },
+            {
+                EntityName: 'MJ: AI Skill Sub Agents',
+                ExtraFilter: `SkillID='${skillId}'`,
+                ResultType: 'simple'
+            }
+        ], contextUser);
+        const actionNames = (actionRows.Success ? actionRows.Results : [])
+            .map(row => ActionEngineServer.Instance.Actions.find(a => UUIDsEqual(a.ID, row.ActionID))?.Name)
+            .filter((name) => !!name);
+        const subAgentNames = (subAgentRows.Success ? subAgentRows.Results : [])
+            .map(row => AIEngine.Instance.Agents.find(a => UUIDsEqual(a.ID, row.SubAgentID))?.Name)
+            .filter((name) => !!name);
+        const markdown = SkillMarkdownConverter.Serialize({
+            name: skill.Name,
+            description: skill.Description ?? undefined,
+            category: skill.Category ?? undefined,
+            actionNames,
+            subAgentNames,
+            instructions: skill.Instructions
+        });
+        return { markdown, skillName: skill.Name };
+    }
+    /**
+     * Imports a SKILL.md document, resolving Action/sub-agent names against the current instance's
+     * catalog (unresolvable names are dropped and reported as warnings, not fatal errors — a skill
+     * authored against a different MJ instance may reference actions that don't exist here yet).
+     */
+    static async ImportSkill(markdownText, contextUser, options, provider) {
+        const parsed = SkillMarkdownConverter.Parse(markdownText);
+        const warnings = [];
+        const md = provider ?? Metadata.Provider;
+        // Name→ID resolution below reads the AI/Action engine caches — ensure they're loaded
+        // (idempotent). Without this, every bundled Action/sub-agent name would falsely resolve to a
+        // "not found" warning on a cold server.
+        await this.ensureEnginesConfigured(contextUser, md);
+        const resolvedActionIDs = this.resolveNames(parsed.frontmatter.actions ?? [], ActionEngineServer.Instance.Actions, warnings, 'Action');
+        const resolvedSubAgentIDs = this.resolveNames(parsed.frontmatter.subAgents ?? [], AIEngine.Instance.Agents, warnings, 'Sub-agent');
+        const skill = await md.GetEntityObject('MJ: AI Skills', contextUser);
+        if (options?.updateSkillId) {
+            const loaded = await skill.Load(options.updateSkillId);
+            if (!loaded) {
+                throw new Error(`Skill ${options.updateSkillId} not found for update`);
+            }
+        }
+        else {
+            skill.NewRecord();
+            skill.CreatedByUserID = contextUser.ID;
+            skill.Status = 'Active';
+        }
+        skill.Name = parsed.frontmatter.name;
+        skill.Description = parsed.frontmatter.description ?? null;
+        skill.Category = parsed.frontmatter.category ?? null;
+        skill.Instructions = parsed.instructions;
+        const saved = await skill.Save();
+        if (!saved) {
+            throw new Error(`Failed to save imported skill: ${skill.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        }
+        await this.resyncJunction(skill.ID, 'MJ: AI Skill Actions', resolvedActionIDs, 'ActionID', contextUser, md);
+        await this.resyncJunction(skill.ID, 'MJ: AI Skill Sub Agents', resolvedSubAgentIDs, 'SubAgentID', contextUser, md);
+        return { skill, warnings };
+    }
+    /**
+     * Loads the AI + Action engine caches that name/ID resolution depends on. Both `Config()` calls
+     * are idempotent — a no-op when the engine is already loaded (the common server case) — so this
+     * is cheap insurance against a cold caller producing empty resolutions.
+     */
+    static async ensureEnginesConfigured(contextUser, provider) {
+        await AIEngine.Instance.Config(false, contextUser, provider);
+        await ActionEngineServer.Instance.Config(false, contextUser, provider);
+    }
+    /** Resolves a list of names against a cached entity array (by ID+Name), collecting a warning for each miss. */
+    static resolveNames(names, catalog, warnings, kindLabel) {
+        const resolved = [];
+        for (const name of names) {
+            const match = catalog.find(c => c.Name.trim().toLowerCase() === name.trim().toLowerCase());
+            if (match) {
+                resolved.push(match.ID);
+            }
+            else {
+                warnings.push(`${kindLabel} '${name}' not found in this instance — skipped`);
+            }
+        }
+        return resolved;
+    }
+    /** Deletes existing junction rows for the skill and recreates them from the resolved ID set — the simplest correct resync for a small bounded set of rows. */
+    static async resyncJunction(skillId, entityName, resolvedIDs, idFieldName, contextUser, provider) {
+        const rv = new RunView();
+        const existing = await rv.RunView({
+            EntityName: entityName,
+            ExtraFilter: `SkillID='${skillId}'`,
+            ResultType: 'entity_object'
+        }, contextUser);
+        if (existing.Success) {
+            for (const row of existing.Results) {
+                const deleted = await row.Delete();
+                if (!deleted) {
+                    throw new Error(`Failed to remove existing ${entityName} row during skill re-sync: ${row.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+                }
+            }
+        }
+        for (const id of resolvedIDs) {
+            const junctionRow = await provider.GetEntityObject(entityName, contextUser);
+            junctionRow.NewRecord();
+            junctionRow.SkillID = skillId;
+            junctionRow[idFieldName] = id;
+            const saved = await junctionRow.Save();
+            if (!saved) {
+                throw new Error(`Failed to create ${entityName} row during skill re-sync: ${junctionRow.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=SkillImportExportService.js.map

package/dist/SkillImportExportService.js.map

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

package/dist/SkillMarkdownConverter.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Pure parse/serialize for the portable SKILL.md format — no database or engine
+ * dependency, so this is fully unit-testable in isolation. `SkillImportExportService` builds on
+ * top of this to do the actual name<->ID resolution and entity persistence.
+ *
+ * ## Format
+ * ```markdown
+ * ---
+ * name: Report Builder
+ * description: Generates formatted business reports from query results
+ * category: Reporting
+ * actions:
+ *   - Run Query
+ *   - Generate PDF
+ * subAgents:
+ *   - Report Formatter Agent
+ * ---
+ *
+ * Instructions body — plain markdown, appended to an accepting agent's system
+ * prompt when the skill is activated.
+ * ```
+ *
+ * Deliberately NOT a general-purpose YAML parser — the frontmatter shape is fixed and small
+ * (flat scalar keys + simple string-list keys), so a hand-rolled parser avoids taking on a new
+ * dependency for a narrow, fully-controlled need.
+ *
+ * @module @memberjunction/ai-agents
+ */
+/**
+ * The frontmatter fields of a SKILL.md file. `actions`/`subAgents` are Action/Agent NAMES (not
+ * IDs) — portability across MJ instances means names are the only stable cross-instance
+ * reference; ID resolution happens at import time via {@link SkillImportExportService}.
+ */
+export interface SkillMarkdownFrontmatter {
+    name: string;
+    description?: string;
+    category?: string;
+    actions?: string[];
+    subAgents?: string[];
+}
+/**
+ * Result of parsing a SKILL.md file: the frontmatter fields plus the Instructions body.
+ */
+export interface ParsedSkillMarkdown {
+    frontmatter: SkillMarkdownFrontmatter;
+    instructions: string;
+}
+/**
+ * Inputs to {@link SkillMarkdownConverter.Serialize} — the export-side counterpart of
+ * {@link ParsedSkillMarkdown}, using resolved names (not IDs) for portability.
+ */
+export interface SerializeSkillMarkdownParams {
+    name: string;
+    description?: string;
+    category?: string;
+    actionNames?: string[];
+    subAgentNames?: string[];
+    instructions: string;
+}
+export declare class SkillMarkdownConverter {
+    /**
+     * Parses a SKILL.md document into its frontmatter + instructions body. Throws with a clear
+     * message on malformed input (missing/unterminated frontmatter block, missing required `name`).
+     */
+    static Parse(markdownText: string): ParsedSkillMarkdown;
+    /**
+     * Serializes skill data into a SKILL.md document. The inverse of {@link Parse}.
+     */
+    static Serialize(params: SerializeSkillMarkdownParams): string;
+    /**
+     * Parses the frontmatter line block into a {@link SkillMarkdownFrontmatter}. Supports flat
+     * `key: value` scalars and `key:` followed by `  - item` list entries — nothing more complex
+     * (no nested objects, no multiline scalars). Unknown keys are ignored rather than erroring, so
+     * a future field addition doesn't break parsing of older SKILL.md files.
+     */
+    private static parseFrontmatterLines;
+    /** Quotes a scalar value if it contains a colon or leading/trailing whitespace that would otherwise break the simple parser. */
+    private static escapeScalar;
+    /** Strips the quoting {@link escapeScalar} applies, if present. */
+    private static unescapeScalar;
+}
+//# sourceMappingURL=SkillMarkdownConverter.d.ts.map

package/dist/SkillMarkdownConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillMarkdownConverter.d.ts","sourceRoot":"","sources":["../src/SkillMarkdownConverter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,wBAAwB,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACxB;AAID,qBAAa,sBAAsB;IAC/B;;;OAGG;WACW,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB;IA2B9D;;OAEG;WACW,SAAS,CAAC,MAAM,EAAE,4BAA4B,GAAG,MAAM;IA6BrE;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA6CpC,gIAAgI;IAChI,OAAO,CAAC,MAAM,CAAC,YAAY;IAO3B,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,cAAc;CAOhC"}

package/dist/SkillMarkdownConverter.js

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview Pure parse/serialize for the portable SKILL.md format — no database or engine
+ * dependency, so this is fully unit-testable in isolation. `SkillImportExportService` builds on
+ * top of this to do the actual name<->ID resolution and entity persistence.
+ *
+ * ## Format
+ * ```markdown
+ * ---
+ * name: Report Builder
+ * description: Generates formatted business reports from query results
+ * category: Reporting
+ * actions:
+ *   - Run Query
+ *   - Generate PDF
+ * subAgents:
+ *   - Report Formatter Agent
+ * ---
+ *
+ * Instructions body — plain markdown, appended to an accepting agent's system
+ * prompt when the skill is activated.
+ * ```
+ *
+ * Deliberately NOT a general-purpose YAML parser — the frontmatter shape is fixed and small
+ * (flat scalar keys + simple string-list keys), so a hand-rolled parser avoids taking on a new
+ * dependency for a narrow, fully-controlled need.
+ *
+ * @module @memberjunction/ai-agents
+ */
+const FRONTMATTER_DELIMITER = '---';
+export class SkillMarkdownConverter {
+    /**
+     * Parses a SKILL.md document into its frontmatter + instructions body. Throws with a clear
+     * message on malformed input (missing/unterminated frontmatter block, missing required `name`).
+     */
+    static Parse(markdownText) {
+        const normalized = markdownText.replace(/\r\n/g, '\n').trim();
+        const lines = normalized.split('\n');
+        if (lines[0]?.trim() !== FRONTMATTER_DELIMITER) {
+            throw new Error('Invalid SKILL.md: expected a frontmatter block starting with "---"');
+        }
+        const closingIndex = lines.findIndex((line, idx) => idx > 0 && line.trim() === FRONTMATTER_DELIMITER);
+        if (closingIndex === -1) {
+            throw new Error('Invalid SKILL.md: frontmatter block is not terminated with a closing "---"');
+        }
+        const frontmatterLines = lines.slice(1, closingIndex);
+        const instructions = lines.slice(closingIndex + 1).join('\n').trim();
+        const frontmatter = this.parseFrontmatterLines(frontmatterLines);
+        if (!frontmatter.name || frontmatter.name.trim().length === 0) {
+            throw new Error('Invalid SKILL.md: frontmatter is missing the required "name" field');
+        }
+        if (!instructions) {
+            throw new Error('Invalid SKILL.md: the Instructions body (after the frontmatter block) is empty');
+        }
+        return { frontmatter, instructions };
+    }
+    /**
+     * Serializes skill data into a SKILL.md document. The inverse of {@link Parse}.
+     */
+    static Serialize(params) {
+        const lines = [FRONTMATTER_DELIMITER];
+        lines.push(`name: ${this.escapeScalar(params.name)}`);
+        if (params.description) {
+            lines.push(`description: ${this.escapeScalar(params.description)}`);
+        }
+        if (params.category) {
+            lines.push(`category: ${this.escapeScalar(params.category)}`);
+        }
+        if (params.actionNames && params.actionNames.length > 0) {
+            lines.push('actions:');
+            for (const name of params.actionNames) {
+                lines.push(`  - ${this.escapeScalar(name)}`);
+            }
+        }
+        if (params.subAgentNames && params.subAgentNames.length > 0) {
+            lines.push('subAgents:');
+            for (const name of params.subAgentNames) {
+                lines.push(`  - ${this.escapeScalar(name)}`);
+            }
+        }
+        lines.push(FRONTMATTER_DELIMITER);
+        lines.push('');
+        lines.push(params.instructions.trim());
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Parses the frontmatter line block into a {@link SkillMarkdownFrontmatter}. Supports flat
+     * `key: value` scalars and `key:` followed by `  - item` list entries — nothing more complex
+     * (no nested objects, no multiline scalars). Unknown keys are ignored rather than erroring, so
+     * a future field addition doesn't break parsing of older SKILL.md files.
+     */
+    static parseFrontmatterLines(lines) {
+        const result = { name: '' };
+        let currentListKey = null;
+        for (const rawLine of lines) {
+            if (rawLine.trim().length === 0) {
+                continue;
+            }
+            const listItemMatch = rawLine.match(/^\s*-\s+(.*)$/);
+            if (listItemMatch && currentListKey) {
+                const value = this.unescapeScalar(listItemMatch[1]);
+                (result[currentListKey] ??= []).push(value);
+                continue;
+            }
+            const keyValueMatch = rawLine.match(/^([A-Za-z][A-Za-z0-9_]*)\s*:\s*(.*)$/);
+            if (!keyValueMatch) {
+                throw new Error(`Invalid SKILL.md frontmatter line: "${rawLine}"`);
+            }
+            const [, key, rawValue] = keyValueMatch;
+            const value = rawValue.trim();
+            if (key === 'actions' || key === 'subAgents') {
+                currentListKey = key;
+                if (value.length > 0) {
+                    // Inline list form, e.g. "actions: [Run Query, Generate PDF]" — split on commas.
+                    const inline = value.replace(/^\[/, '').replace(/\]$/, '');
+                    result[key] = inline.split(',').map(s => this.unescapeScalar(s.trim())).filter(s => s.length > 0);
+                    currentListKey = null;
+                }
+                continue;
+            }
+            currentListKey = null;
+            if (key === 'name' || key === 'description' || key === 'category') {
+                result[key] = this.unescapeScalar(value);
+            }
+            // Unknown scalar keys are silently ignored (forward-compatibility).
+        }
+        return result;
+    }
+    /** Quotes a scalar value if it contains a colon or leading/trailing whitespace that would otherwise break the simple parser. */
+    static escapeScalar(value) {
+        if (/^\s|\s$|:/.test(value)) {
+            return `"${value.replace(/"/g, '\\"')}"`;
+        }
+        return value;
+    }
+    /** Strips the quoting {@link escapeScalar} applies, if present. */
+    static unescapeScalar(value) {
+        const trimmed = value.trim();
+        if (trimmed.startsWith('"') && trimmed.endsWith('"') && trimmed.length >= 2) {
+            return trimmed.slice(1, -1).replace(/\\"/g, '"');
+        }
+        return trimmed;
+    }
+}
+//# sourceMappingURL=SkillMarkdownConverter.js.map

package/dist/SkillMarkdownConverter.js.map

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

package/dist/agent-types/loop-agent-response-type.d.ts

@@ -73,9 +73,9 @@ export interface LoopAgentResponse<P = any> {
      */
     nextStep?: {
         /**
-         * Operation type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While' | 'Pipeline'
+         * Operation type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While' | 'Pipeline' | 'Skill'
          */
-        type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While' | 'Pipeline';
+        type: 'Actions' | 'ClientTools' | 'Sub-Agent' | 'Chat' | 'Retry' | 'ForEach' | 'While' | 'Pipeline' | 'Skill' | 'Plan';
         /**
          * Actions to execute (when type='Actions')
          */
@@ -152,6 +152,27 @@ export interface LoopAgentResponse<P = any> {
          * While operation details (when type='While')
          */
         while?: WhileOperation;
+        /**
+         * Skills to activate (when type='Skill'). Reference by catalog Name only — you only ever
+         * see name + description for skills you haven't activated yet (progressive disclosure).
+         * Activating a skill appends its full instructions to your context and enables its
+         * bundled Actions/sub-agents for the rest of this run. This is NOT a nested agent run.
+         */
+        skills?: Array<{
+            name: string;
+            /**
+             * Brief (one sentence) rationale for why you are activating this skill — what the
+             * current task needs that the skill provides. Recorded in the run's audit trail
+             * (AIAgentRunStep.Skills) so humans can review why capabilities were expanded.
+             */
+            reason?: string;
+        }>;
+        /**
+         * The proposed plan (when type='Plan', Plan Mode only). Presenting a plan pauses the run
+         * and asks the human to approve or edit it via a response-form card before you may execute
+         * any Actions or Sub-Agents. See the Plan Mode section for when this is required.
+         */
+        plan?: string;
     };
 }
 //# sourceMappingURL=loop-agent-response-type.d.ts.map

package/dist/agent-types/loop-agent-response-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-response-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loop-agent-response-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":"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"}

package/dist/agent-types/loop-agent-response-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-response-type.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":";AAuLA,oEAAoE;AACpE,sDAAsD"}
+{"version":3,"file":"loop-agent-response-type.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":";AA8MA,oEAAoE;AACpE,sDAAsD"}

package/dist/agent-types/loop-agent-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEpL,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBACa,aAAc,SAAQ,aAAa;IAC5C,OAAO,CAAC,UAAU,CAAiC;IAEtC,wBAAwB,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3G;;;;;;;;;;;OAWG;IACU,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC7C,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA8NhC;;;;;;;OAOG;IACH,SAAS,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IAyI5F;;;;;;;OAOG;IACU,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EACzC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;OAUG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK/G;;;;;;;;;;;OAWG;IACU,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC9C,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvC;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAK3C;;;;;;;;;;;;;;;;;OAiBG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAChD,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,CAAC,EACjB,cAAc,EAAE,GAAG,EACnB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,6BAA6B;CAyBxC"}
+{"version":3,"file":"loop-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEpL,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBACa,aAAc,SAAQ,aAAa;IAC5C,OAAO,CAAC,UAAU,CAAiC;IAEtC,wBAAwB,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3G;;;;;;;;;;;OAWG;IACU,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC7C,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAuPhC;;;;;;;OAOG;IACH,SAAS,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IA+I5F;;;;;;;OAOG;IACU,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EACzC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;OAUG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK/G;;;;;;;;;;;OAWG;IACU,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC9C,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvC;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAK3C;;;;;;;;;;;;;;;;;OAiBG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAChD,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,CAAC,EACjB,cAAc,EAAE,GAAG,EACnB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,6BAA6B;CAyBxC"}

package/dist/agent-types/loop-agent-type.js

@@ -242,6 +242,31 @@ let LoopAgentType = class LoopAgentType extends BaseAgentType {
                         }));
                     }
                     break;
+                case 'Skill':
+                    if (!response.nextStep.skills || response.nextStep.skills.length === 0) {
+                        retVal.step = 'Retry';
+                        retVal.message = 'When nextStep.type == "Skill", 1 or more skills must be specified in nextStep.skills array';
+                        retVal.errorMessage = 'Skills not specified for Skill type';
+                    }
+                    else {
+                        retVal.step = 'Skill';
+                        retVal.skillActivations = response.nextStep.skills.map(skill => ({
+                            name: skill.name,
+                            ...(skill.reason ? { reason: skill.reason } : {})
+                        }));
+                    }
+                    break;
+                case 'Plan':
+                    if (!response.nextStep.plan || response.nextStep.plan.trim().length === 0) {
+                        retVal.step = 'Retry';
+                        retVal.message = 'When nextStep.type == "Plan", nextStep.plan must contain the proposed plan text';
+                        retVal.errorMessage = 'Plan text not specified for Plan type';
+                    }
+                    else {
+                        retVal.step = 'Plan';
+                        retVal.planDetails = { plan: response.nextStep.plan };
+                    }
+                    break;
                 case 'ForEach':
                     if (!response.nextStep.forEach) {
                         retVal.step = 'Retry';
@@ -356,7 +381,7 @@ let LoopAgentType = class LoopAgentType extends BaseAgentType {
         }
         // Validate nextStep structure if present
         if (response.nextStep) {
-            const validStepTypes = ['actions', 'sub-agent', 'chat', 'retry', 'foreach', 'while', 'clienttools', 'pipeline'];
+            const validStepTypes = ['actions', 'sub-agent', 'chat', 'retry', 'foreach', 'while', 'clienttools', 'pipeline', 'skill', 'plan'];
             let lcaseType = response.nextStep.type?.toLowerCase().trim();
             // allow the AI to mess up the case, but we need to validate it
             // be smart/lenient about missing types. if type is missing but we have a nextStep.subAgent/subAgents, default to sub-agent and if type is missing and we have nextStep.actions, default to actions
@@ -384,6 +409,14 @@ let LoopAgentType = class LoopAgentType extends BaseAgentType {
                 response.nextStep.type = 'Pipeline'; // update the data structure to have the correct type
                 lcaseType = 'pipeline';
             }
+            else if (!lcaseType && response.nextStep.skills && response.nextStep.skills.length > 0) {
+                response.nextStep.type = 'Skill'; // update the data structure to have the correct type
+                lcaseType = 'skill';
+            }
+            else if (!lcaseType && response.nextStep.plan) {
+                response.nextStep.type = 'Plan'; // update the data structure to have the correct type
+                lcaseType = 'plan';
+            }
             if (!validStepTypes.includes(lcaseType)) {
                 const message = `LoopAgentResponse has invalid nextStep.type: ${response.nextStep.type}`;
                 LogError(message);