@slopus/happy-terminal 0.3.0-beta.13

package/dist/protocol/WorkletProtocol.d.ts

@@ -0,0 +1,159 @@
+import { type Static } from "@sinclair/typebox";
+import type { EventId } from "./EventId.js";
+/**
+ * What a worklet is doing right now.
+ *
+ * `starting` covers the window a freshly launched worklet has to register its tools and report
+ * ready. `running` means it is up and its tools are callable. `asleep` is reserved for a worklet
+ * that has nothing outstanding and has been parked; nothing puts a worklet to sleep yet.
+ */
+export declare const workletStateSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"asleep">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
+export type WorkletState = Static<typeof workletStateSchema>;
+export declare const workletToolSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TString;
+}>;
+export type WorkletTool = Static<typeof workletToolSchema>;
+/** A worklet always writes only inside its own durable `Data` folder. */
+export declare const workletDiskPermissionSchema: import("@sinclair/typebox").TLiteral<"none">;
+export type WorkletDiskPermission = Static<typeof workletDiskPermissionSchema>;
+/**
+ * Where a worklet may reach on the network. A scoped worklet's traffic runs through Happy Terminal's managed
+ * proxy, which allows exactly the declared hosts and refuses the rest.
+ */
+export declare const workletNetworkPermissionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"none">, import("@sinclair/typebox").TObject<{
+    hosts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>]>;
+export type WorkletNetworkPermission = Static<typeof workletNetworkPermissionSchema>;
+/** Everything a worklet may touch beyond its own folder and the socket it reaches Happy Terminal on. */
+export declare const workletPermissionsSchema: import("@sinclair/typebox").TObject<{
+    disk: import("@sinclair/typebox").TLiteral<"none">;
+    network: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"none">, import("@sinclair/typebox").TObject<{
+        hosts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    }>]>;
+}>;
+export type WorkletPermissions = Static<typeof workletPermissionsSchema>;
+/**
+ * One imported version, carrying the manifest it was imported with.
+ *
+ * What a worklet says about itself and what it is allowed to do are properties of its code, so
+ * they are recorded per version. Reverting therefore restores the older version's permissions
+ * along with its source, and never leaves a newer grant in force.
+ */
+export declare const workletVersionSchema: import("@sinclair/typebox").TObject<{
+    version: import("@sinclair/typebox").TInteger;
+    changeDescription: import("@sinclair/typebox").TString;
+    createdAt: import("@sinclair/typebox").TNumber;
+    description: import("@sinclair/typebox").TString;
+    permissions: import("@sinclair/typebox").TObject<{
+        disk: import("@sinclair/typebox").TLiteral<"none">;
+        network: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"none">, import("@sinclair/typebox").TObject<{
+            hosts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        }>]>;
+    }>;
+}>;
+export type WorkletVersion = Static<typeof workletVersionSchema>;
+/**
+ * A worklet is background compute Happy Terminal keeps running: TypeScript imported as a source folder,
+ * versioned like an applet, writing only into its own `Data` folder, and declaring tools any
+ * agent can call.
+ */
+export declare const workletSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TString;
+    /** What the current version's manifest asks for, and what Happy Terminal is enforcing right now. */
+    permissions: import("@sinclair/typebox").TObject<{
+        disk: import("@sinclair/typebox").TLiteral<"none">;
+        network: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"none">, import("@sinclair/typebox").TObject<{
+            hosts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        }>]>;
+    }>;
+    iconThumbhash: import("@sinclair/typebox").TString;
+    iconUrl: import("@sinclair/typebox").TString;
+    authorSessionId: import("@sinclair/typebox").TString;
+    sourceDescription: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    currentVersion: import("@sinclair/typebox").TInteger;
+    versions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        version: import("@sinclair/typebox").TInteger;
+        changeDescription: import("@sinclair/typebox").TString;
+        createdAt: import("@sinclair/typebox").TNumber;
+        description: import("@sinclair/typebox").TString;
+        permissions: import("@sinclair/typebox").TObject<{
+            disk: import("@sinclair/typebox").TLiteral<"none">;
+            network: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"none">, import("@sinclair/typebox").TObject<{
+                hosts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            }>]>;
+        }>;
+    }>>;
+    createdAt: import("@sinclair/typebox").TNumber;
+    updatedAt: import("@sinclair/typebox").TNumber;
+    /** The folder the worklet writes into. It survives every version change. */
+    dataDirectory: import("@sinclair/typebox").TString;
+    state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"starting">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"asleep">, import("@sinclair/typebox").TLiteral<"stopped">, import("@sinclair/typebox").TLiteral<"failed">]>;
+    /** The worklet's own words about itself, shown in the interface. */
+    status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Why the worklet is not running, when it failed or stopped. */
+    failure: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    tools: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        name: import("@sinclair/typebox").TString;
+        description: import("@sinclair/typebox").TString;
+    }>>;
+}>;
+export type Worklet = Static<typeof workletSchema>;
+/**
+ * An install names a folder and an icon, and nothing else.
+ *
+ * The worklet's name, what it does, why it exists, and what it is allowed to touch all come from
+ * the `worklet.json` at the root of that folder, so the code and its declared powers arrive
+ * together and no caller can describe a worklet as something other than what it is.
+ */
+export declare const installWorkletRequestSchema: import("@sinclair/typebox").TObject<{
+    authorSessionId: import("@sinclair/typebox").TString;
+    path: import("@sinclair/typebox").TString;
+    iconPath: import("@sinclair/typebox").TString;
+    sourceDescription: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type InstallWorkletRequest = Static<typeof installWorkletRequestSchema>;
+export declare const updateWorkletRequestSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    changeDescription: import("@sinclair/typebox").TString;
+}>;
+export type UpdateWorkletRequest = Static<typeof updateWorkletRequestSchema>;
+export declare const revertWorkletRequestSchema: import("@sinclair/typebox").TObject<{
+    version: import("@sinclair/typebox").TInteger;
+}>;
+export type RevertWorkletRequest = Static<typeof revertWorkletRequestSchema>;
+export interface WorkletResponse {
+    worklet: Worklet;
+}
+export interface ListWorkletsResponse {
+    /** Which change this reading reflects, so a live event can be ordered against it. */
+    version: EventId;
+    worklets: readonly Worklet[];
+}
+export interface WorkletLogResponse {
+    log: string;
+    /** True when the read bound omitted older output. */
+    truncated: boolean;
+}
+export type WorkletManagementErrorCode = "invalid_request" | "invalid_worklet" | "worklet_not_found";
+export interface WorkletManagementErrorResponse {
+    error: {
+        code: WorkletManagementErrorCode;
+        message: string;
+    };
+}
+/**
+ * Worklets changed. Live-only, carrying the whole current set so a reconnecting client reads the
+ * current worklets instead of replaying every past install and state change.
+ */
+export interface WorkletsChangedEvent {
+    createdAt: number;
+    data: {
+        /** The catalog reading this event carries, comparable with a list response. */
+        version: EventId;
+        worklets: readonly Worklet[];
+    };
+    id: EventId;
+    type: "worklets_changed";
+}

