@botbotgo/common 1.0.0

package/dist/events/index.js

@@ -0,0 +1,20 @@
+import {
+  createAgentEventBus,
+  createConsoleAgentEventListener,
+  createProgressAgentEventListener,
+  createRuntime2TreeEventListener,
+  resolveRuntime2DebugConfig
+} from "../chunk-RUIAZ7GO.js";
+import "../chunk-OTWARMTU.js";
+import "../chunk-X4TDNR4V.js";
+import "../chunk-H5BG6SXW.js";
+import "../chunk-DIIWJNRE.js";
+import "../chunk-QG6CT2GZ.js";
+export {
+  createAgentEventBus,
+  createConsoleAgentEventListener,
+  createProgressAgentEventListener,
+  createRuntime2TreeEventListener,
+  resolveRuntime2DebugConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/events/progress-listener.d.ts

@@ -0,0 +1,8 @@
+import type { AgentEventListener } from "./index.js";
+export interface ProgressEventListenerOptions {
+    writer?: (line: string) => void;
+    runLabelReact?: string;
+    runLabelDeep?: string;
+    reasonForAction?: (action: string) => string | null;
+}
+export declare function createProgressAgentEventListener(options?: ProgressEventListenerOptions): AgentEventListener;

package/dist/events/runtime2-tree-listener.d.ts

@@ -0,0 +1,26 @@
+import type { AgentEventListener } from "./index.js";
+export interface Runtime2EventDebugConfig {
+    run?: boolean;
+    workspace?: boolean;
+    toolCall?: boolean;
+    stream?: boolean;
+    close?: boolean;
+}
+export interface Runtime2EventRuntimeConfig {
+    debug?: Runtime2EventDebugConfig;
+    eventLogLevel?: "silent" | "lifecycle" | "tools" | "verbose";
+}
+export interface Runtime2TreeEventListenerOptions {
+    runtimeConfig?: Runtime2EventRuntimeConfig;
+    writer?: (line: string) => void;
+}
+interface ResolvedDebugConfig {
+    run: boolean;
+    workspace: boolean;
+    toolCall: boolean;
+    stream: boolean;
+    close: boolean;
+}
+export declare function createRuntime2TreeEventListener(options?: Runtime2TreeEventListenerOptions): AgentEventListener;
+export declare function resolveRuntime2DebugConfig(runtimeConfig?: Runtime2EventRuntimeConfig): ResolvedDebugConfig;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createAgentEventBus, createConsoleAgentEventListener, createProgressAgentEventListener, createRuntime2TreeEventListener, type AgentEvent, type AgentEventBus, type AgentEventListener, type ProgressEventListenerOptions, type Runtime2EventDebugConfig, type Runtime2EventRuntimeConfig, type Runtime2TreeEventListenerOptions, } from "./events/index.js";
+export { createAgentContext, getDefaultAgentContext, AgentContextTokens, type AgentContext, type AgentContextTokenKey, } from "./context/index.js";
+export { formatLogPath, runStartupStep, StartupProgressRenderer, toErrorMessage, } from "./cli/index.js";
+export { asRecord, extractTextFromLlmOutput, normalizeToolList, shortToolName, stripNullishObjectFields, summarizeForLog, } from "./utils/index.js";

package/dist/index.js

