@datalayer/agent-runtimes 1.0.1 → 1.0.3

package/lib/specs/notifications.js

@@ -0,0 +1,187 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Notification Channel Definitions
+// ============================================================================
+export const API_PUSH_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'api-push',
+    version: '0.0.1',
+    name: 'API Push',
+    description: 'Push results to an external API endpoint via HTTP POST. Useful for integrating with downstream services, data warehouses, or event-driven architectures.',
+    icon: 'upload',
+    available: false,
+    coming_soon: true,
+    fields: [
+        {
+            name: 'url',
+            label: 'Endpoint URL',
+            type: 'string',
+            required: true,
+            placeholder: 'https://api.example.com/agent-results',
+        },
+        {
+            name: 'secret',
+            label: 'Signing Secret',
+            type: 'string',
+            required: false,
+            placeholder: 'Optional HMAC secret for payload signing',
+        },
+        {
+            name: 'include_output',
+            label: 'Include Output',
+            type: 'boolean',
+            required: false,
+            default: true,
+        },
+    ],
+};
+export const EMAIL_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'email',
+    version: '0.0.1',
+    name: 'Email',
+    description: 'Send notifications via email when agent events occur. Supports completion alerts, failure reports, and summary digests.',
+    icon: 'mail',
+    available: true,
+    coming_soon: false,
+    fields: [
+        {
+            name: 'recipients',
+            label: 'Recipients',
+            type: 'string',
+            required: true,
+            placeholder: 'ops@company.com, team-lead@company.com',
+        },
+        {
+            name: 'subject_template',
+            label: 'Subject Template',
+            type: 'string',
+            required: false,
+            placeholder: '[Agent] {{agent_name}} — {{event_type}}',
+        },
+        {
+            name: 'include_output',
+            label: 'Include Output',
+            type: 'boolean',
+            required: false,
+            default: true,
+        },
+    ],
+};
+export const SLACK_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'slack',
+    version: '0.0.1',
+    name: 'Slack',
+    description: 'Post notifications to a Slack channel or direct message when agent events occur. Supports rich message formatting with blocks.',
+    icon: 'bell',
+    available: true,
+    coming_soon: false,
+    fields: [
+        {
+            name: 'channel',
+            label: 'Channel',
+            type: 'string',
+            required: true,
+            placeholder: '#sales-analytics',
+        },
+        {
+            name: 'mention_on_failure',
+            label: 'Mention on Failure',
+            type: 'string',
+            required: false,
+            placeholder: '@oncall-team',
+        },
+        {
+            name: 'include_output',
+            label: 'Include Output',
+            type: 'boolean',
+            required: false,
+            default: false,
+        },
+    ],
+};
+export const TEAMS_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'teams',
+    version: '0.0.1',
+    name: 'Teams',
+    description: 'Post notifications to a Microsoft Teams channel via incoming webhook connector when agent events occur.',
+    icon: 'bell',
+    available: false,
+    coming_soon: true,
+    fields: [
+        {
+            name: 'webhook_url',
+            label: 'Webhook URL',
+            type: 'string',
+            required: true,
+            placeholder: 'https://outlook.office.com/webhook/...',
+        },
+        {
+            name: 'include_output',
+            label: 'Include Output',
+            type: 'boolean',
+            required: false,
+            default: false,
+        },
+    ],
+};
+export const WEBHOOK_NOTIFICATION_SPEC_0_0_1 = {
+    id: 'webhook',
+    version: '0.0.1',
+    name: 'Webhook',
+    description: 'Send notifications to a custom HTTP endpoint via POST request. Payload includes event type, agent metadata, and optional output.',
+    icon: 'bell',
+    available: false,
+    coming_soon: true,
+    fields: [
+        {
+            name: 'url',
+            label: 'Webhook URL',
+            type: 'string',
+            required: true,
+            placeholder: 'https://api.example.com/agent-events',
+        },
+        {
+            name: 'secret',
+            label: 'Signing Secret',
+            type: 'string',
+            required: false,
+            placeholder: 'Optional HMAC secret for payload signing',
+        },
+        {
+            name: 'include_output',
+            label: 'Include Output',
+            type: 'boolean',
+            required: false,
+            default: true,
+        },
+    ],
+};
+// ============================================================================
+// Notification Channel Catalog
+// ============================================================================
+export const NOTIFICATION_CATALOG = {
+    'api-push': API_PUSH_NOTIFICATION_SPEC_0_0_1,
+    email: EMAIL_NOTIFICATION_SPEC_0_0_1,
+    slack: SLACK_NOTIFICATION_SPEC_0_0_1,
+    teams: TEAMS_NOTIFICATION_SPEC_0_0_1,
+    webhook: WEBHOOK_NOTIFICATION_SPEC_0_0_1,
+};
+export function getNotificationSpecs() {
+    return Object.values(NOTIFICATION_CATALOG);
+}
+function resolveNotificationId(channelId) {
+    if (channelId in NOTIFICATION_CATALOG)
+        return channelId;
+    const idx = channelId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = channelId.slice(0, idx);
+        if (base in NOTIFICATION_CATALOG)
+            return base;
+    }
+    return channelId;
+}
+export function getNotificationSpec(channelId) {
+    return NOTIFICATION_CATALOG[resolveNotificationId(channelId)];
+}

