@inneranimalmedia/agentsam-sdk 2.6.11 → 2.6.12

package/docs/prd/README.md

@@ -0,0 +1,39 @@
+# Product Requirements Documents
+
+Use PRDs for user problems, product promises, product boundaries, lifecycle, required capabilities, acceptance cases, and definition-of-v1 criteria.
+
+## Convention
+
+- File names: `PRD-product-name.md`
+- Product status should be explicit: `Experimental`, `Alpha`, `Beta`, `v1`, or `Deprecated`.
+- PRDs may evolve as product requirements become clearer.
+- Keep architectural authority decisions in ADRs and link to them rather than duplicating decision history.
+- Requirements should distinguish current public surface, near-term work, and later capabilities.
+- Acceptance criteria should include direct, indirect, sparse-context, rich-context, authorization, error, and out-of-scope behavior where relevant.
+
+## Current PRDs
+
+- `PRD-agentsam-campaign.md` — AgentSam Campaign product requirements
+
+PRDs describe **what the product must accomplish**. ADRs describe **why architecture and authority boundaries are fixed a certain way**.
+
+## AgentSam offer portfolio
+
+See `../product/OFFER-PORTFOLIO.md` for the package-to-product map. Current product PRDs include:
+
+- `PRD-agentsam-platform.md`
+- `PRD-agentsam-local-studio.md`
+- `PRD-agentsam-work.md`
+- `PRD-agentsam-brand.md`
+- `PRD-agentsam-campaign.md`
+- `PRD-agentsam-content-studio.md`
+- `PRD-agentsam-database-studio.md`
+- `PRD-agentsam-browser.md`
+- `PRD-agentsam-analytics.md`
+- `PRD-agentsam-knowledge.md`
+- `PRD-agentsam-merch.md`
+- `PRD-agentsam-cad-studio.md`
+- `PRD-agentsam-commerce-studio.md`
+- `PRD-agentsam-site-studio.md`
+- `PRD-agentsam-developer-studio.md`
+- `PRD-agentsam-hosted-runtime.md`

package/docs/product/COPRO-DONOR-AUDIT.md

@@ -0,0 +1,9 @@
+# CoPro Donor Audit
+
+MovieMode in the InnerAnimalMedia product repository is the primary donor, not the new product authority.
+
+Harvest its timeline interaction behavior, media/video management, streaming workflows, Remotion preview/render knowledge, conversions, transcription, media embeddings/search, video generation, persistence concepts, and templates.
+
+Rewrite the canonical project schema, one timebase, command/history architecture, MediaAsset identity, renderer-independent RenderPlan, provider contracts, responsive mobile-first UI, and canonical backend authority.
+
+Explicitly reject renderer fields in saved projects, storage/provider fields in clips, direct React mutation as domain authority, Date.now entity IDs, infrastructure-facing creator errors, and duplicated backend source.

package/docs/product/COPRO-EXECUTION-PLAN.md

