@agents-at-scale/ark 0.1.56 → 0.1.59

package/dist/commands/install/index.d.ts

@@ -1,8 +1,10 @@
 import { Command } from 'commander';
 import type { ArkConfig } from '../../lib/config.js';
-export declare function installArk(config: ArkConfig, serviceName?: string, options?: {
+export declare function installArk(config: ArkConfig, serviceNames?: string[], options?: {
     yes?: boolean;
     waitForReady?: string;
     verbose?: boolean;
+    arkVersion?: string;
+    marketplaceVersion?: string;
 }): Promise<void>;
 export declare function createInstallCommand(config: ArkConfig): Command;

package/dist/commands/install/index.js

@@ -10,6 +10,38 @@ import { printNextSteps } from '../../lib/nextSteps.js';
 import ora from 'ora';
 import { waitForServicesReady, } from '../../lib/waitForReady.js';
 import { parseTimeoutToSeconds } from '../../lib/timeout.js';
+function isValidVersion(version) {
+    return /^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.-]+)?(\+[a-zA-Z0-9.-]+)?$/.test(version);
+}
+function isVersionNotFoundError(error, options) {
+    let errorMsg = '';
+    if (error && typeof error === 'object') {
+        const err = error;
+        // Check stderr first (execa captures this with pipe), then message
+        errorMsg = err.stderr || err.message || String(error);
+    }
+    else {
+        errorMsg = String(error);
+    }
+    if (options.arkVersion && errorMsg.includes(`:${options.arkVersion}: not found`)) {
+        return true;
+    }
+    if (options.marketplaceVersion && errorMsg.includes(`:${options.marketplaceVersion}: not found`)) {
+        return true;
+    }
+    return false;
+}
+function handleInstallError(error, service, options) {
+    if (isVersionNotFoundError(error, options)) {
+        const version = options.arkVersion || options.marketplaceVersion;
+        output.warning(`${service.name} version ${version} not found, skipping...`);
+        return true; // should continue to next service
+    }
+    // Other errors still fail
+    output.error(`failed to install ${service.name}`);
+    console.error(error);
+    process.exit(1);
+}
 async function uninstallPrerequisites(service, verbose = false) {
     if (!service.prerequisiteUninstalls?.length)
         return;
@@ -43,14 +75,35 @@ async function checkAndCleanFailedRelease(releaseName, namespace, verbose = fals
         // Ignore errors - prerequisite may not exist
     }
 }
