Skip to content

Public API and contract layer of the ICE ecosystem, defining schemas, actions, IPC messages, and interaction boundaries between systems.

Notifications You must be signed in to change notification settings

francescomaiomascio/ice-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ICE API

ICE Ecosystem Docs Status Language License

ICE API defines the public interface layer of the ICE ecosystem.

It provides stable contracts, schemas, and interaction models used by applications, agents, UIs, and runtimes to communicate with ICE systems in a controlled and versioned way.

ICE API does not execute logic. It defines what can be said, what can be asked, and how systems interact.


Core Responsibilities

ICE API is responsible for:

  • Defining public actions and agent specifications
  • Modeling shared domains and system concepts
  • Providing IPC message formats and event schemas
  • Validating payloads and contracts
  • Exposing lifecycle and interaction primitives
  • Acting as the canonical boundary between ICE subsystems

Architectural Scope

ICE API sits at the boundary layer of the ICE ecosystem.

It does not:

  • orchestrate execution
  • manage memory or cognition
  • implement business logic
  • control system state

It does:

  • define interaction contracts
  • standardize communication
  • enforce schema correctness
  • decouple producers and consumers

Design Principles

  • Explicit and versioned contracts
  • Schema-first validation
  • Clear separation between domains
  • IPC as a first-class concern
  • Backward compatibility by design
  • APIs as boundaries, not conveniences

Usage

ICE API is not a service and not an application.

It is consumed by:

  • ICE Runtime
  • ICE Engine
  • ICE Studio
  • ICE AI
  • External tools and adapters

All ICE components communicate through this layer, not around it.


Status

This project is under active development. Public contracts aim to remain stable; extensions are additive.


License

This project is licensed under the terms of the MIT license. See the LICENSE file for details.

About

Public API and contract layer of the ICE ecosystem, defining schemas, actions, IPC messages, and interaction boundaries between systems.

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Languages