@@ -0,0 +1,81 @@
+# CoPro Execution Plan
+
+Branch: feat/copro-cleanroom-v1
+Worktree: dedicated AgentSam SDK CoPro feature worktree
+
+## Sprint 0 — contracts and visual proof
+
+Land copro-project, copro-editor, copro-timeline, copro-media, copro-render, copro-templates, copro-provider-contracts, copro-proof, copro-ui, agentsam-copro-studio, ADR, PRD and donor audit.
+
+Exit gate: package tests, release train, UI build and a visual app that directly drags/trims/splits/duplicates/deletes clips through the shared command engine.
+
+## Sprint 1 — persistence and media
+
+Status: IN PROGRESS
+
+Completed in current branch:
+- portable copro-storage package;
+- browser local-storage autosave/reopen;
+- real device file import for starting a project;
+- canonical track visibility/mute/lock state;
+- multi-track demo project with video, audio, captions, and overlay tracks.
+
+Completed additionally:
+- reusable in-editor Media shelf;
+- add imported media to the existing timeline at the playhead;
+- reuse session media multiple times;
+- browser media duration probing;
+- browser-decoded audio waveform envelopes when supported.
+
+Remaining:
+- IndexedDB/OPFS large-project storage;
+- durable imported asset handles across reload;
+- generated video thumbnails/posters;
+- proxy generation for heavy footage;
+- replace-clip flow;
+- richer metadata probing.
+
+## Sprint 2 — real editor completion
+
+Status: IN PROGRESS
+
+Completed in current branch:
+- timeline zoom controls;
+- touch pinch zoom;
+- snapping to grid, playhead and clip edges;
+- multi-track lanes;
+- track mute/visibility/lock controls;
+- speed and volume as canonical edit commands;
+- text/caption editing through canonical clip text commands;
+- audio/caption/overlay visual lanes.
+
+Completed additionally:
+- track reorder controls;
+- real decoded audio waveform extraction for supported browser codecs;
+- speed-aware clip duration semantics;
+- selected clip playback speed/volume reflected in preview;
+- create/edit text and captions as real timeline clips;
+- live text/caption canvas overlays;
+- keyboard shortcuts for undo/redo/delete/split/play-pause;
+- add media into an existing edit.
+
+Remaining:
+- drag-based track reorder;
+- volume envelopes/fades;
+- canvas text drag/resize/rotate;
+- transitions;
+- real effects adapters;
+- richer inspector;
+- shortcut customization.
+
+## Sprint 3 — preview/render
+
+Remotion adapter, preview composition, render jobs, cancellation, progress, export settings, backend selection and artifact receipts.
+
+## Sprint 4 — high-value MovieMode harvest
+
+Streaming adapter, transcription, semantic media search, video generation, conversion and useful live-input concepts.
+
+## Sprint 5 — hardening
+
+Responsive phone/tablet/large desktop acceptance, offline/PWA, accessibility, large-project performance, autosave/recovery, provider failure behavior and full acceptance suite.

package/docs/product/COPRO-UI-QUALITY-GATE.md

@@ -0,0 +1,119 @@
+# CoPro UI Quality Gate
+
+CoPro is judged as a creator application, not as an infrastructure demonstration.
+
+## Reference standard
+
+The interaction-density target is the quality creators expect from leading mobile editors such as CapCut, without copying another product's visual identity.
+
+The product should combine:
+
+- serious touch-first editing;
+- immediate visual feedback;
+- restrained modern styling;
+- fast access to common tools;
+- strong mobile ergonomics;
+- responsive desktop expansion;
+- AgentSam assistance without chatbot-first UX.
+
+## Required creator journey
+
+A first-time tester on an iPhone-sized viewport must be able to:
+
+1. open Projects;
+2. search/filter projects;
+3. create a blank project or import a real local media file;
+4. enter the editor;
+5. see media in the preview;
+6. scrub the timeline;
+7. select and drag a clip;
+8. trim either edge;
+9. split at the playhead;
+10. duplicate/delete;
+11. undo/redo;
+12. open contextual bottom-sheet tools;
+13. adjust at least local speed/volume control state;
+14. open Export;
+15. exercise a visible Preparing -> Rendering -> Encoding -> Finalizing -> Complete job flow;
+16. leave the editor and return to Projects.
+
+## Interaction law
+
+Infrastructure stays below the surface.
+
+Normal creator UI must not expose:
+
+- R2 bucket names;
+- Worker/service-binding choices;
+- PTYs;
+- VM lanes;
+- raw provider resource IDs;
+- render-process implementation details.
+
+## Visible-control law
+
+No dead buttons.
+
+Each visible control must:
+
+- perform a real local action;
+- open a functioning local surface;
+- or be disabled with a human-readable capability explanation.
+
+Future-provider TODO buttons are not acceptable.
+
+## Mobile requirements
+
+- safe-area-aware top and bottom chrome;
+- dynamic viewport units;
+- touch targets sized for fingers;
+- horizontal timeline scroll;
+- pointer/touch clip drag;
+- visible trim handles;
+- bottom sheets instead of navigation away from the editor;
+- no hover-only operation;
+- portrait and landscape compatibility;
+- software-keyboard-safe sheets;
+- editor remains useful without AgentSam.
+
+## Desktop requirements
+
+Desktop uses the same project/editor state and command engine.
+
+It may expand into:
+
+- left creator/media rail;
+- larger canvas;
+- right inspector;
+- full-width timeline;
+- optional AgentSam/Work panel.
+
+Do not fork a separate desktop editor.
+
+## Visual anti-patterns
+
+Reject:
+
+- developer-dashboard styling;
+- giant SaaS cards everywhere;
+- excessive nested panels;
+- AI-gradient decoration;
+- terminal-first UX;
+- chatbot-first UX;
+- tiny desktop controls squeezed onto mobile;
+- visible implementation jargon.
+
+## Mechanical validation
+
+Every UI batch must at minimum run:
+
+- copro-ui build;
+- copro-ui typecheck;
+- CoPro Studio production build;
+- CoPro Studio typecheck;
+- package tests;
+- release-train check;
+- phone-size render capture;
+- desktop-size render capture.
+
+Before v1 add interaction automation, responsive screenshot comparisons, PWA/offline reload, project persistence and full export acceptance.

