@stigmer/sdk 3.0.8-dev.20260613074252 → 3.0.8

package/src/synth/context.ts

@@ -0,0 +1,141 @@
+// ProjectContext — the resource-registration surface handed to a
+// `defineProject` builder.
+//
+// Each `ctx.<kind>()` records one ergonomic `*Input` (the very types the
+// `@stigmer/sdk` resource clients already accept) in registration order;
+// `ctx.skill.fromDir` / `ctx.skill.fromGit` record a `SkillSynth` handover
+// message (the SDK→CLI contract from `synth.proto`). The writer later turns
+// these registrations into the `.pb` files the CLI consumes. Reusing the
+// `*Input` types — not a new authoring vocabulary — keeps the synthesis surface
+// identical to the imperative SDK, so there is exactly one way to describe a
+// resource in TypeScript (DD-009 §1, §4).
+//
+// Org defaults from `STIGMER_ORG_ID` when a resource omits it, mirroring the
+// CLI's org injection (apply.ts `injectOrg`) so a project authored without an
+// explicit org still synthesizes to valid protos when run via `stigmer apply`.
+
+import { create } from "@bufbuild/protobuf";
+import {
+  GitSchema,
+  LocalDirSchema,
+  type SkillSynth,
+  SkillSynthSchema,
+} from "@stigmer/protos/ai/stigmer/agentic/skill/v1/synth_pb";
+import type { AgentInput } from "../gen/agent";
+import type { McpServerInput } from "../gen/mcpserver";
+import type { WorkflowInput } from "../gen/workflow";
+
+/** Options for registering a skill from a local directory. */
+export interface SkillFromDirOptions {
+  /** Mutable version tag (the CLI defaults this to "latest" at push time). */
+  readonly tag?: string;
+}
+
+/** Input for registering a skill sourced from a remote git repository. */
+export interface SkillFromGitInput {
+  /** Git repository URL (HTTPS or SSH). */
+  readonly url: string;
+  /** Tag, branch, or commit SHA; empty resolves to the default branch. */
+  readonly ref?: string;
+  /** Subdirectory within the repo that holds SKILL.md; empty = repo root. */
+  readonly subdir?: string;
+  /** Mutable version tag (the CLI defaults this to "latest" at push time). */
+  readonly tag?: string;
+}
+
+// Opaque registration record returned by ctx.skill.* so the builder reads
+// naturally (and to leave room for future linkage ergonomics). Agents reference
+// skills by slug via AgentInput.skillRefs, exactly as in the declarative track —
+// a skill's slug is its SKILL.md name, which the backend assigns at push time.
+export interface SkillHandle {
+  readonly kind: "skill";
+  readonly synth: SkillSynth;
+}
+
+/** One ordered registration captured by the context. */
+export type Registration =
+  | { readonly kind: "agent"; readonly input: AgentInput }
+  | { readonly kind: "workflow"; readonly input: WorkflowInput }
+  | { readonly kind: "mcpServer"; readonly input: McpServerInput }
+  | { readonly kind: "skill"; readonly synth: SkillSynth };
+
+/** The resource-registration API passed to a `defineProject` builder. */
+export interface ProjectContext {
+  /** Register an agent for synthesis. */
+  agent(input: AgentInput): void;
+  /** Register a workflow for synthesis. */
+  workflow(input: WorkflowInput): void;
+  /** Register an MCP server for synthesis. */
+  mcpServer(input: McpServerInput): void;
+  /** Register skills sourced from a local directory or a git repository. */
+  readonly skill: {
+    fromDir(path: string, opts?: SkillFromDirOptions): SkillHandle;
+    fromGit(input: SkillFromGitInput): SkillHandle;
+  };
+}
+
+/**
+ * Concrete {@link ProjectContext} that accumulates registrations in order.
+ * `defineProject` runs the user's builder against one of these, then hands the
+ * collected registrations to the writer.
+ */
+export class RegistrationContext implements ProjectContext {
+  private readonly registrations: Registration[] = [];
+  private readonly defaultOrg: string;
+
+  constructor(defaultOrg: string = process.env.STIGMER_ORG_ID ?? "") {
+    this.defaultOrg = defaultOrg;
+  }
+
+  agent(input: AgentInput): void {
+    this.registrations.push({ kind: "agent", input: this.withOrg(input) });
+  }
+
+  workflow(input: WorkflowInput): void {
+    this.registrations.push({ kind: "workflow", input: this.withOrg(input) });
+  }
+
+  mcpServer(input: McpServerInput): void {
+    this.registrations.push({ kind: "mcpServer", input: this.withOrg(input) });
+  }
+
+  readonly skill = {
+    fromDir: (path: string, opts?: SkillFromDirOptions): SkillHandle => {
+      const synth = create(SkillSynthSchema, {
+        source: { case: "local", value: create(LocalDirSchema, { path }) },
+        tag: opts?.tag ?? "",
+      });
+      this.registrations.push({ kind: "skill", synth });
+      return { kind: "skill", synth };
+    },
+    fromGit: (input: SkillFromGitInput): SkillHandle => {
+      const synth = create(SkillSynthSchema, {
+        source: {
+          case: "git",
+          value: create(GitSchema, {
+            url: input.url,
+            ref: input.ref ?? "",
+            subdir: input.subdir ?? "",
+          }),
+        },
+        tag: input.tag ?? "",
+      });
+      this.registrations.push({ kind: "skill", synth });
+      return { kind: "skill", synth };
+    },
+  };
+
+  /** Registrations captured so far, in builder-call order. */
+  collect(): readonly Registration[] {
+    return this.registrations;
+  }
+
+  // Fill org from STIGMER_ORG_ID only when the resource left it blank; an
+  // explicit org always wins (the CLI later warns on org mismatch, not here).
+  private withOrg<T extends { org: string }>(input: T): T {
+    if (this.defaultOrg !== "" && (input.org === undefined || input.org === "")) {
+      return { ...input, org: this.defaultOrg };
+    }
+    return input;
+  }
+}

