cognitive-modules-cli 2.2.10 → 2.2.12

package/dist/types.d.ts

@@ -2,10 +2,49 @@
  * Cognitive Runtime - Core Types
  * Version 2.2 - With Control/Data plane separation, tier, overflow, extensible enums
  */
+/**
+ * Provider structured output support levels.
+ *
+ * - none: provider does not accept a schema hint (runtime will still validate/repair post-hoc)
+ * - prompt: schema is injected into the prompt as guidance (best-effort)
+ * - native: provider supports a native structured output / response schema API surface
+ */
+export type StructuredOutputMode = 'none' | 'prompt' | 'native';
+/** If a schema is passed, how it should be applied. */
+export type JsonSchemaMode = Exclude<StructuredOutputMode, 'none'>;
+/**
+ * Dialect for a provider-native structured output API.
+ *
+ * The runtime's schemas are JSON Schema (draft-2020-12-ish). Some providers expose a "native schema"
+ * API surface, but it may not accept JSON Schema directly.
+ */
+export type NativeSchemaDialect = 'json-schema' | 'gemini-responseSchema';
+/**
+ * Runtime preference for how to apply structured output.
+ *
+ * - auto: choose based on provider capabilities (and allow safe downgrade from native -> prompt)
+ * - off: do not pass schema hints to providers (runtime can still validate/repair post-hoc)
+ * - prompt: always inject schema as prompt guidance
+ * - native: always use provider-native structured output when available (no auto downgrade)
+ */
+export type StructuredOutputPreference = 'auto' | 'off' | 'prompt' | 'native';
+export interface ProviderCapabilities {
+    structuredOutput: StructuredOutputMode;
+    streaming: boolean;
+    /** If structuredOutput === 'native', which dialect the provider expects. Defaults to 'json-schema'. */
+    nativeSchemaDialect?: NativeSchemaDialect;
+    /** Optional hint for safety limits (bytes) when passing native schemas. */
+    maxNativeSchemaBytes?: number;
+}
 export interface Provider {
     name: string;
     invoke(params: InvokeParams): Promise<InvokeResult>;
     isConfigured(): boolean;
+    /**
+     * Optional capability surface for "publish-grade" behavior parity.
+     * If absent, the runtime assumes structuredOutput='prompt' and streaming based on supportsStreaming().
+     */
+    getCapabilities?(): ProviderCapabilities;
     /**
      * Stream-based invoke (optional).
      * Returns an async generator that yields content chunks.
@@ -21,6 +60,7 @@ export interface Provider {
 export interface InvokeParams {
     messages: Message[];
     jsonSchema?: object;
+    jsonSchemaMode?: JsonSchemaMode;
     temperature?: number;
     maxTokens?: number;
 }
@@ -386,11 +426,10 @@ export interface CommandResultV2 {
 /**
  * Execution profile:
  * - core: minimal constraints (5-minute path)
- * - default: safe defaults for day-to-day usage
- * - strict: higher assurance (more enforcement)
+ * - standard: safe defaults for day-to-day usage
  * - certified: strongest gates (intended for publishable / regulated flows)
  */
-export type ExecutionProfile = 'core' | 'default' | 'strict' | 'certified';
+export type ExecutionProfile = 'core' | 'standard' | 'certified';
 /** Validation mode for input/output schemas and runtime enforcement. */
 export type ValidateMode = 'auto' | 'on' | 'off';
 export interface ExecutionPolicy {
@@ -398,6 +437,7 @@ export interface ExecutionPolicy {
     validate: ValidateMode;
     audit: boolean;
     enableRepair: boolean;
+    structured: StructuredOutputPreference;
     /**
      * If true, refuse to run non-v2.2 modules (legacy/v0/v1 or missing formatVersion).
      * This is a gate for certification-style flows.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cognitive-modules-cli",
-  "version": "2.2.10",
+  "version": "2.2.12",
   "description": "Cognitive Modules - Structured AI Task Execution with version management",
   "type": "module",
   "main": "dist/index.js",
@@ -48,7 +48,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/Cognary/cognitive.git"
+    "url": "git+https://github.com/Cognary/cognitive.git"
   },
   "homepage": "https://cognary.github.io/cognitive/",
   "bugs": {
@@ -62,6 +62,7 @@
   },
   "dependencies": {
     "ajv": "^8.12.0",
+    "ajv-formats": "^3.0.1",
     "js-yaml": "^4.1.1"
   },
   "optionalDependencies": {