@codemieai/cdk 0.1.440 → 0.1.445

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { Integration, BaseDataSourceCreateParams, BaseCodeParams, DataSourceType, BaseConfluenceParams, BaseJiraParams, BaseGoogleParams, BaseFileParams, AssistantCreateParams, ToolKitDetails, ToolDetails, MCPServerDetails, WorkflowCreateParams, CodeMieClient } from 'codemie-sdk';
+import { AssistantCreateParams, ToolKitDetails, ToolDetails, Integration, MCPServerDetails, Assistant, BaseDataSourceCreateParams, BaseCodeParams, DataSourceType, BaseConfluenceParams, BaseJiraParams, BaseGoogleParams, BaseFileParams, WorkflowCreateParams, CodeMieClient } from 'codemie-sdk';
 
 declare const appConfigSchema: z.ZodObject<{
     rootDir: z.ZodString;
@@ -9,6 +9,9 @@ declare const appConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 type AppConfig = z.infer<typeof appConfigSchema>;
 
+type AssistantWithSkills = Assistant & {
+    skill_ids?: string[];
+};
 interface CodemieConfig {
     version: string;
     project: {
@@ -39,6 +42,7 @@ interface CodemieConfig {
         assistants?: AssistantResource[];
         datasources?: DatasourceResource[];
         workflows?: WorkflowResource[];
+        skills?: SkillResource[];
     };
 }
 type IntegrationDefinition = Integration;
@@ -113,6 +117,7 @@ interface AssistantResource extends Partial<Omit<AssistantCreateParams, 'project
     sub_assistants?: string[];
     datasource_names?: string[];
     categories?: string[];
+    skills?: string[];
 }
 /**
  * Base datasource configuration (IaC-specific fields only)
@@ -168,7 +173,7 @@ interface FileDatasourceResource extends BaseDatasourceConfig, Partial<BaseFileP
  * Other/generic datasource configuration (for any other SDK datasource types)
  */
 interface OtherDatasourceResource extends BaseDatasourceConfig {
-    type?: typeof DataSourceType.BEDROCK | typeof DataSourceType.CHUNK_SUMMARY | typeof DataSourceType.JSON | typeof DataSourceType.PROVIDER | typeof DataSourceType.SUMMARY;
+    type?: typeof DataSourceType.BEDROCK | typeof DataSourceType.JSON | typeof DataSourceType.PROVIDER;
 }
 /**
  * Discriminated union of all datasource types
@@ -176,6 +181,16 @@ interface OtherDatasourceResource extends BaseDatasourceConfig {
  * New datasource types in SDK will be automatically supported
  */
 type DatasourceResource = CodeDatasourceResource | ConfluenceDatasourceResource | JiraDatasourceResource | GoogleDatasourceResource | FileDatasourceResource | OtherDatasourceResource;
+/**
+ * Skill resource configuration (IaC layer)
+ */
+interface SkillResource {
+    name: string;
+    description: string;
+    file: string;
+    categories?: string[];
+    visibility?: string;
+}
 /**
  * Base Workflow configuration (IaC-specific fields only)
  */
@@ -208,6 +223,7 @@ interface StateFile {
         assistants: Record<string, AssistantState>;
         datasources: Record<string, DatasourceState>;
         workflows: Record<string, WorkflowState>;
+        skills: Record<string, SkillState>;
     };
 }
 interface AssistantState {
@@ -227,6 +243,12 @@ interface WorkflowState {
     workflowYamlChecksum: string;
     configChecksum: string;
 }
+interface SkillState {
+    id: string;
+    lastDeployed: string;
+    contentChecksum: string;
+    configChecksum: string;
+}
 interface WorkflowYaml {
     assistants: WorkflowAssistantReference[];
     states: WorkflowStateDefinition[];
@@ -250,7 +272,7 @@ interface WorkflowStateDefinition {
 }
 interface Change {
     type: 'create' | 'update' | 'no-change' | 'delete';
-    resourceType: 'assistant' | 'datasource' | 'workflow';
+    resourceType: 'assistant' | 'datasource' | 'workflow' | 'skill';
     name: string;
     details?: string;
 }
@@ -266,6 +288,10 @@ declare class CodemieConfigLoader {
      * Load assistant prompt file
      */
     loadPrompt(promptPath: string): string;
+    /**
+     * Load skill content file (.skill.md)
+     */
+    loadSkillContent(contentPath: string): string;
     /**
      * Load assistant configuration file
      */
@@ -421,23 +447,36 @@ declare class StateManager {
     deleteWorkflowState(name: string): void;
     /**
      * Get all managed resources (for cleanup/destroy)
-     * Returns: { assistants: [name1, name2], datasources: [name1], workflows: [name1] }
+     * Returns: { assistants: [name1, name2], datasources: [name1], workflows: [name1], skills: [name1] }
      */
     getAllManagedResources(): {
         assistants: string[];
         datasources: string[];
         workflows: string[];
+        skills: string[];
     };
     /**
      * Check if a resource is managed by IaC (exists in state.json)
-     * @param type Resource type ('assistant', 'datasource', 'workflow')
+     * @param type Resource type ('assistant', 'datasource', 'workflow', 'skill')
      * @param name Resource name
      */
-    isManagedResource(type: 'assistant' | 'datasource' | 'workflow', name: string): boolean;
+    isManagedResource(type: 'assistant' | 'datasource' | 'workflow' | 'skill', name: string): boolean;
     /**
      * Get ID by name for a specific resource type
      */
-    getIdByName(type: 'assistant' | 'datasource' | 'workflow', name: string): string | undefined;
+    getIdByName(type: 'assistant' | 'datasource' | 'workflow' | 'skill', name: string): string | undefined;
+    /**
+     * Update skill state (keyed by NAME)
+     */
+    updateSkillState(name: string, id: string, content: string, skillResource: SkillResource): void;
+    /**
+     * Get skill state by NAME
+     */
+    getSkillState(name: string): SkillState | undefined;
+    /**
+     * Delete skill state by NAME
+     */
+    deleteSkillState(name: string): void;
 }
 
 /**
@@ -456,9 +495,10 @@ interface CleanupResult {
         assistants: string[];
         datasources: string[];
         workflows: string[];
+        skills: string[];
     };
     errors: Array<{
-        type: 'assistant' | 'datasource' | 'workflow';
+        type: 'assistant' | 'datasource' | 'workflow' | 'skill';
         name: string;
         error: string;
     }>;
@@ -486,6 +526,7 @@ declare class CleanupManager {
         assistants: string[];
         datasources: string[];
         workflows: string[];
+        skills: string[];
     };
     /**
      * Delete orphaned resources from platform
@@ -496,6 +537,7 @@ declare class CleanupManager {
         assistants: string[];
         datasources: string[];
         workflows: string[];
+        skills?: string[];
     }): Promise<CleanupResult>;
     /**
      * Get summary of orphaned resources
@@ -504,6 +546,7 @@ declare class CleanupManager {
         assistants: string[];
         datasources: string[];
         workflows: string[];
+        skills?: string[];
     }): string;
 }
 
@@ -538,6 +581,11 @@ interface DeploymentStats {
  * Extracted from main() for better maintainability
  */
 declare function deployAssistants(config: ReturnType<CodemieConfigLoader['loadConfig']>, client: Awaited<ReturnType<typeof createClient>>, loader: CodemieConfigLoader, stateManager: StateManager): Promise<DeploymentStats>;
+/**
+ * Deploy all skills from configuration
+ * Skills must be deployed before assistants so skill_ids can be resolved
+ */
+declare function deploySkills(config: ReturnType<CodemieConfigLoader['loadConfig']>, client: Awaited<ReturnType<typeof createClient>>, loader: CodemieConfigLoader, stateManager: StateManager): Promise<DeploymentStats>;
 /**
  * Deploy all datasources from configuration
  * Extracted from main() for better maintainability
@@ -576,9 +624,20 @@ declare function backupResources(options: {
     appConfig: AppConfig;
 }): Promise<void>;
 
+type ImportResourceType = 'assistant' | 'datasource' | 'workflow' | 'skill';
+interface ImportOptions {
+    appConfig: AppConfig;
+    resourceType: ImportResourceType;
+    slug: string;
+}
+/**
+ * Import a single resource from the CodeMie platform into the local IaC configuration.
+ */
+declare function importResource(options: ImportOptions): Promise<void>;
+
 declare function destroyResources(options: {
     appConfig: AppConfig;
     force?: boolean;
 }): Promise<void>;
 
-export { type AssistantConfig, type AssistantResource, type AssistantState, type Change, CleanupManager, type CodeDatasourceResource, type CodemieConfig, CodemieConfigLoader, type ConfluenceDatasourceResource, type DatasourceResource, type DatasourceState, type FileDatasourceResource, type GoogleDatasourceResource, type IaCMcpServer, type IaCTool, type IaCToolkit, type ImportedResource, type IntegrationDefinition, type IntegrationRef, type IntegrationReference, type JiraDatasourceResource, LogLevel, type OtherDatasourceResource, type StateFile, StateManager, type ToolDefinition, type WorkflowAssistantReference, type WorkflowResource, type WorkflowState, type WorkflowStateDefinition, type WorkflowYaml, backupResources, createClient, deployAssistants, deployDatasources, deployResources, deployWorkflows, destroyResources, logger, previewChanges, validateConfig };
+export { type AssistantConfig, type AssistantResource, type AssistantState, type AssistantWithSkills, type Change, CleanupManager, type CodeDatasourceResource, type CodemieConfig, CodemieConfigLoader, type ConfluenceDatasourceResource, type DatasourceResource, type DatasourceState, type FileDatasourceResource, type GoogleDatasourceResource, type IaCMcpServer, type IaCTool, type IaCToolkit, type ImportOptions, type ImportResourceType, type ImportedResource, type IntegrationDefinition, type IntegrationRef, type IntegrationReference, type JiraDatasourceResource, LogLevel, type OtherDatasourceResource, type SkillResource, type SkillState, type StateFile, StateManager, type ToolDefinition, type WorkflowAssistantReference, type WorkflowResource, type WorkflowState, type WorkflowStateDefinition, type WorkflowYaml, backupResources, createClient, deployAssistants, deployDatasources, deployResources, deploySkills, deployWorkflows, destroyResources, importResource, logger, previewChanges, validateConfig };