@@ -0,0 +1,49 @@
+import {
+  StartupProgressRenderer,
+  formatLogPath,
+  runStartupStep,
+  toErrorMessage
+} from "./chunk-HBCZVEUG.js";
+import {
+  createAgentEventBus,
+  createConsoleAgentEventListener,
+  createProgressAgentEventListener,
+  createRuntime2TreeEventListener
+} from "./chunk-RUIAZ7GO.js";
+import {
+  asRecord,
+  extractTextFromLlmOutput,
+  normalizeToolList,
+  shortToolName,
+  stripNullishObjectFields,
+  summarizeForLog
+} from "./chunk-OTWARMTU.js";
+import "./chunk-X4TDNR4V.js";
+import {
+  AgentContextTokens
+} from "./chunk-H5BG6SXW.js";
+import {
+  createAgentContext,
+  getDefaultAgentContext
+} from "./chunk-DIIWJNRE.js";
+import "./chunk-QG6CT2GZ.js";
+export {
+  AgentContextTokens,
+  StartupProgressRenderer,
+  asRecord,
+  createAgentContext,
+  createAgentEventBus,
+  createConsoleAgentEventListener,
+  createProgressAgentEventListener,
+  createRuntime2TreeEventListener,
+  extractTextFromLlmOutput,
+  formatLogPath,
+  getDefaultAgentContext,
+  normalizeToolList,
+  runStartupStep,
+  shortToolName,
+  stripNullishObjectFields,
+  summarizeForLog,
+  toErrorMessage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/npm/cache.d.ts

@@ -0,0 +1,9 @@
+export interface EnsurePackageInCacheOptions {
+    cacheBase?: string;
+    /** Working directory used for npm view/pack (controls registry/.npmrc context). */
+    cwd?: string;
+    afterInstall?: (cacheDir: string, packageName: string) => void;
+}
+export declare function ensurePackageInCache(packageName: string, version?: string, options?: EnsurePackageInCacheOptions): string;
+export declare function getPackageEntryPath(packageRoot: string): string;
+export declare function importFromCache(packageRoot: string): Promise<unknown>;

package/dist/npm/command.d.ts

@@ -0,0 +1,36 @@
+export interface RunNpmCommandOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    stdio?: "pipe" | "inherit";
+    shell?: boolean;
+}
+export interface NpmCommandResult {
+    args: string[];
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    signal: NodeJS.Signals | null;
+    error?: Error;
+}
+export interface NpmInstallOptions extends RunNpmCommandOptions {
+    packages?: string[];
+    global?: boolean;
+    noPackageLock?: boolean;
+    legacyPeerDeps?: boolean;
+    registry?: string;
+}
+export interface NpmPublishOptions extends RunNpmCommandOptions {
+    tag?: string;
+    access?: "public" | "restricted";
+    registry?: string;
+}
+export declare function runNpmCommand(args: string[], options?: RunNpmCommandOptions): NpmCommandResult;
+export declare function assertNpmCommandSuccess(result: NpmCommandResult, context: string): void;
+export declare function npmSearchJson(query: string, options?: RunNpmCommandOptions): unknown[];
+export declare function npmInstall(options?: NpmInstallOptions): void;
+export declare function npmRunScript(script: string, options?: RunNpmCommandOptions): void;
+export declare function npmPublish(options?: NpmPublishOptions): void;
+export declare function npmRoot(options?: RunNpmCommandOptions & {
+    global?: boolean;
+}): string;

package/dist/npm/index.d.ts

@@ -0,0 +1 @@
+export { parseNpmProviderSpec, type NpmProviderSpec, } from "./provider.js";

package/dist/npm/index.js

@@ -0,0 +1,29 @@
+// src/npm/provider.ts
+var NPM_PROTOCOL_PREFIX = "npm:";
+function isNpmProviderSpec(spec) {
+  return typeof spec === "string" && spec.startsWith(NPM_PROTOCOL_PREFIX);
+}
+function parseNpmProvider(provider) {
+  if (!isNpmProviderSpec(provider)) return null;
+  const rest = provider.slice(NPM_PROTOCOL_PREFIX.length);
+  const hashIdx = rest.indexOf("#");
+  const fragment = hashIdx >= 0 ? rest.slice(hashIdx + 1) : void 0;
+  const beforeHash = hashIdx >= 0 ? rest.slice(0, hashIdx) : rest;
+  const atIdx = beforeHash.startsWith("@") ? beforeHash.indexOf("@", 1) : beforeHash.lastIndexOf("@");
+  const pkg = atIdx > 0 ? beforeHash.slice(0, atIdx) : beforeHash;
+  const tag = atIdx > 0 ? beforeHash.slice(atIdx + 1) : void 0;
+  return { pkg: pkg || beforeHash, tag: tag || void 0, fragment };
+}
+function parseNpmProviderSpec(spec) {
+  const parsed = parseNpmProvider(spec);
+  if (!parsed) return null;
+  return {
+    packageName: parsed.pkg,
+    version: parsed.tag,
+    provider: parsed.fragment
+  };
+}
+export {
+  parseNpmProviderSpec
+};
+//# sourceMappingURL=index.js.map