-async function installService(service, verbose = false) {
+async function installService(service, verbose = false, arkVersionOverride, marketplaceVersionOverride) {
     await uninstallPrerequisites(service, verbose);
     await checkAndCleanFailedRelease(service.helmReleaseName, service.namespace, verbose);
+    let chartPath = service.chartPath;
+    // Override version for ARK core services
+    if (arkVersionOverride &&
+        chartPath.includes('ghcr.io/mckinsey/agents-at-scale-ark/charts')) {
+        chartPath = chartPath.replace(/:[^:]+$/, `:${arkVersionOverride}`);
+    }
+    // Override version for marketplace items
+    if (marketplaceVersionOverride &&
+        chartPath.includes('ghcr.io/mckinsey/agents-at-scale-marketplace/charts')) {
+        // Check if version tag exists after the last slash
+        const lastSlashIndex = chartPath.lastIndexOf('/');
+        const afterLastSlash = chartPath.slice(lastSlashIndex + 1);
+        if (afterLastSlash.includes(':')) {
+            // Replace existing version
+            chartPath = chartPath.replace(/:[^:/]+$/, `:${marketplaceVersionOverride}`);
+        }
+        else {
+            // Append version
+            chartPath = `${chartPath}:${marketplaceVersionOverride}`;
+        }
+    }
     const helmArgs = [
         'upgrade',
         '--install',
         service.helmReleaseName,
-        service.chartPath,
+        chartPath,
     ];
     // Only add namespace flag if service has explicit namespace
     if (service.namespace) {
@@ -58,9 +111,21 @@ async function installService(service, verbose = false) {
     }
     // Add any additional install args
     helmArgs.push(...(service.installArgs || []));
-    await execute('helm', helmArgs, { stdio: 'inherit' }, { verbose });
+    await execute('helm', helmArgs, {
+        stdout: 'inherit',
+        stderr: 'pipe',
+    }, { verbose });
 }
-export async function installArk(config, serviceName, options = {}) {
+export async function installArk(config, serviceNames = [], options = {}) {
+    // Validate version strings
+    if (options.arkVersion && !isValidVersion(options.arkVersion)) {
+        output.error(`Invalid ARK version format: ${options.arkVersion}. Expected semantic versioning (e.g., 0.1.50)`);
+        process.exit(1);
+    }
+    if (options.marketplaceVersion && !isValidVersion(options.marketplaceVersion)) {
+        output.error(`Invalid marketplace version format: ${options.marketplaceVersion}. Expected semantic versioning (e.g., 0.1.7)`);
+        process.exit(1);
+    }
     // Validate that --wait-for-ready requires -y
     if (options.waitForReady && !options.yes) {
         output.error('--wait-for-ready requires -y flag for non-interactive mode');
@@ -75,69 +140,71 @@ export async function installArk(config, serviceName, options = {}) {
     // Show cluster info
     output.success(`connected to cluster: ${chalk.bold(clusterInfo.context)}`);
     console.log(); // Add blank line after cluster info
-    // If a specific service is requested, install only that service
-    if (serviceName) {
-        // Check if it's a marketplace item
-        if (isMarketplaceService(serviceName)) {
-            const service = await getMarketplaceItem(serviceName);
-            if (!service) {
-                output.error(`marketplace item '${serviceName}' not found`);
-                output.info('available marketplace items:');
-                const marketplaceServices = await getAllMarketplaceServices();
-                if (marketplaceServices) {
-                    for (const name of Object.keys(marketplaceServices)) {
-                        output.info(`  marketplace/services/${name}`);
+    // If specific services are requested, install only those services
+    if (serviceNames.length > 0) {
+        for (const serviceName of serviceNames) {
+            // Check if it's a marketplace item
+            if (isMarketplaceService(serviceName)) {
+                const service = await getMarketplaceItem(serviceName);
+                if (!service) {
+                    output.error(`marketplace item '${serviceName}' not found`);
+                    output.info('available marketplace items:');
+                    const marketplaceServices = await getAllMarketplaceServices();
+                    if (marketplaceServices) {
+                        for (const name of Object.keys(marketplaceServices)) {
+                            output.info(`  marketplace/services/${name}`);
+                        }
                     }
-                }
-                const marketplaceAgents = await getAllMarketplaceAgents();
-                if (marketplaceAgents) {
-                    for (const name of Object.keys(marketplaceAgents)) {
-                        output.info(`  marketplace/agents/${name}`);
+                    const marketplaceAgents = await getAllMarketplaceAgents();
+                    if (marketplaceAgents) {
+                        for (const name of Object.keys(marketplaceAgents)) {
+                            output.info(`  marketplace/agents/${name}`);
+                        }
+                    }
+                    const marketplaceExecutors = await getAllMarketplaceExecutors();
+                    if (marketplaceExecutors) {
+                        for (const name of Object.keys(marketplaceExecutors)) {
+                            output.info(`  marketplace/executors/${name}`);
+                        }
+                    }
+                    if (!marketplaceServices && !marketplaceAgents && !marketplaceExecutors) {
+                        output.warning('Marketplace unavailable');
                     }
+                    process.exit(1);
+                }
+                output.info(`installing marketplace item ${service.name}...`);
+                try {
+                    await installService(service, options.verbose, options.arkVersion, options.marketplaceVersion);
+                    output.success(`${service.name} installed successfully`);
                 }
-                const marketplaceExecutors = await getAllMarketplaceExecutors();
-                if (marketplaceExecutors) {
-                    for (const name of Object.keys(marketplaceExecutors)) {
-                        output.info(`  marketplace/executors/${name}`);
+                catch (error) {
+                    if (handleInstallError(error, service, options)) {
+                        continue;
                     }
                 }
-                if (!marketplaceServices && !marketplaceAgents && !marketplaceExecutors) {
-                    output.warning('Marketplace unavailable');
+                continue;
+            }
+            // Core ARK service
+            const services = getInstallableServices();
+            const service = Object.values(services).find((s) => s.name === serviceName);
+            if (!service) {
+                output.error(`service '${serviceName}' not found`);
+                output.info('available services:');
+                for (const s of Object.values(services)) {
+                    output.info(`  ${s.name}`);
                 }
                 process.exit(1);
             }
-            output.info(`installing marketplace item ${service.name}...`);
+            output.info(`installing ${service.name}...`);
             try {
-                await installService(service, options.verbose);
+                await installService(service, options.verbose, options.arkVersion, options.marketplaceVersion);
                 output.success(`${service.name} installed successfully`);
             }
             catch (error) {
-                output.error(`failed to install ${service.name}`);
-                console.error(error);
-                process.exit(1);
-            }
-            return;
-        }
-        // Core ARK service
-        const services = getInstallableServices();
-        const service = Object.values(services).find((s) => s.name === serviceName);
-        if (!service) {
-            output.error(`service '${serviceName}' not found`);
-            output.info('available services:');
-            for (const s of Object.values(services)) {
-                output.info(`  ${s.name}`);
+                if (handleInstallError(error, service, options)) {
+                    continue;
+                }
             }
-            process.exit(1);
-        }
-        output.info(`installing ${service.name}...`);
-        try {
-            await installService(service, options.verbose);
-            output.success(`${service.name} installed successfully`);
-        }
-        catch (error) {
-            output.error(`failed to install ${service.name}`);
-            console.error(error);
-            process.exit(1);
         }
         return;
     }
@@ -264,12 +331,15 @@ export async function installArk(config, serviceName, options = {}) {
             }
             output.info(`installing ${service.name}...`);
             try {
-                await installService(service, options.verbose);
+                await installService(service, options.verbose, options.arkVersion, options.marketplaceVersion);
                 console.log(); // Add blank line after command output
             }
-            catch {
+            catch (error) {
+                if (handleInstallError(error, service, options)) {
+                    console.log(); // Add blank line after warning
+                    continue;
+                }
                 console.log(); // Add blank line after error output
-                process.exit(1);
             }
         }
     }
@@ -295,17 +365,20 @@ export async function installArk(config, serviceName, options = {}) {
         for (const service of Object.values(services)) {
             output.info(`installing ${service.name}...`);
             try {
-                await installService(service, options.verbose);
+                await installService(service, options.verbose, options.arkVersion, options.marketplaceVersion);
                 console.log(); // Add blank line after command output
             }
-            catch {
+            catch (error) {
+                if (handleInstallError(error, service, options)) {
+                    console.log(); // Add blank line after warning
+                    continue;
+                }
                 console.log(); // Add blank line after error output
-                process.exit(1);
             }
         }
     }
     // Show next steps after successful installation
-    if (!serviceName || serviceName === 'all') {
+    if (serviceNames.length === 0) {
         printNextSteps();
     }
     // Wait for Ark to be ready if requested
@@ -350,12 +423,14 @@ export function createInstallCommand(config) {
     const command = new Command('install');
     command
         .description('Install ARK components using Helm')
-        .argument('[service]', 'specific service to install, or all if omitted')
+        .argument('[service...]', 'specific services to install, or all if omitted')
         .option('-y, --yes', 'automatically confirm all installations')
+        .option('--ark-version <version>', 'ARK version to install (e.g., 0.1.50, defaults to CLI version)')
+        .option('--marketplace-version <version>', 'Marketplace item version to install (e.g., 0.1.5)')
         .option('--wait-for-ready <timeout>', 'wait for Ark to be ready after installation (e.g., 30s, 2m)')
         .option('-v, --verbose', 'show commands being executed')
-        .action(async (service, options) => {
-        await installArk(config, service, options);
+        .action(async (services, options) => {
+        await installArk(config, services, options);
     });
     return command;
 }

package/dist/commands/uninstall/index.js

@@ -14,7 +14,7 @@ async function uninstallService(service, verbose = false) {
     }
     await execute('helm', helmArgs, { stdio: 'inherit' }, { verbose });
 }
-async function uninstallArk(config, serviceName, options = {}) {
+async function uninstallArk(config, serviceNames = [], options = {}) {
     // Check cluster connectivity from config
     if (!config.clusterInfo) {
         showNoClusterError();
@@ -24,38 +24,62 @@ async function uninstallArk(config, serviceName, options = {}) {
     // Show cluster info
     output.success(`connected to cluster: ${chalk.bold(clusterInfo.context)}`);
     console.log(); // Add blank line after cluster info
-    // If a specific service is requested, uninstall only that service
-    if (serviceName) {
-        // Check if it's a marketplace item
-        if (isMarketplaceService(serviceName)) {
-            const service = await getMarketplaceItem(serviceName);
-            if (!service) {
-                output.error(`marketplace item '${serviceName}' not found`);
-                output.info('available marketplace items:');
-                const marketplaceServices = await getAllMarketplaceServices();
-                if (marketplaceServices) {
-                    for (const name of Object.keys(marketplaceServices)) {
-                        output.info(`  marketplace/services/${name}`);
+    // If specific services are requested, uninstall only those services
+    if (serviceNames.length > 0) {
+        for (const serviceName of serviceNames) {
+            // Check if it's a marketplace item
+            if (isMarketplaceService(serviceName)) {
+                const service = await getMarketplaceItem(serviceName);
+                if (!service) {
+                    output.error(`marketplace item '${serviceName}' not found`);
+                    output.info('available marketplace items:');
+                    const marketplaceServices = await getAllMarketplaceServices();
+                    if (marketplaceServices) {
+                        for (const name of Object.keys(marketplaceServices)) {
+                            output.info(`  marketplace/services/${name}`);
+                        }
                     }
-                }
-                const marketplaceAgents = await getAllMarketplaceAgents();
-                if (marketplaceAgents) {
-                    for (const name of Object.keys(marketplaceAgents)) {
-                        output.info(`  marketplace/agents/${name}`);
+                    const marketplaceAgents = await getAllMarketplaceAgents();
+                    if (marketplaceAgents) {
+                        for (const name of Object.keys(marketplaceAgents)) {
+                            output.info(`  marketplace/agents/${name}`);
+                        }
                     }
-                }
-                const marketplaceExecutors = await getAllMarketplaceExecutors();
-                if (marketplaceExecutors) {
-                    for (const name of Object.keys(marketplaceExecutors)) {
-                        output.info(`  marketplace/executors/${name}`);
+                    const marketplaceExecutors = await getAllMarketplaceExecutors();
+                    if (marketplaceExecutors) {
+                        for (const name of Object.keys(marketplaceExecutors)) {
+                            output.info(`  marketplace/executors/${name}`);
+                        }
+                    }
+                    if (!marketplaceServices && !marketplaceAgents && !marketplaceExecutors) {
+                        output.warning('Marketplace unavailable');
                     }
+                    process.exit(1);
                 }
-                if (!marketplaceServices && !marketplaceAgents && !marketplaceExecutors) {
-                    output.warning('Marketplace unavailable');
+                output.info(`uninstalling marketplace item ${service.name}...`);
+                try {
+                    await uninstallService(service, options.verbose);
+                    output.success(`${service.name} uninstalled successfully`);
+                }
+                catch (error) {
+                    output.error(`failed to uninstall ${service.name}`);
+                    console.error(error);
+                    process.exit(1);
+                }
+                continue;
+            }
+            // Core ARK service
+            const services = getInstallableServices();
+            const service = Object.values(services).find((s) => s.name === serviceName);
+            if (!service) {
+                output.error(`service '${serviceName}' not found`);
+                output.info('available services:');
+                for (const s of Object.values(services)) {
+                    output.info(`  ${s.name}`);
                 }
                 process.exit(1);
             }
-            output.info(`uninstalling marketplace item ${service.name}...`);
+            output.info(`uninstalling ${service.name}...`);
             try {
                 await uninstallService(service, options.verbose);
                 output.success(`${service.name} uninstalled successfully`);
@@ -65,28 +89,6 @@ async function uninstallArk(config, serviceName, options = {}) {
                 console.error(error);
                 process.exit(1);
             }
-            return;
-        }
-        // Core ARK service
-        const services = getInstallableServices();
-        const service = Object.values(services).find((s) => s.name === serviceName);
-        if (!service) {
-            output.error(`service '${serviceName}' not found`);
-            output.info('available services:');
-            for (const s of Object.values(services)) {
-                output.info(`  ${s.name}`);
-            }
-            process.exit(1);
-        }
-        output.info(`uninstalling ${service.name}...`);
-        try {
-            await uninstallService(service, options.verbose);
-            output.success(`${service.name} uninstalled successfully`);
-        }
-        catch (error) {
-            output.error(`failed to uninstall ${service.name}`);
-            console.error(error);
-            process.exit(1);
         }
         return;
     }
@@ -134,11 +136,11 @@ export function createUninstallCommand(config) {
     const command = new Command('uninstall');
     command
         .description('Uninstall ARK components using Helm')
-        .argument('[service]', 'specific service to uninstall, or all if omitted')
+        .argument('[service...]', 'specific services to uninstall, or all if omitted')
         .option('-y, --yes', 'automatically confirm all uninstallations')
         .option('-v, --verbose', 'show commands being executed')
-        .action(async (service, options) => {
-        await uninstallArk(config, service, options);
+        .action(async (services, options) => {
+        await uninstallArk(config, services, options);
     });
     return command;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-at-scale/ark",
-  "version": "0.1.56",
+  "version": "0.1.59",
   "description": "Ark CLI - Interactive terminal interface for ARK agents",
   "main": "dist/index.js",
   "type": "module",
@@ -44,7 +44,7 @@
   "dependencies": {
     "@kubernetes/client-node": "^1.3.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "axios": "^1.13.5",
+    "axios": "^1.15.0",
     "chalk": "^4.1.2",
     "commander": "^12.1.0",
     "debug": "^4.4.1",
@@ -87,8 +87,10 @@
   "overrides": {
     "minimatch": "^10.2.3",
     "rollup": "4.59.0",
-    "hono": "^4.12.4",
-    "@hono/node-server": "^1.19.10",
-    "flatted": "^3.4.2"
+    "hono": "^4.12.12",
+    "@hono/node-server": "^1.19.13",
+    "flatted": "^3.4.2",
+    "tar": "^7.5.11",
+    "express-rate-limit": "^8.3.0"
   }
 }

package/templates/marketplace/README.md

@@ -1,197 +1,8 @@
-# ARK Marketplace
+# Ark Marketplace
 
-Welcome to the ARK Marketplace - a central repository for sharing reusable ARK components across projects and teams.
+The Ark Marketplace lives in a separate repository:
 
-## Overview
+**Repository**: https://github.com/mckinsey/agents-at-scale-marketplace
+**Documentation**: https://mckinsey.github.io/agents-at-scale-marketplace/
 
-The marketplace serves as a community-driven collection of:
-
-- **Agents** - Pre-configured AI agents for specific tasks
-- **Teams** - Multi-agent workflows and orchestration patterns
-- **Models** - Model configurations for different providers and use cases
-- **Tools** - Extensions that add capabilities to agents
-- **MCP Servers** - Model Context Protocol server implementations
-- **Queries** - Reusable query templates and patterns
-- **Projects** - Complete, end-to-end Ark project templates and solutions
-
-## Repository Structure
-
-```
-marketplace/
-├── agents/           # Reusable agent definitions
-├── teams/            # Multi-agent workflow configurations
-├── models/           # Model configurations by provider
-├── queries/          # Query templates and patterns
-├── tools/            # Tool definitions and implementations
-├── mcp-servers/      # MCP server configurations
-├── projects/         # Complete Ark project templates and solutions
-├── tests/            # Test configurations and utilities
-├── scripts/          # Automation and validation scripts
-├── docs/             # Documentation and guides
-├── templates/        # Component creation templates
-└── .github/          # GitHub workflows and templates
-```
-
-## Contributing Components
-
-### Getting Started
-
-1. **Fork** this repository
-2. **Choose** the appropriate directory for your component type
-3. **Copy** the relevant template from `templates/` directory
-4. **Implement** your component following the guidelines
-5. **Test** your component thoroughly
-6. **Submit** a pull request
-
-### Component Guidelines
-
-#### Agents (`agents/`)
-
-- One agent per subdirectory
-- Include `agent.yaml` with complete agent definition
-- Provide comprehensive `README.md` with usage examples
-- Test with multiple model providers when possible
-
-#### Teams (`teams/`)
-
-- Document the workflow strategy and use cases
-- Include example inputs and expected outputs
-- Explain when to use this team configuration
-- Test the complete workflow end-to-end
-
-#### Models (`models/`)
-
-- Organize by provider (openai/, anthropic/, etc.)
-- Include provider-specific configurations
-- Document capabilities, limitations, and costs
-- Specify recommended use cases
-
-#### Tools (`tools/`)
-
-- Follow Ark tool specification
-- Include source code and build instructions
-- Provide security considerations
-- Include comprehensive error handling
-
-#### MCP Servers (`mcp-servers/`)
-
-- Follow MCP protocol specifications
-- Document all available tools and resources
-- Include security and monitoring configurations
-- Provide integration examples
-
-#### Queries (`queries/`)
-
-- Make queries parameterizable where possible
-- Document expected inputs and outputs
-- Specify compatible agents and teams
-- Include usage examples
-
-#### Projects (`projects/`)
-
-- Provide complete, self-contained Ark project structures
-- Include comprehensive documentation with architecture overview
-- Specify all required dependencies (models, tools, external services)
-- Provide clear setup and deployment instructions
-- Include working examples and sample data where applicable
-- Document the use case and target scenarios
-- Follow Ark best practices for resource organization
-- Include multiple components working together (agents, teams, tools, etc.)
-
-### Quality Standards
-
-All contributions must meet these standards:
-
-- ✅ **Documentation** - Clear README with setup and usage instructions
-- ✅ **Security** - Follow security best practices
-- ✅ **Compatibility** - Work with latest Ark version
-- ✅ **Examples** - Provide working usage examples
-- ✅ **Validation** - Pass all automated validation checks
-
-### Submission Process
-
-1. **Create** your component following the guidelines above
-2. **Run** validation scripts: `scripts/validate-component.sh <component-path>`
-3. **Test** your component in a real environment
-4. **Submit** pull request with:
-   - Clear description of the component's purpose
-   - Usage examples and test results
-   - Documentation of any dependencies
-   - Screenshots or demos if applicable
-
-### Review Process
-
-1. **Automated Checks** - CI pipeline validates component structure and security
-2. **Community Review** - Other contributors provide feedback
-3. **Maintainer Review** - Core team performs final review
-4. **Approval** - Component is merged and becomes available
-
-## Using Marketplace Components
-
-### Finding Components
-
-- Browse directories by component type
-- Check `README.md` files for detailed descriptions
-- Look for tags and categories in component metadata
-- Use GitHub search to find specific functionality
-
-### Installing Components
-
-1. **Copy** the component files to your project
-2. **Customize** configuration as needed
-3. **Install** any dependencies listed in component README
-4. **Test** the component in your environment
-5. **Deploy** following your project's deployment process
-
-### Component Versioning
-
-Components follow semantic versioning:
-
-- **Major** - Breaking changes requiring migration
-- **Minor** - New features, backward compatible
-- **Patch** - Bug fixes and minor improvements
-
-## Support and Community
-
-### Getting Help
-
-- 📖 **Documentation** - Check `docs/` directory for guides
-- 💬 **Discussions** - Use GitHub Discussions for questions
-- 🐛 **Issues** - Report bugs or request features via GitHub Issues
-- 📧 **Contact** - Reach out to maintainers for urgent matters
-
-### Contributing Beyond Components
-
-We welcome contributions in many forms:
-
-- 📝 **Documentation** improvements
-- 🧪 **Testing** and validation improvements
-- 🔧 **Tooling** and automation enhancements
-- 🎨 **Templates** and examples
-- 🔍 **Reviews** and feedback on submissions
-
-## Governance
-
-### Maintainers
-
-The marketplace is maintained by the core team and trusted community contributors.
-
-### Licensing
-
-All contributions must be compatible with the project license. By contributing, you agree to license your contributions under the same terms.
-
-### Code of Conduct
-
-This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md). Please read and follow these guidelines in all interactions.
-
-## Quick Start
-
-Ready to contribute? Start here:
-
-1. **Explore** existing components for inspiration
-2. **Choose** a template from `templates/` directory
-3. **Read** the component-specific guidelines in `docs/`
-4. **Create** your component following the standards
-5. **Submit** your pull request
-
-Thank you for contributing to the {{ .Values.projectName }} Marketplace! 🚀
+See the marketplace repo for structure, contribution guidelines, and available components (executors, services, MCP servers, agents, demos).

package/templates/mcp-server/Dockerfile

@@ -95,7 +95,7 @@ ENTRYPOINT [ "/bin/sh", "-c", "mcp-proxy --debug --port 8080 --host 0.0.0.0 --sh
 {{- end }}
 
 {{- else if eq .Values.technology "python" }}
-FROM python:3.11-slim
+FROM python:3.11.13-slim
 
 WORKDIR /app
 

package/templates/project/tools/examples/data-tool/Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.11-slim
+FROM python:3.11.13-slim
 
 # Set working directory
 WORKDIR /app

package/templates/tool/Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.12-slim
+FROM python:3.12.11-slim
 
 WORKDIR /app
 

package/templates/marketplace/.editorconfig

@@ -1,24 +0,0 @@
-# EditorConfig is awesome: https://EditorConfig.org
-
-# top-most EditorConfig file
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false
-
-[Makefile]
-indent_style = tab
-
-[*.py]
-indent_size = 4
-
-[*.go]
-indent_style = tab

package/templates/marketplace/.github/.keep

@@ -1,11 +0,0 @@
-# GitHub Configuration Directory
-
-GitHub-specific configuration files for the marketplace repository.
-
-Expected contents:
-- workflows/ - GitHub Actions workflows
-- ISSUE_TEMPLATE/ - Issue templates
-- PULL_REQUEST_TEMPLATE.md - PR template
-- CODEOWNERS - Code ownership rules
-
-These files help maintain quality and consistency in contributions.

package/templates/marketplace/.github/workflows/.keep

@@ -1,16 +0,0 @@
-# GitHub Workflows Directory
-
-GitHub Actions workflows for automating marketplace operations.
-
-Common workflows:
-- component-validation.yml - Validate contributed components
-- security-scan.yml - Security scanning of components
-- documentation-build.yml - Build and deploy documentation
-- release.yml - Automated releases
-- pr-checks.yml - Pull request validation
-
-Workflows should:
-- Be efficient and reliable
-- Provide clear feedback
-- Follow security best practices
-- Be well-documented

package/templates/marketplace/.helmignore

@@ -1,23 +0,0 @@
-# Patterns to ignore when building packages.
-# This supports shell glob matching, relative path matching, and
-# negation (prefixed with !). Only one pattern per line.
-.DS_Store
-# Common VCS dirs
-.git/
-.gitignore
-.bzr/
-.bzrignore
-.hg/
-.hgignore
-.svn/
-# Common backup files
-*.swp
-*.bak
-*.tmp
-*.orig
-*~
-# Various IDEs
-.project
-.idea/
-*.tmproj
-.vscode/

package/templates/marketplace/.prettierrc.json

@@ -1,20 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "es5",
-  "singleQuote": true,
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "arrowParens": "avoid",
-  "bracketSpacing": true,
-  "proseWrap": "preserve",
-  "quoteProps": "as-needed",
-  "overrides": [
-    {
-      "files": "*.yaml",
-      "options": {
-        "singleQuote": false
-      }
-    }
-  ]
-}

package/templates/marketplace/.yamllint.yml

@@ -1,53 +0,0 @@
-# Default rules for yamllint
-extends: default
-
-rules:
-  # 120 chars should be enough, but don't fail if a line is longer
-  line-length:
-    max: 120
-    level: warning
-
-  # accept both       key:value and key: value
-  colons:
-    max-spaces-before: 0
-    max-spaces-after: -1
-
-  # don't bother me with tabs vs spaces issues
-  indentation:
-    spaces: consistent
-    indent-sequences: whatever
-
-  # allow empty values like 'key:'
-  empty-values:
-    forbid-in-block-mappings: false
-    forbid-in-flow-mappings: false
-
-  # sometimes you have to use quotes
-  quoted-strings:
-    quote-type: any
-    required: false
-
-  # allow trailing spaces in comments
-  trailing-spaces:
-    level: warning
-
-  # allow truthy values
-  truthy:
-    allowed-values: ['true', 'false', 'on', 'off', 'yes', 'no']
-    check-keys: false
-
-  # allow ! in yaml
-  comments:
-    require-starting-space: false
-    ignore-shebangs: true
-    min-spaces-from-content: 1
-
-  # brackets
-  brackets:
-    max-spaces-inside: 1
-    max-spaces-inside-empty: 0
-
-  # braces
-  braces:
-    max-spaces-inside: 1
-    max-spaces-inside-empty: 0

package/templates/marketplace/agents/.keep

@@ -1,29 +0,0 @@
-# Agents Directory
-
-This directory contains reusable agent definitions that can be shared across projects.
-
-## Structure
-
-Each agent should be in its own file or subdirectory (complex agents) with:
-
-- agent.yaml (the main agent definition)
-- README.md (documentation)
-- examples/ (optional usage examples)
-
-## Naming Convention
-
-Use descriptive names that indicate the agent's purpose:
-
-- data-analyst/
-- code-reviewer/
-- security-scanner/
-- documentation-writer/
-
-## Contributing
-
-When contributing an agent:
-
-1. Ensure it follows the Ark agent specification
-2. Include comprehensive documentation
-3. Provide usage examples
-4. Test with multiple models when possible

package/templates/marketplace/docs/.keep

@@ -1,19 +0,0 @@
-# Documentation Directory
-
-Documentation for the marketplace and its components.
-
-## Structure
-
-- contributing.md - Guidelines for contributors
-- component-specs/ - Specifications for different component types
-- best-practices/ - Development and usage best practices
-- tutorials/ - Step-by-step guides
-- api/ - API documentation
-
-## Documentation Standards
-
-1. Use clear, concise language
-2. Include code examples
-3. Keep documentation up-to-date
-4. Follow markdown conventions
-5. Include diagrams where helpful

package/templates/marketplace/marketplace.json.example

@@ -1,59 +0,0 @@
-{
-  "version": "1.0.0",
-  "marketplace": "ARK Marketplace",
-  "items": [
-    {
-      "name": "phoenix",
-      "displayName": "Phoenix",
-      "description": "AI/ML observability platform with OpenTelemetry integration",
-      "version": "0.1.5",
-      "author": "ARK Marketplace",
-      "homepage": "https://github.com/mckinsey/agents-at-scale-marketplace",
-      "repository": "https://github.com/mckinsey/agents-at-scale-marketplace",
-      "license": "Apache-2.0",
-      "tags": ["observability", "telemetry", "monitoring"],
-      "category": "observability",
-      "icon": "https://example.com/phoenix-icon.png",
-      "documentation": "https://mckinsey.github.io/agents-at-scale-marketplace/services/phoenix/",
-      "support": {
-        "url": "https://github.com/mckinsey/agents-at-scale-marketplace/issues"
-      },
-      "ark": {
-        "chartPath": "oci://ghcr.io/mckinsey/agents-at-scale-marketplace/charts/phoenix",
-        "namespace": "phoenix",
-        "helmReleaseName": "phoenix",
-        "installArgs": ["--create-namespace"],
-        "k8sServiceName": "phoenix",
-        "k8sServicePort": 6006,
-        "k8sDeploymentName": "phoenix"
-      }
-    },
-    {
-      "name": "langfuse",
-      "displayName": "Langfuse",
-      "description": "Open-source LLM observability and analytics platform with session tracking",
-      "version": "0.1.4",
-      "author": "ARK Marketplace",
-      "homepage": "https://github.com/mckinsey/agents-at-scale-marketplace",
-      "repository": "https://github.com/mckinsey/agents-at-scale-marketplace",
-      "license": "Apache-2.0",
-      "tags": ["observability", "analytics", "llm", "tracking"],
-      "category": "observability",
-      "icon": "https://example.com/langfuse-icon.png",
-      "documentation": "https://mckinsey.github.io/agents-at-scale-marketplace/services/langfuse/",
-      "support": {
-        "url": "https://github.com/mckinsey/agents-at-scale-marketplace/issues"
-      },
-      "ark": {
-        "chartPath": "oci://ghcr.io/mckinsey/agents-at-scale-marketplace/charts/langfuse",
-        "namespace": "telemetry",
-        "helmReleaseName": "langfuse",
-        "installArgs": ["--create-namespace"],
-        "k8sServiceName": "langfuse",
-        "k8sServicePort": 3000,
-        "k8sDeploymentName": "langfuse-web"
-      }
-    }
-  ]
-}
-

package/templates/marketplace/mcp-servers/.keep

@@ -1,32 +0,0 @@
-# MCP Servers Directory
-
-This directory contains Model Context Protocol (MCP) server configurations and implementations.
-
-## Structure
-
-Each MCP server should be in its own subdirectory with:
-
-- mcp-server.yaml (server configuration)
-- src/ (source code if custom implementation)
-- Dockerfile (if containerized)
-- README.md (documentation)
-- examples/ (usage examples)
-
-## Naming Convention
-
-Use descriptive names that indicate the server's purpose:
-
-- file-system-server/
-- database-server/
-- api-gateway-server/
-- knowledge-base-server/
-
-## Contributing
-
-When contributing an MCP server:
-
-1. Follow MCP protocol specifications
-2. Include security configurations
-3. Document all available tools/resources
-4. Provide integration examples
-5. Include monitoring and logging setup

package/templates/marketplace/models/.keep

@@ -1,23 +0,0 @@
-# Models Directory
-
-This directory contains model configurations for different AI providers and use cases.
-
-## Structure
-Each model configuration should be:
-- provider-specific directories (openai/, anthropic/, etc.)
-- model-specific YAML files within each directory
-- README.md documenting capabilities and limitations
-
-## Naming Convention
-Use provider and model names:
-- openai/gpt-4.yaml
-- anthropic/claude-3-sonnet.yaml
-- azure/gpt-4-32k.yaml
-- local/llama2-7b.yaml
-
-## Contributing
-When contributing a model configuration:
-1. Include provider-specific settings
-2. Document token limits and capabilities
-3. Specify recommended use cases
-4. Include cost considerations if applicable

package/templates/marketplace/projects/.keep

@@ -1,43 +0,0 @@
-# Projects Directory
-
-This directory contains complete, reusable Ark projects that demonstrate comprehensive use cases and multi-component solutions.
-
-## Purpose
-
-- **Full Project Templates**: Complete Ark project structures with multiple agents, teams, models, and tools working together
-- **End-to-End Solutions**: Real-world scenarios that showcase complex workflows and integrations
-- **Reference Implementations**: Best practices for structuring large-scale Ark deployments
-
-## Structure Guidelines
-
-Each project should include:
-
-- **Complete project structure**: All necessary YAML configurations
-- **README.md**: Detailed setup instructions, use case description, and architecture overview
-- **Documentation**: Architecture diagrams, workflow explanations, and deployment guides
-- **Examples**: Sample queries and expected outputs
-- **Dependencies**: Clear list of required models, tools, and external services
-
-## Naming Convention
-
-Use descriptive names that indicate the use case:
-
-- `customer-support-workflow/` - Multi-agent customer service system
-- `research-assistant-pipeline/` - Academic research and analysis workflow
-- `content-generation-studio/` - Creative content production system
-
-## Project Requirements
-
-- Each project must be self-contained and deployable
-- Include comprehensive documentation
-- Provide clear setup and configuration instructions
-- Include sample data or test cases where applicable
-- Follow Ark best practices for resource organization
-
-## Examples
-
-- Multi-agent workflows with specialized roles
-- Integration with external APIs and services
-- Complex data processing pipelines
-- Cross-functional team collaboration scenarios
-- Industry-specific solution templates

package/templates/marketplace/queries/.keep

@@ -1,25 +0,0 @@
-# Queries Directory
-
-This directory contains reusable query templates for common use cases.
-
-## Structure
-Each query should be in its own file or subdirectory:
-- query-name.yaml (simple queries)
-- complex-query/ (for queries with multiple files)
-  - query.yaml
-  - README.md
-  - examples/
-
-## Naming Convention
-Use descriptive names that indicate the query's purpose:
-- code-analysis.yaml
-- data-transformation.yaml
-- security-audit.yaml
-- document-summarization.yaml
-
-## Contributing
-When contributing a query:
-1. Make it parameterizable where possible
-2. Include clear documentation of expected inputs
-3. Provide example outputs
-4. Specify compatible agents/teams

package/templates/marketplace/teams/.keep

@@ -1,29 +0,0 @@
-# Teams Directory
-
-This directory contains reusable team configurations for multi-agent workflows.
-
-## Structure
-
-Each team should be in its own file (simple) or subdirectory (complex) with:
-
-- team.yaml (the main team definition)
-- README.md (documentation describing the workflow)
-- examples/ (optional usage examples)
-
-## Naming Convention
-
-Use descriptive names that indicate the team's workflow:
-
-- code-review-team/
-- data-pipeline-team/
-- content-creation-team/
-- security-audit-team/
-
-## Contributing
-
-When contributing a team:
-
-1. Document the team's workflow and strategy
-2. Explain when to use this team configuration
-3. Include examples of typical inputs and outputs
-4. Test the team configuration thoroughly

package/templates/marketplace/tools/.keep

@@ -1,32 +0,0 @@
-# Tools Directory
-
-This directory contains reusable tool definitions for extending agent capabilities.
-
-## Structure
-
-Each tool should be in its own subdirectory with:
-
-- tool.yaml (the main tool definition)
-- src/ (source code if applicable)
-- Dockerfile (if containerized)
-- README.md (documentation)
-- examples/ (usage examples)
-
-## Naming Convention
-
-Use descriptive names that indicate the tool's function:
-
-- file-processor/
-- database-connector/
-- api-client/
-- data-validator/
-
-## Contributing
-
-When contributing a tool:
-
-1. Follow the Ark tool specification
-2. Include comprehensive documentation
-3. Provide usage examples
-4. Ensure proper error handling
-5. Include security considerations

package/templates/marketplace/tools/examples/.keep

@@ -1,17 +0,0 @@
-# Tool Examples Directory
-
-This directory contains example tool implementations that can serve as templates.
-
-Examples should demonstrate:
-
-- Best practices for tool development
-- Common patterns and use cases
-- Integration with different agent types
-- Error handling and logging
-
-Each example should include:
-
-- Complete source code
-- Documentation
-- Build instructions
-- Testing guidelines