agent-skill-compiler 0.1.0__tar.gz

agent_skill_compiler-0.1.0/.dockerignore

@@ -0,0 +1,10 @@
+.git
+.gitignore
+.env
+.venv
+.pytest_cache
+__pycache__
+*.pyc
+.data
+reports
+tests

agent_skill_compiler-0.1.0/.env.example

@@ -0,0 +1,5 @@
+ASC_DB_PATH=.data/agent_skill_compiler.db
+ASC_REPORT_PATH=reports/skills.html
+ASC_API_HOST=127.0.0.1
+ASC_API_PORT=8000
+ASC_ADMIN_TOKEN=

agent_skill_compiler-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.data/
+__pycache__/
+*.pyc
+reports/
+.venv/
+.env
+.artifacts/

agent_skill_compiler-0.1.0/Dockerfile

@@ -0,0 +1,19 @@
+FROM python:3.13-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+COPY pyproject.toml README.md ./
+COPY src ./src
+
+RUN pip install --no-cache-dir .
+
+RUN mkdir -p /app/.data /app/reports
+
+EXPOSE 8000
+
+VOLUME ["/app/.data", "/app/reports"]
+
+CMD ["agent-skill-compiler", "serve", "--host", "0.0.0.0", "--port", "8000"]

agent_skill_compiler-0.1.0/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: agent-skill-compiler
+Version: 0.1.0
+Summary: Local-first toolkit for mining repeated multi-agent execution patterns into candidate skills.
+Author: Open Source Contributors
+License: MIT
+Keywords: agents,ai,analysis,skills,tooling,tracing
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: pydantic-settings>=2.13.1
+Requires-Dist: pydantic>=2.11.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: typer>=0.15.3
+Requires-Dist: uvicorn>=0.34.0
+Description-Content-Type: text/markdown
+
+# Agent Skill Compiler
+
+Agent Skill Compiler is an API-first backend and Python SDK for collecting agent traces, storing project-scoped runs, and analyzing repeated execution patterns into candidate skills.
+
+This repository intentionally ships no frontend. The supported deployment model is:
+
+1. deploy this package as your tracing and analysis API
+2. instrument your backend agents with the Python SDK using `base_url`, `public_key`, and `secret_key`
+3. build your frontend in a separate repo against this API using `base_url` plus the project `public_key`
+
+## Auth Model
+
+- trusted backend writes: `public_key` + `secret_key`
+- frontend reads: `public_key`
+- admin/project provisioning: optional `ASC_ADMIN_TOKEN`
+
+Never expose the `secret_key` in browser code.
+
+## Install
+
+```bash
+pip install agent-skill-compiler
+```
+
+For local development:
+
+```bash
+python3.11 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## Run The API
+
+### Local Python
+
+```bash
+source .venv/bin/activate
+agent-skill-compiler serve
+```
+
+### Docker
+
+```bash
+cp .env.example .env
+docker compose up --build
+```
+
+Useful endpoints:
+
+- `GET /`
+- `GET /docs`
+- `GET /api/healthz`
+- `POST /api/admin/projects`
+
+## Create A Project
+
+Protect project creation if needed:
+
+```bash
+export ASC_ADMIN_TOKEN=change-me
+agent-skill-compiler serve
+```
+
+Create a project and its first keypair:
+
+```bash
+curl -X POST http://localhost:8000/api/admin/projects \
+  -H "Content-Type: application/json" \
+  -H "X-ASC-Admin-Token: change-me" \
+  -d '{
+    "name": "Support API",
+    "slug": "support-api",
+    "key_name": "backend"
+  }'
+```
+
+Example response:
+
+```json
+{
+  "project": {
+    "project_id": "...",
+    "name": "Support API",
+    "slug": "support-api",
+    "created_at": "..."
+  },
+  "public_key": "asc_pk_...",
+  "secret_key": "asc_sk_...",
+  "key_name": "backend"
+}
+```
+
+## Backend Usage
+
+Recommended environment variables:
+
+```bash
+export ASC_BASE_URL=http://localhost:8000
+export ASC_PUBLIC_KEY=asc_pk_your_project_public_key
+export ASC_SECRET_KEY=asc_sk_your_project_secret_key
+```
+
+Minimal SDK example:
+
+```python
+from agent_skill_compiler import SkillCompilerClient
+
+client = SkillCompilerClient(
+    base_url="http://localhost:8000",
+    public_key="asc_pk_your_project_public_key",
+    secret_key="asc_sk_your_project_secret_key",
+)
+
+run = client.start_run(
+    task_name="customer_followup",
+    input_text="Review this customer issue and prepare next steps.",
+    metadata={"service": "support-api", "workflow": "support_triage"},
+)
+
+tool_call = client.record_event(
+    run_id=run.run_id,
+    agent_name="ResearchAgent",
+    action_name="search_docs",
+    action_kind="tool_call",
+    input_payload={"query": "latest billing escalation policy"},
+)
+
+client.record_event(
+    run_id=run.run_id,
+    agent_name="ResearchAgent",
+    action_name="search_docs",
+    action_kind="tool_result",
+    output_payload={"documents": ["billing-policy-v2"]},
+    latency_ms=142,
+    parent_event_id=tool_call.event_id,
+)
+
+client.record_event(
+    run_id=run.run_id,
+    agent_name="SummaryAgent",
+    action_name="final_response",
+    action_kind="final_output",
+    output_payload={"response": "Prepared next steps for the support team."},
+    latency_ms=85,
+)
+
+client.finish_run(run_id=run.run_id, status="success")
+client.close()
+```
+
+## Frontend Usage
+
+Your separate frontend should use the `public_key` only.
+
+Project-scoped read endpoints:
+
+- `GET /api/runs?public_key=asc_pk_...`
+- `GET /api/runs/{run_id}?public_key=asc_pk_...`
+- `GET /api/skills?public_key=asc_pk_...`
+- `POST /api/analyze?public_key=asc_pk_...`
+
+## API Reference
+
+Trusted backend writes:
+
+- `POST /api/runs/start`
+- `POST /api/runs/{run_id}/events`
+- `POST /api/runs/{run_id}/finish`
+
+Project reads:
+
+- `GET /api/runs`
+- `GET /api/runs/{run_id}`
+- `GET /api/skills`
+- `POST /api/analyze`
+
+Admin and ops:
+
+- `GET /api/healthz`
+- `GET /api/config`
+- `GET /api/projects`
+- `GET /api/projects/{project_id}/keys`
+- `POST /api/admin/projects`
+- `POST /api/admin/reset`
+- `POST /api/reports/generate`
+- `GET /reports/latest`
+
+Write requests must include:
+
+- `X-ASC-Public-Key`
+- `X-ASC-Secret-Key`
+
+## Notes
+
+- SQLite is used for local-first persistence.
+- Candidate skills are heuristic suggestions derived from repeated event subsequences.
+- HTML reporting remains available through the report endpoints and CLI.
+
+## License
+
+MIT

agent_skill_compiler-0.1.0/README.md

@@ -0,0 +1,202 @@
+# Agent Skill Compiler
+
+Agent Skill Compiler is an API-first backend and Python SDK for collecting agent traces, storing project-scoped runs, and analyzing repeated execution patterns into candidate skills.
+
+This repository intentionally ships no frontend. The supported deployment model is:
+
+1. deploy this package as your tracing and analysis API
+2. instrument your backend agents with the Python SDK using `base_url`, `public_key`, and `secret_key`
+3. build your frontend in a separate repo against this API using `base_url` plus the project `public_key`
+
+## Auth Model
+
+- trusted backend writes: `public_key` + `secret_key`
+- frontend reads: `public_key`
+- admin/project provisioning: optional `ASC_ADMIN_TOKEN`
+
+Never expose the `secret_key` in browser code.
+
+## Install
+
+```bash
+pip install agent-skill-compiler
+```
+
+For local development:
+
+```bash
+python3.11 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+## Run The API
+
+### Local Python
+
+```bash
+source .venv/bin/activate
+agent-skill-compiler serve
+```
+
+### Docker
+
+```bash
+cp .env.example .env
+docker compose up --build
+```
+
+Useful endpoints:
+
+- `GET /`
+- `GET /docs`
+- `GET /api/healthz`
+- `POST /api/admin/projects`
+
+## Create A Project
+
+Protect project creation if needed:
+
+```bash
+export ASC_ADMIN_TOKEN=change-me
+agent-skill-compiler serve
+```
+
+Create a project and its first keypair:
+
+```bash
+curl -X POST http://localhost:8000/api/admin/projects \
+  -H "Content-Type: application/json" \
+  -H "X-ASC-Admin-Token: change-me" \
+  -d '{
+    "name": "Support API",
+    "slug": "support-api",
+    "key_name": "backend"
+  }'
+```
+
+Example response:
+
+```json
+{
+  "project": {
+    "project_id": "...",
+    "name": "Support API",
+    "slug": "support-api",
+    "created_at": "..."
+  },
+  "public_key": "asc_pk_...",
+  "secret_key": "asc_sk_...",
+  "key_name": "backend"
+}
+```
+
+## Backend Usage
+
+Recommended environment variables:
+
+```bash
+export ASC_BASE_URL=http://localhost:8000
+export ASC_PUBLIC_KEY=asc_pk_your_project_public_key
+export ASC_SECRET_KEY=asc_sk_your_project_secret_key
+```
+
+Minimal SDK example:
+
+```python
+from agent_skill_compiler import SkillCompilerClient
+
+client = SkillCompilerClient(
+    base_url="http://localhost:8000",
+    public_key="asc_pk_your_project_public_key",
+    secret_key="asc_sk_your_project_secret_key",
+)
+
+run = client.start_run(
+    task_name="customer_followup",
+    input_text="Review this customer issue and prepare next steps.",
+    metadata={"service": "support-api", "workflow": "support_triage"},
+)
+
+tool_call = client.record_event(
+    run_id=run.run_id,
+    agent_name="ResearchAgent",
+    action_name="search_docs",
+    action_kind="tool_call",
+    input_payload={"query": "latest billing escalation policy"},
+)
+
+client.record_event(
+    run_id=run.run_id,
+    agent_name="ResearchAgent",
+    action_name="search_docs",
+    action_kind="tool_result",
+    output_payload={"documents": ["billing-policy-v2"]},
+    latency_ms=142,
+    parent_event_id=tool_call.event_id,
+)
+
+client.record_event(
+    run_id=run.run_id,
+    agent_name="SummaryAgent",
+    action_name="final_response",
+    action_kind="final_output",
+    output_payload={"response": "Prepared next steps for the support team."},
+    latency_ms=85,
+)
+
+client.finish_run(run_id=run.run_id, status="success")
+client.close()
+```
+
+## Frontend Usage
+
+Your separate frontend should use the `public_key` only.
+
+Project-scoped read endpoints:
+
+- `GET /api/runs?public_key=asc_pk_...`
+- `GET /api/runs/{run_id}?public_key=asc_pk_...`
+- `GET /api/skills?public_key=asc_pk_...`
+- `POST /api/analyze?public_key=asc_pk_...`
+
+## API Reference
+
+Trusted backend writes:
+
+- `POST /api/runs/start`
+- `POST /api/runs/{run_id}/events`
+- `POST /api/runs/{run_id}/finish`
+
+Project reads:
+
+- `GET /api/runs`
+- `GET /api/runs/{run_id}`
+- `GET /api/skills`
+- `POST /api/analyze`
+
+Admin and ops:
+
+- `GET /api/healthz`
+- `GET /api/config`
+- `GET /api/projects`
+- `GET /api/projects/{project_id}/keys`
+- `POST /api/admin/projects`
+- `POST /api/admin/reset`
+- `POST /api/reports/generate`
+- `GET /reports/latest`
+
+Write requests must include:
+
+- `X-ASC-Public-Key`
+- `X-ASC-Secret-Key`
+
+## Notes
+
+- SQLite is used for local-first persistence.
+- Candidate skills are heuristic suggestions derived from repeated event subsequences.
+- HTML reporting remains available through the report endpoints and CLI.
+
+## License
+
+MIT

