@sverka/compiler 0.0.0 → 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,235 @@
+import { DefinitionGraph } from "@sverka/workflow";
+//#region src/plugin/types.d.ts
+type CapabilitySupport = "native" | "lowered" | "emulated" | "connector" | "partial" | "unsupported";
+interface CapabilityDetail {
+  readonly support: CapabilitySupport;
+  readonly via?: string;
+  readonly notes?: string;
+}
+type CapabilityManifest = Record<string, CapabilitySupport | CapabilityDetail>;
+interface CapabilityDiagnostic {
+  readonly capability: string;
+  readonly support: CapabilitySupport;
+  readonly severity: "error" | "warning" | "info";
+  readonly message: string;
+  readonly stepId?: string;
+}
+interface ModelContribution {
+  readonly kind: string;
+  readonly description?: string;
+}
+interface GraphTransform {
+  readonly name: string;
+  transform(graph: DefinitionGraph): DefinitionGraph;
+}
+interface GraphValidator {
+  readonly name: string;
+  validate(graph: DefinitionGraph): readonly CapabilityDiagnostic[];
+}
+interface Target {
+  readonly name: string;
+  compile(graph: DefinitionGraph): CompilationResult$2;
+}
+interface CompilationResult$2 {
+  readonly artifacts: readonly {
+    readonly path: string;
+    readonly content: string;
+  }[];
+  readonly diagnostics: readonly CapabilityDiagnostic[];
+}
+interface Importer {
+  readonly name: string;
+  parse(input: string): DefinitionGraph;
+}
+interface Engine {
+  readonly name: string;
+  execute(plan: unknown): unknown;
+}
+interface ConnectorFactory {
+  readonly name: string;
+  create(config: unknown): unknown;
+}
+interface NativeExtension {
+  readonly plugin: string;
+  readonly schemaVersion: string;
+  readonly capabilities: readonly string[];
+  readonly fallback?: string;
+}
+interface ToolDefinition {
+  /** Globally unique within plugin: "<server>.<tool>". */
+  readonly name: string;
+  readonly description?: string;
+  /** JSON Schema describing accepted arguments. */
+  readonly inputSchema?: Readonly<Record<string, unknown>>;
+}
+type ToolResultContent = {
+  readonly type: "text";
+  readonly text: string;
+} | {
+  readonly type: "image";
+  readonly data: string;
+  readonly mimeType: string;
+} | {
+  readonly type: "resource";
+  readonly resource: {
+    readonly uri: string;
+    readonly mimeType?: string;
+  };
+};
+interface ToolResult {
+  readonly content: readonly ToolResultContent[];
+  readonly isError?: boolean;
+}
+/**
+ * Runtime facet for listing and calling tools. Added by Spec 23 to enable
+ * MCP plugin transport; consumed by AgentStep (sv-wthn.2.2). Tools are
+ * called at runtime, not synthesized into the Definition Graph.
+ */
+interface ToolProvider {
+  listTools(): Promise<readonly ToolDefinition[]>;
+  callTool(name: string, args?: Readonly<Record<string, unknown>>): Promise<ToolResult>;
+  dispose?(): Promise<void>;
+}
+interface SverkaPlugin {
+  readonly name: string;
+  readonly apiVersion: string;
+  readonly capabilities?: CapabilityManifest;
+  readonly model?: readonly ModelContribution[];
+  readonly transforms?: readonly GraphTransform[];
+  readonly validators?: readonly GraphValidator[];
+  readonly targets?: readonly Target[];
+  readonly importers?: readonly Importer[];
+  readonly engines?: readonly Engine[];
+  readonly connectors?: readonly ConnectorFactory[];
+  readonly extensions?: readonly NativeExtension[];
+  /** Tools facet (Spec 23): runtime tool listing/calling (e.g. MCP). */
+  readonly tools?: ToolProvider;
+}
+interface PluginOptions {
+  readonly [key: string]: unknown;
+}
+interface PluginMeta {
+  readonly version: string;
+}
+interface PluginRegistry {
+  register(plugin: SverkaPlugin): void;
+  readonly plugins: readonly SverkaPlugin[];
+  getCapabilities(): CapabilityManifest[];
+}
+//#endregion
+//#region src/plugin/factory.d.ts
+/**
+ * Define a Sverka plugin. The factory function receives optional options
+ * and meta, and returns a SverkaPlugin object.
+ *
+ * @example
+ * const plugin = defineSverkaPlugin(() => ({
+ *   name: "github",
+ *   apiVersion: "sverka.dev/v1",
+ *   capabilities: { "trigger.push": "native" },
+ * }));
+ */
+export declare function defineSverkaPlugin(factory: (options?: PluginOptions, meta?: PluginMeta) => SverkaPlugin, options?: PluginOptions): SverkaPlugin;
+/**
+ * Create a plugin registry.
+ */
+export declare function createPluginRegistry(): PluginRegistry;
+//#endregion
+//#region src/plugin/capabilities.d.ts
+/**
+ * Detect capabilities used by a Definition Graph.
+ * Returns a set of capability identifiers (e.g., "trigger.push").
+ */
+export declare function detectCapabilities(graph: DefinitionGraph): Set<string>;
+/**
+ * Analyze a Definition Graph against capability manifests.
+ * Returns diagnostics for capabilities that are not natively or lowered
+ * supported.
+ */
+export declare function analyzeCapabilities(graph: DefinitionGraph, manifests: readonly CapabilityManifest[]): readonly CapabilityDiagnostic[];
+//#endregion
+//#region src/plugin/errors.d.ts
+type PluginErrorCode = "INVALID_PLUGIN" | "DUPLICATE_PLUGIN" | "INVALID_CAPABILITY";
+export declare class PluginError extends Error {
+  readonly code: PluginErrorCode;
+  readonly cause: unknown;
+  constructor(message: string, code: PluginErrorCode, cause?: unknown);
+}
+//#endregion
+//#region src/github/pinning.d.ts
+/** Registry mapping `org/name@vN` refs to 40-char commit SHAs. */
+interface PinRegistry {
+  readonly [ref: string]: string;
+}
+/** Pinning configuration for {@link GithubTarget}. */
+interface PinningConfig {
+  /** `"strict"` pins known refs and errors on missing entries; `"off"` leaves refs unchanged. */
+  readonly mode: "strict" | "off";
+  /** Custom registry; defaults to the bundled `pinned-actions.json`. */
+  readonly registry?: PinRegistry;
+}
+/**
+ * Pin a single `uses:` ref to its commit SHA.
+ *
+ * Rules (spec 22 §"Data models"):
+ * 1. Local action (`./…`) → unchanged.
+ * 2. Already pinned (`@<40 hex>`) → unchanged.
+ * 3. `org/name@vN` in registry → `org/name@<sha> # vN`.
+ * 4. `org/name@vN` not in registry → unchanged (caller emits a diagnostic).
+ *
+ * Refs without `@` (malformed) are returned unchanged.
+ */
+export declare function pinActionRef(ref: string, registry: PinRegistry): string;
+/**
+ * Load the bundled `pinned-actions.json` registry.
+ */
+export declare function loadBundledRegistry(): PinRegistry;
+//#endregion
+//#region src/github/types.d.ts
+interface GeneratedArtifact {
+  readonly path: string;
+  readonly content: string;
+}
+interface TargetDiagnostic {
+  readonly capability: string;
+  readonly support: CapabilitySupport;
+  readonly severity: "error" | "warning" | "info";
+  readonly message: string;
+  readonly stepId?: string;
+}
+interface CompilationResult {
+  readonly artifacts: readonly GeneratedArtifact[];
+  readonly diagnostics: readonly TargetDiagnostic[];
+}
+//#endregion
+//#region src/github/target.d.ts
+/**
+ * Convenience function: analyze → lower → emit in one call.
+ */
+export declare function compileGithub(graph: DefinitionGraph): CompilationResult;
+//#endregion
+//#region src/gitlab/types.d.ts
+interface GeneratedArtifact$1 {
+  readonly path: string;
+  readonly content: string;
+}
+interface TargetDiagnostic$1 {
+  readonly capability: string;
+  readonly support: CapabilitySupport;
+  readonly severity: "error" | "warning" | "info";
+  readonly message: string;
+  readonly stepId?: string;
+}
+interface CompilationResult$1 {
+  readonly artifacts: readonly GeneratedArtifact$1[];
+  readonly diagnostics: readonly TargetDiagnostic$1[];
+}
+//#endregion
+//#region src/gitlab/target.d.ts
+/**
+ * Convenience function: analyze → lower → emit in one call.
+ */
+export declare function compileGitlab(graph: DefinitionGraph): CompilationResult$1;
+//#endregion
+export type { CapabilityDetail, CapabilityDiagnostic, CapabilityManifest, CapabilitySupport, CompilationResult, ConnectorFactory, Engine, GeneratedArtifact, GraphTransform, GraphValidator, Importer, ModelContribution, NativeExtension, PinRegistry, PinningConfig, PluginErrorCode, PluginMeta, PluginOptions, PluginRegistry, SverkaPlugin, Target, TargetDiagnostic, ToolDefinition, ToolProvider, ToolResult, ToolResultContent };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/plugin/types.ts","../src/plugin/factory.ts","../src/plugin/capabilities.ts","../src/plugin/errors.ts","../src/github/pinning.ts","../src/github/types.ts","../src/github/target.ts","../src/gitlab/types.ts","../src/gitlab/target.ts"],"mappings":";;KAQY;UAQK;WACN,SAAS;WACT;WACA;;KAGC,qBAAqB,eAAe,oBAAoB;UAEnD;WACN;WACA,SAAS;WACT;WACA;WACA;;UAOM;WACN;WACA;;UAGM;WACN;EACT,UAAU,OAAO,kBAAkB;;UAGpB;WACN;EACT,SAAS,OAAO,2BAA2B;;UAG5B;WACN;EACT,QAAQ,OAAO,kBAAkB;;UAGlB;WACN;aAA+B;aAAuB;;WACtD,sBAAsB;;UAGhB;WACN;EACT,MAAM,gBAAgB;;UAGP;WACN;EACT,QAAQ;;UAGO;WACN;EACT,OAAO;;UAGQ;WACN;WACA;WACA;WACA;;UAOM;;WAEN;WACA;;WAEA,cAAc,SAAS;;KAGtB;WACG;WAAuB;;WACvB;WAAwB;WAAuB;;WAE/C;WACA;aAAqB;aAAsB;;;UAGzC;WACN,kBAAkB;WAClB;;;;;;;UAQM;EACf,aAAa,iBAAiB;EAC9B,SACE,cACA,OAAO,SAAS,2BACf,QAAQ;EACX,YAAY;;UAOG;WACN;WACA;WACA,eAAe;WACf,iBAAiB;WACjB,sBAAsB;WACtB,sBAAsB;WACtB,mBAAmB;WACnB,qBAAqB;WACrB,mBAAmB;WACnB,sBAAsB;WACtB,sBAAsB;;WAEtB,QAAQ;;UAGF;YACL;;UAGK;WACN;;UAOM;EACf,SAAS,QAAQ;WACR,kBAAkB;EAC3B,mBAAmB;;;;;;;;;;;;;;;wBC5IL,mBACd,UAAU,UAAU,eAAe,OAAO,eAAe,cACzD,UAAU,gBACT;;;;wBA+Da,wBAAwB;;;;;;;wBCqUxB,mBAAmB,OAAO,kBAAkB;;;;;;wBA6D5C,oBACd,OAAO,iBACP,oBAAoB,gCACV;;;KCtdA;qBAKC,oBAAoB;WACtB,MAAM;WACG;EAEN,YAAA,iBAAiB,MAAM,iBAAiB;;;;;UCDrC;YACL;;;UAIK;;WAEN;;WAEA,WAAW;;;;;;;;;;;;;wBAgBN,aAAa,aAAa,UAAU;;;;wBAwBpC,uBAAuB;;;UCoDtB;WACN;WACA;;UAGM;WACN;WACA,SAAS;WACT;WACA;WACA;;UAGM;WACN,oBAAoB;WACpB,sBAAsB;;;;;;;wBC8BjB,cAAc,OAAO,kBAAkB;;;UCLtC;WACN;WACA;;UAGM;WACN;WACA,SAAS;WACT;WACA;WACA;;UAGM;WACN,oBAAoB;WACpB,sBAAsB;;;;;;;wBCvGjB,cAAc,OAAO,kBAAkB"}