package/docs/product/OFFER-PORTFOLIO.md

@@ -0,0 +1,158 @@
+# AgentSam Offer Portfolio
+
+This document maps the current `agentsam-sdk` package/app surface into real-world product offers, product engines, shared primitives, adapters, and sellable presentation assets.
+
+## Portfolio rule
+
+A package is not automatically a product. Products are defined by end-to-end user value.
+
+## Primary offers
+
+| Offer | Current status | Primary implementation | Intended value |
+| --- | --- | --- | --- |
+| AgentSam Platform / SDK | Alpha | `@inneranimalmedia/agentsam-sdk` + shared primitives | Build portable AgentSam-powered products without rebuilding the machinery |
+| AgentSam Local Studio | Alpha | `apps/agentsam-local-studio` | Local-first project, provider, terminal, work, and packaged-app workspace |
+| AgentSam Work | Experimental | `agentsam-work`, `agentsam-work-graph` | Durable goals, work, approvals, evidence, artifacts, and progress |
+| AgentSam Brand | Experimental | `agentsam-brand` | Durable brand intelligence and governance |
+| AgentSam Campaign | Experimental | `agentsam-campaign` | Evidence-backed campaign decisions and learning |
+| AgentSam Content Studio | Alpha | `agentsam-content`, `agentsam-content-studio` | Portable content/media lifecycle and preparation |
+| AgentSam Database Studio | Alpha | `agentsam-database-editor` | Safe provider-neutral database inspection/editing |
+| AgentSam Browser | Experimental | `agentsam-abs`, `agentsam-browser-surface` | Browse/Build web exploration and generation |
+| AgentSam Analytics | Experimental | `agentsam-analytics`, `analytics-ui` | Commerce + AgentSam operational decision support |
+| AgentSam Knowledge | Experimental | `agentsam-knowledge`, `agentsam-repository` | Provenance-aware reusable project/organization knowledge |
+| AgentSam Merch | Experimental | `agentsam-merch` | Manufacturing-ready artwork/product preparation |
+| AgentSam CAD Studio | Experimental | `apps/agentsam-cad-creator` | Agent-assisted structured spatial/CAD design |
+| AgentSam Commerce Studio | Experimental | `apps/ecommerce-cms-agentsam` | Provider-neutral commerce operations with AgentSam assistance |
+| AgentSam Site Studio | Experimental | CMS runtime + sections + themes | Brand-aware website creation/refinement |
+| AgentSam Developer Studio | Experimental | `agentsam-ide` + workbench | Reusable AgentSam-native developer workspace |
+| AgentSam Hosted Runtime | Experimental | `apps/agentsam-go-worker` | Durable hosted orchestration without idle model polling |
+
+## Shared primitives - not standalone offers by default
+
+- `agentsam-contracts` - framework-neutral contracts.
+- `agentsam-errors` - error normalization/remediation.
+- `agentsam-hooks` - lifecycle hooks/adapters.
+- `agentsam-goap` - planning/control-plane contracts.
+- `agentsam-queue-control` - queue/retry/scheduling machinery.
+- `agentsam-scoring` - reusable scoring contracts.
+- `agentsam-vault` - secret storage contracts.
+- `agentsam-workbench` - reusable agent interaction primitives.
+- `agentsam-work-graph` - durable graph primitive.
+- `agentsam-settings` - settings surfaces.
+- `agentsam-shell-kit` - shell composition.
+- `agentsam-nav` - responsive navigation.
+- `agentsam-assets-core` - canonical asset identity/provenance.
+- `agentsam-loading-scene` - runtime visualization.
+- `agentsam-key-manager` - keys/integrations UI.
+- `agentsam-desktop-shell` - packaging/runtime shell.
+- `agentsam-docs-theme` - documentation presentation.
+
+## Adapters / providers
+
+- `agentsam-cloudflare-images` - image transport adapter.
+- `agentsam-provider-completeful` - fulfillment/manufacturing provider adapter.
+- `agentsam-connector-cloudflare` - Cloudflare connector.
+- `identity` / `agentsam-identity` - identity implementation surfaces; identity remains a platform capability, not a forced company gate.
+
+## Themes / prebuild assets
+
+The theme packages are productized design assets for Site Studio and client deployments, not separate domain authorities:
+
+- Cypress
+- Ember
+- Forge
+- Grove
+- Harbor
+- Heuristic
+- IASF
+- Resolve
+- Scenes
+- Summit
+- Violet
+
+These may be sold or bundled as templates/prebuilds, but their durable product value comes from the Site Studio/theme ecosystem rather than pretending each theme is a software platform.
+
+## Existing apps and placement
+
+- `agentsam-local-studio` -> AgentSam Local Studio.
+- `agentsam-work-app` -> AgentSam Work reference/packaged app.
+- `agentsam-browser-site` -> AgentSam Browser public product/promo surface.
+- `agentsam-go-worker` -> AgentSam Hosted Runtime.
+- `agentsam-cad-creator` -> AgentSam CAD Studio.
+- `ecommerce-cms-agentsam` -> AgentSam Commerce Studio.
+- `client-cms-editor` -> donor/reference implementation for Site Studio; it should not remain the long-term product identity if stronger portable theme/content surfaces replace it.
+
+## Productization priorities
+
+### Tier 1 - closest to real external offers
+
+1. AgentSam Local Studio
+2. AgentSam Brand
+3. AgentSam Campaign
+4. AgentSam Content Studio
+5. AgentSam Database Studio
+6. AgentSam Browser
+
+### Tier 2 - strong strategic offers requiring workflow closure
+
+1. AgentSam Work
+2. AgentSam Commerce Studio
+3. AgentSam Merch
+4. AgentSam Analytics
+5. AgentSam Knowledge
+6. AgentSam Hosted Runtime
+
+### Tier 3 - promising specialized offers
+
+1. AgentSam CAD Studio
+2. AgentSam Site Studio
+3. AgentSam Developer Studio as a standalone offer, if user demand justifies separating it from Local Studio
+
+## Required next documentation
+
+Each Tier 1 offer should eventually also have:
+
+- use-case inventory;
+- user journey;
+- acceptance/eval suite;
+- packaging/pricing hypothesis;
+- security/privacy notes;
+- launch checklist;
+- telemetry/success metrics;
+- host/plugin distribution plan where applicable.
+
+## Commercial packaging hypotheses
+
+These are hypotheses to test, not locked pricing decisions.
+
+| Offer | Free / adoption wedge | Paid value hypothesis |
+| --- | --- | --- |
+| AgentSam Platform / SDK | Public npm packages, docs, examples | Commercial support, managed services, enterprise distribution/controls |
+| AgentSam Local Studio | Useful local desktop core with user-owned providers | Pro/team workspace, managed sync, remote runtimes, collaboration, premium packaged capabilities |
+| AgentSam Work | Personal/local work graph and basic planning | Team coordination, durable automation, approvals, managed runs, reporting |
+| AgentSam Brand | Basic brand inspection and local BrandContract | Connected brand intelligence, team governance, asset audits, monitoring, advanced workflows |
+| AgentSam Campaign | Basic planning/evaluation with supplied context | Connected commerce/analytics/search evidence, learning loop, team workflows, premium execution/measurement |
+| AgentSam Content Studio | Local/R2-first library and inspection | Team asset workflows, advanced preparation, usage intelligence, managed delivery/storage |
+| AgentSam Database Studio | Local database inspection/editor | Team/production connections, approvals, audit history, managed remote access |
+| AgentSam Browser | Explore/Build local experience | Hosted generation, managed sandboxes, premium models/runtimes, team/browser workspaces |
+| AgentSam Analytics | Local/read-model analytics | Connected multi-source analytics, scheduled briefs, team reporting, longer retention |
+| AgentSam Knowledge | Local indexing/retrieval | Managed indexes, shared organizational knowledge, scheduled refresh, larger-scale retrieval |
+| AgentSam Merch | Local preflight/planning | Provider integrations, production workflows, collection operations, premium preparation/export |
+| AgentSam CAD Studio | Local structured design workspace | Advanced exporters, simulation/fabrication integrations, team/project workflows |
+| AgentSam Commerce Studio | Self-hostable core/admin | Managed commerce operations, provider integrations, premium automation/analytics |
+| AgentSam Site Studio | Open/prebuilt themes and portable site runtime | Premium prebuilds, managed hosting/deploy, assisted refinement, agency/client workflows |
+| AgentSam Developer Studio | SDK/Local Studio developer surface | Team/project features, managed environments, premium remote runtimes if separately validated |
+| AgentSam Hosted Runtime | Self-hostable runtime protocol/service | Managed execution capacity, observability, scheduling, durable queues, enterprise controls |
+
+## Offer validation questions
+
+Before investing heavily in any paid tier, answer:
+
+1. What recurring problem is painful enough that users return without being reminded?
+2. What data/context makes AgentSam materially better than a generic model response?
+3. Which part can remain local/free and which part creates genuine managed-service value?
+4. What ongoing infrastructure cost justifies usage-based or subscription pricing?
+5. Does the offer save time, reduce risk, increase output quality, increase revenue opportunity, or enable work the user otherwise cannot do?
+6. Can the value be demonstrated in under five minutes to a new user?
+7. Can the product survive changing model/provider vendors without losing its identity?
+8. What measurable event proves the core job was completed successfully?