agent_skill_compiler-0.1.0/docker-compose.yml

@@ -0,0 +1,11 @@
+services:
+  agent-skill-compiler:
+    build:
+      context: .
+    env_file:
+      - .env
+    ports:
+      - "8000:8000"
+    volumes:
+      - ./.data:/app/.data
+      - ./reports:/app/reports

agent_skill_compiler-0.1.0/docs/BACKEND_INTEGRATION.md

@@ -0,0 +1,134 @@
+# Backend Integration Guide
+
+Use Agent Skill Compiler as a separate backend service beside your existing agents.
+
+## Integration Contract
+
+Your backend needs:
+
+- `base_url`
+- `public_key`
+- `secret_key`
+
+Your frontend needs:
+
+- `base_url`
+- `public_key`
+
+Never expose the `secret_key` in browser code.
+
+## 1. Run The API
+
+```bash
+agent-skill-compiler serve
+```
+
+Or:
+
+```bash
+docker compose up --build
+```
+
+## 2. Create A Project
+
+Optional:
+
+```bash
+export ASC_ADMIN_TOKEN=change-me
+```
+
+```bash
+curl -X POST http://localhost:8000/api/admin/projects \
+  -H "Content-Type: application/json" \
+  -H "X-ASC-Admin-Token: change-me" \
+  -d '{
+    "name": "Support API",
+    "slug": "support-api",
+    "key_name": "backend"
+  }'
+```
+
+Save the returned `public_key` and `secret_key`.
+
+## 3. Configure Your Backend
+
+```bash
+export ASC_BASE_URL=http://localhost:8000
+export ASC_PUBLIC_KEY=asc_pk_your_project_public_key
+export ASC_SECRET_KEY=asc_sk_your_project_secret_key
+```
+
+```python
+from agent_skill_compiler import SkillCompilerClient
+
+compiler = SkillCompilerClient(
+    base_url="http://localhost:8000",
+    public_key="asc_pk_your_project_public_key",
+    secret_key="asc_sk_your_project_secret_key",
+)
+```
+
+## 4. Instrument One Real Workflow
+
+Wrap one real backend path with:
+
+- `start_run(...)`
+- `record_event(...)`
+- `finish_run(...)`
+
+```python
+run = compiler.start_run(
+    task_name="support_review",
+    input_text=payload["message"],
+    metadata={"service": "support-api", "route": "/support/review"},
+)
+
+tool_call = compiler.record_event(
+    run_id=run.run_id,
+    agent_name="SupportResearcher",
+    action_name="search_docs",
+    action_kind="tool_call",
+    input_payload={"query": "billing escalation policy"},
+)
+
+compiler.record_event(
+    run_id=run.run_id,
+    agent_name="SupportResearcher",
+    action_name="search_docs",
+    action_kind="tool_result",
+    output_payload={"documents": ["billing-policy-v2"]},
+    parent_event_id=tool_call.event_id,
+)
+
+compiler.finish_run(run_id=run.run_id, status="success")
+```
+
+## 5. Verify Reads
+
+```bash
+curl "http://localhost:8000/api/runs?public_key=asc_pk_your_project_public_key"
+```
+
+```bash
+curl "http://localhost:8000/api/skills?public_key=asc_pk_your_project_public_key"
+```
+
+```bash
+curl -X POST "http://localhost:8000/api/analyze?public_key=asc_pk_your_project_public_key"
+```
+
+## Frontend Repo Pattern
+
+Your separate frontend can read project data with:
+
+- `GET /api/runs?public_key=...`
+- `GET /api/runs/{run_id}?public_key=...`
+- `GET /api/skills?public_key=...`
+- `POST /api/analyze?public_key=...`
+
+## Common Mistakes
+
+- Exposing the `secret_key` to the browser.
+- Recording only final output and no intermediate steps.
+- Instrumenting too many workflows before verifying one path end to end.
+- Forgetting to call `finish_run(...)`.

