sim 2.1.7-preview.92.1 → 2.1.8-dev.101.1

package/dist/terminal/secret-input.d.ts

@@ -0,0 +1,15 @@
+import type { ReadStream } from 'node:tty';
+import { SimApiError } from '../http/client';
+/**
+ * Raised when the user abandons the prompt with Ctrl-C or Ctrl-D, so the caller
+ * can exit 130 rather than folding an abort into the generic failure code.
+ */
+export declare class SecretInputCancelledError extends SimApiError {
+    constructor();
+}
+interface SecretOutput {
+    write(value: string): unknown;
+}
+/** Reads a secret from a TTY while rendering one mask character per entered character. */
+export declare function promptSecret(input?: ReadStream, output?: SecretOutput): Promise<string>;
+export {};

package/dist/terminal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Anything the CLI can explain prints as one line and exits 1. An unexpected
+ * error keeps its stack trace — that is a bug in the CLI, and hiding it behind a
+ * friendly message would make it unreportable.
+ */
+export declare function runTerminalCli(program?: import("commander").Command): Promise<void>;

package/dist/transfer/local-file.d.ts

@@ -0,0 +1,16 @@
+import { type EmbedContext } from '../embed-context';
+/** Both positional file spellings address the caller's same path. */
+export declare function embeddedFileKey(path: string): string;
+/**
+ * An embedded run executes in-process on the hosting server, so a positional path must
+ * never reach the server's filesystem. Only the caller-provided file reader may
+ * resolve it; missing capabilities and read failures stay explicit.
+ */
+export declare function embeddedFileContent(embedded: EmbedContext, path: string): Promise<string | Uint8Array<ArrayBuffer>>;
+export declare function contentTypeFor(name: string): string;
+export interface LocalFile {
+    name: string;
+    size: number;
+}
+/** Validates the size and name shared by every local-file transfer. */
+export declare function localFile(path: string, override?: string): Promise<LocalFile>;

package/dist/transfer/streaming-upload.d.ts

@@ -0,0 +1,16 @@
+/** One forward-only file stream shared by a PUT or successive multipart requests. */
+export declare class StreamingUpload {
+    private readonly size;
+    private position;
+    private pending;
+    private closed;
+    private readonly reader;
+    private readonly onAbort;
+    private readonly stopped;
+    readonly signal: AbortSignal;
+    constructor(stream: ReadableStream<Uint8Array>, size: number, signal?: AbortSignal);
+    slice(start: number, end: number): ReadableStream<Uint8Array>;
+    assertConsumed(end: number): void;
+    verifyComplete(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/transfer/upload-session.d.ts

@@ -0,0 +1,18 @@
+import { SimClient } from '../http/client';
+export type UploadTransfer = {
+    method: 'put';
+    url: string;
+    headers: Record<string, string>;
+} | {
+    method: 'multipart';
+    partSize: number;
+    partCount: number;
+};
+export interface UploadSession {
+    basePath: string;
+    uploadToken: string;
+    transfer: UploadTransfer;
+    size: number;
+}
+/** Uploads and completes a signed transfer, aborting its session if the transfer fails. */
+export declare function finishUploadSession<T>(client: SimClient, workspaceId: string, session: UploadSession, path: string): Promise<T>;

package/dist/update/check.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The once-a-day "there is a newer sim" notice.
+ *
+ * It exists because a missing subcommand is indistinguishable from a feature
+ * that was never built: someone on 2.1.2 looking for `sim tools execute` — added
+ * in 2.1.5 — sees a help listing without it and concludes the CLI cannot do it.
+ * The version is the only thing that can tell them otherwise.
+ *
+ * Everything here fails silently. A courtesy notice that breaks a command, or
+ * that writes anything to stdout, is worse than no notice at all.
+ */
+export interface UpdateCheckOptions {
+    /** Current working directory. Injected so project-local installation detection is testable. */
+    cwd?: string;
+    currentVersion?: string;
+    env?: NodeJS.ProcessEnv;
+    /** Whether stderr is a terminal. Injected so the suppression rule is testable. */
+    isTty?: boolean;
+    /** Location of the running module, used to recognise npx and local builds. */
+    modulePath?: string;
+    now?: Date;
+    /** Registry transport. Injectable so network behavior can be tested without global state. */
+    registryRequest?: RegistryRequest;
+    write?: (message: string) => void;
+}
+interface RegistryRequestOptions {
+    headers: Record<string, string>;
+    maxResponseBytes: number;
+    timeoutMs: number;
+}
+type RegistryRequest = (url: URL, options: RegistryRequestOptions) => Promise<string | null>;
+/**
+ * The command that upgrades *this* installation.
+ *
+ * The path is asked first because it describes the installation; the
+ * environment is a fallback because for a globally installed CLI it usually
+ * describes nothing but the shell that happened to invoke it.
+ */
+export declare function upgradeCommand(modulePath?: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * Uses a daily cache before telling the user their installation is out of date.
+ *
+ * Wired as a root `preAction` hook rather than a teardown in the entrypoint for
+ * two structural reasons: commander answers `--help` and `--version` during
+ * parsing, before any action hook runs, so the two most latency-sensitive
+ * invocations are excluded by construction rather than by a check; and some
+ * commands call `process.exit` directly, which a `finally` would never see.
+ *
+ * Never throws, writes only plain text to stderr, and stays silent when stderr
+ * is redirected. The caller runs this before the user's actual command.
+ */
+export declare function announceUpdateIfAvailable(options?: UpdateCheckOptions): Promise<void>;
+export {};

package/dist/version.d.ts

@@ -0,0 +1,10 @@
+export declare function cliVersion(): string;
+/**
+ * Identifies the CLI to the API, the way every other terminal client does.
+ *
+ * Without it a CLI request is indistinguishable from any other API traffic, so
+ * a bug that only reproduces on one CLI version cannot be found in the server's
+ * own logs. The runtime and platform ride along for the same reason: they are
+ * the first things asked about a transport failure that only some users see.
+ */
+export declare function userAgent(): string;

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "sim",
-  "version": "2.1.7-preview.92.1",
+  "version": "2.1.8-dev.101.1",
   "description": "Sim CLI - talk to the Sim API from your terminal",
   "type": "module",
+  "imports": {
+    "#cli/*": "./src/*.ts"
+  },
   "bin": {
     "sim": "dist/index.js"
   },
   "scripts": {
     "prebuild": "bun run clean",
-    "build": "bun build src/index.ts --target=node --format=esm --packages=bundle --reject-unresolved --outfile=dist/index.js",
+    "build": "bun build src/index.ts src/runtime.ts --target=node --format=esm --packages=bundle --reject-unresolved --outdir=dist && tsc -p tsconfig.types.json",
     "clean": "bun -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true })\"",
     "type-check": "tsc --noEmit",
     "lint": "biome check --write --unsafe .",
@@ -57,5 +60,15 @@
     "@types/node": "24.2.1",
     "typescript": "^7.0.2",
     "vitest": "^4.1.0"
+  },
+  "exports": {
+    "./embed": {
+      "types": "./src/embed.ts",
+      "default": "./src/embed.ts"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "default": "./dist/runtime.js"
+    }
   }
 }