package/dist/npm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/npm/provider.ts"],"sourcesContent":["export const NPM_PROTOCOL_PREFIX = \"npm:\";\n\nexport interface NpmProviderInfo {\n  pkg: string;\n  tag?: string;\n  fragment?: string;\n}\n\nexport interface NpmProviderSpec {\n  packageName: string;\n  version?: string;\n  provider?: string;\n}\n\nexport function isNpmProviderSpec(spec: unknown): spec is string {\n  return typeof spec === \"string\" && spec.startsWith(NPM_PROTOCOL_PREFIX);\n}\n\nexport function parseNpmProvider(provider: string): NpmProviderInfo | null {\n  if (!isNpmProviderSpec(provider)) return null;\n  const rest = provider.slice(NPM_PROTOCOL_PREFIX.length);\n  const hashIdx = rest.indexOf(\"#\");\n  const fragment = hashIdx >= 0 ? rest.slice(hashIdx + 1) : undefined;\n  const beforeHash = hashIdx >= 0 ? rest.slice(0, hashIdx) : rest;\n  const atIdx = beforeHash.startsWith(\"@\") ? beforeHash.indexOf(\"@\", 1) : beforeHash.lastIndexOf(\"@\");\n  const pkg = atIdx > 0 ? beforeHash.slice(0, atIdx) : beforeHash;\n  const tag = atIdx > 0 ? beforeHash.slice(atIdx + 1) : undefined;\n  return { pkg: pkg || beforeHash, tag: tag || undefined, fragment };\n}\n\nexport function parseNpmProviderSpec(spec: string): NpmProviderSpec | null {\n  const parsed = parseNpmProvider(spec);\n  if (!parsed) return null;\n  return {\n    packageName: parsed.pkg,\n    version: parsed.tag,\n    provider: parsed.fragment,\n  };\n}\n"],"mappings":";AAAO,IAAM,sBAAsB;AAc5B,SAAS,kBAAkB,MAA+B;AAC/D,SAAO,OAAO,SAAS,YAAY,KAAK,WAAW,mBAAmB;AACxE;AAEO,SAAS,iBAAiB,UAA0C;AACzE,MAAI,CAAC,kBAAkB,QAAQ,EAAG,QAAO;AACzC,QAAM,OAAO,SAAS,MAAM,oBAAoB,MAAM;AACtD,QAAM,UAAU,KAAK,QAAQ,GAAG;AAChC,QAAM,WAAW,WAAW,IAAI,KAAK,MAAM,UAAU,CAAC,IAAI;AAC1D,QAAM,aAAa,WAAW,IAAI,KAAK,MAAM,GAAG,OAAO,IAAI;AAC3D,QAAM,QAAQ,WAAW,WAAW,GAAG,IAAI,WAAW,QAAQ,KAAK,CAAC,IAAI,WAAW,YAAY,GAAG;AAClG,QAAM,MAAM,QAAQ,IAAI,WAAW,MAAM,GAAG,KAAK,IAAI;AACrD,QAAM,MAAM,QAAQ,IAAI,WAAW,MAAM,QAAQ,CAAC,IAAI;AACtD,SAAO,EAAE,KAAK,OAAO,YAAY,KAAK,OAAO,QAAW,SAAS;AACnE;AAEO,SAAS,qBAAqB,MAAsC;AACzE,QAAM,SAAS,iBAAiB,IAAI;AACpC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO;AAAA,IACL,aAAa,OAAO;AAAA,IACpB,SAAS,OAAO;AAAA,IAChB,UAAU,OAAO;AAAA,EACnB;AACF;","names":[]}

package/dist/npm/install.d.ts

@@ -0,0 +1,8 @@
+export interface EnsureNpmPackageInstalledOptions {
+    version?: string;
+    cwd?: string;
+    stdio?: "inherit" | "pipe";
+    noPackageLock?: boolean;
+    logPrefix?: string;
+}
+export declare function ensureNpmPackageInstalled(packageName: string, options?: EnsureNpmPackageInstalledOptions): Promise<void>;

package/dist/npm/provider.d.ts

@@ -0,0 +1,14 @@
+export declare const NPM_PROTOCOL_PREFIX = "npm:";
+export interface NpmProviderInfo {
+    pkg: string;
+    tag?: string;
+    fragment?: string;
+}
+export interface NpmProviderSpec {
+    packageName: string;
+    version?: string;
+    provider?: string;
+}
+export declare function isNpmProviderSpec(spec: unknown): spec is string;
+export declare function parseNpmProvider(provider: string): NpmProviderInfo | null;
+export declare function parseNpmProviderSpec(spec: string): NpmProviderSpec | null;

package/dist/npm/version.d.ts

