@crossdelta/platform-sdk 0.21.12 → 0.21.14

package/bin/templates/workspace/infra/index.ts.hbs

@@ -1,56 +1,82 @@
-import { join } from 'node:path'
 import {
-  buildExternalUrls,
-  buildIngressRules,
-  buildInternalUrls,
-  buildServicePortEnvs,
-  buildServices,
-  buildServiceUrlEnvs,
-  discoverServices,
+  createDOKSCluster,
+  createImagePullSecret,
+  createNamespace,
+  deployK8sServices,
+  deployRuntime,
+  discoverServiceConfigs,
+  materializeStreams,
 } from '@crossdelta/infrastructure'
-import { App } from '@pulumi/digitalocean'
+import * as contracts from '{{scope}}/contracts'
 import { Config, getStack } from '@pulumi/pulumi'
 
-const allServiceConfigs = discoverServices(join(__dirname, 'services'))
-const serviceConfigs = allServiceConfigs.filter((config) => !config.skip)
+const stack = getStack()
 const cfg = new Config()
-const logtailToken = cfg.requireSecret('logtailToken')
 const registryCredentials = cfg.requireSecret('registryCredentials')
 
-const stack = getStack()
+const namespace = `{{projectName}}-${stack}`
 
-const doAppName = `{{projectName}}-${stack}`
+const { provider, kubeconfig, endpoint } = createDOKSCluster({
+  name: '{{projectName}}-cluster',
+  clusterName: '{{projectName}}-cluster',
+  region: 'fra1',
+  ha: false,
+  version: '1.32.2-do.1',
+  nodePool: {
+    name: 'default',
+    size: 's-2vcpu-4gb',
+    nodeCount: 2,
+    labels: { environment: stack },
+  },
+  tags: ['{{projectName}}', `env:${stack}`],
+})
 