package/lib/specs/outputs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Output Catalog
+ *
+ * Predefined output format configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { OutputSpec } from '../types';
+export declare const CSV_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const DASHBOARD_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const DOCUMENT_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const EMAIL_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const JSON_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const NOTEBOOK_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const SPREADSHEET_OUTPUT_SPEC_0_0_1: OutputSpec;
+export declare const OUTPUT_CATALOG: Record<string, OutputSpec>;
+export declare function getOutputSpecs(): OutputSpec[];
+export declare function getOutputSpec(outputId: string): OutputSpec | undefined;

package/lib/specs/outputs.js

@@ -0,0 +1,112 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Output Definitions
+// ============================================================================
+export const CSV_OUTPUT_SPEC_0_0_1 = {
+    id: 'csv',
+    version: '0.0.1',
+    name: 'CSV',
+    description: 'Deliver results as a CSV file for easy import into spreadsheets, data pipelines, or other analysis tools.',
+    icon: 'table',
+    supports_template: false,
+    supports_storage: true,
+    mime_types: ['text/csv'],
+};
+export const DASHBOARD_OUTPUT_SPEC_0_0_1 = {
+    id: 'dashboard',
+    version: '0.0.1',
+    name: 'Dashboard',
+    description: 'Deliver results as an interactive dashboard with charts, tables, and filter controls rendered in the browser.',
+    icon: 'graph',
+    supports_template: true,
+    supports_storage: true,
+    mime_types: ['text/html', 'application/json'],
+};
+export const DOCUMENT_OUTPUT_SPEC_0_0_1 = {
+    id: 'document',
+    version: '0.0.1',
+    name: 'Document',
+    description: 'Deliver results as a structured document (PDF, DOCX, or Markdown) suitable for sharing, archiving, or regulatory compliance.',
+    icon: 'file',
+    supports_template: true,
+    supports_storage: true,
+    mime_types: [
+        'application/pdf',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        'text/markdown',
+    ],
+};
+export const EMAIL_OUTPUT_SPEC_0_0_1 = {
+    id: 'email',
+    version: '0.0.1',
+    name: 'Email',
+    description: 'Send results as an email attachment or inline HTML body. Supports rich formatting with embedded tables and charts.',
+    icon: 'mail',
+    supports_template: true,
+    supports_storage: false,
+    mime_types: ['text/html', 'application/pdf'],
+};
+export const JSON_OUTPUT_SPEC_0_0_1 = {
+    id: 'json',
+    version: '0.0.1',
+    name: 'JSON',
+    description: 'Deliver results as structured JSON data, suitable for programmatic consumption by APIs, pipelines, or dashboards.',
+    icon: 'code',
+    supports_template: false,
+    supports_storage: true,
+    mime_types: ['application/json'],
+};
+export const NOTEBOOK_OUTPUT_SPEC_0_0_1 = {
+    id: 'notebook',
+    version: '0.0.1',
+    name: 'Notebook',
+    description: 'Deliver results as a Jupyter notebook with executable cells, inline visualizations, and rich markdown narrative.',
+    icon: 'file-code',
+    supports_template: true,
+    supports_storage: true,
+    mime_types: ['application/x-ipynb+json'],
+};
+export const SPREADSHEET_OUTPUT_SPEC_0_0_1 = {
+    id: 'spreadsheet',
+    version: '0.0.1',
+    name: 'Spreadsheet',
+    description: 'Deliver results as an Excel spreadsheet with formatted tables, charts, and multiple sheets for structured analysis.',
+    icon: 'table',
+    supports_template: true,
+    supports_storage: true,
+    mime_types: [
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    ],
+};
+// ============================================================================
+// Output Catalog
+// ============================================================================
+export const OUTPUT_CATALOG = {
+    csv: CSV_OUTPUT_SPEC_0_0_1,
+    dashboard: DASHBOARD_OUTPUT_SPEC_0_0_1,
+    document: DOCUMENT_OUTPUT_SPEC_0_0_1,
+    email: EMAIL_OUTPUT_SPEC_0_0_1,
+    json: JSON_OUTPUT_SPEC_0_0_1,
+    notebook: NOTEBOOK_OUTPUT_SPEC_0_0_1,
+    spreadsheet: SPREADSHEET_OUTPUT_SPEC_0_0_1,
+};
+export function getOutputSpecs() {
+    return Object.values(OUTPUT_CATALOG);
+}
+function resolveOutputId(outputId) {
+    if (outputId in OUTPUT_CATALOG)
+        return outputId;
+    const idx = outputId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = outputId.slice(0, idx);
+        if (base in OUTPUT_CATALOG)
+            return base;
+    }
+    return outputId;
+}
+export function getOutputSpec(outputId) {
+    return OUTPUT_CATALOG[resolveOutputId(outputId)];
+}