@@ -0,0 +1,11 @@
+export interface ResolveNpmVersionOptions {
+    cwd?: string;
+    timeoutMs?: number;
+}
+export declare function clearVersionCache(): void;
+export declare function resolveNpmPackageVersion(pkg: string, tag?: string, options?: ResolveNpmVersionOptions): string | null;
+export declare function resolveLatestVersionFromRegistry(packageName: string, options?: ResolveNpmVersionOptions): string;
+export declare function formatProviderDisplay(provider: string): string;
+export declare function getInstalledVersion(packageName: string, options?: {
+    cwd?: string;
+}): string | null;

package/dist/security-store/backends/file/index.d.ts

@@ -0,0 +1,19 @@
+import { type FileSecretStoreBackendOptions, type SecretStoreBackend, type SecretStoreBackendContext } from "../types.js";
+export declare class FileSecretStoreBackend implements SecretStoreBackend {
+    private readonly filePath;
+    private data;
+    private loading;
+    private writeQueue;
+    constructor(options?: FileSecretStoreBackendOptions);
+    init(): Promise<void>;
+    getSecret(service: string, account: string): Promise<string | undefined>;
+    setSecret(service: string, account: string, value: string): Promise<void>;
+    deleteSecret(service: string, account: string): Promise<boolean>;
+    getMasterKey(context: SecretStoreBackendContext): Promise<Buffer | null>;
+    setMasterKey(context: SecretStoreBackendContext, key: Buffer): Promise<void>;
+    private ensureLoaded;
+    private load;
+    private mutate;
+    private persist;
+    private setPermissions;
+}

package/dist/security-store/backends/index.d.ts

@@ -0,0 +1,7 @@
+import { type CreateSecretStoreBackendOptions, type SecretStoreBackend, type SecretStoreBackendName } from "./types.js";
+export declare function createSecretStoreBackend(backend?: SecretStoreBackendName | SecretStoreBackend, options?: CreateSecretStoreBackendOptions): SecretStoreBackend;
+export { FileSecretStoreBackend } from "./file/index.js";
+export { KeychainSecretStoreBackend } from "./keychain/index.js";
+export { MemorySecretStoreBackend } from "./memory/index.js";
+export { MASTER_KEY_LENGTH, deleteSecretFromKeychain, getKeyFromKeychain, getSecretFromKeychain, getTeamIdFromBinary, isPackagedApp, setKeyInKeychainWithAcl, setSecretInKeychain, } from "./keychain/index.js";
+export type { BiometricPolicy, CreateSecretStoreBackendOptions, FileSecretStoreBackendOptions, KeychainAccessOptions, SecretStoreBackend, SecretStoreBackendContext, SecretStoreBackendName, } from "./types.js";

package/dist/security-store/backends/keychain/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const SECURITY_BIN = "/usr/bin/security";
+export declare const CODESIGN_BIN = "/usr/bin/codesign";
+export declare const MASTER_KEY_LENGTH = 32;
+export declare const DEFAULT_BIOMETRIC_PROMPT = "Authenticate to access secure data";

package/dist/security-store/backends/keychain/index.d.ts

@@ -0,0 +1,17 @@
+import { MASTER_KEY_LENGTH } from "./constants.js";
+import { type KeychainAccessOptions, type SecretStoreBackend, type SecretStoreBackendContext } from "../types.js";
+import { isPackagedApp } from "./utils.js";
+export declare function getKeyFromKeychain(service: string, account: string, options?: KeychainAccessOptions): Promise<Buffer | null>;
+export declare function getSecretFromKeychain(service: string, account: string): Promise<string | null>;
+export declare function getTeamIdFromBinary(appBinPath: string): Promise<string | null>;
+export declare function setKeyInKeychainWithAcl(service: string, account: string, keyBuffer: Buffer, appBinPath: string, appleDeveloperTeamId?: string | null, options?: KeychainAccessOptions): Promise<void>;
+export declare function setSecretInKeychain(service: string, account: string, value: string): Promise<void>;
+export declare function deleteSecretFromKeychain(service: string, account: string): Promise<boolean>;
+export declare class KeychainSecretStoreBackend implements SecretStoreBackend {
+    getSecret(service: string, account: string): Promise<string | undefined>;
+    setSecret(service: string, account: string, value: string): Promise<void>;
+    deleteSecret(service: string, account: string): Promise<boolean>;
+    getMasterKey(context: SecretStoreBackendContext): Promise<Buffer | null>;
+    setMasterKey(context: SecretStoreBackendContext, key: Buffer): Promise<void>;
+}
+export { MASTER_KEY_LENGTH, isPackagedApp };

