title	description	section	sectionOrder	order
smarthome.exchange	Source-verified documentation for the current smarthome.exchange v0.1 TypeScript prototype and its production boundaries.	Overview	10	1

smarthome.exchange

smarthome.exchange v0.1 is an executable TypeScript prototype for normalized devices, tool plans, agent definitions, automations, approvals, audit records, integration runtimes, and a component catalog. The committed packages demonstrate those boundaries in process. They are not yet a durable or secured home-control service.

Issue Reporting and Security

For reporting bugs, issues, or security vulnerabilities, please visit community.foss.global/. This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a code.foss.global/ account to submit Pull Requests directly.

Read the status labels literally

Label	Meaning in these docs
Implemented prototype	Code and tests exist at the audited commit, with the limitations stated beside it.
Demo	Seeded or static data exercises a UI or runtime path without representing physical hardware.
Planned	Architecture direction only; not available from the audited packages.

Package metadata such as control-runtime, MCP-shaped descriptors, a JSON schema, or an agent scope is not by itself evidence of live hardware control, authorization enforcement, or production readiness.

Current package boundaries

Package	Implemented at the audited commit	Important boundary
`@smarthome.exchange/interfaces`	Shared data shapes and seven TypedRequest contracts.	Types do not validate input or enforce policy at runtime.
`@smarthome.exchange/sdk`	Trigger registration plus device and agent plan builders.	No scheduler, event source, or hub connection is included.
`@smarthome.exchange/api`	HTTP and TypedSocket calls for the seven operations.	A separate host application must expose the hub router.
`@smarthome.exchange/hub`	Seeded in-memory registries, plans, approvals, audit records, automation context, and integration setup.	No committed standalone server, authentication, persistence, or physical-device dispatch.
`@smarthome.exchange/cli`	`.shx` project, agent, and automation scaffolding.	Generated files are not loaded by the hub.
`@smarthome.exchange/agents`	Six editable reference definitions.	These are data, not running LLM agents.
`@smarthome.exchange/catalog`	Dees/Lit primitives, landing page, and static console demo.	The committed console is demo-backed and has no live snapshot input.
`@smarthome.exchange/integrations`	Registry/discovery/config/runtime primitives, native and generic adapters, and descriptor-only catalog entries.	Declared maturity varies; generated descriptors cannot be set up.

Start here

License and Legal Information

This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the repository license file.

Please note: The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

Trademarks

This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.

Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.

readme.md