workspai 0.75.2 → 0.77.0

package/README.md

@@ -110,8 +110,8 @@ npx workspai create
 ```
 
 Choose whether to create a workspace, scaffold a project, or add existing
-software. Project starters are grouped as Backend, Frontend, Desktop, and
-Extension.
+software. Project starters are grouped as Backend, Frontend, Desktop, AI
+Agent, AI Gateway, Extension, and Gaming.
 
 ```bash
 # Optional global installation

package/contracts/agent-framework-capabilities.v1.json

@@ -425,10 +425,10 @@
   },
   "publication": {
     "manifestSchema": "contracts/workspace-intelligence/agent-framework-adapter-manifest.v1.json",
-    "conformanceSchema": "contracts/workspace-intelligence/agent-framework-conformance-report.v1.json",
+    "conformanceSchema": "contracts/workspace-intelligence/agent-framework-conformance-report.v2.json",
     "changePlanSchema": "contracts/workspace-intelligence/agent-framework-change-plan.v1.json",
     "ownershipReceiptSchema": "contracts/workspace-intelligence/agent-framework-ownership-receipt.v1.json",
-    "admissionCandidateSchema": "contracts/workspace-intelligence/agent-framework-admission-candidate.v1.json",
+    "admissionCandidateSchema": "contracts/workspace-intelligence/agent-framework-admission-candidate.v2.json",
     "requiredChecks": [
       "manifest-schema",
       "protocol-version",

package/contracts/cli-runtime-command-inventory.v1.snapshot.json

@@ -133,6 +133,10 @@
           "flags": "--runtime <runtime>",
           "attributeName": "runtime"
         },
+        {
+          "flags": "--framework <framework>",
+          "attributeName": "framework"
+        },
         {
           "flags": "--workspace <path>",
           "attributeName": "workspace"
@@ -177,6 +181,10 @@
           "flags": "--runtime <runtime>",
           "attributeName": "runtime"
         },
+        {
+          "flags": "--framework <framework>",
+          "attributeName": "framework"
+        },
         {
           "flags": "--name <name>",
           "attributeName": "name"
@@ -241,6 +249,10 @@
           "flags": "--runtime <runtime>",
           "attributeName": "runtime"
         },
+        {
+          "flags": "--framework <framework>",
+          "attributeName": "framework"
+        },
         {
           "flags": "--name <name>",
           "attributeName": "name"

package/contracts/create-planner-capabilities.v1.json

@@ -134,6 +134,54 @@
       "versionPolicy": "tested-baseline",
       "moduleSupport": false,
       "workspacePythonEngine": "none"
+    },
+    {
+      "id": "agent.openai.python",
+      "runtime": "python",
+      "framework": "openai-agents",
+      "plannerFramework": "openai-agents",
+      "category": "agent",
+      "owner": "workspai",
+      "stability": "stable",
+      "versionPolicy": "tested-baseline",
+      "moduleSupport": false,
+      "workspacePythonEngine": "none"
+    },
+    {
+      "id": "agent.openai.typescript",
+      "runtime": "node",
+      "framework": "openai-agents",
+      "plannerFramework": "openai-agents",
+      "category": "agent",
+      "owner": "workspai",
+      "stability": "stable",
+      "versionPolicy": "tested-baseline",
+      "moduleSupport": false,
+      "workspacePythonEngine": "none"
+    },
+    {
+      "id": "gateway.openrouter.typescript",
+      "runtime": "node",
+      "framework": "openrouter",
+      "plannerFramework": "openrouter",
+      "category": "gateway",
+      "owner": "workspai",
+      "stability": "stable",
+      "versionPolicy": "tested-baseline",
+      "moduleSupport": false,
+      "workspacePythonEngine": "none"
+    },
+    {
+      "id": "gateway.openrouter.python",
+      "runtime": "python",
+      "framework": "openrouter",
+      "plannerFramework": "openrouter",
+      "category": "gateway",
+      "owner": "workspai",
+      "stability": "stable",
+      "versionPolicy": "tested-baseline",
+      "moduleSupport": false,
+      "workspacePythonEngine": "none"
     }
   ],
   "officialCreate": [

package/contracts/extension-cli-compatibility.v1.json

@@ -100,10 +100,12 @@
     "agentCustomizationPackCapabilities": "workspai-agent-customization-pack-capabilities.v1",
     "agentFrameworkCapabilities": "workspai.agent-framework-capabilities.v1",
     "agentFrameworkAdapterManifest": "workspai.agent-framework-adapter-manifest.v1",
-    "agentFrameworkConformanceReport": "workspai.agent-framework-conformance-report.v1",
+    "agentFrameworkConformanceReport": "workspai.agent-framework-conformance-report.v2",
+    "agentFrameworkConformanceReportLegacy": "workspai.agent-framework-conformance-report.v1",
     "agentFrameworkChangePlan": "workspai.agent-framework-change-plan.v1",
     "agentFrameworkOwnershipReceipt": "workspai.agent-framework-ownership-receipt.v1",
-    "agentFrameworkAdmissionCandidate": "workspai.agent-framework-admission-candidate.v1",
+    "agentFrameworkAdmissionCandidate": "workspai.agent-framework-admission-candidate.v2",
+    "agentFrameworkAdmissionCandidateLegacy": "workspai.agent-framework-admission-candidate.v1",
     "agentCustomizationPackReport": "rapidkit-agent-customization-pack.v1",
     "agentReportsIndex": "rapidkit-agent-reports-index.v1",
     "workspaceOperationalSkill": "workspace-operational-skill.v1",

package/contracts/published-contract-catalog.v1.json

@@ -507,6 +507,11 @@
       "publication": "json-schema"
     },
     "agentFrameworkConformanceReport": {
+      "schemaVersion": "workspai.agent-framework-conformance-report.v2",
+      "contractPath": "contracts/workspace-intelligence/agent-framework-conformance-report.v2.json",
+      "publication": "json-schema"
+    },
+    "agentFrameworkConformanceReportLegacy": {
       "schemaVersion": "workspai.agent-framework-conformance-report.v1",
       "contractPath": "contracts/workspace-intelligence/agent-framework-conformance-report.v1.json",
       "publication": "json-schema"
@@ -522,6 +527,11 @@
       "publication": "json-schema"
     },
     "agentFrameworkAdmissionCandidate": {
+      "schemaVersion": "workspai.agent-framework-admission-candidate.v2",
+      "contractPath": "contracts/workspace-intelligence/agent-framework-admission-candidate.v2.json",
+      "publication": "json-schema"
+    },
+    "agentFrameworkAdmissionCandidateLegacy": {
       "schemaVersion": "workspai.agent-framework-admission-candidate.v1",
       "contractPath": "contracts/workspace-intelligence/agent-framework-admission-candidate.v1.json",
       "publication": "json-schema"

package/contracts/runtime-command-surface.v1.json

@@ -4371,7 +4371,11 @@
       "dotnet.webapi.clean",
       "rust.axum",
       "agent.microsoft.python",
-      "agent.microsoft.dotnet"
+      "agent.microsoft.dotnet",
+      "agent.openai.python",
+      "agent.openai.typescript",
+      "gateway.openrouter.typescript",
+      "gateway.openrouter.python"
     ],
     "officialCreate": [
       "frontend.nextjs",

package/contracts/workspace-intelligence/agent-framework-admission-candidate.v2.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/contracts/workspace-intelligence/agent-framework-admission-candidate.v2.json",
+  "title": "Workspai Agent Framework Admission Candidate v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "protocolVersion",
+    "generatedAt",
+    "sourceCommit",
+    "cliVersion",
+    "reviewStatus",
+    "adapters",
+    "verdict",
+    "blockers"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspai.agent-framework-admission-candidate.v2"
+    },
+    "protocolVersion": {
+      "const": "workspai.agent-framework-adapter-protocol.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sourceCommit": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{40}(?:[a-f0-9]{24})?$"
+    },
+    "cliVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "reviewStatus": {
+      "const": "pending"
+    },
+    "adapters": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "version",
+          "manifestSha256",
+          "implementationSha256ByPlatform",
+          "framework",
+          "lanes"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$"
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "manifestSha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "implementationSha256ByPlatform": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "linux",
+              "darwin",
+              "win32"
+            ],
+            "properties": {
+              "linux": {
+                "type": "string",
+                "pattern": "^[a-f0-9]{64}$"
+              },
+              "darwin": {
+                "type": "string",
+                "pattern": "^[a-f0-9]{64}$"
+              },
+              "win32": {
+                "type": "string",
+                "pattern": "^[a-f0-9]{64}$"
+              }
+            }
+          },
+          "framework": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$"
+              }
+            }
+          },
+          "lanes": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "platform",
+                "runtime",
+                "runtimeVersion",
+                "frameworkVersion",
+                "report",
+                "evidence"
+              ],
+              "properties": {
+                "platform": {
+                  "enum": [
+                    "linux",
+                    "darwin",
+                    "win32"
+                  ]
+                },
+                "runtime": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "runtimeVersion": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "frameworkVersion": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "report": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "path",
+                    "sha256"
+                  ],
+                  "properties": {
+                    "path": {
+                      "type": "string",
+                      "minLength": 1,
+                      "not": {
+                        "anyOf": [
+                          {
+                            "pattern": "^/"
+                          },
+                          {
+                            "pattern": "^[A-Za-z]:[\\/]"
+                          },
+                          {
+                            "pattern": "(^|[\\/])\\.\\.([\\/]|$)"
+                          }
+                        ]
+                      }
+                    },
+                    "sha256": {
+                      "type": "string",
+                      "pattern": "^[a-f0-9]{64}$"
+                    }
+                  }
+                },
+                "evidence": {
+                  "type": "array",
+                  "minItems": 18,
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                      "path",
+                      "sha256"
+                    ],
+                    "properties": {
+                      "path": {
+                        "type": "string",
+                        "minLength": 1,
+                        "not": {
+                          "anyOf": [
+                            {
+                              "pattern": "^/"
+                            },
+                            {
+                              "pattern": "^[A-Za-z]:[\\/]"
+                            },
+                            {
+                              "pattern": "(^|[\\/])\\.\\.([\\/]|$)"
+                            }
+                          ]
+                        }
+                      },
+                      "sha256": {
+                        "type": "string",
+                        "pattern": "^[a-f0-9]{64}$"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "verdict": {
+      "const": "admitted"
+    },
+    "blockers": {
+      "type": "array",
+      "maxItems": 0
+    }
+  }
+}

