@chipschat/protocol 0.0.0-stage → 1.0.1

package/dist/src/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * `@chipschat/protocol` is Agent Connect. The Zod schemas here are canonical (decision 7): the
+ * JSON Schema in `generated/`, the TypeScript types, the documentation reference and the
+ * fixtures every layer's tests read are all produced from them by `pnpm gen:protocol`.
+ *
+ * It depends on `zod` and nothing else, so an SDK built on it stays light.
+ */
+export type * from "../generated/types.js";
+export type { Address, AddressInput } from "./address.js";
+export { isAgentKind, resolveAddress, takersOf } from "./address.js";
+export type { AgentContextWindowCopy, AgentContextWindowPut, AgentContextWindowView, CompactionState, CompactionView, LastCompaction, LongTurn, WindowChangeFrame, WindowChangeState, WindowChangeView, WindowCompactFrame, WindowLimit, WindowLimitAsk, } from "./agent-context-windows.js";
+export { agentContextWindowPut, agentContextWindowView, COMPACTED_BY, COMPACTION_STATES, compactionState, compactionView, LONG_TURN_FOLDS_MAX, lastCompaction, longTurn, WINDOW_ASK_WAIT_MS, WINDOW_CHANGE_STATES, WINDOW_LIMIT_CHOICES_MAX, windowChangeFrame, windowChangeState, windowChangeView, windowCompactFrame, windowLimit, windowLimitAsk, } from "./agent-context-windows.js";
+export type { AgentHeartbeatCopy, AgentHeartbeatPut, AgentHeartbeatView, HeartbeatChangeAsk, HeartbeatChangeFrame, HeartbeatChangeState, HeartbeatChangeView, } from "./agent-heartbeats.js";
+export { agentHeartbeatPut, agentHeartbeatView, HEARTBEAT_CHANGE_STATES, HEARTBEAT_CHANGE_WAIT_MS, HEARTBEAT_CHOICES_MAX, HEARTBEAT_EVERY_MAX, heartbeatChangeAsk, heartbeatChangeFrame, heartbeatChangeState, heartbeatChangeView, } from "./agent-heartbeats.js";
+export type { AgentModelCopy, AgentModelPut, AgentModelView, EffortLevel, ModelChangeAsk, ModelChangeFrame, ModelChangeState, ModelChangeView, ModelChoice, ModelDefault, } from "./agent-models.js";
+export { agentModelPut, agentModelView, EFFORT_LEVELS_MAX, effortFits, effortLevel, MODEL_CHANGE_STATES, MODEL_CHANGE_WAIT_MS, MODEL_CHOICES_MAX, modelChangeAsk, modelChangeFrame, modelChangeState, modelChangeView, modelChoice, modelDefault, } from "./agent-models.js";
+export type { AgentPlacement, PlaceRefusal, PlaceRoom } from "./agent-place.js";
+export { ONE_ROOM_REFUSALS, refuseAgentInto, STOPPED_BECAUSE } from "./agent-place.js";
+export type { LegacyView } from "./agents.js";
+export { AGENT_EVENTS, inLegacyView } from "./agents.js";
+export type { HarnessCapability } from "./capabilities.js";
+export { FORK_WAIT_MS, HARNESS_CAPABILITIES, NEW_AGENT_WAIT_MS, RESTART_WAIT_MS, } from "./capabilities.js";
+export type { ChecklistRow } from "./checklist.js";
+export { CONNECTION_CHECKLIST } from "./checklist.js";
+export type { CommandParts, StandingOffer } from "./commands.js";
+export { askedCommand, commandParts, commandStarts, NEVER_STANDING, neverStanding, standingOffer, startOf, startsWith, } from "./commands.js";
+export type { Connector, ConnectorKind, ConnectorsAnswer, ServerFacts } from "./connectors.js";
+export { CONNECTORS_MAX, connector, connectorKind, connectorsAnswer, fillLink, LINK_SLOT, readConnectors, serverFacts, } from "./connectors.js";
+export type { ContextBudget, ContextEvent, ContextLine, ReplyingTo, ReplyReading, RoomContext, Who, } from "./context.js";
+export { budgetOf, CONTEXT_BUDGET, CONTEXT_CEILING, CONTEXT_HEADING, contextBudget, contextLine, contextLines, linesOf, quoteOf, quotesBefore, REPLY_BEFORE_HEADING, REPLY_BEFORE_LINES, REPLY_QUOTE_CHARS, renderAttachment, renderContext, renderLine, renderReplyingTo, replyingTo, roomContext, withRole, } from "./context.js";
+export type { AgentContextPut, AgentContextView, ContextEditAsk, ContextEditFrame, ContextEditState, ContextEditView, ContextFile, ContextRole, HarnessContextPut, HarnessContextView, NotShownFile, SharedContextFile, } from "./context-files.js";
+export { agentContextPut, agentContextView, CONTEXT_EDIT_STATES, CONTEXT_EDIT_WAIT_MS, CONTEXT_FILE_BYTES, CONTEXT_FILES_SHOWN, CONTEXT_NOT_SHOWN_MAX, CONTEXT_ROLES, contextBytes, contextEditAsk, contextEditFrame, contextEditState, contextEditView, contextFile, contextRole, harnessContextPut, harnessContextView, notShownFile, STALE_CONTEXT, sharedContextFile, } from "./context-files.js";
+export { type DirectAskView, directAskState, directAskView, SHARE_LINK_MAX, shareLinkOf, } from "./direct-asks.js";
+export type { Direction, Envelope, EventDefinition, EventSender } from "./envelope.js";
+export { defineEvent, envelope, eventSchema, PROTOCOL_VERSION } from "./envelope.js";
+export * from "./events/index.js";
+export type { DeliveredExchange, ExchangeFacts, ExchangeLimits, ExchangeMessage, ExchangeRepeat, ExchangeReset, ExchangeStage, ExchangeStretch, } from "./exchange.js";
+export { CEILING, circleIn, DEFAULT_EXCHANGE_LIMITS, deliveredExchange, exchangeFacts, exchangeFactsOf, exchangeLimitsOf, exchangeReset, exchangeStage, HOLD_CHOICES, HOLD_RANGE, holds, limitsProblem, NUDGE_AT, nudgeAt, PERSON_ACTS, renderExchangeNote, repeatOf, resetsTheCount, STOP_CHOICES, STOP_RANGE, stageOf, WARN_AT, WORK_ACTS, wordsFor, } from "./exchange.js";
+export { AGENT_FIRST_NAMES, mayHoldName, pickAgentName } from "./first-names.js";
+export type { AgentState, ClientFrame, ErrorCode, FolderOpenFrame, FolderRunFrame, FolderRunStateFrame, ServerExtension, ServerFrame, } from "./frames.js";
+export { ackFrame, agentState, clientFrame, clientHelloFrame, errorCode, errorFrame, eventFrame, eventsFrame, FRAME_NAMES, folderOpenFrame, folderRunFrame, folderRunStateFrame, joinFrame, negotiateProtocol, pingFrame, pongFrame, presenceFrame, receiptFrame, restartFrame, SERVER_EXTENSIONS, serverFrame, subscribeFrame, } from "./frames.js";
+export type { HarnessJob, HarnessJobsCopy, HarnessJobsPut, HarnessJobsView, HarnessJobView, JobChangeAsk, JobChangeFrame, JobChangeState, JobChangeView, JobKind, JobRun, JobRunOutcome, JobRunsPost, JobRunsView, } from "./harness-jobs.js";
+export { HARNESS_JOBS_MAX, harnessJob, harnessJobsPut, harnessJobsView, harnessJobView, JOB_CHANGE_STATES, JOB_CHANGE_WAIT_MS, JOB_CHOICES_MAX, JOB_EVERY_MAX, JOB_KINDS, JOB_RUN_OUTCOMES, JOB_RUNS_KEPT_DAYS, JOB_RUNS_POST_MAX, JOB_RUNS_READ_MAX, jobChangeAsk, jobChangeFrame, jobChangeState, jobChangeView, jobId, jobKind, jobRun, jobRunOutcome, jobRunsPost, jobRunsView, } from "./harness-jobs.js";
+export type { Id, IdGenerator, IdGeneratorOptions, IdKind, IdPrefix } from "./ids/index.js";
+export { createIdGenerator, defaultIdGenerator, eventIdOfMessage, ID_PREFIXES, InvalidIdError, isId, messageIdOf, newId, parseId, timestampOf, } from "./ids/index.js";
+export type { InviteLink, InviteReach } from "./invite-link.js";
+export { inviteAppUrl, inviteFromLink, inviteRelayUrl, inviteUrl, RELAY_INVITE_PATH, } from "./invite-link.js";
+export type { JoinAsk, JoinAsked, JoinedDevice, JoinedHarness, JoinKind, JoinRequestView, JoinStartedBy, JoinState, LinkWaiting, } from "./join.js";
+export { GRANTABLE, isLinkKind, JOIN_ASKS_PER_MINUTE, JOIN_CODE_SECONDS, JOIN_LINK_SECONDS, JOIN_POLL_SECONDS, JOIN_WAITING_MAX, joinAsk, joinAsked, joinedDevice, joinedHarness, joinKind, joinLink, joinPending, joinRequestView, joinStartedBy, joinState, keyCode, keyCodeShown, LINK_KINDS, linkWaiting, parseJoinLink, } from "./join.js";
+export type { AttachmentCaps, CapKind } from "./limits.js";
+export { attachmentCap, CAP_KINDS, CAP_WORDS, capKind, capsOverCeiling, formatLimit, kindFromName, LONGEST_VOICE_NOTE_MS, NO_CAPS, sizeRefusal, } from "./limits.js";
+export type { ActionFlags } from "./matters.js";
+export { actionMatters, HOT_RISK } from "./matters.js";
+export type { Mentionable } from "./mentions.js";
+export { EVERYONE_HANDLE, handleMap, handlesIn, handlesOf, isHandle, mentionPattern, mentionsEveryone, resolveMentions, } from "./mentions.js";
+export { clashKey, FIRST_PERSON_NAME, freeAgentName, HIDDEN_CHARACTER_WORDS, isFormOf, MAX_NAME, MIXED_LETTERS_WORDS, NOT_AN_AGENT_WORDS, nameProblem, notAnAgentName, withoutHidden, } from "./names.js";
+export { isNoReply, NO_REPLY, passIfNothingSaid } from "./no-reply.js";
+export type { HarnessNotifications, NotificationSettings, QuietHours, SpaceNotifications, } from "./notifications.js";
+export { DEFAULT_NOTIFICATION_SETTINGS, harnessNotifications, notificationSettings, parseNotificationSettings, quietHours, spaceNotifications, timeOfDay, } from "./notifications.js";
+export { HTML_POLICY, PAGE_HEADER_POLICY, PAGE_SANDBOX } from "./pages.js";
+export type { PairingOffer, PairingPayload } from "./pairing.js";
+export { appPairingUrl, PAIRING_VERSION, pairingCode, pairingCodeTyped, pairingFromLink, pairingFromUrl, pairingPayload, pairingUrl, pairRelayUrl, RELAY_PAIR_PATH, serverKey, } from "./pairing.js";
+export type { Action, Actor, Attachment, AutonomyLevel, Budget, Cost, ParticipantKind, ParticipantRef, Policy, PolicyRule, Preview, RiskClass, SignedAttachment, Source, StepKind, TrailEntry, } from "./primitives.js";
+export { action, actor, agentId, approverRef, attachment, autonomyLevel, budget, cost, id, isoTimestamp, MAX_TRANSCRIPT_LENGTH, memberId, PARTICIPANT_KINDS, participantRef, policy, policyRule, preview, riskClass, signedAttachment, source, stepKind, trailEntry, } from "./primitives.js";
+export type { HeldRun, ProjectChangeAnswer, ProjectFacts, ProjectFilesAnswer, ProjectFolderOpenAnswer, ProjectHistoryAnswer, ProjectRun, ProjectRunAnswer, ProjectToken, ProjectUndoAnswer, RunRecipe, } from "./project.js";
+export { CHIPS_FOLDER, commandOf, commitId, committerId, FILE_LINK, heldRun, isSecretsFile, namesInWords, opensAProgram, opensShown, PROJECT_ACTOR_HEADER, PROJECT_BRANCH, PROJECT_CHANGED_FILES, PROJECT_GIT_VERSION, PROJECT_LEAVE_OUT, PROJECT_TOKEN_PREFIX, PROJECT_TOKEN_TTL_SECONDS, projectChangedFile, projectChangedPayload, projectFileType, projectFolderOpenAnswer, projectPath, projectRequest, projectRun, projectRunAnswer, projectToken, RUN_FILE, RUN_FILE_BEFORE, renderProjectAsks, renderProjectFacts, renderProjectNote, runRecipe, SECRET_SHAPES, SECRETS_FILE, START_PAGE, secretIn, } from "./project.js";
+export type { RangeAnswer } from "./ranges.js";
+export { byteRange, contentRange } from "./ranges.js";
+export type { CandidateAddress, RelayErrorCode, RelayFrame, RelayFrameName } from "./relay.js";
+export { candidateAddress, candidateAddresses, parseRelayFrame, RELAY_ERROR_CODES, RELAY_SESSION_ID_BYTES, RELAY_VERSION, relayChallengeFrame, relayCloseFrame, relayConnectedFrame, relayConnectFrame, relayErrorFrame, relayFrame, relayOpenFrame, relayServeFrame, relayServingFrame, relaySessionId, TUNNEL_DOOR_PATH, } from "./relay.js";
+export type { FileVersion, MadeFrom, PostedFile, RoomFile, StaleRefusal, } from "./room-files.js";
+export { currentFiles, ROOM_FILES_CEILING, ROOM_FILES_HEADING, ROOM_FILES_IN_CONTEXT, renderRoomFiles, roomFile, roomFiles, STALE_FILE, staleRefusal, staleVersion, staleWords, versionsNamed, versionsOf, } from "./room-files.js";
+export type { NoteMember, RoomIdle, RoomMember, RoomNote, RoomNow, RoomWork, TakerNews, } from "./room-note.js";
+export { noteHandle, noteWithoutRules, renderRoomNote, roomIdle, roomMember, roomMembers, roomNote, roomNoteFor, roomRules, roomWork, toEveryAgent, yoursWithoutAt, } from "./room-note.js";
+export type { SpaceIcon, SpaceIcons } from "./space-icons.js";
+export { faceLetters, lettersIn, lettersScale, MOST_FACE_LETTERS, parseSpaceIcon, SPACE_ICON_GROUNDS, spaceIcon, } from "./space-icons.js";
+export type { JobSpend, SpendStage } from "./spend.js";
+export { DEFAULT_SPEND_CEILING_USD, dollars, isSpendCeiling, jobSpend, SPEND_CEILING_MAX, SPEND_CEILING_MIN, SPEND_CEILING_STEP, SPEND_WARN_AT, spendCeiling, spendStage, spendWords, } from "./spend.js";
+export type { SeenEvent, Viewer } from "./visibility.js";
+export { APPROVER_EVENTS, ASK_EVENTS, canSee, DIRECTORY_EVENTS, FACE_EVENTS, FORK_EVENTS, HELD_EVENTS, JOIN_EVENTS, LOCK_EVENTS, MEMBERSHIP_EVENTS, namesApprover, namesViewer, opensFor, opensThreadIn, SELF_EVENTS, WHEREABOUTS_EVENTS, } from "./visibility.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -0,0 +1,47 @@
+/**
+ * `@chipschat/protocol` is Agent Connect. The Zod schemas here are canonical (decision 7): the
+ * JSON Schema in `generated/`, the TypeScript types, the documentation reference and the
+ * fixtures every layer's tests read are all produced from them by `pnpm gen:protocol`.
+ *
+ * It depends on `zod` and nothing else, so an SDK built on it stays light.
+ */
+export { isAgentKind, resolveAddress, takersOf } from "./address.js";
+export { agentContextWindowPut, agentContextWindowView, COMPACTED_BY, COMPACTION_STATES, compactionState, compactionView, LONG_TURN_FOLDS_MAX, lastCompaction, longTurn, WINDOW_ASK_WAIT_MS, WINDOW_CHANGE_STATES, WINDOW_LIMIT_CHOICES_MAX, windowChangeFrame, windowChangeState, windowChangeView, windowCompactFrame, windowLimit, windowLimitAsk, } from "./agent-context-windows.js";
+export { agentHeartbeatPut, agentHeartbeatView, HEARTBEAT_CHANGE_STATES, HEARTBEAT_CHANGE_WAIT_MS, HEARTBEAT_CHOICES_MAX, HEARTBEAT_EVERY_MAX, heartbeatChangeAsk, heartbeatChangeFrame, heartbeatChangeState, heartbeatChangeView, } from "./agent-heartbeats.js";
+export { agentModelPut, agentModelView, EFFORT_LEVELS_MAX, effortFits, effortLevel, MODEL_CHANGE_STATES, MODEL_CHANGE_WAIT_MS, MODEL_CHOICES_MAX, modelChangeAsk, modelChangeFrame, modelChangeState, modelChangeView, modelChoice, modelDefault, } from "./agent-models.js";
+export { ONE_ROOM_REFUSALS, refuseAgentInto, STOPPED_BECAUSE } from "./agent-place.js";
+export { AGENT_EVENTS, inLegacyView } from "./agents.js";
+export { FORK_WAIT_MS, HARNESS_CAPABILITIES, NEW_AGENT_WAIT_MS, RESTART_WAIT_MS, } from "./capabilities.js";
+export { CONNECTION_CHECKLIST } from "./checklist.js";
+export { askedCommand, commandParts, commandStarts, NEVER_STANDING, neverStanding, standingOffer, startOf, startsWith, } from "./commands.js";
+export { CONNECTORS_MAX, connector, connectorKind, connectorsAnswer, fillLink, LINK_SLOT, readConnectors, serverFacts, } from "./connectors.js";
+export { budgetOf, CONTEXT_BUDGET, CONTEXT_CEILING, CONTEXT_HEADING, contextBudget, contextLine, contextLines, linesOf, quoteOf, quotesBefore, REPLY_BEFORE_HEADING, REPLY_BEFORE_LINES, REPLY_QUOTE_CHARS, renderAttachment, renderContext, renderLine, renderReplyingTo, replyingTo, roomContext, withRole, } from "./context.js";
+export { agentContextPut, agentContextView, CONTEXT_EDIT_STATES, CONTEXT_EDIT_WAIT_MS, CONTEXT_FILE_BYTES, CONTEXT_FILES_SHOWN, CONTEXT_NOT_SHOWN_MAX, CONTEXT_ROLES, contextBytes, contextEditAsk, contextEditFrame, contextEditState, contextEditView, contextFile, contextRole, harnessContextPut, harnessContextView, notShownFile, STALE_CONTEXT, sharedContextFile, } from "./context-files.js";
+export { directAskState, directAskView, SHARE_LINK_MAX, shareLinkOf, } from "./direct-asks.js";
+export { defineEvent, envelope, eventSchema, PROTOCOL_VERSION } from "./envelope.js";
+export * from "./events/index.js";
+export { CEILING, circleIn, DEFAULT_EXCHANGE_LIMITS, deliveredExchange, exchangeFacts, exchangeFactsOf, exchangeLimitsOf, exchangeReset, exchangeStage, HOLD_CHOICES, HOLD_RANGE, holds, limitsProblem, NUDGE_AT, nudgeAt, PERSON_ACTS, renderExchangeNote, repeatOf, resetsTheCount, STOP_CHOICES, STOP_RANGE, stageOf, WARN_AT, WORK_ACTS, wordsFor, } from "./exchange.js";
+export { AGENT_FIRST_NAMES, mayHoldName, pickAgentName } from "./first-names.js";
+export { ackFrame, agentState, clientFrame, clientHelloFrame, errorCode, errorFrame, eventFrame, eventsFrame, FRAME_NAMES, folderOpenFrame, folderRunFrame, folderRunStateFrame, joinFrame, negotiateProtocol, pingFrame, pongFrame, presenceFrame, receiptFrame, restartFrame, SERVER_EXTENSIONS, serverFrame, subscribeFrame, } from "./frames.js";
+export { HARNESS_JOBS_MAX, harnessJob, harnessJobsPut, harnessJobsView, harnessJobView, JOB_CHANGE_STATES, JOB_CHANGE_WAIT_MS, JOB_CHOICES_MAX, JOB_EVERY_MAX, JOB_KINDS, JOB_RUN_OUTCOMES, JOB_RUNS_KEPT_DAYS, JOB_RUNS_POST_MAX, JOB_RUNS_READ_MAX, jobChangeAsk, jobChangeFrame, jobChangeState, jobChangeView, jobId, jobKind, jobRun, jobRunOutcome, jobRunsPost, jobRunsView, } from "./harness-jobs.js";
+export { createIdGenerator, defaultIdGenerator, eventIdOfMessage, ID_PREFIXES, InvalidIdError, isId, messageIdOf, newId, parseId, timestampOf, } from "./ids/index.js";
+export { inviteAppUrl, inviteFromLink, inviteRelayUrl, inviteUrl, RELAY_INVITE_PATH, } from "./invite-link.js";
+export { GRANTABLE, isLinkKind, JOIN_ASKS_PER_MINUTE, JOIN_CODE_SECONDS, JOIN_LINK_SECONDS, JOIN_POLL_SECONDS, JOIN_WAITING_MAX, joinAsk, joinAsked, joinedDevice, joinedHarness, joinKind, joinLink, joinPending, joinRequestView, joinStartedBy, joinState, keyCode, keyCodeShown, LINK_KINDS, linkWaiting, parseJoinLink, } from "./join.js";
+export { attachmentCap, CAP_KINDS, CAP_WORDS, capKind, capsOverCeiling, formatLimit, kindFromName, LONGEST_VOICE_NOTE_MS, NO_CAPS, sizeRefusal, } from "./limits.js";
+export { actionMatters, HOT_RISK } from "./matters.js";
+export { EVERYONE_HANDLE, handleMap, handlesIn, handlesOf, isHandle, mentionPattern, mentionsEveryone, resolveMentions, } from "./mentions.js";
+export { clashKey, FIRST_PERSON_NAME, freeAgentName, HIDDEN_CHARACTER_WORDS, isFormOf, MAX_NAME, MIXED_LETTERS_WORDS, NOT_AN_AGENT_WORDS, nameProblem, notAnAgentName, withoutHidden, } from "./names.js";
+export { isNoReply, NO_REPLY, passIfNothingSaid } from "./no-reply.js";
+export { DEFAULT_NOTIFICATION_SETTINGS, harnessNotifications, notificationSettings, parseNotificationSettings, quietHours, spaceNotifications, timeOfDay, } from "./notifications.js";
+export { HTML_POLICY, PAGE_HEADER_POLICY, PAGE_SANDBOX } from "./pages.js";
+export { appPairingUrl, PAIRING_VERSION, pairingCode, pairingCodeTyped, pairingFromLink, pairingFromUrl, pairingPayload, pairingUrl, pairRelayUrl, RELAY_PAIR_PATH, serverKey, } from "./pairing.js";
+export { action, actor, agentId, approverRef, attachment, autonomyLevel, budget, cost, id, isoTimestamp, MAX_TRANSCRIPT_LENGTH, memberId, PARTICIPANT_KINDS, participantRef, policy, policyRule, preview, riskClass, signedAttachment, source, stepKind, trailEntry, } from "./primitives.js";
+export { CHIPS_FOLDER, commandOf, commitId, committerId, FILE_LINK, heldRun, isSecretsFile, namesInWords, opensAProgram, opensShown, PROJECT_ACTOR_HEADER, PROJECT_BRANCH, PROJECT_CHANGED_FILES, PROJECT_GIT_VERSION, PROJECT_LEAVE_OUT, PROJECT_TOKEN_PREFIX, PROJECT_TOKEN_TTL_SECONDS, projectChangedFile, projectChangedPayload, projectFileType, projectFolderOpenAnswer, projectPath, projectRequest, projectRun, projectRunAnswer, projectToken, RUN_FILE, RUN_FILE_BEFORE, renderProjectAsks, renderProjectFacts, renderProjectNote, runRecipe, SECRET_SHAPES, SECRETS_FILE, START_PAGE, secretIn, } from "./project.js";
+export { byteRange, contentRange } from "./ranges.js";
+export { candidateAddress, candidateAddresses, parseRelayFrame, RELAY_ERROR_CODES, RELAY_SESSION_ID_BYTES, RELAY_VERSION, relayChallengeFrame, relayCloseFrame, relayConnectedFrame, relayConnectFrame, relayErrorFrame, relayFrame, relayOpenFrame, relayServeFrame, relayServingFrame, relaySessionId, TUNNEL_DOOR_PATH, } from "./relay.js";
+export { currentFiles, ROOM_FILES_CEILING, ROOM_FILES_HEADING, ROOM_FILES_IN_CONTEXT, renderRoomFiles, roomFile, roomFiles, STALE_FILE, staleRefusal, staleVersion, staleWords, versionsNamed, versionsOf, } from "./room-files.js";
+export { noteHandle, noteWithoutRules, renderRoomNote, roomIdle, roomMember, roomMembers, roomNote, roomNoteFor, roomRules, roomWork, toEveryAgent, yoursWithoutAt, } from "./room-note.js";
+export { faceLetters, lettersIn, lettersScale, MOST_FACE_LETTERS, parseSpaceIcon, SPACE_ICON_GROUNDS, spaceIcon, } from "./space-icons.js";
+export { DEFAULT_SPEND_CEILING_USD, dollars, isSpendCeiling, jobSpend, SPEND_CEILING_MAX, SPEND_CEILING_MIN, SPEND_CEILING_STEP, SPEND_WARN_AT, spendCeiling, spendStage, spendWords, } from "./spend.js";
+export { APPROVER_EVENTS, ASK_EVENTS, canSee, DIRECTORY_EVENTS, FACE_EVENTS, FORK_EVENTS, HELD_EVENTS, JOIN_EVENTS, LOCK_EVENTS, MEMBERSHIP_EVENTS, namesApprover, namesViewer, opensFor, opensThreadIn, SELF_EVENTS, WHEREABOUTS_EVENTS, } from "./visibility.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/invite-link.d.ts

