@bluefly/openstandardagents 0.4.4 → 0.4.6

package/dist/services/workspace/workspace.service.d.ts

@@ -0,0 +1,44 @@
+/**
+ * WorkspaceService — Init, discover, status for OSSA workspaces
+ *
+ * Extracts handleWorkspace logic from MCP server. No TUI/HTTP deps.
+ */
+export interface WorkspaceInitResult {
+    action: 'init';
+    status: 'created' | 'already_exists';
+    path: string;
+    name?: string;
+}
+export interface WorkspaceScaffoldResult {
+    action: 'scaffold';
+    status: 'completed';
+    workspacePath: string;
+    projectsScaffolded: number;
+    codeWorkspacePath: string;
+    externalWorktreesBound: number;
+}
+export interface DiscoveryAgent {
+    name: string;
+    path: string;
+    version: string;
+    kind: string;
+    description: string;
+}
+export interface DiscoveryResult {
+    action: 'discover';
+    count: number;
+    agents: DiscoveryAgent[];
+}
+export interface WorkspaceStatus {
+    action: 'status';
+    initialized: boolean;
+    workspace?: Record<string, unknown>;
+    message?: string;
+}
+export declare class WorkspaceService {
+    init(directory: string, name?: string): Promise<WorkspaceInitResult>;
+    scaffold(baseDirectory: string, initProjects?: string[], externalWorktrees?: string[]): Promise<WorkspaceScaffoldResult>;
+    discover(directory: string): Promise<DiscoveryResult>;
+    status(directory: string): Promise<WorkspaceStatus>;
+}
+//# sourceMappingURL=workspace.service.d.ts.map

package/dist/services/workspace/workspace.service.js

