@backendkit-labs/agent-coding 0.14.0

package/dist/skills/builtins/node-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-pack.js","sourceRoot":"","sources":["../../../src/skills/builtins/node-pack.ts"],"names":[],"mappings":"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"}

package/dist/skills/builtins/python-pack.d.ts

@@ -0,0 +1,7 @@
+import type { Skill } from '@backendkit-labs/agent-core';
+/**
+ * Python / FastAPI skill pack (@bk-python).
+ * Activated for projects with requirements.txt or pyproject.toml.
+ */
+export declare const PYTHON_PACK_SKILLS: Skill[];
+//# sourceMappingURL=python-pack.d.ts.map

package/dist/skills/builtins/python-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-pack.d.ts","sourceRoot":"","sources":["../../../src/skills/builtins/python-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAsSrC,CAAC"}

package/dist/skills/builtins/python-pack.js

@@ -0,0 +1,303 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PYTHON_PACK_SKILLS = void 0;
+/**
+ * Python / FastAPI skill pack (@bk-python).
+ * Activated for projects with requirements.txt or pyproject.toml.
+ */
+exports.PYTHON_PACK_SKILLS = [
+    {
+        name: 'fastapi-patterns',
+        version: '1.0.0',
+        description: 'FastAPI patterns: routers, Depends, Pydantic models, async handlers',
+        scope: 'pack',
+        pack: '@bk-python',
+        language: ['python'],
+        triggers: [
+            'fastapi', 'api', 'router', 'endpoint', 'depends', 'dependency',
+            'pydantic', 'schema', 'request', 'response', 'handler', 'route',
+            'api rest', 'backend', 'servidor', 'server',
+        ],
+        systemPromptAddition: `## FastAPI Patterns
+
+### Router modular
+\`\`\`python
+# routers/users.py
+from fastapi import APIRouter, Depends, HTTPException, status
+from app.schemas.user import UserCreate, UserResponse
+from app.services.user import UserService
+from app.dependencies import get_user_service
+
+router = APIRouter(prefix="/users", tags=["users"])
+
+@router.get("/{user_id}", response_model=UserResponse)
+async def get_user(user_id: UUID, service: UserService = Depends(get_user_service)):
+    user = await service.find_by_id(user_id)
+    if not user:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="User not found")
+    return user
+
+@router.post("", response_model=UserResponse, status_code=status.HTTP_201_CREATED)
+async def create_user(data: UserCreate, service: UserService = Depends(get_user_service)):
+    return await service.create(data)
+\`\`\`
+
+### Pydantic schemas (separados de las entidades ORM)
+\`\`\`python
+from pydantic import BaseModel, EmailStr
+from uuid import UUID
+
+class UserCreate(BaseModel):
+    email: EmailStr
+    name: str
+
+class UserResponse(BaseModel):
+    id: UUID
+    email: str
+    name: str
+
+    model_config = {"from_attributes": True}  # para mapear desde ORM
+\`\`\`
+
+### Dependencias con Depends
+\`\`\`python
+# dependencies.py
+async def get_db() -> AsyncGenerator[AsyncSession, None]:
+    async with AsyncSessionLocal() as session:
+        yield session
+
+async def get_user_service(db: AsyncSession = Depends(get_db)) -> UserService:
+    return UserService(UserRepository(db))
+\`\`\`
+
+### Reglas
+- Usa \`APIRouter\` por dominio — no pongas todo en \`main.py\`
+- Los schemas de entrada (Create/Update) y salida (Response) son clases separadas
+- Nunca devuelvas modelos ORM directamente — mapea a schemas Pydantic
+- Usa \`status.HTTP_xxx\` en lugar de números crudos`,
+    },
+    {
+        name: 'python-error-handling',
+        version: '1.0.0',
+        description: 'FastAPI exception handling: custom exceptions, global handlers, HTTP errors',
+        scope: 'pack',
+        pack: '@bk-python',
+        language: ['python'],
+        triggers: [
+            'exception', 'error', 'manejo de errores', 'error handling',
+            'httpexception', 'exceptionhandler', '404', '400', '422', '500',
+            'try', 'except', 'raise',
+        ],
+        systemPromptAddition: `## Python / FastAPI Error Handling
+
+### Excepciones de dominio
+\`\`\`python
+class AppError(Exception):
+    """Base para todos los errores de la aplicación."""
+    pass
+
+class NotFoundError(AppError):
+    def __init__(self, resource: str, id: Any):
+        self.resource = resource
+        self.id = id
+        super().__init__(f"{resource} not found: {id}")
+
+class ValidationError(AppError):
+    def __init__(self, message: str):
+        super().__init__(message)
+
+class ConflictError(AppError):
+    def __init__(self, message: str):
+        super().__init__(message)
+\`\`\`
+
+### Handler global en FastAPI
+\`\`\`python
+# main.py
+from fastapi import FastAPI, Request
+from fastapi.responses import JSONResponse
+
+app = FastAPI()
+
+@app.exception_handler(NotFoundError)
+async def not_found_handler(request: Request, exc: NotFoundError):
+    return JSONResponse(status_code=404, content={"detail": str(exc)})
+
+@app.exception_handler(ConflictError)
+async def conflict_handler(request: Request, exc: ConflictError):
+    return JSONResponse(status_code=409, content={"detail": str(exc)})
+
+@app.exception_handler(ValidationError)
+async def validation_handler(request: Request, exc: ValidationError):
+    return JSONResponse(status_code=422, content={"detail": str(exc)})
+\`\`\`
+
+### En los servicios — lanza excepciones de dominio
+\`\`\`python
+async def find_by_id(self, user_id: UUID) -> User:
+    user = await self.repo.find_by_id(user_id)
+    if not user:
+        raise NotFoundError("User", user_id)
+    return user
+\`\`\`
+
+### Reglas
+- Los servicios lanzan excepciones de dominio (NotFoundError, etc.) — no HTTPException
+- Los handlers globales convierten excepciones de dominio a respuestas HTTP
+- Nunca devuelvas stack traces al cliente en producción
+- Usa logging estructurado: \`logger.exception("msg", exc_info=True)\``,
+    },
+    {
+        name: 'sqlalchemy-patterns',
+        version: '1.0.0',
+        description: 'Async SQLAlchemy, repository pattern, Alembic migrations',
+        scope: 'pack',
+        pack: '@bk-python',
+        language: ['python'],
+        triggers: [
+            'sqlalchemy', 'database', 'base de datos', 'orm', 'model', 'modelo',
+            'migration', 'migracion', 'alembic', 'session', 'query', 'repository',
+            'repositorio', 'postgresql', 'postgres', 'mysql', 'sqlite',
+        ],
+        systemPromptAddition: `## SQLAlchemy (Async) + Repository Pattern
+
+### Modelo ORM
+\`\`\`python
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
+from sqlalchemy import String
+import uuid
+
+class Base(DeclarativeBase):
+    pass
+
+class UserModel(Base):
+    __tablename__ = "users"
+
+    id: Mapped[uuid.UUID] = mapped_column(primary_key=True, default=uuid.uuid4)
+    email: Mapped[str] = mapped_column(String(255), unique=True, nullable=False)
+    name: Mapped[str] = mapped_column(String(100), nullable=False)
+    created_at: Mapped[datetime] = mapped_column(default=func.now())
+\`\`\`
+
+### Repository
+\`\`\`python
+from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy import select
+
+class UserRepository:
+    def __init__(self, session: AsyncSession):
+        self.session = session
+
+    async def find_by_id(self, user_id: UUID) -> UserModel | None:
+        result = await self.session.execute(
+            select(UserModel).where(UserModel.id == user_id)
+        )
+        return result.scalar_one_or_none()
+
+    async def save(self, user: UserModel) -> UserModel:
+        self.session.add(user)
+        await self.session.flush()   # persiste en la transacción actual
+        await self.session.refresh(user)
+        return user
+\`\`\`
+
+### Sesión async con context manager
+\`\`\`python
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession, async_sessionmaker
+
+engine = create_async_engine(settings.DATABASE_URL)
+AsyncSessionLocal = async_sessionmaker(engine, expire_on_commit=False)
+
+# En dependencies.py
+async def get_db() -> AsyncGenerator[AsyncSession, None]:
+    async with AsyncSessionLocal() as session:
+        async with session.begin():  # commit/rollback automático
+            yield session
+\`\`\`
+
+### Reglas
+- Usa \`async_sessionmaker\` con \`session.begin()\` para transacciones automáticas
+- Nunca expongas modelos ORM fuera del repositorio — mapea a schemas Pydantic
+- Usa Alembic para migraciones — nunca \`Base.metadata.create_all()\` en producción
+- \`expire_on_commit=False\` evita lazy-loading después del commit`,
+    },
+    {
+        name: 'python-testing',
+        version: '1.0.0',
+        description: 'pytest, fixtures, httpx AsyncClient for FastAPI integration tests',
+        scope: 'pack',
+        pack: '@bk-python',
+        language: ['python'],
+        triggers: [
+            'test', 'tests', 'testing', 'pytest', 'fixture', 'mock', 'prueba',
+            'async test', 'httpx', 'asyncclient', 'coverage', 'cobertura',
+            'parametrize', 'conftest',
+        ],
+        systemPromptAddition: `## Python Testing (pytest + httpx)
+
+### Test unitario de servicio
+\`\`\`python
+import pytest
+from unittest.mock import AsyncMock, MagicMock
+from app.services.user import UserService
+from app.errors import NotFoundError
+
+@pytest.fixture
+def mock_repo():
+    return MagicMock()
+
+@pytest.fixture
+def user_service(mock_repo):
+    return UserService(mock_repo)
+
+@pytest.mark.asyncio
+async def test_find_by_id_returns_user(user_service, mock_repo):
+    user = User(id=uuid4(), email="ana@example.com", name="Ana")
+    mock_repo.find_by_id = AsyncMock(return_value=user)
+
+    result = await user_service.find_by_id(user.id)
+
+    assert result.email == "ana@example.com"
+    mock_repo.find_by_id.assert_awaited_once_with(user.id)
+
+@pytest.mark.asyncio
+async def test_find_by_id_raises_not_found(user_service, mock_repo):
+    mock_repo.find_by_id = AsyncMock(return_value=None)
+
+    with pytest.raises(NotFoundError):
+        await user_service.find_by_id(uuid4())
+\`\`\`
+
+### Test de API con httpx AsyncClient
+\`\`\`python
+# conftest.py
+import pytest
+from httpx import AsyncClient, ASGITransport
+from app.main import app
+
+@pytest.fixture
+async def client():
+    async with AsyncClient(transport=ASGITransport(app=app), base_url="http://test") as c:
+        yield c
+
+# test_users.py
+@pytest.mark.asyncio
+async def test_get_user_returns_200(client):
+    response = await client.get(f"/users/{user_id}")
+    assert response.status_code == 200
+    assert response.json()["email"] == "ana@example.com"
+
+@pytest.mark.asyncio
+async def test_get_user_returns_404(client):
+    response = await client.get(f"/users/{uuid4()}")
+    assert response.status_code == 404
+\`\`\`
+
+### Reglas
+- Usa \`pytest-asyncio\` con \`asyncio_mode = "auto"\` en \`pyproject.toml\`
+- Fixtures en \`conftest.py\` — no en cada archivo de test
+- Usa \`AsyncMock\` para mockear funciones async
+- Usa \`pytest.mark.parametrize\` para casos múltiples del mismo test`,
+    },
+];
+//# sourceMappingURL=python-pack.js.map

