@agntk/core 0.1.0

package/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAqBxF,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAwF7E;AA6BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAkErF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAQ9D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CASlF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CA4CnE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAiBtE;AAMD,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,SAAI,GACR,iBAAiB,EAAE,CAkCrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAErE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAgCzD"}

package/dist/skills/loader.js

@@ -0,0 +1,400 @@
+/**
+ * @fileoverview Skills discovery and loading.
+ * Scans directories for SKILL.md files, parses YAML frontmatter,
+ * and builds system prompt injections.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:skills');
+const DEFAULT_SKILLS_DIRS = [
+    '.claude/skills',
+    '.cursor/skills',
+    '.agents/skills',
+    'skills',
+];
+const SKILL_FILENAME = 'SKILL.md';
+/** Known frontmatter fields from both native and skills.sh formats */
+const KNOWN_FIELDS = new Set([
+    'name', 'description', 'license', 'compatibility',
+    'metadata', 'allowed-tools', 'allowedTools', 'tools_deny', 'toolsDeny',
+    'tags', 'when_to_use', 'whenToUse', 'when-to-use',
+    'model', 'max_steps', 'maxSteps', 'max-steps',
+    'requires', 'requires-binaries', 'requires-env',
+]);
+/**
+ * Parse YAML frontmatter from a SKILL.md file.
+ * Accepts both native and skills.sh fields. Unknown fields are preserved in `extra`.
+ *
+ * Expects format:
+ * ---
+ * name: skill-name
+ * description: Short description
+ * license: MIT
+ * allowed-tools: [glob, grep, shell]
+ * ---
+ * ... markdown content ...
+ */
+export function parseSkillFrontmatter(content) {
+    const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/;
+    const match = content.match(frontmatterRegex);
+    if (!match) {
+        return { body: content };
+    }
+    const [, yaml, body] = match;
+    const result = { body: body.trim() };
+    const extra = {};
+    // Simple YAML key-value parsing (avoids adding a YAML dep to the SDK)
+    for (const line of yaml.split('\n')) {
+        const kvMatch = line.match(/^\s*([a-zA-Z_-]+)\s*:\s*(.+?)\s*$/);
+        if (!kvMatch)
+            continue;
+        const [, rawKey, value] = kvMatch;
+        const cleanValue = value.replace(/^['"]|['"]$/g, '');
+        const key = rawKey.toLowerCase();
+        switch (key) {
+            case 'name':
+                result.name = cleanValue;
+                break;
+            case 'description':
+                result.description = cleanValue;
+                break;
+            case 'tags':
+                result.tags = parseYamlList(cleanValue);
+                break;
+            case 'when_to_use':
+            case 'whentouse':
+            case 'when-to-use':
+                result.whenToUse = cleanValue;
+                break;
+            case 'model':
+                if (['fast', 'standard', 'reasoning', 'powerful'].includes(cleanValue)) {
+                    result.model = cleanValue;
+                }
+                break;
+            case 'max_steps':
+            case 'maxsteps':
+            case 'max-steps': {
+                const parsed = parseInt(cleanValue, 10);
+                if (!isNaN(parsed) && parsed > 0) {
+                    result.maxSteps = parsed;
+                }
+                break;
+            }
+            case 'requires-binaries':
+                result.requires = { ...result.requires, binaries: parseYamlList(cleanValue) };
+                break;
+            case 'requires-env':
+                result.requires = { ...result.requires, env: parseYamlList(cleanValue) };
+                break;
+            case 'license':
+                result.license = cleanValue;
+                break;
+            case 'compatibility':
+                result.compatibility = cleanValue;
+                break;
+            case 'allowed-tools':
+            case 'allowedtools':
+                result.allowedTools = parseYamlList(cleanValue);
+                break;
+            case 'tools_deny':
+            case 'toolsdeny':
+                result.toolsDeny = parseYamlList(cleanValue);
+                break;
+            default:
+                // Forward-compatible: store unknown fields in extra
+                extra[rawKey] = cleanValue;
+                break;
+        }
+    }
+    if (Object.keys(extra).length > 0) {
+        result.extra = extra;
+    }
+    // Map allowed-tools → tools_deny (inverse logic)
+    // If allowedTools is set but toolsDeny is not, compute toolsDeny
+    if (result.allowedTools && !result.toolsDeny) {
+        result.toolsDeny = mapAllowedToolsToToolsDeny(result.allowedTools);
+    }
+    return result;
+}
+/**
+ * Parse a simple YAML list value: "[a, b, c]" or "a, b, c"
+ */
+function parseYamlList(value) {
+    // Handle bracket syntax: [a, b, c]
+    const bracketMatch = value.match(/^\[(.+)\]$/);
+    const inner = bracketMatch ? bracketMatch[1] : value;
+    return inner.split(',').map(s => s.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean);
+}
+/** All known tool names in the SDK */
+const ALL_TOOLS = [
+    'glob', 'grep', 'shell', 'web', 'ast_grep_search',
+    'plan', 'deep_reasoning', 'spawn_agent', 'memory',
+    'file_read', 'file_write', 'file_edit', 'file_create',
+    'progress_read', 'progress_update',
+];
+/**
+ * Map skills.sh allowed-tools (allowlist) to our tools_deny (denylist).
+ * Inverse logic: tools NOT in allowed-tools go into tools_deny.
+ */
+function mapAllowedToolsToToolsDeny(allowedTools) {
+    const allowed = new Set(allowedTools.map(t => t.toLowerCase()));
+    return ALL_TOOLS.filter(t => !allowed.has(t));
+}
+/**
+ * Discover SKILL.md files in the given directories.
+ * Returns metadata for each discovered skill.
+ */
+export function discoverSkills(directories, basePath) {
+    const dirs = directories ?? DEFAULT_SKILLS_DIRS;
+    const base = basePath ?? process.cwd();
+    const skills = [];
+    for (const dir of dirs) {
+        const absoluteDir = path.isAbsolute(dir) ? dir : path.resolve(base, dir);
+        if (!fs.existsSync(absoluteDir)) {
+            log.debug('Skills directory does not exist, skipping', { dir: absoluteDir });
+            continue;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(absoluteDir, { withFileTypes: true });
+        }
+        catch (error) {
+            log.warn('Failed to read skills directory', { dir: absoluteDir, error: String(error) });
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillDir = path.join(absoluteDir, entry.name);
+            const skillFile = path.join(skillDir, SKILL_FILENAME);
+            if (!fs.existsSync(skillFile)) {
+                log.debug('No SKILL.md found in directory', { dir: skillDir });
+                continue;
+            }
+            try {
+                const content = fs.readFileSync(skillFile, 'utf-8');
+                const parsed = parseSkillFrontmatter(content);
+                const meta = {
+                    name: parsed.name ?? entry.name,
+                    description: parsed.description ?? `Skill from ${entry.name}`,
+                    path: skillFile,
+                    directory: skillDir,
+                };
+                if (parsed.tags)
+                    meta.tags = parsed.tags;
+                if (parsed.whenToUse)
+                    meta.whenToUse = parsed.whenToUse;
+                if (parsed.model)
+                    meta.model = parsed.model;
+                if (parsed.maxSteps)
+                    meta.maxSteps = parsed.maxSteps;
+                if (parsed.requires)
+                    meta.requires = parsed.requires;
+                if (parsed.license)
+                    meta.license = parsed.license;
+                if (parsed.compatibility)
+                    meta.compatibility = parsed.compatibility;
+                if (parsed.metadata)
+                    meta.metadata = parsed.metadata;
+                if (parsed.allowedTools)
+                    meta.allowedTools = parsed.allowedTools;
+                if (parsed.toolsDeny)
+                    meta.toolsDeny = parsed.toolsDeny;
+                if (parsed.extra)
+                    meta.extra = parsed.extra;
+                skills.push(meta);
+                log.debug('Discovered skill', { name: meta.name, path: skillFile });
+            }
+            catch (error) {
+                log.warn('Failed to parse skill', { path: skillFile, error: String(error) });
+            }
+        }
+    }
+    log.info('Skills discovery complete', { count: skills.length });
+    return skills;
+}
+/**
+ * Load the full content of a skill, including the markdown body.
+ */
+export function loadSkillContent(meta) {
+    const content = fs.readFileSync(meta.path, 'utf-8');
+    const { body } = parseSkillFrontmatter(content);
+    return {
+        ...meta,
+        content: body,
+    };
+}
+/**
+ * Load skills based on configuration.
+ * Supports both explicit paths and auto-discovery.
+ */
+export function loadSkills(config, basePath) {
+    const discovered = discoverSkills(config.directories, basePath);
+    // Filter by include list if provided
+    const filtered = config.include
+        ? discovered.filter(s => config.include.includes(s.name))
+        : discovered;
+    return filtered.map(loadSkillContent);
+}
+/**
+ * Load skills from explicit directory paths (each path IS the skill directory).
+ */
+export function loadSkillsFromPaths(paths) {
+    const skills = [];
+    for (const skillDir of paths) {
+        const absoluteDir = path.isAbsolute(skillDir) ? skillDir : path.resolve(process.cwd(), skillDir);
+        const skillFile = path.join(absoluteDir, SKILL_FILENAME);
+        if (!fs.existsSync(skillFile)) {
+            log.warn('SKILL.md not found', { path: skillFile });
+            continue;
+        }
+        try {
+            const content = fs.readFileSync(skillFile, 'utf-8');
+            const parsed = parseSkillFrontmatter(content);
+            const dirName = path.basename(absoluteDir);
+            const skill = {
+                name: parsed.name ?? dirName,
+                description: parsed.description ?? `Skill from ${dirName}`,
+                path: skillFile,
+                directory: absoluteDir,
+                content: parsed.body,
+            };
+            if (parsed.tags)
+                skill.tags = parsed.tags;
+            if (parsed.whenToUse)
+                skill.whenToUse = parsed.whenToUse;
+            if (parsed.model)
+                skill.model = parsed.model;
+            if (parsed.maxSteps)
+                skill.maxSteps = parsed.maxSteps;
+            if (parsed.requires)
+                skill.requires = parsed.requires;
+            if (parsed.license)
+                skill.license = parsed.license;
+            if (parsed.compatibility)
+                skill.compatibility = parsed.compatibility;
+            if (parsed.metadata)
+                skill.metadata = parsed.metadata;
+            if (parsed.allowedTools)
+                skill.allowedTools = parsed.allowedTools;
+            if (parsed.toolsDeny)
+                skill.toolsDeny = parsed.toolsDeny;
+            if (parsed.extra)
+                skill.extra = parsed.extra;
+            skills.push(skill);
+        }
+        catch (error) {
+            log.warn('Failed to load skill', { path: skillFile, error: String(error) });
+        }
+    }
+    return skills;
+}
+/**
+ * Build a system prompt section from loaded skills.
+ * Injects skill descriptions and instructions for the LLM.
+ */
+export function buildSkillsSystemPrompt(skills) {
+    if (skills.length === 0)
+        return '';
+    const sections = skills.map(skill => {
+        const header = `### ${skill.name}`;
+        const desc = skill.description ? `> ${skill.description}` : '';
+        return [header, desc, '', skill.content].filter(Boolean).join('\n');
+    });
+    return [
+        '',
+        '<skills>',
+        `You have ${skills.length} skill(s) available. Follow the instructions in each skill when relevant.`,
+        '',
+        ...sections,
+        '</skills>',
+    ].join('\n');
+}
+/**
+ * Search skills by keyword against name, description, tags, and whenToUse.
+ * Returns top matches ranked by relevance score.
+ */
+export function searchSkills(skills, query, limit = 5) {
+    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    if (terms.length === 0)
+        return [];
+    const scored = [];
+    for (const skill of skills) {
+        let score = 0;
+        const nameLower = skill.name.toLowerCase();
+        const descLower = skill.description.toLowerCase();
+        const tagsLower = (skill.tags ?? []).map(t => t.toLowerCase());
+        const whenLower = (skill.whenToUse ?? '').toLowerCase();
+        for (const term of terms) {
+            // Name match: highest weight
+            if (nameLower.includes(term))
+                score += 3;
+            // Tag match: high weight (exact match preferred)
+            if (tagsLower.some(t => t === term))
+                score += 2.5;
+            else if (tagsLower.some(t => t.includes(term)))
+                score += 1.5;
+            // whenToUse match
+            if (whenLower.includes(term))
+                score += 2;
+            // Description match: moderate weight
+            if (descLower.includes(term))
+                score += 1;
+        }
+        if (score > 0) {
+            scored.push({ skill, score });
+        }
+    }
+    // Sort by score descending, then by name for stability
+    scored.sort((a, b) => b.score - a.score || a.skill.name.localeCompare(b.skill.name));
+    return scored.slice(0, limit);
+}
+/**
+ * Filter skills to only those whose runtime requirements are met.
+ *
+ * Checks:
+ * - `requires.binaries`: each binary is found on PATH
+ * - `requires.env`: each env var is defined in process.env
+ *
+ * Skills with no requirements are always eligible.
+ */
+export function filterEligibleSkills(skills) {
+    return skills.filter(skill => isSkillEligible(skill));
+}
+/**
+ * Check if a single skill's runtime requirements are met.
+ */
+export function isSkillEligible(skill) {
+    if (!skill.requires)
+        return true;
+    // Check binaries on PATH
+    if (skill.requires.binaries) {
+        const pathDirs = (process.env.PATH ?? '').split(path.delimiter);
+        for (const binary of skill.requires.binaries) {
+            const found = pathDirs.some(dir => {
+                try {
+                    return fs.existsSync(path.join(dir, binary));
+                }
+                catch (_e) {
+                    return false;
+                }
+            });
+            if (!found) {
+                log.debug('Skill requirement not met: missing binary', { skill: skill.name, binary });
+                return false;
+            }
+        }
+    }
+    // Check env vars
+    if (skill.requires.env) {
+        for (const envVar of skill.requires.env) {
+            if (!(envVar in process.env)) {
+                log.debug('Skill requirement not met: missing env var', { skill: skill.name, envVar });
+                return false;
+            }
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Type definitions for the Skills system.
+ * Skills are SKILL.md files that agents can discover and inject into their system prompt.
+ */
+/**
+ * Metadata extracted from a SKILL.md file's YAML frontmatter.
+ * Supports both native and skills.sh fields.
+ */
+export interface SkillMeta {
+    /** Skill name from frontmatter */
+    name: string;
+    /** Short description from frontmatter */
+    description: string;
+    /** Absolute path to the SKILL.md file */
+    path: string;
+    /** Directory containing the skill (may include templates/, scripts/, resources/) */
+    directory: string;
+    /** Tags for search and categorization */
+    tags?: string[];
+    /** When this skill should be used (natural language guidance for the agent) */
+    whenToUse?: string;
+    /** Recommended model tier for this skill */
+    model?: 'fast' | 'standard' | 'reasoning' | 'powerful';
+    /** Maximum steps recommended for this skill */
+    maxSteps?: number;
+    /** Runtime requirements */
+    requires?: SkillRequirements;
+    /** License (skills.sh: license) */
+    license?: string;
+    /** Compatibility info (skills.sh: compatibility) */
+    compatibility?: string;
+    /** Arbitrary metadata (skills.sh: metadata) */
+    metadata?: Record<string, string>;
+    /** Tools the skill is allowed to use (skills.sh: allowed-tools) */
+    allowedTools?: string[];
+    /** Tools the skill should NOT use (inverse of allowed-tools) */
+    toolsDeny?: string[];
+    /** Additional unknown frontmatter fields (forward-compatible) */
+    extra?: Record<string, unknown>;
+}
+/** Runtime requirements a skill needs to function. */
+export interface SkillRequirements {
+    /** Binary executables required on PATH (e.g. ['git', 'node', 'docker']) */
+    binaries?: string[];
+    /** Environment variables required (e.g. ['OPENAI_API_KEY', 'DATABASE_URL']) */
+    env?: string[];
+}
+/**
+ * Full skill content including the markdown body.
+ */
+export interface SkillContent extends SkillMeta {
+    /** Full SKILL.md markdown content (excluding frontmatter) */
+    content: string;
+}
+/**
+ * Configuration for skill loading.
+ */
+export interface SkillsConfig {
+    /** Directories to scan for skills. Default: ['.agents/skills'] */
+    directories?: string[];
+    /** Auto-discover all skills in configured directories. Default: true */
+    autoDiscover?: boolean;
+    /** Specific skill names to include (if set, only these are loaded) */
+    include?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAIlB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IAEvD,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAI7B,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/skills/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Type definitions for the Skills system.
+ * Skills are SKILL.md files that agents can discover and inject into their system prompt.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/streaming/data-parts.d.ts

@@ -0,0 +1,163 @@
+/**
+ * @fileoverview Custom data part types for AI SDK streaming.
+ * These types define the shape of transient data streamed during agent execution.
+ *
+ * Usage with AI SDK:
+ * ```typescript
+ * import type { DataStreamWriter } from 'ai';
+ *
+ * const writer: DataStreamWriter = ...;
+ * writer.writeData({ type: 'file-content', data: { path: '/foo.ts', content: '...', truncated: false } });
+ * ```
+ */
+/**
+ * Union type of all custom data parts supported by the agent SDK.
+ * These are streamed transiently and not persisted to conversation context.
+ */
+export type AgentDataParts = {
+    /**
+     * Streaming output from a spawned sub-agent.
+     * Displayed as nested collapsible in UI.
+     */
+    'sub-agent-stream': SubAgentStreamData;
+    /**
+     * Search results from grep/glob/codebase search.
+     */
+    'search-result': SearchResultData;
+    /**
+     * File content streamed transiently (not added to context).
+     */
+    'file-content': FileContentData;
+    /**
+     * Shell command execution output.
+     */
+    'shell-output': ShellOutputData;
+    /**
+     * Progress indicator for long-running tools.
+     */
+    'tool-progress': ToolProgressData;
+    /**
+     * Reasoning/thinking step from deep reasoning tool.
+     */
+    'reasoning-step': ReasoningStepData;
+    /**
+     * Memory retrieval results.
+     */
+    'memory-result': MemoryResultData;
+};
+/** Sub-agent streaming data. */
+export interface SubAgentStreamData {
+    /** Unique identifier for the sub-agent instance. */
+    agentId: string;
+    /** Role of the sub-agent. */
+    role: string;
+    /** Streamed text content. */
+    text: string;
+    /** Status of the sub-agent stream. */
+    status: 'streaming' | 'complete' | 'error';
+    /** Error message if status is 'error'. */
+    error?: string;
+}
+/** Search result data from file/code search. */
+export interface SearchResultData {
+    /** File path relative to workspace root. */
+    path: string;
+    /** Matched content snippet. */
+    content: string;
+    /** Number of matches in the file. */
+    matches: number;
+    /** Line number of the first match. */
+    line?: number;
+    /** Search pattern used. */
+    pattern?: string;
+}
+/** File content data for transient streaming. */
+export interface FileContentData {
+    /** Absolute or relative file path. */
+    path: string;
+    /** File content. */
+    content: string;
+    /** Whether content was truncated due to size limits. */
+    truncated: boolean;
+    /** Total file size in bytes. */
+    totalBytes?: number;
+    /** MIME type of the file. */
+    mimeType?: string;
+    /** Language identifier for syntax highlighting. */
+    language?: string;
+    /** Line range if partial content. */
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+}
+/** Shell command output data. */
+export interface ShellOutputData {
+    /** Command that was executed. */
+    command: string;
+    /** Command output (stdout + stderr). */
+    output: string;
+    /** Exit code of the command. */
+    exitCode: number;
+    /** Working directory where command was executed. */
+    cwd?: string;
+    /** Whether output was truncated. */
+    truncated?: boolean;
+    /** Execution duration in milliseconds. */
+    durationMs?: number;
+}
+/** Tool progress indicator data. */
+export interface ToolProgressData {
+    /** Name of the tool being executed. */
+    toolName: string;
+    /** Progress percentage (0-100). */
+    progress: number;
+    /** Human-readable progress message. */
+    message: string;
+    /** Estimated time remaining in milliseconds. */
+    estimatedRemaining?: number;
+    /** Current step/total steps format. */
+    step?: {
+        current: number;
+        total: number;
+    };
+}
+/** Reasoning step from deep reasoning tool. */
+export interface ReasoningStepData {
+    /** Step number in the reasoning chain. */
+    stepNumber: number;
+    /** Total estimated steps. */
+    totalSteps: number;
+    /** The reasoning thought content. */
+    thought: string;
+    /** Whether this is a revision of a previous thought. */
+    isRevision?: boolean;
+    /** Which thought number is being revised. */
+    revisesThought?: number;
+    /** Branch identifier for alternative reasoning paths. */
+    branchId?: string;
+}
+/** Memory retrieval result data. */
+export interface MemoryResultData {
+    /** Memory entry content. */
+    content: string;
+    /** Similarity score (0-1). */
+    score: number;
+    /** Metadata associated with the memory. */
+    metadata?: Record<string, unknown>;
+    /** When the memory was stored. */
+    timestamp?: string;
+}
+/** Type helper to get data type for a specific part type. */
+export type DataPartType<K extends keyof AgentDataParts> = AgentDataParts[K];
+/** Type helper for creating typed data parts. */
+export interface TypedDataPart<K extends keyof AgentDataParts> {
+    type: K;
+    id?: string;
+    data: AgentDataParts[K];
+}
+/** Union of all possible data parts. */
+export type AnyDataPart = {
+    [K in keyof AgentDataParts]: TypedDataPart<K>;
+}[keyof AgentDataParts];
+//# sourceMappingURL=data-parts.d.ts.map