package/src/synth/index.ts

@@ -0,0 +1,85 @@
+// `@stigmer/sdk/synth` — the project-synthesis authoring API (the "producer").
+//
+// A user's entry point describes resources functionally and synthesizes them to
+// proto `.pb` files that `stigmer apply` consumes:
+//
+//   import { defineProject } from "@stigmer/sdk/synth";
+//
+//   const project = defineProject((ctx) => {
+//     ctx.skill.fromDir("./skills/calculator");
+//     ctx.agent({ name: "support-bot", org: "acme", instructions: "…" });
+//   });
+//
+//   await project.synth();
+//
+// `synth()` is EXPLICIT (no import-time / beforeExit magic): the builder runs
+// lazily inside it, honoring `@stigmer/sdk`'s `sideEffects: false` and staying
+// trivially testable via `synth({ outDir })` (DD-009 §1). Node-only — it writes
+// files — and exported from the dedicated `/synth` subpath (DD-009 §2).
+
+import { RegistrationContext } from "./context";
+import { countRegistrations, type SynthCounts, writeRegistrations } from "./writer";
+import type { ProjectContext } from "./context";
+
+export type {
+  ProjectContext,
+  Registration,
+  SkillFromDirOptions,
+  SkillFromGitInput,
+  SkillHandle,
+} from "./context";
+export type { SynthCounts, SynthFile } from "./writer";
+export { serializeRegistrations } from "./writer";
+
+/** Options for {@link ProjectApp.synth}. */
+export interface SynthOptions {
+  /** Output directory; defaults to `process.env.STIGMER_OUT_DIR`. */
+  readonly outDir?: string;
+  /** Default org for resources that omit one; defaults to `STIGMER_ORG_ID`. */
+  readonly org?: string;
+}
+
+/** Outcome of a synthesis run. */
+export interface SynthResult {
+  /** Directory the `.pb` files were written to. */
+  readonly outDir: string;
+  /** Names of the written `.pb` files, in registration order. */
+  readonly files: readonly string[];
+  /** Per-kind resource counts. */
+  readonly counts: SynthCounts;
+}
+
+/** A builder that registers resources on the given context (sync or async). */
+export type ProjectBuilder = (ctx: ProjectContext) => void | Promise<void>;
+
+/** A synthesizable project produced by {@link defineProject}. */
+export interface ProjectApp {
+  /** Run the builder and write the `.pb` artifacts; resolves to a summary. */
+  synth(opts?: SynthOptions): Promise<SynthResult>;
+}
+
+/**
+ * Define a synthesizable project. The `build` callback is NOT run here — it runs
+ * lazily inside {@link ProjectApp.synth}, so importing the module has no side
+ * effects and the same app can be synthesized to different out dirs in tests.
+ */
+export function defineProject(build: ProjectBuilder): ProjectApp {
+  return {
+    async synth(opts?: SynthOptions): Promise<SynthResult> {
+      const outDir = opts?.outDir ?? process.env.STIGMER_OUT_DIR;
+      if (outDir === undefined || outDir === "") {
+        throw new Error(
+          "no synthesis output directory\n\n" +
+            "Run this project via `stigmer apply` (which sets STIGMER_OUT_DIR), " +
+            "or call project.synth({ outDir }) with an explicit directory.",
+        );
+      }
+
+      const ctx = new RegistrationContext(opts?.org ?? process.env.STIGMER_ORG_ID ?? "");
+      await build(ctx);
+      const registrations = ctx.collect();
+      const files = writeRegistrations(outDir, registrations);
+      return { outDir, files, counts: countRegistrations(registrations) };
+    },
+  };
+}

