@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/README.md

@@ -0,0 +1,48 @@
+# @a5c-ai/genty-platform
+
+Agent Platform layer — harness integration, governance, interaction, storage.
+
+<!-- docs-status:start -->
+> Status: Public advanced/runtime package.
+> Canonical docs home: [Package and Plugin Docs Map](../../docs/package-and-plugin-map.md).
+> This README is the canonical runtime/platform API contract. The product CLI implementation lives in `@a5c-ai/genty`.
+<!-- docs-status:end -->
+
+## Installation
+
+```bash
+npm install @a5c-ai/genty-platform
+```
+
+## Usage
+
+Use this package as the reusable platform API layer. Install `@a5c-ai/genty` for the product CLI.
+
+```ts
+import { discoverHarnesses, invokeHarness } from "@a5c-ai/genty-platform/harness";
+import { apiRunStatus } from "@a5c-ai/genty-platform/api";
+```
+
+Use `@a5c-ai/genty` for the product CLI and the main `babysitter` CLI for harness installation and session-state commands:
+
+```bash
+babysitter harness:install claude-code
+babysitter harness:install-plugin claude-code
+babysitter session:state --session-id demo --state-dir .a5c
+```
+
+## Local Build
+
+From the repo root, run:
+
+```bash
+npm run build --workspace=@a5c-ai/genty-platform
+```
+
+This package now builds with `tsc --build` project references for workspace-owned TypeScript packages, and it explicitly invokes the root `build:runtime:agent-platform-deps` entrypoint to prepare the runtime chain, including the `@a5c-ai/adapters` SDK surface. A fresh-checkout build no longer requires prebuilt upstream `dist/` output.
+
+For the release/CI runtime chain, use the shared root entrypoint:
+
+```bash
+npm run build:runtime
+```

package/dist/anycli/cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * AnyCLI Cache Management
+ *
+ * Simple filesystem-based cache for agent-generated service artifacts.
+ * One cache.json per service under ~/.a5c/anycli/cache/<service>/.
+ * The agent decides freshness, structure, and invalidation -- this module
+ * is just convenience I/O.
+ */
+import type { AnycliServiceCache } from "./types";
+/**
+ * Returns the global cache directory for a service.
+ *
+ * @param service - Service identifier
+ * @returns Absolute path to `~/.a5c/anycli/cache/<service>/`
+ */
+export declare function getAnycliCacheDir(service: string): string;
+/**
+ * Reads a cached service entry if one exists.
+ *
+ * Returns `null` if no cache entry exists or the entry is corrupt.
+ *
+ * @param service - Service identifier
+ * @returns The cached service entry, or null
+ */
+export declare function readServiceCache(service: string): Promise<AnycliServiceCache | null>;
+/**
+ * Writes a service cache entry atomically.
+ *
+ * @param service - Service identifier
+ * @param cache - The cache entry to write
+ */
+export declare function writeServiceCache(service: string, cache: AnycliServiceCache): Promise<void>;
+/**
+ * Invalidates the cache for a service by removing its cache directory.
+ *
+ * @param service - Service identifier
+ */
+export declare function invalidateServiceCache(service: string): Promise<void>;
+/**
+ * Lists all cached service names.
+ *
+ * @returns Array of service identifier strings
+ */
+export declare function listCachedServices(): Promise<string[]>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/anycli/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/anycli/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAkBlD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAgB1F;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAc5D"}

