@bluefly/openstandardagents 0.4.8 → 0.5.0

package/dist/data/platform-matrix.js

@@ -423,6 +423,35 @@ export const PLATFORM_MATRIX = [
         importHow: 'no',
         specUsage: ['Export produces Warp-compatible agent config from manifest.'],
     },
+    {
+        id: 'agentscope',
+        name: 'AgentScope',
+        description: 'AgentScope multi-agent Python framework with MCP tool integration, A2A support, and Mem0 memory',
+        status: 'beta',
+        whatTheyNeed: [
+            'Python 3.9+',
+            'AgentScope SDK (pip install agentscope)',
+            'LLM API key (OpenAI, Anthropic, etc.)',
+            'Optional: Mem0 for long-term memory',
+        ],
+        folderStructure: [
+            '.agents/{name}/manifest.ossa.yaml',
+            '.agents/{name}/src/ (Python agent code)',
+            'requirements.txt with agentscope',
+        ],
+        sdkNpm: [
+            'agentscope (PyPI)',
+            'agentscope[service] (with tool service)',
+        ],
+        exportHow: 'ossa export <manifest> --platform agentscope -o dist/',
+        importHow: 'partial',
+        specUsage: [
+            'Map spec.role to system message; spec.llm to model_config; spec.tools to service_toolkit.',
+            'extensions.agentscope.agent_class selects AgentScope agent type (ReActAgent, DialogAgent, etc.).',
+            'extensions.agentscope.memory_backend configures memory (mem0, local, etc.).',
+            'extensions.agentscope.orchestration selects multi-agent pattern (msghub, pipeline, etc.).',
+        ],
+    },
     {
         id: 'symfony',
         name: 'Symfony AI Agent',

package/dist/mcp-server/__tests__/mcp-server.spec.js

@@ -32,6 +32,15 @@ afterAll(async () => {
         fs.rmSync(tmpDir, { recursive: true, force: true });
     }
 });
