@stigmer/sdk 3.2.3 → 3.3.0

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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"}

package/manifest/serialize.d.ts

@@ -0,0 +1,24 @@
+import { type Message } from "@bufbuild/protobuf";
+/**
+ * Serialize a resource proto into the canonical, editable Stigmer YAML form.
+ *
+ * The resource kind is derived from the message's proto type, so any
+ * registry-supported resource (an `Agent` from `stigmer.agent.get()`, an
+ * `Environment` from `stigmer.environment.get()`, …) serializes with the
+ * same call. `metadata.id` is preserved — the output is a full-fidelity
+ * representation of the stored resource, minus system-managed state.
+ *
+ * @param message - A resource proto of a registry-supported kind.
+ * @returns YAML text suitable for editing and re-applying.
+ * @throws {Error} When the message's kind is not in the manifest registry.
+ *
+ * @example
+ * ```ts
+ * import { serializeManifest } from "@stigmer/sdk";
+ *
+ * const agent = await stigmer.agent.get(agentId);
+ * const yaml = serializeManifest(agent);
+ * ```
+ */
+export declare function serializeManifest(message: Message): string;
+//# sourceMappingURL=serialize.d.ts.map

package/manifest/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/manifest/serialize.ts"],"names":[],"mappings":"AAeA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAoC1D"}

package/manifest/serialize.js