package/dist/anycli/cache.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * AnyCLI Cache Management
+ *
+ * Simple filesystem-based cache for agent-generated service artifacts.
+ * One cache.json per service under ~/.a5c/anycli/cache/<service>/.
+ * The agent decides freshness, structure, and invalidation -- this module
+ * is just convenience I/O.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAnycliCacheDir = getAnycliCacheDir;
+exports.readServiceCache = readServiceCache;
+exports.writeServiceCache = writeServiceCache;
+exports.invalidateServiceCache = invalidateServiceCache;
+exports.listCachedServices = listCachedServices;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const os_1 = require("os");
+const atomic_1 = require("../storage/atomic");
+/**
+ * Base directory name for babysitter state.
+ */
+const A5C_DIR = ".a5c";
+/**
+ * Subdirectory for anycli cache within the global state dir.
+ */
+const ANYCLI_CACHE_SUBDIR = path_1.default.join("anycli", "cache");
+/**
+ * Cache filename.
+ */
+const CACHE_FILE = "cache.json";
+/**
+ * Returns the global cache directory for a service.
+ *
+ * @param service - Service identifier
+ * @returns Absolute path to `~/.a5c/anycli/cache/<service>/`
+ */
+function getAnycliCacheDir(service) {
+    return path_1.default.join((0, os_1.homedir)(), A5C_DIR, ANYCLI_CACHE_SUBDIR, service);
+}
+/**
+ * Reads a cached service entry if one exists.
+ *
+ * Returns `null` if no cache entry exists or the entry is corrupt.
+ *
+ * @param service - Service identifier
+ * @returns The cached service entry, or null
+ */
+async function readServiceCache(service) {
+    const cacheDir = getAnycliCacheDir(service);
+    const cachePath = path_1.default.join(cacheDir, CACHE_FILE);
+    try {
+        const raw = await fs_1.promises.readFile(cachePath, "utf8");
+        const entry = JSON.parse(raw);
+        return entry;
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            return null;
+        }
+        // Corrupt cache -- treat as miss
+        return null;
+    }
+}
+/**
+ * Writes a service cache entry atomically.
+ *
+ * @param service - Service identifier
+ * @param cache - The cache entry to write
+ */
+async function writeServiceCache(service, cache) {
+    const cacheDir = getAnycliCacheDir(service);
+    await fs_1.promises.mkdir(cacheDir, { recursive: true });
+    const cachePath = path_1.default.join(cacheDir, CACHE_FILE);
+    await (0, atomic_1.writeFileAtomic)(cachePath, JSON.stringify(cache, null, 2) + "\n");
+}
+/**
+ * Invalidates the cache for a service by removing its cache directory.
+ *
+ * @param service - Service identifier
+ */
+async function invalidateServiceCache(service) {
+    const cacheDir = getAnycliCacheDir(service);
+    try {
+        await fs_1.promises.rm(cacheDir, { recursive: true, force: true });
+    }
+    catch (error) {
+        const err = error;
+        if (err.code !== "ENOENT") {
+            throw error;
+        }
+    }
+}
+/**
+ * Lists all cached service names.
+ *
+ * @returns Array of service identifier strings
+ */
+async function listCachedServices() {
+    const baseDir = path_1.default.join((0, os_1.homedir)(), A5C_DIR, ANYCLI_CACHE_SUBDIR);
+    try {
+        const entries = await fs_1.promises.readdir(baseDir, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+}

package/dist/anycli/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AnyCLI Module
+ *
+ * Provides minimal cache infrastructure for agent-driven service integration.
+ * The agent handles all service discovery, auth resolution, and code generation
+ * at runtime -- these exports are just persistence utilities.
+ */
+export * from "./types";
+export * from "./cache";
+//# sourceMappingURL=index.d.ts.map

package/dist/anycli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/anycli/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/anycli/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * AnyCLI Module
+ *
+ * Provides minimal cache infrastructure for agent-driven service integration.
+ * The agent handles all service discovery, auth resolution, and code generation
+ * at runtime -- these exports are just persistence utilities.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./cache"), exports);

package/dist/anycli/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AnyCLI Types
+ *
+ * Minimal type definitions for the AnyCLI service cache.
+ * The agent handles all service discovery, auth resolution, and code
+ * generation at runtime -- these types are just persistence infrastructure.
+ */
+/**
+ * Transport type for MCP server communication.
+ */
+export type AnycliTransport = "stdio" | "http-sse";
+/**
+ * Cache entry for a service's agent-generated artifacts.
+ */
+export interface AnycliServiceCache {
+    /** Service identifier (e.g. "github", "stripe") */
+    service: string;
+    /** Agent-defined service definition -- no rigid schema */
+    definition: Record<string, unknown>;
+    /** Generated module files: filename -> content */
+    modules: Record<string, string>;
+    /** Cache metadata */
+    metadata: {
+        /** ISO timestamp when the cache entry was created */
+        createdAt: string;
+        /** SDK version that generated this cache entry */
+        sdkVersion: string;
+        /** Hash of the definition for change detection */
+        definitionHash: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/anycli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/anycli/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,qBAAqB;IACrB,QAAQ,EAAE;QACR,qDAAqD;QACrD,SAAS,EAAE,MAAM,CAAC;QAClB,kDAAkD;QAClD,UAAU,EAAE,MAAM,CAAC;QACnB,kDAAkD;QAClD,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH"}

package/dist/anycli/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * AnyCLI Types
+ *
+ * Minimal type definitions for the AnyCLI service cache.
+ * The agent handles all service discovery, auth resolution, and code
+ * generation at runtime -- these types are just persistence infrastructure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/breakpoints.d.ts

@@ -0,0 +1,93 @@
+/**
+ * GAP-JSON-003: JSON Breakpoint Interaction API.
+ *
+ * Typed API wrappers for listing, showing, and responding to breakpoint effects,
+ * plus auto-approval rule management. All functions return ApiResult envelopes
+ * and never throw.
+ */
+import type { ApiResult } from "./runs";
+import type { AutoApprovalResult, BreakpointConfig, BreakpointRule } from "@a5c-ai/babysitter-sdk";
+export interface ListBreakpointsOutput {
+    breakpoints: BreakpointSummary[];
+}
+export interface BreakpointSummary {
+    effectId: string;
+    breakpointId?: string;
+    title?: string;
+    tags?: string[];
+    expert?: string | string[];
+    strategy?: string;
+    autoApproval?: unknown;
+    requestedAt?: string;
+}
+export interface ShowBreakpointOutput {
+    effectId: string;
+    status: string;
+    breakpointId?: string;
+    title?: string;
+    description?: string;
+    tags?: string[];
+    expert?: string | string[];
+    strategy?: string;
+    previousFeedback?: string;
+    attempt?: number;
+    options?: unknown;
+    autoApproval?: unknown;
+    result?: unknown;
+    requestedAt?: string;
+    resolvedAt?: string;
+}
+export interface RespondToBreakpointInput {
+    runDir: string;
+    effectId: string;
+    approved: boolean;
+    response?: string;
+    feedback?: string;
+    option?: string;
+    respondedBy?: string;
+}
+export interface AddAutoApprovalRuleInput {
+    pattern: string;
+    action: "auto-approve" | "never-auto-approve";
+    createdBy: string;
+    id?: string;
+    source?: string;
+    note?: string;
+    rulesPath?: string;
+}
+export interface EvaluateAutoApprovalInput {
+    breakpointId: string;
+    tags?: string[];
+    expert?: string;
+    rulesPath?: string;
+    autoApproveAfterN?: number;
+    consecutiveApprovals?: number;
+    profileConfig?: BreakpointConfig;
+}
+export declare function apiListBreakpoints(input: {
+    runDir: string;
+}): Promise<ApiResult<ListBreakpointsOutput>>;
+export declare function apiShowBreakpoint(input: {
+    runDir: string;
+    effectId: string;
+}): Promise<ApiResult<ShowBreakpointOutput>>;
+export declare function apiRespondToBreakpoint(input: RespondToBreakpointInput): Promise<ApiResult<{
+    resultRef: string;
+}>>;
+export declare function apiListAutoApprovalRules(input?: {
+    rulesPath?: string;
+}): Promise<ApiResult<{
+    rules: BreakpointRule[];
+}>>;
+export declare function apiAddAutoApprovalRule(input: AddAutoApprovalRuleInput): Promise<ApiResult<{
+    rule: BreakpointRule;
+    rules: BreakpointRule[];
+}>>;
+export declare function apiRemoveAutoApprovalRule(input: {
+    ruleId: string;
+    rulesPath?: string;
+}): Promise<ApiResult<{
+    rules: BreakpointRule[];
+}>>;
+export declare function apiEvaluateAutoApproval(input: EvaluateAutoApprovalInput): Promise<ApiResult<AutoApprovalResult>>;
+//# sourceMappingURL=breakpoints.d.ts.map

package/dist/api/breakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.d.ts","sourceRoot":"","sources":["../../src/api/breakpoints.ts"],"names":[],"mappings":"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"}