@yadsh/dsh-qa-surface 0.18.0 → 0.20.0

package/lib/types/client/forms-styles.d.ts

@@ -1,2 +1,2 @@
-export declare const QA_FORM_STYLES = "\n.dsh-qa-form{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:16px;max-height:75vh;overflow:hidden;overflow-wrap:anywhere;color:var(--dsw-alias-label-primary);display:flex;flex-direction:column}\n.dsh-qa-form__content{overflow:auto;min-height:0;padding:0 2px}.dsh-qa-form>header,.dsh-qa-form>footer,.dsh-qa-form>nav,.dsh-qa-form>p{flex-shrink:0}.dsh-qa-form>footer{border-top:1px solid var(--dsw-alias-border-l2);padding-top:12px;margin-top:8px}\n.dsh-qa-form>header{max-height:96px;overflow:auto}\n.dsh-qa-form header,.dsh-qa-form footer,.dsh-qa-form nav{display:flex;gap:8px;align-items:center;flex-wrap:wrap}\n.dsh-qa-form header{justify-content:space-between}.dsh-qa-form nav{margin:12px 0}.dsh-qa-form h3{margin:12px 0}\n.dsh-qa-form button{font:inherit;color:inherit;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px 12px;cursor:pointer}\n.dsh-qa-form button:disabled{opacity:.55;cursor:default}.dsh-qa-form button:focus-visible,.dsh-qa-form input:focus-visible,.dsh-qa-form textarea:focus-visible{outline:var(--dsw-focus-ring-width,2px) solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px}\n.dsh-qa-form__item{min-width:0;border:0;border-bottom:1px solid var(--dsw-alias-border-l2);padding:12px 0;margin:0 0 12px}.dsh-qa-form legend{font-weight:600}.dsh-qa-form small{font-weight:400;display:block;color:var(--dsw-alias-label-tertiary)}\n.dsh-qa-form__hint{font-size:13px;color:var(--dsw-alias-label-secondary)}.dsh-qa-form label{display:block}.dsh-qa-form input[type=text],.dsh-qa-form textarea{display:block;box-sizing:border-box;width:100%;font:inherit;color:inherit;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:10px;margin:6px 0}\n.dsh-qa-form__choices>label{display:flex;gap:8px;align-items:baseline;margin:8px 0}.dsh-qa-form__files{border:1px dashed var(--dsw-alias-border-l2);border-radius:8px;padding:12px;margin-top:12px}.dsh-qa-form input[type=file]{max-width:100%;display:block;margin:8px 0}.dsh-qa-form__files ul{padding-left:18px}.dsh-qa-form__files li{margin:10px 0}.dsh-qa-form__files button{margin:4px}.dsh-qa-form__review>div{border-bottom:1px solid var(--dsw-alias-border-l2);margin-bottom:12px}.dsh-qa-form [role=alert]{color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);padding:10px;border-radius:8px}\n@media(max-width:600px){.dsh-qa-form{padding:12px;max-height:80vh}.dsh-qa-form footer button{flex:1 1 auto}.dsh-qa-form nav button{font-size:12px}}\n";
+export declare const QA_FORM_STYLES = "\n.dsh-qa-form{box-sizing:border-box;min-width:0;max-height:min(720px,calc(100dvh - 160px));overflow:hidden;overflow-wrap:anywhere;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);border-radius:16px;display:flex;flex-direction:column;font:inherit;font-size:14px;line-height:20px}\n.dsh-qa-form *{box-sizing:border-box}.dsh-qa-form p,.dsh-qa-form h3,.dsh-qa-form h4{margin:0}\n.dsh-qa-form .title-3{font-size:16px;line-height:24px;font-weight:600}.dsh-qa-form .title-4{font-size:14px;line-height:20px;font-weight:600}.dsh-qa-form .caption-5{font-size:12px;line-height:16px;font-weight:400}\n.dsh-qa-form>header{padding:16px 24px;display:flex;align-items:flex-start;justify-content:space-between;gap:16px;flex-shrink:0}.dsh-qa-form__heading{min-width:0;display:grid;gap:4px}.dsh-qa-form__heading strong{display:block;text-wrap:pretty}\n.dsh-qa-form__description{color:var(--dsw-alias-label-secondary);text-wrap:pretty}.dsh-qa-form__hint{font-size:12px;line-height:16px;color:var(--dsw-alias-label-secondary)}\n.dsh-qa-form__badge{display:inline-flex;flex-shrink:0;align-items:center;border-radius:999px;background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);padding:4px 8px;white-space:nowrap}\n.dsh-qa-form__status{display:flex;flex-wrap:wrap;gap:4px 16px;padding:0 24px 12px;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:16px;flex-shrink:0}\n.dsh-qa-form>nav{display:flex;gap:8px;overflow:auto;flex-shrink:0;padding:0 24px 16px;scrollbar-width:thin}.dsh-qa-form>nav button{display:flex;align-items:center;gap:8px;white-space:nowrap;font-weight:500;background:transparent}\n.dsh-qa-form__step-number{width:24px;height:24px;border-radius:999px;display:inline-grid;place-items:center;background:var(--dsw-alias-bg-module-platform);font-size:12px;line-height:16px;flex-shrink:0}\n.dsh-qa-form>nav button[aria-current=step]{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 12%,transparent);border-color:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-label-primary)}\n.dsh-qa-form>nav button[aria-current=step] .dsh-qa-form__step-number{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 24%,transparent)}\n.dsh-qa-form__content{overflow:auto;min-height:0;padding:0 24px 16px;overscroll-behavior:contain;scrollbar-gutter:stable}.dsh-qa-form__step{display:grid;gap:16px}.dsh-qa-form__step-heading{display:grid;gap:4px}\n.dsh-qa-form__item{min-width:0;margin:0;padding:16px;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-3)}\n.dsh-qa-form__item-title{max-width:100%;padding:0 4px;display:flex;align-items:center;gap:8px;flex-wrap:wrap;color:var(--dsw-alias-label-primary)}\n.dsh-qa-form__item>.dsh-qa-form__description,.dsh-qa-form__item>.dsh-qa-form__hint{margin-bottom:8px}.dsh-qa-form__answer{display:block}\n.dsh-qa-form input[type=text],.dsh-qa-form textarea{display:block;min-width:0;width:100%;font:inherit;color:inherit;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px 12px;min-height:40px}.dsh-qa-form textarea{resize:vertical;min-height:96px}\n.dsh-qa-form__choices{display:grid;gap:8px}.dsh-qa-form__choice{display:grid;grid-template-columns:16px minmax(0,1fr);align-items:start;gap:12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:12px;background:var(--dsw-alias-bg-layer-2);cursor:pointer}\n.dsh-qa-form__choice:hover{border-color:var(--dsw-alias-label-dimmed)}.dsh-qa-form__choice.is-selected{border-color:var(--dsw-alias-state-business-primary);background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 8%,var(--dsw-alias-bg-layer-2))}\n.dsh-qa-form__choice input{width:16px;height:16px;margin:2px 0 0;accent-color:var(--dsw-alias-state-business-primary)}.dsh-qa-form__choice-copy{display:grid;gap:4px;min-width:0}.dsh-qa-form__choice-copy>.title-4{display:flex;align-items:center;gap:8px;flex-wrap:wrap}\n.dsh-qa-form__recommended{color:var(--dsw-alias-state-business-primary);font-weight:500}.dsh-qa-form__other{display:grid;gap:8px;padding-top:4px}\n.dsh-qa-form button,.dsh-qa-form__picker{appearance:none;font:inherit;font-weight:500;line-height:20px;color:inherit;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px 12px;min-height:40px;cursor:pointer;text-align:center;display:inline-flex;align-items:center;justify-content:center;gap:8px}\n.dsh-qa-form button:hover,.dsh-qa-form__picker:hover{border-color:var(--dsw-alias-label-dimmed)}.dsh-qa-form button:disabled,.dsh-qa-form .is-disabled{opacity:.5;cursor:default}\n.dsh-qa-form button:focus-visible,.dsh-qa-form input:focus-visible,.dsh-qa-form textarea:focus-visible,.dsh-qa-form__picker:focus-within{outline:var(--dsw-focus-ring-width,2px) solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px}\n.dsh-qa-form .dsh-qa-form__primary,.dsh-qa-form__dropzone>.dsh-qa-form__picker{font-weight:600;border-color:var(--dsw-alias-state-business-primary);background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 16%,var(--dsw-alias-bg-layer-2))}\n.dsh-qa-form .dsh-qa-form__text-button{background:transparent;justify-self:start}.dsh-qa-form__files{display:grid;gap:8px;margin-top:12px;padding:16px;border:1px dashed var(--dsw-alias-label-dimmed);border-radius:8px;background:var(--dsw-alias-bg-layer-2)}\n.dsh-qa-form__file-heading{display:flex;align-items:center;justify-content:space-between;gap:8px}.dsh-qa-form__dropzone{display:flex;align-items:center;gap:12px;flex-wrap:wrap;padding-top:4px}.dsh-qa-form__picker{position:relative;max-width:100%}\n.dsh-qa-form__picker input[type=file]{position:absolute;width:1px;height:1px;opacity:0;overflow:hidden;clip-path:inset(50%)}\n.dsh-qa-form__file-list{display:grid;gap:8px;padding:0;margin:4px 0 0;list-style:none}.dsh-qa-form__file-row,.dsh-qa-form__upload{display:flex;align-items:center;gap:12px;flex-wrap:wrap;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:12px;background:var(--dsw-alias-bg-layer-3)}\n.dsh-qa-form__file-copy{display:grid;gap:4px;min-width:0;flex:1 1 160px}.dsh-qa-form__file-actions{display:flex;gap:8px;flex-wrap:wrap}.dsh-qa-form__file-actions button,.dsh-qa-form__picker--small{font-size:12px;line-height:16px;min-height:32px;padding:4px 8px}\n.dsh-qa-form__field-errors{display:grid;gap:4px;margin-top:8px;color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:16px}.dsh-qa-form [aria-invalid=true]{border-color:var(--dsw-alias-state-error-primary)}\n.dsh-qa-form [role=alert]{display:grid;gap:8px;color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-state-error-primary);padding:12px;border-radius:8px;margin-bottom:16px}\n.dsh-qa-form>footer{display:grid;gap:8px;padding:12px 24px 16px;flex-shrink:0;background:var(--dsw-alias-bg-layer-2)}.dsh-qa-form__actions{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}.dsh-qa-form__navigation,.dsh-qa-form__secondary{display:flex;gap:8px;flex-wrap:wrap}\n.dsh-qa-form__review{display:grid;gap:16px}.dsh-qa-form__review-step{display:grid;gap:12px}.dsh-qa-form__review-item{display:grid;gap:8px;padding:16px;border:1px solid var(--dsw-alias-border-l2);border-radius:12px;background:var(--dsw-alias-bg-layer-3);white-space:pre-wrap}\n.dsh-qa-form--summary{padding:16px 24px;flex-direction:row;align-items:center;justify-content:space-between;gap:16px}.dsh-qa-form--summary>div:first-child{display:grid;gap:4px;min-width:0}\n@media(max-width:600px){.dsh-qa-form{max-height:calc(100dvh - 160px);border-radius:12px}.dsh-qa-form>header{padding:12px 16px;gap:8px}.dsh-qa-form__status{padding:0 16px 12px}.dsh-qa-form>nav{padding:0 16px 12px}.dsh-qa-form__content{padding:0 16px 12px}.dsh-qa-form__item,.dsh-qa-form__files{padding:12px}.dsh-qa-form>footer{padding:12px 16px}.dsh-qa-form__actions{flex-direction:column;align-items:stretch}.dsh-qa-form__navigation{display:grid;grid-template-columns:1fr 1fr}.dsh-qa-form__secondary{justify-content:space-between}.dsh-qa-form__secondary button{font-size:12px;line-height:16px;min-height:32px;padding:4px 8px}.dsh-qa-form--summary{padding:12px 16px;align-items:flex-start}.dsh-qa-form__file-row{align-items:flex-start}}\n";
 //# sourceMappingURL=forms-styles.d.ts.map