package/dist/skills/builtins/python-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-pack.js","sourceRoot":"","sources":["../../../src/skills/builtins/python-pack.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,kBAAkB,GAAY;IACvC;QACI,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,qEAAqE;QAClF,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,QAAQ,EAAE;YACN,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY;YAC/D,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO;YAC/D,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ;SAC9C;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAwDwB;KACjD;IACD;QACI,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,6EAA6E;QAC1F,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,QAAQ,EAAE;YACN,WAAW,EAAE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB;YAC3D,eAAe,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YAC/D,KAAK,EAAE,QAAQ,EAAE,OAAO;SAC3B;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAyDyC;KAClE;IACD;QACI,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,0DAA0D;QACvE,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,QAAQ,EAAE;YACN,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ;YACnE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY;YACrE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ;SAC7D;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEA4DsC;KAC/D;IACD;QACI,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,mEAAmE;QAChF,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,QAAQ,EAAE;YACN,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ;YACjE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW;YAC7D,aAAa,EAAE,UAAU;SAC5B;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEAgEyC;KAClE;CACJ,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1,7 @@
+export { GLOBAL_BUILTIN_SKILLS } from './builtins/global';
+export { NODE_PACK_SKILLS } from './builtins/node-pack';
+export { GO_PACK_SKILLS } from './builtins/go-pack';
+export { JAVA_PACK_SKILLS } from './builtins/java-pack';
+export { KOTLIN_PACK_SKILLS } from './builtins/kotlin-pack';
+export { PYTHON_PACK_SKILLS } from './builtins/python-pack';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PYTHON_PACK_SKILLS = exports.KOTLIN_PACK_SKILLS = exports.JAVA_PACK_SKILLS = exports.GO_PACK_SKILLS = exports.NODE_PACK_SKILLS = exports.GLOBAL_BUILTIN_SKILLS = void 0;
+var global_1 = require("./builtins/global");
+Object.defineProperty(exports, "GLOBAL_BUILTIN_SKILLS", { enumerable: true, get: function () { return global_1.GLOBAL_BUILTIN_SKILLS; } });
+var node_pack_1 = require("./builtins/node-pack");
+Object.defineProperty(exports, "NODE_PACK_SKILLS", { enumerable: true, get: function () { return node_pack_1.NODE_PACK_SKILLS; } });
+var go_pack_1 = require("./builtins/go-pack");
+Object.defineProperty(exports, "GO_PACK_SKILLS", { enumerable: true, get: function () { return go_pack_1.GO_PACK_SKILLS; } });
+var java_pack_1 = require("./builtins/java-pack");
+Object.defineProperty(exports, "JAVA_PACK_SKILLS", { enumerable: true, get: function () { return java_pack_1.JAVA_PACK_SKILLS; } });
+var kotlin_pack_1 = require("./builtins/kotlin-pack");
+Object.defineProperty(exports, "KOTLIN_PACK_SKILLS", { enumerable: true, get: function () { return kotlin_pack_1.KOTLIN_PACK_SKILLS; } });
+var python_pack_1 = require("./builtins/python-pack");
+Object.defineProperty(exports, "PYTHON_PACK_SKILLS", { enumerable: true, get: function () { return python_pack_1.PYTHON_PACK_SKILLS; } });
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":";;;AAAA,4CAA0D;AAAjD,+GAAA,qBAAqB,OAAA;AAC9B,kDAAwD;AAA/C,6GAAA,gBAAgB,OAAA;AACzB,8CAAoD;AAA3C,yGAAA,cAAc,OAAA;AACvB,kDAAwD;AAA/C,6GAAA,gBAAgB,OAAA;AACzB,sDAA4D;AAAnD,iHAAA,kBAAkB,OAAA;AAC3B,sDAA4D;AAAnD,iHAAA,kBAAkB,OAAA"}

