@kici-dev/agent 0.1.14 → 0.1.16

package/dist/ws/orchestrator-client.d.ts

@@ -1,6 +1,7 @@
-import { type AgentToOrchestratorMessage, type JobDispatch, type JobCancel } from '@kici-dev/engine';
+import { type AgentToOrchestratorMessage, type JobDispatch, type JobCancel, type FleetLogsRequest } from '@kici-dev/engine';
+import type { CacheRequestIpc, CacheResponseIpc, StepApprovalRequestIpc, StepApprovalResolvedIpc } from '../execution/sandbox/index.js';
 export type ConnectionState = 'disconnected' | 'connecting' | 'authenticating' | 'registering' | 'registered';
-interface OrchestratorClientOptions {
+export interface OrchestratorClientOptions {
     /** WebSocket URL of the orchestrator. */
     url: string;
     /** Agent's unique identifier. */
@@ -34,6 +35,18 @@ interface OrchestratorClientOptions {
      * doesn't have to read process.env directly.
      */
     scalerManaged?: boolean;
+    /**
+     * Supplies the inputs for the agent fleet mini-bundle on a fleet.logs.request.
+     * Returns the agent's resolved config (redacted inside the bundle assembler),
+     * the log directory, and the current Prometheus metrics text. Omitted in
+     * tests / contexts that don't participate in fleet collection — the handler
+     * then replies with an empty-config bundle.
+     */
+    getFleetBundleInputs?: () => Promise<{
+        config: Record<string, unknown>;
+        logDir?: string;
+        metricsText?: string;
+    }>;
 }
 /**
  * WebSocket client that connects the agent to the customer orchestrator.
@@ -67,6 +80,15 @@ export declare class OrchestratorClient {
     private readonly pendingEventEmitRequests;
     /** Pending agent.api.request calls awaiting orchestrator response. */
     private readonly pendingApiRequests;
+    /** Pending user-cache restore/save requests awaiting orchestrator response. */
+    private readonly pendingUserCacheRequests;
+    /**
+     * Pending step-approval requests awaiting the orchestrator's resolution.
+     * No client-side timeout: the orchestrator owns the (org-/SDK-configured)
+     * expiry and sends `step.approval-resolved: expired` when it lapses. The
+     * workflow-runner carries an outer safety-net timeout.
+     */
+    private readonly pendingStepApprovals;
     /** Pending concurrency report requests awaiting orchestrator ack. */
     private readonly pendingConcurrencyRequests;
     private readonly url;
@@ -80,6 +102,7 @@ export declare class OrchestratorClient {
     private readonly getInFlightJobs?;
     private readonly roles;
     private readonly scalerManaged;
+    private readonly getFleetBundleInputs?;
     /** Timestamp when the connection was lost, used for gap marker outage duration. */
     private disconnectedAt;
     /** Set to true when auth.failure is received. Prevents retrying with a bad token. */
@@ -177,6 +200,12 @@ export declare class OrchestratorClient {
         deliveryId?: string;
         error?: string;
     }>;
+    /**
+     * Build this agent's fleet mini-bundle and stream it back to the orchestrator
+     * as ordered fleet.bundle.chunk frames (the WS frame cap forbids one frame).
+     * On failure, sends a single fleet.bundle.error. Public for unit testing.
+     */
+    streamFleetBundle(req: FleetLogsRequest): Promise<void>;
     /**
      * Send a typed API request to the orchestrator and await the response.
      *
@@ -184,6 +213,30 @@ export declare class OrchestratorClient {
      * KiciApi interface calls this with dot-namespaced method names.
      */
     sendApiRequest(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Relay a user-facing cache request from the sandbox to the orchestrator.
+     *
+     * Translates the sandbox `cache.request` IPC into the matching `cache.user.*`
+     * WS message and resolves with the orchestrator's response mapped onto the
+     * IPC response shape:
+     *
+     * - `restore` -> `cache.user.restore.request`, awaits `cache.user.restore.response`.
+     * - `beginSave` -> `cache.user.save.request`, awaits `cache.user.save.response`.
+     * - `completeSave` -> `cache.user.save.complete` (fire-and-forget; the
+     *   orchestrator commits temp -> final without replying), resolves immediately.
+     *
+     * Times out after 30 seconds for the round-trip ops.
+     */
+    requestUserCache(jobId: string, request: CacheRequestIpc): Promise<CacheResponseIpc>;
+    /**
+     * Relay a step-level approval request to the orchestrator. Sends a
+     * `step.approval-request` WS message and resolves with the orchestrator's
+     * `step.approval-resolved` mapped onto the IPC response shape. No client-side
+     * timeout — the orchestrator owns the approval expiry and replies with an
+     * `expired` outcome when it lapses. Rejects only on disconnect (the relay
+     * caller treats a rejection as a fail-closed reject).
+     */
+    sendStepApproval(runId: string, jobId: string, request: StepApprovalRequestIpc): Promise<StepApprovalResolvedIpc>;
     /**
      * Send a job.context message to the orchestrator.
      *
@@ -265,5 +318,4 @@ export declare class OrchestratorClient {
     private scheduleReconnect;
     private cancelReconnect;
 }
-export {};
 //# sourceMappingURL=orchestrator-client.d.ts.map

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "@kici-dev/agent",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Customer-deployable agent for the KiCI CI/CD stack. Connects to an orchestrator, clones the workflow repo, executes steps, and streams logs back.",
   "keywords": [
-    "kici",
     "ci",
-    "cd",
-    "ci-cd",
+    "cicd",
+    "continuous-integration",
     "typescript",
-    "workflows",
-    "devops",
+    "workflow",
     "agent",
     "runner"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kici-dev/kici-public.git",
+    "directory": "packages/agent"
+  },
+  "bugs": "https://github.com/kici-dev/kici-public/issues",
   "homepage": "https://kici.dev",
   "author": {
     "name": "KiCI",
@@ -50,6 +54,7 @@
   },
   "dependencies": {
     "@hono/node-server": "^2.0.0",
+    "archiver": "^7.0.1",
     "dockerode": "^5.0.0",
     "hono": "^4.12.18",
     "tar": "^7.5.13",
@@ -57,10 +62,10 @@
     "ws": "^8.20.0",
     "zod": "^4.3.6",
     "zx": "^8.8.5",
-    "@kici-dev/core": "0.1.14",
-    "@kici-dev/engine": "0.1.14",
-    "@kici-dev/sdk": "0.1.14",
-    "@kici-dev/shared": "0.1.14"
+    "@kici-dev/core": "0.1.16",
+    "@kici-dev/engine": "0.1.16",
+    "@kici-dev/shared": "0.1.16",
+    "@kici-dev/sdk": "0.1.16"
   },
   "kici": {
     "metrics": {
@@ -69,6 +74,7 @@
     }
   },
   "devDependencies": {
+    "@types/archiver": "^7.0.0",
     "@types/dockerode": "^4.0.1"
   },
   "scripts": {