package/lib/specs/skills.d.ts

@@ -6,22 +6,13 @@
  * This file is AUTO-GENERATED from YAML specifications.
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
-export interface SkillSpec {
-    id: string;
-    name: string;
-    description: string;
-    module: string;
-    requiredEnvVars: string[];
-    optionalEnvVars: string[];
-    dependencies: string[];
-    tags: string[];
-    icon?: string;
-    emoji?: string;
-    enabled: boolean;
-}
-export declare const CRAWL_SKILL_SPEC: SkillSpec;
-export declare const GITHUB_SKILL_SPEC: SkillSpec;
-export declare const PDF_SKILL_SPEC: SkillSpec;
+import type { SkillSpec } from '../types';
+export declare const CRAWL_SKILL_SPEC_0_0_1: SkillSpec;
+export declare const EVENTS_SKILL_SPEC_0_0_1: SkillSpec;
+export declare const GITHUB_SKILL_SPEC_0_0_1: SkillSpec;
+export declare const JOKES_SKILL_SPEC_0_0_1: SkillSpec;
+export declare const PDF_SKILL_SPEC_0_0_1: SkillSpec;
+export declare const TEXT_SUMMARIZER_SKILL_SPEC_0_0_1: SkillSpec;
 export declare const SKILL_CATALOG: Record<string, SkillSpec>;
 export declare function getSkillSpecs(): SkillSpec[];
 export declare function getSkillSpec(skillId: string): SkillSpec | undefined;

package/lib/specs/skills.js

@@ -5,12 +5,16 @@
 // ============================================================================
 // Skill Definitions
 // ============================================================================
