agent-apprenticeship 0.1.4 → 0.1.6

package/README.md

@@ -1,5 +1,3 @@
-# Agent Apprenticeship
-
 The living ecosystem where AI agents learn from real-world work through iterative workflow loops, reusable experience, and collective training signal exchange.
 
 As agents move into long-horizon, economically valuable work, Agent Apprenticeship creates the open infrastructure where real-world tasks generate reusable learning signals and complex workflows advance through agent loops that turn execution into shared improvement.
@@ -11,198 +9,3 @@ Agent Apprenticeship is built for iterative workflow loops across domains, from
 Agent Apprenticeship is now available for anyone to start using with local agents including Codex, Cursor, Claude Code, OpenClaw, OpenCode, Hermes Agent, and custom agents, alongside different model providers. Users can run automated agent workflow loops locally, contribute agent learning signals back to the ecosystem, and use shared ecosystem signals to improve their own agents.
 
 Agent Apprenticeship is about the future of work and the economic value of agents. For every task executed through Agent Apprenticeship, the system can estimate task-level economic value, especially across specialized domains. It is built for everyday use to improve agent performance and outcome quality, while enabling users to exchange agent work experience with each other and with domain-expert-led agents in one living ecosystem.
-
-## Install
-
-```bash
-npx agent-apprenticeship init
-```
-
-```bash
-npm install -g agent-apprenticeship
-apprentice init
-```
-
-The installed command is:
-
-```bash
-apprentice
-```
-
-The long-form command also remains available:
-
-```bash
-agent-apprenticeship
-```
-
-## Quickstart
-
-```bash
-apprentice init
-apprentice settings
-apprentice run "Create a short market map for AI procurement tools."
-```
-
-Runs print the artifacts path and Contribution Bundle path.
-
-```bash
-apprentice ecosystem contribute <bundle_path>
-```
-
-Public ecosystem:
-
-https://github.com/Forsy-AI/agent-apprenticeship
-
-## Apprentice Agents
-
-Selected v0 Apprentice Agents:
-
-* Codex
-* Cursor
-* Claude Code
-* OpenClaw
-* OpenCode
-* Hermes Agent
-* Custom
-
-Agent Apprenticeship auto-detects installed CLIs. If multiple are detected, choose one during setup.
-
-Custom lets you provide a command template:
-
-```bash
-apprentice configure agent custom --command-template "my-agent run --workspace {workspace} --prompt-file {prompt_file}"
-```
-
-## Mentor Model Providers
-
-Store local keys in:
-
-```text
-~/.agent-apprenticeship/.env.local
-```
-
-Example:
-
-```bash
-OPENAI_API_KEY=""
-ANTHROPIC_API_KEY=""
-GEMINI_API_KEY=""
-OPENROUTER_API_KEY=""
-```
-
-Configure:
-
-```bash
-apprentice configure model
-apprentice doctor
-```
-
-## Mentor Modes
-
-```bash
-apprentice run "..." --mentor-mode model-assisted
-apprentice run "..." --mentor-mode expert-led
-apprentice run "..." --mentor-mode hybrid
-```
-
-* `model-assisted`: Mentor Model Provider handles the mentor loop.
-* `expert-led`: human expert checkpoints guide the mentor loop.
-* `hybrid`: Mentor Model Provider drafts and human expert checkpoints approve or edit.
-
-## Seed Dataset
-
-The seed dataset is included under:
-
-```text
-seed_dataset/
-```
-
-Explore seed tasks:
-
-```bash
-apprentice ecosystem list
-apprentice ecosystem search cloud
-apprentice ecosystem inspect aa-seed-task-501
-apprentice ecosystem pull aa-seed-task-501
-```
-
-## Ecosystem Learning
-
-Create Experience Packs from ecosystem experience:
-
-```bash
-apprentice learn create aa-seed-task-501
-apprentice learn preview <pack_id>
-apprentice learn replay <pack_id>
-apprentice learn keep <pack_id>
-apprentice run "Create a related incident response checklist." --experience-pack <pack_id>
-apprentice learn revert <pack_id>
-```
-
-Use active packs explicitly:
-
-```bash
-apprentice run "..." --use-active-experience-packs
-apprentice run "..." --no-experience-packs
-```
-
-## Contribution Bundles
-
-Runs produce Contribution Bundles.
-
-Contribute one to the public ecosystem:
-
-```bash
-apprentice ecosystem contribute <bundle_path>
-apprentice bundle contribute <bundle_path>
-```
-
-Public ecosystem:
-
-https://github.com/Forsy-AI/agent-apprenticeship
-
-## Ecosystem Auto-Share
-
-Default mode is Manual.
-
-```bash
-apprentice ecosystem configure --repo Forsy-AI/agent-apprenticeship
-apprentice ecosystem configure --auto-share manual
-apprentice ecosystem configure --auto-share ask
-apprentice ecosystem configure --auto-share automatic
-apprentice ecosystem status
-```
-
-Requirements:
-
-* GitHub CLI installed
-* `gh` authenticated
-* ecosystem repo configured
-
-## Search, Inspect, Pull
-
-Discover and export ecosystem experience:
-
-```bash
-apprentice ecosystem search <query>
-apprentice ecosystem inspect <id>
-apprentice ecosystem pull <id>
-```
-
-## Public Repo Structure
-
-```text
-seed_dataset/
-ecosystem/
-ecosystem/contributions/
-schemas/
-examples/
-```
-
-## Development Commands
-
-```bash
-.venv/bin/python -m pytest -q tests
-PYTHONPATH=src .venv/bin/python -m compileall -q src tests scripts examples
-bash scripts/export_public_repo.sh
-```