@@ -0,0 +1,203 @@
+/**
+ * WorkspaceService — Init, discover, status for OSSA workspaces
+ *
+ * Extracts handleWorkspace logic from MCP server. No TUI/HTTP deps.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import fg from 'fast-glob';
+import { injectable } from 'inversify';
+import yaml from 'js-yaml';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getApiVersion } from '../../utils/version.js';
+import { IdentityService } from '../identity/identity.service.js';
+let WorkspaceService = class WorkspaceService {
+    async init(directory, name) {
+        const dir = path.resolve(directory);
+        const wsDir = path.join(dir, '.agents-workspace');
+        const registryDir = path.join(wsDir, 'registry');
+        if (fs.existsSync(wsDir)) {
+            return { action: 'init', status: 'already_exists', path: wsDir };
+        }
+        fs.mkdirSync(registryDir, { recursive: true });
+        const wsName = name || path.basename(dir);
+        const indexYaml = yaml.dump({
+            workspace: wsName,
+            version: '1.0.0',
+            created: new Date().toISOString(),
+            agents: [],
+        });
+        fs.writeFileSync(path.join(registryDir, 'index.yaml'), indexYaml);
+        fs.writeFileSync(path.join(wsDir, 'README.md'), `# OSSA Workspace: ${wsName}\n\nGenerated by OSSA.\n\nRun \`ossa workspace discover\` to scan for agents.\n`);
+        return { action: 'init', status: 'created', path: wsDir, name: wsName };
+    }
+    async scaffold(baseDirectory, initProjects = [], externalWorktrees = []) {
+        const dir = path.resolve(baseDirectory);
+        const wsDir = path.join(dir, '.agents-workspace');
+        // 1. Ensure the agents-workspace orchestrator root exists
+        if (!fs.existsSync(wsDir)) {
+            await this.init(dir);
+        }
+        // 2. Deliberate provisioning: Only inject .agents/ folders into explicitly specified projects
+        const projectsScaffolded = [];
+        for (const projectPath of initProjects) {
+            const pDir = path.resolve(dir, projectPath);
+            if (fs.existsSync(pDir)) {
+                const agentsDir = path.join(pDir, '.agents');
+                if (!fs.existsSync(agentsDir)) {
+                    fs.mkdirSync(agentsDir, { recursive: true });
+                    const identity = IdentityService.provisionIdentityForAgent(pDir);
+                    const stubYaml = yaml.dump({
+                        apiVersion: getApiVersion(),
+                        kind: 'Agent',
+                        metadata: {
+                            name: path.basename(pDir),
+                            version: '0.1.0',
+                            identity: {
+                                publicKey: identity.publicKey,
+                                algorithm: identity.algorithm,
+                            },
+                        },
+                        spec: { capabilities: [] },
+                    });
+                    fs.writeFileSync(path.join(agentsDir, 'manifest.ossa.yaml'), stubYaml);
+                    projectsScaffolded.push(path.basename(pDir));
+                }
+            }
+        }
+        // 3. Generate the IDE multi-root workspace file dynamically using discover()
+        const codeWorkspacePath = path.join(dir, 'agents-playground.code-workspace');
+        const folders = [
+            { name: '⚙️ Agents Workspace Root', path: wsDir },
+        ];
+        // Scan base directory for agent projects using the advanced globber in discover()
+        const baseDiscovery = await this.discover(dir);
+        const discoveredDirs = new Set();
+        for (const agent of baseDiscovery.agents) {
+            // agent.path is inside .agents/, we want the project root
+            const pRoot = path.dirname(path.dirname(agent.path));
+            if (!discoveredDirs.has(pRoot) && pRoot !== dir && pRoot !== wsDir) {
+                discoveredDirs.add(pRoot);
+                folders.push({ name: `🤖 ${path.basename(pRoot)}`, path: pRoot });
+            }
+        }
+        // Bind requested external git worktrees or arbitrary paths to the IDE
+        const worktreesBound = [];
+        for (const wtPath of externalWorktrees) {
+            const wDir = path.resolve(wtPath);
+            if (fs.existsSync(wDir)) {
+                folders.push({
+                    name: `🌳 ${path.basename(wDir)} (Worktree)`,
+                    path: wDir,
+                });
+                worktreesBound.push(wDir);
+                // Also run a discovery in the worktree to add it to the central workspace registry
+                const wtDiscovery = await this.discover(wDir);
+                for (const agent of wtDiscovery.agents) {
+                    const pRoot = path.dirname(path.dirname(agent.path));
+                    if (!discoveredDirs.has(pRoot)) {
+                        discoveredDirs.add(pRoot);
+                        folders.push({ name: `🤖 ${path.basename(pRoot)}`, path: pRoot });
+                    }
+                }
+            }
+        }
+        const vscodeSettings = {
+            'files.exclude': {
+                '**/node_modules': true,
+                '**/.git': true,
+                '**/dist': true,
+            },
+            'kiroAgent.configureMCP': 'Enabled',
+        };
+        fs.writeFileSync(codeWorkspacePath, JSON.stringify({ folders, settings: vscodeSettings }, null, 2));
+        return {
+            action: 'scaffold',
+            status: 'completed',
+            workspacePath: wsDir,
+            projectsScaffolded: projectsScaffolded.length,
+            codeWorkspacePath,
+            externalWorktreesBound: worktreesBound.length,
+        };
+    }
+    async discover(directory) {
+        const dir = path.resolve(directory);
+        const patterns = [
+            '**/*.ossa.yaml',
+            '**/*.ossa.yml',
+            '**/.agents/*/manifest.ossa.yaml',
+        ];
+        const ignorePatterns = [
+            '**/node_modules/**',
+            '**/dist/**',
+            '**/.git/**',
+            '**/coverage/**',
+        ];
+        const files = await fg(patterns, {
+            cwd: dir,
+            ignore: ignorePatterns,
+            absolute: true,
+        });
+        const agents = [];
+        for (const f of files) {
+            try {
+                const raw = fs.readFileSync(f, 'utf8');
+                const m = yaml.load(raw);
+                const meta = m?.metadata;
+                agents.push({
+                    name: meta?.name || path.basename(path.dirname(f)),
+                    path: f,
+                    version: meta?.version || '0.0.0',
+                    kind: m?.kind || 'Agent',
+                    description: meta?.description || '',
+                });
+            }
+            catch {
+                // Skip unparseable files
+            }
+        }
+        // Write discovery output if .agents-workspace exists
+        const wsDir = path.join(dir, '.agents-workspace');
+        if (fs.existsSync(wsDir)) {
+            const registryDir = path.join(wsDir, 'registry');
+            fs.mkdirSync(registryDir, { recursive: true });
+            const index = {
+                workspace: path.basename(dir),
+                discovered: new Date().toISOString(),
+                count: agents.length,
+                agents: agents.map((a) => ({
+                    name: a.name,
+                    version: a.version,
+                    kind: a.kind,
+                    path: a.path,
+                })),
+            };
+            fs.writeFileSync(path.join(registryDir, 'index.yaml'), yaml.dump(index));
+        }
+        return { action: 'discover', count: agents.length, agents };
+    }
+    async status(directory) {
+        const dir = path.resolve(directory);
+        const wsDir = path.join(dir, '.agents-workspace');
+        const indexPath = path.join(wsDir, 'registry', 'index.yaml');
+        if (!fs.existsSync(indexPath)) {
+            return {
+                action: 'status',
+                initialized: false,
+                message: 'Run ossa workspace init first',
+            };
+        }
+        const indexContent = yaml.load(fs.readFileSync(indexPath, 'utf8'));
+        return { action: 'status', initialized: true, workspace: indexContent };
+    }
+};
+WorkspaceService = __decorate([
+    injectable()
+], WorkspaceService);
+export { WorkspaceService };
+//# sourceMappingURL=workspace.service.js.map

