@kici-dev/agent 0.1.14 → 0.1.15

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

@@ -1,4 +1,5 @@
 import { type AgentToOrchestratorMessage, type JobDispatch, type JobCancel } from '@kici-dev/engine';
+import type { CacheRequestIpc, CacheResponseIpc } from '../execution/sandbox/index.js';
 export type ConnectionState = 'disconnected' | 'connecting' | 'authenticating' | 'registering' | 'registered';
 interface OrchestratorClientOptions {
     /** WebSocket URL of the orchestrator. */
@@ -67,6 +68,8 @@ 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 concurrency report requests awaiting orchestrator ack. */
     private readonly pendingConcurrencyRequests;
     private readonly url;
@@ -184,6 +187,21 @@ 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>;
     /**
      * Send a job.context message to the orchestrator.
      *

package/package.json

@@ -1,18 +1,22 @@
 {
   "name": "@kici-dev/agent",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "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",
@@ -57,10 +61,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.15",
+    "@kici-dev/sdk": "0.1.15",
+    "@kici-dev/engine": "0.1.15",
+    "@kici-dev/shared": "0.1.15"
   },
   "kici": {
     "metrics": {

package/sbom.spdx.json

@@ -2,10 +2,10 @@
   "spdxVersion": "SPDX-2.3",
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
-  "name": "@kici-dev/agent@0.1.14",
-  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fagent/0.1.14/09c43db5-07b7-4b6e-aadf-3c88cd914ad9",
+  "name": "@kici-dev/agent@0.1.15",
+  "documentNamespace": "https://kici.dev/sbom/%40kici-dev%2Fagent/0.1.15/c153b3ce-90e6-427f-8c25-5fb714e6a0c5",
   "creationInfo": {
-    "created": "2026-05-30T03:06:30Z",
+    "created": "2026-06-11T03:03:58Z",
     "creators": [
       "Tool: kici-sbom-generator"
     ]
@@ -1065,7 +1065,7 @@
     {
       "SPDXID": "SPDXRef-RootPackage",
       "name": "@kici-dev/agent",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.15",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -1076,16 +1076,16 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/agent@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/agent@0.1.15"
         }
       ],
       "description": "Customer-deployable agent for the KiCI CI/CD stack. Connects to an orchestrator, clones the workflow repo, executes steps, and streams logs back.",
       "homepage": "https://kici.dev"
     },
     {
-      "SPDXID": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "SPDXID": "SPDXRef-Package--kici-dev-core-0.1.15",
       "name": "@kici-dev/core",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.15",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -1096,16 +1096,16 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/core@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/core@0.1.15"
         }
       ],
       "description": "Light shared utilities for the KiCI stack (logging, errors, formatting, crypto, zx init, the TypeScript ESM loader hook). No server-side dependencies.",
       "homepage": "https://kici.dev"
     },
     {
-      "SPDXID": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "SPDXID": "SPDXRef-Package--kici-dev-engine-0.1.15",
       "name": "@kici-dev/engine",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.15",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -1116,16 +1116,16 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/engine@0.1.15"
         }
       ],
       "description": "Shared business logic for the KiCI CI/CD stack: protocol, triggers, state machine, and provider interfaces used by the Platform relay, orchestrator, and compiler.",
       "homepage": "https://kici.dev"
     },
     {
-      "SPDXID": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "SPDXID": "SPDXRef-Package--kici-dev-sdk-0.1.15",
       "name": "@kici-dev/sdk",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.15",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -1136,16 +1136,16 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/sdk@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/sdk@0.1.15"
         }
       ],
       "description": "TypeScript SDK for defining KiCI workflows. Import into `.kici/workflows/*.ts` to declare workflows, jobs, steps, triggers, rules, and matrix configurations.",
       "homepage": "https://kici.dev"
     },
     {
-      "SPDXID": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "SPDXID": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "name": "@kici-dev/shared",
-      "versionInfo": "0.1.14",
+      "versionInfo": "0.1.15",
       "downloadLocation": "NOASSERTION",
       "filesAnalyzed": false,
       "licenseConcluded": "NOASSERTION",
@@ -1156,7 +1156,7 @@
         {
           "referenceCategory": "PACKAGE-MANAGER",
           "referenceType": "purl",
-          "referenceLocator": "pkg:npm/%40kici-dev/shared@0.1.14"
+          "referenceLocator": "pkg:npm/%40kici-dev/shared@0.1.15"
         }
       ],
       "description": "Shared utilities for the KiCI CI/CD stack — logging, zx setup, crypto, telemetry, health and metrics routes. No business logic.",
@@ -7448,22 +7448,22 @@
     },
     {
       "spdxElementId": "SPDXRef-RootPackage",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relationshipType": "DEPENDS_ON"
     },
     {
       "spdxElementId": "SPDXRef-RootPackage",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.15",
       "relationshipType": "DEPENDS_ON"
     },
     {
       "spdxElementId": "SPDXRef-RootPackage",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-sdk-0.1.15",
       "relationshipType": "DEPENDS_ON"
     },
     {
       "spdxElementId": "SPDXRef-RootPackage",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relationshipType": "DEPENDS_ON"
     },
     {
@@ -7502,182 +7502,182 @@
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-oxc-transform-0.128.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-picocolors-1.1.1",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-winston-daily-rotate-file-5.0.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-winston-3.19.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-zod-4.3.6",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-zx-8.8.5",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-jsonpath-plus-10.4.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-picomatch-4.0.4",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-engine-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-zod-4.3.6",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.15",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.15",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-engine-0.1.15",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-fast-cartesian-9.0.1",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-micromatch-4.0.8",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-zod-4.3.6",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-sdk-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-zx-8.8.5",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--aws-sdk-client-s3-3.1038.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
-      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
+      "relatedSpdxElement": "SPDXRef-Package--kici-dev-core-0.1.15",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-api-1.9.1",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-exporter-metrics-otlp-http-0.217.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-exporter-prometheus-0.217.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-exporter-trace-otlp-http-0.217.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-instrumentation-runtime-node-0.28.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-resources-2.7.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-sdk-node-0.217.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package--opentelemetry-semantic-conventions-1.40.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-diff-7.0.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-hono-4.12.18",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-kysely-0.29.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-oxc-transform-0.128.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-pg-8.20.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-picocolors-1.1.1",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-winston-daily-rotate-file-5.0.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-winston-3.19.0",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-yaml-2.8.3",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-zod-4.3.6",
       "relationshipType": "DEPENDS_ON"
     },
     {
-      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.14",
+      "spdxElementId": "SPDXRef-Package--kici-dev-shared-0.1.15",
       "relatedSpdxElement": "SPDXRef-Package-zx-8.8.5",
       "relationshipType": "DEPENDS_ON"
     },