@stigmer/sdk 3.2.3 → 3.4.0

package/manifest/client.js

@@ -0,0 +1,109 @@
+// Kind-agnostic apply/lookup over the manifest registry.
+//
+// One client, every registry kind: `apply` drives the kind's command
+// controller with the full resource proto (create-or-update by slug,
+// server-side), `getByReference` loads current server state for
+// create-vs-update previews and YAML editing.
+import { create } from "@bufbuild/protobuf";
+import { createClient } from "@connectrpc/connect";
+import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { wrapError } from "../gen/errors.js";
+import { metadataOf } from "./parse.js";
+import { manifestHandlerForYamlKind, manifestKinds, } from "./registry.js";
+/**
+ * Client for applying and loading Stigmer resources as manifests,
+ * independent of kind.
+ *
+ * Complements the typed per-kind clients (`stigmer.agent`, …): those take
+ * curated `*Input` shapes for programmatic use; this one takes full
+ * resource protos produced by {@link parseManifest} — the declarative
+ * "apply this YAML" path, with the same semantics as `stigmer apply -f`.
+ *
+ * @example
+ * ```ts
+ * const docs = parseManifest(yamlText, { org: "acme" });
+ * for (const doc of docs) {
+ *   const applied = await stigmer.manifest.apply(doc);
+ *   console.log(`${applied.displayName} ${applied.slug} applied`);
+ * }
+ * ```
+ */
+export class ManifestClient {
+    // Raw controller clients are created lazily and cached per service —
+    // one dialog session typically touches one or two kinds.
+    clients = new Map();
+    transport;
+    clientFor;
+    constructor(transport) {
+        this.transport = transport;
+        this.clientFor = (service) => {
+            let client = this.clients.get(service);
+            if (client === undefined) {
+                client = createClient(service, this.transport);
+                this.clients.set(service, client);
+            }
+            return client;
+        };
+    }
+    /** The kinds this client can apply, in dependency apply order. */
+    supportedKinds() {
+        return manifestKinds();
+    }
+    /**
+     * Apply one parsed manifest document (create-or-update by slug).
+     *
+     * @throws {StigmerError} When the server rejects the apply
+     *   (validation, permissions, …).
+     */
+    async apply(document) {
+        let applied;
+        try {
+            applied = await document.handler.apply(this.clientFor, document.message);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+        const metadata = metadataOf(applied);
+        return {
+            yamlKind: document.handler.yamlKind,
+            displayName: document.handler.displayName,
+            name: metadata?.name || document.name,
+            slug: metadata?.slug || document.slug,
+            org: metadata?.org || document.org,
+            id: metadata?.id ?? "",
+            message: applied,
+        };
+    }
+    /**
+     * Load a resource's current server state by kind + org/slug reference.
+     *
+     * @returns The resource proto, or `null` when it does not exist —
+     *   the create-vs-update discriminator for previews.
+     * @throws {Error} When the kind is not in the manifest registry.
+     * @throws {StigmerError} For failures other than not-found.
+     */
+    async getByReference(yamlKind, org, slug) {
+        const handler = manifestHandlerForYamlKind(yamlKind);
+        if (handler === undefined) {
+            const supported = manifestKinds()
+                .map((h) => h.yamlKind)
+                .join(", ");
+            throw new Error(`Unsupported resource kind "${yamlKind}". Supported kinds: ${supported}.`);
+        }
+        const ref = create(ApiResourceReferenceSchema, {
+            org,
+            slug,
+            kind: handler.kind,
+        });
+        try {
+            return await handler.getByReference(this.clientFor, ref);
+        }
+        catch (e) {
+            const wrapped = wrapError(e);
+            if (wrapped.code === "not-found")
+                return null;
+            throw wrapped;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/manifest/client.js.map

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

package/manifest/index.d.ts

@@ -0,0 +1,9 @@
+export { manifestKinds, manifestHandlerForYamlKind, manifestHandlerForTypeName, } from "./registry.js";
+export type { ManifestKindHandler, ServiceClientFn } from "./registry.js";
+export { parseManifest, metadataOf } from "./parse.js";
+export type { ManifestDocument, ParseManifestOptions } from "./parse.js";
+export { serializeManifest } from "./serialize.js";
+export { ManifestClient } from "./client.js";
+export type { AppliedManifest } from "./client.js";
+export { REDACTED_SECRET_MARKER, containsRedactedSecrets, } from "./redaction.js";
+//# sourceMappingURL=index.d.ts.map

package/manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}

package/manifest/index.js

@@ -0,0 +1,11 @@
+// Manifest engine: kind-agnostic YAML ⇄ proto ⇄ apply for Stigmer resources.
+//
+// The declarative counterpart to the typed per-kind clients — parse a YAML
+// manifest against generated proto schemas, serialize server state back to
+// editable YAML, and apply through each kind's command controller.
+export { manifestKinds, manifestHandlerForYamlKind, manifestHandlerForTypeName, } from "./registry.js";
+export { parseManifest, metadataOf } from "./parse.js";
+export { serializeManifest } from "./serialize.js";
+export { ManifestClient } from "./client.js";
+export { REDACTED_SECRET_MARKER, containsRedactedSecrets, } from "./redaction.js";
+//# sourceMappingURL=index.js.map

package/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,mEAAmE;AAEnE,OAAO,EACL,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}

package/manifest/parse.d.ts

@@ -0,0 +1,57 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type ApiResourceMetadata } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { type ManifestKindHandler } from "./registry.js";
+/** Options for {@link parseManifest}. */
+export interface ParseManifestOptions {
+    /**
+     * Target organization slug. Injected into `metadata.org` when the document
+     * omits it. When the document specifies a *different* org, the document's
+     * value wins and a warning is attached (matching `stigmer apply`).
+     */
+    readonly org?: string;
+}
+/** One resource document parsed from a manifest. */
+export interface ManifestDocument {
+    /** The registry handler for this document's kind. */
+    readonly handler: ManifestKindHandler;
+    /** The fully-marshalled resource proto, ready for `apply`. */
+    readonly message: Message;
+    /** `metadata.name` (always present — validated). */
+    readonly name: string;
+    /** `metadata.slug`, or the name when the document has no explicit slug. */
+    readonly slug: string;
+    /** `metadata.org` after org injection ("" when unresolvable). */
+    readonly org: string;
+    /** Org-mismatch warning, when the document's org differs from the target. */
+    readonly warning?: string;
+}
+/**
+ * Parse a (possibly multi-document) YAML manifest into resource protos.
+ *
+ * Each document is validated against its kind's generated proto schema —
+ * the same schemas the backend serves — so a document that parses here is
+ * structurally valid for `apply`. Documents are returned in **dependency
+ * apply order** (referenced kinds before dependents, stable within a kind),
+ * mirroring the CLI's apply ordering.
+ *
+ * @param content - Raw YAML text (one or more `---`-separated documents).
+ * @param options - Optional target org for `metadata.org` injection.
+ * @returns The parsed documents, sorted into dependency apply order.
+ * @throws {Error} With a user-facing message when the YAML is malformed,
+ *   a document has no `kind`, the kind is unsupported, or a document does
+ *   not match its proto schema (unknown fields included).
+ *
+ * @example
+ * ```ts
+ * import { parseManifest } from "@stigmer/sdk";
+ *
+ * const docs = parseManifest(yamlText, { org: "acme" });
+ * for (const doc of docs) {
+ *   await stigmer.manifest.apply(doc);
+ * }
+ * ```
+ */
+export declare function parseManifest(content: string, options?: ParseManifestOptions): ManifestDocument[];
+/** Read a resource message's metadata envelope, if present. */
+export declare function metadataOf(message: Message): ApiResourceMetadata | undefined;
+//# sourceMappingURL=parse.d.ts.map

package/manifest/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/manifest/parse.ts"],"names":[],"mappings":"AAQA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,4DAA4D,CAAC;AAEpE,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,eAAe,CAAC;AAEvB,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,gBAAgB,EAAE,CAwCpB;AAyDD,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAE5E"}

package/manifest/parse.js

@@ -0,0 +1,134 @@
+// Strict YAML → proto parsing for Stigmer resource manifests.
+//
+// The strictness contract matches `stigmer apply -f`: YAML syntax errors and
+// unknown fields both fail loudly (`ignoreUnknownFields: false`) — silently
+// applying a half-parsed or typo'd document would be dangerous. Error
+// messages are written for end users (DD-006): what failed, where, and what
+// a valid document looks like.
+import { fromJson } from "@bufbuild/protobuf";
+import { create } from "@bufbuild/protobuf";
+import { ApiResourceMetadataSchema, } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { parseAllDocuments } from "yaml";
+import { manifestHandlerForYamlKind, manifestKinds, } from "./registry.js";
+/**
+ * Parse a (possibly multi-document) YAML manifest into resource protos.
+ *
+ * Each document is validated against its kind's generated proto schema —
+ * the same schemas the backend serves — so a document that parses here is
+ * structurally valid for `apply`. Documents are returned in **dependency
+ * apply order** (referenced kinds before dependents, stable within a kind),
+ * mirroring the CLI's apply ordering.
+ *
+ * @param content - Raw YAML text (one or more `---`-separated documents).
+ * @param options - Optional target org for `metadata.org` injection.
+ * @returns The parsed documents, sorted into dependency apply order.
+ * @throws {Error} With a user-facing message when the YAML is malformed,
+ *   a document has no `kind`, the kind is unsupported, or a document does
+ *   not match its proto schema (unknown fields included).
+ *
+ * @example
+ * ```ts
+ * import { parseManifest } from "@stigmer/sdk";
+ *
+ * const docs = parseManifest(yamlText, { org: "acme" });
+ * for (const doc of docs) {
+ *   await stigmer.manifest.apply(doc);
+ * }
+ * ```
+ */
+export function parseManifest(content, options = {}) {
+    if (!content.trim()) {
+        throw new Error("The manifest is empty. Paste or upload a Stigmer resource YAML " +
+            "(a document with apiVersion, kind, metadata, and spec).");
+    }
+    const parsed = parseAllDocuments(content);
+    const documents = [];
+    for (const [index, doc] of parsed.entries()) {
+        const where = parsed.length === 1 ? "the manifest" : `document ${index + 1}`;
+        if (doc.errors.length > 0) {
+            throw new Error(`Invalid YAML in ${where}: ${doc.errors[0].message}`);
+        }
+        const value = doc.toJS();
+        if (value === null || value === undefined)
+            continue; // blank document between separators
+        if (typeof value !== "object" || Array.isArray(value)) {
+            throw new Error(`Invalid YAML in ${where}: expected a mapping document with ` +
+                "apiVersion, kind, metadata, and spec.");
+        }
+        documents.push(parseDocument(value, where, options.org));
+    }
+    if (documents.length === 0) {
+        throw new Error("The manifest contains no resource documents. Each document needs " +
+            "at least a kind (e.g. kind: Agent) and metadata.name.");
+    }
+    // Stable sort into dependency order so multi-document manifests apply
+    // parents before dependents (e.g. Environment before AgentChannel).
+    return documents.sort((a, b) => a.handler.applyOrder - b.handler.applyOrder);
+}
+function parseDocument(value, where, org) {
+    const kind = value.kind;
+    if (typeof kind !== "string" || kind === "") {
+        throw new Error(`${capitalize(where)} is missing the required 'kind' field ` +
+            "(e.g. kind: Agent).");
+    }
+    const handler = manifestHandlerForYamlKind(kind);
+    if (handler === undefined) {
+        const supported = manifestKinds()
+            .map((h) => h.yamlKind)
+            .join(", ");
+        throw new Error(`Unsupported resource kind "${kind}" in ${where}. ` +
+            `Supported kinds: ${supported}.`);
+    }
+    let message;
+    try {
+        message = fromJson(handler.schema, value, {
+            ignoreUnknownFields: false,
+        });
+    }
+    catch (err) {
+        throw new Error(`Invalid ${handler.displayName} in ${where}: ${err.message}`);
+    }
+    const warning = injectOrg(message, org ?? "");
+    const metadata = metadataOf(message);
+    const name = metadata?.name ?? "";
+    if (name === "") {
+        throw new Error(`${capitalize(where)} is missing the required metadata.name field.`);
+    }
+    return {
+        handler,
+        message,
+        name,
+        slug: metadata?.slug || name,
+        org: metadata?.org ?? "",
+        ...(warning !== undefined && { warning }),
+    };
+}
+/** Read a resource message's metadata envelope, if present. */
+export function metadataOf(message) {
+    return message.metadata;
+}
+// Inject the target org into metadata.org when the document omitted it. When
+// the document specifies a *different* org, the document's value is honored
+// and a warning is returned (matching `stigmer apply`).
+function injectOrg(message, org) {
+    if (org === "")
+        return undefined;
+    const holder = message;
+    if (holder.metadata === undefined) {
+        holder.metadata = create(ApiResourceMetadataSchema, { org });
+        return undefined;
+    }
+    if (holder.metadata.org === "") {
+        holder.metadata.org = org;
+        return undefined;
+    }
+    if (holder.metadata.org !== org) {
+        return (`The document's org "${holder.metadata.org}" differs from the ` +
+            `target org "${org}"; applying to "${holder.metadata.org}".`);
+    }
+    return undefined;
+}
+function capitalize(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+//# sourceMappingURL=parse.js.map

package/manifest/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/manifest/parse.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,sEAAsE;AACtE,4EAA4E;AAC5E,+BAA+B;AAE/B,OAAO,EAAE,QAAQ,EAAgC,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAEL,yBAAyB,GAC1B,MAAM,4DAA4D,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAEL,0BAA0B,EAC1B,aAAa,GACd,MAAM,eAAe,CAAC;AA4BvB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,UAAgC,EAAE;IAElC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,iEAAiE;YAC/D,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAuB,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,EAAE,CAAC;QAE7E,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAa,CAAC;QACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS,CAAC,oCAAoC;QACzF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,qCAAqC;gBAC3D,uCAAuC,CAC1C,CAAC;QACJ,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,KAAgC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,mEAAmE;YACjE,uDAAuD,CAC1D,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,oEAAoE;IACpE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,aAAa,CACpB,KAA8B,EAC9B,KAAa,EACb,GAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,CAAC,KAAK,CAAC,wCAAwC;YAC1D,qBAAqB,CACxB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,aAAa,EAAE;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;aACtB,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,QAAQ,KAAK,IAAI;YACjD,oBAAoB,SAAS,GAAG,CACnC,CAAC;IACJ,CAAC;IAED,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,KAAkB,EAAE;YACrD,mBAAmB,EAAE,KAAK;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,CAAC,WAAW,OAAO,KAAK,KAAM,GAAa,CAAC,OAAO,EAAE,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;IAClC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,CAAC,KAAK,CAAC,+CAA+C,CACpE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO;QACP,OAAO;QACP,IAAI;QACJ,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI;QAC5B,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE;QACxB,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAQ,OAAyD,CAAC,QAAQ,CAAC;AAC7E,CAAC;AAED,6EAA6E;AAC7E,4EAA4E;AAC5E,wDAAwD;AACxD,SAAS,SAAS,CAAC,OAAgB,EAAE,GAAW;IAC9C,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACjC,MAAM,MAAM,GAAG,OAAwD,CAAC;IACxE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QAChC,OAAO,CACL,uBAAuB,MAAM,CAAC,QAAQ,CAAC,GAAG,qBAAqB;YAC/D,eAAe,GAAG,mBAAmB,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/manifest/redaction.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sentinel the server substitutes for secret values before they leave the
+ * backend (Cloud environment reads, ChannelApp/OAuthApp reads on both
+ * editions). Sending the marker back in an `apply` means "keep the stored
+ * secret" — the update pipelines restore the existing encrypted value.
+ */
+export declare const REDACTED_SECRET_MARKER = "***REDACTED***";
+/**
+ * Whether manifest content contains redacted secret values.
+ *
+ * Used by editing UIs to explain the marker to users ("redacted secrets
+ * keep their stored values when applied") instead of letting it read like
+ * a bug.
+ */
+export declare function containsRedactedSecrets(content: string): boolean;
+//# sourceMappingURL=redaction.d.ts.map

package/manifest/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/manifest/redaction.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE"}

package/manifest/redaction.js

@@ -0,0 +1,19 @@
+// The server-side secret-redaction contract, mirrored for client UX.
+/**
+ * Sentinel the server substitutes for secret values before they leave the
+ * backend (Cloud environment reads, ChannelApp/OAuthApp reads on both
+ * editions). Sending the marker back in an `apply` means "keep the stored
+ * secret" — the update pipelines restore the existing encrypted value.
+ */
+export const REDACTED_SECRET_MARKER = "***REDACTED***";
+/**
+ * Whether manifest content contains redacted secret values.
+ *
+ * Used by editing UIs to explain the marker to users ("redacted secrets
+ * keep their stored values when applied") instead of letting it read like
+ * a bug.
+ */
+export function containsRedactedSecrets(content) {
+    return content.includes(REDACTED_SECRET_MARKER);
+}
+//# sourceMappingURL=redaction.js.map

package/manifest/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/manifest/redaction.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;AAClD,CAAC"}

package/manifest/registry.d.ts

@@ -0,0 +1,44 @@
+import type { DescMessage, DescService, Message } from "@bufbuild/protobuf";
+import type { Client } from "@connectrpc/connect";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import type { ApiResourceReference } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+/**
+ * Accessor for a raw Connect client over a generated service controller.
+ * Implementations cache clients per service (see `ManifestClient`).
+ */
+export type ServiceClientFn = <Desc extends DescService>(service: Desc) => Client<Desc>;
+/**
+ * Binds one YAML `kind` to everything the manifest engine needs:
+ * the proto schema (strict marshalling), the command controller's `apply`
+ * RPC, and the query controller's `getByReference` RPC (create-vs-update
+ * preview).
+ */
+export interface ManifestKindHandler {
+    /** The platform resource kind enum value. */
+    readonly kind: ApiResourceKind;
+    /** The YAML discriminator, e.g. `"Agent"`. */
+    readonly yamlKind: string;
+    /** Human-facing name for messages, e.g. `"MCP Server"`. */
+    readonly displayName: string;
+    /** Canonical `apiVersion` for this kind, e.g. `"agentic.stigmer.ai/v1"`. */
+    readonly apiVersion: string;
+    /** Proto schema for strict YAML↔proto conversion. */
+    readonly schema: DescMessage;
+    /**
+     * Position in the dependency apply order (ascending). Referenced kinds
+     * apply before their dependents, e.g. an McpServer before the Agent that
+     * uses it, and everything an AgentChannel references before the channel.
+     */
+    readonly applyOrder: number;
+    /** Drive the command controller's `apply` RPC with the full resource. */
+    apply(clientFor: ServiceClientFn, message: Message): Promise<Message>;
+    /** Load the current server state by org/slug reference. */
+    getByReference(clientFor: ServiceClientFn, ref: ApiResourceReference): Promise<Message>;
+}
+/** All kinds the manifest engine supports, in dependency apply order. */
+export declare function manifestKinds(): readonly ManifestKindHandler[];
+/** Resolve a handler by its YAML `kind` discriminator (e.g. `"Agent"`). */
+export declare function manifestHandlerForYamlKind(yamlKind: string): ManifestKindHandler | undefined;
+/** Resolve a handler from a proto message's fully-qualified type name. */
+export declare function manifestHandlerForTypeName(typeName: string): ManifestKindHandler | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/manifest/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/manifest/registry.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AACtH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAoCjG;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,SAAS,WAAW,EAAE,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;AAExF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,KAAK,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,2DAA2D;IAC3D,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAiID,yEAAyE;AACzE,wBAAgB,aAAa,IAAI,SAAS,mBAAmB,EAAE,CAE9D;AAED,2EAA2E;AAC3E,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GACf,mBAAmB,GAAG,SAAS,CAEjC;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GACf,mBAAmB,GAAG,SAAS,CAEjC"}

package/manifest/registry.js

@@ -0,0 +1,178 @@
+// Explicit manifest-kind registry: the single place that binds a YAML `kind`
+// to its proto schema and controller RPCs.
+//
+// This is the SDK home of the pattern the CLIs already rely on (Go CLI,
+// TS CLI `resources/apply/handlers.ts`, mcp-server): strict YAML→proto
+// marshalling against the *generated schema*, and apply through the raw
+// command controller with the full resource message. The high-level
+// `*Input` wrappers are intentionally bypassed — they are lossy (they drop
+// `metadata.id` and any field codegen hasn't projected), while the `apply`
+// RPC takes the complete resource and the server upserts by slug.
+//
+// Registration is explicit — to support a new kind, add one entry here.
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { AgentSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import { AgentCommandController } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/command_pb";
+import { AgentQueryController } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/query_pb";
+import { AgentChannelSchema } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/api_pb";
+import { AgentChannelCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/command_pb";
+import { AgentChannelQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/query_pb";
+import { AgentInstanceSchema } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+import { AgentInstanceCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/command_pb";
+import { AgentInstanceQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/query_pb";
+import { AgentShareSchema } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/api_pb";
+import { AgentShareCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/command_pb";
+import { AgentShareQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentshare/v1/query_pb";
+import { ChannelAppSchema } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/api_pb";
+import { ChannelAppCommandController } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/command_pb";
+import { ChannelAppQueryController } from "@stigmer/protos/ai/stigmer/agentic/channelapp/v1/query_pb";
+import { DatastoreSchema } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/api_pb";
+import { DatastoreCommandController } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/command_pb";
+import { DatastoreQueryController } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/query_pb";
+import { EnvironmentSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+import { EnvironmentCommandController } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/command_pb";
+import { EnvironmentQueryController } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/query_pb";
+import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import { McpServerCommandController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/command_pb";
+import { McpServerQueryController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/query_pb";
+import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import { WorkflowCommandController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/command_pb";
+import { WorkflowQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/query_pb";
+import { IdentityProviderSchema } from "@stigmer/protos/ai/stigmer/iam/identityprovider/v1/api_pb";
+import { IdentityProviderCommandController } from "@stigmer/protos/ai/stigmer/iam/identityprovider/v1/command_pb";
+import { IdentityProviderQueryController } from "@stigmer/protos/ai/stigmer/iam/identityprovider/v1/query_pb";
+import { OAuthAppSchema } from "@stigmer/protos/ai/stigmer/iam/oauthapp/v1/api_pb";
+import { OAuthAppCommandController } from "@stigmer/protos/ai/stigmer/iam/oauthapp/v1/command_pb";
+import { OAuthAppQueryController } from "@stigmer/protos/ai/stigmer/iam/oauthapp/v1/query_pb";
+const AGENTIC_V1 = "agentic.stigmer.ai/v1";
+const IAM_V1 = "iam.stigmer.ai/v1";
+const HANDLERS = [
+    {
+        kind: ApiResourceKind.mcp_server,
+        yamlKind: "McpServer",
+        displayName: "MCP Server",
+        apiVersion: AGENTIC_V1,
+        schema: McpServerSchema,
+        applyOrder: 1,
+        apply: (c, m) => c(McpServerCommandController).apply(m),
+        getByReference: (c, ref) => c(McpServerQueryController).getByReference(ref),
+    },
+    // A Datastore applies before the Agents that reference it via
+    // datastore_usages (the McpServer-before-Agent pattern).
+    {
+        kind: ApiResourceKind.datastore,
+        yamlKind: "Datastore",
+        displayName: "Datastore",
+        apiVersion: AGENTIC_V1,
+        schema: DatastoreSchema,
+        applyOrder: 2,
+        apply: (c, m) => c(DatastoreCommandController).apply(m),
+        getByReference: (c, ref) => c(DatastoreQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.agent,
+        yamlKind: "Agent",
+        displayName: "Agent",
+        apiVersion: AGENTIC_V1,
+        schema: AgentSchema,
+        applyOrder: 3,
+        apply: (c, m) => c(AgentCommandController).apply(m),
+        getByReference: (c, ref) => c(AgentQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.workflow,
+        yamlKind: "Workflow",
+        displayName: "Workflow",
+        apiVersion: AGENTIC_V1,
+        schema: WorkflowSchema,
+        applyOrder: 4,
+        apply: (c, m) => c(WorkflowCommandController).apply(m),
+        getByReference: (c, ref) => c(WorkflowQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.environment,
+        yamlKind: "Environment",
+        displayName: "Environment",
+        apiVersion: AGENTIC_V1,
+        schema: EnvironmentSchema,
+        applyOrder: 5,
+        apply: (c, m) => c(EnvironmentCommandController).apply(m),
+        getByReference: (c, ref) => c(EnvironmentQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.identity_provider,
+        yamlKind: "IdentityProvider",
+        displayName: "Identity Provider",
+        apiVersion: IAM_V1,
+        schema: IdentityProviderSchema,
+        applyOrder: 6,
+        apply: (c, m) => c(IdentityProviderCommandController).apply(m),
+        getByReference: (c, ref) => c(IdentityProviderQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.oauth_app,
+        yamlKind: "OAuthApp",
+        displayName: "OAuth App",
+        apiVersion: IAM_V1,
+        schema: OAuthAppSchema,
+        applyOrder: 7,
+        apply: (c, m) => c(OAuthAppCommandController).apply(m),
+        getByReference: (c, ref) => c(OAuthAppQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.channel_app,
+        yamlKind: "ChannelApp",
+        displayName: "Channel App",
+        apiVersion: AGENTIC_V1,
+        schema: ChannelAppSchema,
+        applyOrder: 8,
+        apply: (c, m) => c(ChannelAppCommandController).apply(m),
+        getByReference: (c, ref) => c(ChannelAppQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.agent_instance,
+        yamlKind: "AgentInstance",
+        displayName: "Agent Instance",
+        apiVersion: AGENTIC_V1,
+        schema: AgentInstanceSchema,
+        applyOrder: 9,
+        apply: (c, m) => c(AgentInstanceCommandController).apply(m),
+        getByReference: (c, ref) => c(AgentInstanceQueryController).getByReference(ref),
+    },
+    {
+        kind: ApiResourceKind.agent_share,
+        yamlKind: "AgentShare",
+        displayName: "Agent Share",
+        apiVersion: AGENTIC_V1,
+        schema: AgentShareSchema,
+        applyOrder: 10,
+        apply: (c, m) => c(AgentShareCommandController).apply(m),
+        getByReference: (c, ref) => c(AgentShareQueryController).getByReference(ref),
+    },
+    // Last: an AgentChannel references an Agent, a ChannelApp, and Environments.
+    {
+        kind: ApiResourceKind.agent_channel,
+        yamlKind: "AgentChannel",
+        displayName: "Agent Channel",
+        apiVersion: AGENTIC_V1,
+        schema: AgentChannelSchema,
+        applyOrder: 11,
+        apply: (c, m) => c(AgentChannelCommandController).apply(m),
+        getByReference: (c, ref) => c(AgentChannelQueryController).getByReference(ref),
+    },
+];
+const BY_YAML_KIND = new Map(HANDLERS.map((h) => [h.yamlKind, h]));
+const BY_TYPE_NAME = new Map(HANDLERS.map((h) => [h.schema.typeName, h]));
+/** All kinds the manifest engine supports, in dependency apply order. */
+export function manifestKinds() {
+    return HANDLERS;
+}
+/** Resolve a handler by its YAML `kind` discriminator (e.g. `"Agent"`). */
+export function manifestHandlerForYamlKind(yamlKind) {
+    return BY_YAML_KIND.get(yamlKind);
+}
+/** Resolve a handler from a proto message's fully-qualified type name. */
+export function manifestHandlerForTypeName(typeName) {
+    return BY_TYPE_NAME.get(typeName);
+}
+//# sourceMappingURL=registry.js.map

package/manifest/registry.js.map

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