t3code-cli 0.12.0 → 0.14.0

package/README.md

@@ -36,7 +36,7 @@ This repo includes an agent skill for operating `t3cli`: [`skills/t3code-cli/SKI
 Install it with:
 
 ```sh
-npx skills add tarik02/t3cli
+npx skills add tarik02-org/t3code-cli
 ```
 
 ## Authentication
@@ -63,6 +63,92 @@ t3cli --environment <name> ...                                      # Use a spec
 - Set `T3CLI_ENV=<name>` to select an environment when `--environment` is omitted
 - `T3CODE_URL` and `T3CODE_TOKEN` override the selected environment only when both are set
 
+## Programmatic API
+
+Pairing accepts T3 client presentation metadata. Automation clients should identify themselves as
+bots and provide a label that users can recognize in T3 Code:
+
+```ts
+import * as Effect from "effect/Effect";
+import { T3AuthPairing } from "t3code-cli/auth";
+import { T3AuthPairingLayer } from "t3code-cli/runtime";
+
+const pair = Effect.gen(function* () {
+  const auth = yield* T3AuthPairing;
+  return yield* auth.pair({
+    pairingUrl,
+    clientMetadata: {
+      label: "aperture bridge",
+      deviceType: "bot",
+      os: "linux",
+    },
+  });
+}).pipe(Effect.provide(T3AuthPairingLayer));
+```
+
+`T3PreviewAutomation` registers a preview host and exposes T3's request stream, response RPC, and
+focus RPC. Compose its live layer with the existing connection layers when supplying credentials
+directly:
+
+```ts
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+import { T3CodeConnectionProviderLive } from "t3code-cli/connection";
+import { T3CodeNodeRpcLayer } from "t3code-cli/node";
+import { T3PreviewAutomation, T3PreviewAutomationLive } from "t3code-cli/preview";
+import { T3RpcOperationsLive } from "t3code-cli/rpc";
+
+const connectionLayer = T3CodeConnectionProviderLive({
+  origin: { url },
+  auth: { token },
+});
+const rpcLayer = T3CodeNodeRpcLayer.pipe(Layer.provide(connectionLayer));
+const previewLayer = T3PreviewAutomationLive.pipe(
+  Layer.provide(T3RpcOperationsLive.pipe(Layer.provide(rpcLayer))),
+);
+
+const runHost = Effect.gen(function* () {
+  const preview = yield* T3PreviewAutomation;
+  yield* preview
+    .connect({ clientId, environmentId, supportedOperations })
+    .pipe(Stream.runForEach(handlePreviewEvent));
+}).pipe(Effect.scoped, Effect.provide(previewLayer));
+```
+
+`T3PreviewAutomationLayer` is the shorter CLI-config-backed layer for callers that use a selected
+`t3cli` environment.
+
+`T3Orchestration.watchShellSnapshots()` emits the initial shell snapshot and a reduced snapshot for
+each later project or thread event. A new full snapshot resets the reducer after reconnects.
+
+T3 Code's shared and client-runtime export maps are mirrored under `t3code-cli/shared/*` and
+`t3code-cli/client-runtime/*`. For example, the viewport catalog and resolver are available through
+the matching shared subpath:
+
+```ts
+import {
+  PREVIEW_VIEWPORT_PRESETS,
+  resolvePreviewViewport,
+} from "t3code-cli/shared/previewViewport";
+import { PreviewViewportSetting } from "t3code-cli/contracts";
+```
+
+## Upstream Maintenance
+
+Synchronize dependency versions and patches with the current `upstream-t3code` revision:
+
+```sh
+pnpm sync-upstream
+```
+
+Pass `--target` to update the submodule first. It accepts `stable`, `nightly`, `main`, a version such
+as `0.0.31` or `v0.0.31`, or a Git ref or commit:
+
+```sh
+pnpm sync-upstream --target stable
+```
+
 ## Project Management
 
 ```sh

package/dist/application.d.ts

@@ -0,0 +1,2 @@
+import { $r as T3ApplicationSlicesLive, Ai as WaitEvent, Ci as T3Application, Di as T3ThreadApplication, Ei as T3TerminalApplication, Li as ApplicationError, Oi as UpdateProjectActionInput, Qr as T3ApplicationLive, Si as T3ActionApplicationService, Ti as T3ProjectApplication, Zr as T3ActionApplicationLive, _i as ProjectActionSelector, bi as StartThreadPolicy, ei as T3ModelApplicationLive, gi as ProjectActionRunResult, hi as ProjectActionMutationResult, ii as makeT3Application, ki as UpdateThreadInput, mi as ProjectActionDeleteResult, ni as T3TerminalApplicationLive, pi as AddProjectActionInput, ri as T3ThreadApplicationLive, ti as T3ProjectApplicationLive, vi as SendThreadInput, wi as T3ModelApplication, xi as T3ActionApplication, yi as StartThreadInput } from "./shared.js";
+export { type AddProjectActionInput, type ApplicationError, type ProjectActionDeleteResult, type ProjectActionMutationResult, type ProjectActionRunResult, type ProjectActionSelector, type SendThreadInput, type StartThreadInput, type StartThreadPolicy, T3ActionApplication, T3ActionApplicationLive, type T3ActionApplicationService, T3Application, T3ApplicationLive, T3ApplicationSlicesLive, T3ModelApplication, T3ModelApplicationLive, T3ProjectApplication, T3ProjectApplicationLive, T3TerminalApplication, T3TerminalApplicationLive, T3ThreadApplication, T3ThreadApplicationLive, type UpdateProjectActionInput, type UpdateThreadInput, type WaitEvent, makeT3Application };

package/dist/application.js

@@ -1,2 +1,2 @@
-import { B as T3ModelApplicationLive, Gm as T3ActionApplication, H as T3TerminalApplicationLive, Jm as T3ProjectApplication, Km as T3Application, L as T3ActionApplicationLive, R as T3ApplicationLive, U as T3ThreadApplicationLive, V as T3ProjectApplicationLive, W as makeT3Application, Xm as T3ThreadApplication, Ym as T3TerminalApplication, qm as T3ModelApplication, z as T3ApplicationSlicesLive } from "./shared.js";
+import { Aw as T3ThreadApplication, Bi as T3ModelApplicationLive, Dw as T3ModelApplication, Ew as T3Application, Hi as T3TerminalApplicationLive, Li as T3ActionApplicationLive, Ow as T3ProjectApplication, Ri as T3ApplicationLive, Tw as T3ActionApplication, Ui as T3ThreadApplicationLive, Vi as T3ProjectApplicationLive, Wi as makeT3Application, kw as T3TerminalApplication, zi as T3ApplicationSlicesLive } from "./shared.js";
 export { T3ActionApplication, T3ActionApplicationLive, T3Application, T3ApplicationLive, T3ApplicationSlicesLive, T3ModelApplication, T3ModelApplicationLive, T3ProjectApplication, T3ProjectApplicationLive, T3TerminalApplication, T3TerminalApplicationLive, T3ThreadApplication, T3ThreadApplicationLive, makeT3Application };

package/dist/auth.d.ts

@@ -0,0 +1,50 @@
+import { $n as makeT3LocalAuth, $w as AuthClientPresentationMetadata, Ar as AuthStatusResult, Br as PersistEnvironmentInput, Cr as T3Auth, Dr as AuthPairInput, Er as AuthEnvironmentSummary, Fr as LocalAuthResult, Gr as AuthLocalSecretError, Hr as AuthError, Ir as LocalAuthTokenInput, Jn as makeT3AuthPairing, Jr as AuthTransportError, Kn as T3AuthPairing, Kr as AuthLocalSigningError, Lr as LocalAuthTokenResult, Mr as AuthUseResult, Nr as LocalAuthInput, Or as AuthResolvedConfig, Pr as LocalAuthOriginInput, Qn as T3LocalAuthLive, Rr as PairResult, Tr as AuthEnvironmentListItem, Ur as AuthLocalDatabaseError, Vr as AuthConfigError, Wr as AuthLocalError, Xn as T3AuthTransport, Xr as AuthWebSocketTicketResult, Yn as parsePairingUrl, Yr as AuthSessionState, Zn as T3LocalAuth, ar as makeT3LocalAuthOrigin, er as T3LocalAuthToken, ir as T3LocalAuthOriginLive, jr as AuthUnpairResult, kr as AuthSessionRole, nr as makeT3LocalAuthToken, or as T3Config, qn as T3AuthPairingLive, qr as AuthPairingUrlError, rr as T3LocalAuthOrigin, tr as T3LocalAuthTokenLive, wr as AuthConfigInput, zr as PairingUrl } from "./shared.js";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+//#region src/auth/layer.d.ts
+declare const makeT3Auth: () => Effect.Effect<{
+  pair: (input: AuthPairInput) => Effect.Effect<PairResult, AuthPairingUrlError | AuthTransportError>;
+  local: (input: LocalAuthInput) => Effect.Effect<LocalAuthResult, AuthLocalError>;
+  writeConfig: (input: AuthConfigInput) => Effect.Effect<void, AuthConfigError, never>;
+  persistEnvironment: (input: {
+    readonly name: string;
+    readonly url: string;
+    readonly token: string;
+    readonly local: boolean;
+    readonly replace?: boolean;
+    readonly allowReplace: boolean;
+  }) => Effect.Effect<string, AuthConfigError, never>;
+  environmentExists: (name: string) => Effect.Effect<boolean, AuthConfigError, never>;
+  defaultNameFromUrl: (url: string) => Effect.Effect<string, AuthConfigError, never>;
+  defaultNameForLocal: () => Effect.Effect<"local", never, never>;
+  listEnvironments: () => Effect.Effect<AuthEnvironmentListItem[], AuthConfigError, never>;
+  useEnvironment: (name: string) => Effect.Effect<{
+    name: string;
+    default: true;
+  }, AuthConfigError, never>;
+  resolveUnpairTarget: (input: {
+    readonly name?: string;
+  }) => Effect.Effect<string, AuthConfigError, never>;
+  unpairEnvironment: (input: {
+    readonly name: string;
+  }) => Effect.Effect<{
+    name: string;
+    removed: true;
+  }, AuthConfigError, never>;
+  status: () => Effect.Effect<{
+    readonly config: AuthResolvedConfig;
+    readonly session: {
+      readonly authenticated: boolean;
+      readonly role?: "client" | "owner";
+      readonly sessionMethod?: string;
+      readonly expiresAt?: string;
+    };
+  }, AuthConfigError | AuthTransportError, never>;
+  issueWebSocketTicket: () => Effect.Effect<{
+    readonly ticket: string;
+    readonly expiresAt: string;
+  }, AuthConfigError | AuthTransportError, never>;
+}, never, T3AuthPairing | T3AuthTransport | T3Config | T3LocalAuth>;
+declare const T3AuthLive: Layer.Layer<T3Auth, never, T3AuthPairing | T3AuthTransport | T3Config | T3LocalAuth>;
+//#endregion
+export { type AuthClientPresentationMetadata, AuthConfigError, type AuthConfigInput, type AuthEnvironmentListItem, type AuthEnvironmentSummary, type AuthError, AuthLocalDatabaseError, AuthLocalError, AuthLocalSecretError, AuthLocalSigningError, type AuthPairInput, AuthPairingUrlError, type AuthResolvedConfig, type AuthSessionRole, type AuthSessionState, type AuthStatusResult, AuthTransportError, type AuthUnpairResult, type AuthUseResult, type AuthWebSocketTicketResult, type LocalAuthInput, type LocalAuthOriginInput, type LocalAuthResult, type LocalAuthTokenInput, type LocalAuthTokenResult, type PairResult, type PairingUrl, type PersistEnvironmentInput, T3Auth, T3AuthLive, T3AuthPairing, T3AuthPairingLive, T3LocalAuth, T3LocalAuthLive, T3LocalAuthOrigin, T3LocalAuthOriginLive, T3LocalAuthToken, T3LocalAuthTokenLive, makeT3Auth, makeT3AuthPairing, makeT3LocalAuth, makeT3LocalAuthOrigin, makeT3LocalAuthToken, parsePairingUrl };

package/dist/auth.js

@@ -1,2 +1,2 @@
-import { $ as AuthLocalError, A as T3LocalAuthToken, C as T3AuthPairing, D as T3LocalAuth, E as parsePairingUrl, F as makeT3LocalAuthOrigin, Gp as T3Auth, M as makeT3LocalAuthToken, N as T3LocalAuthOrigin, O as T3LocalAuthLive, P as T3LocalAuthOriginLive, Q as AuthLocalDatabaseError, S as makeT3Auth, T as makeT3AuthPairing, Z as AuthConfigError, et as AuthLocalSecretError, j as T3LocalAuthTokenLive, k as makeT3LocalAuth, nt as AuthPairingUrlError, rt as AuthTransportError, tt as AuthLocalSigningError, w as T3AuthPairingLive, x as T3AuthLive } from "./shared.js";
+import { Ai as AuthConfigError, Ci as T3LocalAuthToken, Di as T3LocalAuthOriginLive, Ei as T3LocalAuthOrigin, Fi as AuthPairingUrlError, Ii as AuthTransportError, Mi as AuthLocalError, Ni as AuthLocalSecretError, Oi as makeT3LocalAuthOrigin, Pi as AuthLocalSigningError, Si as makeT3LocalAuth, Ti as makeT3LocalAuthToken, _i as T3AuthPairingLive, bi as T3LocalAuth, gi as T3AuthPairing, hi as makeT3Auth, ji as AuthLocalDatabaseError, mC as T3Auth, mi as T3AuthLive, vi as makeT3AuthPairing, wi as T3LocalAuthTokenLive, xi as T3LocalAuthLive, yi as parsePairingUrl } from "./shared.js";
 export { AuthConfigError, AuthLocalDatabaseError, AuthLocalError, AuthLocalSecretError, AuthLocalSigningError, AuthPairingUrlError, AuthTransportError, T3Auth, T3AuthLive, T3AuthPairing, T3AuthPairingLive, T3LocalAuth, T3LocalAuthLive, T3LocalAuthOrigin, T3LocalAuthOriginLive, T3LocalAuthToken, T3LocalAuthTokenLive, makeT3Auth, makeT3AuthPairing, makeT3LocalAuth, makeT3LocalAuthOrigin, makeT3LocalAuthToken, parsePairingUrl };

package/dist/bin.d.ts

@@ -0,0 +1 @@
+export {}