mirror of https://github.com/cline/cline.git synced 2026-09-19 10:13:34 +08:00

Files

T

WaylandYang 44e15319e4 fix(plugin-sandbox): expose CLINE_PLUGIN_IMPORT_TIMEOUT_MS env override (#11065 ) (#11084 )

* fix(plugin-sandbox): expose CLINE_PLUGIN_IMPORT_TIMEOUT_MS env override

The hardcoded 4000 ms importTimeoutMs default is too tight on Windows
cold-start; the plugin-sandbox tests already use 30_000 ms for the same
reason. This patch lets hosts raise the ceiling via env var without
touching code or adding a CLI flag, with explicit options.importTimeoutMs
still taking precedence.

Precedence: options.importTimeoutMs > env var > 4000.

Refs: #11065

* fix(plugin-sandbox): tighten env parsing + use vi.stubEnv (PR feedback)

- Number.parseInt accepts trailing garbage ("4000ms" -> 4000); switch
  to Number() + Number.isInteger() so malformed env values fall back
  to the default instead of silently consuming the numeric prefix.
- Replace manual process.env save/restore in the regression test with
  the idiomatic vi.stubEnv() / vi.unstubAllEnvs() pattern.

Per Greptile review on #11084.

2026-06-01 17:34:13 -07:00

agents

Cline SDK 0.0.42 (#10994 )

2026-05-22 13:31:48 -07:00

core

fix(plugin-sandbox): expose CLINE_PLUGIN_IMPORT_TIMEOUT_MS env override (#11065 ) (#11084 )

2026-06-01 17:34:13 -07:00

llms

chore(sdk): Model Catalog v1780081026557 (#11140 )

2026-05-29 12:00:26 -07:00

sdk

Cline SDK 0.0.42 (#10994 )

2026-05-22 13:31:48 -07:00

shared

feat: Cline Hub web app (#10969 )

2026-05-29 11:25:50 -07:00

README.md

refactor: promote remote-config primitives from enterprise (#65 )

2026-05-08 23:19:57 +02:00

tsconfig.base.json

chore: publish only dist artifacts in package exports (#52 )

2026-05-07 11:58:43 -07:00

README.md

Packages Overview

This directory is the single documentation source for package-level responsibilities.

High-level package roles: this file (packages/README.md)
Package interaction and runtime flows: ARCHITECTURE.md

Package Responsibilities

Package	Primary responsibility	Typical consumers	Internal deps
`@cline/shared`	Cross-package shared primitives (path resolution, session common types, indexing helpers)	`@cline/agents`, `@cline/core`, apps	None
`@cline/llms`	Model catalog + provider settings schema + handler creation SDK	`@cline/agents`, `@cline/core`, apps	None
`@cline/agents`	Stateless agent runtime loop (tools, hooks, extensions, teams, streaming)	`@cline/core`, apps	`@cline/llms`, `@cline/shared`
`@cline/core`	Stateful runtime orchestration (runtime composition, session lifecycle/storage, local and hub runtime services, hub discovery and client helpers)	CLI/Desktop apps	`@cline/agents`, `@cline/llms`, `@cline/shared`

How Packages Work Together

@cline/llms defines model/provider capabilities and builds concrete handlers.
@cline/agents runs the agent loop on top of those handlers and tool execution primitives.
@cline/core composes runtime behavior with persistent sessions/storage and local or hub-backed runtime services.
@cline/core hub services orchestrate scheduled runtime execution, execution history, and schedule command handling.
@cline/core/hub exposes discovery, the detached hub daemon, and session-oriented client APIs (HubSessionClient, HubUIClient) when hosts need a shared daemon.
@cline/shared provides the shared contracts and path/session primitives used across the stack.

Practical Boundary Rules

Put provider/model schema, cataloging, and handler wiring in @cline/llms.
Put loop/tool/hook/team execution behavior in @cline/agents.
Put persistence, session lifecycle, and runtime assembly in @cline/core.
Put scheduled execution and schedule persistence in @cline/core hub services.
Put hub discovery, attach flows, and session-oriented client adapters in @cline/core/hub.
Put cross-package utility types and path/session constants in @cline/shared.
Put remote-config schemas, materialization, telemetry normalization, and blob upload primitives in @cline/shared/remote-config.

Runtime Entry Points

Node-oriented imports exist where packages expose a distinct Node alias.
@cline/core itself is now the Node/runtime-oriented entry point for host/session services.
Browser entry points still exist in packages that intentionally publish a browser surface, but @cline/core no longer does.

Notes for Doc Consolidation

Nested package README.md and ARCHITECTURE.md files can be reduced or removed after references are updated to point here.