@@ -0,0 +1,78 @@
+// Proto → canonical Stigmer YAML serialization.
+//
+// Follows the platform-wide protojson parity contract (Go CLI, TS CLI
+// output/proto.ts, mcp-server marshal.ts): `toJson` with
+// `useProtoFieldName: true` emits snake_case field names and omits unset
+// defaults, so the output round-trips through `parseManifest`'s strict
+// `fromJson` without loss.
+//
+// Two deliberate departures from the raw protojson projection, both for
+// the *editable manifest* use case:
+//   - `status` and `metadata.version` are stripped — they are system-managed
+//     and would be ignored (or rejected) on apply.
+//   - the envelope field is spelled `apiVersion` (the canonical form used in
+//     every repo manifest and doc); `fromJson` accepts both spellings.
+import { toJson } from "@bufbuild/protobuf";
+import { stringify as stringifyYaml } from "yaml";
+import { manifestHandlerForTypeName, manifestKinds } from "./registry.js";
+/**
+ * Serialize a resource proto into the canonical, editable Stigmer YAML form.
+ *
+ * The resource kind is derived from the message's proto type, so any
+ * registry-supported resource (an `Agent` from `stigmer.agent.get()`, an
+ * `Environment` from `stigmer.environment.get()`, …) serializes with the
+ * same call. `metadata.id` is preserved — the output is a full-fidelity
+ * representation of the stored resource, minus system-managed state.
+ *
+ * @param message - A resource proto of a registry-supported kind.
+ * @returns YAML text suitable for editing and re-applying.
+ * @throws {Error} When the message's kind is not in the manifest registry.
+ *
+ * @example
+ * ```ts
+ * import { serializeManifest } from "@stigmer/sdk";
+ *
+ * const agent = await stigmer.agent.get(agentId);
+ * const yaml = serializeManifest(agent);
+ * ```
+ */
+export function serializeManifest(message) {
+    const handler = manifestHandlerForTypeName(message.$typeName);
+    if (handler === undefined) {
+        const supported = manifestKinds()
+            .map((h) => h.yamlKind)
+            .join(", ");
+        throw new Error(`Cannot serialize ${message.$typeName} as a manifest: kind is not ` +
+            `in the manifest registry. Supported kinds: ${supported}.`);
+    }
+    const json = toJson(handler.schema, message, { useProtoFieldName: true });
+    if (json === null || typeof json !== "object" || Array.isArray(json)) {
+        throw new Error(`Cannot serialize ${handler.displayName}: unexpected non-object ` +
+            "protojson projection.");
+    }
+    const { api_version, kind, status, metadata, ...rest } = json;
+    void status;
+    const doc = {
+        apiVersion: typeof api_version === "string" && api_version !== ""
+            ? api_version
+            : handler.apiVersion,
+        kind: typeof kind === "string" && kind !== "" ? kind : handler.yamlKind,
+        ...(isPlainObject(metadata) && { metadata: stripSystemMetadata(metadata) }),
+        ...rest,
+    };
+    // lineWidth: 0 disables wrapping (long instruction lines stay intact);
+    // blockQuote: "literal" renders multi-line strings as readable `|` blocks.
+    return stringifyYaml(doc, { lineWidth: 0, blockQuote: "literal" });
+}
+// metadata.version (version id, previous-version pointer, tag) is written by
+// the server on every mutation; round-tripping it through an edit would be
+// misleading at best. Everything else — including id — is user-meaningful.
+function stripSystemMetadata(metadata) {
+    const { version, ...rest } = metadata;
+    void version;
+    return rest;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=serialize.js.map

package/manifest/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/manifest/serialize.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,sEAAsE;AACtE,yDAAyD;AACzD,yEAAyE;AACzE,uEAAuE;AACvE,2BAA2B;AAC3B,EAAE;AACF,wEAAwE;AACxE,oCAAoC;AACpC,6EAA6E;AAC7E,mDAAmD;AACnD,6EAA6E;AAC7E,uEAAuE;AAEvE,OAAO,EAAE,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,MAAM,OAAO,GAAG,0BAA0B,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9D,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,oBAAoB,OAAO,CAAC,SAAS,8BAA8B;YACjE,8CAA8C,SAAS,GAAG,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CACb,oBAAoB,OAAO,CAAC,WAAW,0BAA0B;YAC/D,uBAAuB,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GACpD,IAA+B,CAAC;IAClC,KAAK,MAAM,CAAC;IAEZ,MAAM,GAAG,GAA4B;QACnC,UAAU,EAAE,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,EAAE;YAC/D,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,OAAO,CAAC,UAAU;QACtB,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ;QACvE,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3E,GAAG,IAAI;KACR,CAAC;IAEF,uEAAuE;IACvE,2EAA2E;IAC3E,OAAO,aAAa,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,SAAS,mBAAmB,CAC1B,QAAiC;IAEjC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;IACtC,KAAK,OAAO,CAAC;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/sdk",
-  "version": "3.2.3",
+  "version": "3.3.0",
   "description": "Stigmer TypeScript SDK — typed API client for all Stigmer platform resources",
   "license": "Apache-2.0",
   "type": "module",
@@ -39,11 +39,12 @@
   },
   "dependencies": {
     "@connectrpc/connect": "^2.0.0",
-    "@connectrpc/connect-web": "^2.0.0"
+    "@connectrpc/connect-web": "^2.0.0",
+    "yaml": "^2.8.2"
   },
   "peerDependencies": {
     "@bufbuild/protobuf": "^2.0.0",
     "@connectrpc/connect-node": "^2.0.0",
-    "@stigmer/protos": "3.2.3"
+    "@stigmer/protos": "3.3.0"
   }
 }

package/src/__tests__/errors.test.ts

@@ -8,6 +8,7 @@ import {
   isTransientStreamError,
   getUserMessage,
   getErrorReason,
+  getRecordConstraint,
   annotateRpcError,
   getRpcMetadata,
   type ErrorCategory,
@@ -328,6 +329,63 @@ describe("getErrorReason", () => {
   });
 });
 