package/dist/protocol/createEventIdFactory.d.ts

@@ -0,0 +1,7 @@
+import type { EventId } from "./EventId.js";
+export interface EventIdFactoryOptions {
+    after?: EventId;
+    now?: () => number;
+}
+export declare function createEventIdFactory(options?: EventIdFactoryOptions): () => EventId;
+export declare function eventIdsShareScope(left: string, right: string): boolean;

package/dist/protocol/index.d.ts

@@ -0,0 +1,34 @@
+export type { EventId } from "./EventId.js";
+export { CURRENT_ONBOARDING_VERSION, onboardMurmurRequestSchema, onboardMurmurResponseSchema, onboardingStatusSchema, type OnboardMurmurRequest, type OnboardMurmurResponse, type OnboardingStatus, } from "./OnboardingProtocol.js";
+export { createFolderShareRequestSchema, createSharingInvitationResponseSchema, folderShareStatusSchema, requestSharingContactRequestSchema, sharingChangedEventSchema, sharingConnectionSchema, sharingContactRequestSchema, sharingContactSchema, sharingIdentitySchema, sharingOutgoingContactRequestResponseSchema, sharingOutgoingContactRequestSchema, sharingSnapshotSchema, type CreateFolderShareRequest, type CreateSharingInvitationResponse, type FolderShareStatus, type RequestSharingContactRequest, type SharingChangedEvent, type SharingConnection, type SharingContact, type SharingContactRequest, type SharingIdentity, type SharingOutgoingContactRequest, type SharingOutgoingContactRequestResponse, type SharingSnapshot, } from "./SharingProtocol.js";
+export { createHappyAgentProfileRequestSchema, listHappyAgentProfilesResponseSchema, replicateHappyAgentProfileRequestSchema, happyAgentProfileChangedEventSchema, happyAgentProfileEmailSchema, happyAgentProfileIdentitySchema, happyAgentProfileIdSchema, happyAgentProfileNameSchema, happyAgentProfilePhotoInputSchema, happyAgentProfilePhotoSchema, happyAgentProfileResponseSchema, happyAgentProfileSchema, updateHappyAgentProfileRequestSchema, type CreateHappyAgentProfileRequest, type ListHappyAgentProfilesResponse, type ReplicateHappyAgentProfileRequest, type HappyAgentProfile, type HappyAgentProfileChangedEvent, type HappyAgentProfileId, type HappyAgentProfileIdentity, type HappyAgentProfilePhoto, type HappyAgentProfilePhotoInput, type HappyAgentProfileResponse, type UpdateHappyAgentProfileRequest, } from "./ProfileProtocol.js";
+export { PROJECT_ERROR_MAX_LENGTH } from "./ProjectProtocol.js";
+export { happyTerminalCliInstallationInspectionSchema, happyAgentDaemonInstallationDiscoverySchema, happyAgentDataEpochSchema, happyAgentInitializedDataSchema, happyAgentInstallationDataSchema, type HappyTerminalCliInstallationInspection, type HappyAgentDaemonInstallationDiscovery, type HappyAgentInitializedData, type HappyAgentInstallationData, } from "./InstallationProtocol.js";
+export { HAPPY_CLOUD_CONTRACT_VERSION, HAPPY_CLOUD_CIPHERTEXT_MAX_LENGTH, happyCloudCapabilitySchema, happyCloudChangedEventSchema, happyCloudCommandErrorResponseSchema, happyCloudCommandResponseSchema, happyCloudCommandSchema, happyCloudConsentSchema, happyCloudProfileCiphertextResponseSchema, happyCloudSessionBlobResponseSchema, happyCloudSessionIdSchema, happyCloudStatusSchema, type HappyCloudCapability, type HappyCloudCapabilityStatus, type HappyCloudChangedEvent, type HappyCloudCommandErrorResponse, type HappyCloudCommand, type HappyCloudCommandResponse, type HappyCloudConsent, type HappyCloudProfileCiphertextResponse, type HappyCloudSessionBlobResponse, type HappyCloudStatus, } from "./HappyCloudProtocol.js";
+export { computePreparationNoticeSchema, SERVICE_NOTICE_MESSAGE_MAX_LENGTH, SERVICE_NOTICE_TEXT_MAX_LENGTH, serviceNoticeSchema, systemNoticePayloadSchema, type ComputePreparationNotice, type ServiceNotice, type SystemNoticePayload, } from "./ServiceNotice.js";
+export type { BaseProjectEvent, BaseProjectWorkspaceEvent, ComputePreparationEvent, DiscoverPluginCatalogRequest, DiscoverPluginCatalogResponse, ComputePreparationPhase, CreateProjectWorkspaceRequest, CreateRemoteProjectRequest, GitChangeSnapshot, GitChangeState, GitComparisonState, GitStateResponse, GitWatchRequest, GitWatchResponse, GitFileChange, GitFileChangeStatus, GitRepositoryFacts, GlobalEvent, GlobalEventDelivery, GlobalEventQueueEntry, GlobalLiveEvent, GlobalLiveEventDelivery, GlobalStreamHello, PluginsChangedEvent, InstalledPluginSummary, InstallPluginRequest, InstallPluginResponse, ListPluginsResponse, PluginManagementErrorCode, PluginManagementErrorResponse, PluginInstallClassification, PluginInstallSource, PluginLogResponse, PluginLogSnapshot, PluginSummary, PresenceChangedEvent, PresenceSnapshot, PresenceSummary, SetPresenceRequestBody, ListGlobalEventsResponse, ListProjectsResponse, ListProjectWorkspacesResponse, Project, ProjectAvatar, ProjectAvatarSource, ProjectCreator, ProjectEvent, ProjectGitEvent, ProjectInitializationStatus, ProjectKind, ProjectNameSource, ProjectPresence, ProjectRegistrationErrorCode, ProjectRegistrationErrorResponse, ProjectRemoteSource, ProjectGitSecret, ProjectResponse, ProjectSettings, ProjectSettingsUpdate, ProjectScope, ProjectWorkspace, ProjectWorkspaceEvent, ProjectWorkspaceGitEvent, ProjectWorkspaceKind, ProjectWorkspaceResponse, ProjectWorkspaceStatus, ProjectWorktreeSupport, ProjectWorkspaceCompute, ProjectWorkspaceComputeInput, RemoteTerminalGroupState, RemoteTerminalsChangedEvent, RegisterProjectRequest, RenameProjectRequest, RenameProjectWorkspaceRequest, ReorderRequest, TrimGlobalEventsRequest, TrimGlobalEventsResponse, UpdateProjectSettingsRequest, UninstalledPluginSummary, UninstallPluginResponse, } from "./ProjectProtocol.js";
+export { fileTreeEntrySchema, listFileTreeRequestSchema, listFileTreeResponseSchema, writeProjectFileRequestSchema, type FileSearchResult, type FileTreeEntry, type ListFileTreeRequest, type ListFileTreeResponse, type ListProjectFilePathsResponse, type ReadProjectFileResponse, type ReadProjectFileRevisionResponse, type SearchFilesResponse, type WriteProjectFileRequest, type WriteProjectFileResponse, } from "./ProjectFileProtocol.js";
+export { createFolderItemRequestSchema, createFolderRequestSchema, folderItemSchema, folderItemResponseSchema, folderItemTargetSchema, folderSchema, listFoldersResponseSchema, folderErrorCodeSchema, folderErrorResponseSchema, moveFolderItemRequestSchema, moveFolderRequestSchema, updateFolderRequestSchema, FOLDER_ICON_MAX_LENGTH, FOLDER_NAME_MAX_LENGTH, FOLDER_TEXT_MAX_LENGTH, UNSORTED_SESSION_ARCHIVE_AFTER_MS, type CreateFolderItemRequest, type CreateFolderRequest, type Folder, type FolderErrorCode, type FolderErrorResponse, type FolderEvent, type FolderItem, type FolderItemResponse, type FolderItemTarget, type FolderResponse, type ListFoldersResponse, type MoveFolderItemRequest, type MoveFolderRequest, type UpdateFolderRequest, } from "./FolderProtocol.js";
+export { folderShareDescriptorSchema, folderShareOperationSchema, folderSharePacketSchema, MAX_SHARED_FOLDER_NODES, sharedFolderNodeSchema, sharedFolderStateSchema, type FolderShareDescriptor, type FolderShareOperation, type FolderSharePacket, type SharedFolderNode, type SharedFolderState, } from "./FolderSharingProtocol.js";
+export { createDocumentRequestSchema, documentCreatedBySchema, documentErrorCodeSchema, documentErrorResponseSchema, documentResponseSchema, documentSchema, documentUnreadCursorSchema, documentUpdatePageSchema, documentUpdateSchema, listDocumentUpdatesRequestSchema, writeDocumentRequestSchema, DOCUMENT_STATE_MAX_BYTES, DOCUMENT_UPDATE_MAX_BYTES, DOCUMENT_UPDATE_PAGE_MAX_LIMIT, DOCUMENT_UPDATE_RETENTION_MAX_BYTES, DOCUMENT_UPDATE_RETENTION_MAX_COUNT, type CreateDocumentRequest, type Document, type DocumentCreatedBy, type DocumentErrorCode, type DocumentErrorResponse, type DocumentEvent, type DocumentResponse, type DocumentUpdate, type DocumentUpdatePage, type ListDocumentUpdatesRequest, type WriteDocumentRequest, } from "./DocumentProtocol.js";
+export type { AgentBlock, AgentCompactionResult, AgentLoopEvent, AgentMessage, AgentSnapshot, AutoPermissionRisk, AutoPermissionUserAuthorization, BackgroundTerminalInteractionPresentation, BashSessionActivity, BashSessionSnapshot, ChangeGoalStatusRequest, CompactionMessage, ContentBlock, CreateGoalRequest, DockerExecutionConfig, DockerMountConfig, DurableSkillDefinition, EnvironmentSecretRegistration, EnvironmentSecretUpdate, ErrorMessage, ExecCommandPresentation, ExplorationOperation, ExplorationToolCallPresentation, ExternalToolCall, ExternalToolCallResolution, ExternalToolDefinition, FileDiff, FileDiffHunk, FileDiffKind, FileDiffLine, FileDiffLineKind, FileDiffToolResultPresentation, GoalStatus, ImageBlock, McpServerSummary, Message, Model, PermissionMode, ProviderError, ScheduledMessage, SecretAttachmentScope, SecretReference, ServiceTier, SessionExecutionEnvironment, SessionGoal, SessionTask, StopReason, SystemMessage, TaskStatus, TextBlock, ThinkingBlock, ToolCallBlock, ToolCallPresentation, ToolPermission, ToolPermissionReview, ToolResultBlock, ToolResultPresentation, Usage, UserInputOption, UserInputQuestion, UserInputRequest, UserInputResponse, UserMessage, WorkflowRun, WorkflowRunStatus, WorkflowRunUpdate, } from "./ClientProtocolTypes.js";
+export { environmentSecretRegistrationSchema, environmentSecretUpdateSchema, environmentVariableNameSchema, secretIdSchema, } from "./ClientProtocolTypes.js";
+export type { CreateRemoteTerminalRequest, CreateRemoteTerminalResponse, ListRemoteTerminalsResponse, RemoteTerminalColorScheme, RemoteTerminalResponse, RemoteTerminalScope, RemoteTerminalStatus, RemoteTerminalSummary, ResizeRemoteTerminalRequest, } from "../terminal/index.js";
+export { remoteTerminalColorSchemeSchema } from "../terminal/index.js";
+export type { ProviderUsage, ProviderUsageCredits, ProviderUsageWindow, } from "@slopus/happy-providers";
+export { isLiveGlobalEvent } from "./ProjectProtocol.js";
+export { discoverPluginCatalogRequestSchema, discoverPluginCatalogResponseSchema, createRemoteProjectRequestSchema, installPluginRequestSchema, pluginInstallSourceSchema, pluginInstallClassificationSchema, projectSettingsSchema, projectSettingsUpdateSchema, projectRegistrationErrorCodeSchema, projectRegistrationErrorResponseSchema, projectRemoteSourceSchema, projectGitSecretSchema, projectCreatorSchema, projectWorkspaceComputeSchema, projectWorkspaceComputeInputSchema, registerProjectRequestSchema, updateProjectSettingsRequestSchema, } from "./ProjectProtocol.js";
+export type { GetTimelineRequest, GetTimelineResponse, TimelineAgent, TimelineScope, TimelineSpan, TimelineSpanKind, TimelineSpanOutcome, } from "./TimelineProtocol.js";
+export { globalSecurityPolicySchema, type GetGlobalSecurityPolicyResponse, type UpdateGlobalSecurityPolicyRequest, type UpdateGlobalSecurityPolicyResponse, } from "./GlobalSecurityProtocol.js";
+export { createEventIdFactory, eventIdsShareScope, type EventIdFactoryOptions, } from "./createEventIdFactory.js";
+export type { AbortRequestedEvent, BroadcastMessageRequest, BroadcastMessageResponse, AttachSecretRequest, AnswerUserInputRequest, AbortRunOptions, AbortRunResponse, AgentMessageEvent, AgentStreamEvent, BaseSessionEvent, CancelScheduledMessageResponse, ChangeSessionGoalStatusRequest, CompactSessionResponse, CreateSessionRequest, CreateSessionResponse, DaemonConfig, DaemonIdentity, ExternalToolCallRequestedEvent, ExternalToolCallResolvedEvent, ForkSessionResponse, GetCurrentProviderQuotaResponse, GetDaemonConfigResponse, GetGlobalInstructionsResponse, GetSessionUsageResponse, ListProviderUsageResponse, ProviderUsageEntry, ProviderCredentialProvenance, ListSessionsResponse, ListSessionsArchivedFilter, ListSessionsOptions, ListSecretsResponse, ListExternalToolCallsResponse, ListSubagentsResponse, ListModelsResponse, HealthResponse, ReadyHealthResponse, GoalChangedEvent, GoalSessionResponse, ModelCatalog, MessageSubmittedEvent, McpServersChangedEvent, PermissionModeChangedEvent, ProviderModelCatalog, ProtocolSession, MoveSessionRequest, ProviderQuotaObservedEvent, ReadBackgroundProcessResponse, ResolveExternalToolCallRequest, ResolveExternalToolCallResponse, RewindSessionRequest, RewindSessionResponse, RegisterSecretRequest, RegisterSecretResponse, RunErrorEvent, RunFinishedEvent, RunShellCommandRequest, RunShellCommandResponse, RunShellCommandResult, RunningShellCommandResponse, RunStartedEvent, SecretSessionResponse, SecretSummary, SecretsChangedEvent, SetGoalRequest, SetSessionDraftRequest, SessionCreatedEvent, SessionContextUsage, SessionProviderQuota, SessionActivity, SessionActivityChangedEvent, SessionActivityCompaction, SessionActivityKind, SessionActivityPermissionReview, SessionActivityRetry, SessionActivityWait, SessionActivityToolCall, SessionActiveTurn, SessionAgentMetadata, SessionAgentType, SessionArchiveChangedEvent, SessionArchiveResponse, SessionDraftChangedEvent, SessionEvent, SessionGitChangedEvent, SessionInterruption, SessionInterruptionReason, SessionPartialMessage, SessionPermissionReview, SessionReadResponse, SessionStateResponse, SessionStreamHello, SessionTranscriptTurn, SessionTranscriptGroup, SessionTranscriptNotice, SessionTranscriptWindow, SessionResetEvent, SessionStatusChangedEvent, SessionRewoundEvent, SessionStatus, SessionScope, SessionSummaryStatus, SessionUnreadReason, SessionUnreadState, SessionWorkspaceArchivedEvent, SystemNoticeEvent, SessionConfigurationChangedEvent, SessionConfigurationField, SessionTitleChangedEvent, SessionUpdatedEvent, ScheduledMessageChangedEvent, SessionSummary, ShellCommandFinishedEvent, ShellCommandState, ShellCommandStartedEvent, StopBackgroundProcessResponse, StopInspectorResponse, SessionUsageGroup, SubagentChangedEvent, SubagentSummary, StopWorkflowResponse, SessionTitleStatus, ShutdownServerResponse, StartInspectorResponse, SubmitMessageRequest, SubmitMessageResponse, SubmitContextMessageRequest, SubmitContextMessageResponse, SteerMessageRequest, SteerMessageResponse, TasksChangedEvent, UnregisterSecretResponse, UpdateSecretRequest, UpdateSecretResponse, UpdateDaemonConfigRequest, UpdateDaemonConfigResponse, UpdateGlobalInstructionsRequest, UpdateGlobalInstructionsResponse, UpdateSessionRequest, UserInputRequestedEvent, GetPresenceResponse, SetPresenceResponse, UserInputDetachedEvent, UserInputResolvedEvent, WorkflowChangedEvent, } from "./SessionProtocol.js";
+export { providerCredentialProvenanceSchema } from "./SessionProtocol.js";
+export { createSlotEntryRequestSchema, slotActionSchema, slotContentSchema, slotEntryAuthorSchema, slotEntrySchema, slotNameSchema, slotScopeSchema, updateSlotEntryRequestSchema, type CreateSlotEntryRequest, type ListSlotEntriesResponse, type SlotAction, type SlotContent, type SlotEntryAuthor, type SlotEntry, type SlotEntryFilter, type SlotEntryResponse, type SlotManagementErrorCode, type SlotManagementErrorResponse, type SlotName, type SlotScope, type SlotsChangedEvent, type UpdateSlotEntryRequest, } from "./SlotProtocol.js";
+export { createAppletRequestSchema, defaultAppletAllowedScopes, resolveAppletOpenRequestSchema, resolveAppletOpenResponseSchema, revertAppletRequestSchema, updateAppletRequestSchema, appletAllowedScopesSchema, appletContextSchema, appletSchema, appletVersionSchema, type CreateAppletRequest, type ListAppletsResponse, type ResolveAppletOpenRequest, type ResolveAppletOpenResponse, type RevertAppletRequest, type UpdateAppletRequest, type Applet, type AppletAllowedScopes, type AppletContext, type AppletManagementErrorCode, type AppletManagementErrorResponse, type AppletResponse, type AppletsChangedEvent, type AppletVersion, } from "./AppletProtocol.js";
+export { HAPPY_TERMINAL_PROTOCOL_VERSION } from "./ProtocolVersion.js";
+export { p2pInstanceIdSchema, p2pPeerIdentitySchema, p2pPublicKeySchema, type P2pPeerIdentity, } from "./P2pIdentityProtocol.js";
+export { p2pCredentialMaterialSchema, p2pCredentialReplaceResponseSchema, p2pCredentialSnapshotSchema, p2pCredentialVersionConflictResponseSchema, p2pCredentialVisibilitySchema, p2pEncryptedCredentialSnapshotSchema, p2pShareSchema, provisionedProviderConfigSchema, provisionedProviderSchema, type P2pCredentialMaterial, type P2pCredentialReplaceResponse, type P2pCredentialSnapshot, type P2pCredentialVersionConflictResponse, type P2pCredentialVisibility, type P2pEncryptedCredentialSnapshot, type P2pShare, type ProvisionedProvider, type ProvisionedProviderConfig, } from "./P2pCredentialProtocol.js";
+export { p2pPeerConnectionStatusSchema, p2pPeerStatusSchema, p2pStatusChangedEventSchema, p2pStatusSchema, p2pTransportStatusSchema, type P2pPeerConnectionStatus, type P2pPeerStatus, type P2pStatus, type P2pStatusChangedEvent, type P2pTransportStatus, } from "./P2pProtocol.js";
+export { answerP2pVerificationRequestSchema, createP2pInvitationResponseSchema, joinP2pInvitationRequestSchema, joinP2pInvitationResponseSchema, p2pInvitationPayloadSchema, p2pPairingPeerSchema, p2pPairingStateSchema, type AnswerP2pVerificationRequest, type CreateP2pInvitationResponse, type JoinP2pInvitationRequest, type JoinP2pInvitationResponse, type P2pInvitationPayload, type P2pPairingPeer, type P2pPairingState, } from "./P2pPairingProtocol.js";
+export { SESSION_DRAFT_MAX_CLOCK_SKEW_MS, SESSION_DRAFT_MAX_LENGTH, SESSION_TRANSCRIPT_NOTICE_LIMIT, SESSION_STREAM_TURN_LIMIT, moveSessionRequestSchema, submitContextMessageRequestSchema, sessionScopeSchema, updateDaemonConfigRequestSchema, } from "./SessionProtocol.js";
+export { AttachmentImagePreviewSchema, AttachmentSchema, type Attachment, type AttachmentImagePreview, } from "./Attachment.js";