@@ -0,0 +1,64 @@
+/**
+ * An invite as a link carries it (ADR 0164): the token, and beside it what an app needs to reach
+ * the server, as a pairing code's QR carries them (ADR 0038): the server's tunnel key, which the
+ * tunnel door on its network answers to (ADR 0191), and the relay the server dials out to when it
+ * has one, for an app that is not on that network. Two shapes:
+ *
+ *   https://host/#invite=chips_inv_…&relay=wss://…&key=…    the server's page, which a browser opens
+ *   chips://join?invite=chips_inv_…&lan=https://host&key=…  the apps' own, from "Open in Chips"
+ *
+ * And a third, the one sent when the server has a relay (ADR 0207): the relay's page, `/join`,
+ * which opens from anywhere and opens the iPhone app.
+ *
+ * The page's link names its server by its origin; the apps' link and the relay's have another
+ * origin or none, so the server travels as `lan`. In the fragment rather than the query, as a pairing code's is: a
+ * fragment never reaches a server's log, and the token is a key to the workspace.
+ *
+ * Read with a plain split rather than `new URL`: React Native's `URL` stops a hash at its first
+ * `/`, and a relay's address in the fragment has several (`apps/mobile/src/pairing/scanned.ts`).
+ */
+/** An invite in a link: the token, and where its server is when the link says. */
+export interface InviteLink {
+    readonly token: string;
+    /** The server on its network: the page's origin, or `lan` in the apps' link. */
+    readonly lan?: string | undefined;
+    /** The server's tunnel key (ADR 0191): what the tunnel door and the relay both answer to. */
+    readonly key?: string | undefined;
+    /** The relay the server dials out to, when it has one. Never without the key to ask for there. */
+    readonly relay?: string | undefined;
+}
+/** What a link carries beside the token. */
+export interface InviteReach {
+    readonly relay?: string | undefined;
+    readonly key?: string | undefined;
+}
+/** The link a person is sent: the server's page, with the invite in its fragment. */
+export declare function inviteUrl(base: string, token: string, invite?: InviteReach): string;
+/** Where an invite opens at a relay (ADR 0207): its page, and the path the iPhone app claims. */
+export declare const RELAY_INVITE_PATH = "/join";
+/**
+ * The link a person is sent when the server has a relay (ADR 0207): the relay's own page, with the
+ * invite in its fragment and the server beside it as `lan`, as the apps' link carries it. The
+ * relay is on the open internet where the server may not be, so the link opens for everybody, and
+ * on an iPhone with Chips it opens the app. The fragment never reaches the relay. `lan` is the
+ * server's origin, as the server's own page link named it. `until` is when the link runs out, in
+ * seconds, so the page can say so, as the pairing page does (ADR 0210).
+ *
+ *   https://relay.chipschat.ai/join#invite=chips_inv_…&lan=https://host&relay=wss://…&key=…&until=…
+ */
+export declare function inviteRelayUrl(relay: string, token: string, invite: {
+    readonly lan: string;
+    readonly key: string;
+    readonly until?: number | undefined;
+}): string;
+/** The same invite as a link the installed app opens: `chips://join?invite=…&lan=…`. */
+export declare function inviteAppUrl(invite: InviteLink & {
+    readonly lan: string;
+}): string;
+/**
+ * The invite in a link somebody pasted, scanned or opened: either shape, or the page's with the
+ * invite moved to the query by something that rewrote it. Nothing when it carries no invite, which
+ * is most of what a camera sees.
+ */
+export declare function inviteFromLink(text: string): InviteLink | undefined;
+//# sourceMappingURL=invite-link.d.ts.map

