@bluefly/openstandardagents 0.4.6 → 0.4.8

package/.version.json

@@ -1,7 +1,7 @@
 {
-  "current": "0.4.6",
-  "latest_stable": "0.4.6",
-  "spec_version": "0.4.6",
+  "current": "0.4.7",
+  "latest_stable": "0.4.7",
+  "spec_version": "0.4.7",
   "spec_path": "spec/v0.4",
   "schema_file": "agent.schema.json"
 }

package/CHANGELOG.md

@@ -7,8 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- **AgentScope integration**: Add AgentScope as supported agent framework with Python adapter, Drupal module, MCP server, A2A endpoint, and example manifests
+
+## [0.4.7] - 2026-03-06
+
+### Fixed
+- **CLI broken import**: Removed `!dist/services/release-automation/` from package `files` exclusion — the core CLI (`release.command.ts`) imports `ReleaseAgentService` from that directory, so excluding it broke `ossa release` at runtime in v0.4.6
+
 ## [0.4.6] - 2026-03-05
 
+### Added
+- **`ossa config` command** — Get/set CLI config persisted to `~/.ossa/config.json` (overridable with `OSSA_CONFIG_PATH`). Env vars override config when running commands.
+  - `ossa config set <key> <value>` — set a key (e.g. `SKILLS_PATH`, `BLUEFLY_SKILLS_CATALOG`)
+  - `ossa config get [key]` — get value or config file path
+  - `ossa config list` — list all keys in config file
+  - `ossa config unset <key>` — remove key from config file
+- **Config-driven skills path** — `ossa skills add` and both wizards (interactive and API-first) resolve the default skills directory from config file then env (`SKILLS_PATH`, `BLUEFLY_SKILLS_PATH`), then `~/.claude/skills`. Use `ossa config set SKILLS_PATH /path/to/skills` so you no longer need to set env or pass `--path` every time.
+
 ### Changed
 - Updated package version from 0.4.5 to 0.4.6
 - Updated all version references throughout codebase

package/README.md

@@ -473,6 +473,7 @@ ossa export --list-platforms
 | `claude-skills` | beta | 3 files | - | Claude Skills format with team support |
 | `mobile-agent` | alpha | 1 file | - | Mobile LLM platform export |
 | `symfony` | alpha | 1 file | - | Symfony bundle for PHP-based agents |
+| `agentscope` | alpha | 10 files | agentscope | AgentScope ReAct assistant for Drupal AI Agents |
 
 Every export includes `agent.ossa.yaml` (the source manifest) for provenance.
 

package/dist/.version.json

@@ -1,7 +1,7 @@
 {
-  "current": "0.4.6",
-  "latest_stable": "0.4.6",
-  "spec_version": "0.4.6",
+  "current": "0.4.7",
+  "latest_stable": "0.4.7",
+  "spec_version": "0.4.7",
   "spec_path": "spec/v0.4",
   "schema_file": "agent.schema.json"
 }

package/dist/adapters/mcp/converter.js

@@ -1,5 +1,6 @@
-// OSSA v{{VERSION}} - MCP (Model Context Protocol) Export Adapter
+// OSSA - MCP (Model Context Protocol) Export Adapter
 import { BaseAdapter, } from '../base/adapter.interface.js';
+import { SPEC_VERSION } from '../../version.js';
 /**
  * MCP export adapter - generates JSON-RPC 2.0 MCP servers
  * Compatible with Claude Code, Cursor, and other MCP clients
@@ -9,9 +10,9 @@ export class MCPAdapter extends BaseAdapter {
     displayName = 'MCP Server';
     description = 'Export OSSA agents as Model Context Protocol servers';
     status = 'production';
-    supportedVersions = ['0.3.6', '0.4.x', '0.4.6'];
+    supportedVersions = ['0.3.6', '0.4.x', SPEC_VERSION];
     version = '1.0.0';
-    supportedOssaVersions = ['0.3.6', '0.4.x', '0.4.6'];
+    supportedOssaVersions = ['0.3.6', '0.4.x', SPEC_VERSION];
     outputFormat = ['typescript'];
     async export(manifest, options) {
         return this.convert(manifest, options || {});

package/dist/adapters/npm/adapter.js

@@ -6,6 +6,7 @@
  * DRY: Uses shared libraries for license, validation, README, package.json
  */
 import { getApiVersion } from '../../utils/version.js';