package/lib/types/client/history-organization-styles.d.ts

@@ -0,0 +1,3 @@
+/** Virtual history controls inherit the same palette as the existing sidebar. */
+export declare const historyOrganizationStyles: string;
+//# sourceMappingURL=history-organization-styles.d.ts.map

package/lib/types/client/history-organization.d.ts

@@ -0,0 +1,38 @@
+import type { QaHistoryFolderTarget } from "../types/accounts.js";
+/** Browser-only presentation metadata. No entry is a filesystem path. */
+export interface QaHistoryFolder {
+    readonly id: string;
+    readonly name: string;
+    readonly collapsed: boolean;
+}
+export interface QaHistoryOrganization {
+    readonly folders: readonly QaHistoryFolder[];
+    readonly assignments: Readonly<Record<string, string>>;
+    readonly pinned: readonly string[];
+    readonly order: readonly string[];
+    /** Routing was imported, or the reader explicitly chose a folder/root. */
+    readonly folderHandled?: readonly string[];
+}
+export declare const EMPTY_HISTORY: QaHistoryOrganization;
+/** Treat storage as untrusted and tolerate older, partial or damaged values. */
+export declare function parseHistoryOrganization(raw: string | null): QaHistoryOrganization;
+export declare function historyFolderOf(state: QaHistoryOrganization, id: string): string | null;
+/** A removed folder releases its chats, including pinned chats, to the root. */
+export declare function removeHistoryFolder(state: QaHistoryOrganization, folderId: string): QaHistoryOrganization;
+/** Insert relative to the visible target without losing filtered or unloaded ids. */
+export declare function insertHistoryId(ids: readonly string[], id: string, before?: string): string[];
+export type QaHistoryDestination = {
+    readonly kind: "pinned";
+} | {
+    readonly kind: "folder";
+    readonly id: string | null;
+};
+/** Moving a pinned chat into a folder unpins it; pinning retains its folder. */
+export declare function moveHistoryChat(state: QaHistoryOrganization, id: string, destination: QaHistoryDestination, visibleOrder: readonly string[], before?: string): QaHistoryOrganization;
+/** Apply server defaults once; subsequent manual moves and deletions win. */
+export declare function importIntegrationFolders(state: QaHistoryOrganization, hints: Readonly<Record<string, QaHistoryFolderTarget>>, visibleIds: ReadonlySet<string>): QaHistoryOrganization;
+/** Unordered rows keep recency order until the reader arranges them. */
+export declare function orderHistoryRows<T extends {
+    readonly id: string;
+}>(rows: readonly T[], order: readonly string[]): T[];
+//# sourceMappingURL=history-organization.d.ts.map