package/dist/security-store/backends/keychain/keytar.d.ts

@@ -0,0 +1,5 @@
+interface KeytarLike {
+    getPassword: (service: string, account: string) => Promise<string | null>;
+}
+export declare function getKeytar(): KeytarLike;
+export {};

package/dist/security-store/backends/keychain/swift-bridge.d.ts

@@ -0,0 +1,17 @@
+import { type BiometricPolicy } from "../types.js";
+type SwiftOp = "set" | "get";
+interface SwiftResult {
+    ok: boolean;
+    found?: boolean;
+    value?: string;
+    error?: string;
+}
+export declare function runSwiftKeychainWithFallback(op: SwiftOp, input: {
+    service: string;
+    account: string;
+    secret?: string;
+    prompt?: string;
+    biometric: BiometricPolicy;
+}): Promise<SwiftResult | undefined>;
+export declare function resolvePrompt(prompt?: string): string;
+export {};

package/dist/security-store/backends/keychain/utils.d.ts

@@ -0,0 +1,11 @@
+import { type BiometricPolicy } from "../types.js";
+export declare function assertMacOS(): void;
+export declare function assertNonEmpty(value: string, field: string): string;
+export declare function normalizeAppleDeveloperTeamId(teamId: string | null | undefined): string | undefined;
+export declare function normalizeBiometricPolicy(policy: BiometricPolicy | undefined): BiometricPolicy;
+export declare function resolveSwiftBiometricPolicy(policy: BiometricPolicy): Exclude<BiometricPolicy, "none" | "auto">;
+export declare function isSwiftUnavailableError(error: unknown): boolean;
+export declare function isSwiftEntitlementError(error: unknown): boolean;
+export declare function isKeychainNotFoundError(error: unknown): boolean;
+export declare function isPackagedApp(): boolean;
+export declare function resolveAppBinPath(appBinPath?: string): string;

package/dist/security-store/backends/memory/index.d.ts

@@ -0,0 +1,10 @@
+import { type SecretStoreBackend, type SecretStoreBackendContext } from "../types.js";
+export declare class MemorySecretStoreBackend implements SecretStoreBackend {
+    private readonly secrets;
+    private readonly masterKeys;
+    getSecret(service: string, account: string): Promise<string | undefined>;
+    setSecret(service: string, account: string, value: string): Promise<void>;
+    deleteSecret(service: string, account: string): Promise<boolean>;
+    getMasterKey(context: SecretStoreBackendContext): Promise<Buffer | null>;
+    setMasterKey(context: SecretStoreBackendContext, key: Buffer): Promise<void>;
+}

package/dist/security-store/backends/types.d.ts

@@ -0,0 +1,29 @@
+export interface SecretStoreBackendContext {
+    service: string;
+    account: string;
+    appBinPath?: string;
+    appleDeveloperTeamId?: string | null;
+    biometric?: BiometricPolicy;
+    prompt?: string;
+}
+export interface SecretStoreBackend {
+    init?(): Promise<void>;
+    getSecret(service: string, account: string): Promise<string | undefined>;
+    setSecret(service: string, account: string, value: string): Promise<void>;
+    deleteSecret(service: string, account: string): Promise<boolean>;
+    getMasterKey?(context: SecretStoreBackendContext): Promise<Buffer | null>;
+    setMasterKey?(context: SecretStoreBackendContext, key: Buffer): Promise<void>;
+}
+export interface FileSecretStoreBackendOptions {
+    filePath?: string;
+    service?: string;
+}
+export interface CreateSecretStoreBackendOptions {
+    service?: string;
+}
+export type SecretStoreBackendName = "keychain" | "memory" | "file";
+export type BiometricPolicy = "none" | "auto" | "user-presence" | "biometry-current-set";
+export interface KeychainAccessOptions {
+    biometric?: BiometricPolicy;
+    prompt?: string;
+}

package/dist/security-store/backends/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function buildEntryKey(service: string, account: string): string;
+export declare function defaultFileStorePath(service?: string): string;

package/dist/security-store/index.d.ts

@@ -0,0 +1,2 @@
+export { createSecretStore, type SecretStoreOptions, } from "./store.js";
+export { type SecretStoreBackendName, } from "./backends/index.js";