@wowyuarm/dsh-agent-team 0.2.0 → 0.2.1

package/packages/agent-team/lib/types/pressure-policy.d.ts

@@ -1,134 +0,0 @@
-/**
- * Team-owned context pressure policy.
- *
- * The Team preset mounts `compaction-basic` with `auto: false`; this
- * coordinator owns both policy entry points instead — the proactive handoff
- * notice near the effective handoff budget and the forced CompactionEngine
- * reduction before any request at or above the effective hard limit — while
- * reusing the public CompactionEngine implementation. The hard-limit
- * translation lives in exactly one method; no caller re-derives it.
- *
- * Fail-closed rule: at the hard limit, a compaction that no-ops, throws, is
- * cancelled, or does not advance the durable surface must block the model
- * request (reject the step) rather than knowingly submit over the Team limit.
- * A blocked Member keeps its log and reports a recoverable error.
- * @module @wowyuarm/dsh-agent-team/pressure-policy
- */
-import type { Agent } from '@deepseek-ai/dsh-agent';
-import type { CompactionEngine } from '@deepseek-ai/dsh-compaction';
-import type { AgentTeamMemberId } from './types.ts';
-import type { SessionEvent } from '@deepseek-ai/dsh-session';
-import { type SessionEventFold } from './session-event-cursor.ts';
-/**
- * Stable summary of the one-shot rollover pressure notice. It is a durable
- * marker: the notice's own presence in a Session's log is what latches the
- * policy, so the wording is read back and must not drift.
- */
-export declare const CONTEXT_PRESSURE_NOTICE_SUMMARY = "Context pressure: prepare a handoff";
-/**
- * Whether this Session's own span already carries the pressure notice: either
- * surfaced as a `user/message` or still queued in a durable
- * `agent/inbox/spliced` insert. Expressed as a fold rather than a scan because
- * the answer is monotone — once delivered it stays delivered for the
- * generation — so the cursor only ever has to read events it has not seen.
- */
-export declare const PRESSURE_NOTICE_FOLD: SessionEventFold<boolean, SessionEvent>;
-/**
- * One pressure-notice text. The wording is the engine's — the same sentence a
- * fresh-context handoff is asked for through — so the notice and the rollover
- * tool cannot drift apart; Team supplies only its own labels and input shape.
- */
-export declare function contextPressureNoticeText(input: {
-    readonly usageTokens: number;
-    readonly handoffAt: number;
-    readonly hardLimit: number;
-    readonly activeClaims: readonly string[];
-    readonly runningJobs: readonly string[];
-}): string;
-export interface PressurePolicyOptions {
-    /** Resolve the live Agent of one Member. */
-    readonly agentForMember: (memberId: AgentTeamMemberId) => Agent | undefined;
-    /** Resolve the durable Member of one live Agent. */
-    readonly memberForAgent: (agent: Agent) => {
-        readonly memberId: AgentTeamMemberId;
-        readonly sessionId: Agent['id'];
-    } | undefined;
-    /** Resolve the Member-scoped compaction engine. */
-    readonly compactionForAgent: (agent: Agent) => CompactionEngine | undefined;
-    /** Effective budgets for one Member's current route; undefined means the route window is unknown. */
-    readonly limitsForAgent: (agent: Agent) => Promise<{
-        readonly usageTokens: number;
-        readonly hardLimit: number;
-        readonly handoffAt: number;
-    } | undefined> | {
-        readonly usageTokens: number;
-        readonly hardLimit: number;
-        readonly handoffAt: number;
-    } | undefined;
-    /** The model-visible active-Claim labels for one Member's notice. */
-    readonly activeClaimLabels: (memberId: AgentTeamMemberId) => readonly string[];
-    /** The model-visible running-job labels for one Member's notice. */
-    readonly runningJobLabels: (memberId: AgentTeamMemberId) => readonly string[];
-    /** Report a Member failure with a recoverable diagnostic. */
-    readonly failed: (memberId: AgentTeamMemberId, sessionId: Agent['id'], diagnostic: string) => void;
-    /** Log one coordinator diagnostic. */
-    readonly log: (message: string) => void;
-}
-export declare class PressurePolicyCoordinator {
-    private readonly options;
-    /**
-     * Retry budget per agent for the current provider-overflow sequence.
-     * Process-only by design: a restart re-earns one sequence per chain.
-     */
-    private readonly overflowRetries;
-    /**
-     * Whether the one-shot notice was already delivered, folded incrementally per
-     * Member. The scan below is a monotone "has this ever happened" fold over the
-     * Session's own events, so a cursor can replace re-scanning the whole log on
-     * every step; identity guarding falls back to a cold fold when the Member's
-     * Session changed under the entry.
-     */
-    private readonly noticeSeen;
-    private disposed;
-    constructor(options: PressurePolicyOptions);
-    /**
-     * The one-shot pressure notice is durable Session evidence, not process
-     * state: a `CONTEXT_PRESSURE_NOTICE_SUMMARY` notice already surfaced as a
-     * `user/message`, or still queued in a durable `agent/inbox/spliced`
-     * insert (a steered notice surfaces only at the next step boundary, and a
-     * Host restart replays the splice before surfacing), marks the current
-     * generation as already notified. A resume or restart stays quiet; a
-     * rollover starts a fresh Session whose own event span has no notice yet,
-     * which is exactly the documented re-arm.
-     */
-    private noticeDelivered;
-    dispose(): void;
-    /** A successful assistant response ends any open overflow-recovery sequence. */
-    onAssistantMessage(agent: Agent): void;
-    /**
-     * Pre-step policy for one Member agent: below the handoff budget nothing
-     * happens; at the handoff budget one structured notice per generation is
-     * steered into the running turn; at the hard limit the request is forced
-     * through compaction first and fails closed when that cannot be proven.
-     * Returns the decision for the step: `continue` forwards, `reject` blocks.
-     */
-    onPreStep(agent: Agent, signal: AbortSignal): Promise<{
-        readonly kind: 'continue' | 'reject' | 'notice';
-    }>;
-    /**
-     * Provider-overflow recovery: one bounded compact-and-retry sequence per
-     * open failure chain. Returns whether the request may retry once.
-     */
-    onRequestError(agent: Agent, failure: {
-        readonly code?: string;
-    }, signal: AbortSignal): Promise<boolean>;
-    /**
-     * The one Team hard-limit translation: force a CompactionEngine reduction
-     * in the current Agent/Session and prove it advanced the durable surface
-     * (or measurably reduced pressure) before continuing. Background jobs are
-     * untouched — compaction never cancels or discards them.
-     * @returns whether the request may proceed.
-     */
-    private enforceHardLimit;
-}
-//# sourceMappingURL=pressure-policy.d.ts.map