package/dist/store/LearningRouter.d.ts

@@ -0,0 +1,17 @@
+export type LearningType = 'tool_quirk' | 'skill' | 'project' | 'user' | 'session';
+export type LearningScope = 'global' | 'project';
+export type LLMFn = (prompt: string) => Promise<string>;
+export interface RouterCtx {
+    projectDir: string;
+    homeDir: string;
+    llm: LLMFn;
+    /** Emit a compacting event to show progress bar in display */
+    emit?: (phase: 'start' | 'done' | 'fail', label: string) => void;
+}
+export interface RouteResult {
+    type: LearningType;
+    target: string;
+    skipped: boolean;
+}
+export declare function routeLearning(content: string, ctx: RouterCtx): Promise<RouteResult>;
+//# sourceMappingURL=LearningRouter.d.ts.map

package/dist/store/LearningRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LearningRouter.d.ts","sourceRoot":"","sources":["../../src/store/LearningRouter.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AACnF,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjD,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AASxD,MAAM,WAAW,SAAS;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAK,MAAM,CAAC;IACnB,GAAG,EAAS,KAAK,CAAC;IAClB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAK,YAAY,CAAC;IACtB,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACpB;AAqGD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CA+EzF"}

package/dist/store/LearningRouter.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.routeLearning = routeLearning;
+const fs_1 = require("fs");
+const path_1 = require("path");
+// ── Constants ─────────────────────────────────────────────────────────────────
+const KNOWN_AGENTS = ['data', 'backend', 'frontend', 'infrastructure', 'qa-engineer', 'security', 'architecture', 'general'];
+const MAX_NOTES_BYTES = 1_500;
+const MAX_CTX_BYTES = 4_000;
+const MAX_USER_BYTES = 2_000;
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function safeRead(path) {
+    try {
+        return (0, fs_1.readFileSync)(path, 'utf-8').trim();
+    }
+    catch {
+        return '';
+    }
+}
+function safeWrite(path, content) {
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
+    (0, fs_1.writeFileSync)(path, content, 'utf-8');
+}
+function parseJSON(raw, fallback) {
+    try {
+        const json = raw.match(/\{[\s\S]*\}/)?.[0] ?? raw;
+        return JSON.parse(json);
+    }
+    catch {
+        return fallback;
+    }
+}
+// ── LLM helpers ───────────────────────────────────────────────────────────────
+async function classify(content, llm) {
+    const prompt = `Classify this learning and respond as JSON only (no markdown).
+
+Categories:
+- tool_quirk : specific behavior or limitation of a tool/library/framework
+- skill      : reusable step-by-step process worth packaging as a reusable skill
+- project    : architectural decision or project-specific fact
+- user       : user preference or working style
+- session    : ephemeral task info, not worth persisting
+
+Fields required:
+- type         : one of the categories
+- target_agent : which agent owns this — one of: ${KNOWN_AGENTS.join(', ')}
+- skill_name   : if type=skill, suggest a kebab-case name (else empty string "")
+- scope        : "global" if applies to all projects | "project" if specific to this one
+
+Learning: "${content.slice(0, 500)}"
+
+JSON only:`;
+    const raw = await llm(prompt).catch(() => '{}');
+    return parseJSON(raw, {
+        type: 'tool_quirk', target_agent: 'general', skill_name: '', scope: 'global',
+    });
+}
+async function isDuplicate(content, existing, llm) {
+    if (!existing.trim())
+        return false;
+    const prompt = `Does the new learning add any information not already present in the existing notes?
+Existing (excerpt): "${existing.slice(0, 600)}"
+New: "${content.slice(0, 300)}"
+JSON only: {"is_duplicate": true or false}`;
+    const raw = await llm(prompt).catch(() => '{"is_duplicate":false}');
+    return parseJSON(raw, { is_duplicate: false }).is_duplicate;
+}
+async function compact(content, maxBytes, label, ctx) {
+    ctx.emit?.('start', label);
+    const prompt = `Compact these notes to under ${Math.floor(maxBytes / 2)} bytes. Keep all distinct facts. Remove redundancy. Output only the compacted text, no preamble:\n\n${content}`;
+    const result = await ctx.llm(prompt).catch(() => content);
+    ctx.emit?.('done', label);
+    return result.trim();
+}
+async function generateSkillMd(content, agent, name, llm) {
+    const prompt = `Generate a skill file in .md format with YAML frontmatter. Output the raw file content only, no extra explanation.
+
+Format:
+---
+name: ${name}
+version: 1.0.0
+description: <one concise line>
+triggers:
+  - <keyword1>
+  - <keyword2>
+agents:
+  - ${agent}
+---
+
+<Step-by-step instructions derived from this learning, written in markdown>
+
+Learning: "${content.slice(0, 500)}"`;
+    const raw = await llm(prompt).catch(() => '');
+    const cleaned = raw.replace(/^```(?:md|markdown)?\n?/im, '').replace(/```\s*$/m, '').trim();
+    return cleaned ||
+        `---\nname: ${name}\nversion: 1.0.0\ndescription: ${content.slice(0, 80)}\ntriggers: []\nagents:\n  - ${agent}\n---\n\n${content}\n`;
+}
+// ── Main router ───────────────────────────────────────────────────────────────
+async function routeLearning(content, ctx) {
+    const cls = await classify(content, ctx.llm);
+    const agent = KNOWN_AGENTS.includes(cls.target_agent) ? cls.target_agent : 'general';
+    // session learnings are ephemeral — discard
+    if (cls.type === 'session') {
+        return { type: 'session', target: 'discarded (ephemeral)', skipped: true };
+    }
+    if (cls.type === 'tool_quirk') {
+        const dir = cls.scope === 'global'
+            ? (0, path_1.join)(ctx.homeDir, 'agent-notes')
+            : (0, path_1.join)(ctx.projectDir, 'agent-notes');
+        const path = (0, path_1.join)(dir, `${agent}.md`);
+        const existing = safeRead(path);
+        if (await isDuplicate(content, existing, ctx.llm)) {
+            return { type: 'tool_quirk', target: `agent-notes/${agent}.md`, skipped: true };
+        }
+        let updated = existing ? `${existing}\n- ${content}` : `- ${content}`;
+        if (Buffer.byteLength(updated, 'utf-8') > MAX_NOTES_BYTES) {
+            updated = await compact(updated, MAX_NOTES_BYTES, `Compacting ${agent} notes`, ctx);
+        }
+        safeWrite(path, updated);
+        return { type: 'tool_quirk', target: `agent-notes/${agent}.md`, skipped: false };
+    }
+    if (cls.type === 'skill') {
+        const name = cls.skill_name || `skill-${Date.now()}`;
+        const dir = cls.scope === 'global'
+            ? (0, path_1.join)(ctx.homeDir, 'skills', 'global')
+            : (0, path_1.join)(ctx.projectDir, 'skills');
+        const filePath = (0, path_1.join)(dir, `${name}.md`);
+        if ((0, fs_1.existsSync)(filePath)) {
+            return { type: 'skill', target: `skills/${name}.md`, skipped: true };
+        }
+        ctx.emit?.('start', `Generating skill "${name}"`);
+        const md = await generateSkillMd(content, agent, name, ctx.llm);
+        ctx.emit?.('done', `Generating skill "${name}"`);
+        safeWrite(filePath, md);
+        return { type: 'skill', target: `skills/${name}.md`, skipped: false };
+    }
+    if (cls.type === 'project') {
+        const path = (0, path_1.join)(ctx.projectDir, 'memory', 'contexto-proyecto.md');
+        const existing = safeRead(path);
+        if (await isDuplicate(content, existing, ctx.llm)) {
+            return { type: 'project', target: 'contexto-proyecto.md', skipped: true };
+        }
+        let updated = existing ? `${existing}\n\n${content}` : content;
+        if (Buffer.byteLength(updated, 'utf-8') > MAX_CTX_BYTES) {
+            updated = await compact(updated, MAX_CTX_BYTES, 'Compacting project context', ctx);
+        }
+        safeWrite(path, updated);
+        return { type: 'project', target: 'contexto-proyecto.md', skipped: false };
+    }
+    if (cls.type === 'user') {
+        const path = (0, path_1.join)(ctx.homeDir, 'USER.md');
+        const existing = safeRead(path);
+        if (await isDuplicate(content, existing, ctx.llm)) {
+            return { type: 'user', target: 'USER.md', skipped: true };
+        }
+        let updated = existing ? `${existing}\n- ${content}` : `- ${content}`;
+        if (Buffer.byteLength(updated, 'utf-8') > MAX_USER_BYTES) {
+            updated = await compact(updated, MAX_USER_BYTES, 'Compacting user profile', ctx);
+        }
+        safeWrite(path, updated);
+        return { type: 'user', target: 'USER.md', skipped: false };
+    }
+    return { type: 'session', target: 'unclassified/discarded', skipped: true };
+}
+//# sourceMappingURL=LearningRouter.js.map

