@vascend/talos 0.1.4 → 0.1.6

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Lorenzo Daniel Danilov and Vascend Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -20,6 +20,28 @@ Epoch-based context engineering. Extensible workflows. One engine from terminal
 
 ---
 
+## Why I built Talos
+
+I'm **Lorenzo Daniel Danilov**, and I lead [Vascend Technologies](https://vascend.it), an Italian AI lab.
+
+I created Talos because I found existing agent harnesses too restrictive for the way I wanted to work, especially when it came to customization. I wanted to shape the tools, workflows and context management around the task, with control over how the agent operates.
+
+After months of research, I introduced a new approach to context engineering in Talos: **epoch-based context engineering**, implemented through **Context Fabric** and **Epoch–Lease–Lens**. My aim is to give developers a harness they can understand, adapt and build on.
+
+**Bring your next bug, refactor or investigation to Talos.** [Install it](#quick-start), choose your model and put its context controls to the test on your own project.
+
+I'm Italian and **only 22 years old**, but I want to start contributing to AI research now. I'm driven by a passion for understanding, experimenting and turning ideas into tools that people can use. I founded [Vascend Technologies](https://vascend.it) to put that passion into practice: to learn, share what I discover and help Europe develop its own technology through free, open and accessible research.
+
+Each project has been a step in my research journey, from mid-2025 to September 2026: **about 15 months of study, experimentation and development**. I apologize in advance for any bugs you may encounter. I have focused primarily on the core functionality, and some details still need work. I hope you will understand that choice and, if you find the project useful, help support it through feedback, bug reports or contributions.
+
+Through these projects, I also want to share a personal conviction and an invitation to anyone with an idea they want to bring to life:
+
+> **“Have the ambition to create. Those who never try to build their own future end up depending on the one built by others.”**
+
+**Contact:** [LinkedIn](https://www.linkedin.com/in/lorenzo-danilov/) · [Instagram @lorenzo.danilov](https://www.instagram.com/lorenzo.danilov/) · [l.danilov@vascend.it](mailto:l.danilov@vascend.it)
+
+---
+
 **Give your coding agent a mission. Keep the controls.** Talos combines an extensible agent runtime with **Context Fabric**: a system that tracks the current objective, gives temporary focus an expiry and lets you inspect how context is assembled.
 
 Choose the model. Shape the workflow. Pin what matters. Carry the same engine into your scripts and applications.
@@ -28,6 +50,8 @@ Created by **Lorenzo Daniel Danilov** at **Vascend Technologies**, an Italian AI
 
 ## Quick start
 
+> **Built with ambition. Still evolving.** Talos is not perfect yet and you may encounter bugs. We apologize in advance for any issues and will continue to maintain it with updates, fixes and improvements. Follow the [Talos changelog](https://vascend.it/en/talos/changelog) for release-by-release details, or contact [l.danilov@vascend.it](mailto:l.danilov@vascend.it) to report a problem.
+
 **Put Talos to work on your next real task.** With [Node.js 20 or newer](https://nodejs.org), run:
 
 ```bash
@@ -96,6 +120,12 @@ Full configuration and API key examples: [CLI reference](docs/CLI-REFERENCE.it.m
 
 </details>
 
+## Talos inside Horizon
+
+**Prefer a desktop interface? Talos is also available inside [Vascend Horizon](https://vascend.it/en/ide).** Work with the agent from Horizon's interface, or install the standalone CLI to use Talos in your terminal.
+
+[Explore Horizon →](https://vascend.it/en/ide)
+
 ## Why Talos
 
 **Choose Talos when the way your agent works matters as much as the model it uses.**
@@ -128,6 +158,12 @@ Explore the [work runner](src/vascend/work-runner.ts), [context lifecycle](docs/
 
 ## Epoch-based context engineering
 
+[![Vascend Talos: mission control, context compiler, execution, receipt and compaction](assets/context-engine-infographic.png)](assets/context-engine-infographic.png)
+
+[Open the full-resolution infographic](assets/context-engine-infographic.png)
+
+A map of the context engine: mission control, scoped sources, context compilation, execution and feedback. Receipt, compaction and context lanes support the turn lifecycle.
+
 An **epoch** is a phase of work organized around a specific objective. Context Fabric tracks that objective across turns and builds the working context needed to pursue it.
 
 | Concept | How it works |
@@ -157,16 +193,6 @@ Our **five-scenario, deterministic offline context benchmark**, rerun on Septemb
 
 These are internal fixture results against the repository's `cursor-style-proxy`, **not measurements of the Cursor product or a live coding comparison with competing agents**. They measure context selection in this suite, not coding success, latency or your API bill. The value is reproducibility: inspect the [full report](docs/benchmark-results/context-gap-2026-09-11T08-44-47-116Z.md), [raw results](docs/benchmark-results/context-gap-2026-09-11T08-44-47-116Z.json) and [methodology](bench/README.md), or run `bun run bench:context` from a source checkout.
 
-## Why I built Talos
-
-I'm **Lorenzo Daniel Danilov**, and I lead [Vascend Technologies](https://vascend.it), an Italian AI lab.
-
-I created Talos because I found existing agent harnesses too restrictive for the way I wanted to work, especially when it came to customization. I wanted to shape the tools, workflows and context management around the task, with control over how the agent operates.
-
-After months of research, I introduced a new approach to context engineering in Talos: **epoch-based context engineering**, implemented through **Context Fabric** and **Epoch–Lease–Lens**. My aim is to give developers a harness they can understand, adapt and build on.
-
-**Bring your next bug, refactor or investigation to Talos.** [Install it](#quick-start), choose your model and put its context controls to the test on your own project.
-
 ## Keep your place in the conversation
 
 **Keep writing while the agent asks a question.** Questions wait above the prompt. Open one when you are ready, choose an option or select **Other** to write your own answer. Your main prompt and answer drafts remain separate.
@@ -264,8 +290,7 @@ Report bugs in [Issues](https://github.com/VascendTechnologies/vascend-talos/iss
 
 Created by **Lorenzo Daniel Danilov** at [Vascend Technologies](https://vascend.it), an Italian AI lab. Inspired by the extensible agent philosophy of [Pi](https://pi.dev).
 
-**Contact:** [LinkedIn](https://www.linkedin.com/in/lorenzo-danilov/) · [Instagram @LorenzoDanilov](https://www.instagram.com/LorenzoDanilov/) · [l.danilov@vascend.it](mailto:l.danilov@vascend.it)
 
-The package is marked **`UNLICENSED`**. This repository does not grant an open-source license; use and distribution require permission from Vascend Technologies.
+Talos is available under the [MIT license](LICENSE). Copyright (c) 2026 Lorenzo Daniel Danilov and Vascend Technologies. Source repository: [VascendTechnologies/vascend-talos](https://github.com/VascendTechnologies/vascend-talos).
 
 <p align="center"><strong>English</strong> · <a href="readme/README.it.md">Italiano</a> · <a href="readme/README.es.md">Español</a> · <a href="readme/README.de.md">Deutsch</a> · <a href="docs/README.md">Documentation</a></p>

package/dist/core/agent.d.ts

@@ -1,4 +1,4 @@
-import type { EventSink, Message, Provider, ToolContext, ContentPart, ToolCallPart, SpawnAgentSpec } from "./types.js";
+import type { AgentEvent, EventSink, Message, Provider, ToolContext, ContentPart, ToolCallPart, SpawnAgentSpec } from "./types.js";
 import type { ToolRegistry } from "../tools/registry.js";
 import type { Session } from "./session.js";
 import type { PiConfig } from "./config.js";
@@ -7,13 +7,26 @@ import { type UserInbox } from "./user-inbox.js";
 import { type ContextFabricResult } from "../vascend/context-fabric.js";
 import { type FileCoordinationContext } from "./file-coordination.js";
 import type { ExecutionTarget } from "./execution-target.js";
+import type { StepPolicy } from "./step-policy.js";
 import { type WorkspaceSession } from "./workspace-sessions.js";
 export interface AgentDeps {
+    readonly fusionHarness?: import("./bootstrap.js").Harness;
+    /** Politica per passo (Fusion): guida effimera e tool ammessi nel passo. */
+    readonly stepPolicy?: StepPolicy;
+    /** Trasporto Jev dell'host per il canale client (sessione Vascend dell'host). */
+    readonly jevProxy?: import("../fusion/jev.js").JevProxy;
+    /** Full worker events for hosts with per-agent transcripts. */
+    readonly onWorkerEvent?: (actor: string, event: AgentEvent) => void;
     readonly provider: Provider;
     readonly tools: ToolRegistry;
     readonly session: Session;
     readonly config: PiConfig;
     readonly env?: NodeJS.ProcessEnv;
+    /** Correlazione di un follow-up gia' prelevato dall'inbox dall'host. */
+    readonly inputMessage?: {
+        readonly id: string;
+        readonly immediate?: boolean;
+    };
     /** Allowlist filesystem aggiuntiva, isolata al singolo runTurn. */
     readonly fsRoots?: readonly string[];
     readonly executionTarget?: ExecutionTarget;
@@ -25,8 +38,8 @@ export interface AgentDeps {
      * Viene marcata come non attendibile e non entra mai nella sessione.
      */
     readonly ephemeralContext?: string;
-    readonly confirm: (action: string, detail: string) => Promise<boolean>;
-    readonly ask?: (question: string, options?: readonly string[]) => Promise<string | null>;
+    readonly confirm: (action: string, detail: string, signal?: AbortSignal) => Promise<boolean>;
+    readonly ask?: (question: string, options?: readonly string[], signal?: AbortSignal) => Promise<string | null>;
     readonly spawnKingdom?: (castles: readonly SpawnAgentSpec[], opts?: {
         baseBranch?: string;
         detach?: boolean;