apsimo 1.4.3__tar.gz → 1.4.5__tar.gz

{apsimo-1.4.3 → apsimo-1.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apsimo
-Version: 1.4.3
+Version: 1.4.5
 Summary: Persistent identity, memory and autonomy for AI agents
 License-Expression: MIT
 Requires-Python: >=3.11
@@ -28,15 +28,13 @@ Requires-Dist: pandas>=2.0; extra == "vectors"
 Requires-Dist: pyarrow>=15.0; extra == "vectors"
 Requires-Dist: lancedb>=0.10; extra == "vectors"
 Provides-Extra: hermes
-Requires-Dist: apsimo-hermes<2,>=1.4.3; extra == "hermes"
+Requires-Dist: apsimo-hermes<2,>=1.4.5; extra == "hermes"
 Provides-Extra: mcp
 Requires-Dist: mcp[cli]<2,>=1.0; extra == "mcp"
 Provides-Extra: lancedb
 Requires-Dist: lancedb>=0.6; extra == "lancedb"
 Requires-Dist: pyarrow>=14.0; extra == "lancedb"
 Requires-Dist: pandas>=2.0; extra == "lancedb"
-Provides-Extra: postgres
-Requires-Dist: asyncpg>=0.29; extra == "postgres"
 Provides-Extra: extraction
 Requires-Dist: PyMuPDF>=1.24; extra == "extraction"
 Requires-Dist: beautifulsoup4>=4.12; extra == "extraction"

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/api/routers/host.py

@@ -485,8 +485,6 @@ def supported_capabilities() -> List[str]:
     if _world_store is not None:
         caps.append("context")
         caps.append("world_model_api")
-    if _world_store is not None and hasattr(_world_store, '_config') and _world_store._config.backend == "neo4j":
-        caps.append("neo4j_backend")
     caps.append("event_journal")
     if _external_event_intake is not None:
         caps.append("external_cognition_events")
@@ -820,8 +818,6 @@ async def health() -> HostHealthResponse:
     if _world_store is not None and hasattr(_world_store, '_backend') and _world_store._backend is not None:
         backend_type = type(_world_store._backend).__name__
         notes["world_model_backend"] = f"{backend_type} connected"
-    if _world_store is not None and hasattr(_world_store, '_config') and _world_store._config.backend == "neo4j":
-        notes["neo4j"] = "Neo4j backend selected"
 
     health_status = "ok"
     if model_mismatch or embed_degraded or memory_backend_down:
@@ -2520,7 +2516,7 @@ async def context_assemble(
 
     # --- Memory: authorized candidates, one selection and one budget ---
     if _canonical_person_allowed and query_text:
-        from apsimo.intelligence.graph.recall import source_candidates
+        from apsimo.memory.recall import source_candidates
         beliefs, quotations, source_hits, semantic_media = [], [], [], []
         source_ledger = None
         if not _canonical_only and _graph is not None:
@@ -2585,7 +2581,7 @@ async def context_assemble(
                     contact_tz, body.context.timezone or ("UTC" if _canonical_only else None)))
             if source_ledger is not None:
                 from apsimo.beliefs.source_projection import SourceClaimProjection
-                from apsimo.intelligence.graph.selection import current_work_query
+                from apsimo.memory.selection import current_work_query
                 beliefs, quotations = SourceClaimProjection(source_ledger).prepare_context(
                     beliefs, source_hits, contact_id=body.context.contact_id,
                     session_id=body.context.session_id, time_query=time_query,
@@ -2602,7 +2598,7 @@ async def context_assemble(
                     # The projected view preserves envelope and current-source
                     # checks. A fact needs query overlap before any fail-open
                     # reranker path; confidence alone never makes it relevant.
-                    from apsimo.intelligence.graph.recall import contact_fact_candidates
+                    from apsimo.memory.recall import contact_fact_candidates
                     fact_result = _tom_context_facts.list_facts(
                         contact_id=body.context.contact_id, limit=512)
                     facts = fact_result if isinstance(fact_result, list) else fact_result.get('facts', [])
@@ -2627,7 +2623,7 @@ async def context_assemble(
                 from apsimo.turns.source_annotations import current_candidates
                 retained = current_candidates(source_ledger, selected, **annotation_scope)
                 if len(retained) != len(selected):
-                    from apsimo.intelligence.graph.recall import pack_memory_context
+                    from apsimo.memory.recall import pack_memory_context
                     selected, body_text = pack_memory_context(retained, limit=5,
                         max_chars=max(0, min(max_chars, 24000)))
             if body_text:
@@ -11288,7 +11284,7 @@ async def enriched_context(
             and (_p8_runtime is None or _enriched_p8_viewer is not None):
         async def _shared_facts():
             try:
-                from apsimo.intelligence.graph.recall import contact_fact_candidates, pack_memory_context
+                from apsimo.memory.recall import contact_fact_candidates, pack_memory_context
                 from apsimo.turns.source_annotations import expand, current_candidates
                 store = _p8_runtime.facts_store if _p8_runtime is not None else _facts_store
                 view = (_p8_runtime.projected_facts_view(_enriched_p8_viewer,
@@ -11729,8 +11725,8 @@ def _memory_context_selector():
     """Keep one selector per active reranker, also usable without graph storage."""
     global _context_recall_selector
     if _context_recall_selector is None or _context_recall_selector[0] is not _reranker:
-        from apsimo.intelligence.graph.selection import RecallSelector
-        from apsimo.intelligence.graph.recall import provider_calibration_metadata
+        from apsimo.memory.selection import RecallSelector
+        from apsimo.memory.recall import provider_calibration_metadata
         provider = _reranker
         selector = RecallSelector(
             provider.rerank if provider is not None else None,
@@ -12032,20 +12028,6 @@ async def executor_status() -> dict:
     }
 
 
-# ---------------------------------------------------------------------------
-# Self-Knowledge Seeding
-# ---------------------------------------------------------------------------
-
-
-class SeedResponse(BaseModel):
-    memories: int = 0
-    entities: int = 0
-    skills: int = 0
-    insights: int = 0
-    errors: list[str] = []
-    skipped: list[str] = []  # Machine-readable dispositions, including retirement
-
-
 # ---------------------------------------------------------------------------
 # Commitment Tracking
 # ---------------------------------------------------------------------------
@@ -13043,14 +13025,6 @@ async def extract_tom(
     )
 
 
-@router.post("/seed", response_model=SeedResponse)
-async def seed_self_knowledge_endpoint(force: bool = Query(False, description="Compatibility flag; built-in seeding remains retired")) -> SeedResponse:
-    """Return the retired built-in seeding disposition without opening stores."""
-    from apsimo.seed import seed_self_knowledge
-
-    return SeedResponse(**await seed_self_knowledge(force=force))
-
-
 # ============================================================================
 # World Model — Entity CRUD
 # ============================================================================
@@ -13062,7 +13036,7 @@ async def create_world_entity(body: WorldEntityCreateRequest) -> WorldEntityDeta
         raise HTTPException(status_code=501, detail="World model not initialized")
     try:
         from apsimo.world_model.entities import BaseEntity, ENTITY_CLASS_MAP
-        from apsimo.world_model.neo4j.backend import _generate_id
+        from apsimo.world_model.sqlite.backend import _generate_id
         cls = ENTITY_CLASS_MAP.get(body.entity_type, BaseEntity)
         import dataclasses
         valid = {f.name for f in dataclasses.fields(cls)}
@@ -13155,7 +13129,7 @@ async def create_world_relationship(body: WorldRelationshipCreateRequest) -> Wor
         raise HTTPException(status_code=501, detail="World model not initialized")
     try:
         from apsimo.world_model.relationships import WorldRelationship
-        from apsimo.world_model.neo4j.backend import _generate_id
+        from apsimo.world_model.sqlite.backend import _generate_id
         now = datetime.now(timezone.utc).isoformat()
         rel = WorldRelationship(
             id=_generate_id("wr"),

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/beliefs/source_projection.py

@@ -470,7 +470,7 @@ class SourceClaimProjection:
         Unknown, corrected, changed, multiple-input and cross-scope provenance
         remains recallable. This transient hint never changes stored history.
         """
-        from apsimo.intelligence.graph.selection import current_work_query
+        from apsimo.memory.selection import current_work_query
         from apsimo.turns.idempotency import canonical_turn_digest, source_message_hash
         if message.get('role') != 'assistant' or source['scope'] != 'person':
             return False
@@ -521,7 +521,7 @@ class SourceClaimProjection:
         """
         from apsimo.turns.idempotency import source_message_hash
         from apsimo.turns.audio import source_text
-        from apsimo.intelligence.graph.recall import source_candidates
+        from apsimo.memory.recall import source_candidates
         turn_ids = list(dict.fromkeys(
             [row["turn_id"] for row in source_hits] + [str(row["source_uri"])[5:] for row in beliefs
              if str(row.get("source_uri") or "").startswith("turn:")]))

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/cli.py

@@ -43,6 +43,7 @@ def main() -> None:
     init_p.add_argument("--quiet-hours", help="Optional local follow-up quiet window, HH:MM-HH:MM; grants no outreach permission")
     init_p.add_argument("--whatsapp-read-receipts", choices=["on", "off"], help="Set this Hermes profile's read receipts for accepted WhatsApp messages; omission preserves its setting")
     init_p.add_argument("--preferences-only", action="store_true", help="Update only an existing Hermes config preference; skip instance and model setup")
+    init_p.add_argument("--skills-only", action="store_true", help="Install or explicitly refresh owned bundled skills in one Hermes profile; no instance or model setup")
     init_p.add_argument("--preview", action="store_true", help="With --preferences-only, show changed preference paths without writing")
     init_p.add_argument("--model-url", help="One local OpenAI-compatible API root")
     init_p.add_argument("--model", help="Model identifier at that endpoint")
@@ -105,11 +106,6 @@ def main() -> None:
     # --- generate-types ---
     sub.add_parser("generate-types", help="Export OpenAPI spec (for TypeScript generation)")
 
-    # --- seed ---
-    seed_p = sub.add_parser("seed", help="Show the retired built-in seeding disposition")
-    seed_p.add_argument("--verify", action="store_true", help="Compatibility flag; show the retirement disposition")
-    seed_p.add_argument("--force", action="store_true", help="Compatibility flag; built-in seeding remains retired")
-
     # --- backfill ---
     backfill_p = sub.add_parser("backfill", help="Re-embed all vectors with current model")
     backfill_p.add_argument("--collection", default=None, help="Specific collection to backfill (default: all)")
@@ -318,7 +314,7 @@ def main() -> None:
         code = run_init(root_dir=args.dir, args=args)
         if code != 0:
             sys.exit(code)
-        if args.preferences_only:
+        if args.preferences_only or args.skills_only:
             return
 
         # Initialize Apsimo identity if not already done
@@ -441,10 +437,6 @@ def main() -> None:
         p = len(spec.get("paths", {}))
         print(f"✅ OpenAPI spec written to {out} ({n} schemas, {p} paths)")
 
-    elif args.command == "seed":
-        from apsimo.seed import seed_self_knowledge_summary
-        print(seed_self_knowledge_summary())
-
     elif args.command == "backfill":
         _load_dotenv()
         import httpx
@@ -2398,8 +2390,8 @@ def _cmd_validate(args) -> None:
     if llm_ok and len(found) >= 2:
         print("  ✅ Full sidecar pipeline working — context assembly + LLM router live")
     elif llm_ok:
-        print("  ⚠️ LLM live but cognitive context sections are thin — seed data "
-              "or run a few turns, then re-validate")
+        print("  ⚠️ LLM live but cognitive context sections are thin — run a few "
+              "ordinary turns and check their retained evidence")
     else:
         print("  ⚪ LLM not verified — context pipeline validated, reasoning not")
 

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/intelligence/graph/client.py

@@ -1260,7 +1260,7 @@ class ColonyGraph:
                             memories.append(mem)
 
                 if hybrid:
-                    from .recall import fuse_candidates
+                    from apsimo.memory.recall import fuse_candidates
                     candidate_limit = min(max(limit * 5, limit), max(100, limit))
                     lexical = await self._recall_lexical(
                         query, candidate_limit, min_strength, min_confidence,
@@ -1394,7 +1394,7 @@ class ColonyGraph:
         content reaches Python/reranking. A missing/populating index degrades
         to the existing vector/keyword path.
         """
-        from .recall import FULLTEXT_INDEX, lexical_query
+        from .queries import FULLTEXT_INDEX, lexical_query
         search_text = lexical_query(query)
         if not search_text:
             return []
@@ -1468,7 +1468,7 @@ class ColonyGraph:
         self, query, memories, limit, *, strength_ranking=False,
     ):
         # The same selector is used for mixed source/belief turn context.
-        from .selection import RecallSelector
+        from apsimo.memory.selection import RecallSelector
         selector = getattr(self, "_recall_selector", None)
         if selector is None:
             selector = self._recall_selector = RecallSelector(

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/intelligence/graph/queries.py

@@ -7,6 +7,16 @@ and makes it easy to test / review / optimise in one place.
 Parameters are referenced with ``$param`` syntax for Neo4j driver binding.
 """
 
+FULLTEXT_INDEX = "memory_content_fulltext"
+
+
+def lexical_query(text: str, max_terms: int = 16) -> str:
+    """Literal words/identifiers, not caller-supplied Lucene operators."""
+    from apsimo.memory.recall import lexical_terms
+
+    return " OR ".join(f'"{word}"' for word in lexical_terms(text, max_terms))
+
+
 # ──────────────────────────────────────────────────────────────────────
 # Memory operations
 # ──────────────────────────────────────────────────────────────────────

apsimo-1.4.5/apsimo/memory/__init__.py

@@ -0,0 +1 @@
+"""Shared evidence selection and rendering for Apsimo memory."""

{apsimo-1.4.3/apsimo/intelligence/graph → apsimo-1.4.5/apsimo/memory}/recall.py

@@ -1,4 +1,4 @@
-"""Small retrieval helpers shared by the existing graph/vector recall path."""
+"""Shared source candidates, rank fusion and bounded memory rendering."""
 from __future__ import annotations
 
 import re
@@ -7,7 +7,6 @@ import json
 import os
 from typing import Any
 
-FULLTEXT_INDEX = "memory_content_fulltext"
 _WORDS = re.compile(r"[^\W_]+(?:[-.][^\W_]+)*", re.UNICODE)
 _STOP = frozenset("a an and are as at be by do does for from how i in is it me of on or that the this to was what when where which who with you".split())
 
@@ -209,11 +208,6 @@ def lexical_terms(text: str, max_terms: int = 16) -> list[str]:
     return list(words)[:max_terms]
 
 
-def lexical_query(text: str, max_terms: int = 16) -> str:
-    """Literal words/identifiers, not caller-supplied Lucene operators."""
-    return " OR ".join(f'"{word}"' for word in lexical_terms(text, max_terms))
-
-
 def contact_fact_candidates(query: str, facts: list[dict[str, Any]], *, limit: int = 25) -> list[dict[str, Any]]:
     """Lexical candidates from an authorized, current source-linked fact view.
 

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/qualification/memory_cases.py

@@ -13,7 +13,7 @@ from .records import CaseSpec
 
 def _recollect(projection, query, *, contact, session, now, max_chars):
     from apsimo.beliefs.source_time import interpret_time_query
-    from apsimo.intelligence.graph.recall import pack_memory_context
+    from apsimo.memory.recall import pack_memory_context
     from apsimo.turns.source_annotations import expand, current_candidates
     ledger = projection.ledger
     hits = ledger.search_sources(query, contact_id=contact, session_id=session, limit=10)

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/server.py

@@ -1861,7 +1861,7 @@ async def lifespan(app: FastAPI):
             # set_embed_fn wiring above). Registration alone changes
             # nothing: use is gated by COLONY_RECALL_RERANK (default off).
             if graph is not None and hasattr(graph, "set_rerank_fn"):
-                from apsimo.intelligence.graph.recall import provider_calibration_metadata
+                from apsimo.memory.recall import provider_calibration_metadata
                 def recall_calibration_metadata():
                     return provider_calibration_metadata(reranker_provider)
                 graph.set_rerank_fn(
@@ -2592,11 +2592,10 @@ async def lifespan(app: FastAPI):
     try:
         from apsimo.world_model.store import WorldModelStore
         from apsimo.world_model.config import WorldModelConfig
-        _wm_backend = os.environ.get("WORLD_MODEL_BACKEND", "sqlite")
-        world_store = WorldModelStore(WorldModelConfig(backend=_wm_backend))
+        world_store = WorldModelStore(WorldModelConfig())
         await world_store.connect()
         set_world_store(world_store)
-        logger.info("WorldModelStore initialized and connected (backend=%s)", _wm_backend)
+        logger.info("WorldModelStore connected to SQLite")
 
         # World-model population from conversation (shadow-first). Boundary-checked
         # via the directive manager. Mode from COLONY_WORLD_POPULATE_MODE
@@ -2687,13 +2686,8 @@ async def lifespan(app: FastAPI):
             logger.warning("Extraction pipeline init skipped: %s", eexc)
     except Exception as exc:
         logger.warning("WorldModelStore init failed: %s", exc)
-        # Try without connect() — some operations work without it
-        try:
-            world_store = WorldModelStore(WorldModelConfig(backend=_wm_backend))
-            set_world_store(world_store)
-            logger.info("WorldModelStore initialized (without connect)")
-        except Exception as exc2:
-            logger.error("WorldModelStore fallback init also failed: %s", exc2)
+        world_store = None
+        set_world_store(None)
 
     # --- 11. Cognition (CognitionPipeline) ---
     cognition_pipeline = None

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/setup.py

@@ -9,7 +9,6 @@ Guides the user through first-time configuration:
 6. Write .env
 7. Database setup
 8. Autonomy & approvals (owner contact, approval policy, gates, home channel)
-9. Self-knowledge seeding
 10. Start sidecar + verify (10e: schedule agent workers via crontab)
 11. Summary
 12. Health check (colony doctor)
@@ -1685,14 +1684,14 @@ def run_autonomy_step(
 #: (for the `python -m` fallback) and cron schedule.
 WORKER_SPECS = (
     {
-        "name": "colony-queue-worker",
+        "name": "apsimo-queue-worker",
         "module": "apsimo.workers.queue_worker",
         "schedule": "*/5 * * * *",
         "blurb": "claims approved agent_action jobs every 5 minutes and hands "
                  "them to your agent (without it, auto-approved jobs sit QUEUED forever)",
     },
     {
-        "name": "colony-skills-sync",
+        "name": "apsimo-skills-sync",
         "module": "apsimo.workers.skills_sync",
         "schedule": "0 9 * * *",
         "blurb": "reports your agent's installed skill index to Apsimo once a "
@@ -1947,7 +1946,7 @@ def run_init(root_dir: str | None = None, args=None) -> int:
         root_dir: Root directory for config files
         args: Parsed argparse Namespace for non-interactive mode
     """
-    if (getattr(args, 'owner_handle', None) or getattr(args, 'preferences_only', False) or getattr(args, 'preview', False)
+    if (getattr(args, 'owner_handle', None) or getattr(args, 'preferences_only', False) or getattr(args, 'skills_only', False) or getattr(args, 'preview', False)
             or getattr(args, 'whatsapp_read_receipts', None) is not None):
         if (getattr(args, 'no_harness', False) or getattr(args, 'mcp_harnesses', None)
                 or getattr(args, 'host_framework', None) not in (None, 'hermes')):
@@ -2378,7 +2377,6 @@ def run_init(root_dir: str | None = None, args=None) -> int:
         "NEO4J_USER": existing.get("NEO4J_USER", "neo4j"),
         "NEO4J_PASSWORD": neo4j_password or existing.get("NEO4J_PASSWORD", ""),
         "NEO4J_DATABASE": existing.get("NEO4J_DATABASE", "neo4j"),
-        "WORLD_MODEL_BACKEND": existing.get("WORLD_MODEL_BACKEND", "neo4j" if neo4j_password else "sqlite"),
         "COLONY_API_KEY": existing.get("COLONY_API_KEY", secrets.token_urlsafe(32)),
         "COLONY_CONTACTS_DB": existing.get("COLONY_CONTACTS_DB", str(colony_home / "data" / "contacts.db")),
         "COLONY_EMBED_PROVIDER": embed_provider,

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/setup_hermes.py

@@ -282,7 +282,7 @@ def _select_home(args, ask):
 
 
 def _adapter_resources(wheel=None):
-    packages = ('apsimo_hermes/', 'apsimo_memory/', 'colony_hermes/', 'colony_memory/')
+    packages = ('apsimo_hermes/', 'apsimo_memory/')
     if wheel:
         with zipfile.ZipFile(wheel) as archive:
             resources = {name: archive.read(name) for name in archive.namelist()
@@ -344,13 +344,6 @@ import hashlib, importlib.metadata, importlib.util, json, sys
 from pathlib import Path
 expected = json.load(sys.stdin)
 entries = importlib.metadata.entry_points()
-aliases = []
-for group, name, target in [('hermes_agent.plugins', 'colony', 'apsimo_hermes'),
-                            ('hermes_agent.memory_providers', 'colony-memory', 'apsimo_memory')]:
-    matches = [ep for ep in entries.select(group=group) if ep.name == name]
-    if len(matches) > 1 or any(ep.value != target for ep in matches):
-        raise ValueError('Conflicting legacy adapter distribution or target')
-    aliases.extend(matches)
 selected = []
 for group, name, module in [('hermes_agent.plugins', 'apsimo', 'apsimo_hermes'),
                             ('hermes_agent.memory_providers', 'apsimo-memory', 'apsimo_memory')]:
@@ -358,14 +351,14 @@ for group, name, module in [('hermes_agent.plugins', 'apsimo', 'apsimo_hermes'),
     if len(matches) > 1 or (matches and matches[0].value != module):
         raise ValueError('Conflicting Apsimo entry point')
     selected.append(matches[0] if matches else None)
-if not any(selected) and not aliases:
+if not any(selected):
     print(json.dumps({'mode': 'private-directory'}))
     sys.exit(0)
 if not all(selected):
     raise ValueError('Both canonical native Apsimo entry points are required')
-identities = {(ep.dist.metadata['Name'].lower().replace('_', '-'), ep.dist.version) for ep in [*selected, *aliases]}
+identities = {(ep.dist.metadata['Name'].lower().replace('_', '-'), ep.dist.version) for ep in selected}
 if len(identities) != 1:
-    raise ValueError('Canonical and legacy adapter registrations come from different distributions')
+    raise ValueError('Canonical adapter registrations come from different distributions')
 sources, external_modules, versions = {}, {}, set()
 for ep in selected:
     module = ep.value
@@ -473,14 +466,14 @@ def refresh_adapter(state, args):
                 raise ValueError('Expected one managed adapter directory; reconcile duplicate or missing bindings')
             directory = directories[0]
             forwarder = directory/'__init__.py'
-            modules = ('apsimo_memory','colony_memory') if memory else ('apsimo_hermes','colony_hermes')
+            modules = ('apsimo_memory',) if memory else ('apsimo_hermes',)
             matches = [module for module in modules if not forwarder.is_symlink()
                        and forwarder.read_text() == _forwarder(adapter, module, memory)]
             if len(matches) != 1:
                 raise ValueError('The selected profile adapter forwarder changed; reconcile it before refreshing')
             module = matches[0]
             if module+'/__init__.py' not in resources:
-                raise ValueError('New adapter lacks the compatibility module required by this forwarder')
+                raise ValueError('New adapter lacks the canonical module required by this forwarder')
             target = directory/'plugin.yaml'
             if target.is_symlink() or target.read_bytes() != old_resources[module+'/plugin.yaml']:
                 raise ValueError('The selected profile adapter manifest changed; reconcile it before refreshing')
@@ -576,14 +569,25 @@ def run(root_dir=None, args=None):
     try:
         receipt_choice = getattr(args, 'whatsapp_read_receipts', None)
         preferences_only = bool(getattr(args, 'preferences_only', False))
+        skills_only = bool(getattr(args, 'skills_only', False))
         preview = bool(getattr(args, 'preview', False))
-        if preferences_only:
+        if preferences_only or skills_only:
             home = setup._resolve_hermes_home(getattr(args, 'hermes_home', None))
             selected_python = None
         else:
             home, selected_python = _select_home(args, ask)
         if preview and not preferences_only:
             raise ValueError('--preview requires --preferences-only')
+        if skills_only:
+            if root_dir or receipt_choice or any(getattr(args, name, None) for name in (
+                    'preferences_only', 'preview', 'start', 'refresh_adapter', 'replace_memory_provider',
+                    'local_work', 'native_goals', 'native_reviews', 'model_url', 'model', 'agent_name',
+                    'agent_values', 'timezone', 'quiet_hours', 'contact_name', 'owner_handle', 'encrypt',
+                    'passphrase', 'claim_genesis', 'mcp_harnesses', 'no_harness')):
+                raise ValueError('--skills-only cannot be combined with instance or preference changes')
+            from .setup_skills import prepare, install
+            install(prepare(home, _adapter_resources(getattr(args, 'adapter_wheel', None)), refresh=True))
+            return 0
         if preferences_only:
             if receipt_choice is None:
                 raise ValueError('--preferences-only requires --whatsapp-read-receipts on or off')
@@ -680,6 +684,8 @@ def run(root_dir=None, args=None):
         resources = _adapter_resources(getattr(args, 'adapter_wheel', None))
         _preflight_outbox(home, resources)
         binding = _adapter_binding(python, resources)
+        from .setup_skills import prepare as prepare_skills, install as install_skills
+        skill_updates = prepare_skills(home, resources)
         owner_name = ask('Your name', getattr(args, 'contact_name', None) or os.environ.get('USER', 'Owner'), True)
         owner_handles, owner_platforms = _owner_handles(args, ask, noninteractive)
         agent_name = ask('Agent name', getattr(args, 'agent_name', None) or 'Assistant', True)
@@ -771,7 +777,7 @@ def run(root_dir=None, args=None):
                 'COLONY_PERSONA_NAME': agent_name, 'COLONY_CONTACTS_DB': str(state/'contacts.db'),
                 'COLONY_API_KEYRING_PATH': str(state/'api-keyring.json'), 'COLONY_API_KEY': '',
                 'COLONY_CLIENT_API_KEY': key, 'COLONY_GRAPH_ENABLED': 'false',
-                'COLONY_EMBED_PROVIDER': 'skip', 'WORLD_MODEL_BACKEND': 'sqlite',
+                'COLONY_EMBED_PROVIDER': 'skip',
                 'COLONY_AUTONOMY_PRESET': 'passive', 'COLONY_EMBEDDED_WORKER_ENABLED': 'false',
                 'COLONY_SOURCE_CLAIMS': 'on'}
             values.update({
@@ -865,6 +871,7 @@ def run(root_dir=None, args=None):
                 guiding = ('Guiding values: ' + ', '.join(agent_preferences['values']) + '.\n'
                            if agent_preferences['values'] else '')
                 create(home/'SOUL.md', f'# {agent_name}\n\nYou are {agent_name}, the personal assistant of {owner_name}.\n{guiding}Use retained evidence with its provenance; ask about uncertainty.\nYour opinions are revisable interpretations; distinguish them from facts and permissions.\nOwner consent is required for consequential external actions; an existing task-scoped consent covers only its stated scope.\n')
+            install_skills(skill_updates)
         except Exception:
             # Undo only this installation's exact bytes. Concurrent edits stay
             # intact, with original files still retained in the private state.

apsimo-1.4.5/apsimo/setup_skills.py

@@ -0,0 +1,90 @@
+"""Install owned bundled skills into one native Hermes catalog."""
+from __future__ import annotations
+
+import hashlib
+import json
+from pathlib import Path
+import re
+
+
+SKILL_NAME = 'apsimo-deep-research'
+BUNDLE_PREFIX = 'apsimo_hermes/bundled_skills/'
+SKILL_RESOURCE = f'{BUNDLE_PREFIX}{SKILL_NAME}/SKILL.md'
+
+
+def _read_owned_path(path):
+    for parent in (path, *path.parents):
+        if parent.is_symlink():
+            raise ValueError('Bundled skill destination is symlinked; existing files were preserved')
+    return path.read_bytes() if path.exists() else None
+
+
+def prepare(home, resources, *, refresh=False):
+    """Validate all packaged skill preimages before any setup writes/probe."""
+    updates = []
+    for path, content in sorted(resources.items()):
+        if not path.startswith(BUNDLE_PREFIX) or not path.endswith('/SKILL.md'):
+            continue
+        name = path[len(BUNDLE_PREFIX):-len('/SKILL.md')]
+        if not re.fullmatch(r'apsimo-[a-z0-9-]{1,56}', name):
+            raise ValueError('Bundled skill must have a canonical apsimo- name')
+        updates.extend(_prepare_skill(home, name, content, refresh=refresh))
+    if not updates:
+        raise ValueError('Selected adapter has no bundled skills')
+    return updates
+
+
+def _prepare_skill(home, name, content, *, refresh):
+    if not content:
+        raise ValueError('Selected adapter has an empty bundled skill')
+    directory = Path(home)/'skills'/name
+    skill, marker = directory/'SKILL.md', directory/'.apsimo-owned.json'
+    previous, recorded = _read_owned_path(skill), _read_owned_path(marker)
+    digest = hashlib.sha256(content).hexdigest()
+    if recorded is None:
+        if directory.exists():
+            raise ValueError('Unowned bundled skill destination was preserved; choose another profile or move your copy')
+    else:
+        try:
+            record = json.loads(recorded)
+            owned = (record['owner'] == 'apsimo-hermes' and record['version'] == 1
+                     and previous is not None
+                     and record['sha256'] == hashlib.sha256(previous).hexdigest())
+        except (ValueError, KeyError, TypeError):
+            owned = False
+        if not owned:
+            raise ValueError('Locally modified bundled skill was preserved; keep your copy or reconcile it before refreshing')
+        if previous != content and not refresh:
+            raise ValueError('Bundled skill update requires explicit apsimo init --skills-only')
+    after = (json.dumps({'owner': 'apsimo-hermes', 'version': 1, 'sha256': digest},
+                        sort_keys=True, indent=2)+'\n').encode()
+    return [(skill, previous, content), (marker, recorded, after)]
+
+
+def install(updates):
+    """Replace only previously verified owned bytes; retain local edits on conflict."""
+    from .setup import _atomic_hermes_config_write
+    for path, before, _ in updates:
+        if _read_owned_path(path) != before:
+            raise ValueError('Bundled skill changed during installation; current files were preserved')
+    completed = []
+    try:
+        for path, before, after in updates:
+            if before != after:
+                path.parent.mkdir(parents=True, exist_ok=True, mode=0o700)
+                _atomic_hermes_config_write(path, before, after)
+                completed.append((path, before, after))
+    except Exception:
+        for path, before, after in reversed(completed):
+            if _read_owned_path(path) == after:
+                if before is None:
+                    path.unlink()
+                else:
+                    _atomic_hermes_config_write(path, after, before)
+        # A failed first installation leaves no false ownership claim.
+        for directory in {path.parent for path, _, _ in updates}:
+            if directory.is_dir() and not any(directory.iterdir()):
+                directory.rmdir()
+        raise
+    names = sorted({path.parent.name for path, _, _ in updates})
+    print('Bundled skills available: '+', '.join(names)+'. With this Apsimo adapter version active, ongoing conversations refresh skill discovery on their next request.')

apsimo-1.4.5/apsimo/workers/__init__.py

@@ -0,0 +1,12 @@
+"""Schedulable agent-side workers, available as installed console commands.
+
+- ``apsimo-agent-bridge`` (:mod:`apsimo.workers.agent_bridge`) runs
+  initiative polling, job dispatch, skills sync and circuit health checks.
+- ``apsimo-queue-worker`` (:mod:`apsimo.workers.queue_worker`) claims
+  approved ``agent_action`` jobs and hands them to the agent.
+- ``apsimo-skills-sync`` (:mod:`apsimo.workers.skills_sync`) reports
+  the agent's installed skill index to Apsimo.
+
+These modules are stdlib-only so the workers can run without the full
+sidecar dependency stack. Do not import heavy dependencies here.
+"""

{apsimo-1.4.3 → apsimo-1.4.5}/apsimo/workers/colony_worker.py

@@ -332,7 +332,7 @@ def run_cycle(cfg: Dict[str, Any]) -> int:
 
 
 def run_forever(cfg: Dict[str, Any]) -> None:
-    print(f"colony-worker {cfg['node_id']} polling {cfg['colony_url']} "
+    print(f"apsimo-worker {cfg['node_id']} polling {cfg['colony_url']} "
           f"every {cfg['poll_secs']}s (caps={cfg['capabilities']}, "
           f"types={cfg['job_types']})")
     while True:
@@ -354,7 +354,7 @@ def main(argv: Optional[list] = None) -> int:
     except Exception:
         pass
     parser = argparse.ArgumentParser(
-        prog="colony-worker",
+        prog="apsimo-worker",
         description="Claim typed Colony jobs and execute them read/analyse-only.")
     parser.add_argument("--dry-run", action="store_true",
                         help="print resolved config and exit (no network)")
@@ -367,7 +367,7 @@ def main(argv: Optional[list] = None) -> int:
         safe = dict(cfg)
         safe["api_key"] = "***" if cfg["api_key"] else ""
         safe["llm_api_key"] = "***" if cfg["llm_api_key"] else ""
-        print("colony-worker (dry run -- no network calls):")
+        print("apsimo-worker (dry run -- no network calls):")
         for k, v in safe.items():
             print(f"  {k}: {v}")
         return 0