-const app = new App('{{projectName}}', {
-  spec: {
-    name: doAppName,
-    region: 'fra',
+createNamespace(provider, namespace, { environment: stack })
 
-    alerts: [{ rule: 'DEPLOYMENT_FAILED' }, { rule: 'DOMAIN_FAILED' }],
+const imagePullSecretName = 'ghcr-secret'
 
-    features: ['buildpack-stack=ubuntu-22'],
+createImagePullSecret(provider, namespace, imagePullSecretName, {
+  registry: 'ghcr.io',
+  username: 'github',
+  password: registryCredentials,
+})
 
-    envs: [
-      ...buildServiceUrlEnvs(serviceConfigs),
-      ...buildServicePortEnvs(serviceConfigs),
-    ],
+const runtime = deployRuntime(provider, namespace, {
+  nats: {
+    enabled: true,
+    config: {
+      replicas: 1,
+      jetstream: {
+        enabled: true,
+        storageSize: '1Gi',
+        storageClass: 'do-block-storage',
+      },
+    },
+  },
+})
 
-    services: buildServices({
-      serviceConfigs,
-      registryCredentials,
-      logtailToken,
-    }),
+if (runtime.natsUrl) {
+  const natsDepends = runtime.natsRelease ? [runtime.natsRelease] : []
 
-    ingress: {
-      rules: buildIngressRules(serviceConfigs),
-    },
+  materializeStreams(provider, namespace, {
+    natsUrl: runtime.natsUrl,
+    contracts,
+    dependsOn: natsDepends,
+  })
+}
+
+const serviceConfigs = discoverServiceConfigs('services').map((config) => ({
+  ...config,
+  env: {
+    ...config.env,
+    ...(runtime.natsUrl && { NATS_URL: runtime.natsUrl }),
   },
+}))
+
+deployK8sServices(provider, namespace, serviceConfigs, {
+  imagePullSecretName,
 })
 
-// Outputs
-export const appId = app.id
-export const appDefaultIngress = app.defaultIngress
-export const internalUrls = buildInternalUrls(serviceConfigs)
-export const serviceUrls = app.defaultIngress.apply((baseUrl) =>
-  buildExternalUrls(serviceConfigs, baseUrl ?? ''),
-)
+export const clusterEndpoint = endpoint
+export const clusterKubeconfig = kubeconfig
+export const natsInternalUrl = runtime.natsUrl

package/bin/templates/workspace/infra/package.json.hbs

@@ -7,8 +7,8 @@
     "pulumi": "pulumi"
   },
   "dependencies": {
-    "@crossdelta/cloudevents": "^0.7.20",
-    "@crossdelta/infrastructure": "^0.11.5",
+    "@crossdelta/cloudevents": "^0.8.1",
+    "@crossdelta/infrastructure": "^0.11.7",
     "{{scope}}/contracts": "workspace:*",
     "@pulumi/digitalocean": "^4.55.0",
     "@pulumi/kubernetes": "^4.21.0",

package/bin/templates/workspace/packages/contracts/package.json.hbs

@@ -19,8 +19,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@crossdelta/cloudevents": "^0.7.20",
-    "@crossdelta/infrastructure": "^0.11.5",
+    "@crossdelta/cloudevents": "^0.8.1",
+    "@crossdelta/infrastructure": "^0.11.7",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/dist/facade.d.mts

@@ -1,7 +1,7 @@
 import { FlowContext, FlowRunOptions, FlowResult } from '@crossdelta/flowcore';
 export { FlowContext, FlowResult, FlowRunOptions } from '@crossdelta/flowcore';
-import { P as PfWorkspaceContext, g as PfEffect, a as PfPluginContext, L as LoadedPlugin, b as PfPlugin } from './plugin-types-DQOv97Zh.mjs';
-export { E as ElicitInputEffect, h as ElicitInputField, i as EnvAddEffect, F as FileWriteEffect, I as InfraAddEffect, c as PfCommand, d as PfCommandArg, e as PfCommandOption, j as PfCommandResult, k as isElicitInputEffect } from './plugin-types-DQOv97Zh.mjs';
+import { PfWorkspaceContext, PfEffect, PfPluginContext, LoadedPlugin, PfPlugin } from '@crossdelta/shared/plugin-types';
+export { ElicitInputEffect, ElicitInputField, EnvAddEffect, FileWriteEffect, InfraAddEffect, LoadedPlugin, PfCommand, PfCommandArg, PfCommandOption, PfCommandResult, PfEffect, PfPlugin, PfPluginContext, PfWorkspaceContext, isElicitInputEffect } from '@crossdelta/shared/plugin-types';
 export { deriveEventNames } from '@crossdelta/cloudevents';
 import { z } from 'zod';
 
@@ -837,4 +837,4 @@ declare const getGeneratorDocsDir: () => string;
  */
 declare const listGeneratorDocs: () => Promise<string[]>;
 
-export { type Artifact, type CapabilitiesConfig, type Change, type CodingConstraints, type CommandLikeResult, type Diagnostic, type EffectHandlerOptions, type EffectResult, type EffectRuntimeContext, type ExecutableToolSpec, type ForbiddenPattern, type FrameworkLayout, LoadedPlugin, type NextAction, type OperationResult, type ParseResult, type PathGuards, PfEffect, PfPlugin, PfPluginContext, PfWorkspaceContext, type PlannedFile, type PolicyValidationResult, type PolicyViolation, type ProviderLookup, SERVICE_LAYOUT_POLICY_VERSION, type ServiceFramework, type ServiceGenerationInputs, type ServiceMeta, type ServiceMetadata, type ServiceSpec, type ToolInputSchema, type ToolPropertySchema, type ToolSpec, aggregateChanges, applyEffects, collectExecutableToolSpecs, collectToolSpecs, createContext, createContextFromWorkspace, err as createErrResult, ok as createOkResult, findWorkspaceRoot, formatChangeDetails, formatChangeSummary, getFrameworkPolicy, getGeneratorDocsDir, getRegisteredProviders, listGeneratorDocs, loadCapabilitiesConfig, loadCapabilitiesConfigFromWorkspace, loadPlugins, lookupProvider, lowerSpecToCapabilities, parseServicePrompt, planServiceGeneration, resolveProvider, runFlow, serviceLayoutPolicy, validateGeneratedFiles };
+export { type Artifact, type CapabilitiesConfig, type Change, type CodingConstraints, type CommandLikeResult, type Diagnostic, type EffectHandlerOptions, type EffectResult, type EffectRuntimeContext, type ExecutableToolSpec, type ForbiddenPattern, type FrameworkLayout, type NextAction, type OperationResult, type ParseResult, type PathGuards, type PlannedFile, type PolicyValidationResult, type PolicyViolation, type ProviderLookup, SERVICE_LAYOUT_POLICY_VERSION, type ServiceFramework, type ServiceGenerationInputs, type ServiceMeta, type ServiceMetadata, type ServiceSpec, type ToolInputSchema, type ToolPropertySchema, type ToolSpec, aggregateChanges, applyEffects, collectExecutableToolSpecs, collectToolSpecs, createContext, createContextFromWorkspace, err as createErrResult, ok as createOkResult, findWorkspaceRoot, formatChangeDetails, formatChangeSummary, getFrameworkPolicy, getGeneratorDocsDir, getRegisteredProviders, listGeneratorDocs, loadCapabilitiesConfig, loadCapabilitiesConfigFromWorkspace, loadPlugins, lookupProvider, lowerSpecToCapabilities, parseServicePrompt, planServiceGeneration, resolveProvider, runFlow, serviceLayoutPolicy, validateGeneratedFiles };

package/dist/facade.d.ts

@@ -1,7 +1,7 @@
 import { FlowContext, FlowRunOptions, FlowResult } from '@crossdelta/flowcore';
 export { FlowContext, FlowResult, FlowRunOptions } from '@crossdelta/flowcore';
-import { P as PfWorkspaceContext, g as PfEffect, a as PfPluginContext, L as LoadedPlugin, b as PfPlugin } from './plugin-types-DQOv97Zh.js';
-export { E as ElicitInputEffect, h as ElicitInputField, i as EnvAddEffect, F as FileWriteEffect, I as InfraAddEffect, c as PfCommand, d as PfCommandArg, e as PfCommandOption, j as PfCommandResult, k as isElicitInputEffect } from './plugin-types-DQOv97Zh.js';
+import { PfWorkspaceContext, PfEffect, PfPluginContext, LoadedPlugin, PfPlugin } from '@crossdelta/shared/plugin-types';
+export { ElicitInputEffect, ElicitInputField, EnvAddEffect, FileWriteEffect, InfraAddEffect, LoadedPlugin, PfCommand, PfCommandArg, PfCommandOption, PfCommandResult, PfEffect, PfPlugin, PfPluginContext, PfWorkspaceContext, isElicitInputEffect } from '@crossdelta/shared/plugin-types';
 export { deriveEventNames } from '@crossdelta/cloudevents';
 import { z } from 'zod';
 
@@ -837,4 +837,4 @@ declare const getGeneratorDocsDir: () => string;
  */
 declare const listGeneratorDocs: () => Promise<string[]>;
 
-export { type Artifact, type CapabilitiesConfig, type Change, type CodingConstraints, type CommandLikeResult, type Diagnostic, type EffectHandlerOptions, type EffectResult, type EffectRuntimeContext, type ExecutableToolSpec, type ForbiddenPattern, type FrameworkLayout, LoadedPlugin, type NextAction, type OperationResult, type ParseResult, type PathGuards, PfEffect, PfPlugin, PfPluginContext, PfWorkspaceContext, type PlannedFile, type PolicyValidationResult, type PolicyViolation, type ProviderLookup, SERVICE_LAYOUT_POLICY_VERSION, type ServiceFramework, type ServiceGenerationInputs, type ServiceMeta, type ServiceMetadata, type ServiceSpec, type ToolInputSchema, type ToolPropertySchema, type ToolSpec, aggregateChanges, applyEffects, collectExecutableToolSpecs, collectToolSpecs, createContext, createContextFromWorkspace, err as createErrResult, ok as createOkResult, findWorkspaceRoot, formatChangeDetails, formatChangeSummary, getFrameworkPolicy, getGeneratorDocsDir, getRegisteredProviders, listGeneratorDocs, loadCapabilitiesConfig, loadCapabilitiesConfigFromWorkspace, loadPlugins, lookupProvider, lowerSpecToCapabilities, parseServicePrompt, planServiceGeneration, resolveProvider, runFlow, serviceLayoutPolicy, validateGeneratedFiles };
+export { type Artifact, type CapabilitiesConfig, type Change, type CodingConstraints, type CommandLikeResult, type Diagnostic, type EffectHandlerOptions, type EffectResult, type EffectRuntimeContext, type ExecutableToolSpec, type ForbiddenPattern, type FrameworkLayout, type NextAction, type OperationResult, type ParseResult, type PathGuards, type PlannedFile, type PolicyValidationResult, type PolicyViolation, type ProviderLookup, SERVICE_LAYOUT_POLICY_VERSION, type ServiceFramework, type ServiceGenerationInputs, type ServiceMeta, type ServiceMetadata, type ServiceSpec, type ToolInputSchema, type ToolPropertySchema, type ToolSpec, aggregateChanges, applyEffects, collectExecutableToolSpecs, collectToolSpecs, createContext, createContextFromWorkspace, err as createErrResult, ok as createOkResult, findWorkspaceRoot, formatChangeDetails, formatChangeSummary, getFrameworkPolicy, getGeneratorDocsDir, getRegisteredProviders, listGeneratorDocs, loadCapabilitiesConfig, loadCapabilitiesConfigFromWorkspace, loadPlugins, lookupProvider, lowerSpecToCapabilities, parseServicePrompt, planServiceGeneration, resolveProvider, runFlow, serviceLayoutPolicy, validateGeneratedFiles };

package/dist/facade.js

@@ -383,7 +383,7 @@ __export(facade_exports, {
   getFrameworkPolicy: () => getFrameworkPolicy,
   getGeneratorDocsDir: () => getGeneratorDocsDir,
   getRegisteredProviders: () => getRegisteredProviders,
-  isElicitInputEffect: () => isElicitInputEffect,
+  isElicitInputEffect: () => import_plugin_types.isElicitInputEffect,
   listGeneratorDocs: () => listGeneratorDocs,
   loadCapabilitiesConfig: () => loadCapabilitiesConfig,
   loadCapabilitiesConfigFromWorkspace: () => loadCapabilitiesConfigFromWorkspace,
@@ -2166,7 +2166,7 @@ var planServiceGeneration = (inputs) => {
 init_config();
 
 // cli/src/core/plugins/types.ts
-var isElicitInputEffect = (effect) => effect.kind === "elicit:input";
+var import_plugin_types = require("@crossdelta/shared/plugin-types");
 
 // cli/src/core/facade/context.ts
 init_config();

package/dist/facade.mjs

@@ -2095,7 +2095,9 @@ var planServiceGeneration = (inputs) => {
 init_config();
 
 // cli/src/core/plugins/types.ts
-var isElicitInputEffect = (effect) => effect.kind === "elicit:input";
+import {
+  isElicitInputEffect
+} from "@crossdelta/shared/plugin-types";
 
 // cli/src/core/facade/context.ts
 init_config();

package/dist/plugin-types.d.mts

@@ -1 +1 @@
-export { L as LoadedPlugin, c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow, b as PfPlugin, a as PfPluginContext } from './plugin-types-DQOv97Zh.mjs';
+export { LoadedPlugin, PfCommand, PfCommandArg, PfCommandOption, PfFlow, PfPlugin, PfPluginContext } from '@crossdelta/shared/plugin-types';

package/dist/plugin-types.d.ts

@@ -1 +1 @@
-export { L as LoadedPlugin, c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow, b as PfPlugin, a as PfPluginContext } from './plugin-types-DQOv97Zh.js';
+export { LoadedPlugin, PfCommand, PfCommandArg, PfCommandOption, PfFlow, PfPlugin, PfPluginContext } from '@crossdelta/shared/plugin-types';

package/dist/plugin.d.mts

@@ -1,5 +1,5 @@
-import { P as PfWorkspaceContext, a as PfPluginContext, L as LoadedPlugin, b as PfPlugin } from './plugin-types-DQOv97Zh.mjs';
-export { c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow } from './plugin-types-DQOv97Zh.mjs';
+import { PfWorkspaceContext, PfPluginContext, LoadedPlugin, PfPlugin } from '@crossdelta/shared/plugin-types';
+export { LoadedPlugin, PfCommand, PfCommandArg, PfCommandOption, PfFlow, PfPlugin, PfPluginContext, PfWorkspaceContext } from '@crossdelta/shared/plugin-types';
 
 /**
  * Plugin Loader
@@ -28,4 +28,4 @@ declare const createPluginContext: (workspace: PfWorkspaceContext, logger?: PfPl
  */
 declare const loadPluginFromModule: (moduleName: string, context: PfPluginContext) => Promise<LoadedPlugin>;
 
-export { LoadedPlugin, PfPlugin, PfPluginContext, PfWorkspaceContext, createPluginContext, loadPluginFromModule, validatePlugin, validatePluginStrict };
+export { createPluginContext, loadPluginFromModule, validatePlugin, validatePluginStrict };

package/dist/plugin.d.ts

@@ -1,5 +1,5 @@
-import { P as PfWorkspaceContext, a as PfPluginContext, L as LoadedPlugin, b as PfPlugin } from './plugin-types-DQOv97Zh.js';
-export { c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow } from './plugin-types-DQOv97Zh.js';
+import { PfWorkspaceContext, PfPluginContext, LoadedPlugin, PfPlugin } from '@crossdelta/shared/plugin-types';
+export { LoadedPlugin, PfCommand, PfCommandArg, PfCommandOption, PfFlow, PfPlugin, PfPluginContext, PfWorkspaceContext } from '@crossdelta/shared/plugin-types';
 
 /**
  * Plugin Loader
@@ -28,4 +28,4 @@ declare const createPluginContext: (workspace: PfWorkspaceContext, logger?: PfPl
  */
 declare const loadPluginFromModule: (moduleName: string, context: PfPluginContext) => Promise<LoadedPlugin>;
 
-export { LoadedPlugin, PfPlugin, PfPluginContext, PfWorkspaceContext, createPluginContext, loadPluginFromModule, validatePlugin, validatePluginStrict };
+export { createPluginContext, loadPluginFromModule, validatePlugin, validatePluginStrict };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.21.12",
+  "version": "0.21.14",
   "description": "Platform toolkit for event-driven microservices — keeping code and infrastructure in lockstep.",
   "keywords": [
     "cli",
@@ -118,8 +118,9 @@
     "@ai-sdk/anthropic": "^2.0.53",
     "@ai-sdk/openai": "^2.0.79",
     "@angular-devkit/core": "^21.0.0",
-    "@crossdelta/cloudevents": "^0.7.20",
+    "@crossdelta/cloudevents": "^0.8.1",
     "@crossdelta/flowcore": "^0.1.2",
+    "@crossdelta/shared": "^0.1.0",
     "@faker-js/faker": "^9.8.0",
     "@inquirer/prompts": "^7.5.0",
     "@listr2/prompt-adapter-enquirer": "^2.0.15",
@@ -144,7 +145,7 @@
     "zod": "^4.0.0"
   },
   "peerDependencies": {
-    "@crossdelta/infrastructure": "^0.11.5",
+    "@crossdelta/infrastructure": "^0.11.7",
     "@nestjs/schematics": "^11.0.5",
     "turbo": "^2.0.0"
   },

package/dist/plugin-types-DQOv97Zh.d.mts

@@ -1,180 +0,0 @@
-/**
- * Plugin System Types
- *
- * pf owns and defines these interfaces.
- * Plugins MUST adapt to these interfaces.
- * pf is strict and predictable - no duck-typing, no fallbacks.
- */
-/**
- * Base effect type - all domain effects must have a kind
- * pf handles effects generically via kind-based handler registry
- */
-interface PfEffect {
-    readonly kind: string;
-}
-/**
- * File write effect - write content to a file
- */
-interface FileWriteEffect extends PfEffect {
-    readonly kind: 'file:write';
-    readonly path: string;
-    readonly content: string;
-}
-/**
- * Infrastructure service configuration effect
- */
-interface InfraAddEffect extends PfEffect {
-    readonly kind: 'infra:add';
-    readonly serviceName: string;
-    readonly port: number;
-    readonly framework: string;
-    readonly runtime: string;
-}
-/**
- * Environment variable effect
- */
-interface EnvAddEffect extends PfEffect {
-    readonly kind: 'env:add';
-    readonly key: string;
-    readonly value: string;
-}
-/**
- * Field definition for input elicitation
- *
- * Describes a single field that needs user input.
- * Host-agnostic - CLI and MCP interpret this differently.
- */
-interface ElicitInputField {
-    /** Field name (used as key in response) */
-    readonly name: string;
-    /** Human-readable prompt/question */
-    readonly prompt: string;
-    /** Whether the field is required */
-    readonly required?: boolean;
-    /** Detailed description (shown as help text) */
-    readonly description?: string;
-    /** Default value if user provides nothing */
-    readonly defaultValue?: unknown;
-    /** Allowed values (enum constraint) */
-    readonly enum?: readonly string[];
-    /** Field type hint */
-    readonly type?: 'string' | 'number' | 'boolean';
-}
-/**
- * Input elicitation effect
- *
- * Returned by tools when required inputs are missing.
- * Pure data - no MCP SDK imports, no host-specific logic.
- *
- * Hosts interpret this effect differently:
- * - CLI: Interactive prompt
- * - MCP: server.elicitInput() or structured error
- */
-interface ElicitInputEffect extends PfEffect {
-    readonly kind: 'elicit:input';
-    /** Message explaining what's needed */
-    readonly message: string;
-    /** Fields to collect from user */
-    readonly fields: readonly ElicitInputField[];
-}
-/**
- * Type guard for ElicitInputEffect
- */
-declare const isElicitInputEffect: (effect: PfEffect) => effect is ElicitInputEffect;
-/**
- * Result of running a command
- */
-interface PfCommandResult {
-    /** Domain effects to be applied by the runtime */
-    effects: PfEffect[];
-    /** Optional output to display (for read-only commands) */
-    output?: string | string[];
-}
-/**
- * Command argument definition
- */
-interface PfCommandArg {
-    name: string;
-    description: string;
-    required: boolean;
-}
-/**
- * Command option definition
- */
-interface PfCommandOption {
-    flags: string;
-    description: string;
-    default?: unknown;
-}
-/**
- * A CLI command provided by a plugin
- *
- * Plugins MUST implement this exact interface.
- */
-interface PfCommand {
-    name: string;
-    description: string;
-    args: PfCommandArg[];
-    options: PfCommandOption[];
-    run(args: Record<string, unknown>, options: Record<string, unknown>): Promise<PfCommandResult>;
-}
-/**
- * An interactive flow provided by a plugin
- */
-interface PfFlow {
-    name: string;
-    description: string;
-    getSteps(initialContext?: Record<string, unknown>): Promise<unknown[]>;
-}
-/**
- * Workspace context with all discovered information
- * pf owns this - plugins receive it during setup
- */
-interface PfWorkspaceContext {
-    /** Absolute path to workspace root */
-    workspaceRoot: string;
-    /** Discovered services (relative paths like 'services/api-gateway') */
-    availableServices: string[];
-    /** Contracts package configuration */
-    contracts: {
-        /** Relative path to contracts source (e.g., 'packages/contracts/src') */
-        path: string;
-        /** Package name (e.g., '@my-platform/contracts') */
-        packageName?: string;
-    };
-}
-/**
- * Plugin context provided by pf during setup
- */
-interface PfPluginContext {
-    workspace: PfWorkspaceContext;
-    logger: {
-        debug: (message: string) => void;
-        info: (message: string) => void;
-        warn: (message: string) => void;
-        error: (message: string) => void;
-    };
-}
-/**
- * A plugin that can be loaded by pf
- *
- * Plugins MUST implement this exact interface.
- * If a plugin has a different internal API, it must provide an adapter.
- */
-interface PfPlugin {
-    name: string;
-    version: string;
-    description?: string;
-    commands: PfCommand[];
-    flows: PfFlow[];
-    setup: (context: PfPluginContext) => Promise<void> | void;
-}
-/**
- * Result of loading a plugin
- */
-interface LoadedPlugin {
-    plugin: PfPlugin;
-    source: string;
-}
-
-export { type ElicitInputEffect as E, type FileWriteEffect as F, type InfraAddEffect as I, type LoadedPlugin as L, type PfWorkspaceContext as P, type PfPluginContext as a, type PfPlugin as b, type PfCommand as c, type PfCommandArg as d, type PfCommandOption as e, type PfFlow as f, type PfEffect as g, type ElicitInputField as h, type EnvAddEffect as i, type PfCommandResult as j, isElicitInputEffect as k };

package/dist/plugin-types-DQOv97Zh.d.ts

@@ -1,180 +0,0 @@
-/**
- * Plugin System Types
- *
- * pf owns and defines these interfaces.
- * Plugins MUST adapt to these interfaces.
- * pf is strict and predictable - no duck-typing, no fallbacks.
- */
-/**
- * Base effect type - all domain effects must have a kind
- * pf handles effects generically via kind-based handler registry
- */
-interface PfEffect {
-    readonly kind: string;
-}
-/**
- * File write effect - write content to a file
- */
-interface FileWriteEffect extends PfEffect {
-    readonly kind: 'file:write';
-    readonly path: string;
-    readonly content: string;
-}
-/**
- * Infrastructure service configuration effect
- */
-interface InfraAddEffect extends PfEffect {
-    readonly kind: 'infra:add';
-    readonly serviceName: string;
-    readonly port: number;
-    readonly framework: string;
-    readonly runtime: string;
-}
-/**
- * Environment variable effect
- */
-interface EnvAddEffect extends PfEffect {
-    readonly kind: 'env:add';
-    readonly key: string;
-    readonly value: string;
-}
-/**
- * Field definition for input elicitation
- *
- * Describes a single field that needs user input.
- * Host-agnostic - CLI and MCP interpret this differently.
- */
-interface ElicitInputField {
-    /** Field name (used as key in response) */
-    readonly name: string;
-    /** Human-readable prompt/question */
-    readonly prompt: string;
-    /** Whether the field is required */
-    readonly required?: boolean;
-    /** Detailed description (shown as help text) */
-    readonly description?: string;
-    /** Default value if user provides nothing */
-    readonly defaultValue?: unknown;
-    /** Allowed values (enum constraint) */
-    readonly enum?: readonly string[];
-    /** Field type hint */
-    readonly type?: 'string' | 'number' | 'boolean';
-}
-/**
- * Input elicitation effect
- *
- * Returned by tools when required inputs are missing.
- * Pure data - no MCP SDK imports, no host-specific logic.
- *
- * Hosts interpret this effect differently:
- * - CLI: Interactive prompt
- * - MCP: server.elicitInput() or structured error
- */
-interface ElicitInputEffect extends PfEffect {
-    readonly kind: 'elicit:input';
-    /** Message explaining what's needed */
-    readonly message: string;
-    /** Fields to collect from user */
-    readonly fields: readonly ElicitInputField[];
-}
-/**
- * Type guard for ElicitInputEffect
- */
-declare const isElicitInputEffect: (effect: PfEffect) => effect is ElicitInputEffect;
-/**
- * Result of running a command
- */
-interface PfCommandResult {
-    /** Domain effects to be applied by the runtime */
-    effects: PfEffect[];
-    /** Optional output to display (for read-only commands) */
-    output?: string | string[];
-}
-/**
- * Command argument definition
- */
-interface PfCommandArg {
-    name: string;
-    description: string;
-    required: boolean;
-}
-/**
- * Command option definition
- */
-interface PfCommandOption {
-    flags: string;
-    description: string;
-    default?: unknown;
-}
-/**
- * A CLI command provided by a plugin
- *
- * Plugins MUST implement this exact interface.
- */
-interface PfCommand {
-    name: string;
-    description: string;
-    args: PfCommandArg[];
-    options: PfCommandOption[];
-    run(args: Record<string, unknown>, options: Record<string, unknown>): Promise<PfCommandResult>;
-}
-/**
- * An interactive flow provided by a plugin
- */
-interface PfFlow {
-    name: string;
-    description: string;
-    getSteps(initialContext?: Record<string, unknown>): Promise<unknown[]>;
-}
-/**
- * Workspace context with all discovered information
- * pf owns this - plugins receive it during setup
- */
-interface PfWorkspaceContext {
-    /** Absolute path to workspace root */
-    workspaceRoot: string;
-    /** Discovered services (relative paths like 'services/api-gateway') */
-    availableServices: string[];
-    /** Contracts package configuration */
-    contracts: {
-        /** Relative path to contracts source (e.g., 'packages/contracts/src') */
-        path: string;
-        /** Package name (e.g., '@my-platform/contracts') */
-        packageName?: string;
-    };
-}
-/**
- * Plugin context provided by pf during setup
- */
-interface PfPluginContext {
-    workspace: PfWorkspaceContext;
-    logger: {
-        debug: (message: string) => void;
-        info: (message: string) => void;
-        warn: (message: string) => void;
-        error: (message: string) => void;
-    };
-}
-/**
- * A plugin that can be loaded by pf
- *
- * Plugins MUST implement this exact interface.
- * If a plugin has a different internal API, it must provide an adapter.
- */
-interface PfPlugin {
-    name: string;
-    version: string;
-    description?: string;
-    commands: PfCommand[];
-    flows: PfFlow[];
-    setup: (context: PfPluginContext) => Promise<void> | void;
-}
-/**
- * Result of loading a plugin
- */
-interface LoadedPlugin {
-    plugin: PfPlugin;
-    source: string;
-}
-
-export { type ElicitInputEffect as E, type FileWriteEffect as F, type InfraAddEffect as I, type LoadedPlugin as L, type PfWorkspaceContext as P, type PfPluginContext as a, type PfPlugin as b, type PfCommand as c, type PfCommandArg as d, type PfCommandOption as e, type PfFlow as f, type PfEffect as g, type ElicitInputField as h, type EnvAddEffect as i, type PfCommandResult as j, isElicitInputEffect as k };