package/lib/types/client/project-session-state.d.ts

@@ -40,10 +40,8 @@ export interface QaBoundProjectionInput {
     readonly questions: readonly QaPendingQuestion[];
     readonly operationError: string | null;
     /**
-     * A send the stand had no room for. The dialog is the whole of what the
-     * visitor learns: the question never reached the Host, so the transcript has
-     * no row to carry the refusal on. Distinct from `queue`, the waiting rows of
-     * this chat.
+     * Server admission status for this waiting chat, or a legacy Host's
+     * pre-send refusal. Distinct from `queue`, the next messages of this chat.
      */
     readonly requestQueue: QaQueueStatus | null;
     readonly policyReady: boolean;

package/lib/types/client/request-wait-styles.d.ts

@@ -0,0 +1,2 @@
+export declare const requestWaitStyles = "\n.dsh-qa-request-wait{display:flex;align-items:center;gap:8px;align-self:flex-start;width:fit-content;max-width:100%;box-sizing:border-box;margin:0 0 10px;padding:6px 12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-secondary);font-size:13px;line-height:1.45;overflow-wrap:anywhere}\n.dsh-qa-request-wait__spinner{width:12px;height:12px;flex:none;border:1.5px solid var(--dsw-alias-border-l2);border-top-color:var(--dsw-alias-label-secondary);border-radius:50%;animation:dsh-qa-request-spin 1s linear infinite}\n@keyframes dsh-qa-request-spin{to{transform:rotate(360deg)}}\n@media(prefers-reduced-motion:reduce){.dsh-qa-request-wait__spinner{animation:none}}\n";
+//# sourceMappingURL=request-wait-styles.d.ts.map

package/lib/types/client/types.d.ts

@@ -1,7 +1,7 @@
 import type { ClientRemote } from "@deepseek-ai/dsh-api-gateway/client";
 import type { ISessions, SessionFace } from "@deepseek-ai/dsh-api-session-controller/client";
 import type { UiConversation } from "@deepseek-ai/dsh-client-ui-conversation/client";
-import type { QaAccountNotificationsInput, QaAccountProfileInput, QaAccountSession, QaAccountStartersInput, QaAccountStarter, QaAccountUserPublic, QaAccessAdminSnapshot, QaApprovalDecision, QaClaimResult, QaLockdownProof, QaModelCatalogEntry, QaOwnershipEntry, QaPasswordResetRequest, QaPendingApproval, QaPendingQuestion, QaQuestionAnswerItem, QaQueueStatus, QaIssuedServiceToken, QaServiceTokenCreateInput, QaServiceTokenSummary, QaSessionState, QaSkillDocument, QaSkillDraftInput, QaSkillRemoval, QaSkillSummary, QaSkillToolDescriptor, QaSkillValidation, QaSourceFilePreview, QaTurnSources, QaWhoamiResult, QaDocumentPreview, QaSpreadsheetPreviewSelection, QaWorkspaceFile, QaWorkspaceFileChunk, QaDocumentWorkflowStatus, QaWorkspaceListing, QaCapabilitySelection, QaCurrentAccess, QaSessionAccess, QaSkillActivationRecord, QaSkillAssignmentOverride, QaSubrole, QaUserAccess, QaAdminAuditEvent, QaAdminOverview, QaAdminPage, QaAdminSkillScope, QaAdminSkillsView, QaAdminUserDetail, QaAdminUserRow, QaAdminUserUpdate, QaAuditQuery, QaConversationDetail, QaConversationDeletion, QaConversationQuery, QaConversationReview, QaConversationReviewInput, QaConversationSummary, QaExpertMemoryDraft, QaExpertMemoryPage, QaExpertMemoryRecord, QaExpertMemoryScope, QaFeedbackQuery, QaFeedbackRow, QaMessageFeedback, QaMessageFeedbackInput, QaQualityMetrics, QaReviewQueueItem, QaReviewQueueRow, QaSlashCatalog, QaSlashExecution, QaSlashSubmitAttachment, QaUserQuery } from "../types.js";
+import type { QaAccountNotificationsInput, QaAccountProfileInput, QaAccountSession, QaAccountStartersInput, QaAccountStarter, QaAccountUserPublic, QaAccessAdminSnapshot, QaApprovalDecision, QaClaimResult, QaLockdownProof, QaModelCatalogEntry, QaModelOptions, QaOwnershipEntry, QaPasswordResetRequest, QaPendingApproval, QaPendingQuestion, QaQuestionAnswerItem, QaQueueStatus, QaIssuedServiceToken, QaServiceTokenCreateInput, QaServiceTokenSummary, QaSessionState, QaSkillDocument, QaSkillDraftInput, QaSkillRemoval, QaSkillSummary, QaSkillToolDescriptor, QaSkillValidation, QaSourceFilePreview, QaTurnSources, QaWhoamiResult, QaDocumentPreview, QaSpreadsheetPreviewSelection, QaWorkspaceFile, QaWorkspaceFileChunk, QaDocumentWorkflowStatus, QaWorkspaceListing, QaCapabilitySelection, QaCurrentAccess, QaSessionAccess, QaSkillActivationRecord, QaSkillAssignmentOverride, QaSubrole, QaUserAccess, QaAdminAuditEvent, QaAdminOverview, QaAdminPage, QaAdminSkillScope, QaAdminSkillsView, QaAdminUserDetail, QaAdminUserRow, QaAdminUserUpdate, QaAuditQuery, QaConversationDetail, QaConversationDeletion, QaConversationQuery, QaConversationReview, QaConversationReviewInput, QaConversationSummary, QaExpertMemoryDraft, QaExpertMemoryPage, QaExpertMemoryRecord, QaExpertMemoryScope, QaFeedbackQuery, QaFeedbackRow, QaMessageFeedback, QaMessageFeedbackInput, QaQualityMetrics, QaReviewQueueItem, QaReviewQueueRow, QaSlashCatalog, QaSlashExecution, QaSlashSubmitAttachment, QaUserQuery } from "../types.js";
 /** Wire content one prompt carries: text plus base64 image uploads. */
 export type QaPromptContent = Parameters<SessionFace["prompt"]>[0];
 /** DSH session runtime surface the QA controller is allowed to touch. */
@@ -37,12 +37,13 @@ export type QaCreateSession = (token: string, subroleId: string | null, adminPre
 export type QaForkSession = (token: string, sourceId: string, answerSeq: number) => Promise<RemoteResult<string>>;
 /**
  * The Host's live read of the request ceiling (`qaSurface/queueStatus`), asked
- * per send: how many questions the stand is answering and whether one more
- * fits.
+ * per send and for the current waiting chat. Supplying a session id requires
+ * current account read access; global reads expose counts only.
  */
-export type QaQueueStatusRemote = () => Promise<RemoteResult<QaQueueStatus>>;
+export type QaQueueStatusRemote = (token?: string, sessionId?: string) => Promise<RemoteResult<QaQueueStatus>>;
 /** Role selector plus administrator mutation channel. */
 export interface QaAccessApi {
+    userModels?(token: string, sessionId: string | null, subroleId: string | null, adminPreview: boolean): Promise<RemoteResult<QaModelOptions>>;
     current(token: string): Promise<RemoteResult<QaCurrentAccess>>;
     session(token: string, sessionId: string): Promise<RemoteResult<QaSessionAccess>>;
     admin(token: string): Promise<RemoteResult<QaAccessAdminSnapshot>>;
@@ -337,6 +338,8 @@ export type QaIntegrationTokenResult<Value> = {
 };
 /** The integration-token section with the account token bound at the call site. */
 export interface QaIntegrationTokenApi {
+    readonly historyStorageKey?: string;
+    setFolder?(tokenId: string, folder: import("../types/accounts.js").QaHistoryFolderTarget | null): Promise<QaIntegrationTokenResult<null>>;
     /**
      * Whether this deployment can mint at all. A token is a credential for the
      * HTTP API, so when that API is off the page explains the state instead of
@@ -351,6 +354,9 @@ export interface QaIntegrationTokenApi {
 }
 /** Account remotes exposed by the plugin's own typert namespace. */
 export interface QaAccountsApi {
+    accountsSetServiceTokenHistoryFolder?(token: string, tokenId: string, folder: import("../types/accounts.js").QaHistoryFolderTarget | null): Promise<RemoteResult<{
+        readonly updated: boolean;
+    }>>;
     accountsSetServiceTokenClarifications?(token: string, tokenId: string, allowed: boolean): Promise<RemoteResult<{
         readonly updated: boolean;
     }>>;
@@ -362,9 +368,7 @@ export interface QaAccountsApi {
     accountsLogin(email: string, password: string): Promise<RemoteResult<QaAccountSession>>;
     accountsRegister(email: string, password: string): Promise<RemoteResult<QaAccountSession>>;
     accountsClaimSessions(token: string, sessionIds: readonly string[]): Promise<RemoteResult<QaClaimResult>>;
-    accountsOwnedSessions(token: string): Promise<RemoteResult<{
-        readonly ids: readonly string[];
-    }>>;
+    accountsOwnedSessions(token: string): Promise<RemoteResult<import("../types/accounts.js").QaOwnedSessionsResult>>;
     accountsListOwnership(token: string): Promise<RemoteResult<{
         readonly entries: readonly QaOwnershipEntry[];
     }>>;
@@ -412,6 +416,10 @@ export type RemoteResult<Value> = {
     readonly ok: false;
     readonly error: unknown;
 };
+export interface QaChatCodeSourceApi {
+    read(token: string, sessionId: string): Promise<RemoteResult<import("../types/code-sources.js").QaChatCodeSources>>;
+    select(token: string, sessionId: string, source: string | null): Promise<RemoteResult<import("../types/code-sources.js").QaChatCodeSources>>;
+}
 /** Minimal persistence contract; backed by `window.localStorage` in the app. */
 export interface StorageLike {
     getItem(key: string): string | null;

package/lib/types/client/use-chat-code-source.d.ts

@@ -0,0 +1,20 @@
+import type { CodeSourcesCatalog } from "@yadsh/dsh-plugin-kit/code-sources";
+import type { QaChatCodeSources } from "../types/code-sources.js";
+import type { QaChatCodeSourceApi } from "./types.js";
+export interface ChatCodeSourceOptions {
+    readonly api?: QaChatCodeSourceApi | undefined;
+    readonly token: string;
+    readonly sessionId: string | null;
+    readonly chatKey: number;
+    readonly catalog: CodeSourcesCatalog;
+}
+/** Server-backed per-chat state. Drafts do not create sessions until their first send. */
+export declare function useChatCodeSource(options: ChatCodeSourceOptions): {
+    value: QaChatCodeSources;
+    pending: boolean;
+    error: string | null;
+    select: (source: string | null) => Promise<boolean>;
+    prepareSession: (sessionId: string) => Promise<void>;
+    blocked: boolean;
+};
+//# sourceMappingURL=use-chat-code-source.d.ts.map

package/lib/types/client/use-history-organization.d.ts

@@ -0,0 +1,8 @@
+import { type QaHistoryOrganization } from "./history-organization.js";
+/** The catalog is keyed on mount, so changing accounts cannot reuse its state. */
+export declare function useHistoryOrganization(key: string): {
+    state: QaHistoryOrganization;
+    update: (next: QaHistoryOrganization) => void;
+    persistenceFailed: boolean;
+};
+//# sourceMappingURL=use-history-organization.d.ts.map

package/lib/types/client/use-model-selection.d.ts

@@ -0,0 +1,24 @@
+import type { QaModelOptions, QaModelPair } from "../types.js";
+import type { QaAccessApi } from "./types.js";
+export declare const qaModelKey: (pair: QaModelPair) => string;
+export interface QaModelSelectionProps {
+    readonly api: NonNullable<QaAccessApi["userModels"]>;
+    readonly token: string;
+    readonly sessionId: string | null;
+    readonly subroleId: string | null;
+    readonly preview: boolean;
+    readonly disabled: boolean;
+    readonly onSelect: (pair: QaModelPair) => Promise<string>;
+}
+/** The existing authenticated selection boundary shared by composer controls. */
+export declare function useQaModelSelection(props: QaModelSelectionProps | undefined): {
+    options: QaModelOptions | undefined;
+    busy: boolean;
+    error: string | undefined;
+    selectedKey: string;
+    select: (key: string) => Promise<boolean>;
+    selected: import("../types.js").QaModelCatalogEntry | undefined;
+    disabled: boolean;
+    reload: () => void;
+};
+//# sourceMappingURL=use-model-selection.d.ts.map

package/lib/types/client/use-qa-file-drop.d.ts

@@ -0,0 +1,12 @@
+import { type RefObject } from "react";
+interface FileDropTarget {
+    readonly element: RefObject<HTMLElement>;
+    readonly fallback?: boolean;
+    readonly canDrop: () => boolean;
+    readonly onFiles: (files: File[]) => void;
+    readonly onActive?: (active: boolean) => void;
+}
+/** Register a QA file receiver; ordinary text and chat drags remain untouched. */
+export declare function useQaFileDrop(target: FileDropTarget): void;
+export {};
+//# sourceMappingURL=use-qa-file-drop.d.ts.map

package/lib/types/code-source-selection.d.ts

@@ -0,0 +1,28 @@
+import { SqliteDatabase } from "@yadsh/dsh-plugin-kit/sqlite";
+import type { CodeSourcesCatalog } from "@yadsh/dsh-plugin-kit/code-sources";
+import type { QaChatCodeSources } from "./types/code-sources.js";
+export interface CodeSourceSession {
+    readonly header: {
+        readonly parentSession?: unknown;
+        readonly isSeeded?: boolean;
+        readonly origin?: unknown;
+    };
+}
+/** Durable chat preference and immutable snapshots for delegated/forked children. */
+export declare class QaCodeSourceSelection {
+    private readonly configured;
+    private readonly session;
+    private readonly busy;
+    readonly storage: SqliteDatabase;
+    constructor(filePath: string, configured: () => CodeSourcesCatalog, session: (id: string) => CodeSourceSession | undefined, busy: (id: string) => boolean);
+    private stored;
+    /** Resolve old/resumed children through their durable lineage when no snapshot exists. */
+    selected(id: string): string | null;
+    catalog(id?: string): CodeSourcesCatalog;
+    view(id: string, owner: boolean): QaChatCodeSources;
+    select(id: string, source: string | null): QaChatCodeSources;
+    inherit(id: string, parent: string, managedParent?: boolean): void;
+    private save;
+    close(): void;
+}
+//# sourceMappingURL=code-source-selection.d.ts.map

package/lib/types/code-sources.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-sources.js.map

package/lib/types/code-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-sources.js","sourceRoot":"","sources":["../../src/types/code-sources.ts"],"names":[],"mappings":""}

package/lib/types/config-resolvers/integration.d.ts

@@ -48,6 +48,12 @@ export declare function normalizeIntegrationBasePath(value: string): string;
  * @param accounts - the resolved accounts domain, for the cross-check.
  * @returns the frozen resolved slice.
  */
-export declare function resolveIntegration(input: QaIntegrationConfig | undefined, accounts: ResolvedQaSurfaceConfig["accounts"]): ResolvedIntegration;
+export declare function resolveIntegration(input: QaIntegrationConfig | undefined, accounts: ResolvedQaSurfaceConfig["accounts"], attachments?: {
+    readonly textFiles: boolean;
+    readonly pastedTextLines: number;
+    readonly maxFileBytes: number;
+    readonly maxPending: number;
+    readonly extensions: readonly string[];
+}): ResolvedIntegration;
 export {};
 //# sourceMappingURL=integration.d.ts.map

package/lib/types/filesystem-intent.d.ts

@@ -0,0 +1,12 @@
+/** The Host tool contract, normalized once for path and storage policy. */
+export type QaFilesystemIntent = {
+    readonly kind: "read";
+    readonly path: string;
+    readonly fileOnlyGrant: boolean;
+} | {
+    readonly kind: "write";
+    readonly path: string;
+    readonly bytes: number;
+};
+export declare function qaFilesystemIntent(name: string, args: Record<string, unknown> | undefined): QaFilesystemIntent | undefined;
+//# sourceMappingURL=filesystem-intent.d.ts.map

package/lib/types/forms/attachments.d.ts

@@ -27,7 +27,8 @@ export declare function validateFormFile(name: string, data: Buffer): string;
 export declare class QaFormAttachmentAdapter {
     private readonly service;
     private readonly host;
-    constructor(service: () => QaFormService, host: () => QaFormHostAttachments | undefined);
+    private readonly grantFile?;
+    constructor(service: () => QaFormService, host: () => QaFormHostAttachments | undefined, grantFile?: ((sessionId: string, file: string) => void) | undefined);
     available(): boolean;
     check(session: string, formId: string, uploadId: string): void;
     claim(session: string, uploadId: string): {
@@ -37,12 +38,14 @@ export declare class QaFormAttachmentAdapter {
     complete(session: string, formId: string, uploadId: string, raw: unknown, signal: AbortSignal, authorize: () => void): Promise<QaFormRecord>;
     fail(session: string, formId: string, uploadId: string): void;
     /** Exact saved bytes are re-projected through the Host on each successful resume. */
-    readable(submission: QaFormSubmission): Promise<QaFormSubmission & {
+    readable(submission: QaFormSubmission, sessionId?: string): Promise<QaFormSubmission & {
         resources: {
             resource_id: string;
             read_path: string;
         }[];
     }>;
+    /** Rebuild exact grants from this chat's persisted, verified submissions. */
+    restore(sessionId: string): Promise<void>;
 }
 export {};
 //# sourceMappingURL=attachments.d.ts.map

package/lib/types/forms/errors.d.ts

@@ -1,9 +1,10 @@
-import type { QaFormFieldError, QaFormResult } from "./types.js";
+import type { QaFormFieldError, QaFormResult, QaFormSchemaIssue } from "./types.js";
 export declare class QaFormError extends Error {
     readonly code: string;
     readonly revision?: number | undefined;
     readonly fields?: QaFormFieldError[] | undefined;
-    constructor(code: string, message: string, revision?: number | undefined, fields?: QaFormFieldError[] | undefined);
+    readonly schemaIssues?: QaFormSchemaIssue[] | undefined;
+    constructor(code: string, message: string, revision?: number | undefined, fields?: QaFormFieldError[] | undefined, schemaIssues?: QaFormSchemaIssue[] | undefined);
 }
 /** Deliberately redact unexpected storage/Host exceptions at the wire boundary. */
 export declare function formFailure(error: unknown): QaFormResult<never>;

package/lib/types/forms/gate.d.ts

@@ -1,12 +1,13 @@
 import type { Context } from "@deepseek-ai/cordis";
 import type { ToolExecution } from "@deepseek-ai/dsh-tools";
 import type { QaFormService } from "./service.js";
-import type { QaFormRecord, QaFormSubmission } from "./types.js";
-type Outcome = QaFormSubmission | {
+import type { QaFormRecord, QaFormSubmission, QaFormValidation } from "./types.js";
+type CollectionOutcome = QaFormSubmission | {
     status: "paused";
     form_id: string;
     reason: string;
 };
+type Outcome = CollectionOutcome | QaFormValidation;
 /** A parked tool call is transient. Never reconstruct one from a saved draft. */
 export declare class QaFormGate {
     readonly service: () => QaFormService;
@@ -22,6 +23,7 @@ export declare class QaFormGate {
     install(ctx: Context): void;
     waiting(id: string): boolean;
     touch(session: string): void;
+    private clientReady;
     hasSession(session: string): boolean;
     request(raw: unknown, exec: ToolExecution): Promise<Outcome>;
     notify(record: QaFormRecord, pause?: boolean): void;

package/lib/types/forms/schema-errors.d.ts

@@ -0,0 +1,7 @@
+import type { z } from "zod";
+import { QaFormError } from "./errors.js";
+import type { QaFormSchemaIssue } from "./types.js";
+/** Report locations and constraints, never copy input values into diagnostics. */
+export declare function formSchemaError(issues: QaFormSchemaIssue[]): QaFormError;
+export declare function formSchemaIssues(issues: z.ZodError["issues"]): QaFormSchemaIssue[];
+//# sourceMappingURL=schema-errors.d.ts.map

package/lib/types/forms/types.d.ts

@@ -106,6 +106,19 @@ export interface QaFormFieldError {
     code: string;
     message: string;
 }
+export interface QaFormSchemaIssue {
+    path: string;
+    code: string;
+    message: string;
+}
+export interface QaFormValidation {
+    status: "validated";
+    valid: boolean;
+    interactive_client_ready: boolean;
+    file_upload_available: boolean;
+    policy: Readonly<QaFormPolicy>;
+    issues: QaFormSchemaIssue[];
+}
 export interface QaFormSubmission {
     status: "submitted";
     form_id: string;
@@ -182,6 +195,7 @@ export type QaFormResult<T> = {
         message: string;
         form_revision?: number;
         field_errors?: QaFormFieldError[];
+        schema_errors?: QaFormSchemaIssue[];
     };
 };
 /**

package/lib/types/index.d.ts

@@ -1,12 +1,14 @@
+import type { QaChatCodeSources } from "./types/code-sources.js";
 import type { QaChatAccess, QaChatGrant, QaChatMode, QaChatAuthor, QaChatJson } from "./chat-sharing/types.js";
 import type { SessionPageRequest, SessionFollowRequest, SessionPromptRequest, SessionPromptValue, SessionAttachmentRequest, SessionAttachmentValue, SessionRenameRequest, SessionRenameValue, SessionCancelValue, SessionUpdateQueueRequest, SessionUpdateQueueValue, SessionSearchRequest, SessionSelectModelRequest, SessionSelectModelValue } from "@deepseek-ai/dsh-api-session-controller/types";
 import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 import type { Context } from "@deepseek-ai/cordis";
 import type { QaSurfaceConfigRefs } from "./config.js";
 import type { QaFormCommand, QaFormResult, QaFormView } from "./forms/types.js";
+import type { QaModelOptions } from "./types.js";
 import type { QaAccountNotificationsInput } from "./types.js";
 import type { QaTurnSources } from "./provenance/types.js";
-import type { QaAccountProfileInput, QaAccountSession, QaAccountStartersInput, QaAccountUserPublic, QaApprovalDecision, QaClaimResult, QaDocumentPreview, QaSpreadsheetPreviewSelection, QaDocumentWorkflowStatus, QaIssuedServiceToken, QaLockdownProof, QaOwnershipEntry, QaPasswordResetRequest, QaPendingApproval, QaPendingQuestion, QaQuestionAnswerItem, QaQueueStatus, QaServiceTokenCreateInput, QaServiceTokenSummary, ResolvedQaSurfaceConfig, QaAdminSkillScope, QaAdminSkillsView, QaExpertMemoryDraft, QaExpertMemoryPage, QaExpertMemoryRecord, QaExpertMemoryScope, QaSkillDocument, QaSkillDraftInput, QaSkillRemoval, QaSkillSummary, QaSkillToolDescriptor, QaSkillValidation, QaSourceFilePreview, QaWhoamiResult, QaWorkspaceFile, QaWorkspaceFileChunk, QaWorkspaceListing, QaPrincipal, QaAccessAdminSnapshot, QaAdminAuditEvent, QaAdminOverview, QaAdminPage, QaAdminUserDetail, QaAdminUserRow, QaAdminUserUpdate, QaAuditQuery, QaCapabilitySelection, QaConversationDetail, QaConversationDeletion, QaConversationQuery, QaConversationReview, QaConversationReviewInput, QaConversationSummary, QaCurrentAccess, QaFeedbackHarvestEntry, QaFeedbackHarvestResult, QaFeedbackQuery, QaFeedbackRow, QaMessageFeedback, QaMessageFeedbackInput, QaModelCatalogEntry, QaModelPair, QaQualityMetrics, QaReviewQueueItem, QaReviewQueueRow, QaSessionAccess, QaSlashCatalog, QaSlashExecution, QaSlashSubmitAttachment, QaSkillActivationRecord, QaSkillAssignmentOverride, QaSubrole, QaUserAccess, QaUserQuery } from "./types.js";
+import type { QaAccountProfileInput, QaAccountSession, QaAccountStartersInput, QaAccountUserPublic, QaApprovalDecision, QaClaimResult, QaDocumentPreview, QaSpreadsheetPreviewSelection, QaDocumentWorkflowStatus, QaIssuedServiceToken, QaHistoryFolderTarget, QaOwnedSessionsResult, QaLockdownProof, QaOwnershipEntry, QaPasswordResetRequest, QaPendingApproval, QaPendingQuestion, QaQuestionAnswerItem, QaQueueStatus, QaServiceTokenCreateInput, QaServiceTokenSummary, ResolvedQaSurfaceConfig, QaAdminSkillScope, QaAdminSkillsView, QaExpertMemoryDraft, QaExpertMemoryPage, QaExpertMemoryRecord, QaExpertMemoryScope, QaSkillDocument, QaSkillDraftInput, QaSkillRemoval, QaSkillSummary, QaSkillToolDescriptor, QaSkillValidation, QaSourceFilePreview, QaWhoamiResult, QaWorkspaceFile, QaWorkspaceFileChunk, QaWorkspaceListing, QaPrincipal, QaAccessAdminSnapshot, QaAdminAuditEvent, QaAdminOverview, QaAdminPage, QaAdminUserDetail, QaAdminUserRow, QaAdminUserUpdate, QaAuditQuery, QaCapabilitySelection, QaConversationDetail, QaConversationDeletion, QaConversationQuery, QaConversationReview, QaConversationReviewInput, QaConversationSummary, QaCurrentAccess, QaFeedbackHarvestEntry, QaFeedbackHarvestResult, QaFeedbackQuery, QaFeedbackRow, QaMessageFeedback, QaMessageFeedbackInput, QaModelCatalogEntry, QaModelPair, QaQualityMetrics, QaReviewQueueItem, QaReviewQueueRow, QaSessionAccess, QaSlashCatalog, QaSlashExecution, QaSlashSubmitAttachment, QaSkillActivationRecord, QaSkillAssignmentOverride, QaSubrole, QaUserAccess, QaUserQuery } from "./types.js";
 export declare const name = "qa-surface";
 export declare const inject: string[];
 import { QA_SURFACE_SETTINGS_NAMESPACE } from "./shared/settings.js";
@@ -19,6 +21,8 @@ declare module "@deepseek-ai/cordis" {
 }
 /** Host companion: validates config, owns the admission boundary and the route. */
 export declare class QaSurface extends TypertRemoteService {
+    private sourceSelections?;
+    private codeSourceStore;
     static inject: string[];
     static Config: import("@deepseek-ai/schemastery").default<QaSurfaceConfigRefs>;
     private readonly source;
@@ -79,6 +83,7 @@ export declare class QaSurface extends TypertRemoteService {
     private chatSharingStore;
     private readonly chatTransport;
     private readonly chatTurnGuard;
+    private readonly requestScheduler;
     private sharing;
     constructor(ctx: Context, entry?: Partial<QaSurfaceConfigRefs>);
     /** The quality store, opening its file the first time anyone needs it. */
@@ -125,6 +130,11 @@ export declare class QaSurface extends TypertRemoteService {
      * @param sessionId - the chat the work is delegated from.
      */
     modelPolicyForSession(sessionId: string): QaModelPair | undefined;
+    /** Shared source catalogue consumed by preset-mounted Git tools at call time. */
+    getCodeSources(sessionId?: string): ResolvedQaSurfaceConfig["codeSources"];
+    getSelectedCodeSource(sessionId: string): string | null;
+    chatCodeSources(token: string, sessionId: string): Promise<QaChatCodeSources>;
+    chatSelectCodeSource(token: string, sessionId: string, source: string | null): Promise<QaChatCodeSources>;
     getConfig(): ResolvedQaSurfaceConfig;
     /**
      * Ownership plus the role's user-skill grant for one slash read.
@@ -171,9 +181,7 @@ export declare class QaSurface extends TypertRemoteService {
      */
     accountsClaimSessions(token: string, sessionIds: readonly string[]): QaClaimResult;
     /** The token user's owned session ids; the sidebar list authority. */
-    accountsOwnedSessions(token: string): {
-        readonly ids: readonly string[];
-    };
+    accountsOwnedSessions(token: string): QaOwnedSessionsResult;
     /**
      * Every chat-ownership entry with owner display names; the cross-user view
      * admin browsers group the sidebar by. Ordinary accounts are refused with
@@ -228,6 +236,9 @@ export declare class QaSurface extends TypertRemoteService {
     accountsSetServiceTokenClarifications(token: string, tokenId: string, allowed: boolean): {
         readonly updated: boolean;
     };
+    accountsSetServiceTokenHistoryFolder(token: string, tokenId: string, folder: QaHistoryFolderTarget | null): {
+        readonly updated: boolean;
+    };
     /**
      * Serve the effective QA configuration to the browser. The DSH gateway pins
      * settings RPCs to loopback, so a browser served over the LAN always sees
@@ -237,19 +248,33 @@ export declare class QaSurface extends TypertRemoteService {
      */
     describe(): ResolvedQaSurfaceConfig;
     /**
-     * Report how much of the deployment's request ceiling the stand is using, so
-     * a browser holds its question back instead of opening another turn on a
-     * model that is busy answering the ones it allows.
+     * Report server admission. Global reads expose counts only; a chat's FIFO
+     * position requires that account's current read access to the chat. The
+     * scheduler gates every root turn, including native and integration sends.
      *
-     * The count is the Host's, not the browser's: a visitor cannot see another
-     * account's chats, and the HTTP API's questions are invisible to every chat
-     * view. Read-only, and a ceiling rather than a lock — a prompt rides the
-     * native session RPC this plugin does not own, so the boundary is the
-     * browser's own courtesy, and two questions sent in the same instant can
-     * still overshoot by one. What the ceiling buys is that steady state, not a
-     * strict bound.
+     * Both arguments are part of the wire contract: the gateway client counts
+     * declared parameters rather than TypeScript optionals, so a call that omits
+     * them is refused on the browser before the Host ever sees it. An empty
+     * session id is the global read — the shape every initial send asks for,
+     * while its draft chat has no session to name yet.
+     */
+    queueStatus(token: string, sessionId: string): QaQueueStatus;
+    /**
+     * The ceiling this read answers against: the chat's own account chain when
+     * the read names a chat, the caller's account chain when it does not (the
+     * pre-send check carries a token but no chat yet), and the deployment's
+     * number whenever accounts are off or nobody matches. `undefined` is the
+     * scheduler's signal to fall back to that number, so the branch is a value
+     * rather than a flag.
+     */
+    private queueCeiling;
+    /**
+     * The ceiling override one arriving turn fills against, or `undefined` when
+     * the deployment default governs it: without accounts every turn shares the
+     * one number, and an unowned session (an integration or an admin preview)
+     * stays in that shared pool whatever its role might say.
      */
-    queueStatus(): QaQueueStatus;
+    private queueSlotsOverride;
     /**
      * Create a QA session from Host-owned inputs. With account workspaces on,
      * cwd is `<configured workspace>/.qa-users/<account UUID>` and the child is
@@ -268,6 +293,7 @@ export declare class QaSurface extends TypertRemoteService {
     accessUpdateSubrole(token: string, id: string, input: QaSubrole): Promise<QaSubrole>;
     /** The pairs this Host can serve, for the surface that writes a policy. */
     accessModelCatalog(token: string): Promise<readonly QaModelCatalogEntry[]>;
+    accessUserModels(token: string, sessionId: string | null, subroleId: string | null, adminPreview: boolean): Promise<QaModelOptions>;
     accessDeleteSubrole(token: string, id: string, replacementId: string | null): {
         readonly deleted: boolean;
     };

package/lib/types/integration/http.d.ts

@@ -4,8 +4,6 @@ import type { PluginLogger } from "@yadsh/dsh-plugin-log";
 import type { ResolvedQaSurfaceConfig } from "../types.js";
 import { type QaAskRequest } from "./contract.js";
 import type { QaIntegrationService } from "./service.js";
-/** The bridge's own ceiling: five attachments per question. */
-export declare const QA_INTEGRATION_MAX_FILES = 5;
 export interface QaIntegrationRouteOptions {
     config: ResolvedQaSurfaceConfig;
     service: QaIntegrationService;
@@ -59,7 +57,7 @@ interface MultipartBody {
  * @param boundary - the boundary parameter of the content type.
  * @returns text fields and file parts, in the order they appeared.
  */
-export declare function parseMultipart(body: Buffer, boundary: string): MultipartBody;
+export declare function parseMultipart(body: Buffer, boundary: string, maxAttachments?: number): MultipartBody;
 /**
  * Read the whole request body under a byte ceiling.
  * @param request - the incoming request.

package/lib/types/integration/service.d.ts

@@ -1,5 +1,6 @@
 import type { PluginLogger } from "@yadsh/dsh-plugin-log";
 import type { QaAccounts } from "../accounts/store.js";
+import type { QaHistoryFolderTarget } from "../types/accounts.js";
 import { type QaServiceTokenScope } from "../accounts/service-token.js";
 import type { QaSourceReference } from "../provenance/types.js";
 import type { ResolvedQaSurfaceConfig } from "../types.js";
@@ -31,6 +32,7 @@ export declare const QA_INTEGRATION_MAX_CITATIONS = 5;
 export declare function sourceCitations(sources: readonly QaSourceReference[]): readonly string[];
 /** Who a presented credential turned out to be. */
 export interface QaIntegrationIdentity {
+    readonly historyFolder?: QaHistoryFolderTarget;
     readonly allowClarifications: boolean;
     readonly tokenId: string;
     readonly userId: string;

package/lib/types/personal-skills/shared-seed.d.ts

@@ -0,0 +1,12 @@
+import type { PluginLogger } from "@yadsh/dsh-plugin-log";
+import type { ResolvedQaSurfaceConfig } from "../types.js";
+import { type QaSkillRoots } from "./paths.js";
+/**
+ * Promote an operator-selected subset of a read-only catalog into the shared
+ * store. Copy complete directories, including resources, before publishing a
+ * skill. Neither a restart, an updated seed nor an editor deletion restores
+ * the original bytes: a hidden per-name receipt survives rename and removal.
+ * Existing shared directories always belong to the operator and win as-is.
+ */
+export declare function seedSharedSkills(roots: QaSkillRoots, seed: ResolvedQaSurfaceConfig["accounts"]["skills"]["sharedSeed"], logger: PluginLogger): boolean;
+//# sourceMappingURL=shared-seed.d.ts.map

package/lib/types/prompt-notes.d.ts

@@ -32,6 +32,7 @@ export declare const QA_DOCUMENTS_NOTE = "dsh-qa-surface:attached-documents";
 /** Note name carrying the deployment's rule about where an answer comes from. */
 export declare const QA_SOURCE_PRIORITY_NOTE = "dsh-qa-surface:source-priority";
 export declare const QA_BRANCH_NOTE = "dsh-qa-surface:chat-branch";
+export declare const QA_CODE_SOURCES_NOTE = "dsh-qa-surface:code-sources";
 /**
  * Built-in note texts. Each is the fallback for its settings template
  * (`notes.*.template`); the placeholders mark the parts the injector
@@ -41,7 +42,7 @@ export declare const QA_IDENTITY_NOTE_TEMPLATE = "{identity}\n\n{instructions}";
 export declare const QA_SOURCES_NOTE_TEMPLATE = "Source provenance is collected automatically from your tool calls; the QA surface lists what it collected beside the answer. Do not append a manual Sources/\u0418\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0438 bibliography of your own.";
 export declare const QA_SOURCES_FALLBACK_TEMPLATE = "A delegated run whose provider cannot expose tool events must call {reportTool} before finishing.";
 export declare const QA_DELEGATION_NOTE_TEMPLATE = "When you start a background subagent, give the delegation a short vivid name in its description field: two or three words in the user's language that say what the run is for (\u00AB\u0421\u0432\u0435\u0440\u043A\u0430 \u043E\u0442\u0447\u0451\u0442\u043E\u0432\u00BB, \"Log triage\"). The QA surface shows that description as the subagent's display name in the operator's panel and completion notices.";
-export declare const QA_DOCUMENTS_NOTE_TEMPLATE = "A document a chat user attached is a path on disk, not text: read it with the deployment's document pipeline \u2014 `document_inspect` says what a DOCX or PDF is, `document_to_markdown` extracts its text, `document_from_url` stores the text of an attachment that only exists behind a URL. For XLSX, CSV, TSV, ODS or FODS, `spreadsheet_inspect` lists all sheets and detects text delimiter/encoding, `spreadsheet_read` reads pages, and `spreadsheet_create` creates a file in the selected format. CSV/TSV have one Data sheet with string fields; reuse detected delimiter and encoding when paging. XLSX/ODS/FODS support multiple sheets. Inspect all sheet names before selecting data; formula values are saved caches, not recalculated results. The plain file reader refuses those formats as binary, so that refusal is expected and is not a hint to go looking for the file somewhere else. When the pipeline itself refuses a path, report the refusal and the path it named instead of trying another reader.";
+export declare const QA_DOCUMENTS_NOTE_TEMPLATE: string;
 export declare const QA_SOURCE_PRIORITY_NOTE_TEMPLATE = "Answer from the source that owns the question: read what the conversation and its attachments already carry, then search the product documentation and ask the domain expert, and only then look in memory. Recalled memory is background from earlier sessions \u2014 a miss there is not evidence that no source exists, and it is not where a document, a page or a product fact should be looked up.";
 export interface QaIdentityRenderInput {
     /** The owner's account address; the one fact accounts always provide. */
@@ -71,6 +72,7 @@ export interface QaPromptNote {
     readonly text: string;
 }
 export interface QaPromptNotesOptions {
+    readonly codeSources?: (sessionId: string) => import("@yadsh/dsh-plugin-kit/code-sources").CodeSourcesCatalog;
     readonly config: () => ResolvedQaSurfaceConfig;
     /** The live accounts store, or undefined while accounts are disabled. */
     readonly accounts: () => QaAccounts | undefined;
@@ -116,6 +118,8 @@ export declare class QaPromptNotes {
     dispose(): void;
     /** Append every note whose text this step does not already carry. */
     private inject;
+    /** Keep Git and file lookups on the same configured tree, including in children. */
+    private codeSourceNotes;
     /** Who is asking: the owner's name, handles and their own instructions. */
     private identityNotes;
     /** What the deployment expects around the sources the surface collects. */