agent_skill_compiler-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agent-skill-compiler"
+version = "0.1.0"
+description = "Local-first toolkit for mining repeated multi-agent execution patterns into candidate skills."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+  { name = "Open Source Contributors" }
+]
+keywords = ["agents", "ai", "skills", "tracing", "analysis", "tooling"]
+dependencies = [
+  "fastapi>=0.115.0",
+  "httpx>=0.28.1",
+  "jinja2>=3.1.6",
+  "pydantic>=2.11.0",
+  "pydantic-settings>=2.13.1",
+  "rich>=14.0.0",
+  "typer>=0.15.3",
+  "uvicorn>=0.34.0",
+]
+
+[project.scripts]
+agent-skill-compiler = "agent_skill_compiler.cli.app:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agent_skill_compiler"]

agent_skill_compiler-0.1.0/src/agent_skill_compiler/__init__.py

@@ -0,0 +1,5 @@
+"""Agent Skill Compiler."""
+
+from agent_skill_compiler.sdk.client import SkillCompilerClient
+
+__all__ = ["SkillCompilerClient"]

agent_skill_compiler-0.1.0/src/agent_skill_compiler/analysis/__init__.py

@@ -0,0 +1,6 @@
+"""Analysis exports."""
+
+from agent_skill_compiler.analysis.pipeline import AnalysisService, PatternMiner, SequenceNormalizer, SkillSuggester
+from agent_skill_compiler.models.domain import AnalysisSummary
+
+__all__ = ["AnalysisService", "AnalysisSummary", "PatternMiner", "SequenceNormalizer", "SkillSuggester"]