agent-apprenticeship 0.1.0 → 0.1.1

package/bin/agent-apprenticeship.js

@@ -34,20 +34,50 @@ function runCandidate(command, args) {
   });
 }
 
-function pythonIsUsable(command) {
+function pythonCheck(command) {
   const check = runCandidate(command, [
     "-c",
     "import sys; raise SystemExit(0 if sys.version_info >= (3, 11) else 1)"
   ]);
-  return !check.error && check.status === 0;
+  return {
+    usable: !check.error && check.status === 0,
+    error: check.error ? String(check.error.message || check.error) : null,
+    status: check.status
+  };
 }
 
 function findPython() {
-  const candidates = [];
-  if (process.env.AA_PYTHON) candidates.push(process.env.AA_PYTHON);
-  candidates.push("python3", "python");
+  if (process.env.AA_PYTHON) {
+    const candidate = expandHome(process.env.AA_PYTHON);
+    const check = pythonCheck(candidate);
+    if (check.usable) return candidate;
+    console.error("AA_PYTHON is set but does not point to Python 3.11 or newer.");
+    console.error(`AA_PYTHON=${candidate}`);
+    console.error("");
+    console.error("Agent Apprenticeship requires Python 3.11 or newer.");
+    console.error("");
+    console.error("macOS Homebrew:");
+    console.error("brew install python@3.11");
+    console.error("");
+    console.error("Or set:");
+    console.error("AA_PYTHON=/path/to/python3.11");
+    process.exit(1);
+  }
+  const candidates = [
+    "python3.13",
+    "python3.12",
+    "python3.11",
+    "/opt/homebrew/bin/python3.13",
+    "/opt/homebrew/bin/python3.12",
+    "/opt/homebrew/bin/python3.11",
+    "/usr/local/bin/python3.13",
+    "/usr/local/bin/python3.12",
+    "/usr/local/bin/python3.11",
+    "python3",
+    "python"
+  ];
   for (const candidate of candidates) {
-    if (pythonIsUsable(candidate)) return candidate;
+    if (pythonCheck(candidate).usable) return candidate;
   }
   return null;
 }
@@ -120,7 +150,12 @@ function runCli(python, args, usePackagedSource) {
 const python = findPython();
 if (!python) {
   console.error("Agent Apprenticeship requires Python 3.11 or newer.");
-  console.error("Install python3 or set AA_PYTHON=/path/to/python.");
+  console.error("");
+  console.error("macOS Homebrew:");
+  console.error("brew install python@3.11");
+  console.error("");
+  console.error("Or set:");
+  console.error("AA_PYTHON=/path/to/python3.11");
   process.exit(1);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-apprenticeship",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agent-apprenticeship"
-version = "0.1.0"
+version = "0.1.1"
 description = "Open framework for turning real agent work into transferable agent experience"
 readme = "README.md"
 requires-python = ">=3.11"

package/src/agent_apprenticeship_trace/__init__.py

@@ -1,2 +1,2 @@
 """Agent Apprenticeship framework."""
-__version__ = "0.1.0"
+__version__ = "0.1.1"

package/src/agent_apprenticeship_trace/cli.py

@@ -289,7 +289,7 @@ def _configure_detected_model_provider(row: dict) -> None:
     )
 
 
-def _first_run_setup(*, interactive: bool) -> None:
+def _first_run_setup(*, interactive: bool, defaults: bool=False) -> None:
     detected_agents = _detect_apprentice_agents()
     typer.echo("")
     if detected_agents:
@@ -298,7 +298,10 @@ def _first_run_setup(*, interactive: bool) -> None:
             typer.echo(f"{idx}. {row['display_name']} - command found ({row['command']})")
         custom_index = len(detected_agents) + 1
         typer.echo(f"{custom_index}. Custom - use a custom command template")
-        if interactive:
+        if defaults:
+            _configure_detected_apprentice_agent(detected_agents[0])
+            typer.echo(f"Configured Apprentice Agent: {detected_agents[0]['display_name']}")
+        elif interactive:
             choice = _choose_detected_index(custom_index, default=1)
             if choice and choice <= len(detected_agents):
                 _configure_detected_apprentice_agent(detected_agents[choice - 1])
@@ -318,7 +321,10 @@ def _first_run_setup(*, interactive: bool) -> None:
         typer.echo("Detected Mentor Model Provider keys:")
         for idx, row in enumerate(detected_providers, 1):
             typer.echo(f"{idx}. {row['display_name']} - {row['api_key_env_var']} visible")
-        if interactive:
+        if defaults:
+            _configure_detected_model_provider(detected_providers[0])
+            typer.echo(f"Configured Mentor Model Provider: {detected_providers[0]['display_name']}")
+        elif interactive:
             choice = _choose_detected_index(len(detected_providers), default=1)
             if choice:
                 _configure_detected_model_provider(detected_providers[choice - 1])
@@ -641,10 +647,13 @@ def _ensure_apprentice_agent_ready(settings, runner: str | None=None, interactiv
 def init(
     overwrite: bool=typer.Option(False, help='Replace existing settings.json with defaults.'),
     setup: bool=typer.Option(False, '--setup', help='Detect installed Apprentice Agents and Mentor Model Provider keys.'),
+    defaults: bool=typer.Option(False, '--defaults', '--non-interactive', help='Initialize with deterministic defaults and never prompt.'),
 ):
     path=init_settings(overwrite=overwrite)
     typer.echo(f'initialized Agent Apprenticeship settings at {path}')
-    if setup or sys.stdin.isatty():
+    if defaults:
+        _first_run_setup(interactive=False, defaults=True)
+    elif setup or sys.stdin.isatty():
         _first_run_setup(interactive=bool(setup or sys.stdin.isatty()))
 
 @app.command('settings')
@@ -2812,27 +2821,27 @@ def bundle_contribute(path: Path=typer.Argument(..., help='Contribution Bundle f
     typer.echo('View files:')
     typer.echo(f'open {path}')
 
-@app.command('init-env')
+@app.command('init-env', hidden=True)
 def init_env():
     dst=Path('.env.local')
     if not dst.exists(): shutil.copyfile('.env.example', dst); typer.echo('created .env.local from .env.example')
     else: typer.echo('.env.local already exists')
 
-@app.command('run-task')
+@app.command('run-task', hidden=True)
 def run_task(input: Path=typer.Option(Path('data/seed_tasks/hard_finance_reconciliation.jsonl')), output_root: Path=Path('outputs'), runner: str='deterministic'):
     raw=RawTaskRecord.model_validate(read_jsonl(input)[0])
     run_root=output_root/'runs'/'single'
     pkg=run_one(raw, run_root, runner=runner); typer.echo(str(pkg))
 
-@app.command('run-batch')
+@app.command('run-batch', hidden=True)
 def run_batch(input: Path=typer.Option(...), limit: int|None=None, resume: bool=False, max_parallel: int=1, retry_limit: int=0, task_timeout_seconds: int=900, runner: str='deterministic', release_id: str|None=None, output_root: Path=Path('outputs'), max_iterations: int|None=None):
     typer.echo(str(run_batch_impl(input, output_root, limit, resume, max_parallel, retry_limit, task_timeout_seconds, runner, release_id, max_iterations=max_iterations)))
 
-@app.command('run-many')
+@app.command('run-many', hidden=True)
 def run_many(input: Path=typer.Option(...), limit: int|None=None, resume: bool=False, max_parallel: int=1, retry_limit: int=0, task_timeout_seconds: int=900, runner: str='deterministic', release_id: str|None=None, output_root: Path=Path('outputs'), max_iterations: int|None=None):
     typer.echo(str(run_batch_impl(input, output_root, limit, resume, max_parallel, retry_limit, task_timeout_seconds, runner, release_id, max_iterations=max_iterations)))
 
-@app.command('create-bundle')
+@app.command('create-bundle', hidden=True)
 def create_bundle(
     run_root: Path=typer.Option(...),
     bundle_root: Path|None=typer.Option(None),
@@ -2841,15 +2850,15 @@ def create_bundle(
 ):
     typer.echo(str(create_contribution_bundle(run_root, bundle_root, include_debug=include_debug, release_style=release_style)))
 
-@app.command('create-release')
+@app.command('create-release', hidden=True)
 def create_release(run_root: Path=typer.Option(Path('outputs/runs/single')), release_root: Path=typer.Option(Path('outputs/releases/manual'))):
     typer.echo(str(create_release_impl(run_root, release_root)))
 
-@app.command('validate-release')
+@app.command('validate-release', hidden=True)
 def validate_release(release_root: Path=typer.Option(...)):
     c=validate_release_impl(release_root); typer.echo(format_counters(c)); raise typer.Exit(0 if c['release_valid'] else 1)
 
-@app.command('validate-public-release')
+@app.command('validate-public-release', hidden=True)
 def validate_public_release(release_root: Path=typer.Option(...)):
     public=release_root/'public' if (release_root/'public').exists() else release_root
     c=validate_release_impl(release_root if (release_root/'public').exists() else release_root.parent) if public.name == 'public' else validate_release_impl(release_root)
@@ -2857,7 +2866,7 @@ def validate_public_release(release_root: Path=typer.Option(...)):
     raise typer.Exit(0 if c.get('public_release_valid') else 1)
 
 
-@app.command('repair-roles')
+@app.command('repair-roles', hidden=True)
 def repair_roles(run_root: Path=typer.Option(...), task_id: str=typer.Option(...), roles: str=typer.Option('evaluator_agent,grader_agent,verifier_agent'), attempts: str=typer.Option('baseline,revised'), rebuild_release: Path|None=typer.Option(None)):
     """Re-run model evaluation roles from existing task package artifacts/traces."""
     from .schemas import RubricSpec, ActualOutputs, AgentTrace, GraderResult, VerifierResult
@@ -2916,7 +2925,7 @@ def repair_roles(run_root: Path=typer.Option(...), task_id: str=typer.Option(...
         typer.echo(f'rebuilt release={rebuild_release}')
 
 
-@app.command('summarize-releases')
+@app.command('summarize-releases', hidden=True)
 def summarize_releases(release_root: Path=typer.Option(Path('outputs/releases')), pattern: str=typer.Option('tasks-*')):
     """Summarize release readiness across a release directory."""
     from .validation import validate_release
@@ -2952,17 +2961,17 @@ def summarize_releases(release_root: Path=typer.Option(Path('outputs/releases'))
     typer.echo('task_ids_publishable_with_warnings=' + ','.join(warnings))
     typer.echo('task_ids_clean_publishable=' + ','.join(clean))
 
-@app.command('inspect-trace')
+@app.command('inspect-trace', hidden=True)
 def inspect_trace(trace_path: Path):
     t=AgentTrace.model_validate_json(trace_path.read_text()); typer.echo(f'trace_id={t.trace_id}\ntask_id={t.task_id}\nsteps={len(t.steps)}')
 
-@app.command('codex-smoke')
+@app.command('codex-smoke', hidden=True)
 def codex_smoke():
     if not shutil.which('codex'):
         typer.echo('codex_available=false'); raise typer.Exit(1)
     typer.echo('codex_available=true')
 
-@app.command('llm-smoke')
+@app.command('llm-smoke', hidden=True)
 def llm_smoke(
     output_dir: Path=Path('outputs/llm_smoke'),
     provider: str | None=typer.Option(None, '--provider', help='Mentor Model Provider id to test. Defaults to configured provider.'),