package/dist/spec/extensions/knowledge-graph/knowledge-graph.schema.json

@@ -359,7 +359,7 @@
         "vector_db": {
           "type": "qdrant",
           "url": "${QDRANT_URL}",
-          "collection": "my-agent-kg"
+          "collection": "supercali-fragilisticagent-kg"
         },
         "wiki": {
           "type": "markdown",

package/dist/spec/extensions/manifest-extensions.md

@@ -16,7 +16,7 @@ The `messaging` field is added to the `spec` section of Agent manifests:
 apiVersion: ossa/v0.3.3
 kind: Agent
 metadata:
-  name: my-agent
+  name: creative-agent-naming
   version: 1.0.0
 spec:
   messaging:
@@ -33,7 +33,7 @@ spec:
         schema: TaskAssigned
         handler: handleTaskAssigned
         filter:
-          payload.assignedTo: "ossa://agents/my-agent"
+          payload.assignedTo: "ossa://agents/creative-agent-naming"
         priority: high
 
     transport:

package/dist/spec/ossa-audit-api.yaml

@@ -12,8 +12,8 @@ info:
 servers:
   - url: http://localhost:3000
     description: Local development
-  - url: https://ossa-audit.blueflyagents.com
-    description: Production
+  - url: https://your-ossa-audit.example.com
+    description: Production (configure via environment)
 
 paths:
   /audit/scan:
@@ -48,8 +48,8 @@ paths:
                 specVersion:
                   type: string
                   description: OSSA spec version to validate against
-                  example: "0.3.5"
-                  default: "0.3.5"
+                  example: "0.4.6"
+                  default: "0.4.6"
                 includeExamples:
                   type: boolean
                   description: Include example manifests in scan
@@ -137,7 +137,7 @@ paths:
                   description: Path to manifest file
                 specVersion:
                   type: string
-                  default: "0.3.5"
+                  default: "0.4.6"
       responses:
         '200':
           description: Validation result

package/dist/spec/reference/reference-agents/compliance-auditor/manifest.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.4.6
 kind: Agent
 metadata:
   name: compliance-auditor

package/dist/spec/reference/reference-agents/doc-agent/manifest.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.4.6
 kind: Agent
 metadata:
   name: doc-agent

package/dist/spec/reference/reference-agents/mr-reviewer/manifest.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.4.6
 kind: Agent
 metadata:
   name: mr-reviewer

package/dist/spec/reference/reference-agents/ossa-validator-v0.3/manifest.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.4.6
 kind: Agent
 
 metadata:

package/dist/spec/reference/reference-agents/pipeline-fixer/manifest.ossa.yaml

@@ -9,7 +9,7 @@
 #
 # ============================================================================
 
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.4.6
 kind: Agent
 
 metadata:

package/dist/spec/reference/reference-agents/release-orchestrator/manifest.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.5
+apiVersion: ossa/v0.4.6
 kind: Agent
 metadata:
   name: release-orchestrator

package/dist/spec/registry/README.md

@@ -28,6 +28,12 @@ This is your primary reference for understanding how the OSSA Registry works.
 
 ---
 
+### 📐 [project-registry.schema.json](./project-registry.schema.json)
+**JSON Schema for project-level registry** (`.agents-workspace/registry.yaml`):
+- Local agents list, remote sources (MCP endpoint + auth), scopes, resolution order
+- Use for validating a project's decentralized agent registry index
+- See [Agents Workspace and Registry](../../docs/getting-started/agents-workspace-registry.md)
+
 ### 📐 [registry-api.schema.json](./registry-api.schema.json)
 **JSON Schema definitions** for all API request/response types:
 - `AgentRegistryMetadata`: Core agent metadata
@@ -75,7 +81,7 @@ cat > agent.ossa.yaml <<EOF
 apiVersion: ossa/v0.3.0
 kind: Agent
 metadata:
-  name: my-agent
+  name: creative-agent-naming
   version: 1.0.0
 spec:
   role: A helpful assistant

package/dist/spec/registry/project-registry.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/registry/project-registry/v1.json",
+  "title": "OSSA Project Registry (agents-workspace)",
+  "description": "JSON Schema for .agents-workspace/registry.yaml - project-level decentralized agent registry index",
+  "version": "1.0.0",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+$",
+      "description": "Format version of the project registry (e.g. 1.0)"
+    },
+    "project": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string", "description": "Project name" },
+        "namespace": { "type": "string", "description": "Project namespace (e.g. team or org)" }
+      }
+    },
+    "local": {
+      "type": "array",
+      "description": "Agents defined in this repo (paths under .agents/)",
+      "items": {
+        "type": "object",
+        "required": ["name", "path"],
+        "properties": {
+          "name": { "type": "string", "description": "Agent name" },
+          "path": { "type": "string", "description": "Path to agent (e.g. .agents/my-agent)" }
+        }
+      }
+    },
+    "sources": {
+      "type": "array",
+      "description": "Remote registries to pull from (MCP endpoint + auth)",
+      "items": {
+        "type": "object",
+        "required": ["id", "type", "endpoint", "scope"],
+        "properties": {
+          "id": { "type": "string", "description": "Source identifier" },
+          "type": { "type": "string", "enum": ["mcp"], "description": "Source type (e.g. mcp)" },
+          "endpoint": { "type": "string", "format": "uri", "description": "Registry MCP endpoint URL" },
+          "auth": { "type": "string", "description": "Auth reference (e.g. ref:company-token)" },
+          "scope": {
+            "type": "string",
+            "enum": ["company", "department", "team", "project"],
+            "description": "Scope of this source"
+          }
+        }
+      }
+    },
+    "resolution_order": {
+      "type": "array",
+      "description": "Order for resolving agent name conflicts (first scope wins)",
+      "items": {
+        "type": "string",
+        "enum": ["project", "team", "department", "company"]
+      }
+    }
+  }
+}

