deepclause-sdk 0.0.64 → 0.0.66

package/dist/system/runtime/shell-manager.js

@@ -1,6 +1,8 @@
 import { spawn } from 'child_process';
 import { AgentVMManager, } from './agentvm-manager.js';
 const ABORT_FORCE_KILL_MS = 500;
+const EXIT_STDIO_GRACE_MS = 25;
+const DEFAULT_HOST_SHELL_IDLE_TIMEOUT_MS = 180_000;
 export class HostShellManager {
     workspacePath;
     kind = 'host';
@@ -12,6 +14,7 @@ export class HostShellManager {
             throw abortError(signal.reason);
         }
         return new Promise((resolve, reject) => {
+            const idleTimeoutMs = getHostShellIdleTimeoutMs();
             const child = spawn('bash', ['-lc', command], {
                 cwd: this.workspacePath,
                 env: process.env,
@@ -24,10 +27,43 @@ export class HostShellManager {
             });
             let stdout = '';
             let stderr = '';
+            let exitCode = null;
+            let exitSignal = null;
+            let timedOut = false;
+            let idleTimer = null;
+            const resetIdleTimer = () => {
+                if (idleTimeoutMs <= 0 || settled || timedOut) {
+                    return;
+                }
+                if (idleTimer) {
+                    clearTimeout(idleTimer);
+                }
+                idleTimer = setTimeout(() => {
+                    if (settled || signal?.aborted) {
+                        return;
+                    }
+                    timedOut = true;
+                    exitCode = 124;
+                    stderr = stderr
+                        ? `${stderr}${stderr.endsWith('\n') ? '' : '\n'}Command timed out after ${idleTimeoutMs}ms without output`
+                        : `Command timed out after ${idleTimeoutMs}ms without output`;
+                    terminateChildProcessTree(child, 'SIGTERM');
+                    if (!forceKillTimer) {
+                        forceKillTimer = setTimeout(() => {
+                            if (child.exitCode === null && child.signalCode === null) {
+                                terminateChildProcessTree(child, 'SIGKILL');
+                            }
+                        }, ABORT_FORCE_KILL_MS);
+                        forceKillTimer.unref?.();
+                    }
+                }, idleTimeoutMs);
+                idleTimer.unref?.();
+            };
             child.stdout.setEncoding('utf8');
             child.stderr.setEncoding('utf8');
             child.stdout.on('data', (chunk) => {
                 stdout += chunk;
+                resetIdleTimer();
                 observer?.onStdout?.({
                     command,
                     chunk,
@@ -37,6 +73,7 @@ export class HostShellManager {
             });
             child.stderr.on('data', (chunk) => {
                 stderr += chunk;
+                resetIdleTimer();
                 observer?.onStderr?.({
                     command,
                     chunk,
@@ -45,7 +82,44 @@ export class HostShellManager {
                 });
             });
             let forceKillTimer = null;
+            let exitGraceTimer = null;
             let settled = false;
+            const maybeDestroyStreams = () => {
+                child.stdout.destroy?.();
+                child.stderr.destroy?.();
+            };
+            const buildResult = () => {
+                const resolvedExitCode = typeof exitCode === 'number'
+                    ? exitCode
+                    : (timedOut ? 124 : 1);
+                const signalSuffix = exitSignal ? ` (signal ${exitSignal})` : '';
+                return {
+                    success: resolvedExitCode === 0,
+                    stdout,
+                    stderr,
+                    exitCode: resolvedExitCode,
+                    pid: child.pid,
+                    backend: this.kind,
+                    summary: resolvedExitCode === 0
+                        ? 'Command completed successfully'
+                        : (timedOut ? `Command timed out after ${idleTimeoutMs}ms without output` : (stderr || `Command failed with exit code ${resolvedExitCode}${signalSuffix}`)),
+                };
+            };
+            const finalizeExit = (detachStreams = false) => {
+                if (detachStreams) {
+                    maybeDestroyStreams();
+                }
+                const result = buildResult();
+                observer?.onExit?.({
+                    command,
+                    pid: child.pid,
+                    backend: this.kind,
+                    success: result.success,
+                    exitCode: result.exitCode,
+                    summary: result.summary,
+                });
+                finalizeResolve(result);
+            };
             const finalizeReject = (error) => {
                 if (settled) {
                     return;
@@ -76,50 +150,49 @@ export class HostShellManager {
             };
             const cleanup = () => {
                 signal?.removeEventListener('abort', onAbort);
-            };
-            signal?.addEventListener('abort', onAbort, { once: true });
-            child.once('error', (error) => {
+                if (idleTimer) {
+                    clearTimeout(idleTimer);
+                    idleTimer = null;
+                }
                 if (forceKillTimer) {
                     clearTimeout(forceKillTimer);
                     forceKillTimer = null;
                 }
+                if (exitGraceTimer) {
+                    clearTimeout(exitGraceTimer);
+                    exitGraceTimer = null;
+                }
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+            resetIdleTimer();
+            child.once('error', (error) => {
                 if (signal?.aborted) {
                     finalizeReject(abortError(signal.reason));
                     return;
                 }
                 finalizeReject(error);
             });
-            child.once('close', (code, closeSignal) => {
-                if (forceKillTimer) {
-                    clearTimeout(forceKillTimer);
-                    forceKillTimer = null;
+            child.once('exit', (code, closeSignal) => {
+                exitCode = typeof code === 'number' ? code : 1;
+                exitSignal = closeSignal;
+                if (signal?.aborted || settled) {
+                    return;
                 }
+                exitGraceTimer = setTimeout(() => {
+                    if (!settled) {
+                        finalizeExit(true);
+                    }
+                }, EXIT_STDIO_GRACE_MS);
+                exitGraceTimer.unref?.();
+            });
+            child.once('close', (code, closeSignal) => {
+                exitCode = typeof code === 'number' ? code : (exitCode ?? 1);
+                exitSignal = closeSignal ?? exitSignal;
                 if (signal?.aborted) {
                     finalizeReject(abortError(signal.reason));
                     return;
                 }
-                const exitCode = typeof code === 'number' ? code : 1;
-                const signalSuffix = closeSignal ? ` (signal ${closeSignal})` : '';
-                const result = {
-                    success: exitCode === 0,
-                    stdout,
-                    stderr,
-                    exitCode,
-                    pid: child.pid,
-                    backend: this.kind,
-                    summary: exitCode === 0
-                        ? 'Command completed successfully'
-                        : (stderr || `Command failed with exit code ${exitCode}${signalSuffix}`),
-                };
-                observer?.onExit?.({
-                    command,
-                    pid: child.pid,
-                    backend: this.kind,
-                    success: result.success,
-                    exitCode,
-                    summary: result.summary,
-                });
-                finalizeResolve(result);
+                finalizeExit(false);
             });
         });
     }
@@ -133,6 +206,16 @@ export function createShellManager(options) {
     }
     return new HostShellManager(options.workspacePath);
 }
+function getHostShellIdleTimeoutMs() {
+    const raw = process.env.DC_HOST_SHELL_IDLE_TIMEOUT_MS;
+    if (raw != null) {
+        const parsed = Number.parseInt(raw, 10);
+        if (Number.isFinite(parsed) && parsed >= 0) {
+            return parsed;
+        }
+    }
+    return DEFAULT_HOST_SHELL_IDLE_TIMEOUT_MS;
+}
 function abortError(reason) {
     return reason instanceof Error
         ? reason

package/dist/system/runtime/shell-manager.js.map

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

package/dist/system/runtime/skill-creator.d.ts

@@ -33,4 +33,6 @@ export interface SkillCreatorCompileResult {
     usageByModel: TokenUsageByModel;
 }
 export declare function compileWithSkillCreator(markdown: string, options: SkillCreatorCompileOptions): Promise<SkillCreatorCompileResult>;
+export declare function normalizeSkillSlug(value: string, fallback?: string): string;
+export declare function deriveSkillSlugFromMarkdown(markdown: string, fallbackBaseName?: string): string;
 //# sourceMappingURL=skill-creator.d.ts.map

package/dist/system/runtime/skill-creator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-creator.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/skill-creator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAG9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAOpE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQ5E,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAeD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAYpC"}
+{"version":3,"file":"skill-creator.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/skill-creator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAG9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQpE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAS5E,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAeD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAYpC;AA2ZD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAU,GAAG,MAAM,CAsB5E;AAWD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,SAAU,GAAG,MAAM,CAahG"}

package/dist/system/runtime/skill-creator.js

@@ -8,6 +8,7 @@ import { readSystemPromptAsset, readSystemSkillAsset } from '../assets/index.js'
 import { listLocalSkillCatalog } from './catalog-skills.js';
 import { withCapturedConsole } from './console-capture.js';
 import { executeDml } from './dml-executor.js';
+import { truncateUrlFetchTextBody } from './runtime-tools.js';
 import { createShellManager } from './shell-manager.js';
 import { createShellToolEventBridge } from './shell-tool-events.js';
 import { recordTokenUsage } from './token-usage.js';
@@ -264,7 +265,7 @@ function registerSkillCreatorTools(sdk, context) {
             context.onPublish(published);
             return {
                 ok: true,
-                slug: context.baseName,
+                slug: published.slug,
                 version: published.meta.history.length,
             };
         },
@@ -281,7 +282,7 @@ async function buildSkillCreatorSystemPrompt(workspaceRoot, config, compileSelec
         '## LLM Access from Scripts',
         '',
         'The local CLI runtime does not provide an extra proxy-only script API.',
-        'Use DML task()/prompt() for LLM work unless you explicitly configure provider SDK access in your shell environment.',
+        'Use DML task()/prompt() when the skill needs open-ended LLM reasoning or text generation. Deterministic or simple skills can be pure Prolog plus exec()/consult() with no task() at all.',
         `The compile slot currently resolves to \`${compileSelection.id}\`.`,
     ].join('\n');
     const runtimeSection = sandbox
@@ -318,6 +319,11 @@ async function buildSkillCreatorSystemPrompt(workspaceRoot, config, compileSelec
 ## File-Based DML Only
 validate_dml, test_dml, and deploy_skill only accept file paths. Write the DML to disk first.
 
+## Deterministic Skills
+- It is fine for a skill to use no task()/prompt() when the workflow is mostly deterministic or simple.
+- In those cases, prefer direct Prolog predicates, consult/use_module, and exec() calls.
+- Add task()/prompt() only when the skill needs open-ended reasoning, extraction, summarization, classification, or free-form text generation.
+
 ## Reusing Existing Skills
 - Call list_skills when the requested functionality overlaps with an existing local skill.
 - Prefer narrow wrapper tool predicates that internally call exec(run_skill(...)) for one specific child skill.
@@ -325,25 +331,185 @@ validate_dml, test_dml, and deploy_skill only accept file paths. Write the DML t
 
 ${runtimeSection}${attemptSection}`;
 }
-function buildLocalMetadata(markdown, baseName) {
-    const name = baseName
-        .split(/[-_\s]+/)
+const SKILL_NAME_PATTERNS = [
+    /(?:called|named)\s+["']?([A-Za-z0-9][A-Za-z0-9 _-]{1,79})["']?/i,
+    /(?:create|build|make|write|generate|implement)(?:\s+me)?\s+(?:a|an|the)?\s*["']?([A-Za-z0-9][A-Za-z0-9 _-]{1,79}?)(?:["']?\s+skill\b|["']?$)/i,
+    /(?:create|build|make|write|generate|implement)(?:\s+me)?\s+(?:a|an|the)?\s+skill\s+(?:to|for|that)\s+["']?([A-Za-z0-9][A-Za-z0-9 _-]{1,79})["']?/i,
+];
+function cleanSkillLabel(value) {
+    return value
+        .trim()
+        .replace(/[`"']/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function findSkillNameCandidate(source) {
+    const heading = source.match(/^#\s+(.+)$/m)?.[1];
+    if (heading) {
+        const cleaned = cleanSkillLabel(heading);
+        if (cleaned) {
+            return cleaned;
+        }
+    }
+    for (const pattern of SKILL_NAME_PATTERNS) {
+        const match = pattern.exec(source);
+        if (!match?.[1]) {
+            continue;
+        }
+        const cleaned = cleanSkillLabel(match[1]);
+        if (cleaned) {
+            return cleaned;
+        }
+    }
+    return null;
+}
+function shortenSlug(slug, maxLength = 40) {
+    if (slug.length <= maxLength) {
+        return slug;
+    }
+    const boundary = slug.lastIndexOf('-', maxLength);
+    if (boundary >= Math.floor(maxLength / 2)) {
+        return slug.slice(0, boundary);
+    }
+    return slug.slice(0, maxLength).replace(/-+$/g, '');
+}
+export function normalizeSkillSlug(value, fallback = 'skill') {
+    const slug = shortenSlug(value
+        .trim()
+        .replace(/[`"']/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-+/g, '-'));
+    if (slug) {
+        return slug;
+    }
+    const fallbackSlug = fallback
+        .trim()
+        .replace(/[`"']/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .replace(/-+/g, '-');
+    return fallbackSlug || 'skill';
+}
+function formatSkillName(value) {
+    return cleanSkillLabel(value)
+        .replace(/[-_]+/g, ' ')
+        .split(/\s+/)
         .filter(Boolean)
         .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
         .join(' ');
+}
+export function deriveSkillSlugFromMarkdown(markdown, fallbackBaseName = 'skill') {
+    const fallbackSlug = normalizeSkillSlug(fallbackBaseName, 'skill');
+    const directCandidate = findSkillNameCandidate(markdown);
+    if (directCandidate) {
+        return normalizeSkillSlug(directCandidate, fallbackSlug);
+    }
+    const fallbackCandidate = findSkillNameCandidate(fallbackBaseName.replace(/[-_]+/g, ' '));
+    if (fallbackCandidate) {
+        return normalizeSkillSlug(fallbackCandidate, fallbackSlug);
+    }
+    return fallbackSlug;
+}
+function buildLocalMetadata(markdown, baseName) {
+    const slug = deriveSkillSlugFromMarkdown(markdown, baseName);
+    const nameCandidate = findSkillNameCandidate(markdown)
+        ?? findSkillNameCandidate(baseName.replace(/[-_]+/g, ' '))
+        ?? slug;
+    const name = formatSkillName(nameCandidate) || formatSkillName(slug);
     const description = extractDescription(markdown);
+    const triggerPhraseBase = name.replace(/\s+/g, ' ').trim().toLowerCase() || slug.replace(/[-_]+/g, ' ');
     const triggerPhrases = Array.from(new Set([
-        baseName.replace(/[-_]+/g, ' '),
-        `run ${baseName.replace(/[-_]+/g, ' ')}`,
-        `use ${baseName.replace(/[-_]+/g, ' ')}`,
+        triggerPhraseBase,
+        `run ${triggerPhraseBase}`,
+        `use ${triggerPhraseBase}`,
     ])).slice(0, 3);
     return {
-        slug: baseName,
-        name: name || baseName,
+        slug,
+        name: name || formatSkillName(slug),
         description,
         trigger_phrases: triggerPhrases,
     };
 }
+function normalizeParameterName(name) {
+    return name
+        .trim()
+        .replace(/[`"']/g, '')
+        .replace(/([A-Z])/g, (_m, c, i) => (i > 0 ? '_' : '') + c.toLowerCase())
+        .replace(/[\s-]+/g, '_')
+        .replace(/[^a-z0-9_]/g, '')
+        .replace(/_+/g, '_')
+        .replace(/^_+|_+$/g, '');
+}
+function extractParameterDocs(markdown) {
+    const parameterDocs = [];
+    const lines = markdown.split('\n');
+    let inParametersSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!inParametersSection) {
+            if (/^##\s+Parameters\b/i.test(trimmed)) {
+                inParametersSection = true;
+            }
+            continue;
+        }
+        if (/^##\s+/.test(trimmed)) {
+            break;
+        }
+        const match = /^-\s+`?([^`:(]+)`?\s*(?:\(([^)]*)\))?\s*:\s*(.+)$/.exec(trimmed);
+        if (!match) {
+            continue;
+        }
+        const [, rawName, qualifiers = '', description] = match;
+        const defaultMatch = /default\s*:\s*(?:"([^"]+)"|'([^']+)'|([^,]+))/i.exec(qualifiers);
+        const qualifierText = qualifiers.toLowerCase();
+        parameterDocs.push({
+            name: normalizeParameterName(rawName),
+            description: description.trim(),
+            required: qualifierText.includes('required')
+                ? true
+                : (qualifierText.includes('optional') || !!defaultMatch ? false : undefined),
+            default: defaultMatch
+                ? (defaultMatch[1] ?? defaultMatch[2] ?? defaultMatch[3]).trim()
+                : undefined,
+        });
+    }
+    return parameterDocs;
+}
+function mergeParameterDocs(parameters, parameterDocs) {
+    const docsByName = new Map(parameterDocs.map((parameterDoc) => [parameterDoc.name, parameterDoc]));
+    return parameters.map((parameter) => {
+        const parameterDoc = docsByName.get(parameter.name);
+        if (!parameterDoc) {
+            return parameter;
+        }
+        return {
+            ...parameter,
+            description: parameterDoc.description ?? parameter.description,
+            required: parameterDoc.required ?? parameter.required,
+            default: parameterDoc.default ?? parameter.default,
+        };
+    });
+}
+function extractSkillCapabilities(analysis) {
+    return Array.from(new Set(analysis.capabilities.filter((capability) => !capability.startsWith('tool_use('))));
+}
+function readMetadataName(metadata, fallbackName) {
+    const name = metadata['name'];
+    return typeof name === 'string' && name.trim() ? name.trim() : fallbackName;
+}
+function readMetadataTriggerPhrases(metadata, fallbackTriggerPhrases) {
+    const rawTriggerPhrases = Array.isArray(metadata['trigger_phrases'])
+        ? metadata['trigger_phrases']
+        : (Array.isArray(metadata['triggerPhrases']) ? metadata['triggerPhrases'] : fallbackTriggerPhrases);
+    return Array.from(new Set(rawTriggerPhrases
+        .filter((triggerPhrase) => typeof triggerPhrase === 'string')
+        .map((triggerPhrase) => triggerPhrase.trim())
+        .filter((triggerPhrase) => triggerPhrase.length > 0)))
+        .slice(0, 5);
+}
 async function writeWorkspaceFile(workspacePath, args) {
     const relPath = String(args.path ?? '');
     const content = String(args.content ?? '');
@@ -416,9 +582,13 @@ async function runLocalTestDml(context, args) {
 async function publishSkill(context, args) {
     const dmlPath = resolveWorkspacePath(context.workspacePath, String(args.dml_file ?? ''));
     const dml = await fs.readFile(dmlPath, 'utf8');
+    const fallbackMetadata = buildLocalMetadata(context.markdown, context.baseName);
     const normalized = normalizeDeployInputs(String(args.spec_markdown ?? context.markdown), String(args.metadata_json ?? ''));
-    const metadata = parseMetadataJson(normalized.metadataJson, buildLocalMetadata(context.markdown, context.baseName));
-    const publishName = context.baseName || String(args.slug_override ?? metadata.slug ?? 'skill');
+    const metadata = parseMetadataJson(normalized.metadataJson, fallbackMetadata);
+    const requestedSlug = typeof args.slug_override === 'string' && args.slug_override.trim()
+        ? args.slug_override
+        : (typeof metadata.slug === 'string' && metadata.slug.trim() ? metadata.slug : fallbackMetadata.slug);
+    const publishName = normalizeSkillSlug(requestedSlug, fallbackMetadata.slug);
     const meta = await buildMetaFile({
         dml,
         markdown: normalized.specMarkdown,
@@ -426,6 +596,8 @@ async function publishSkill(context, args) {
         publishName,
         model: context.compileSelection.model,
         provider: context.compileSelection.provider,
+        name: readMetadataName(metadata, fallbackMetadata.name),
+        triggerPhrases: readMetadataTriggerPhrases(metadata, fallbackMetadata.trigger_phrases),
         description: typeof metadata.description === 'string' ? metadata.description : extractDescription(normalized.specMarkdown),
     });
     const outputPath = path.join(context.outputDir, `${publishName}.dml`);
@@ -438,6 +610,7 @@ async function publishSkill(context, args) {
         dml,
         meta,
         outputPath,
+        slug: publishName,
     };
 }
 async function buildMetaFile(input) {
@@ -447,6 +620,8 @@ async function buildMetaFile(input) {
     const history = existing?.history ?? [];
     const analysis = await analyzeDML(input.dml);
     const tools = extractToolNames(analysis);
+    const parameters = mergeParameterDocs(extractParameters(input.dml), extractParameterDocs(input.markdown));
+    const capabilities = extractSkillCapabilities(analysis);
     return {
         version: '1.0.0',
         source: input.publishName,
@@ -454,8 +629,11 @@ async function buildMetaFile(input) {
         compiledAt: new Date().toISOString(),
         model: input.model,
         provider: input.provider,
+        name: input.name,
+        triggerPhrases: input.triggerPhrases.length > 0 ? input.triggerPhrases : undefined,
+        capabilities: capabilities.length > 0 ? capabilities : undefined,
         description: input.description,
-        parameters: extractParameters(input.dml),
+        parameters,
         tools,
         history: [
             ...history,
@@ -493,8 +671,13 @@ async function urlFetch(workspacePath, args, signal) {
             headers,
         };
     }
+    const body = await response.text();
+    const truncated = truncateUrlFetchTextBody(body);
     return {
-        body: await response.text(),
+        body: truncated.body,
+        truncated: truncated.truncated,
+        original_length: truncated.originalLength,
+        returned_length: truncated.returnedLength,
         status: response.status,
         headers,
     };
@@ -524,7 +707,8 @@ function looksLikeJsonObject(value) {
 }
 function parseMetadataJson(metadataJson, fallback) {
     try {
-        return JSON.parse(metadataJson);
+        const parsed = JSON.parse(metadataJson);
+        return parsed && typeof parsed === 'object' ? parsed : fallback;
     }
     catch {
         return fallback;