+function readTextResource(content) {
+    if (typeof content.text === 'string') {
+        return content.text;
+    }
+    if (typeof content.blob === 'string') {
+        return Buffer.from(content.blob, 'base64').toString('utf8');
+    }
+    throw new Error('Expected text resource content');
+}
 describe('ossa_validate', () => {
     it('validates a valid manifest', async () => {
         const manifestPath = path.join(FIXTURE_DIR, 'compliance-auditor/manifest.ossa.yaml');
@@ -483,30 +492,30 @@ describe('MCP resources', () => {
             uri: 'ossa://template/minimal',
         });
         expect(result.contents.length).toBe(1);
-        expect(result.contents[0].text).toContain('apiVersion: ossa/v0.4');
-        expect(result.contents[0].text).toContain('kind: Agent');
+        expect(readTextResource(result.contents[0])).toContain('apiVersion: ossa/v0.4');
+        expect(readTextResource(result.contents[0])).toContain('kind: Agent');
     });
     it('reads full template with all sections', async () => {
         const result = await client.readResource({ uri: 'ossa://template/full' });
-        expect(result.contents[0].text).toContain('spec:');
-        expect(result.contents[0].text).toContain('tools:');
-        expect(result.contents[0].text).toContain('autonomy:');
-        expect(result.contents[0].text).toContain('extensions:');
-        expect(result.contents[0].text).toContain('token_efficiency:');
+        expect(readTextResource(result.contents[0])).toContain('spec:');
+        expect(readTextResource(result.contents[0])).toContain('tools:');
+        expect(readTextResource(result.contents[0])).toContain('autonomy:');
+        expect(readTextResource(result.contents[0])).toContain('extensions:');
+        expect(readTextResource(result.contents[0])).toContain('token_efficiency:');
     });
     it('reads MCP→OSSA→A2A guide', async () => {
         const result = await client.readResource({
             uri: 'ossa://guide/mcp-ossa-a2a',
         });
-        expect(result.contents[0].text).toContain('MCP');
-        expect(result.contents[0].text).toContain('OSSA');
-        expect(result.contents[0].text).toContain('A2A');
+        expect(readTextResource(result.contents[0])).toContain('MCP');
+        expect(readTextResource(result.contents[0])).toContain('OSSA');
+        expect(readTextResource(result.contents[0])).toContain('A2A');
     });
     it('reads supported platforms with SDK references', async () => {
         const result = await client.readResource({
             uri: 'ossa://platforms/supported',
         });
-        const platforms = JSON.parse(result.contents[0].text);
+        const platforms = JSON.parse(readTextResource(result.contents[0]));
         expect(platforms.total).toBeGreaterThanOrEqual(14);
         expect(platforms.platforms).toBeInstanceOf(Array);
         const openai = platforms.platforms.find((p) => p.id === 'openai');

package/dist/mesh/discovery-providers.js

@@ -237,7 +237,7 @@ export class ConsulDiscoveryProvider {
     }
     consulServiceToAgent(service) {
         return {
-            uri: service.Meta.uri || `agent://consul/${service.ID}`,
+            uri: service.Meta.uri || `uadp://consul/${service.ID}`,
             name: service.Service,
             version: service.Meta.version || '1.0.0',
             ossaVersion: service.Meta.ossaVersion || getApiVersion(),
@@ -372,7 +372,7 @@ export class KubernetesDiscoveryProvider {
         const labels = service.metadata.labels || {};
         return {
             uri: annotations['ossa.io/agent-uri'] ||
-                `agent://k8s/${service.metadata.name}`,
+                `uadp://k8s/${service.metadata.name}`,
             name: service.metadata.name,
             version: labels['app.kubernetes.io/version'] || '1.0.0',
             ossaVersion: annotations['ossa.io/version'] || getApiVersion(),

package/dist/mesh/discovery.js

@@ -201,7 +201,7 @@ export class AgentUriParser {
      * Build an agent URI from namespace and name
      */
     static build(namespace, name) {
-        return `agent://${namespace}/${name}`;
+        return `uadp://${namespace}/${name}`;
     }
     /**
      * Validate an agent URI

package/dist/mesh/index.d.ts

@@ -21,7 +21,7 @@
  *
  * // Define local agent
  * const localAgent = {
- *   uri: 'agent://team-a/my-agent',
+ *   uri: 'uadp://team-a/my-agent',
  *   name: 'My Agent',
  *   version: '1.0.0',
  *   ossaVersion: '0.3.0',
@@ -62,7 +62,7 @@
  *
  * // Request/response
  * const response = await client.request(
- *   'agent://team-b/analyzer',
+ *   'uadp://team-b/analyzer',
  *   { action: 'analyze', data: 'sample' }
  * );
  *

package/dist/mesh/index.js

@@ -21,7 +21,7 @@
  *
  * // Define local agent
  * const localAgent = {
- *   uri: 'agent://team-a/my-agent',
+ *   uri: 'uadp://team-a/my-agent',
  *   name: 'My Agent',
  *   version: '1.0.0',
  *   ossaVersion: '0.3.0',
@@ -62,7 +62,7 @@
  *
  * // Request/response
  * const response = await client.request(
- *   'agent://team-b/analyzer',
+ *   'uadp://team-b/analyzer',
  *   { action: 'analyze', data: 'sample' }
  * );
  *

package/dist/mesh/types.d.ts

@@ -45,7 +45,7 @@ export interface MessageEnvelope<T = unknown> {
     id: string;
     /** Message creation timestamp (ISO 8601) */
     timestamp: string;
-    /** Sender agent URI (format: agent://{namespace}/{name}) */
+    /** Sender agent URI (format: uadp://{namespace}/{name}) */
     from: string;
     /** Recipient agent URI or topic */
     to: string;
@@ -107,6 +107,8 @@ export interface AgentCard {
     name: string;
     version: string;
     ossaVersion: string;
+    uuid?: string;
+    gaid?: string;
     taxonomy?: AgentTaxonomy;
     capabilities: string[];
     tools?: ToolDescriptor[];
@@ -374,6 +376,205 @@ export interface AgentObservability {
         format?: string;
     };
 }
+/**
+ * Agent Taxonomy
+ * Classifies the agent by runtime platform, functional role, and architecture pattern.
+ */
+export interface AgentTaxonomy {
+    /** Runtime platform: claude, kagent, openai, langchain, crewai, etc. */
+    agentType?: string;
+    /** Functional role: orchestrator, worker, reviewer, analyzer, etc. */
+    agentKind?: string;
+    /** Architecture pattern and capabilities */
+    architecture?: {
+        /** Pattern: swarm, pipeline, tree, graph, etc. */
+        pattern?: string;
+        /** Architecture capabilities: handoff, streaming, context, tools, vision */
+        capabilities?: string[];
+        /** Coordination strategy */
+        coordination?: {
+            handoffStrategy?: string;
+            maxDepth?: number;
+        };
+        /** Runtime characteristics */
+        runtime?: {
+            scalability?: string;
+            executionModel?: string;
+            preferredRegion?: string;
+        };
+    };
+}
+/**
+ * Agent Model Info
+ * LLM configuration powering this agent.
+ */
+export interface AgentModelInfo {
+    provider?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+}
+/**
+ * MCP Server Descriptor
+ * Model Context Protocol server this agent connects to.
+ */
+export interface McpServerDescriptor {
+    name: string;
+    description?: string;
+    transport?: {
+        type: string;
+        command?: string;
+        args?: string[];
+        url?: string;
+    };
+    version?: string;
+    capabilities?: {
+        resources?: {
+            subscribe?: boolean;
+            listChanged?: boolean;
+        };
+        tools?: {
+            listChanged?: boolean;
+        };
+        logging?: {
+            enabled?: boolean;
+            level?: string;
+        };
+    };
+    resources?: McpResourceDescriptor[];
+}
+/**
+ * MCP Resource Descriptor
+ */
+export interface McpResourceDescriptor {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * A2A Protocol Descriptor
+ * How this agent communicates with other agents.
+ */
+export interface A2AProtocolDescriptor {
+    /** Protocol type and version */
+    protocol?: {
+        type?: string;
+        version?: string;
+        messageFormat?: string;
+    };
+    /** Connected agent endpoints */
+    agentEndpoints?: Array<{
+        agentId: string;
+        url: string;
+        capabilities?: string[];
+        priority?: number;
+    }>;
+    /** Routing configuration */
+    routing?: {
+        strategy?: string;
+        rules?: Array<{
+            name: string;
+            condition: string;
+            target: string;
+            priority?: number;
+        }>;
+    };
+    /** Delegation and handoff rules */
+    delegation?: {
+        enabled?: boolean;
+        maxDepth?: number;
+        timeout?: number;
+        handoffRules?: Array<{
+            name: string;
+            condition: string;
+            target: string;
+            message?: string;
+        }>;
+    };
+    /** Completion signals */
+    completionSignals?: {
+        signals?: string[];
+        handlers?: Array<{
+            signal: string;
+            action: string;
+            target?: string;
+        }>;
+    };
+    /** Retry policy */
+    retryPolicy?: {
+        maxRetries?: number;
+        backoff?: string;
+        retryableErrors?: string[];
+    };
+    /** Circuit breaker */
+    circuitBreaker?: {
+        enabled?: boolean;
+        failureThreshold?: number;
+        timeout?: number;
+    };
+}
+/**
+ * Agent Handoff
+ * Direct delegation targets from spec.handoffs.
+ */
+export interface AgentHandoff {
+    to: string;
+    condition?: string;
+}
+/**
+ * Agent Autonomy
+ * How independently this agent operates.
+ */
+export interface AgentAutonomy {
+    level?: string;
+    approvalRequired?: boolean;
+    allowedActions?: string[];
+    blockedActions?: string[];
+}
+/**
+ * Agent Constraints
+ * Operational limits for cost, performance, and resources.
+ */
+export interface AgentConstraints {
+    cost?: {
+        maxTokensPerDay?: number;
+        maxTokensPerRequest?: number;
+        maxCostPerDay?: number;
+        currency?: string;
+    };
+    performance?: {
+        maxLatencySeconds?: number;
+        maxConcurrentRequests?: number;
+        timeoutSeconds?: number;
+    };
+    resources?: {
+        cpu?: string;
+        memory?: string;
+    };
+}
+/**
+ * Agent Observability
+ * Tracing, metrics, and logging configuration.
+ */
+export interface AgentObservability {
+    tracing?: {
+        enabled?: boolean;
+        exporter?: string;
+        endpoint?: string;
+        samplingRate?: number;
+    };
+    metrics?: {
+        enabled?: boolean;
+        exporter?: string;
+        endpoint?: string;
+    };
+    logging?: {
+        level?: string;
+        format?: string;
+    };
+}
 /**
  * Tool Descriptor
  */

package/dist/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "exports": {
-    "./schema": "./spec/v0.4/agent.schema.json",
+    "./schema": "./spec/v0.5/agent.schema.json",
     "./schema/v0.4": "./spec/v0.4/agent.schema.json",
     "./schema/v0.4.1": "./spec/v0.4/agent.schema.json",
+    "./schema/v0.5": "./spec/v0.5/agent.schema.json",
+    "./schema/v0.5.0": "./spec/v0.5/agent.schema.json",
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
@@ -46,7 +48,7 @@
       "import": "./dist/services/agent-card-generator.js",
       "require": "./dist/services/agent-card-generator.js"
     },
-    "./agent-card-schema": "./spec/v0.4/agent-card.schema.json",
+    "./agent-card-schema": "./spec/v0.5/agent-card.schema.json",
     "./sdk": {
       "types": "./dist/sdk.d.ts",
       "import": "./dist/sdk.js",
@@ -142,7 +144,7 @@
   },
   "homepage": "https://openstandardagents.org",
   "scripts": {
-    "// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500": "",
+    "// ─────────────────────────────────────────────────────────────────────────────": "",
     "// BUILD & DEVELOPMENT": "",
     "mcp": "node dist/mcp-server/index.js",
     "prebuild": "npm run docs:process",
@@ -150,8 +152,9 @@
     "build:assets": "cp -r spec dist/ && cp package.json .version.json dist/",
     "build:clean": "npm run clean && npm run build",
     "dev": "tsc --watch",
-    "clean": "rm -rf dist coverage .tsbuildinfo",
+    "clean": "node -e \"const fs=require('node:fs'); ['dist','coverage','.tsbuildinfo'].forEach((p)=>fs.rmSync(p,{recursive:true,force:true}))\"",
     "// TESTING": "",
+    "pretest": "npm run build",
     "test": "jest",
     "test:unit": "jest tests/unit --forceExit",
     "test:integration": "jest tests/integration",
@@ -185,7 +188,7 @@
     "validate:sdk:python": "cd src/sdks/python && python -m pip install --quiet -e . && python -m pytest tests/ -v || true",
     "validate:schema": "npx ajv-cli compile -s $(node -p \"require('./.version.json').spec_path\")/$(node -p \"require('./.version.json').schema_file\") -r $(node -p \"require('./.version.json').spec_path\")/extensions/kagent/kagent.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/mcp/mcp.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/a2a/a2a.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/langchain/langchain.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/langgraph/langgraph.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/ag2/ag2.schema.json -r $(node -p \"require('./.version.json').spec_path\")/extensions/crewai/crewai.schema.json --strict=false --allow-union-types",
     "validate:manifest": "npx ajv-cli validate -s $(node -p \"require('./.version.json').spec_path\")/$(node -p \"require('./.version.json').schema_file\") --strict=false --allow-union-types -d",
-    "validate:examples": "find examples \\( -name '*.ossa.yaml' -o -name '*.ossa.yml' \\) | grep -v 'swarm-to-ossa' | head -20 | xargs -I {} npm run validate:manifest -- {} || true",
+    "validate:examples": "tsx src/tools/validation/validate-examples.ts",
     "validate:versions": "tsx src/tools/validate-versions.ts",
     "fix:versions": "tsx src/tools/fix-versions.ts",
     "validate:power": "tsx src/tools/validation/validate-ossa.ts",
@@ -238,16 +241,17 @@
     "@anthropic-ai/claude-agent-sdk": "^0.2.50",
     "@anthropic-ai/sdk": "^0.71.0",
     "@aws-sdk/client-bedrock-runtime": "^3.955.0",
+    "@cedar-policy/cedar-wasm": "^4.9.1",
     "@gitbeaker/node": "^35.8.1",
     "@gitbeaker/rest": "^43.8.0",
     "@google/generative-ai": "^0.21.0",
     "@langchain/anthropic": "^0.3.10",
     "@langchain/core": "^0.3.29",
     "@langchain/openai": "^0.3.17",
-    "@modelcontextprotocol/sdk": "^0.6.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@noble/ed25519": "^2.3.0",
     "@octokit/rest": "^20.0.0",
-    "@openai/agents": "^0.4.6",
+    "@openai/agents": "^0.7.1",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-jaeger": "^1.28.0",
     "@opentelemetry/exporter-logs-otlp-http": "^0.211.0",
@@ -260,7 +264,7 @@
     "@opentelemetry/sdk-metrics": "^2.5.0",
     "@opentelemetry/sdk-node": "^0.54.0",
     "@opentelemetry/sdk-trace-base": "^1.28.0",
-    "@qdrant/js-client-rest": "^1.9.0",
+    "@qdrant/js-client-rest": "^1.17.0",
     "@temporalio/activity": "^1.11.3",
     "@temporalio/workflow": "^1.11.3",
     "@types/tar": "^6.1.13",
@@ -293,7 +297,7 @@
     "readline": "^1.3.0",
     "reflect-metadata": "^0.2.2",
     "semver": "^7.7.3",
-    "tar": "^7.5.3",
+    "tar": "^7.5.11",
     "uuid": "^11.0.5",
     "web-did-resolver": "^2.0.32",
     "ws": "^8.19.0",
@@ -301,6 +305,7 @@
     "zod": "^4.1.11"
   },
   "devDependencies": {
+    "@bluefly/duadp": "^0.1.4",
     "@jest/globals": "^29.7.0",
     "@octokit/rest": "^22.0.1",
     "@semantic-release/changelog": "^6.0.3",
@@ -342,12 +347,8 @@
     "vitest": "^2.1.8"
   },
   "optionalDependencies": {
-    "nodemailer": "^6.9.0"
+    "nodemailer": "^8.0.2"
   },
-  "bundledDependencies": [
-    "ajv",
-    "ajv-formats"
-  ],
   "engines": {
     "node": ">=20.0.0",
     "npm": ">=10.0.0"
@@ -356,8 +357,14 @@
     "node": "22.19.0",
     "npm": "11.10.0"
   },
-  "bundleDependencies": [
-    "ajv",
-    "ajv-formats"
-  ]
-}
+  "overrides": {
+    "@hono/node-server": "^1.19.10",
+    "express-rate-limit": "^8.2.2",
+    "hono": "^4.12.7",
+    "langsmith": "^0.4.6",
+    "fast-xml-parser": "^5.3.8",
+    "@langchain/anthropic": {
+      "fast-xml-parser": "^4.5.4"
+    }
+  }
+}

package/dist/services/agent-card-generator.d.ts

@@ -16,10 +16,10 @@
  * - manifestRef, manifestDigest: options or metadata.manifest_ref, metadata.manifest_digest
  * - tokenEfficiencySummary: top-level token_efficiency
  */
-import type { OssaAgent } from '../types/index.js';
 import type { AgentCard } from '../mesh/types.js';
+import type { OssaAgent } from '../types/index.js';
 export interface AgentCardGeneratorOptions {
-    /** Override the agent URI (default: agent://{namespace}/{name}) */
+    /** Override the agent URI (default: uadp://{namespace}/{name}) */
     uri?: string;
     /** Namespace for the agent URI (default: 'default') */
     namespace?: string;

package/dist/services/agent-card-generator.js

@@ -49,7 +49,7 @@ export class AgentCardGenerator {
         const name = manifest.metadata.name;
         const version = manifest.metadata?.version || '1.0.0';
         const namespace = options?.namespace || 'default';
-        const uri = options?.uri || `agent://${namespace}/${name}`;
+        const uri = options?.uri || `uadp://${namespace}/${name}`;
         // Extract all features
         const taxonomy = this.extractTaxonomy(manifest);
         const capabilities = this.extractCapabilities(manifest, taxonomy);
@@ -88,6 +88,8 @@ export class AgentCardGenerator {
             name,
             version,
             ossaVersion: manifest.apiVersion || 'ossa/v0.4',
+            ...(manifest.metadata?.identity?.uuid ? { uuid: manifest.metadata.identity.uuid } : {}),
+            ...(manifest.metadata?.identity?.gaid ? { gaid: manifest.metadata.identity.gaid } : {}),
             // Taxonomy — what kind of agent
             ...(taxonomy ? { taxonomy } : {}),
             // Capabilities & tools

package/dist/services/agents-md/agents-md.service.d.ts

@@ -7,6 +7,10 @@ import type { OssaAgent } from '../../types/index.js';
  * Service for generating and managing agents.md files from OSSA manifests
  */
 export declare class AgentsMdService {
+    /**
+     * Append optional configured block content to a generated section.
+     */
+    private addOptionalBlock;
     /**
      * Generate AGENTS.md content from OSSA manifest
      * @param manifest - OSSA agent manifest

package/dist/services/agents-md/agents-md.service.js

@@ -15,6 +15,15 @@ import { watch } from 'fs';
  * Service for generating and managing agents.md files from OSSA manifests
  */
 let AgentsMdService = class AgentsMdService {
+    /**
+     * Append optional configured block content to a generated section.
+     */
+    addOptionalBlock(lines, content) {
+        if (!content?.trim()) {
+            return;
+        }
+        lines.push('', content);
+    }
     /**
      * Generate AGENTS.md content from OSSA manifest
      * @param manifest - OSSA agent manifest
@@ -61,9 +70,11 @@ let AgentsMdService = class AgentsMdService {
      */
     generateDevEnvironmentSection(manifest, config) {
         const lines = ['# Dev environment tips'];
+        this.addOptionalBlock(lines, config?.prepend);
         // Use custom content if provided
         if (config?.custom) {
             lines.push('', config.custom);
+            this.addOptionalBlock(lines, config?.append);
             return lines.join('\n');
         }
         // Derive from spec.tools if source is specified
@@ -92,6 +103,7 @@ let AgentsMdService = class AgentsMdService {
             lines.push('- Ensure all required dependencies are installed');
             lines.push('- Configure environment variables as needed');
         }
+        this.addOptionalBlock(lines, config?.append);
         return lines.join('\n');
     }
     /**
@@ -99,9 +111,11 @@ let AgentsMdService = class AgentsMdService {
      */
     generateTestingSection(manifest, config) {
         const lines = ['# Testing instructions'];
+        this.addOptionalBlock(lines, config?.prepend);
         // Use custom content if provided
         if (config?.custom) {
             lines.push('', config.custom);
+            this.addOptionalBlock(lines, config?.append);
             return lines.join('\n');
         }
         // Derive from spec.constraints if source is specified
@@ -133,6 +147,7 @@ let AgentsMdService = class AgentsMdService {
             lines.push('- Ensure code coverage meets project standards');
             lines.push('- Validate against OSSA schema: `ossa validate manifest.yaml`');
         }
+        this.addOptionalBlock(lines, config?.append);
         return lines.join('\n');
     }
     /**
@@ -140,9 +155,11 @@ let AgentsMdService = class AgentsMdService {
      */
     generatePRInstructionsSection(manifest, config) {
         const lines = ['# PR instructions'];
+        this.addOptionalBlock(lines, config?.prepend);
         // Use custom content if provided
         if (config?.custom) {
             lines.push('', config.custom);
+            this.addOptionalBlock(lines, config?.append);
             return lines.join('\n');
         }
         // Derive from spec.autonomy if source is specified
@@ -176,6 +193,7 @@ let AgentsMdService = class AgentsMdService {
             lines.push('- Update documentation as needed');
             lines.push('- Ensure CI passes before requesting review');
         }
+        this.addOptionalBlock(lines, config?.append);
         return lines.join('\n');
     }
     /**

package/dist/services/export/langchain/langchain-exporter.js

@@ -628,7 +628,7 @@ services:
 `;
         }
         else if (memoryBackend === 'postgres') {
-            compose += `      - POSTGRES_URL=postgresql://postgres:postgres@postgres:5432/agent_memory
+            compose += `      - POSTGRES_URL=postgresql://postgres:\${POSTGRES_PASSWORD}@postgres:5432/agent_memory
     depends_on:
       - postgres
 
@@ -661,7 +661,7 @@ volumes:
             '',
             '# Memory Backend',
             'REDIS_URL=redis://localhost:6379',
-            'POSTGRES_URL=postgresql://postgres:postgres@localhost:5432/agent_memory',
+            'POSTGRES_URL=postgresql://postgres:${POSTGRES_PASSWORD}@localhost:5432/agent_memory',
             '',
             '# API Configuration',
             'API_PORT=8000',

package/dist/services/export/langchain/memory-generator.js

@@ -815,7 +815,7 @@ def _get_pg_pool():
 
     postgres_url = os.getenv(
         "POSTGRES_URL",
-        "postgresql://postgres:postgres@localhost:5432/agent_memory"
+        "postgresql://postgres:your-password-here@localhost:5432/agent_memory"
     )
 
     if _pg_pool is None:
@@ -943,7 +943,7 @@ def get_memory(session_id: str = "default") -> ConversationBufferMemory:
 
         postgres_url = os.getenv(
             "POSTGRES_URL",
-            "postgresql://postgres:postgres@localhost:5432/agent_memory"
+            "postgresql://postgres:your-password-here@localhost:5432/agent_memory"
         )
 
         message_history = PostgresChatMessageHistory(