package/src/synth/writer.ts

@@ -0,0 +1,100 @@
+// Writer — turns ordered {@link Registration}s into the proto `.pb` files the
+// CLI's synthesis reader consumes.
+//
+// Each kind gets its own zero-based counter, producing `agent-N.pb`,
+// `workflow-N.pb`, `mcpserver-N.pb`, and `skill-N.pb`. These names and the
+// binary encoding are the SDK↔CLI handoff contract: they must match the reader's
+// glob/sort (`<kind>-*.pb`, lexically sorted) on both the Go and TS consumers
+// (reader.go / reader.ts). Resources are serialized via protobuf-es `toBinary`
+// (DD-009 §3); the full proto is built by reusing the generated, package-private
+// `build<Kind>Proto` helpers (DD-009 §4) so synthesis and the imperative SDK
+// share one field mapping. Skills are already `SkillSynth` messages and are
+// encoded directly.
+
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { toBinary } from "@bufbuild/protobuf";
+import { AgentSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import { SkillSynthSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/synth_pb";
+import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import { buildAgentProto } from "../gen/agent";
+import { buildMcpServerProto } from "../gen/mcpserver";
+import { buildWorkflowProto } from "../gen/workflow";
+import type { Registration } from "./context";
+
+/** One serialized synthesis artifact: its file name and binary proto bytes. */
+export interface SynthFile {
+  readonly name: string;
+  readonly bytes: Uint8Array;
+}
+
+/** Per-kind counts of synthesized resources. */
+export interface SynthCounts {
+  readonly agents: number;
+  readonly workflows: number;
+  readonly mcpServers: number;
+  readonly skills: number;
+}
+
+/**
+ * Serialize registrations into named `.pb` artifacts, in registration order,
+ * with a per-kind zero-based index. Pure (no filesystem) so it is trivially
+ * unit-testable and reusable by callers that want the bytes without writing.
+ */
+export function serializeRegistrations(registrations: readonly Registration[]): SynthFile[] {
+  const next = { agent: 0, workflow: 0, mcpServer: 0, skill: 0 };
+  const files: SynthFile[] = [];
+  for (const reg of registrations) {
+    switch (reg.kind) {
+      case "agent":
+        files.push({ name: `agent-${next.agent++}.pb`, bytes: toBinary(AgentSchema, buildAgentProto(reg.input)) });
+        break;
+      case "workflow":
+        files.push({
+          name: `workflow-${next.workflow++}.pb`,
+          bytes: toBinary(WorkflowSchema, buildWorkflowProto(reg.input)),
+        });
+        break;
+      case "mcpServer":
+        files.push({
+          name: `mcpserver-${next.mcpServer++}.pb`,
+          bytes: toBinary(McpServerSchema, buildMcpServerProto(reg.input)),
+        });
+        break;
+      case "skill":
+        files.push({ name: `skill-${next.skill++}.pb`, bytes: toBinary(SkillSynthSchema, reg.synth) });
+        break;
+    }
+  }
+  return files;
+}
+
+/** Tally registrations by kind (for the synth result summary). */
+export function countRegistrations(registrations: readonly Registration[]): SynthCounts {
+  let agents = 0;
+  let workflows = 0;
+  let mcpServers = 0;
+  let skills = 0;
+  for (const reg of registrations) {
+    if (reg.kind === "agent") agents++;
+    else if (reg.kind === "workflow") workflows++;
+    else if (reg.kind === "mcpServer") mcpServers++;
+    else skills++;
+  }
+  return { agents, workflows, mcpServers, skills };
+}
+
+/**
+ * Serialize and write all registrations into `outDir`, returning the written
+ * file names. The directory is created if absent (idempotent) — synthesis owns
+ * its output target, like CDK's `app.synth()` creating `cdk.out`.
+ */
+export function writeRegistrations(outDir: string, registrations: readonly Registration[]): string[] {
+  const files = serializeRegistrations(registrations);
+  mkdirSync(outDir, { recursive: true });
+  for (const file of files) {
+    writeFileSync(join(outDir, file.name), file.bytes);
+  }
+  return files.map((file) => file.name);
+}

package/src/synth.ts

@@ -0,0 +1,8 @@
+// Node-only entry point for the project-synthesis authoring API.
+//
+// Re-exports `@stigmer/sdk/synth` (see ./synth/index.ts). Kept as a thin
+// top-level module so the package `exports` map can expose `"./synth"` the same
+// way `"./node"` maps to ./node.ts — a capability subpath, not a client noun
+// (DD-009 §2).
+
+export * from "./synth/index.js";

package/synth/__tests__/synth.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=synth.test.d.ts.map

package/synth/__tests__/synth.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synth.test.d.ts","sourceRoot":"","sources":["../../../src/synth/__tests__/synth.test.ts"],"names":[],"mappings":""}

package/synth/__tests__/synth.test.js

@@ -0,0 +1,143 @@
+// Tests for the `@stigmer/sdk/synth` producer: explicit synth writes the
+// reader-contract file names in order, each artifact round-trips through
+// fromBinary, skills serialize both local and git sources, async builders are
+// awaited, and a missing out dir produces actionable guidance.
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fromBinary } from "@bufbuild/protobuf";
+import { AgentSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import { SkillSynthSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/synth_pb";
+import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { defineProject } from "../index";
+let outDir;
+beforeEach(() => {
+    outDir = mkdtempSync(join(tmpdir(), "stigmer-synth-"));
+});
+afterEach(() => {
+    rmSync(outDir, { recursive: true, force: true });
+});
+function readProto(schema, name) {
+    return fromBinary(schema, readFileSync(join(outDir, name)));
+}
+describe("defineProject().synth()", () => {
+    it("writes per-kind, zero-indexed file names in registration order", async () => {
+        const project = defineProject((ctx) => {
+            ctx.skill.fromDir("./skills/calculator");
+            ctx.mcpServer({ name: "fs", org: "acme" });
+            ctx.agent({ name: "support-bot", org: "acme", instructions: "help" });
+            ctx.agent({ name: "sales-bot", org: "acme", instructions: "sell" });
+            ctx.workflow({
+                name: "onboard",
+                org: "acme",
+                document: { namespace: "acme", name: "onboard", version: "1.0.0" },
+            });
+        });
+        const result = await project.synth({ outDir });
+        expect(result.outDir).toBe(outDir);
+        expect(result.counts).toEqual({ agents: 2, workflows: 1, mcpServers: 1, skills: 1 });
+        expect(result.files).toEqual([
+            "skill-0.pb",
+            "mcpserver-0.pb",
+            "agent-0.pb",
+            "agent-1.pb",
+            "workflow-0.pb",
+        ]);
+    });
+    it("round-trips each kind through fromBinary", async () => {
+        const project = defineProject((ctx) => {
+            ctx.agent({ name: "support-bot", org: "acme", instructions: "be helpful" });
+            ctx.workflow({
+                name: "onboard",
+                org: "acme",
+                document: { namespace: "acme", name: "onboard", version: "2.1.0" },
+            });
+            ctx.mcpServer({ name: "filesystem", org: "acme" });
+        });
+        await project.synth({ outDir });
+        const agent = readProto(AgentSchema, "agent-0.pb");
+        expect(agent.metadata?.name).toBe("support-bot");
+        expect(agent.metadata?.org).toBe("acme");
+        expect(agent.spec?.instructions).toBe("be helpful");
+        const workflow = readProto(WorkflowSchema, "workflow-0.pb");
+        expect(workflow.spec?.document?.name).toBe("onboard");
+        expect(workflow.spec?.document?.version).toBe("2.1.0");
+        const mcp = readProto(McpServerSchema, "mcpserver-0.pb");
+        expect(mcp.metadata?.name).toBe("filesystem");
+    });
+    it("serializes skills from a local directory", async () => {
+        const project = defineProject((ctx) => {
+            ctx.skill.fromDir("./skills/calculator", { tag: "stable" });
+        });
+        await project.synth({ outDir });
+        const synth = readProto(SkillSynthSchema, "skill-0.pb");
+        expect(synth.source.case).toBe("local");
+        expect(synth.source.value.path).toBe("./skills/calculator");
+        expect(synth.tag).toBe("stable");
+    });
+    it("serializes skills from a git repository", async () => {
+        const project = defineProject((ctx) => {
+            ctx.skill.fromGit({ url: "https://github.com/acme/skills.git", ref: "v1", subdir: "calc" });
+        });
+        await project.synth({ outDir });
+        const synth = readProto(SkillSynthSchema, "skill-0.pb");
+        expect(synth.source.case).toBe("git");
+        expect(synth.source.value.url).toBe("https://github.com/acme/skills.git");
+        expect(synth.source.value.ref).toBe("v1");
+        expect(synth.source.value.subdir).toBe("calc");
+    });
+    it("awaits an async builder", async () => {
+        const project = defineProject(async (ctx) => {
+            await Promise.resolve();
+            ctx.agent({ name: "async-bot", org: "acme", instructions: "later" });
+        });
+        const result = await project.synth({ outDir });
+        expect(result.counts.agents).toBe(1);
+        expect(readProto(AgentSchema, "agent-0.pb").metadata?.name).toBe("async-bot");
+    });
+    it("defaults org from the synth({ org }) option when a resource omits it", async () => {
+        const project = defineProject((ctx) => {
+            ctx.agent({ name: "no-org-bot", org: "", instructions: "x" });
+        });
+        await project.synth({ outDir, org: "from-option" });
+        expect(readProto(AgentSchema, "agent-0.pb").metadata?.org).toBe("from-option");
+    });
+    it("does not run the builder until synth() is called", async () => {
+        let ran = false;
+        defineProject(() => {
+            ran = true;
+        });
+        expect(ran).toBe(false);
+    });
+    it("throws actionable guidance when no out dir is resolvable", async () => {
+        const saved = process.env.STIGMER_OUT_DIR;
+        delete process.env.STIGMER_OUT_DIR;
+        try {
+            const project = defineProject((ctx) => ctx.agent({ name: "x", org: "acme", instructions: "x" }));
+            await expect(project.synth()).rejects.toThrow(/no synthesis output directory/);
+            await expect(project.synth()).rejects.toThrow(/stigmer apply/);
+        }
+        finally {
+            if (saved !== undefined)
+                process.env.STIGMER_OUT_DIR = saved;
+        }
+    });
+    it("resolves the out dir from STIGMER_OUT_DIR when no option is passed", async () => {
+        const saved = process.env.STIGMER_OUT_DIR;
+        process.env.STIGMER_OUT_DIR = outDir;
+        try {
+            const project = defineProject((ctx) => ctx.agent({ name: "env-bot", org: "acme", instructions: "x" }));
+            const result = await project.synth();
+            expect(result.outDir).toBe(outDir);
+        }
+        finally {
+            if (saved !== undefined)
+                process.env.STIGMER_OUT_DIR = saved;
+            else
+                delete process.env.STIGMER_OUT_DIR;
+        }
+    });
+});
+//# sourceMappingURL=synth.test.js.map

package/synth/__tests__/synth.test.js.map

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

package/synth/context.d.ts

@@ -0,0 +1,73 @@
+import { type SkillSynth } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/synth_pb";
+import type { AgentInput } from "../gen/agent";
+import type { McpServerInput } from "../gen/mcpserver";
+import type { WorkflowInput } from "../gen/workflow";
+/** Options for registering a skill from a local directory. */
+export interface SkillFromDirOptions {
+    /** Mutable version tag (the CLI defaults this to "latest" at push time). */
+    readonly tag?: string;
+}
+/** Input for registering a skill sourced from a remote git repository. */
+export interface SkillFromGitInput {
+    /** Git repository URL (HTTPS or SSH). */
+    readonly url: string;
+    /** Tag, branch, or commit SHA; empty resolves to the default branch. */
+    readonly ref?: string;
+    /** Subdirectory within the repo that holds SKILL.md; empty = repo root. */
+    readonly subdir?: string;
+    /** Mutable version tag (the CLI defaults this to "latest" at push time). */
+    readonly tag?: string;
+}
+export interface SkillHandle {
+    readonly kind: "skill";
+    readonly synth: SkillSynth;
+}
+/** One ordered registration captured by the context. */
+export type Registration = {
+    readonly kind: "agent";
+    readonly input: AgentInput;
+} | {
+    readonly kind: "workflow";
+    readonly input: WorkflowInput;
+} | {
+    readonly kind: "mcpServer";
+    readonly input: McpServerInput;
+} | {
+    readonly kind: "skill";
+    readonly synth: SkillSynth;
+};
+/** The resource-registration API passed to a `defineProject` builder. */
+export interface ProjectContext {
+    /** Register an agent for synthesis. */
+    agent(input: AgentInput): void;
+    /** Register a workflow for synthesis. */
+    workflow(input: WorkflowInput): void;
+    /** Register an MCP server for synthesis. */
+    mcpServer(input: McpServerInput): void;
+    /** Register skills sourced from a local directory or a git repository. */
+    readonly skill: {
+        fromDir(path: string, opts?: SkillFromDirOptions): SkillHandle;
+        fromGit(input: SkillFromGitInput): SkillHandle;
+    };
+}
+/**
+ * Concrete {@link ProjectContext} that accumulates registrations in order.
+ * `defineProject` runs the user's builder against one of these, then hands the
+ * collected registrations to the writer.
+ */
+export declare class RegistrationContext implements ProjectContext {
+    private readonly registrations;
+    private readonly defaultOrg;
+    constructor(defaultOrg?: string);
+    agent(input: AgentInput): void;
+    workflow(input: WorkflowInput): void;
+    mcpServer(input: McpServerInput): void;
+    readonly skill: {
+        fromDir: (path: string, opts?: SkillFromDirOptions) => SkillHandle;
+        fromGit: (input: SkillFromGitInput) => SkillHandle;
+    };
+    /** Registrations captured so far, in builder-call order. */
+    collect(): readonly Registration[];
+    private withOrg;
+}
+//# sourceMappingURL=context.d.ts.map

package/synth/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/synth/context.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,wDAAwD;AACxD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,4CAA4C;IAC5C,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE;QACd,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,WAAW,CAAC;QAC/D,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAAC;KAChD,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,GAAE,MAAyC;IAIjE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAI9B,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIpC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAItC,QAAQ,CAAC,KAAK;wBACI,MAAM,SAAS,mBAAmB,KAAG,WAAW;yBAQ/C,iBAAiB,KAAG,WAAW;MAehD;IAEF,4DAA4D;IAC5D,OAAO,IAAI,SAAS,YAAY,EAAE;IAMlC,OAAO,CAAC,OAAO;CAMhB"}

package/synth/context.js

@@ -0,0 +1,76 @@
+// ProjectContext — the resource-registration surface handed to a
+// `defineProject` builder.
+//
+// Each `ctx.<kind>()` records one ergonomic `*Input` (the very types the
+// `@stigmer/sdk` resource clients already accept) in registration order;
+// `ctx.skill.fromDir` / `ctx.skill.fromGit` record a `SkillSynth` handover
+// message (the SDK→CLI contract from `synth.proto`). The writer later turns
+// these registrations into the `.pb` files the CLI consumes. Reusing the
+// `*Input` types — not a new authoring vocabulary — keeps the synthesis surface
+// identical to the imperative SDK, so there is exactly one way to describe a
+// resource in TypeScript (DD-009 §1, §4).
+//
+// Org defaults from `STIGMER_ORG_ID` when a resource omits it, mirroring the
+// CLI's org injection (apply.ts `injectOrg`) so a project authored without an
+// explicit org still synthesizes to valid protos when run via `stigmer apply`.
+import { create } from "@bufbuild/protobuf";
+import { GitSchema, LocalDirSchema, SkillSynthSchema, } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/synth_pb";
+/**
+ * Concrete {@link ProjectContext} that accumulates registrations in order.
+ * `defineProject` runs the user's builder against one of these, then hands the
+ * collected registrations to the writer.
+ */
+export class RegistrationContext {
+    registrations = [];
+    defaultOrg;
+    constructor(defaultOrg = process.env.STIGMER_ORG_ID ?? "") {
+        this.defaultOrg = defaultOrg;
+    }
+    agent(input) {
+        this.registrations.push({ kind: "agent", input: this.withOrg(input) });
+    }
+    workflow(input) {
+        this.registrations.push({ kind: "workflow", input: this.withOrg(input) });
+    }
+    mcpServer(input) {
+        this.registrations.push({ kind: "mcpServer", input: this.withOrg(input) });
+    }
+    skill = {
+        fromDir: (path, opts) => {
+            const synth = create(SkillSynthSchema, {
+                source: { case: "local", value: create(LocalDirSchema, { path }) },
+                tag: opts?.tag ?? "",
+            });
+            this.registrations.push({ kind: "skill", synth });
+            return { kind: "skill", synth };
+        },
+        fromGit: (input) => {
+            const synth = create(SkillSynthSchema, {
+                source: {
+                    case: "git",
+                    value: create(GitSchema, {
+                        url: input.url,
+                        ref: input.ref ?? "",
+                        subdir: input.subdir ?? "",
+                    }),
+                },
+                tag: input.tag ?? "",
+            });
+            this.registrations.push({ kind: "skill", synth });
+            return { kind: "skill", synth };
+        },
+    };
+    /** Registrations captured so far, in builder-call order. */
+    collect() {
+        return this.registrations;
+    }
+    // Fill org from STIGMER_ORG_ID only when the resource left it blank; an
+    // explicit org always wins (the CLI later warns on org mismatch, not here).
+    withOrg(input) {
+        if (this.defaultOrg !== "" && (input.org === undefined || input.org === "")) {
+            return { ...input, org: this.defaultOrg };
+        }
+        return input;
+    }
+}
+//# sourceMappingURL=context.js.map

package/synth/context.js.map

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