+import { SPEC_VERSION } from '../../version.js';
 import { BaseAdapter } from '../base/adapter.interface.js';
 import { generateLicense, generateReadme, sanitizePackageName, } from '../base/common-file-generator.js';
 import { isValidSemver } from '../base/manifest-validator.js';
@@ -18,7 +19,7 @@ export class NPMAdapter extends BaseAdapter {
     displayName = 'NPM Package';
     description = 'Export agent as installable npm package';
     status = 'production';
-    supportedVersions = ['v0.3.6', 'v0.4.x', 'v0.4.6'];
+    supportedVersions = ['v0.3.6', 'v0.4.x', `v${SPEC_VERSION}`];
     converter = new NPMConverter();
     _skillsService;
     /**

package/dist/adapters/openai-agents/adapter.js

@@ -62,7 +62,7 @@ export class OpenAIAgentsAdapter extends BaseAdapter {
             files.push(this.createManifestFile(manifest));
             return this.createResult(true, files, undefined, {
                 duration: Date.now() - startTime,
-                version: '0.4.6',
+                version: SPEC_VERSION,
                 warnings: [],
             });
         }

package/dist/cli/commands/config.command.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ossa config set <key> <value> | get [key] | list | unset <key>
+ * Persists to ~/.ossa/config.json. process.env overrides config file when reading.
+ */
+import { Command } from 'commander';
+export declare const configCommand: Command;
+//# sourceMappingURL=config.command.d.ts.map

package/dist/cli/commands/config.command.js

@@ -0,0 +1,92 @@
+/**
+ * ossa config set <key> <value> | get [key] | list | unset <key>
+ * Persists to ~/.ossa/config.json. process.env overrides config file when reading.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getConfigPath, getConfigValue, setConfigValue, unsetConfigValue, listConfig, } from '../../config/cli-config.js';
+export const configCommand = new Command('config')
+    .description('Get or set OSSA CLI config (stored in ~/.ossa/config.json). Env vars override config when running commands.')
+    .configureHelp({ sortSubcommands: true });
+configCommand
+    .command('set <key> <value>')
+    .description('Set a config key (e.g. SKILLS_PATH, BLUEFLY_SKILLS_CATALOG)')
+    .action((key, value) => {
+    if (!key || !value) {
+        console.error(chalk.red('Usage: ossa config set <key> <value>'));
+        process.exit(1);
+    }
+    setConfigValue(key, value);
+    console.log(chalk.gray(`Config: ${getConfigPath()}`));
+    console.log(chalk.green(`${key}=${value}`));
+});
+configCommand
+    .command('get [key]')
+    .description('Get a config value (env overrides file). Omit key to show config path.')
+    .action((key) => {
+    if (!key) {
+        console.log(getConfigPath());
+        return;
+    }
+    const v = getConfigValue(key);
+    if (v === undefined || v === '') {
+        console.log('');
+        process.exit(1);
+    }
+    console.log(v);
+});
+configCommand
+    .command('list')
+    .description('List all keys and values stored in the config file')
+    .option('-q, --quiet', 'Only print keys')
+    .action((opts) => {
+    const data = listConfig();
+    const keys = Object.keys(data).sort();
+    if (keys.length === 0) {
+        console.log(chalk.gray('No keys in config file. Use: ossa config set SKILLS_PATH <path>'));
+        console.log(chalk.gray('Config path: ' + getConfigPath()));
+        return;
+    }
+    if (opts.quiet) {
+        keys.forEach((k) => console.log(k));
+        return;
+    }
+    console.log(chalk.gray('Config: ' + getConfigPath() + '\n'));
+    keys.forEach((k) => {
+        const val = data[k];
+        const display = val.length > 60 ? val.slice(0, 57) + '...' : val;
+        console.log(`  ${chalk.cyan(k)}=${display}`);
+    });
+});
+configCommand
+    .command('unset <key>')
+    .description('Remove a key from the config file')
+    .action((key) => {
+    const removed = unsetConfigValue(key);
+    if (removed) {
+        console.log(chalk.green(`Removed ${key}`));
+    }
+    else {
+        console.log(chalk.yellow(`Key not in config: ${key}`));
+        process.exit(1);
+    }
+});
+configCommand.addHelpText('after', `
+Known keys (you can set any key; these are commonly used):
+  SKILLS_PATH              Directory for skills add/list (e.g. /Volumes/AgentPlatform/services/marketplace/skills)
+  BLUEFLY_SKILLS_MARKETPLACE   Set to 1 to prefer marketplace skills path in MCP
+  BLUEFLY_SKILLS_CATALOG   Path to marketplace-skills-catalog.json
+  BLUEFLY_SKILLS_PATH      Alias for skills path
+  OSSA_WEBAGENTS_API_URL   OSSA UI / agent builder API base URL
+  OSSA_CONFIG_PATH         Override config file path
+  MCP_URL                  MCP server URL
+  GITLAB_URL               GitLab instance URL
+  GITLAB_TOKEN             GitLab token (prefer env for secrets)
+
+Examples:
+  ossa config set SKILLS_PATH /Volumes/AgentPlatform/services/marketplace/skills
+  ossa config get SKILLS_PATH
+  ossa config list
+  ossa config unset SKILLS_PATH
+`);
+//# sourceMappingURL=config.command.js.map

package/dist/cli/commands/migrate.command.js

@@ -17,7 +17,7 @@ import { addGlobalOptions, addMutationOptions, shouldUseColor, ExitCode, } from
 export const migrateCommand = new Command('migrate')
     .description('Migrate OSSA manifests between spec versions')
     .argument('<source>', 'Path to source OSSA manifest file')
-    .option('--to <version>', 'Target OSSA version (e.g., 0.3.6, 0.4.6)', getVersion())
+    .option('--to <version>', 'Target OSSA version (e.g., 0.3.6, 0.4.x)', getVersion())
     .option('--list', 'List available migration transforms')
     .option('--validate', 'Validate converted manifest', true);
 // Apply production-grade standard options

package/dist/cli/commands/sign.command.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const signCommand: Command;
+//# sourceMappingURL=sign.command.d.ts.map

package/dist/cli/commands/sign.command.js

@@ -0,0 +1,42 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as yaml from 'js-yaml';
+import * as path from 'path';
+import { signAgentManifest } from '../../services/trust/trust.service.js';
+export const signCommand = new Command('sign')
+    .description('Cryptographically sign an OSSA manifest using an Ed25519 private key')
+    .argument('<manifest>', 'Path to the OSSA manifest file (.yaml or .json)')
+    .requiredOption('-k, --private-key <hex>', 'Ed25519 private key in hex format')
+    .option('-i, --issuer <did>', 'Optional DID of the signing entity (e.g. did:web:example.com)')
+    .option('-o, --output <file>', 'Optional output file path. Defaults to overwriting the input file.')
+    .action(async (manifestPath, options) => {
+    try {
+        const fullPath = path.resolve(process.cwd(), manifestPath);
+        if (!fs.existsSync(fullPath)) {
+            console.error(`Error: Manifest file not found at ${fullPath}`);
+            process.exit(1);
+        }
+        const isJson = fullPath.endsWith('.json');
+        const content = fs.readFileSync(fullPath, 'utf-8');
+        let manifest;
+        try {
+            manifest = isJson ? JSON.parse(content) : yaml.load(content);
+        }
+        catch (e) {
+            console.error(`Error parsing manifest: ${e instanceof Error ? e.message : 'Unknown error'}`);
+            process.exit(1);
+        }
+        const signedManifest = await signAgentManifest(manifest, options.privateKey, options.issuer);
+        const outputContent = isJson
+            ? JSON.stringify(signedManifest, null, 2)
+            : yaml.dump(signedManifest, { noRefs: true, indent: 2 });
+        const outputPath = options.output ? path.resolve(process.cwd(), options.output) : fullPath;
+        fs.writeFileSync(outputPath, outputContent, 'utf-8');
+        console.log(`Successfully signed manifest. Output saved to ${outputPath}`);
+    }
+    catch (e) {
+        console.error(`Error signing manifest: ${e instanceof Error ? e.message : 'Unknown error'}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=sign.command.js.map

package/dist/cli/commands/skills.command.js

@@ -7,10 +7,11 @@ import { Command } from 'commander';
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import { z } from 'zod';
+import { getSkillsPathDefault } from '../../config/cli-config.js';
 import { container } from '../../di-container.js';
 import { ManifestRepository } from '../../repositories/manifest.repository.js';
+import { SkillsExportService, SkillsGeneratorService, SkillsInstallService, SkillsResearchService, } from '../../services/skills-pipeline/index.js';
 import { ClaudeSkillsService } from '../../services/skills/claude-skills.service.js';
-import { SkillsResearchService, SkillsGeneratorService, SkillsExportService, SkillsInstallService, } from '../../services/skills-pipeline/index.js';
 const AgentPathSchema = z.string().min(1);
 const SkillPathSchema = z.string().min(1);
 /** Parse skills.sh URL into GitHub repo URL + skill name. e.g. https://skills.sh/sparkfabrik/sf-awesome-copilot/drupal-cache-maxage -> { repoUrl, skill } */
@@ -179,17 +180,14 @@ skillsCommandGroup
 skillsCommandGroup
     .command('add <repo-url>')
     .option('--skill <name>', 'Skill name (subdir in repo, e.g. drupal-cache-maxage). Not needed when repo-url is a skills.sh URL.', '')
-    .option('--path <dir>', 'Target directory to install into', process.env.SKILLS_PATH ||
-    (process.env.HOME
-        ? `${process.env.HOME}/.claude/skills`
-        : '.claude/skills'))
+    .option('--path <dir>', 'Target directory to install into (default: config SKILLS_PATH or ~/.claude/skills)', '')
     .option('--ref <ref>', 'Git ref (branch/tag/sha)', 'HEAD')
     .option('--dry-run', 'Show what would be installed without writing', false)
     .description('Install a Claude Skill from a GitHub repo or from skills.sh URL')
     .action(async (repoUrl, options) => {
     try {
         const installService = container.get(SkillsInstallService);
-        const targetPath = options.path;
+        const targetPath = options.path || getSkillsPathDefault();
         let resolvedRepoUrl = repoUrl;
         let resolvedSkill = options.skill ?? '';
         const skillsSh = parseSkillsShUrl(repoUrl);

package/dist/config/cli-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * OSSA CLI config file (e.g. ~/.ossa/config.json).
+ * Values here override defaults; process.env overrides config file.
+ * Use: ossa config set SKILLS_PATH /path/to/skills
+ */
+export type ConfigRecord = Record<string, string>;
+/**
+ * Config file path (for display).
+ */
+export declare function getConfigPath(): string;
+/**
+ * Get a config value. Resolution: process.env[key] then config file.
+ */
+export declare function getConfigValue(key: string): string | undefined;
+/**
+ * Set a config value (writes to config file). Does not set process.env.
+ */
+export declare function setConfigValue(key: string, value: string): void;
+/**
+ * Remove a key from the config file.
+ */
+export declare function unsetConfigValue(key: string): boolean;
+/**
+ * List all keys and values from the config file (not env).
+ */
+export declare function listConfig(): ConfigRecord;
+/** Known keys documented in `ossa config --help`. */
+export declare const KNOWN_KEYS: readonly ["SKILLS_PATH", "BLUEFLY_SKILLS_MARKETPLACE", "BLUEFLY_SKILLS_CATALOG", "BLUEFLY_SKILLS_PATH", "OSSA_WEBAGENTS_API_URL", "OSSA_CONFIG_PATH", "MCP_URL", "GITLAB_URL", "GITLAB_TOKEN"];
+/**
+ * Default directory for skills add/list. Resolution: config SKILLS_PATH, then env SKILLS_PATH/BLUEFLY_SKILLS_PATH, then ~/.claude/skills.
+ */
+export declare function getSkillsPathDefault(): string;
+//# sourceMappingURL=cli-config.d.ts.map

package/dist/config/cli-config.js

@@ -0,0 +1,107 @@
+/**
+ * OSSA CLI config file (e.g. ~/.ossa/config.json).
+ * Values here override defaults; process.env overrides config file.
+ * Use: ossa config set SKILLS_PATH /path/to/skills
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir } from 'os';
+const OSSA_DIR = process.env.OSSA_CONFIG_DIR || path.join(homedir(), '.ossa');
+const CONFIG_FILE = process.env.OSSA_CONFIG_PATH || path.join(OSSA_DIR, 'config.json');
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function loadRaw() {
+    if (!fs.existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        const raw = fs.readFileSync(CONFIG_FILE, 'utf-8');
+        const data = JSON.parse(raw);
+        if (data && typeof data === 'object' && !Array.isArray(data)) {
+            const out = {};
+            for (const [k, v] of Object.entries(data)) {
+                if (typeof v === 'string')
+                    out[k] = v;
+                else if (v != null)
+                    out[k] = String(v);
+            }
+            return out;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return {};
+}
+function saveRaw(data) {
+    ensureDir(path.dirname(CONFIG_FILE));
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Config file path (for display).
+ */
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+/**
+ * Get a config value. Resolution: process.env[key] then config file.
+ */
+export function getConfigValue(key) {
+    const envVal = process.env[key];
+    if (envVal !== undefined && envVal !== '') {
+        return envVal;
+    }
+    const data = loadRaw();
+    return data[key];
+}
+/**
+ * Set a config value (writes to config file). Does not set process.env.
+ */
+export function setConfigValue(key, value) {
+    const data = loadRaw();
+    data[key] = value;
+    saveRaw(data);
+}
+/**
+ * Remove a key from the config file.
+ */
+export function unsetConfigValue(key) {
+    const data = loadRaw();
+    if (!(key in data))
+        return false;
+    delete data[key];
+    saveRaw(data);
+    return true;
+}
+/**
+ * List all keys and values from the config file (not env).
+ */
+export function listConfig() {
+    return loadRaw();
+}
+/** Known keys documented in `ossa config --help`. */
+export const KNOWN_KEYS = [
+    'SKILLS_PATH',
+    'BLUEFLY_SKILLS_MARKETPLACE',
+    'BLUEFLY_SKILLS_CATALOG',
+    'BLUEFLY_SKILLS_PATH',
+    'OSSA_WEBAGENTS_API_URL',
+    'OSSA_CONFIG_PATH',
+    'MCP_URL',
+    'GITLAB_URL',
+    'GITLAB_TOKEN',
+];
+/**
+ * Default directory for skills add/list. Resolution: config SKILLS_PATH, then env SKILLS_PATH/BLUEFLY_SKILLS_PATH, then ~/.claude/skills.
+ */
+export function getSkillsPathDefault() {
+    return (getConfigValue('SKILLS_PATH') ||
+        getConfigValue('BLUEFLY_SKILLS_PATH') ||
+        process.env.SKILLS_PATH ||
+        process.env.BLUEFLY_SKILLS_PATH ||
+        (process.env.HOME ? `${process.env.HOME}/.claude/skills` : '.claude/skills'));
+}
+//# sourceMappingURL=cli-config.js.map

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluefly/openstandardagents",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "exports": {
     "./schema": "./spec/v0.4/agent.schema.json",
     "./schema/v0.4": "./spec/v0.4/agent.schema.json",
@@ -114,7 +114,6 @@
   "files": [
     "dist/",
     "!dist/dev-cli/",
-    "!dist/services/release-automation/",
     "!dist/sdks/python-generator/",
     "!dist/sdks/typescript/",
     "!dist/**/*.js.map",
@@ -143,7 +142,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",
@@ -227,7 +226,7 @@
     "prepare": "lefthook install || true",
     "postinstall": "node bin/postinstall || true",
     "// RELEASE & PUBLISH": "",
-    "prepublishOnly": "publint && npm run build",
+    "prepublishOnly": "publint && npm run test:unit && npm run build",
     "validate:deps": "depcheck --ignore-dirs=examples --ignores='@anthropic-ai/claude-agent-sdk,@langchain/openai,@openai/agents,@temporalio/activity,@temporalio/workflow,pino-pretty,readline,@types/*,ts-jest,eslint*,prettier*,lefthook,jest*,vitest,semantic-release*,@semantic-release/*,keep-a-changelog,jest-junit,publint,conventional-changelog-conventionalcommits,ajv-cli,json-schema-to-typescript,json-schema-to-zod,ts-node,@playwright/test,@langchain/anthropic,@langchain/core,langchain'",
     "validate:package": "publint",
     "publish:dry-run": "npm publish --dry-run",
@@ -350,15 +349,15 @@
     "ajv-formats"
   ],
   "engines": {
-    "node": ">=16.20.0 || >=18.0.0 || >=20.0.0 || >=22.0.0",
-    "npm": ">=8.0.0"
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
   },
   "volta": {
-    "node": "18.20.8",
-    "npm": "10.9.4"
+    "node": "22.19.0",
+    "npm": "11.10.0"
   },
   "bundleDependencies": [
     "ajv",
     "ajv-formats"
   ]
-}
+}

package/dist/services/governance/cedar-provider.js

@@ -1,3 +1,4 @@
+import { SPEC_VERSION } from '../../version.js';
 /**
  * Cedar Governance Provider
  *
@@ -7,7 +8,7 @@
  */
 export class CedarGovernanceProvider {
     name = 'cedar';
-    version = 'v0.4.6';
+    version = `v${SPEC_VERSION}`;
     /**
      * Checks if the agent's governance config satisfies basic Cedar alignment.
      * e.g., missing clearance levels when policies require them.

package/dist/services/release-automation/base-crud.service.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Base CRUD Service
+ * DRY: Reusable CRUD operations for all release automation entities
+ */
+import { z } from 'zod';
+/**
+ * Generic CRUD operations interface
+ */
+export interface ICrudService<T, CreateInput, UpdateInput, FilterInput> {
+    /**
+     * Create a new entity
+     */
+    create(input: CreateInput): Promise<T>;
+    /**
+     * Read entity by ID
+     */
+    read(id: string | number): Promise<T | null>;
+    /**
+     * Update entity
+     */
+    update(id: string | number, input: UpdateInput): Promise<T>;
+    /**
+     * Delete entity
+     */
+    delete(id: string | number): Promise<void>;
+    /**
+     * List entities with filtering and pagination
+     */
+    list(filters?: FilterInput): Promise<{
+        items: T[];
+        pagination: {
+            page: number;
+            perPage: number;
+            total: number;
+            totalPages: number;
+        };
+    }>;
+}
+/**
+ * Base CRUD Service Implementation
+ * DRY: Provides common CRUD operations
+ */
+export declare abstract class BaseCrudService<T, CreateInput, UpdateInput, FilterInput> implements ICrudService<T, CreateInput, UpdateInput, FilterInput> {
+    protected abstract createSchema: z.ZodSchema<CreateInput>;
+    protected abstract updateSchema: z.ZodSchema<UpdateInput> | z.ZodNever;
+    protected abstract filterSchema: z.ZodSchema<FilterInput>;
+    protected abstract entitySchema: z.ZodSchema<T>;
+    /**
+     * Validate and parse input using Zod
+     */
+    protected validateCreate(input: unknown): CreateInput;
+    protected validateUpdate(input: unknown): UpdateInput;
+    protected validateFilter(input: unknown): FilterInput;
+    protected validateEntity(entity: unknown): T;
+    /**
+     * Abstract methods to be implemented by subclasses
+     */
+    abstract create(input: CreateInput): Promise<T>;
+    abstract read(id: string | number): Promise<T | null>;
+    abstract update(id: string | number, input: UpdateInput): Promise<T>;
+    abstract delete(id: string | number): Promise<void>;
+    abstract list(filters?: FilterInput): Promise<{
+        items: T[];
+        pagination: {
+            page: number;
+            perPage: number;
+            total: number;
+            totalPages: number;
+        };
+    }>;
+    /**
+     * Helper: Calculate pagination metadata
+     */
+    protected calculatePagination(total: number, page: number, perPage: number): {
+        page: number;
+        perPage: number;
+        total: number;
+        totalPages: number;
+    };
+    /**
+     * Helper: Validate ID format
+     */
+    protected validateId(id: string | number): void;
+    /**
+     * Helper: Handle not found errors
+     */
+    protected throwNotFound(resource: string, id: string | number): never;
+    /**
+     * Helper: Handle validation errors
+     */
+    protected handleValidationError(error: unknown): never;
+}
+//# sourceMappingURL=base-crud.service.d.ts.map