package/dist/readPackageVersion.d.ts

@@ -0,0 +1 @@
+export declare function readPackageVersion(): string;

package/dist/readPackageVersion.js

@@ -0,0 +1,16 @@
+import { createRequire as createBundleRequire } from "node:module"; const require = createBundleRequire(import.meta.url);
+
+// sources/readPackageVersion.ts
+import { readFileSync } from "node:fs";
+function readPackageVersion() {
+  try {
+    const contents = readFileSync(new URL("../package.json", import.meta.url), "utf8");
+    const manifest = JSON.parse(contents);
+    return typeof manifest.version === "string" ? manifest.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+export {
+  readPackageVersion
+};

package/dist/reportCliFailure.d.ts

@@ -0,0 +1,2 @@
+export declare function reportCliFailure(error: unknown, write?: (text: string) => void): void;
+export declare function reportCliFailureAndExit(error: unknown, write?: (text: string) => void, exit?: (code: number) => never): never;

package/dist/runHappyTerminal.d.ts

@@ -0,0 +1,6 @@
+import type { Context } from "@steve.kite/stdlib";
+import { type RunAppOptions } from "./app/runApp.js";
+export type RunHappyTerminalOptions = RunAppOptions;
+/** Runs Happy Terminal on the current process's stdin and stdout until the user exits it. */
+export declare function runHappyTerminal(options?: RunHappyTerminalOptions): Promise<void>;
+export declare function runHappyTerminalWithContext(ctx: Context, options?: RunHappyTerminalOptions): Promise<void>;

package/dist/terminal/index.d.ts

@@ -0,0 +1,2 @@
+export type { CreateRemoteTerminalRequest, CreateRemoteTerminalResponse, ListRemoteTerminalsResponse, RemoteTerminalColorScheme, RemoteTerminalResponse, RemoteTerminalScope, RemoteTerminalStatus, RemoteTerminalSummary, ResizeRemoteTerminalRequest, } from "./types.js";
+export { remoteTerminalColorSchemeSchema } from "./types.js";

package/dist/terminal/types.d.ts

@@ -0,0 +1,39 @@
+import { type Static } from "@sinclair/typebox";
+export type RemoteTerminalStatus = "exited" | "running";
+export declare const remoteTerminalColorSchemeSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"dark">, import("@sinclair/typebox").TLiteral<"light">]>;
+export type RemoteTerminalColorScheme = Static<typeof remoteTerminalColorSchemeSchema>;
+export interface RemoteTerminalScope {
+    projectId: string;
+    workspaceId?: string;
+}
+export interface CreateRemoteTerminalRequest {
+    cols?: number;
+    colorScheme?: RemoteTerminalColorScheme;
+    command?: string;
+    cwd?: string;
+    maxScrollback?: number;
+    rows?: number;
+    shell?: string;
+}
+export interface RemoteTerminalSummary {
+    cols: number;
+    colorScheme: RemoteTerminalColorScheme;
+    epoch: string;
+    exitCode: number | null;
+    id: string;
+    rows: number;
+    status: RemoteTerminalStatus;
+}
+export interface CreateRemoteTerminalResponse {
+    terminal: RemoteTerminalSummary;
+}
+export interface ListRemoteTerminalsResponse {
+    terminals: readonly RemoteTerminalSummary[];
+}
+export interface ResizeRemoteTerminalRequest {
+    cols: number;
+    rows: number;
+}
+export interface RemoteTerminalResponse {
+    terminal: RemoteTerminalSummary;
+}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export type { AttachSecretRequest, CreateSessionRequest, CreateSessionResponse, GetDaemonConfigResponse, GetGlobalInstructionsResponse, HealthResponse, ListModelsResponse, ListSessionsArchivedFilter, ListSessionsOptions, ListSessionsResponse, ListSecretsResponse, ListSubagentsResponse, ModelCatalog, ProtocolSession, RegisterSecretRequest, RegisterSecretResponse, ResolveExternalToolCallRequest, ResolveExternalToolCallResponse, SecretSummary, SessionArchiveResponse, SubmitMessageRequest, SubmitMessageResponse, SubagentSummary, UnregisterSecretResponse, UpdateDaemonConfigRequest, UpdateGlobalInstructionsRequest, UpdateSecretRequest, UpdateSecretResponse, } from "./protocol/SessionProtocol.js";
+export type { GetGlobalSecurityPolicyResponse, UpdateGlobalSecurityPolicyRequest, UpdateGlobalSecurityPolicyResponse, } from "./protocol/GlobalSecurityProtocol.js";
+export type { ProjectScope, TrimGlobalEventsRequest } from "./protocol/ProjectProtocol.js";
+export type { FileSearchResult, FileTreeEntry, ListFileTreeRequest, ListFileTreeResponse, ListProjectFilePathsResponse, ReadProjectFileResponse, ReadProjectFileRevisionResponse, SearchFilesResponse, WriteProjectFileRequest, WriteProjectFileResponse, } from "./protocol/ProjectFileProtocol.js";
+export type { DurableSkillDefinition, ExternalToolCall, ExternalToolCallResolution, ExternalToolDefinition, } from "./protocol/ClientProtocolTypes.js";
+export type { CreateRemoteTerminalRequest, RemoteTerminalColorScheme, RemoteTerminalResponse, RemoteTerminalScope, RemoteTerminalSummary, } from "./terminal/types.js";

package/dist/writeStderrSync.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Writes to stderr synchronously. Node buffers `process.stderr.write` when stderr is a pipe or a
+ * file, so a report written that way can be lost when the process exits immediately afterwards.
+ */
+export declare function writeStderrSync(text: string): void;

package/package.json

@@ -0,0 +1,97 @@
+{
+    "name": "@slopus/happy-terminal",
+    "version": "0.3.0-beta.13",
+    "description": "Happy Terminal, the embeddable terminal client for Happy Agent.",
+    "keywords": [
+        "coding-agent",
+        "terminal"
+    ],
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/slopus/happy-agent.git"
+    },
+    "bin": {
+        "happy-terminal": "./dist/main.js",
+        "rig": "./dist/main.js"
+    },
+    "files": [
+        "dist",
+        "LICENSE-CODEX",
+        "LICENSE-HAPPY",
+        "LICENSE-GROK-BUILD",
+        "THIRD-PARTY-NOTICES.md"
+    ],
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        },
+        "./package-version": {
+            "types": "./dist/readPackageVersion.d.ts",
+            "import": "./dist/readPackageVersion.js",
+            "default": "./dist/readPackageVersion.js"
+        },
+        "./dist/main.js": "./dist/main.js",
+        "./dist/readPackageVersion.js": {
+            "types": "./dist/readPackageVersion.d.ts",
+            "import": "./dist/readPackageVersion.js",
+            "default": "./dist/readPackageVersion.js"
+        }
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "TMPDIR=\"$PWD/../../.local\" tsx scripts/build.ts",
+        "check": "tsc --noEmit",
+        "start": "node dist/main.js",
+        "test": "vitest run --isolate=false",
+        "test:live": "HAPPY_TERMINAL_LIVE_TEST=1 vitest run -c vitest.live.config.ts",
+        "test:watch": "vitest"
+    },
+    "dependencies": {
+        "@earendil-works/pi-tui": "^0.80.3",
+        "@ff-labs/fff-node": "^0.9.6",
+        "@libsql/client": "^0.17.4",
+        "@lydell/node-pty": "1.2.0-beta.15",
+        "@mariozechner/clipboard": "^0.3.9",
+        "@noble/ciphers": "^1.3.0",
+        "@noble/curves": "^1.9.7",
+        "@opentelemetry/api": "^1.9.1",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.221.0",
+        "@opentelemetry/resources": "^2.10.0",
+        "@opentelemetry/sdk-trace-base": "^2.10.0",
+        "@opentelemetry/sdk-trace-node": "^2.10.0",
+        "@opentelemetry/semantic-conventions": "^1.43.0",
+        "@paralleldrive/cuid2": "^3.3.0",
+        "@pydantic/monty": "0.0.18",
+        "@sinclair/typebox": "^0.34.49",
+        "@slopus/ghostty-wasm": "1.3.6",
+        "@slopus/ghostty-web": "0.1.3",
+        "@slopus/happy-agent-client": "0.0.13",
+        "@slopus/happy-providers": "0.0.11",
+        "@slopus/murmur": "0.4.4",
+        "@steve.kite/stdlib": "0.0.12",
+        "drizzle-orm": "^0.45.2",
+        "pino": "^10.3.1",
+        "sharp": "^0.35.3",
+        "smol-toml": "^1.7.0",
+        "socket.io-client": "^4.8.3",
+        "turndown": "^7.2.4",
+        "ws": "^8.21.1"
+    },
+    "devDependencies": {
+        "@types/node": "^24.0.10",
+        "@types/ws": "^8.18.1",
+        "esbuild": "^0.28.1",
+        "tsx": "^4.23.0",
+        "typescript": "^5.8.3",
+        "vitest": "^3.2.4"
+    },
+    "engines": {
+        "node": ">=24"
+    }
+}