+describe("getRecordConstraint", () => {
+  const recordViolation = (metadata: Record<string, string>) =>
+    new ConnectError("that slot is already booked", Code.AlreadyExists, undefined, [
+      {
+        desc: ErrorInfoSchema,
+        value: {
+          domain: "datastore.stigmer.ai",
+          reason: "CONSTRAINT_VIOLATION",
+          metadata,
+        },
+      },
+    ]);
+
+  it("extracts the constraint name from a record-RPC violation", () => {
+    expect(getRecordConstraint(recordViolation({ constraint: "one_confirmed_per_slot" })))
+      .toBe("one_confirmed_per_slot");
+  });
+
+  it("walks the cause chain of an SDK-wrapped StigmerError", () => {
+    const connectError = recordViolation({ constraint: "one_confirmed_per_slot" });
+    const wrapped = new StigmerError(
+      "already-exists",
+      connectError.rawMessage,
+      Code.AlreadyExists,
+      { cause: connectError },
+    );
+    expect(getRecordConstraint(wrapped)).toBe("one_confirmed_per_slot");
+  });
+
+  it("returns null when the ErrorInfo domain is not the records domain", () => {
+    const foreign = new ConnectError("workspace taken", Code.FailedPrecondition, undefined, [
+      {
+        desc: ErrorInfoSchema,
+        value: {
+          domain: "stigmer.ai",
+          reason: "SLACK_WORKSPACE_ALREADY_CONNECTED",
+          metadata: { constraint: "should_not_leak" },
+        },
+      },
+    ]);
+    expect(getRecordConstraint(foreign)).toBeNull();
+  });
+
+  it("returns null when the violation carries no constraint metadata", () => {
+    expect(getRecordConstraint(recordViolation({}))).toBeNull();
+    expect(getRecordConstraint(recordViolation({ constraint: "" }))).toBeNull();
+  });
+
+  it("returns null for errors without ErrorInfo", () => {
+    expect(
+      getRecordConstraint(new ConnectError("bare", Code.AlreadyExists)),
+    ).toBeNull();
+    expect(getRecordConstraint(new Error("plain"))).toBeNull();
+    expect(getRecordConstraint(null)).toBeNull();
+  });
+});
+
 describe("annotateRpcError / getRpcMetadata", () => {
   it("roundtrips metadata on an error object", () => {
     const err = new Error("test");

package/src/__tests__/manifest.test.ts

@@ -0,0 +1,271 @@
+import { describe, it, expect } from "vitest";
+import { create, equals } from "@bufbuild/protobuf";
+import { AgentSchema, type Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import { EnvironmentSchema, type Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { parse as parseYaml } from "yaml";
+import { parseManifest } from "../manifest/parse";
+import { serializeManifest } from "../manifest/serialize";
+import { manifestKinds, manifestHandlerForYamlKind } from "../manifest/registry";
+
+/**
+ * Manifest engine contract tests.
+ *
+ * The engine's core promise is *round-trip fidelity against the generated
+ * proto schemas*: any resource the server returns serializes to YAML that
+ * parses back to the same proto (minus system-managed state), and any
+ * repo-authored manifest (snake_case fields, `apiVersion` spelling) parses
+ * to a proto the `apply` RPC accepts. Fixtures mirror the real manifests
+ * in the whatsapp-doctor-assistant dogfooding repo.
+ */
+
+// ---------------------------------------------------------------------------
+// Fixtures — shaped like the whatsapp-doctor-assistant repo manifests
+// ---------------------------------------------------------------------------
+
+const AGENT_YAML = `
+apiVersion: agentic.stigmer.ai/v1
+kind: Agent
+metadata:
+  name: clinic-patient-assistant
+  org: rakeshreddi098
+spec:
+  description: Patient-facing WhatsApp assistant for the clinic.
+  instructions: |
+    You are the appointment assistant for the clinic.
+    Short messages. One question at a time.
+`;
+
+const ENVIRONMENT_YAML = `
+apiVersion: agentic.stigmer.ai/v1
+kind: Environment
+metadata:
+  name: clinic-patient-db
+  org: rakeshreddi098
+spec:
+  description: "Clinic records access for the patient assistant"
+  data:
+    POSTGRES_CONNECTION_URL:
+      value: "postgresql://patient_role:secret@host:5432/postgres"
+      is_secret: true
+      description: "Supabase Postgres connection URL for patient_role"
+`;
+
+const AGENT_CHANNEL_YAML = `
+apiVersion: agentic.stigmer.ai/v1
+kind: AgentChannel
+metadata:
+  name: clinic-patient-whatsapp
+  org: rakeshreddi098
+spec:
+  agent_ref:
+    kind: agent
+    org: rakeshreddi098
+    slug: clinic-patient-assistant
+  enabled: true
+  whatsapp:
+    phone_number_id: "1234567890"
+  app_ref:
+    kind: channel_app
+    org: rakeshreddi098
+    slug: hosipital
+  environment_refs:
+    - kind: environment
+      org: rakeshreddi098
+      slug: clinic-patient-db
+`;
+
+// ---------------------------------------------------------------------------
+// parseManifest
+// ---------------------------------------------------------------------------
+
+describe("parseManifest", () => {
+  it("parses a snake_case Agent manifest into a full Agent proto", () => {
+    const docs = parseManifest(AGENT_YAML);
+    expect(docs).toHaveLength(1);
+
+    const doc = docs[0];
+    expect(doc.handler.yamlKind).toBe("Agent");
+    expect(doc.name).toBe("clinic-patient-assistant");
+    expect(doc.org).toBe("rakeshreddi098");
+
+    const agent = doc.message as Agent;
+    expect(agent.spec?.description).toBe(
+      "Patient-facing WhatsApp assistant for the clinic.",
+    );
+    expect(agent.spec?.instructions).toContain("appointment assistant");
+  });
+
+  it("parses an AgentChannel manifest with enum-valued resource refs", () => {
+    const docs = parseManifest(AGENT_CHANNEL_YAML);
+    expect(docs).toHaveLength(1);
+    expect(docs[0].handler.yamlKind).toBe("AgentChannel");
+    expect(docs[0].slug).toBe("clinic-patient-whatsapp");
+  });
+
+  it("sorts multi-document manifests into dependency apply order", () => {
+    // Authored channel-first; the Environment must still apply first.
+    const docs = parseManifest(`${AGENT_CHANNEL_YAML}\n---\n${ENVIRONMENT_YAML}`);
+    expect(docs.map((d) => d.handler.yamlKind)).toEqual([
+      "Environment",
+      "AgentChannel",
+    ]);
+  });
+
+  it("injects the target org when the document omits it", () => {
+    const yaml = AGENT_YAML.replace("  org: rakeshreddi098\n", "");
+    const docs = parseManifest(yaml, { org: "acme" });
+    expect(docs[0].org).toBe("acme");
+    expect(docs[0].warning).toBeUndefined();
+  });
+
+  it("honors the document org and warns when it differs from the target", () => {
+    const docs = parseManifest(AGENT_YAML, { org: "acme" });
+    expect(docs[0].org).toBe("rakeshreddi098");
+    expect(docs[0].warning).toContain('"rakeshreddi098"');
+    expect(docs[0].warning).toContain('"acme"');
+  });
+
+  it("rejects unknown fields loudly (strict schema contract)", () => {
+    const yaml = AGENT_YAML.replace("spec:", "spec:\n  instrctions: typo");
+    expect(() => parseManifest(yaml)).toThrow(/Invalid Agent/);
+  });
+
+  it("rejects a document without a kind", () => {
+    expect(() => parseManifest("metadata:\n  name: x\n")).toThrow(/'kind'/);
+  });
+
+  it("rejects unsupported kinds with the supported list", () => {
+    expect(() => parseManifest("kind: Skill\nmetadata:\n  name: x\n")).toThrow(
+      /Unsupported resource kind "Skill".*Agent/s,
+    );
+  });
+
+  it("rejects empty input with actionable guidance", () => {
+    expect(() => parseManifest("   \n")).toThrow(/empty/i);
+  });
+
+  it("rejects malformed YAML", () => {
+    expect(() => parseManifest("kind: Agent\n  bad indent: [")).toThrow(
+      /Invalid YAML/,
+    );
+  });
+});
+
+// ---------------------------------------------------------------------------
+// serializeManifest
+// ---------------------------------------------------------------------------
+
+describe("serializeManifest", () => {
+  const agent = create(AgentSchema, {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "Agent",
+    metadata: {
+      id: "agt_01example",
+      name: "clinic-patient-assistant",
+      slug: "clinic-patient-assistant",
+      org: "rakeshreddi098",
+      version: { id: "ver_01", message: "server-managed" },
+    },
+    spec: {
+      description: "Patient-facing WhatsApp assistant.",
+      instructions: "Short messages.\nOne question at a time.\n",
+    },
+    status: { defaultInstanceId: "agi_01example" },
+  });
+
+  it("emits the canonical envelope: apiVersion spelling, no status", () => {
+    const yaml = serializeManifest(agent);
+    const doc = parseYaml(yaml) as Record<string, unknown>;
+
+    expect(Object.keys(doc)[0]).toBe("apiVersion");
+    expect(doc.apiVersion).toBe("agentic.stigmer.ai/v1");
+    expect(doc.kind).toBe("Agent");
+    expect(doc.status).toBeUndefined();
+    expect(yaml).not.toContain("api_version:");
+  });
+
+  it("keeps metadata.id but strips server-managed metadata.version", () => {
+    const doc = parseYaml(serializeManifest(agent)) as {
+      metadata: Record<string, unknown>;
+    };
+    expect(doc.metadata.id).toBe("agt_01example");
+    expect(doc.metadata.version).toBeUndefined();
+  });
+
+  it("fills apiVersion and kind from the registry when the proto omits them", () => {
+    const bare = create(AgentSchema, {
+      metadata: { name: "x", org: "acme" },
+    });
+    const doc = parseYaml(serializeManifest(bare)) as Record<string, unknown>;
+    expect(doc.apiVersion).toBe("agentic.stigmer.ai/v1");
+    expect(doc.kind).toBe("Agent");
+  });
+
+  it("round-trips through parseManifest to an equal proto", () => {
+    const docs = parseManifest(serializeManifest(agent));
+    expect(docs).toHaveLength(1);
+
+    // The round-tripped proto matches the original minus system-managed
+    // state (status, metadata.version) — exactly what apply consumes.
+    const expected = create(AgentSchema, {
+      ...agent,
+      status: undefined,
+      metadata: { ...agent.metadata!, version: undefined },
+    });
+    expect(equals(AgentSchema, docs[0].message as Agent, expected)).toBe(true);
+  });
+
+  it("round-trips Environment secret values byte-identically", () => {
+    const env = create(EnvironmentSchema, {
+      metadata: { name: "clinic-patient-db", org: "rakeshreddi098" },
+      spec: {
+        data: {
+          POSTGRES_CONNECTION_URL: {
+            value: "***REDACTED***",
+            isSecret: true,
+            description: "Supabase Postgres connection URL",
+          },
+        },
+      },
+    });
+
+    const docs = parseManifest(serializeManifest(env));
+    const roundTripped = docs[0].message as Environment;
+    expect(roundTripped.spec?.data.POSTGRES_CONNECTION_URL?.value).toBe(
+      "***REDACTED***",
+    );
+    expect(roundTripped.spec?.data.POSTGRES_CONNECTION_URL?.isSecret).toBe(true);
+  });
+
+  it("rejects messages of kinds outside the registry", () => {
+    // ApiResourceMetadata is a real proto message but not a manifest kind.
+    const notAResource = create(ApiResourceMetadataSchema, { name: "x" });
+    expect(() => serializeManifest(notAResource)).toThrow(/not.*registry/i);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Registry invariants
+// ---------------------------------------------------------------------------
+
+describe("manifest registry", () => {
+  it("every handler resolves by its own YAML kind", () => {
+    for (const handler of manifestKinds()) {
+      expect(manifestHandlerForYamlKind(handler.yamlKind)).toBe(handler);
+    }
+  });
+
+  it("apply order is strictly increasing (no accidental ties)", () => {
+    const orders = manifestKinds().map((h) => h.applyOrder);
+    for (let i = 1; i < orders.length; i++) {
+      expect(orders[i]).toBeGreaterThan(orders[i - 1]);
+    }
+  });
+
+  it("covers the kinds the console flows depend on", () => {
+    for (const kind of ["Agent", "McpServer", "Workflow", "Environment", "AgentChannel", "ChannelApp"]) {
+      expect(manifestHandlerForYamlKind(kind), `missing handler for ${kind}`).toBeDefined();
+    }
+  });
+});