@kanonak-protocol/cli 1.4.0 → 1.6.0

package/dist/agents/AgentDeploymentHandler.d.ts

@@ -0,0 +1,19 @@
+import type { DeploymentContext, DeploymentHandler, DeployedInstance, OperationContext } from '../capabilities/DeploymentHandlerRegistry.js';
+/**
+ * Deployment handler for the `AgentInstanceDeployment` DeploymentTarget.
+ *
+ * Transforms `kanonak.org/agents/Agent` instances into the target
+ * client's on-disk file format (markdown-with-frontmatter for
+ * Claude Code and Gemini CLI, TOML for Codex) and writes each one
+ * into the directory declared by the named Client instance selected
+ * via the `--client` option (defaulting to the "agents"
+ * cross-client layout).
+ */
+export declare class AgentDeploymentHandler implements DeploymentHandler {
+    private readonly parser;
+    private readonly objectParser;
+    private readonly runner;
+    deploy(context: DeploymentContext): Promise<void>;
+    undeploy(name: string, context: OperationContext): Promise<void>;
+    list(context: OperationContext): Promise<DeployedInstance[]>;
+}

package/dist/agents/AgentLock.d.ts

@@ -0,0 +1,15 @@
+export interface AgentLockEntry {
+    publisher: string;
+    package_: string;
+    version: string;
+    resolved: string;
+    integrity: string;
+    fileName: string;
+}
+export interface AgentLockFile {
+    version: string;
+    lastUpdated: string;
+    agents: Record<string, AgentLockEntry>;
+}
+export declare function loadAgentLock(agentsDir: string): AgentLockFile;
+export declare function saveAgentLock(agentsDir: string, lock: AgentLockFile): void;

package/dist/agents/AgentPaths.d.ts

@@ -0,0 +1,23 @@
+import type { IKanonakDocumentRepository } from '@kanonak-protocol/sdk';
+export type AgentFileFormat = 'markdown-frontmatter' | 'toml';
+export interface AgentPathOptions {
+    client?: string;
+    scope?: string;
+}
+export interface ResolvedAgentDeployment {
+    agentsDir: string;
+    format: AgentFileFormat;
+    fileExtension: string;
+}
+export declare function detectClient(): string | undefined;
+/**
+ * Resolve the agent deployment settings for the requested client
+ * and scope: the target directory plus the on-disk format to write.
+ *
+ * Goes through the SDK object model: agent-skills is parsed, Client
+ * instances are looked up by clientId, the selected Client's
+ * projectAgentDir / userAgentDir and agentFileFormat are read, and
+ * the AgentFileFormat reference is followed to extract the local
+ * name (markdown-frontmatter / toml).
+ */
+export declare function resolveAgentDeployment(options: AgentPathOptions, repository: IKanonakDocumentRepository): Promise<ResolvedAgentDeployment>;

package/dist/capabilities/DeploymentHandlerRegistry.d.ts

@@ -20,7 +20,8 @@ export interface DeployedInstance {
  *
  * `repository` is the broader repository (local cache + HTTP) that the
  * handler can use to fetch entities from other packages when needed
- * (e.g. a `Tool` instance defined in `agent-skills`).
+ * (e.g. a `Tool` instance or `Client` instance defined in
+ * `agent-skills`).
  */
 export interface DeploymentContext {
     instances: SubjectKanonak[];
@@ -28,6 +29,16 @@ export interface DeploymentContext {
     repository: IKanonakDocumentRepository;
     options: Record<string, string>;
 }
+/**
+ * Context passed to a deployment handler for lifecycle operations
+ * that are NOT about deploying a fresh instance (undeploy, list).
+ * Carries the broader repository so handlers can still resolve
+ * ontology entities like `Client` for per-product skill paths.
+ */
+export interface OperationContext {
+    repository: IKanonakDocumentRepository;
+    options: Record<string, string>;
+}
 /**
  * Handler that deploys/undeploys instances of a managed type to the
  * local system.
@@ -39,8 +50,8 @@ export interface DeploymentContext {
  */
 export interface DeploymentHandler {
     deploy(context: DeploymentContext): Promise<void>;
-    undeploy(name: string, options: Record<string, string>): Promise<void>;
-    list(options: Record<string, string>): Promise<DeployedInstance[]>;
+    undeploy(name: string, context: OperationContext): Promise<void>;
+    list(context: OperationContext): Promise<DeployedInstance[]>;
 }
 /**
  * Registry that maps a DeploymentTarget URI key to its handler.