package/dist/store/LearningRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LearningRouter.js","sourceRoot":"","sources":["../../src/store/LearningRouter.ts"],"names":[],"mappings":"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"}

package/dist/store/PersistentMemory.d.ts

@@ -0,0 +1,10 @@
+import type { SessionMemoryData } from '@backendkit-labs/agent-core';
+export declare class PersistentMemory implements SessionMemoryData {
+    private data;
+    private readonly filePath;
+    constructor(projectDir: string);
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    getAll(): Record<string, string>;
+}
+//# sourceMappingURL=PersistentMemory.d.ts.map

package/dist/store/PersistentMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentMemory.d.ts","sourceRoot":"","sources":["../../src/store/PersistentMemory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,qBAAa,gBAAiB,YAAW,iBAAiB;IACtD,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,UAAU,EAAE,MAAM;IAO9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGnC"}

package/dist/store/PersistentMemory.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistentMemory = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const agent_core_1 = require("@backendkit-labs/agent-core");
+class PersistentMemory {
+    data = {};
+    filePath;
+    constructor(projectDir) {
+        this.filePath = (0, path_1.join)(projectDir, 'memory.json');
+        try {
+            this.data = JSON.parse((0, fs_1.readFileSync)(this.filePath, 'utf-8'));
+        }
+        catch { /* first run — start empty */ }
+    }
+    get(key) {
+        return this.data[key];
+    }
+    set(key, value) {
+        this.data[key] = value;
+        (0, agent_core_1.atomicWriteSync)(this.filePath, JSON.stringify(this.data, null, 2));
+    }
+    getAll() {
+        return { ...this.data };
+    }
+}
+exports.PersistentMemory = PersistentMemory;
+//# sourceMappingURL=PersistentMemory.js.map