package/dist/spec/registry/registry-spec.md

@@ -2122,14 +2122,14 @@ err = client.Publish(ctx, &registry.PublishRequest{
 
 ```bash
 # 1. Create agent directory
-mkdir my-agent && cd my-agent
+mkdir creative-agent-naming && cd creative-agent-naming
 
 # 2. Create manifest
 cat > agent.ossa.yaml <<EOF
 apiVersion: ossa/v0.3.0
 kind: Agent
 metadata:
-  name: my-agent
+  name: creative-agent-naming
   version: 1.0.0
   description: My first OSSA agent
 spec:
@@ -2142,7 +2142,7 @@ EOF
 # 3. Create package metadata
 cat > ossa.json <<EOF
 {
-  "name": "my-agent",
+  "name": "creative-agent-naming",
   "version": "1.0.0",
   "description": "My first OSSA agent",
   "license": "MIT",
@@ -2215,7 +2215,7 @@ ossa login --registry https://registry.internal.example.com
 ossa publish --registry https://registry.internal.example.com
 
 # Install from private registry
-ossa install my-agent --registry https://registry.internal.example.com
+ossa install creative-agent-naming --registry https://registry.internal.example.com
 ```
 
 ---

package/dist/spec/schema/components/adapter.schema.json

@@ -9,7 +9,7 @@
     "type": {
       "type": "string",
       "description": "Adapter type identifier (e.g., scm.github, runtime.kagent)",
-      "pattern": "^[a-z0-9]+(\.[a-z0-9]+)+$"
+      "pattern": "^[a-z0-9]+(\\.[a-z0-9]+)+$"
     },
     "version": {
       "type": "string",

package/dist/spec/schema/components/metadata.schema.json

@@ -30,6 +30,21 @@
       "type": "object",
       "additionalProperties": { "type": "string" },
       "description": "Key-value annotations for tooling"
+    },
+    "uuid": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Globally unique identifier for the agent"
+    },
+    "machine_name": {
+      "type": "string",
+      "pattern": "^[a-z0-9_]+$",
+      "description": "System-friendly identifier used by Drupal and other CMS"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "published", "deprecated", "revoked"],
+      "description": "Publication lifecycle status of the agent"
     }
   },
   "required": ["name", "version"],