package/bin/agent-apprenticeship.js

@@ -120,7 +120,7 @@ function runQuiet(command, args, label, timeoutMs) {
       console.error(message);
     }
     const out = [result.stdout, result.stderr].filter(Boolean).join("\n").trim();
-    if (out) console.error(out.slice(-4000));
+    if (out) console.error(out.slice(-8000));
     process.exit(result.status || 1);
   }
 }
@@ -157,10 +157,10 @@ function ensureRuntime(python) {
   runQuiet(python, ["-m", "venv", venvDir], "create the Python environment", 120000);
   runQuiet(py, [
     "-m", "pip", "install",
-    "-q",
     "--disable-pip-version-check",
     "--progress-bar", "off",
     "--no-input",
+    "--no-build-isolation",
     "--retries", "10",
     "--timeout", "60",
     packageRoot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-apprenticeship",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "The living ecosystem for AI agents learning from real-world work through iterative loops and training-signal exchange.",
   "license": "MIT",
   "repository": {

package/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-apprenticeship"
-version = "0.1.4"
+version = "0.1.6"
 description = "Open framework for turning real agent work into transferable agent experience"
 readme = "README.md"
 requires-python = ">=3.11"
-dependencies = ["pydantic>=2", "typer>=0.12", "openai>=1.0"]
+dependencies = ["pydantic>=2.7,<3", "typer>=0.12,<1", "openai>=2,<3"]
 
 [project.optional-dependencies]
-llm = ["openai>=1.0"]
+llm = ["openai>=2,<3"]
 test = ["pytest>=8"]
 
 [project.scripts]

package/src/agent_apprenticeship_trace/__init__.py

@@ -1,2 +1,2 @@
 """Agent Apprenticeship framework."""
-__version__ = "0.1.4"
+__version__ = "0.1.6"

package/src/agent_apprenticeship_trace/cli.py

@@ -48,6 +48,7 @@ from .config import (
 )
 from .openai_structured import run_llm_smoke, format_smoke_counters
 from .env import contains_secret, redact_secrets
+from .public_sanitizer import sanitize_public_obj, sanitize_public_text
 from .command_discovery import AGENT_COMMAND_CANDIDATES, resolve_command, resolve_agent_command
 from .integration_status import integrations_report
 from .certification import certification_exit_code, run_certification_matrix
@@ -2188,6 +2189,55 @@ def _zip_dir(src: Path, dst: Path) -> str:
     return f"sha256:{digest}"
 
 
+def _sanitize_submission_copy(root: Path) -> None:
+    text_suffixes = {
+        ".json",
+        ".jsonl",
+        ".md",
+        ".txt",
+        ".yaml",
+        ".yml",
+        ".csv",
+        ".tsv",
+        ".log",
+    }
+    for path in root.rglob("*"):
+        if not path.is_file() or path.stat().st_size > 5_000_000:
+            continue
+        if path.suffix.lower() not in text_suffixes:
+            continue
+        raw = path.read_text(errors="ignore")
+        if path.suffix.lower() == ".json":
+            try:
+                data = json.loads(raw or "{}")
+            except Exception:
+                path.write_text(sanitize_public_text(raw) or "")
+            else:
+                if isinstance(data, dict):
+                    write_json(path, sanitize_public_obj(data))
+                elif isinstance(data, list):
+                    path.write_text(json.dumps(sanitize_public_obj({"items": data})["items"], indent=2, sort_keys=True) + "\n")
+                else:
+                    path.write_text(sanitize_public_text(raw) or "")
+        elif path.suffix.lower() == ".jsonl":
+            rows = []
+            for line in raw.splitlines():
+                if not line.strip():
+                    continue
+                try:
+                    data = json.loads(line)
+                except Exception:
+                    rows.append(json.dumps(sanitize_public_text(line) or "", sort_keys=True))
+                else:
+                    if isinstance(data, dict):
+                        rows.append(json.dumps(sanitize_public_obj(data), sort_keys=True))
+                    else:
+                        rows.append(json.dumps(sanitize_public_obj({"item": data})["item"], sort_keys=True))
+            path.write_text("\n".join(rows) + ("\n" if rows else ""))
+        else:
+            path.write_text(sanitize_public_text(raw) or "")
+
+
 def _create_ecosystem_submission(bundle: Path) -> tuple[Path, Path, dict]:
     bundle = _safe_bundle_path(bundle)
     secret_hits = _bundle_secret_hits(bundle)
@@ -2206,6 +2256,7 @@ def _create_ecosystem_submission(bundle: Path) -> tuple[Path, Path, dict]:
         submission_dir / "contribution_bundle",
         ignore=shutil.ignore_patterns(".env", ".env.local", "__pycache__", "*.pyc"),
     )
+    _sanitize_submission_copy(submission_dir / "contribution_bundle")
     package_zip = bundle.parent / f"{bundle.name}_ecosystem_submission.zip"
     metadata = _bundle_submission_metadata(bundle, package_name=package_zip.name)
     write_json(submission_dir / "ecosystem_submission.json", metadata)
@@ -2757,9 +2808,9 @@ def ecosystem_contribute(
     typer.echo("")
     typer.echo(f"Bundle ID: {metadata.get('bundle_id')}")
     typer.echo(f"Title: {metadata.get('title')}")
-    typer.echo(f"Bundle: {bundle}")
-    typer.echo(f"Submission package: {package_zip}")
-    typer.echo(f"Submission metadata: {submission_dir / 'ecosystem_submission.json'}")
+    typer.echo(f"Bundle folder: {bundle.name}")
+    typer.echo(f"Submission package: {package_zip.name}")
+    typer.echo("Submission metadata: ecosystem_submission/ecosystem_submission.json")
     if result["contribution_created"]:
         typer.echo(f"Public contribution URL: {result['contribution_url']}")
         typer.echo("No bundle files were uploaded automatically. Attach or submit the generated package according to the repo instructions.")
@@ -2769,7 +2820,7 @@ def ecosystem_contribute(
         typer.echo(str(result.get("gh_error") or ""))
     elif target_repo and _gh_path() and _gh_authenticated() and dry_run:
         typer.echo("Dry run: no GitHub issue was created.")
-        typer.echo(f"Would run: gh issue create --repo {target_repo} --title \"Contribution Bundle: {metadata.get('bundle_id')}\" --body-file {issue_body}")
+        typer.echo(f"Would run: gh issue create --repo {target_repo} --title \"Contribution Bundle: {metadata.get('bundle_id')}\" --body-file GITHUB_ISSUE_BODY.md")
     else:
         typer.echo("No upload was performed in v0.")
         typer.echo(f"Public ecosystem: {_ecosystem_repo_url(target_repo)}")
@@ -2780,8 +2831,8 @@ def ecosystem_contribute(
     typer.echo("")
     typer.echo("Manual public submission steps:")
     typer.echo(f"1. Open {_ecosystem_repo_url(target_repo)} in GitHub.")
-    typer.echo(f"2. Create a new issue using: {issue_body}")
-    typer.echo(f"3. Attach or share the submission package: {package_zip}")
+    typer.echo("2. Create a new issue using: ecosystem_submission/GITHUB_ISSUE_BODY.md")
+    typer.echo(f"3. Attach or share the submission package: {package_zip.name}")
     typer.echo(f"Community Slack: {SLACK_LINK}")
 
 
@@ -3123,8 +3174,8 @@ def bundle_contribute(path: Path=typer.Argument(..., help='Contribution Bundle f
     typer.echo(str(path))
     typer.echo('')
     typer.echo('No upload was performed by this command.')
-    typer.echo(f"Submission package: {package_zip}")
-    typer.echo(f"Submission metadata: {submission_dir / 'ecosystem_submission.json'}")
+    typer.echo(f"Submission package: {package_zip.name}")
+    typer.echo("Submission metadata: ecosystem_submission/ecosystem_submission.json")
     typer.echo('')
     typer.echo('Contribute to public ecosystem:')
     typer.echo(f'apprentice ecosystem contribute {path}')

package/src/agent_apprenticeship_trace/public_sanitizer.py

@@ -16,11 +16,11 @@ CONTROLLER_TELEMETRY_KEYS={
 }
 CONTROLLER_TELEMETRY_PATTERNS=list(CONTROLLER_TELEMETRY_KEYS)
 PUBLIC_OMIT_KEYS={
-    'source_url_or_ref','source_kind','source_url','source_ref','source_license',
+    'source_url_or_ref','source_kind','source_url','source_ref','source_basis','source_license',
     'expected_pay','expected_apprentice_pay',
     'evaluation_mode','data_sharing_level','sensitive_info_masking',
 }
-_ABS_LOCAL_PATH_RE=re.compile(r"(/Users/[^\s\"\']+|/home/[^\s\"\']+|/private/[^\s\"\']+|/tmp/[^\s\"\']+)")
+_ABS_LOCAL_PATH_RE=re.compile(r"(/Users/[^\s\"\']+|/home/[^\s\"\']+|/private/[^\s\"\']+|/tmp/[^\s\"\']+|/var/folders/[^\s\"\']+)")
 _USAGE_RE=re.compile(r"(you['’]?ve hit your usage limit|usage limit|rate limit|quota)", re.I)
 PUBLIC_TEXT_REPLACEMENTS=[
     ("source_url_or_ref", "reference_or_context"),
@@ -29,6 +29,7 @@ PUBLIC_TEXT_REPLACEMENTS=[
     ("source_urls", "reference_links"),
     ("source_url", "reference_link"),
     ("source_ref", "reference_id"),
+    ("source_basis", "reference_basis"),
     ("source_kind", "reference_kind"),
     ("source_license", "reference_license"),
     ("expected_apprentice_pay", "expected_economic_value_for_agent_apprentice"),