package/packages/agent-team/lib/types/pressure-policy.d.ts.map

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

package/packages/client-agent-team/lib/types/client/HumanSettingsSection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"HumanSettingsSection.d.ts","sourceRoot":"","sources":["../../../src/client/HumanSettingsSection.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAEjF,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAElF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAmBnE,MAAM,WAAW,4BAA4B;IAC3C,mFAAmF;IACnF,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,sFAAsF;IACtF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,gGAAgG;IAChG,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACzD,gEAAgE;IAChE,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC/C,+EAA+E;IAC/E,WAAW,EAAE,qBAAqB,CAAA;CACnC;AAED,MAAM,MAAM,yBAAyB,GACjC,YAAY,CAAC,kBAAkB,CAAC,GAChC,WAAW,CAAC,MAAM,CAAC,GACnB,4BAA4B,CAAA;AAsBhC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,+BAkKpE"}

package/packages/client-agent-team/lib/types/client/HumanSettingsSection.js

@@ -1,118 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useRef, useState } from 'react';
-import { Button, Input } from '@deepseek-ai/dsh-client-ui-primitives';
-import { useHumanIdentity } from "./human-identity.js";
-import { EnvironmentCheck } from "./EnvironmentCheck.js";
-import { useAvatarImage } from "./avatar-image.js";
-import css from './human-settings.module.css';
-/**
- * The Human's own settings page: display name, avatar, the local environment
- * check, and the version footnote.
- *
- * The page owns no durable fact and no copy of one. Name, avatar, and version
- * all arrive from the shared identity projection, so a save here moves the
- * message rows and member refs at the same moment; a failed write keeps the
- * typed name in the field and reports the Host's own reason. The environment
- * check is a separate projection, read only, and belongs to the installation
- * rather than to the Human.
- */
-/** Host-side avatar ceiling (`ATTACHMENT_MAX_BYTES`): the settings page refuses larger files before the round trip. */
-const AVATAR_MAX_BYTES = 10 * 1024 * 1024;
-/**
- * Run one durable write and reduce every failure to the message the page
- * reports. A rejected Remote call (a dropped carrier, a refused write) is a
- * failure like any other: without this the field would sit on "saving" forever
- * and report nothing.
- */
-async function failureOf(action) {
-    try {
-        return await action();
-    }
-    catch (error) {
-        return error instanceof Error ? error.message : String(error);
-    }
-}
-/** First visible character of a display name, or the neutral `H` before one is known. */
-function avatarInitial(name) {
-    const trimmed = (name ?? '').replace(/^@/, '').trim();
-    return trimmed === '' ? 'H' : trimmed.slice(0, 1).toUpperCase();
-}
-export function HumanSettingsSection(props) {
-    const { t, identity } = props;
-    const profile = useHumanIdentity(identity);
-    // Undefined means "follow the Host value": the field re-syncs whenever the
-    // profile changes underneath, without a background read clobbering a name
-    // the reader is still editing.
-    const [draft, setDraft] = useState(undefined);
-    const [saving, setSaving] = useState(false);
-    const [uploading, setUploading] = useState(false);
-    const [notice, setNotice] = useState(null);
-    const filePicker = useRef(null);
-    const name = draft ?? profile.name ?? '';
-    const dirty = draft !== undefined && draft.trim() !== (profile.name ?? '');
-    const emptyName = draft !== undefined && draft.trim() === '';
-    const hasAvatar = profile.avatarRef !== undefined;
-    // The circle answers to decoded bytes, not to a stored reference: the Host
-    // accepts any `image/…` payload, so a file this browser cannot read has to
-    // fall back to the initial exactly as a removed one does.
-    const avatar = useAvatarImage(profile.avatarUrl);
-    const submitName = async () => {
-        if (!dirty || emptyName || saving)
-            return;
-        setSaving(true);
-        setNotice(null);
-        const failure = await failureOf(() => props.saveName(name.trim()));
-        setSaving(false);
-        if (failure !== undefined) {
-            setNotice(t('humanSettingsNameFailed', { message: failure }));
-            return;
-        }
-        setDraft(undefined);
-    };
-    const pickAvatar = async (file) => {
-        if (file === undefined)
-            return;
-        setNotice(null);
-        if (!file.type.startsWith('image/')) {
-            setNotice(t('humanSettingsAvatarNotImage'));
-            return;
-        }
-        if (file.size > AVATAR_MAX_BYTES) {
-            setNotice(t('humanSettingsAvatarTooLarge'));
-            return;
-        }
-        setUploading(true);
-        const failure = await failureOf(() => props.uploadAvatar(file));
-        setUploading(false);
-        if (failure !== undefined)
-            setNotice(t('humanSettingsAvatarFailed', { message: failure }));
-    };
-    const removeAvatar = async () => {
-        setNotice(null);
-        const failure = await failureOf(() => props.removeAvatar());
-        if (failure !== undefined)
-            setNotice(t('humanSettingsAvatarFailed', { message: failure }));
-    };
-    // The page says what it is before it says what happened: the settings nav
-    // lists it beside the Harness's own pages, so the title alone leaves "whose
-    // profile is this, and where does it apply?" unanswered — and every state,
-    // including a failed read, has to answer it.
-    const pageHeader = _jsxs(_Fragment, { children: [_jsx("h2", { className: css.heading, children: t('humanSettingsTitle') }), _jsx("p", { className: css.intro, children: t('humanSettingsIntro') })] });
-    if (profile.status === 'loading' && profile.name === undefined) {
-        return _jsxs("div", { className: css.section, children: [pageHeader, _jsx("p", { className: css.state, role: "status", children: t('humanSettingsLoading') })] });
-    }
-    if (profile.name === undefined) {
-        return _jsxs("div", { className: css.section, children: [pageHeader, _jsx("p", { className: css.state, role: "alert", children: t('humanSettingsUnavailable', { message: profile.error ?? '' }) }), _jsx("div", { className: css.stateAction, children: _jsx(Button, { variant: "outline", onClick: () => { void identity.refresh(); }, children: t('retry') }) })] });
-    }
-    return (_jsxs("div", { className: css.section, children: [pageHeader, _jsxs("div", { className: css.rows, children: [_jsxs("div", { className: css.row, children: [_jsxs("div", { className: css.rowText, children: [_jsx("div", { className: css.title, children: t('humanSettingsName') }), _jsx("div", { className: css.desc, children: t('humanSettingsNameHint') })] }), _jsxs("form", { className: css.controls, onSubmit: (event) => {
-                                    event.preventDefault();
-                                    void submitName();
-                                }, children: [_jsx(Input, { className: css.nameInput, "aria-label": t('humanSettingsName'), "aria-invalid": emptyName || undefined, value: name, disabled: saving, onChange: (event) => { setDraft(event.target.value); } }), _jsx(Button, { type: "submit", variant: "primary", disabled: saving || !dirty || emptyName, children: saving ? t('humanSettingsSaving') : t('humanSettingsSave') })] })] }), _jsxs("div", { className: css.row, children: [_jsxs("div", { className: css.rowText, children: [_jsx("div", { className: css.title, children: t('humanSettingsAvatar') }), _jsx("div", { className: css.desc, children: t('humanSettingsAvatarHint') })] }), _jsxs("div", { className: css.controls, children: [avatar.src === undefined
-                                        ? _jsx("span", { className: `${css.identity} ${css.identityFallback}`, "data-avatar": "initial", "aria-hidden": "true", children: avatarInitial(profile.name) })
-                                        : _jsx("img", { className: `${css.identity} ${css.identityImage}`, "data-avatar": "image", src: avatar.src, alt: "", onError: avatar.failed }), _jsx("input", { ref: filePicker, type: "file", accept: "image/*", tabIndex: -1, "aria-hidden": "true", hidden: true, onChange: (event) => {
-                                            void pickAvatar(event.target.files?.[0]);
-                                            event.target.value = '';
-                                        } }), _jsx(Button, { variant: "outline", disabled: uploading, onClick: () => { filePicker.current?.click(); }, children: uploading ? t('humanSettingsUploading') : hasAvatar ? t('humanSettingsReplace') : t('humanSettingsUpload') }), hasAvatar && _jsx(Button, { disabled: uploading, onClick: () => { void removeAvatar(); }, children: t('humanSettingsRemoveAvatar') })] })] })] }), _jsx(EnvironmentCheck, { t: t, environment: props.environment }), _jsxs("div", { className: css.footnote, children: [_jsx("span", { children: t('humanSettingsVersion', { version: profile.version ?? '' }) }), _jsx("span", { "aria-hidden": "true", children: "\u00B7" }), _jsx("a", { className: css.link, href: profile.repoUrl ?? '', target: "_blank", rel: "noreferrer", children: "GitHub" }), profile.updateAvailable && profile.latestVersion !== undefined
-                        ? _jsx("a", { className: css.link, href: `${profile.repoUrl ?? ''}/releases`, target: "_blank", rel: "noreferrer", children: t('humanSettingsUpdateAvailable', { version: profile.latestVersion }) })
-                        : null] }), emptyName && _jsx("p", { className: css.notice, children: t('humanSettingsNameEmpty') }), notice === null ? null : _jsx("p", { className: css.notice, role: "alert", children: notice })] }));
-}