@growthub/cli 0.5.1 → 0.6.1

package/dist/prompts/storage.js

@@ -0,0 +1,129 @@
+import * as p from "@clack/prompts";
+import { resolveDefaultStorageDir, resolvePaperclipInstanceId } from "../config/home.js";
+function defaultStorageBaseDir() {
+    return resolveDefaultStorageDir(resolvePaperclipInstanceId());
+}
+export function defaultStorageConfig() {
+    return {
+        provider: "local_disk",
+        localDisk: {
+            baseDir: defaultStorageBaseDir(),
+        },
+        s3: {
+            bucket: "paperclip",
+            region: "us-east-1",
+            endpoint: undefined,
+            prefix: "",
+            forcePathStyle: false,
+        },
+    };
+}
+export async function promptStorage(current) {
+    const base = current ?? defaultStorageConfig();
+    const provider = await p.select({
+        message: "Storage provider",
+        options: [
+            {
+                value: "local_disk",
+                label: "Local disk (recommended)",
+                hint: "best for single-user local deployments",
+            },
+            {
+                value: "s3",
+                label: "S3 compatible",
+                hint: "for cloud/object storage backends",
+            },
+        ],
+        initialValue: base.provider,
+    });
+    if (p.isCancel(provider)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    if (provider === "local_disk") {
+        const baseDir = await p.text({
+            message: "Local storage base directory",
+            defaultValue: base.localDisk.baseDir || defaultStorageBaseDir(),
+            placeholder: defaultStorageBaseDir(),
+            validate: (value) => {
+                if (!value || value.trim().length === 0)
+                    return "Storage base directory is required";
+            },
+        });
+        if (p.isCancel(baseDir)) {
+            p.cancel("Setup cancelled.");
+            process.exit(0);
+        }
+        return {
+            provider: "local_disk",
+            localDisk: {
+                baseDir: baseDir.trim(),
+            },
+            s3: base.s3,
+        };
+    }
+    const bucket = await p.text({
+        message: "S3 bucket",
+        defaultValue: base.s3.bucket || "paperclip",
+        placeholder: "paperclip",
+        validate: (value) => {
+            if (!value || value.trim().length === 0)
+                return "Bucket is required";
+        },
+    });
+    if (p.isCancel(bucket)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    const region = await p.text({
+        message: "S3 region",
+        defaultValue: base.s3.region || "us-east-1",
+        placeholder: "us-east-1",
+        validate: (value) => {
+            if (!value || value.trim().length === 0)
+                return "Region is required";
+        },
+    });
+    if (p.isCancel(region)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    const endpoint = await p.text({
+        message: "S3 endpoint (optional for compatible backends)",
+        defaultValue: base.s3.endpoint ?? "",
+        placeholder: "https://s3.amazonaws.com",
+    });
+    if (p.isCancel(endpoint)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    const prefix = await p.text({
+        message: "Object key prefix (optional)",
+        defaultValue: base.s3.prefix ?? "",
+        placeholder: "paperclip/",
+    });
+    if (p.isCancel(prefix)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    const forcePathStyle = await p.confirm({
+        message: "Use S3 path-style URLs?",
+        initialValue: base.s3.forcePathStyle ?? false,
+    });
+    if (p.isCancel(forcePathStyle)) {
+        p.cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    return {
+        provider: "s3",
+        localDisk: base.localDisk,
+        s3: {
+            bucket: bucket.trim(),
+            region: region.trim(),
+            endpoint: endpoint.trim() || undefined,
+            prefix: prefix.trim(),
+            forcePathStyle,
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/prompts/storage.js.map

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

package/dist/runtime/agent-harness/auth-store.d.ts

@@ -0,0 +1,8 @@
+type HarnessCredentialMap = Record<string, string>;
+export declare function readHarnessCredentials(harnessId: string): HarnessCredentialMap;
+export declare function getHarnessCredential(harnessId: string, key: string): string | undefined;
+export declare function setHarnessCredential(harnessId: string, key: string, value: string | undefined): void;
+export declare function setHarnessCredentials(harnessId: string, updates: Record<string, string | undefined>): void;
+export declare function maskSecret(value: string | undefined): string;
+export {};
+//# sourceMappingURL=auth-store.d.ts.map

package/dist/runtime/agent-harness/auth-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/agent-harness/auth-store.ts"],"names":[],"mappings":"AAIA,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAgCnD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAgB9E;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvF;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,IAAI,CAeN;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC1C,IAAI,CAgBN;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI5D"}

package/dist/runtime/agent-harness/auth-store.js

@@ -0,0 +1,92 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolvePaperclipHomeDir } from "../../config/home.js";
+function resolveHarnessAuthDir() {
+    return path.resolve(resolvePaperclipHomeDir(), "harness-auth");
+}
+function resolveHarnessAuthFile(harnessId) {
+    return path.resolve(resolveHarnessAuthDir(), `${harnessId}.json`);
+}
+function normalizeSecret(value) {
+    const trimmed = value?.trim();
+    return trimmed && trimmed.length > 0 ? trimmed : undefined;
+}
+function ensureSecureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+    try {
+        fs.chmodSync(dirPath, 0o700);
+    }
+    catch {
+        // Best effort only; some filesystems may ignore chmod.
+    }
+}
+function ensureSecureFile(filePath) {
+    try {
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch {
+        // Best effort only; some filesystems may ignore chmod.
+    }
+}
+export function readHarnessCredentials(harnessId) {
+    const filePath = resolveHarnessAuthFile(harnessId);
+    if (!fs.existsSync(filePath))
+        return {};
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        const creds = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value === "string" && value.trim().length > 0) {
+                creds[key] = value;
+            }
+        }
+        return creds;
+    }
+    catch {
+        return {};
+    }
+}
+export function getHarnessCredential(harnessId, key) {
+    const creds = readHarnessCredentials(harnessId);
+    return creds[key];
+}
+export function setHarnessCredential(harnessId, key, value) {
+    const normalized = normalizeSecret(value);
+    const creds = readHarnessCredentials(harnessId);
+    if (normalized) {
+        creds[key] = normalized;
+    }
+    else {
+        delete creds[key];
+    }
+    const dirPath = resolveHarnessAuthDir();
+    ensureSecureDir(dirPath);
+    const filePath = resolveHarnessAuthFile(harnessId);
+    fs.writeFileSync(filePath, `${JSON.stringify(creds, null, 2)}\n`, "utf-8");
+    ensureSecureFile(filePath);
+}
+export function setHarnessCredentials(harnessId, updates) {
+    const creds = readHarnessCredentials(harnessId);
+    for (const [key, rawValue] of Object.entries(updates)) {
+        const normalized = normalizeSecret(rawValue);
+        if (normalized) {
+            creds[key] = normalized;
+        }
+        else {
+            delete creds[key];
+        }
+    }
+    const dirPath = resolveHarnessAuthDir();
+    ensureSecureDir(dirPath);
+    const filePath = resolveHarnessAuthFile(harnessId);
+    fs.writeFileSync(filePath, `${JSON.stringify(creds, null, 2)}\n`, "utf-8");
+    ensureSecureFile(filePath);
+}
+export function maskSecret(value) {
+    if (!value)
+        return "(not set)";
+    if (value.length <= 4)
+        return "****";
+    return `${"*".repeat(Math.max(4, value.length - 4))}${value.slice(-4)}`;
+}
+//# sourceMappingURL=auth-store.js.map

package/dist/runtime/agent-harness/auth-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-store.js","sourceRoot":"","sources":["../../../src/runtime/agent-harness/auth-store.ts"],"names":[],"mappings":"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"}

package/dist/runtime/artifact-contracts/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Artifact Contract Layer
+ *
+ * Standardizes outputs from dynamic pipelines so they work the same across
+ * local runtime, browser surfaces, hosted app, and serverless futures.
+ *
+ * Responsibilities:
+ *   - normalize output metadata from hosted execution / provider assembly
+ *   - support future sync through profile/artifact APIs
+ *   - make artifacts queryable from both CLI and hosted surfaces
+ *   - preserve compatibility with manifest registry and thread-scoped output
+ *
+ * Storage:
+ *   - Local artifacts are persisted under ~/.paperclip/artifacts/
+ *   - Hosted artifacts are fetched from the hosted profile/artifact API
+ *   - The store merges both sources into a unified query surface
+ */
+import type { GrowthubArtifactManifest, GrowthubArtifactType, ArtifactExecutionContext, ArtifactQuery, ArtifactStoreMeta } from "./types.js";
+export type { GrowthubArtifactManifest, GrowthubArtifactType, ArtifactExecutionContext, ArtifactStatus, ArtifactContentRef, ArtifactQuery, ArtifactStoreMeta, } from "./types.js";
+export interface CreateArtifactInput {
+    artifactType: GrowthubArtifactType;
+    sourceNodeSlug: string;
+    executionContext: ArtifactExecutionContext;
+    pipelineId?: string;
+    nodeId?: string;
+    threadId?: string;
+    createdByConnectionId?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function createArtifactManifest(input: CreateArtifactInput): GrowthubArtifactManifest;
+export interface ArtifactStore {
+    /** Create and persist a new artifact manifest. */
+    create(input: CreateArtifactInput): GrowthubArtifactManifest;
+    /** Get a single artifact by ID. */
+    get(artifactId: string): GrowthubArtifactManifest | null;
+    /** List artifacts, optionally filtered. */
+    list(query?: ArtifactQuery): {
+        artifacts: GrowthubArtifactManifest[];
+        meta: ArtifactStoreMeta;
+    };
+    /** Update an existing artifact manifest. */
+    update(artifactId: string, patch: Partial<Pick<GrowthubArtifactManifest, "status" | "metadata" | "updatedAt">>): GrowthubArtifactManifest | null;
+    /** Get the local artifacts directory path. */
+    getStorePath(): string;
+}
+export declare function createArtifactStore(): ArtifactStore;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/artifact-contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/artifact-contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EAExB,aAAa,EACb,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC;AA+EpB,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,oBAAoB,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,wBAAwB,CAc3F;AAMD,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,wBAAwB,CAAC;IAC7D,mCAAmC;IACnC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAAC;IACzD,2CAA2C;IAC3C,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG;QAAE,SAAS,EAAE,wBAAwB,EAAE,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAChG,4CAA4C;IAC5C,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC,GAAG,wBAAwB,GAAG,IAAI,CAAC;IACjJ,8CAA8C;IAC9C,YAAY,IAAI,MAAM,CAAC;CACxB;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAoDnD"}

package/dist/runtime/artifact-contracts/index.js

@@ -0,0 +1,153 @@
+/**
+ * Artifact Contract Layer
+ *
+ * Standardizes outputs from dynamic pipelines so they work the same across
+ * local runtime, browser surfaces, hosted app, and serverless futures.
+ *
+ * Responsibilities:
+ *   - normalize output metadata from hosted execution / provider assembly
+ *   - support future sync through profile/artifact APIs
+ *   - make artifacts queryable from both CLI and hosted surfaces
+ *   - preserve compatibility with manifest registry and thread-scoped output
+ *
+ * Storage:
+ *   - Local artifacts are persisted under ~/.paperclip/artifacts/
+ *   - Hosted artifacts are fetched from the hosted profile/artifact API
+ *   - The store merges both sources into a unified query surface
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { randomBytes } from "node:crypto";
+import { resolvePaperclipHomeDir } from "../../config/home.js";
+// ---------------------------------------------------------------------------
+// Artifact ID generation
+// ---------------------------------------------------------------------------
+function generateArtifactId() {
+    return `art_${randomBytes(8).toString("hex")}`;
+}
+// ---------------------------------------------------------------------------
+// Local artifact storage paths
+// ---------------------------------------------------------------------------
+function resolveArtifactsDir() {
+    return path.resolve(resolvePaperclipHomeDir(), "artifacts");
+}
+function resolveArtifactManifestPath(artifactId) {
+    return path.resolve(resolveArtifactsDir(), `${artifactId}.json`);
+}
+// ---------------------------------------------------------------------------
+// Local persistence
+// ---------------------------------------------------------------------------
+function readLocalManifest(artifactId) {
+    const filePath = resolveArtifactManifestPath(artifactId);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeLocalManifest(manifest) {
+    const dir = resolveArtifactsDir();
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = resolveArtifactManifestPath(manifest.id);
+    fs.writeFileSync(filePath, `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o600 });
+}
+function listLocalManifests() {
+    const dir = resolveArtifactsDir();
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+        .map((entry) => {
+        try {
+            const content = fs.readFileSync(path.resolve(dir, entry.name), "utf-8");
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((m) => m !== null)
+        .sort((a, b) => (b.createdAt ?? "").localeCompare(a.createdAt ?? ""));
+}
+// ---------------------------------------------------------------------------
+// Query filter
+// ---------------------------------------------------------------------------
+function matchesQuery(manifest, query) {
+    if (query.artifactType && manifest.artifactType !== query.artifactType)
+        return false;
+    if (query.pipelineId && manifest.pipelineId !== query.pipelineId)
+        return false;
+    if (query.sourceNodeSlug && manifest.sourceNodeSlug !== query.sourceNodeSlug)
+        return false;
+    if (query.executionContext && manifest.executionContext !== query.executionContext)
+        return false;
+    if (query.status && manifest.status !== query.status)
+        return false;
+    if (query.threadId && manifest.threadId !== query.threadId)
+        return false;
+    return true;
+}
+export function createArtifactManifest(input) {
+    return {
+        id: generateArtifactId(),
+        artifactType: input.artifactType,
+        sourceNodeSlug: input.sourceNodeSlug,
+        createdByConnectionId: input.createdByConnectionId,
+        executionContext: input.executionContext,
+        status: "pending",
+        pipelineId: input.pipelineId,
+        nodeId: input.nodeId,
+        threadId: input.threadId,
+        createdAt: new Date().toISOString(),
+        metadata: input.metadata ?? {},
+    };
+}
+export function createArtifactStore() {
+    return {
+        create(input) {
+            const manifest = createArtifactManifest(input);
+            writeLocalManifest(manifest);
+            return manifest;
+        },
+        get(artifactId) {
+            return readLocalManifest(artifactId);
+        },
+        list(query) {
+            let artifacts = listLocalManifests();
+            if (query) {
+                artifacts = artifacts.filter((m) => matchesQuery(m, query));
+            }
+            if (query?.limit && query.limit > 0) {
+                artifacts = artifacts.slice(0, query.limit);
+            }
+            return {
+                artifacts,
+                meta: {
+                    total: artifacts.length,
+                    source: "local",
+                    fetchedAt: new Date().toISOString(),
+                },
+            };
+        },
+        update(artifactId, patch) {
+            const existing = readLocalManifest(artifactId);
+            if (!existing)
+                return null;
+            const updated = {
+                ...existing,
+                ...(patch.status !== undefined ? { status: patch.status } : {}),
+                ...(patch.metadata !== undefined ? { metadata: { ...existing.metadata, ...patch.metadata } } : {}),
+                updatedAt: patch.updatedAt ?? new Date().toISOString(),
+            };
+            writeLocalManifest(updated);
+            return updated;
+        },
+        getStorePath() {
+            return resolveArtifactsDir();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/artifact-contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/artifact-contracts/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime/artifact-contracts/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Artifact Contract Layer — Type Definitions
+ *
+ * Standardizes outputs from dynamic pipelines so they work the same across:
+ *   - local runtime
+ *   - browser surfaces
+ *   - hosted app
+ *   - serverless futures
+ *
+ * Compatible with:
+ *   - manifest registry artifact semantics
+ *   - thread-scoped output logic
+ *   - IssueWorkProduct types (packages/shared)
+ */
+export type GrowthubArtifactType = "video" | "image" | "slides" | "text" | "report" | "pipeline";
+export type ArtifactExecutionContext = "local" | "hosted" | "hybrid";
+export type ArtifactStatus = "pending" | "generating" | "ready" | "failed" | "archived";
+export interface GrowthubArtifactManifest {
+    /** Unique artifact ID. */
+    id: string;
+    /** Artifact type classification. */
+    artifactType: GrowthubArtifactType;
+    /** CMS capability slug that produced this artifact. */
+    sourceNodeSlug: string;
+    /** Machine connection ID that produced this artifact. */
+    createdByConnectionId?: string;
+    /** Execution context where the artifact was produced. */
+    executionContext: ArtifactExecutionContext;
+    /** Current artifact status. */
+    status: ArtifactStatus;
+    /** Pipeline ID that produced this artifact (if pipeline-scoped). */
+    pipelineId?: string;
+    /** Pipeline node ID that produced this artifact. */
+    nodeId?: string;
+    /** Thread/conversation ID scope. */
+    threadId?: string;
+    /** ISO timestamp when the artifact was created. */
+    createdAt: string;
+    /** ISO timestamp when the artifact was last updated. */
+    updatedAt?: string;
+    /** Opaque metadata from the producing node or pipeline. */
+    metadata: Record<string, unknown>;
+}
+export interface ArtifactContentRef {
+    /** Artifact ID this content belongs to. */
+    artifactId: string;
+    /** Content MIME type. */
+    mimeType: string;
+    /** Content URL (hosted/S3/local path). */
+    url?: string;
+    /** Local file path (for local-context artifacts). */
+    localPath?: string;
+    /** Content size in bytes, if known. */
+    sizeBytes?: number;
+    /** SHA-256 checksum, if computed. */
+    sha256?: string;
+}
+export interface ArtifactQuery {
+    /** Filter by artifact type. */
+    artifactType?: GrowthubArtifactType;
+    /** Filter by pipeline ID. */
+    pipelineId?: string;
+    /** Filter by source node slug. */
+    sourceNodeSlug?: string;
+    /** Filter by execution context. */
+    executionContext?: ArtifactExecutionContext;
+    /** Filter by status. */
+    status?: ArtifactStatus;
+    /** Filter by thread ID. */
+    threadId?: string;
+    /** Limit results. */
+    limit?: number;
+}
+export interface ArtifactStoreMeta {
+    /** Total artifacts tracked. */
+    total: number;
+    /** Source of the data. */
+    source: "local" | "hosted" | "merged";
+    /** ISO timestamp of freshness. */
+    fetchedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/artifact-contracts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/artifact-contracts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,UAAU,CAAC;AAMf,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,YAAY,EAAE,oBAAoB,CAAC;IACnC,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,+BAA+B;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,wBAAwB;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/runtime/artifact-contracts/types.js

@@ -0,0 +1,16 @@
+/**
+ * Artifact Contract Layer — Type Definitions
+ *
+ * Standardizes outputs from dynamic pipelines so they work the same across:
+ *   - local runtime
+ *   - browser surfaces
+ *   - hosted app
+ *   - serverless futures
+ *
+ * Compatible with:
+ *   - manifest registry artifact semantics
+ *   - thread-scoped output logic
+ *   - IssueWorkProduct types (packages/shared)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime/artifact-contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/artifact-contracts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/runtime/cms-capability-registry/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CMS Capability Registry Client
+ *
+ * Treats the CMS-backed node/tool definitions as a first-class registry for
+ * the CLI/runtime. This layer lets agents discover:
+ *   - which core node primitives exist
+ *   - which are available to the authenticated user/org
+ *   - how they bind into pipelines
+ *   - what execution shape they require
+ *
+ * Data source:
+ *   - Hosted registry endpoint via HostedExecutionClient
+ *
+ * The registry does NOT reimplement CMS semantics — it exposes them as
+ * CLI/runtime-friendly node records.
+ */
+import type { CmsCapabilityNode, CapabilityQuery, CapabilityRegistryMeta } from "./types.js";
+export type { CmsCapabilityNode, CmsConnectorNode, CapabilityFamily, CapabilityExecutionKind, CapabilityQuery, CapabilityRegistryMeta, CmsNodeType, CmsVisibility, CmsExecutionBinding, CmsExecutionTokens, } from "./types.js";
+export { CAPABILITY_FAMILIES } from "./types.js";
+export interface CmsCapabilityRegistryClient {
+    /** Fetch all capabilities, optionally filtered. */
+    listCapabilities(query?: CapabilityQuery): Promise<{
+        nodes: CmsCapabilityNode[];
+        meta: CapabilityRegistryMeta;
+    }>;
+    /** Fetch a single capability by slug. */
+    getCapability(slug: string): Promise<CmsCapabilityNode | null>;
+}
+export declare function createCmsCapabilityRegistryClient(): CmsCapabilityRegistryClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/cms-capability-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/cms-capability-registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EACf,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAuIjD,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,gBAAgB,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE,CAAC,CAAC;IACjH,yCAAyC;IACzC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAChE;AAED,wBAAgB,iCAAiC,IAAI,2BAA2B,CAiC/E"}