-export const CRAWL_SKILL_SPEC = {
+export const CRAWL_SKILL_SPEC_0_0_1 = {
     id: 'crawl',
+    version: '0.0.1',
     name: 'Web Crawl Skill',
     description: 'Web crawling and content extraction capabilities',
-    module: 'agent_skills.crawl',
-    requiredEnvVars: ['TAVILY_API_KEY'],
+    module: 'agent_skills.skills.crawl',
+    package: undefined,
+    method: undefined,
+    path: undefined,
+    requiredEnvVars: ['TAVILY_API_KEY:0.0.1'],
     optionalEnvVars: [],
     dependencies: ['requests>=2.31.0', 'beautifulsoup4>=4.12.0'],
     tags: ['web', 'crawl', 'scraping'],
@@ -18,12 +22,33 @@ export const CRAWL_SKILL_SPEC = {
     emoji: '🌐',
     enabled: true,
 };
-export const GITHUB_SKILL_SPEC = {
+export const EVENTS_SKILL_SPEC_0_0_1 = {
+    id: 'events',
+    version: '0.0.1',
+    name: 'Events Skill',
+    description: 'Event generation, enrichment, and lifecycle orchestration',
+    module: 'agent_skills.skills.events',
+    package: undefined,
+    method: undefined,
+    path: undefined,
+    requiredEnvVars: [],
+    optionalEnvVars: [],
+    dependencies: ['httpx>=0.27.0'],
+    tags: ['events', 'orchestration', 'automation'],
+    icon: 'bell',
+    emoji: '📅',
+    enabled: true,
+};
+export const GITHUB_SKILL_SPEC_0_0_1 = {
     id: 'github',
+    version: '0.0.1',
     name: 'GitHub Skill',
     description: 'GitHub repository management and code operations',
-    module: 'agent_skills.github',
-    requiredEnvVars: ['GITHUB_TOKEN'],
+    module: 'agent_skills.skills.github',
+    package: undefined,
+    method: undefined,
+    path: undefined,
+    requiredEnvVars: ['GITHUB_TOKEN:0.0.1'],
     optionalEnvVars: [],
     dependencies: ['PyGithub>=2.1.0'],
     tags: ['github', 'git', 'code'],
@@ -31,11 +56,32 @@ export const GITHUB_SKILL_SPEC = {
     emoji: '🐙',
     enabled: true,
 };
-export const PDF_SKILL_SPEC = {
+export const JOKES_SKILL_SPEC_0_0_1 = {
+    id: 'jokes',
+    version: '0.0.1',
+    name: 'Jokes Skill',
+    description: 'Return random jokes from a local path-based skill.',
+    module: undefined,
+    package: undefined,
+    method: undefined,
+    path: 'jokes',
+    requiredEnvVars: [],
+    optionalEnvVars: [],
+    dependencies: [],
+    tags: ['fun', 'humor', 'demo'],
+    icon: 'smiley',
+    emoji: '😄',
+    enabled: true,
+};
+export const PDF_SKILL_SPEC_0_0_1 = {
     id: 'pdf',
+    version: '0.0.1',
     name: 'PDF Processing Skill',
     description: 'PDF document reading, parsing, and extraction',
-    module: 'agent_skills.pdf',
+    module: 'agent_skills.skills.pdf',
+    package: undefined,
+    method: undefined,
+    path: undefined,
     requiredEnvVars: [],
     optionalEnvVars: [],
     dependencies: ['PyPDF2>=3.0.0', 'pdfplumber>=0.10.0'],
@@ -44,17 +90,48 @@ export const PDF_SKILL_SPEC = {
     emoji: '📄',
     enabled: true,
 };
+export const TEXT_SUMMARIZER_SKILL_SPEC_0_0_1 = {
+    id: 'text-summarizer',
+    version: '0.0.1',
+    name: 'Text Summarizer Skill',
+    description: 'Summarize text content using extractive and abstractive techniques. Use when the user asks for summaries, key points, or condensed versions of documents.',
+    module: undefined,
+    package: 'agent_skills.skills.text_summarizer',
+    method: 'summarize_text',
+    path: undefined,
+    requiredEnvVars: [],
+    optionalEnvVars: [],
+    dependencies: ['agent-skills>=0.0.1'],
+    tags: ['nlp', 'summarization', 'text-processing'],
+    icon: 'note',
+    emoji: '📝',
+    enabled: true,
+};
 // ============================================================================
 // Skill Catalog
 // ============================================================================
 export const SKILL_CATALOG = {
-    crawl: CRAWL_SKILL_SPEC,
-    github: GITHUB_SKILL_SPEC,
-    pdf: PDF_SKILL_SPEC,
+    crawl: CRAWL_SKILL_SPEC_0_0_1,
+    events: EVENTS_SKILL_SPEC_0_0_1,
+    github: GITHUB_SKILL_SPEC_0_0_1,
+    jokes: JOKES_SKILL_SPEC_0_0_1,
+    pdf: PDF_SKILL_SPEC_0_0_1,
+    'text-summarizer': TEXT_SUMMARIZER_SKILL_SPEC_0_0_1,
 };
 export function getSkillSpecs() {
     return Object.values(SKILL_CATALOG);
 }
+function resolveSkillId(skillId) {
+    if (skillId in SKILL_CATALOG)
+        return skillId;
+    const idx = skillId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = skillId.slice(0, idx);
+        if (base in SKILL_CATALOG)
+            return base;
+    }
+    return skillId;
+}
 export function getSkillSpec(skillId) {
-    return SKILL_CATALOG[skillId];
+    return SKILL_CATALOG[resolveSkillId(skillId)];
 }

package/lib/specs/teams/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Team Library - Subfolder Organization.
+ *
+ * THIS FILE IS AUTO-GENERATED. DO NOT EDIT MANUALLY.
+ */
+import type { TeamSpec } from '../../types';
+export declare const TEAM_SPECS: Record<string, TeamSpec>;
+/**
+ * Get a team specification by ID.
+ */
+export declare function getTeamSpec(teamId: string): TeamSpec | undefined;
+/**
+ * List all available team specifications.
+ *
+ * @param prefix - If provided, only return specs whose ID starts with this prefix.
+ */
+export declare function listTeamSpecs(prefix?: string): TeamSpec[];

package/lib/specs/teams/index.js

@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { TEAM_SPECS as ROOT_TEAMS } from './teams';
+// Merge all team specs from subfolders
+export const TEAM_SPECS = {
+    ...ROOT_TEAMS,
+};
+function resolveTeamId(teamId) {
+    if (teamId in TEAM_SPECS)
+        return teamId;
+    const idx = teamId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = teamId.slice(0, idx);
+        if (base in TEAM_SPECS)
+            return base;
+    }
+    return teamId;
+}
+/**
+ * Get a team specification by ID.
+ */
+export function getTeamSpec(teamId) {
+    return TEAM_SPECS[resolveTeamId(teamId)];
+}
+/**
+ * List all available team specifications.
+ *
+ * @param prefix - If provided, only return specs whose ID starts with this prefix.
+ */
+export function listTeamSpecs(prefix) {
+    const specs = Object.values(TEAM_SPECS);
+    return prefix !== undefined
+        ? specs.filter(s => s.id.startsWith(prefix))
+        : specs;
+}

package/lib/specs/teams/teams.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Team Specifications.
+ *
+ * THIS FILE IS AUTO-GENERATED from YAML team specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { TeamSpec } from '../../types';
+export declare const ANALYZE_CAMPAIGN_PERFORMANCE_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const ANALYZE_SUPPORT_TICKETS_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const AUDIT_INVENTORY_LEVELS_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const AUTOMATE_REGULATORY_REPORTING_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const COMPREHENSIVE_SALES_ANALYTICS_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const OPTIMIZE_GRID_OPERATIONS_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const PROCESS_CITIZEN_REQUESTS_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const PROCESS_CLINICAL_TRIAL_DATA_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const SYNC_CRM_CONTACTS_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const TEAM_SPECS: Record<string, TeamSpec>;
+/**
+ * Get a team specification by ID.
+ */
+export declare function getTeamSpec(teamId: string): TeamSpec | undefined;
+/**
+ * List all available team specifications.
+ *
+ * @param prefix - If provided, only return specs whose ID starts with this prefix.
+ */
+export declare function listTeamSpecs(prefix?: string): TeamSpec[];