package/docs/product/PACKAGE-TAXONOMY.md

@@ -0,0 +1,78 @@
+# AgentSam Package and App Taxonomy
+
+This is the exhaustive current package/app placement map for `agentsam-sdk`. It complements `OFFER-PORTFOLIO.md`.
+
+## Packages
+
+| Package | Portfolio role | Primary offer(s) | Current description |
+| --- | --- | --- | --- |
+| `@inneranimalmedia/agentsam-abs` | Product engine | AgentSam Browser | AgentSam Auto Browser Shell: dual-mode Explore/Build browser surface with provider-agnostic generative navigation, sandboxed previews, deterministic history, and packaged runtime scenes. |
+| `@inneranimalmedia/agentsam-analytics` | Product engine | AgentSam Analytics | Portable AgentSam analytics read models and operational analytics surfaces. |
+| `@inneranimalmedia/agentsam-assets-core` | Shared primitive | Brand, Content Studio, Merch, Commerce Studio | Shared Asset Core: canonical ast_* identity, machine facts, provenance, and provider representations. Peer BrandPack and Content domains build on this — neither owns the other. |
+| `@inneranimalmedia/agentsam-brand` | Product engine | AgentSam Brand | Deterministic Brand Intelligence + portable brand-asset promotion SDK for AgentSam (inspect, derive, plan, promote, publish, verify). |
+| `@inneranimalmedia/agentsam-browser-surface` | Product engine | AgentSam Browser, Local Studio | AgentSamBrowserSurface: a portable Browse/Build browser capability with a provider registry so the lightweight Local Studio browser and the AgentSam Browser Shell can be swapped behind one stable host composition. |
+| `@inneranimalmedia/agentsam-campaign` | Product engine | AgentSam Campaign | Portable AgentSam campaign intelligence for promotional planning, product launches, SEO/content strategy, merchandising, audience targeting, conversion, brand consistency, and evidence-backed campaign evaluation. |
+| `@inneranimalmedia/agentsam-cloudflare-images` | Provider adapter | Content Studio, Brand | Shared Cloudflare Images transport: credentials, delivery URLs, and HTTP client. Content and Brand consume this — duplicate clients are not allowed. Independent project; not affiliated with Cloudflare, Inc.. |
+| `@inneranimalmedia/agentsam-content` | Product engine | AgentSam Content Studio, Site Studio, Commerce Studio | Portable content/library peer domain over Asset Core: lifecycle, usage, providers, intelligence, and createContentRuntime(). BrandPack remains peer brand authority. |
+| `@inneranimalmedia/agentsam-content-studio` | Product UI | AgentSam Content Studio | Canonical React UI for AgentSam Content Studio: library, inspectors, assistant rail. Host apps provide a ContentRuntime; the UI never knows their names. |
+| `@inneranimalmedia/agentsam-contracts` | Shared primitive | All AgentSam offers | Framework-neutral AgentSam contracts for workbench, tools, providers, events, hooks, execution, identity and repository context. |
+| `@inneranimalmedia/agentsam-database-editor` | Product engine/UI | AgentSam Database Studio | Portable AgentSam Database Editor — adapters for SQLite/D1/Postgres/Supabase + vectors surface. Donor: IAM /dashboard/database. Independent project; not affiliated with Supabase. |
+| `@inneranimalmedia/agentsam-desktop-shell` | Host/packaging primitive | Local Studio and packaged apps | Tauri desktop shell for AgentSam-powered brand dashboards — manifest-driven, multi-brand installs. Independent project; not affiliated with Tauri. |
+| `@inneranimalmedia/agentsam-docs-theme` | Presentation primitive | Public documentation | Violet docs skin tokens for AgentSam public guides (Systematic Autonomous Machinery). |
+| `@inneranimalmedia/agentsam-errors` | Shared primitive | All AgentSam offers | Canonical AgentSam runtime error normalization, classification, transport, remediation and rendering. |
+| `@inneranimalmedia/agentsam-goap` | Shared orchestration primitive | Work, Hosted Runtime, long-running workflows | Portable AgentSam GOAP control-plane contracts and adapters over existing blackboard, ticket, workflow, execution, approval, queue, runtime, and evidence stores. |
+| `@inneranimalmedia/agentsam-hooks` | Shared primitive | All extensible AgentSam offers | Provider-neutral, language-agnostic AgentSam lifecycle hooks with callback, command, HTTP, model, tool, MCP, LSP, and sub-agent adapters. |
+| `@inneranimalmedia/agentsam-ide` | Product engine/UI | Developer Studio, Local Studio | AgentSam IDE packages — Monaco, file tree, xterm, LSP client, first-login onboarding. Rapidly deployable into Local Studio / desktop. |
+| `@inneranimalmedia/agentsam-key-manager` | Shared product surface | Local Studio, provider setup | AgentSam settings UI for keys + integrations. Uses agentsam-vault contracts; Kumo-style SensitiveInput primitives. |
+| `@inneranimalmedia/agentsam-knowledge` | Product engine | AgentSam Knowledge | Portable AutoRAG discovery, adapter registries, probes, and company routing contracts for AgentSam. |
+| `@inneranimalmedia/agentsam-loading-scene` | Presentation/runtime primitive | Local Studio, Browser, packaged apps | Provider-agnostic runtime visualization with six seamless full-frame Computational Hyperspace studies driven by real AgentSam runtime semantics. |
+| `@inneranimalmedia/agentsam-merch` | Product engine | AgentSam Merch, Commerce Studio | Provider-neutral manufacturing profiles, preflight, derivative planning, and collection-lab primitives for AgentSam. |
+| `@inneranimalmedia/agentsam-nav` | UI primitive | Dashboard-family apps | Reusable responsive navigation primitives for AgentSam dashboard-family applications. |
+| `@inneranimalmedia/agentsam-queue-control` | Shared orchestration primitive | Work, Hosted Runtime | Portable AgentSam queue, job-routing, retry, scheduling, and execution-control primitives with provider adapters. |
+| `@inneranimalmedia/agentsam-repository` | Shared/domain primitive | Knowledge, Developer Studio, Local Studio | Portable AgentSam repository identity, Merkle, semantic file metadata, persistence, and repository graph runtime contracts. |
+| `@inneranimalmedia/agentsam-scoring` | Shared decision primitive | Campaign, Work, GOAP, quality systems | Generic ScoreCard contract and versioned weight formulas. Raw evidence is SSOT; scores are recomputable derived views — never a grand similarity_score. |
+| `@inneranimalmedia/agentsam-sections` | Product/design primitive | Site Studio, Browser generated sites | Reusable mxs-* page kit: global header/footer, scroll-driven split sections, and a media slot for image, gif, video, glb and sandboxed app previews. |
+| `@inneranimalmedia/agentsam-settings` | UI primitive | Local Studio and packaged apps | Portable AgentSam Settings shell, contracts, fixtures, and host adapter surface for desktop and hosted applications. |
+| `@inneranimalmedia/agentsam-shell-kit` | UI/host primitive | Local Studio and packaged apps | Compatibility facade for the AgentSam workbench shell. New code uses @inneranimalmedia/agentsam-workbench. |
+| `@inneranimalmedia/agentsam-vault` | Security primitive | All credentialed AgentSam offers | AgentSam credential vault core — contracts, AES-GCM crypto, provider registry, resolver. UI lives in agentsam-key-manager. |
+| `@inneranimalmedia/agentsam-work` | Product engine | AgentSam Work | Portable AgentSam Work product surface: shared work contracts, fixture and HTTP hosts, project/ticket/mail/calendar/artifact views, and host-neutral React UI. |
+| `@inneranimalmedia/agentsam-workbench` | Shared product UI primitive | Local Studio and AgentSam apps | Reusable AgentSam workbench primitives for agent threads, composer, browser, terminal and resizable work surfaces. |
+| `@inneranimalmedia/analytics-ui` | Product UI | AgentSam Analytics, Commerce Studio | Domain-neutral analytics presentation primitives for Inner Animal Media products. |
+| `@inneranimalmedia/cms-runtime` | Product engine | Site Studio, Commerce Studio | Portable self-describing local CMS runtime with SQLite schema, tool/skill catalogs, and provider-neutral package contracts. |
+| `@inneranimalmedia/theme-heuristic` | Theme/prebuild | Site Studio | Stock AgentSam CMS storefront shell theme contract (heuristic-theme). |
+| `@inneranimalmedia/agentsam-identity` | Platform capability | Public/local identity implementations | Identity module for @inneranimalmedia/agentsam-sdk (workspace — publish via root SDK) |
+| `@inneranimalmedia/theme-cypress` | Theme/prebuild | Site Studio | A welcoming community prebuild for organizations that need events, groups, giving, visits, and mission-driven storytelling without looking like a generic nonprofit template. |
+| `@inneranimalmedia/theme-ember` | Theme/prebuild | Site Studio | An editorial commerce prebuild that mixes product discovery, brand story, collections, community, and launch moments without collapsing into another tiled product grid. |
+| `@inneranimalmedia/theme-forge` | Theme/prebuild | Site Studio | A mobile-first local-services prebuild with estimate capture, service-area confidence, project proof, reviews, and practical trust signals that stay sharp on the smallest screen. |
+| `@inneranimalmedia/theme-grove` | Theme/prebuild | Site Studio | A visual service-business prebuild centered on project galleries, material detail, process, reviews, and estimate conversion — polished enough for a studio, practical enough for a crew. |
+| `@inneranimalmedia/theme-harbor` | Theme/prebuild | Site Studio | A professional-services prebuild for trust-heavy businesses: clear service storytelling, proof, resources, and lead capture with enough editorial polish to avoid the usual corporate-blue template look. |
+| `@inneranimalmedia/theme-iasf` | Theme/prebuild | Site Studio / Commerce Studio | IASF — stock Inner Animal Storefront theme pack (normalized from studio-cms-editor harvest). |
+| `@inneranimalmedia/theme-resolve` | Theme/prebuild | Site Studio / Commerce Studio | A high-fashion commerce prebuild built around cinematic scroll, shoppable editorial, sticky purchase rails, lookbooks, stories, bundles, and micro-interactions that make the storefront feel directed instead of assembled. |
+| `@inneranimalmedia/theme-scenes` | Composition primitive | Site Studio, branded experiences | Reusable scene / shell / block vocabulary for branded website experiences. BrandPack owns look; theme-scenes owns composition. |
+| `@inneranimalmedia/theme-summit` | Theme/prebuild | Site Studio | A restrained consulting and portfolio prebuild with editorial services, case studies, multilingual-ready structure, media, and thoughtful spacing that lets expertise do the talking. |
+| `@inneranimalmedia/theme-violet` | Theme/prebuild | Site Studio | A campaign-forward prebuild with bold calls to action, impact proof, stories, donation moments, and participation paths designed to turn attention into action. |
+| `@inneranimalmedia/agentsam-work-graph` | Shared/domain primitive | AgentSam Work, Hosted Runtime | Core AgentSam work-graph primitive: one graph model (WorkItem, Dependency, TimelineEvent, Artifact, Evidence, Actor) powering an engineering adapter (git/MCP/tests/deploys) and a business adapter (projects/clients/approvals/milestones), with Gantt/timeline rendering as a pure projection over the graph rather than its own source of truth. |
+| `@inneranimalmedia/agentsam-provider-completeful` | Provider adapter | Commerce Studio, Merch | Portable Completeful provider adapter and AgentSam tool definitions. |
+| `@inneranimalmedia/agentsam-connector-cloudflare` | Provider connector | Platform/runtime/storage consumers | Portable Cloudflare capability connector for AgentSam applications and SDK consumers. Independent project; not affiliated with Cloudflare, Inc.. |
+
+## Apps
+
+| App | Portfolio role | Primary offer | Current description |
+| --- | --- | --- | --- |
+| `@inneranimalmedia/agentsam-browser-site` | Product/public surface | AgentSam Browser | Public site for AgentSam Browser. Consumes the real ABS and sections packages. |
+| `@inneranimalmedia/agentsam-go-worker` | Deployable runtime | AgentSam Hosted Runtime | Deployable AgentSam Go runtime service artifact for Cloudflare Worker + Container self-hosting and official InnerAnimalMedia releases. Independent project; not affiliated with Cloudflare, Inc.. |
+| `@inneranimalmedia/agentsam-cad-creator` | Packaged app | AgentSam CAD Studio | Prepackaged AgentSam CAD, spatial design, and robotics application kit. |
+| `@inneranimalmedia/client-cms-editor` | Donor/reference app | AgentSam Site Studio | Reusable full-stack website + CMS kit with multi-page public sites, a protected authoring dashboard, local SQLite, starter/theme import, and pluggable auth, storage, and deployment adapters. |
+| `@inneranimalmedia/ecommerce-cms-agentsam` | Packaged app/runtime | AgentSam Commerce Studio | Portable AgentSam ecommerce CMS runtime, scaffolding, media, analytics, and admin application package. |
+| `@inneranimalmedia/agentsam-local-studio` | Primary product app | AgentSam Local Studio | Portable AgentSam Local Studio desktop and hosted workbench for local-first projects, terminals, providers, and packaged apps. |
+| `@inneranimalmedia/agentsam-work-app` | Packaged/reference app | AgentSam Work |  |
+
+## Interpretation
+
+- **Product engine/UI** may be marketed through the named offer, but package identity and product identity are not automatically the same.
+- **Shared primitive** exists to make multiple products stronger and should not be forced into a standalone offer without separate product evidence.
+- **Provider adapter/connector** stays beneath provider-neutral product operations.
+- **Theme/prebuild** can be sold or bundled as a design asset while remaining subordinate to Site Studio/Commerce Studio domain authority.
+- **Donor/reference app** is implementation evidence, not necessarily the long-term product identity.
+
+Any new package should be added here when introduced.