package/dist/store/PersistentMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistentMemory.js","sourceRoot":"","sources":["../../src/store/PersistentMemory.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAClC,+BAA4B;AAC5B,4DAA8D;AAG9D,MAAa,gBAAgB;IACjB,IAAI,GAA2B,EAAE,CAAC;IACzB,QAAQ,CAAS;IAElC,YAAY,UAAkB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAA,WAAI,EAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC;YACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IAED,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAa;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,IAAA,4BAAe,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM;QACF,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;CACJ;AAvBD,4CAuBC"}

package/dist/store/ProjectStore.d.ts

@@ -0,0 +1,29 @@
+import type { ProjectStoreData, SessionUpdates } from '@backendkit-labs/agent-core';
+export declare class ProjectStore implements ProjectStoreData {
+    readonly homeDir: string;
+    readonly projectDir: string;
+    constructor(cwd: string, appName?: string);
+    private initSessionFile;
+    getContext(): string;
+    appendContext(content: string): void;
+    getLearnings(): string;
+    appendLearning(content: string): void;
+    getAgentNotes(agentId: string): string;
+    saveAudit(agentId: string, content: string): void;
+    getLatestAudit(agentId: string): string | null;
+    listAudits(): string[];
+    getUserProfile(): string;
+    appendUserPreference(content: string): void;
+    buildSystemContext(agentMd?: string): string;
+    buildAgentContext(agentId: string, agentMd?: string): string;
+    updateSession(updates: SessionUpdates): void;
+    private read;
+    private readAbs;
+    private append;
+    private appendAbs;
+    /** Replace entire content of a markdown section. Creates section if absent. */
+    private setSection;
+    /** Append lines to a markdown section, skipping placeholder text. Creates section if absent. */
+    private appendToSection;
+}
+//# sourceMappingURL=ProjectStore.d.ts.map

package/dist/store/ProjectStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectStore.d.ts","sourceRoot":"","sources":["../../src/store/ProjectStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAKpF,qBAAa,YAAa,YAAW,gBAAgB;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,MAAM,EAAE,OAAO,SAAa;IAQ7C,OAAO,CAAC,eAAe;IA6BvB,UAAU,IAAI,MAAM;IACpB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAGpC,YAAY,IAAI,MAAM;IACtB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAGrC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAStC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ9C,UAAU,IAAI,MAAM,EAAE;IAMtB,cAAc,IAAI,MAAM;IAGxB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3C,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAa5C,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ5D,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAwC5C,OAAO,CAAC,IAAI;IAGZ,OAAO,CAAC,OAAO;IAGf,OAAO,CAAC,MAAM;IAGd,OAAO,CAAC,SAAS;IAKjB,+EAA+E;IAC/E,OAAO,CAAC,UAAU;IAOlB,gGAAgG;IAChG,OAAO,CAAC,eAAe;CAU1B"}