@codemation/core-nodes-ocr 0.2.0

package/dist/codemation.plugin.d.cts

@@ -0,0 +1,325 @@
+import { l as WorkflowDefinition, n as TypeToken, t as Container, u as AnyCredentialType } from "./runtimeTypes-ffl603pJ.cjs";
+import { BetterAuthOptions } from "better-auth";
+
+//#region ../core/src/contracts/mcpTypes.d.ts
+type McpServerTransport = "http";
+interface McpServerDeclaration {
+  /** Globally unique slug, e.g. "gmail". Workflow authors reference this. */
+  id: string;
+  displayName: string;
+  description: string;
+  transport: McpServerTransport;
+  url: string;
+  /**
+   * Credential types accepted by this MCP server, matching CredentialRequirement.acceptedTypes.
+   * Absent or empty means no credential is required.
+   */
+  acceptedCredentialTypes?: ReadonlyArray<string>;
+  /**
+   * Documentation only in MVP. The bind-time validator checks
+   * requiredScopes ⊆ CredentialInstance.scopesGranted.
+   */
+  requiredScopes?: string[];
+  /** Non-secret static headers merged onto every MCP request. */
+  staticHeaders?: Record<string, string>;
+  /**
+   * Overrides for tool descriptions advertised by the MCP server.
+   * Applied by the connection pool after tools/list.
+   * Key: exact tool name as returned by the server.
+   */
+  toolDescriptionOverrides?: Record<string, string>;
+}
+//#endregion
+//#region ../core/src/policies/executionLimits/EngineExecutionLimitsPolicy.d.ts
+interface EngineExecutionLimitsPolicyConfig {
+  readonly defaultMaxNodeActivations: number;
+  readonly hardMaxNodeActivations: number;
+  readonly defaultMaxSubworkflowDepth: number;
+  readonly hardMaxSubworkflowDepth: number;
+}
+//#endregion
+//#region ../core/src/authoring/defineCollection.types.d.ts
+type CollectionFieldType = "text" | "int" | "bigint" | "double" | "bool" | "timestamptz" | "jsonb" | "uuid";
+interface CollectionFieldDefinition {
+  readonly type: CollectionFieldType;
+  readonly nullable: boolean;
+  readonly default?: unknown;
+}
+interface CollectionIndexDefinition {
+  readonly on: ReadonlyArray<string>;
+  readonly unique?: boolean;
+}
+interface CollectionDefinition {
+  readonly name: string;
+  readonly fields: Readonly<Record<string, CollectionFieldDefinition>>;
+  readonly indexes: ReadonlyArray<CollectionIndexDefinition>;
+}
+interface DefinedCollection<TDefinition extends CollectionDefinition = CollectionDefinition> {
+  readonly kind: "defined-collection";
+  readonly definition: TDefinition;
+  register(context: {
+    registerCollection(d: CollectionDefinition): void;
+  }): void;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationClassToken.d.ts
+type CodemationClassToken<TValue> = TypeToken<TValue> & (new (...args: never[]) => TValue);
+//#endregion
+//#region ../host/src/bootstrap/CodemationContainerRegistration.d.ts
+interface CodemationContainerRegistrationBase<TValue> {
+  readonly token: TypeToken<TValue>;
+}
+interface CodemationValueRegistration<TValue> extends CodemationContainerRegistrationBase<TValue> {
+  readonly useValue: TValue;
+}
+interface CodemationClassRegistration<TValue> extends CodemationContainerRegistrationBase<TValue> {
+  readonly useClass: CodemationClassToken<TValue>;
+}
+interface CodemationFactoryRegistration<TValue> extends CodemationContainerRegistrationBase<TValue> {
+  readonly useFactory: (container: Container) => TValue;
+}
+type CodemationContainerRegistration<TValue = unknown> = CodemationValueRegistration<TValue> | CodemationClassRegistration<TValue> | CodemationFactoryRegistration<TValue>;
+//#endregion
+//#region ../host/src/application/logging/Logger.d.ts
+interface Logger {
+  info(message: string, exception?: Error): void;
+  warn(message: string, exception?: Error): void;
+  error(message: string, exception?: Error): void;
+  debug(message: string, exception?: Error): void;
+}
+interface LoggerFactory {
+  create(scope: string): Logger;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationAuthConfig.d.ts
+/**
+ * Consumer-declared authentication profile for the hosted UI + HTTP API.
+ * Social provider ids intentionally match Better Auth's provider ids so config stays 1:1 with the auth runtime.
+ */
+type CodemationAuthKind = "local" | "oauth" | "oidc" | "managed";
+type CodemationAuthOAuthProviderId = Extract<keyof NonNullable<BetterAuthOptions["socialProviders"]>, "github" | "google" | "microsoft">;
+interface CodemationAuthOAuthProviderConfig {
+  readonly provider: CodemationAuthOAuthProviderId;
+  readonly clientIdEnv: string;
+  readonly clientSecretEnv: string;
+  /** Microsoft tenant; environment variable name whose value is the tenant ID. */
+  readonly tenantIdEnv?: string;
+}
+interface CodemationAuthOidcProviderConfig {
+  readonly id: string;
+  readonly issuer: string;
+  readonly clientIdEnv: string;
+  readonly clientSecretEnv: string;
+}
+interface CodemationAuthConfig {
+  readonly kind: CodemationAuthKind;
+  /**
+   * When true and NODE_ENV is not production, the API accepts requests without a real session
+   * (synthetic principal only — never honored in production).
+   */
+  readonly allowUnauthenticatedInDevelopment?: boolean;
+  readonly oauth?: ReadonlyArray<CodemationAuthOAuthProviderConfig>;
+  readonly oidc?: ReadonlyArray<CodemationAuthOidcProviderConfig>;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationLogConfig.d.ts
+/**
+ * Minimum level for namespaces matched by {@link CodemationLogRule.filter}.
+ * `silent` suppresses all log lines for matching namespaces.
+ */
+type CodemationLogLevelName = "debug" | "info" | "warn" | "error" | "silent";
+/**
+ * One rule: {@link filter} is one glob or several (`*` = any substring; a lone `*` matches all namespaces).
+ * If multiple patterns are given, **any** match applies this rule’s level.
+ * Rules are evaluated in order; the **first** rule whose filter set matches wins.
+ */
+type CodemationLogRule = Readonly<{
+  filter: string | ReadonlyArray<string>;
+  level: CodemationLogLevelName;
+}>;
+/**
+ * Either a single rule (`{ filter, level }`) or multiple `{ rules: [...] }`.
+ * Put broader patterns last, e.g. `{ filter: "codemation.webhooks.*", level: "info" }` then `{ filter: "*", level: "warn" }`.
+ * Use an array for `filter` to match several namespaces with the same level, e.g. `filter: ["codemation.webhooks.*", "codemation.engine.triggers"]`.
+ */
+type CodemationLogConfig = Readonly<{
+  rules: ReadonlyArray<CodemationLogRule>;
+}> | CodemationLogRule;
+//#endregion
+//#region ../host/src/presentation/config/CodemationWhitelabelConfig.d.ts
+/**
+ * Optional host shell whitelabeling (sidebar, login, document title).
+ * `logoPath` is resolved relative to the consumer project root.
+ */
+interface CodemationWhitelabelConfig {
+  readonly productName?: string;
+  /** Relative to consumer project root, e.g. `branding/logo.svg`. */
+  readonly logoPath?: string;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationWorkflowDiscovery.d.ts
+interface CodemationWorkflowDiscovery {
+  readonly directories?: ReadonlyArray<string>;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationConfig.d.ts
+type CodemationEventBusKind = "memory" | "redis";
+type CodemationSchedulerKind = "local" | "bullmq";
+type CodemationDatabaseKind = "postgresql" | "sqlite";
+interface CodemationDatabaseConfig {
+  readonly kind?: CodemationDatabaseKind;
+  /** TCP PostgreSQL URL when `kind` is `postgresql` (or omitted with a postgres URL). */
+  readonly url?: string;
+  /** SQLite database file path when `kind` is `sqlite`. Relative paths resolve from the consumer app root. */
+  readonly sqliteFilePath?: string;
+}
+interface CodemationEventBusConfig {
+  readonly kind?: CodemationEventBusKind;
+  readonly redisUrl?: string;
+  readonly queuePrefix?: string;
+}
+interface CodemationSchedulerConfig {
+  readonly kind?: CodemationSchedulerKind;
+  readonly queuePrefix?: string;
+  readonly workerQueues?: ReadonlyArray<string>;
+}
+type CodemationAppSchedulerKind = "inline" | "queue";
+interface CodemationAppSchedulerConfig {
+  readonly kind?: CodemationAppSchedulerKind;
+  readonly queuePrefix?: string;
+  readonly workerQueues?: ReadonlyArray<string>;
+  readonly redisUrl?: string;
+}
+/**
+ * Optional overrides for engine execution limits (activation budget and subworkflow depth caps).
+ * Omitted fields keep framework defaults. Advanced users can bind `CoreTokens.EngineExecutionLimitsPolicy` for full control.
+ */
+type CodemationEngineExecutionLimitsConfig = Readonly<Partial<EngineExecutionLimitsPolicyConfig>>;
+interface CodemationAppDefinition {
+  readonly frontendPort?: number;
+  readonly databaseUrl?: string;
+  readonly database?: CodemationDatabaseConfig;
+  readonly scheduler?: CodemationAppSchedulerConfig;
+  readonly auth?: CodemationAuthConfig;
+  readonly whitelabel?: CodemationWhitelabelConfig;
+  readonly log?: CodemationLogConfig;
+  readonly engineExecutionLimits?: CodemationEngineExecutionLimitsConfig;
+}
+interface CodemationApplicationRuntimeConfig {
+  readonly frontendPort?: number;
+  readonly database?: CodemationDatabaseConfig;
+  readonly eventBus?: CodemationEventBusConfig;
+  readonly scheduler?: CodemationSchedulerConfig;
+  /** Merged with engine defaults when building the execution limits policy (API + workers). */
+  readonly engineExecutionLimits?: CodemationEngineExecutionLimitsConfig;
+}
+interface CodemationConfig {
+  readonly app?: CodemationAppDefinition;
+  readonly register?: (context: CodemationAppContext) => void;
+  readonly runtime?: CodemationApplicationRuntimeConfig;
+  readonly workflows?: ReadonlyArray<WorkflowDefinition>;
+  readonly workflowDiscovery?: CodemationWorkflowDiscovery;
+  readonly plugins?: ReadonlyArray<CodemationPlugin>;
+  /** Consumer-defined `CredentialType` entries (see `@codemation/core`), applied when the host loads config. */
+  readonly credentialTypes?: ReadonlyArray<AnyCredentialType>;
+  /** MCP server declarations from this config file (merged with plugin and control-plane sources at startup). */
+  readonly mcpServers?: ReadonlyArray<McpServerDeclaration>;
+  /** Declared collections available at runtime via `ctx.collections`. Accepts either raw `CollectionDefinition` or `DefinedCollection` (the result of `defineCollection(...)`). */
+  readonly collections?: ReadonlyArray<CollectionDefinition | DefinedCollection>;
+  /** Optional shell whitelabel (product name, logo path). */
+  readonly whitelabel?: CodemationWhitelabelConfig;
+  /** Required for production hosts; optional only when using development bypass (never in production). */
+  readonly auth?: CodemationAuthConfig;
+  /**
+   * Namespace-level log filters (first matching rule wins). Unmatched namespaces use `CODEMATION_LOG_LEVEL` / defaults.
+   * Omit to keep env-only behavior.
+   */
+  readonly log?: CodemationLogConfig;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationPlugin.d.ts
+interface CodemationPluginContext extends CodemationRegistrationContextBase {
+  readonly container: Container;
+  readonly appConfig: AppConfig;
+  readonly loggerFactory: LoggerFactory;
+}
+interface CodemationPluginConfig {
+  readonly pluginPackageId?: string;
+  readonly credentialTypes?: ReadonlyArray<AnyCredentialType>;
+  readonly mcpServers?: ReadonlyArray<McpServerDeclaration>;
+  readonly register?: (context: CodemationPluginContext) => void | Promise<void>;
+  readonly sandbox?: CodemationConfig;
+}
+type CodemationPlugin = CodemationPluginConfig;
+//#endregion
+//#region ../host/src/presentation/config/AppConfig.d.ts
+type AppPersistenceConfig = Readonly<{
+  kind: "none";
+}> | Readonly<{
+  kind: "postgresql";
+  databaseUrl: string;
+}> | Readonly<{
+  kind: "sqlite";
+  databaseFilePath: string;
+}>;
+type AppPluginLoadSummary = Readonly<{
+  packageName: string;
+  source: "configured" | "discovered";
+}>;
+interface AppConfig {
+  readonly consumerRoot: string;
+  readonly repoRoot: string;
+  readonly env: Readonly<NodeJS.ProcessEnv>;
+  readonly workflowSources: ReadonlyArray<string>;
+  readonly workflows: ReadonlyArray<WorkflowDefinition>;
+  readonly containerRegistrations: ReadonlyArray<CodemationContainerRegistration<unknown>>;
+  readonly credentialTypes: ReadonlyArray<AnyCredentialType>;
+  readonly collections: ReadonlyArray<CollectionDefinition>;
+  readonly plugins: ReadonlyArray<CodemationPlugin>;
+  readonly pluginLoadSummary?: ReadonlyArray<AppPluginLoadSummary>;
+  readonly mcpServers: ReadonlyArray<McpServerDeclaration>;
+  readonly hasConfiguredCredentialSessionServiceRegistration: boolean;
+  readonly log?: CodemationLogConfig;
+  readonly engineExecutionLimits?: CodemationEngineExecutionLimitsConfig;
+  readonly databaseUrl?: string;
+  readonly database?: CodemationDatabaseConfig;
+  readonly persistence: AppPersistenceConfig;
+  readonly scheduler: Readonly<{
+    kind: CodemationSchedulerKind;
+    queuePrefix?: string;
+    workerQueues: ReadonlyArray<string>;
+    redisUrl?: string;
+  }>;
+  readonly eventing: Readonly<{
+    kind: CodemationEventBusKind;
+    queuePrefix?: string;
+    redisUrl?: string;
+  }>;
+  readonly auth?: CodemationAuthConfig;
+  readonly whitelabel: CodemationWhitelabelConfig;
+  readonly webSocketPort: number;
+  readonly webSocketBindHost: string;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationAppContext.d.ts
+interface CodemationRegistrationContextBase {
+  readonly appConfig?: AppConfig;
+  registerCredentialType(type: AnyCredentialType): void;
+  registerCollection(definition: CollectionDefinition): void;
+  registerNode<TValue>(token: TypeToken<TValue>, implementation?: CodemationClassToken<TValue>): void;
+  registerValue<TValue>(token: TypeToken<TValue>, value: TValue): void;
+  registerClass<TValue>(token: TypeToken<TValue>, implementation: CodemationClassToken<TValue>): void;
+  registerFactory<TValue>(token: TypeToken<TValue>, factory: (container: Container) => TValue): void;
+}
+interface CodemationAppContext extends CodemationRegistrationContextBase {
+  registerWorkflow(workflow: WorkflowDefinition): void;
+  registerWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
+  discoverWorkflows(...directories: ReadonlyArray<string>): void;
+}
+//#endregion
+//#region codemation.plugin.d.ts
+declare const plugin: CodemationPluginConfig & Readonly<{
+  sandbox?: CodemationConfig;
+}>;
+export = plugin;
+//# sourceMappingURL=codemation.plugin.d.cts.map

package/dist/codemation.plugin.d.ts

@@ -0,0 +1,266 @@
+import { a as TypeToken, c as WorkflowDefinition, i as Container, l as AnyCredentialType, n as DefinedCollection, o as EngineExecutionLimitsPolicyConfig, s as McpServerDeclaration, t as CollectionDefinition } from "./index-C2KJPzqN.js";
+import { ZodType, z } from "zod";
+import { BetterAuthOptions } from "better-auth";
+
+//#region ../host/src/presentation/config/CodemationClassToken.d.ts
+type CodemationClassToken<TValue> = TypeToken<TValue> & (new (...args: never[]) => TValue);
+//#endregion
+//#region ../host/src/bootstrap/CodemationContainerRegistration.d.ts
+interface CodemationContainerRegistrationBase<TValue> {
+  readonly token: TypeToken<TValue>;
+}
+interface CodemationValueRegistration<TValue> extends CodemationContainerRegistrationBase<TValue> {
+  readonly useValue: TValue;
+}
+interface CodemationClassRegistration<TValue> extends CodemationContainerRegistrationBase<TValue> {
+  readonly useClass: CodemationClassToken<TValue>;
+}
+interface CodemationFactoryRegistration<TValue> extends CodemationContainerRegistrationBase<TValue> {
+  readonly useFactory: (container: Container) => TValue;
+}
+type CodemationContainerRegistration<TValue = unknown> = CodemationValueRegistration<TValue> | CodemationClassRegistration<TValue> | CodemationFactoryRegistration<TValue>;
+//#endregion
+//#region ../host/src/application/logging/Logger.d.ts
+interface Logger {
+  info(message: string, exception?: Error): void;
+  warn(message: string, exception?: Error): void;
+  error(message: string, exception?: Error): void;
+  debug(message: string, exception?: Error): void;
+}
+interface LoggerFactory {
+  create(scope: string): Logger;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationAuthConfig.d.ts
+/**
+ * Consumer-declared authentication profile for the hosted UI + HTTP API.
+ * Social provider ids intentionally match Better Auth's provider ids so config stays 1:1 with the auth runtime.
+ */
+type CodemationAuthKind = "local" | "oauth" | "oidc" | "managed";
+type CodemationAuthOAuthProviderId = Extract<keyof NonNullable<BetterAuthOptions["socialProviders"]>, "github" | "google" | "microsoft">;
+interface CodemationAuthOAuthProviderConfig {
+  readonly provider: CodemationAuthOAuthProviderId;
+  readonly clientIdEnv: string;
+  readonly clientSecretEnv: string;
+  /** Microsoft tenant; environment variable name whose value is the tenant ID. */
+  readonly tenantIdEnv?: string;
+}
+interface CodemationAuthOidcProviderConfig {
+  readonly id: string;
+  readonly issuer: string;
+  readonly clientIdEnv: string;
+  readonly clientSecretEnv: string;
+}
+interface CodemationAuthConfig {
+  readonly kind: CodemationAuthKind;
+  /**
+   * When true and NODE_ENV is not production, the API accepts requests without a real session
+   * (synthetic principal only — never honored in production).
+   */
+  readonly allowUnauthenticatedInDevelopment?: boolean;
+  readonly oauth?: ReadonlyArray<CodemationAuthOAuthProviderConfig>;
+  readonly oidc?: ReadonlyArray<CodemationAuthOidcProviderConfig>;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationLogConfig.d.ts
+/**
+ * Minimum level for namespaces matched by {@link CodemationLogRule.filter}.
+ * `silent` suppresses all log lines for matching namespaces.
+ */
+type CodemationLogLevelName = "debug" | "info" | "warn" | "error" | "silent";
+/**
+ * One rule: {@link filter} is one glob or several (`*` = any substring; a lone `*` matches all namespaces).
+ * If multiple patterns are given, **any** match applies this rule’s level.
+ * Rules are evaluated in order; the **first** rule whose filter set matches wins.
+ */
+type CodemationLogRule = Readonly<{
+  filter: string | ReadonlyArray<string>;
+  level: CodemationLogLevelName;
+}>;
+/**
+ * Either a single rule (`{ filter, level }`) or multiple `{ rules: [...] }`.
+ * Put broader patterns last, e.g. `{ filter: "codemation.webhooks.*", level: "info" }` then `{ filter: "*", level: "warn" }`.
+ * Use an array for `filter` to match several namespaces with the same level, e.g. `filter: ["codemation.webhooks.*", "codemation.engine.triggers"]`.
+ */
+type CodemationLogConfig = Readonly<{
+  rules: ReadonlyArray<CodemationLogRule>;
+}> | CodemationLogRule;
+//#endregion
+//#region ../host/src/presentation/config/CodemationWhitelabelConfig.d.ts
+/**
+ * Optional host shell whitelabeling (sidebar, login, document title).
+ * `logoPath` is resolved relative to the consumer project root.
+ */
+interface CodemationWhitelabelConfig {
+  readonly productName?: string;
+  /** Relative to consumer project root, e.g. `branding/logo.svg`. */
+  readonly logoPath?: string;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationWorkflowDiscovery.d.ts
+interface CodemationWorkflowDiscovery {
+  readonly directories?: ReadonlyArray<string>;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationConfig.d.ts
+type CodemationEventBusKind = "memory" | "redis";
+type CodemationSchedulerKind = "local" | "bullmq";
+type CodemationDatabaseKind = "postgresql" | "sqlite";
+interface CodemationDatabaseConfig {
+  readonly kind?: CodemationDatabaseKind;
+  /** TCP PostgreSQL URL when `kind` is `postgresql` (or omitted with a postgres URL). */
+  readonly url?: string;
+  /** SQLite database file path when `kind` is `sqlite`. Relative paths resolve from the consumer app root. */
+  readonly sqliteFilePath?: string;
+}
+interface CodemationEventBusConfig {
+  readonly kind?: CodemationEventBusKind;
+  readonly redisUrl?: string;
+  readonly queuePrefix?: string;
+}
+interface CodemationSchedulerConfig {
+  readonly kind?: CodemationSchedulerKind;
+  readonly queuePrefix?: string;
+  readonly workerQueues?: ReadonlyArray<string>;
+}
+type CodemationAppSchedulerKind = "inline" | "queue";
+interface CodemationAppSchedulerConfig {
+  readonly kind?: CodemationAppSchedulerKind;
+  readonly queuePrefix?: string;
+  readonly workerQueues?: ReadonlyArray<string>;
+  readonly redisUrl?: string;
+}
+/**
+ * Optional overrides for engine execution limits (activation budget and subworkflow depth caps).
+ * Omitted fields keep framework defaults. Advanced users can bind `CoreTokens.EngineExecutionLimitsPolicy` for full control.
+ */
+type CodemationEngineExecutionLimitsConfig = Readonly<Partial<EngineExecutionLimitsPolicyConfig>>;
+interface CodemationAppDefinition {
+  readonly frontendPort?: number;
+  readonly databaseUrl?: string;
+  readonly database?: CodemationDatabaseConfig;
+  readonly scheduler?: CodemationAppSchedulerConfig;
+  readonly auth?: CodemationAuthConfig;
+  readonly whitelabel?: CodemationWhitelabelConfig;
+  readonly log?: CodemationLogConfig;
+  readonly engineExecutionLimits?: CodemationEngineExecutionLimitsConfig;
+}
+interface CodemationApplicationRuntimeConfig {
+  readonly frontendPort?: number;
+  readonly database?: CodemationDatabaseConfig;
+  readonly eventBus?: CodemationEventBusConfig;
+  readonly scheduler?: CodemationSchedulerConfig;
+  /** Merged with engine defaults when building the execution limits policy (API + workers). */
+  readonly engineExecutionLimits?: CodemationEngineExecutionLimitsConfig;
+}
+interface CodemationConfig {
+  readonly app?: CodemationAppDefinition;
+  readonly register?: (context: CodemationAppContext) => void;
+  readonly runtime?: CodemationApplicationRuntimeConfig;
+  readonly workflows?: ReadonlyArray<WorkflowDefinition>;
+  readonly workflowDiscovery?: CodemationWorkflowDiscovery;
+  readonly plugins?: ReadonlyArray<CodemationPlugin>;
+  /** Consumer-defined `CredentialType` entries (see `@codemation/core`), applied when the host loads config. */
+  readonly credentialTypes?: ReadonlyArray<AnyCredentialType>;
+  /** MCP server declarations from this config file (merged with plugin and control-plane sources at startup). */
+  readonly mcpServers?: ReadonlyArray<McpServerDeclaration>;
+  /** Declared collections available at runtime via `ctx.collections`. Accepts either raw `CollectionDefinition` or `DefinedCollection` (the result of `defineCollection(...)`). */
+  readonly collections?: ReadonlyArray<CollectionDefinition | DefinedCollection>;
+  /** Optional shell whitelabel (product name, logo path). */
+  readonly whitelabel?: CodemationWhitelabelConfig;
+  /** Required for production hosts; optional only when using development bypass (never in production). */
+  readonly auth?: CodemationAuthConfig;
+  /**
+   * Namespace-level log filters (first matching rule wins). Unmatched namespaces use `CODEMATION_LOG_LEVEL` / defaults.
+   * Omit to keep env-only behavior.
+   */
+  readonly log?: CodemationLogConfig;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationPlugin.d.ts
+interface CodemationPluginContext extends CodemationRegistrationContextBase {
+  readonly container: Container;
+  readonly appConfig: AppConfig;
+  readonly loggerFactory: LoggerFactory;
+}
+interface CodemationPluginConfig {
+  readonly pluginPackageId?: string;
+  readonly credentialTypes?: ReadonlyArray<AnyCredentialType>;
+  readonly mcpServers?: ReadonlyArray<McpServerDeclaration>;
+  readonly register?: (context: CodemationPluginContext) => void | Promise<void>;
+  readonly sandbox?: CodemationConfig;
+}
+type CodemationPlugin = CodemationPluginConfig;
+//#endregion
+//#region ../host/src/presentation/config/AppConfig.d.ts
+type AppPersistenceConfig = Readonly<{
+  kind: "none";
+}> | Readonly<{
+  kind: "postgresql";
+  databaseUrl: string;
+}> | Readonly<{
+  kind: "sqlite";
+  databaseFilePath: string;
+}>;
+type AppPluginLoadSummary = Readonly<{
+  packageName: string;
+  source: "configured" | "discovered";
+}>;
+interface AppConfig {
+  readonly consumerRoot: string;
+  readonly repoRoot: string;
+  readonly env: Readonly<NodeJS.ProcessEnv>;
+  readonly workflowSources: ReadonlyArray<string>;
+  readonly workflows: ReadonlyArray<WorkflowDefinition>;
+  readonly containerRegistrations: ReadonlyArray<CodemationContainerRegistration<unknown>>;
+  readonly credentialTypes: ReadonlyArray<AnyCredentialType>;
+  readonly collections: ReadonlyArray<CollectionDefinition>;
+  readonly plugins: ReadonlyArray<CodemationPlugin>;
+  readonly pluginLoadSummary?: ReadonlyArray<AppPluginLoadSummary>;
+  readonly mcpServers: ReadonlyArray<McpServerDeclaration>;
+  readonly hasConfiguredCredentialSessionServiceRegistration: boolean;
+  readonly log?: CodemationLogConfig;
+  readonly engineExecutionLimits?: CodemationEngineExecutionLimitsConfig;
+  readonly databaseUrl?: string;
+  readonly database?: CodemationDatabaseConfig;
+  readonly persistence: AppPersistenceConfig;
+  readonly scheduler: Readonly<{
+    kind: CodemationSchedulerKind;
+    queuePrefix?: string;
+    workerQueues: ReadonlyArray<string>;
+    redisUrl?: string;
+  }>;
+  readonly eventing: Readonly<{
+    kind: CodemationEventBusKind;
+    queuePrefix?: string;
+    redisUrl?: string;
+  }>;
+  readonly auth?: CodemationAuthConfig;
+  readonly whitelabel: CodemationWhitelabelConfig;
+  readonly webSocketPort: number;
+  readonly webSocketBindHost: string;
+}
+//#endregion
+//#region ../host/src/presentation/config/CodemationAppContext.d.ts
+interface CodemationRegistrationContextBase {
+  readonly appConfig?: AppConfig;
+  registerCredentialType(type: AnyCredentialType): void;
+  registerCollection(definition: CollectionDefinition): void;
+  registerNode<TValue>(token: TypeToken<TValue>, implementation?: CodemationClassToken<TValue>): void;
+  registerValue<TValue>(token: TypeToken<TValue>, value: TValue): void;
+  registerClass<TValue>(token: TypeToken<TValue>, implementation: CodemationClassToken<TValue>): void;
+  registerFactory<TValue>(token: TypeToken<TValue>, factory: (container: Container) => TValue): void;
+}
+interface CodemationAppContext extends CodemationRegistrationContextBase {
+  registerWorkflow(workflow: WorkflowDefinition): void;
+  registerWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
+  discoverWorkflows(...directories: ReadonlyArray<string>): void;
+}
+//#endregion
+//#region codemation.plugin.d.ts
+declare const plugin: CodemationPluginConfig & Readonly<{
+  sandbox?: CodemationConfig;
+}>;
+//#endregion
+export { plugin as default };
+//# sourceMappingURL=codemation.plugin.d.ts.map