package/contracts/workspace-intelligence/agent-framework-conformance-report.v2.json

@@ -0,0 +1,274 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://workspai.dev/contracts/workspace-intelligence/agent-framework-conformance-report.v2.json",
+  "title": "Workspai Agent Framework Conformance Report v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "protocolVersion",
+    "generatedAt",
+    "adapter",
+    "frameworkVersion",
+    "cliVersion",
+    "environment",
+    "checks",
+    "summary",
+    "verdict",
+    "blockers",
+    "limitations"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "workspai.agent-framework-conformance-report.v2"
+    },
+    "protocolVersion": {
+      "const": "workspai.agent-framework-adapter-protocol.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "adapter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "manifestSha256",
+        "implementationSha256"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "manifestSha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "implementationSha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "frameworkVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "cliVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "platform",
+        "architecture",
+        "runtime",
+        "runtimeVersion"
+      ],
+      "properties": {
+        "platform": {
+          "enum": [
+            "linux",
+            "darwin",
+            "win32"
+          ]
+        },
+        "architecture": {
+          "type": "string",
+          "minLength": 1
+        },
+        "runtime": {
+          "type": "string",
+          "minLength": 1
+        },
+        "runtimeVersion": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "checks": {
+      "type": "array",
+      "minItems": 18,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "status",
+          "required",
+          "summary",
+          "evidencePaths",
+          "durationMs"
+        ],
+        "properties": {
+          "id": {
+            "enum": [
+              "manifest-schema",
+              "protocol-version",
+              "capability-truth",
+              "detection-positive",
+              "detection-negative",
+              "scaffold-plan-safety",
+              "attach-plan-safety",
+              "managed-file-ownership",
+              "user-file-preservation",
+              "path-containment",
+              "secret-non-persistence",
+              "context-generation-binding",
+              "mutation-gateway",
+              "verification-binding",
+              "failure-isolation",
+              "idempotency",
+              "offline-posture",
+              "cross-platform-paths"
+            ]
+          },
+          "status": {
+            "enum": [
+              "passed",
+              "failed",
+              "skipped"
+            ]
+          },
+          "required": {
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1
+          },
+          "evidencePaths": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "not": {
+                "anyOf": [
+                  {
+                    "pattern": "^/"
+                  },
+                  {
+                    "pattern": "^[A-Za-z]:[\\\\/]"
+                  },
+                  {
+                    "pattern": "(^|[\\\\/])\\.\\.([\\\\/]|$)"
+                  }
+                ]
+              }
+            }
+          },
+          "durationMs": {
+            "type": "number",
+            "minimum": 0
+          }
+        }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "passed",
+        "failed",
+        "skipped",
+        "required"
+      ],
+      "properties": {
+        "passed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "failed": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "skipped": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "required": {
+          "type": "integer",
+          "minimum": 18
+        }
+      }
+    },
+    "verdict": {
+      "enum": [
+        "admitted",
+        "blocked"
+      ]
+    },
+    "blockers": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "minItems": 0,
+      "uniqueItems": true
+    },
+    "limitations": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "minItems": 0,
+      "uniqueItems": true
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "verdict": {
+            "const": "blocked"
+          }
+        },
+        "required": [
+          "verdict"
+        ]
+      },
+      "then": {
+        "properties": {
+          "blockers": {
+            "type": "array",
+            "minItems": 1
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "verdict": {
+            "const": "admitted"
+          }
+        },
+        "required": [
+          "verdict"
+        ]
+      },
+      "then": {
+        "properties": {
+          "blockers": {
+            "type": "array",
+            "maxItems": 0
+          }
+        }
+      }
+    }
+  ]
+}

package/contracts/workspace-intelligence/workspace-model.v1.json

@@ -48,6 +48,7 @@
               "service",
               "worker",
               "agent",
+              "gateway",
               "platform",
               "library",
               "infra",
@@ -66,6 +67,7 @@
               "desktop",
               "extension",
               "agent",
+              "gateway",
               "platform",
               "library",
               "infrastructure",
@@ -97,6 +99,7 @@
               "extension",
               "worker",
               "agent",
+              "gateway",
               "platform",
               "library",
               "infra",
@@ -112,6 +115,7 @@
               "desktop",
               "extension",
               "agent",
+              "gateway",
               "platform",
               "library",
               "infrastructure",