@agents-at-scale/ark 0.1.42 → 0.1.44

package/dist/lib/kubectl.js

@@ -18,3 +18,30 @@ export async function getResource(resourceType, name) {
     const result = await execa('kubectl', ['get', resourceType, name, '-o', 'json'], { stdio: 'pipe' });
     return JSON.parse(result.stdout);
 }
+export async function listResources(resourceType, options) {
+    const args = ['get', resourceType];
+    if (options?.sortBy) {
+        args.push(`--sort-by=${options.sortBy}`);
+    }
+    args.push('-o', 'json');
+    const result = await execa('kubectl', args, { stdio: 'pipe' });
+    const data = JSON.parse(result.stdout);
+    return data.items || [];
+}
+export async function deleteResource(resourceType, name, options) {
+    const args = ['delete', resourceType];
+    if (options?.all) {
+        args.push('--all');
+    }
+    else if (name) {
+        args.push(name);
+    }
+    await execa('kubectl', args, { stdio: 'pipe' });
+}
+export async function replaceResource(resource) {
+    const result = await execa('kubectl', ['replace', '-f', '-', '-o', 'json'], {
+        input: JSON.stringify(resource),
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    return JSON.parse(result.stdout);
+}

package/dist/lib/kubectl.spec.js

@@ -3,7 +3,7 @@ const mockExeca = jest.fn();
 jest.unstable_mockModule('execa', () => ({
     execa: mockExeca,
 }));
-const { getResource } = await import('./kubectl.js');
+const { getResource, listResources, deleteResource } = await import('./kubectl.js');
 describe('kubectl', () => {
     beforeEach(() => {
         jest.clearAllMocks();
@@ -85,4 +85,92 @@ describe('kubectl', () => {
             expect(mockExeca).toHaveBeenCalledWith('kubectl', ['get', 'agents', 'test-agent', '-o', 'json'], { stdio: 'pipe' });
         });
     });
+    describe('listResources', () => {
+        it('should list all resources of a given type', async () => {
+            const mockResources = [
+                {
+                    metadata: {
+                        name: 'query-1',
+                        creationTimestamp: '2024-01-01T00:00:00Z',
+                    },
+                    spec: {
+                        value: 'test1',
+                    },
+                },
+                {
+                    metadata: {
+                        name: 'query-2',
+                        creationTimestamp: '2024-01-02T00:00:00Z',
+                    },
+                    spec: {
+                        value: 'test2',
+                    },
+                },
+            ];
+            mockExeca.mockResolvedValue({
+                stdout: JSON.stringify({ items: mockResources }),
+            });
+            const result = await listResources('queries');
+            expect(result).toEqual(mockResources);
+            expect(mockExeca).toHaveBeenCalledWith('kubectl', ['get', 'queries', '-o', 'json'], { stdio: 'pipe' });
+        });
+        it('should return an empty array when no resources exist', async () => {
+            mockExeca.mockResolvedValue({
+                stdout: JSON.stringify({ items: [] }),
+            });
+            const result = await listResources('queries');
+            expect(result).toEqual([]);
+            expect(mockExeca).toHaveBeenCalledWith('kubectl', ['get', 'queries', '-o', 'json'], { stdio: 'pipe' });
+        });
+        it('should list resources with custom sort option', async () => {
+            const mockResources = [
+                {
+                    metadata: {
+                        name: 'query-1',
+                        creationTimestamp: '2024-01-01T00:00:00Z',
+                    },
+                },
+                {
+                    metadata: {
+                        name: 'query-2',
+                        creationTimestamp: '2024-01-02T00:00:00Z',
+                    },
+                },
+            ];
+            mockExeca.mockResolvedValue({
+                stdout: JSON.stringify({ items: mockResources }),
+            });
+            const result = await listResources('queries', {
+                sortBy: '.metadata.creationTimestamp',
+            });
+            expect(result).toEqual(mockResources);
+            expect(mockExeca).toHaveBeenCalledWith('kubectl', [
+                'get',
+                'queries',
+                '--sort-by=.metadata.creationTimestamp',
+                '-o',
+                'json',
+            ], { stdio: 'pipe' });
+        });
+        it('should handle kubectl errors when listing resources', async () => {
+            mockExeca.mockRejectedValue(new Error('kubectl connection error'));
+            await expect(listResources('queries')).rejects.toThrow('kubectl connection error');
+        });
+    });
+    describe('deleteResource', () => {
+        it('should delete a resource by name', async () => {
+            mockExeca.mockResolvedValue({
+                stdout: '',
+            });
+            await deleteResource('queries', 'test-query');
+            expect(mockExeca).toHaveBeenCalledWith('kubectl', ['delete', 'queries', 'test-query'], { stdio: 'pipe' });
+        });
+        it('should delete all resources of a type when all option is true', async () => {
+            mockExeca.mockResolvedValue({
+                stdout: '',
+            });
+            await deleteResource('queries', undefined, { all: true });
+            expect(mockExeca).toHaveBeenCalledWith('kubectl', ['delete', 'queries', '--all'], { stdio: 'pipe' });
+        });
+    });
 });

package/dist/lib/types.d.ts

@@ -94,6 +94,25 @@ export interface QueryTarget {
 }
 export interface QueryResponse {
     content?: string;
+    a2a?: {
+        contextId?: string;
+    };
+}
+export interface QueryStatus {
+    phase?: 'initializing' | 'running' | 'done' | 'error' | 'canceled';
+    conditions?: K8sCondition[];
+    responses?: QueryResponse[];
+    message?: string;
+    error?: string;
+    tokenUsage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    a2a?: {
+        contextId?: string;
+        taskId?: string;
+    };
 }
 export interface Query {
     apiVersion: string;
@@ -102,14 +121,10 @@ export interface Query {
     spec?: {
         input: string;
         targets: QueryTarget[];
+        sessionId?: string;
+        timeout?: string;
     };
-    status?: {
-        phase?: 'initializing' | 'running' | 'done' | 'error' | 'canceled';
-        conditions?: K8sCondition[];
-        responses?: QueryResponse[];
-        message?: string;
-        error?: string;
-    };
+    status?: QueryStatus;
 }
 export interface Tool {
     metadata: K8sMetadata;

package/dist/marketplaceServices.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Marketplace service definitions for external ARK marketplace resources
+ * Repository: https://github.com/mckinsey/agents-at-scale-marketplace
+ * Charts are installed from the public OCI registry
+ */
+import type { ArkService, ServiceCollection } from './types/arkService.js';
+/**
+ * Available marketplace services
+ * Charts are published to: oci://ghcr.io/mckinsey/agents-at-scale-marketplace/charts
+ */
+export declare const marketplaceServices: ServiceCollection;
+export declare function getMarketplaceService(name: string): ArkService | undefined;
+export declare function getAllMarketplaceServices(): ServiceCollection;
+export declare function isMarketplaceService(name: string): boolean;
+export declare function extractMarketplaceServiceName(path: string): string;

package/dist/marketplaceServices.js

@@ -0,0 +1,51 @@
+/**
+ * Marketplace service definitions for external ARK marketplace resources
+ * Repository: https://github.com/mckinsey/agents-at-scale-marketplace
+ * Charts are installed from the public OCI registry
+ */
+const MARKETPLACE_REGISTRY = 'oci://ghcr.io/mckinsey/agents-at-scale-marketplace/charts';
+/**
+ * Available marketplace services
+ * Charts are published to: oci://ghcr.io/mckinsey/agents-at-scale-marketplace/charts
+ */
+export const marketplaceServices = {
+    phoenix: {
+        name: 'phoenix',
+        helmReleaseName: 'phoenix',
+        description: 'AI/ML observability and evaluation platform with OpenTelemetry integration',
+        enabled: true,
+        category: 'marketplace',
+        namespace: 'phoenix',
+        chartPath: `${MARKETPLACE_REGISTRY}/phoenix`,
+        installArgs: ['--create-namespace'],
+        k8sServiceName: 'phoenix',
+        k8sServicePort: 6006,
+        k8sDeploymentName: 'phoenix',
+    },
+    langfuse: {
+        name: 'langfuse',
+        helmReleaseName: 'langfuse',
+        description: 'Open-source LLM observability and analytics platform with session tracking',
+        enabled: true,
+        category: 'marketplace',
+        namespace: 'telemetry',
+        chartPath: `${MARKETPLACE_REGISTRY}/langfuse`,
+        installArgs: ['--create-namespace'],
+        k8sServiceName: 'langfuse',
+        k8sServicePort: 3000,
+        k8sDeploymentName: 'langfuse-web',
+    },
+};
+export function getMarketplaceService(name) {
+    return marketplaceServices[name];
+}
+export function getAllMarketplaceServices() {
+    return marketplaceServices;
+}
+export function isMarketplaceService(name) {
+    return name.startsWith('marketplace/services/');
+}
+export function extractMarketplaceServiceName(path) {
+    // Extract service name from marketplace/services/phoenix
+    return path.replace(/^marketplace\/services\//, '');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-at-scale/ark",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "Ark CLI - Interactive terminal interface for ARK agents",
   "main": "dist/index.js",
   "type": "module",

package/templates/models/azure.yaml

@@ -7,7 +7,7 @@ stringData:
   # IMPORTANT: Environment variables must be substituted before applying
   # Use one of these methods:
   #   1. make models-apply (recommended)
-  #   2. make quickstart (full deployment)
+  #   2. devspace dev (full deployment)
   #   3. make fix-models (if you have broken queries)
   # Manual: export AZURE_API_KEY="key" && envsubst < models/{{ .Values.modelName }}.yaml | kubectl apply -f -
   token: ${AZURE_API_KEY}

package/templates/project/Makefile

@@ -29,7 +29,7 @@ DOCKER_BUILD_DIR := $(OUT_DIR)/docker
 .PHONY: help
 help: ## Show this help message
 	@echo "🚀 Quick Commands:"
-	@echo "  make quickstart     # 5-minute setup with proper resource dependency handling"
+	@echo "  devspace dev        # Deploy ARK to cluster"
 	@echo "  make resources-apply # Apply all custom resources in correct order"
 	@echo "  make fix-models     # Fix broken models (if you have query errors)"
 	@echo ""

package/templates/project/README.md

@@ -12,7 +12,7 @@ cd {{ .Values.projectName }}
 source .env  # Edit this file first with your API keys
 
 # 3. Deploy to your ARK cluster
-make quickstart
+devspace dev
 
 # 4. Check your deployment
 kubectl get agents,teams,queries --namespace {{ .Values.namespace }}

package/templates/project/scripts/setup.sh

@@ -104,5 +104,5 @@ echo -e "${BLUE}Next steps:${NC}"
 echo "  make install       # Deploy to Kubernetes"
 echo "  make status        # Check deployment"
 echo ""
-echo "Or use the quick start:"
-echo "  make quickstart   # One-command deploy"
+echo "Or use ARK CLI for deployment:"
+echo "  devspace dev      # Local development"