package/dist/src/invite-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invite-link.d.ts","sourceRoot":"","sources":["../../src/invite-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,kGAAkG;IAClG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAaD,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,GAAG,MAAM,CAIvF;AAED,iGAAiG;AACjG,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC1F,MAAM,CAQR;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAIlF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAyBnE"}

package/dist/src/invite-link.js

@@ -0,0 +1,99 @@
+/**
+ * An invite as a link carries it (ADR 0164): the token, and beside it what an app needs to reach
+ * the server, as a pairing code's QR carries them (ADR 0038): the server's tunnel key, which the
+ * tunnel door on its network answers to (ADR 0191), and the relay the server dials out to when it
+ * has one, for an app that is not on that network. Two shapes:
+ *
+ *   https://host/#invite=chips_inv_…&relay=wss://…&key=…    the server's page, which a browser opens
+ *   chips://join?invite=chips_inv_…&lan=https://host&key=…  the apps' own, from "Open in Chips"
+ *
+ * And a third, the one sent when the server has a relay (ADR 0207): the relay's page, `/join`,
+ * which opens from anywhere and opens the iPhone app.
+ *
+ * The page's link names its server by its origin; the apps' link and the relay's have another
+ * origin or none, so the server travels as `lan`. In the fragment rather than the query, as a pairing code's is: a
+ * fragment never reaches a server's log, and the token is a key to the workspace.
+ *
+ * Read with a plain split rather than `new URL`: React Native's `URL` stops a hash at its first
+ * `/`, and a relay's address in the fragment has several (`apps/mobile/src/pairing/scanned.ts`).
+ */
+/**
+ * What a link carries beside the token. A key alone is carried: the tunnel door on the server's
+ * network needs nothing else (ADR 0191). A relay rides only with a key, since a relay without the
+ * key to ask for there reaches nothing.
+ */
+function reach(fields, invite) {
+    if (invite.key === undefined || invite.key === "")
+        return;
+    if (invite.relay !== undefined && invite.relay !== "")
+        fields.set("relay", invite.relay);
+    fields.set("key", invite.key);
+}
+/** The link a person is sent: the server's page, with the invite in its fragment. */
+export function inviteUrl(base, token, invite = {}) {
+    const fields = new URLSearchParams({ invite: token });
+    reach(fields, invite);
+    return `${base.replace(/\/$/, "")}/#${fields.toString()}`;
+}
+/** Where an invite opens at a relay (ADR 0207): its page, and the path the iPhone app claims. */
+export const RELAY_INVITE_PATH = "/join";
+/**
+ * The link a person is sent when the server has a relay (ADR 0207): the relay's own page, with the
+ * invite in its fragment and the server beside it as `lan`, as the apps' link carries it. The
+ * relay is on the open internet where the server may not be, so the link opens for everybody, and
+ * on an iPhone with Chips it opens the app. The fragment never reaches the relay. `lan` is the
+ * server's origin, as the server's own page link named it. `until` is when the link runs out, in
+ * seconds, so the page can say so, as the pairing page does (ADR 0210).
+ *
+ *   https://relay.chipschat.ai/join#invite=chips_inv_…&lan=https://host&relay=wss://…&key=…&until=…
+ */
+export function inviteRelayUrl(relay, token, invite) {
+    const page = /^https?:\/\/[^/?#]+/i.exec(relay.replace(/^ws(s?):\/\//i, "http$1://"))?.[0];
+    if (page === undefined)
+        throw new Error(`not a relay's address: ${relay}`);
+    const lan = /^https?:\/\/[^/?#]+/i.exec(invite.lan)?.[0] ?? invite.lan.replace(/\/$/, "");
+    const fields = new URLSearchParams({ invite: token, lan });
+    reach(fields, { relay, key: invite.key });
+    if (invite.until !== undefined)
+        fields.set("until", String(Math.floor(invite.until)));
+    return `${page}${RELAY_INVITE_PATH}#${fields.toString()}`;
+}
+/** The same invite as a link the installed app opens: `chips://join?invite=…&lan=…`. */
+export function inviteAppUrl(invite) {
+    const fields = new URLSearchParams({ invite: invite.token, lan: invite.lan.replace(/\/$/, "") });
+    reach(fields, invite);
+    return `chips://join?${fields.toString()}`;
+}
+/**
+ * The invite in a link somebody pasted, scanned or opened: either shape, or the page's with the
+ * invite moved to the query by something that rewrote it. Nothing when it carries no invite, which
+ * is most of what a camera sees.
+ */
+export function inviteFromLink(text) {
+    // A link copied out of a message may come with the message: the word that holds the invite.
+    const trimmed = text.split(/\s+/).find((word) => word.includes("invite=")) ?? "";
+    const hashAt = trimmed.indexOf("#");
+    const head = hashAt === -1 ? trimmed : trimmed.slice(0, hashAt);
+    const queryAt = head.indexOf("?");
+    const fragment = new URLSearchParams(hashAt === -1 ? "" : trimmed.slice(hashAt + 1));
+    const query = new URLSearchParams(queryAt === -1 ? "" : head.slice(queryAt + 1));
+    const field = (name) => {
+        const found = query.get(name) ?? fragment.get(name);
+        return found === null || found.trim() === "" ? undefined : found.trim();
+    };
+    const token = field("invite");
+    if (token === undefined)
+        return undefined;
+    const origin = /^https?:\/\/[^/?#]+/.exec(head)?.[0];
+    const app = /^chips:/i.test(head);
+    const lan = field("lan") ?? (app ? undefined : origin);
+    const relay = field("relay");
+    const key = field("key");
+    return {
+        token,
+        ...(lan === undefined ? {} : { lan: lan.replace(/\/$/, "") }),
+        ...(key === undefined ? {} : { key }),
+        ...(relay === undefined || key === undefined ? {} : { relay }),
+    };
+}
+//# sourceMappingURL=invite-link.js.map

package/dist/src/invite-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invite-link.js","sourceRoot":"","sources":["../../src/invite-link.ts"],"names":[],"mappings":"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"}

package/dist/src/join.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Join requests (ADR 0122): something asks to join Chips, and a person allows it. A harness asks
+ * for a key and the room it starts in; a device asks to be paired. No token is copied by hand.
+ *
+ * Two ways in, one request:
+ *
+ * - **The requester starts.** It sends `POST /v1/join` with no credential and is answered with a
+ *   secret, which only it holds, and a short code, which it shows. An owner or admin compares the
+ *   code, says which of what it asks for it may have, and allows it or not. The requester polls
+ *   `POST /v1/join/:id/redeem` with the secret and is handed its credential once.
+ * - **A person starts.** An owner or admin makes a link, choosing first what the harness may do.
+ *   The link is `<address>/j/<secret>`, good once, for fifteen minutes; whoever holds it redeems
+ *   it at `POST /v1/join/redeem`, already allowed.
+ *
+ * The code is for comparing, not a secret: the 128-bit secret is the credential. Every rule a
+ * client draws from — how long each lasts, how many may wait — is named here once, so the server,
+ * the apps and the SDK cannot disagree.
+ */
+import { z } from "zod";
+/** How long a request a requester started waits for a person: ten minutes. */
+export declare const JOIN_CODE_SECONDS = 600;
+/** How long a link a person made waits for its harness: fifteen minutes. */
+export declare const JOIN_LINK_SECONDS = 900;
+/** Requests waiting for a person at once, on one server. The sixth is refused. */
+export declare const JOIN_WAITING_MAX = 5;
+/** Requests one address may start in a minute. */
+export declare const JOIN_ASKS_PER_MINUTE = 10;
+/**
+ * How often a requester asks whether it was allowed, in seconds: twenty a minute, under the thirty
+ * a relay lets through a tunnel without a credential.
+ */
+export declare const JOIN_POLL_SECONDS = 3;
+export declare const joinKind: z.ZodEnum<{
+    harness: "harness";
+    device: "device";
+    invite: "invite";
+    pairing: "pairing";
+}>;
+export type JoinKind = z.infer<typeof joinKind>;
+/** The kinds a link makes, which wait for the one person who handed it out (ADR 0232). */
+export declare const LINK_KINDS: readonly JoinKind[];
+/** Whether a request is a link's, asked of one person: an invite's, or a pairing code's. */
+export declare function isLinkKind(kind: JoinKind): boolean;
+/**
+ * The code a link's request shows (ADR 0232): six digits made from the joining device's key, the
+ * same on the device and on the Allow sheet, for a person to compare.
+ */
+export declare const keyCode: z.ZodString;
+/** Six digits as people read them: two groups of three. */
+export declare function keyCodeShown(code: string): string;
+export declare const joinState: z.ZodEnum<{
+    waiting: "waiting";
+    allowed: "allowed";
+    denied: "denied";
+    expired: "expired";
+    redeemed: "redeemed";
+}>;
+export type JoinState = z.infer<typeof joinState>;
+export declare const joinStartedBy: z.ZodEnum<{
+    person: "person";
+    requester: "requester";
+}>;
+export type JoinStartedBy = z.infer<typeof joinStartedBy>;
+/** What a person may grant a harness: every capability a harness may take (ADR 0046). */
+export declare const GRANTABLE: readonly string[];
+/** A request as an owner's or admin's client sees it: never the secret. */
+export declare const joinRequestView: z.ZodObject<{
+    request_id: z.ZodString;
+    kind: z.ZodEnum<{
+        harness: "harness";
+        device: "device";
+        invite: "invite";
+        pairing: "pairing";
+    }>;
+    state: z.ZodEnum<{
+        waiting: "waiting";
+        allowed: "allowed";
+        denied: "denied";
+        expired: "expired";
+        redeemed: "redeemed";
+    }>;
+    started_by: z.ZodEnum<{
+        person: "person";
+        requester: "requester";
+    }>;
+    code: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
+    name: z.ZodOptional<z.ZodString>;
+    software: z.ZodOptional<z.ZodString>;
+    machine: z.ZodOptional<z.ZodString>;
+    from_addr: z.ZodOptional<z.ZodString>;
+    wants: z.ZodArray<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodString>;
+    url: z.ZodURL;
+    decided_by: z.ZodOptional<z.ZodString>;
+    decided_at: z.ZodOptional<z.ZodISODateTime>;
+    created_at: z.ZodISODateTime;
+    expires_at: z.ZodISODateTime;
+    harness_id: z.ZodOptional<z.ZodString>;
+    space_id: z.ZodOptional<z.ZodString>;
+    device_id: z.ZodOptional<z.ZodString>;
+    pair_as: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        owner: "owner";
+        member: "member";
+        guest: "guest";
+        admin: "admin";
+    }>>;
+}, z.core.$strip>;
+export type JoinRequestView = z.infer<typeof joinRequestView>;
+/** `POST /v1/join`: what a requester sends. */
+export declare const joinAsk: z.ZodObject<{
+    kind: z.ZodDefault<z.ZodEnum<{
+        harness: "harness";
+        device: "device";
+        invite: "invite";
+        pairing: "pairing";
+    }>>;
+    name: z.ZodString;
+    software: z.ZodOptional<z.ZodString>;
+    machine: z.ZodOptional<z.ZodString>;
+    wants: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    public_key: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JoinAsk = z.input<typeof joinAsk>;
+/** The answer to `POST /v1/join`. */
+export declare const joinAsked: z.ZodObject<{
+    request_id: z.ZodString;
+    secret: z.ZodString;
+    code: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+    expires_in: z.ZodInt;
+    interval: z.ZodInt;
+}, z.core.$strip>;
+export type JoinAsked = z.infer<typeof joinAsked>;
+/**
+ * What `POST /v1/invites/redeem` and `POST /v1/pair` answer, `202`, for a link that asks (ADR
+ * 0232): a request that waits for the person who handed the link out, polled as a device's is.
+ */
+export declare const linkWaiting: z.ZodObject<{
+    request_id: z.ZodString;
+    secret: z.ZodString;
+    expires_in: z.ZodInt;
+    interval: z.ZodInt;
+    state: z.ZodLiteral<"waiting">;
+    code: z.ZodString;
+}, z.core.$strip>;
+export type LinkWaiting = z.infer<typeof linkWaiting>;
+/** What a harness is handed once, when its request is redeemed. */
+export declare const joinedHarness: z.ZodObject<{
+    kind: z.ZodLiteral<"harness">;
+    url: z.ZodURL;
+    harness_id: z.ZodString;
+    token: z.ZodString;
+    space_id: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type JoinedHarness = z.infer<typeof joinedHarness>;
+/** What a device is handed once, when its request is redeemed. */
+export declare const joinedDevice: z.ZodObject<{
+    kind: z.ZodLiteral<"device">;
+    url: z.ZodURL;
+    device_id: z.ZodString;
+    participant_id: z.ZodString;
+    workspace_id: z.ZodString;
+    display_name: z.ZodString;
+    workspace_name: z.ZodOptional<z.ZodString>;
+    server_key: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        owner: "owner";
+        member: "member";
+        guest: "guest";
+        admin: "admin";
+    }>>;
+    space_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type JoinedDevice = z.infer<typeof joinedDevice>;
+/** A poll's answer while the request still waits for a person: ask again in `interval`. */
+export declare const joinPending: z.ZodObject<{
+    state: z.ZodLiteral<"waiting">;
+    interval: z.ZodInt;
+}, z.core.$strip>;
+/** A link a person hands a harness: the server's address, then `/j/`, then the secret. */
+export declare function joinLink(base: string, secret: string): string;
+/** A link taken apart: where Chips is, and the secret. Nothing when it is not a join link. */
+export declare function parseJoinLink(link: string): {
+    url: string;
+    secret: string;
+} | undefined;
+//# sourceMappingURL=join.d.ts.map

package/dist/src/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../src/join.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,eAAO,MAAM,QAAQ;;;;;EAIlB,CAAC;AACJ,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,0FAA0F;AAC1F,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAA0B,CAAC;AAErE,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,aAA+C,CAAC;AAEpE,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAKD,eAAO,MAAM,SAAS;;;;;;EAInB,CAAC;AACJ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,aAAa;;;EAIvB,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,yFAAyF;AACzF,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAAwC,CAAC;AAShF,2EAA2E;AAC3E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0C2C,CAAC;AACxE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,+CAA+C;AAC/C,eAAO,MAAM,OAAO;;;;;;;;;;;;iBAaa,CAAC;AAClC,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,qCAAqC;AACrC,eAAO,MAAM,SAAS;;;;;;iBAMpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;iBAE6D,CAAC;AACtF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,mEAAmE;AACnE,eAAO,MAAM,aAAa;;;;;;;iBAOxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,kEAAkE;AAClE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;iBAkBvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,2FAA2F;AAC3F,eAAO,MAAM,WAAW;;;iBAGtB,CAAC;AAKH,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAYvF"}