@primusclaw/personal-agent 0.0.0-stage → 0.1.0

package/dist/types/locales/approval-decisions.d.ts

@@ -0,0 +1,28 @@
+export declare const decisionText: import("./catalog.js").Catalog<{
+    pressAgain: string;
+    notBound: string;
+    exchangeFailed: string;
+    notSent: string;
+    refused: (p: {
+        answering: boolean;
+        status: number;
+    }) => string;
+    unreachable: string;
+    answered: string;
+    decided: (p: {
+        allow: boolean;
+        tool: string;
+    }) => string;
+    questionExpired: string;
+    approvalExpired: string;
+    approvalNeeded: (p: {
+        tool: string;
+    }) => string;
+    onlyAskerAnswers: string;
+    onlyAskerDecides: string;
+    approvalInactive: string;
+    approvalAnswered: string;
+    questionInactive: string;
+    questionAnswered: string;
+    notConnected: string;
+}>;

package/dist/types/locales/approval.d.ts

@@ -0,0 +1,31 @@
+export declare const approvalText: import("./catalog.js").Catalog<{
+    title: string;
+    titleGroup: string;
+    action: string;
+    reason: string;
+    model: string;
+    said: string;
+    more: (p: {
+        n: number;
+    }) => string;
+    details: string;
+    rule: (p: {
+        label: string;
+    }) => string;
+    only: (p: {
+        who: string;
+    }) => string;
+    asker: string;
+    fallbackTool: string;
+    sep: string;
+    allow: string;
+    deny: string;
+    questionTitle: string;
+    questionOr: string;
+    questionYours: string;
+    questionOnly: (p: {
+        who: string;
+    }) => string;
+    questionAsker: string;
+    send: string;
+}>;

package/dist/types/locales/assistant-actions.d.ts

@@ -0,0 +1,65 @@
+import type { Lang } from "./lang.js";
+/** What upgrades a machine's claw-connector and restarts it on the new version (connector_setup.UPGRADE_COMMAND). */
+export declare const CONNECTOR_UPGRADE_COMMAND = "npm install -g @primusclaw/connector@latest && claw-connector stop && claw-connector service install";
+type Words = Readonly<Record<string, Readonly<Record<Lang, string>>>>;
+/** Why Claw did not do a held write the person let through, by its error word. */
+export declare const CONFIRM_FAILED: Words;
+/** Why Claw did not post a comment the person let through, by its error word. */
+export declare const COMMENT_FAILED: Words;
+/** Why Claw did not send an instruction the person let through, by its error word. */
+export declare const DEVENV_SEND_FAILED: Words;
+export declare const assistantActionText: import("./catalog.js").Catalog<{
+    noExchange: string;
+    notBound: string;
+    exchangeFailed: string;
+    clawSilent: string;
+    nothingDone: string;
+    commentPosted: (p: {
+        link: string;
+    }) => string;
+    commentDenied: string;
+    commentNotPosted: (p: {
+        why: string;
+    }) => string;
+    triggerCancelled: string;
+    scheduled: (p: {
+        name: string;
+        schedule: string;
+        tz: string;
+        next: string;
+    }) => string;
+    alreadyAnswered: string;
+    notCreated: string;
+    notCancelled: string;
+    expired: string;
+    notDone: (p: {
+        why: string;
+    }) => string;
+    sent: (p: {
+        agent: string;
+        machine: string;
+        seq: string;
+    }) => string;
+    notSent: string;
+    sendExpired: string;
+    notSentWhy: (p: {
+        why: string;
+    }) => string;
+    actionGone: string;
+    actionUsed: string;
+    confirmGone: string;
+    confirmUsed: string;
+    notRun: (p: {
+        text: string;
+    }) => string;
+    actionInvalid: (p: {
+        text: string;
+    }) => string;
+    ran: (p: {
+        text: string;
+    }) => string;
+    couldNotRun: (p: {
+        text: string;
+    }) => string;
+}>;
+export {};

package/dist/types/locales/assistant-board.d.ts

@@ -0,0 +1,14 @@
+export declare const boardText: import("./catalog.js").Catalog<{
+    notAvailable: string;
+    failed: string;
+    empty: string;
+    moreWaiting: (p: {
+        n: number;
+    }) => string;
+    unreachable: string;
+    cardGone: string;
+    cardUsed: string;
+    tryAgain: string;
+    pressAgain: string;
+    retryAgain: string;
+}>;

package/dist/types/locales/assistant-cards.d.ts

@@ -0,0 +1,81 @@
+export declare const assistantCardText: import("./catalog.js").Catalog<{
+    resultReady: (p: {
+        version: number;
+    }) => string;
+    waiting: string;
+    replyForChanges: string;
+    accept: (p: {
+        version: number;
+    }) => string;
+    stop: string;
+    watch: string;
+    unwatch: string;
+    watchHint: string;
+    watchingHint: string;
+    acceptAll: (p: {
+        n: number;
+    }) => string;
+    retry: (p: {
+        seq: number;
+    }) => string;
+    runTitle: string;
+    run: string;
+    cancel: string;
+    confirmTitle: string;
+    confirm: string;
+    deny: string;
+    boardTitle: string;
+    boardWaiting: (p: {
+        n: number;
+    }) => string;
+    boardNothing: string;
+    column: (p: {
+        state: string;
+    }) => string;
+    badge: (p: {
+        state: string;
+    }) => string;
+    /** board_line: how a done item ended (its outcome as Claw says it, "closed" when none). */
+    outcome: (p: {
+        outcome: string;
+    }) => string;
+    ready: (p: {
+        version: number;
+    }) => string;
+    asks: (p: {
+        question: string;
+    }) => string;
+    report: (p: {
+        kind: string;
+    }) => string;
+    more: (p: {
+        n: number;
+    }) => string;
+    older: (p: {
+        n: number;
+    }) => string;
+    justNow: string;
+    minutesAgo: (p: {
+        n: number;
+    }) => string;
+    hoursAgo: (p: {
+        n: number;
+    }) => string;
+    daysAgo: (p: {
+        n: number;
+    }) => string;
+    askedTitle: (p: {
+        n: number;
+    }) => string;
+    version: (p: {
+        version: number;
+    }) => string;
+    needsYou: (p: {
+        label: string;
+    }) => string;
+}>;
+/** asked_line: how a review asked of someone else stands, by Claw's word (always English; asked_section translates it). */
+export declare const ASKED_VERDICT: Readonly<Record<string, string>>;
+export declare const ASKED_WAITING: Readonly<Record<string, string>>;
+/** asked_section: the English words of how an asked review stands, in Chinese. */
+export declare const ASKED_STATE_ZH: Readonly<Record<string, string>>;

package/dist/types/locales/assistant-chat.d.ts

@@ -0,0 +1,13 @@
+export declare const assistantChatText: import("./catalog.js").Catalog<{
+    unavailable: string;
+    rejected: string;
+    stopFailed: string;
+    stopped: string;
+    notBusy: string;
+    stopHint: string;
+    notTaken: string;
+    clawRefused: string;
+    anImage: string;
+    notUnderstood: string;
+    filesOnly: string;
+}>;

package/dist/types/locales/assistant-devenv-hide.d.ts

@@ -0,0 +1,23 @@
+export declare const devenvHideText: import("./catalog.js").Catalog<{
+    hidden: (p: {
+        n: number;
+    }) => string;
+    shownAgain: (p: {
+        n: number;
+    }) => string;
+    disconnected: (p: {
+        n: number;
+    }) => string;
+    /** The way back is said only when something was hidden: after showing again, or disconnecting, nothing is to bring back. */
+    done: (p: {
+        parts: readonly string[];
+        hidden: boolean;
+    }) => string;
+    nothing: string;
+    alreadyAnswered: string;
+    denied: string;
+    expired: string;
+    failed: (p: {
+        why: string;
+    }) => string;
+}>;

package/dist/types/locales/assistant-work-clicks.d.ts

@@ -0,0 +1,98 @@
+export declare const workClickText: import("./catalog.js").Catalog<{
+    retried: (p: {
+        label: string;
+    }) => string;
+    tooMany: (p: {
+        label: string;
+    }) => string;
+    notRetryable: (p: {
+        label: string;
+    }) => string;
+    noRetry: string;
+    /** A Retry drawn while the stop was recent, pressed after RETRY_STOPPED_SECONDS. */
+    stoppedLongAgo: (p: {
+        label: string;
+    }) => string;
+    watching: (p: {
+        pull: string;
+        label: string;
+        short: string;
+    }) => string;
+    watchingAlready: (p: {
+        pull: string;
+        short: string;
+    }) => string;
+    unwatched: (p: {
+        label: string;
+        pull: string;
+    }) => string;
+    unwatchedAlready: (p: {
+        label: string;
+    }) => string;
+    noPull: (p: {
+        label: string;
+    }) => string;
+    watchNeedsSignIn: string;
+    watchRefused409: (p: {
+        label: string;
+    }) => string;
+    watchRefused404: string;
+    watchRefused403: string;
+    rejected: string;
+    notFound: string;
+    notStopped: string;
+    couldNot: (p: {
+        status: number;
+    }) => string;
+    reviewEnded: (p: {
+        how: string;
+    }) => string;
+    alreadyMerged: (p: {
+        label: string;
+    }) => string;
+    mergeInProgress: (p: {
+        label: string;
+    }) => string;
+    stoppedReview: (p: {
+        label: string;
+    }) => string;
+    stoppedTitle: string;
+    done: (p: {
+        verb: string;
+        label: string;
+        version: number | null;
+    }) => string;
+    updated: (p: {
+        version: number;
+    }) => string;
+    updatedCard: (p: {
+        note: string;
+        version: number;
+    }) => string;
+    lookAgain: (p: {
+        note: string;
+    }) => string;
+    alreadyClosed: (p: {
+        label: string;
+        outcome: string;
+    }) => string;
+    waitingVersion: (p: {
+        label: string;
+        version: number;
+    }) => string;
+    waitingForYou: (p: {
+        label: string;
+        question: string;
+    }) => string;
+    workedOn: (p: {
+        label: string;
+    }) => string;
+    acceptedAll: (p: {
+        n: number;
+        labels: string;
+    }) => string;
+    acceptedNone: string;
+    leftOver: (p: {
+        n: number;
+    }) => string;
+}>;

package/dist/types/locales/assistant.d.ts

@@ -0,0 +1,5 @@
+export declare const receiptText: import("./catalog.js").Catalog<{
+    received: string;
+    background: string;
+    alsoLead: string;
+}>;

package/dist/types/locales/brief.d.ts

@@ -0,0 +1,29 @@
+export declare const briefText: import("./catalog.js").Catalog<{
+    unavailable: string;
+    needsKey: string;
+    usage: (p: {
+        assistant: boolean;
+    }) => string;
+    noTriggers: string;
+    tooMany: string;
+    refused: (p: {
+        status: number;
+    }) => string;
+    isOn: (p: {
+        schedule: string;
+        timezone: string;
+    }) => string;
+    isOff: string;
+    unreadable: string;
+    badTime: string;
+    onAssistant: (p: {
+        clock: string;
+        timezone: string;
+    }) => string;
+    onSkill: (p: {
+        clock: string;
+        timezone: string;
+    }) => string;
+    off: string;
+    wasNotOn: string;
+}>;

package/dist/types/locales/catalog.d.ts

@@ -0,0 +1,24 @@
+import type { Lang } from "./lang.js";
+/**
+ * User-facing text lives in catalogs, one per feature (`locales/<feature>.ts`), never inline in domain code. A catalog
+ * is defined once per language with the same keys and the same parameters, which the compiler checks:
+ *
+ *     export const apimText = defineCatalog({
+ *       en: { guidance: (p: { url: string }) => `Please upload it here:\n${p.url}` },
+ *       zh: { guidance: (p) => `请先在这里上传：\n${p.url}` },
+ *     });
+ *     apimText.in(lang).guidance({ url });
+ *
+ * A message is a fixed string or a function of named parameters. Byte-for-byte equality with the Python worker's
+ * texts is a test of the feature that ports them, not of this mechanism.
+ */
+export type Message = string | ((params: never) => string);
+export type Messages = Readonly<Record<string, Message>>;
+export interface Catalog<M extends Messages> {
+    /** The messages in `lang`. */
+    in(lang: Lang): M;
+}
+export declare function defineCatalog<M extends Messages>(texts: {
+    readonly en: M;
+    readonly zh: NoInfer<M>;
+}): Catalog<M>;

package/dist/types/locales/claw.d.ts

@@ -0,0 +1,5 @@
+export declare const clawText: import("./catalog.js").Catalog<{
+    readonly service_client_not_allowed: "PrimusClaw does not take answers from me yet: its operator has to allow this worker's client.";
+    readonly interactive_sign_in_required: "PrimusClaw did not take my credential for you as a sign-in; tell the operator.";
+    readonly only_the_acting_user_can_decide: "PrimusClaw says this answer is not yours to give.";
+}>;

package/dist/types/locales/commands.d.ts

@@ -0,0 +1,12 @@
+/** The command usage texts. */
+export declare const commandText: import("./catalog.js").Catalog<{
+    repoUsage: string;
+    /**
+     * With the assistant on there is one conversation and a task of its own for each thing asked: no session to start,
+     * list or choose, and no repository to bind to a session.
+     */
+    assistantNoSessions: string;
+    assistantNoRepo: string;
+}>;
+/** What `/agent` alone (or with no subcommand) says; the remote-agent feature shows it. English only, as in the Python worker. */
+export declare const AGENT_USAGE: string;

package/dist/types/locales/connector-reasons.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The closed set of reason codes a connector (and Claw on its behalf) gives: what happened, then what to do. The fix of an
+ * old-connector code and the hints after some codes are added by `remote/connector/reasons.ts`.
+ *
+ * Sources: connector/src (session.ts, manager.ts, attach.ts, roots.ts, connector.ts, permissions.ts, terminal-input.ts) and what
+ * Claw itself writes with `data.by = "claw"` (claw/packages/api/src/remote-agents/store.ts). A code the connector gains must be
+ * added here, in both languages. `{login}` is the login command of the address the worker reaches Claw at.
+ */
+export declare const connectorReasonText: import("./catalog.js").Catalog<{
+    mode_unavailable: string;
+    mode_not_enforced: string;
+    mode_not_confirmed: string;
+    mode_mismatch: string;
+    mode_not_allowed: string;
+    mode_id_required: string;
+    set_mode_failed: string;
+    adapter_gone: string;
+    adapter_start_failed: string;
+    adapter_unavailable: string;
+    adapter_protocol: string;
+    adapter_cannot_resume: string;
+    adapter_error: string;
+    agent_auth_required: string;
+    cwd_outside_roots: string;
+    cwd_not_found: string;
+    cwd_not_directory: string;
+    cwd_not_absolute: string;
+    invalid_cwd: string;
+    cwd_mismatch: string;
+    unknown_agent: string;
+    not_delivered: string;
+    delivery_unconfirmed: string;
+    connector_revoked: string;
+    machine_reconnected: string;
+    unknown_session: string;
+    too_many_sessions: string;
+    resume_not_supported: string;
+    attach_unavailable: string;
+    resume_ref_required: string;
+    invalid_resume_ref: string;
+    already_attached: string;
+    catalog_unavailable: string;
+    session_live: string;
+    recently_written: string;
+    twin_check_failed: string;
+    terminal_did_not_exit: string;
+    session_live_elsewhere: string;
+    takeover_not_permitted: string;
+    takeover_failed: string;
+    terminal_busy: string;
+    terminal_input_withdrawn: string;
+    terminal_state_unknown: string;
+    terminal_gone: string;
+    terminal_switched: string;
+    terminal_input_failed: string;
+    terminal_input_unconfirmed: string;
+    terminal_input_unavailable: string;
+    empty_prompt: string;
+    read_only_live_session: string;
+    terminal_session: string;
+    terminal_mode_not_allowed: string;
+    terminal_mode_unknown: string;
+    terminal_screen_unknown: string;
+    terminal_command_refused: string;
+    takeover_expired: string;
+    cwd_ambiguous: string;
+    root_unavailable: string;
+    session_closed: string;
+    closed: string;
+    stopped: string;
+    paused: string;
+    revoked: string;
+    text_required: string;
+    action_and_option_required: string;
+    too_many_queued_prompts: string;
+    cancelled: string;
+    unknown_action: string;
+    option_not_offered: string;
+}>;
+/** What `explain` adds after a reason's own sentence, and the sentence of a code it does not know. */
+export declare const connectorReasonHints: import("./catalog.js").Catalog<{
+    upgrade: (p: {
+        command: string;
+    }) => string;
+    sandbox: string;
+    status: string;
+    newSession: string;
+    retry: string;
+    unknown: (p: {
+        code: string;
+    }) => string;
+    /** Between a lead and the reason after it, and the end of a lead with none. */
+    leadSep: string;
+    leadEnd: string;
+}>;

package/dist/types/locales/connector-setup.d.ts

@@ -0,0 +1,20 @@
+/** How to connect a machine and upgrade its connector (`remote/connector/setup.ts`). */
+export declare const connectorSetupText: import("./catalog.js").Catalog<{
+    noMachine: string;
+    /** Between the first line and `runOn`. */
+    sep: string;
+    runOn: string;
+    after: string;
+    /** What differs per system, one line each. */
+    notes: string;
+    upgrade: (p: {
+        command: string;
+    }) => string;
+    versionUnsupported: (p: {
+        version: string;
+    }) => string;
+    versionOutdated: (p: {
+        version: string;
+    }) => string;
+    offlineHint: string;
+}>;

package/dist/types/locales/feedback.d.ts

@@ -0,0 +1,75 @@
+export declare const feedbackText: import("./catalog.js").Catalog<{
+    filed: (p: {
+        number: number;
+        url: string;
+    }) => string;
+    commented: (p: {
+        number: number;
+        url: string;
+    }) => string;
+    unconfigured: string;
+    failed: string;
+    whatWentWrong: string;
+    whatWentWrongInGroup: (p: {
+        bot: string;
+    }) => string;
+    thumbReportFailed: string;
+    thumbsAsk: string;
+    thumbsUp: string;
+    thumbsDownAsk: string;
+    buttonInactive: string;
+    filing: string;
+    reportInactive: string;
+    reportInactiveNote: string;
+    reportNotAsker: string;
+    reportAsked: string;
+    offerAdded: (p: {
+        number: number;
+    }) => string;
+    offerDeclined: (p: {
+        number: number;
+    }) => string;
+    offerEmpty: (p: {
+        number: number;
+    }) => string;
+    offerInvalid: string;
+    offerRetry: string;
+}>;
+/** The texts of feedback: the same in every language for now (see above). */
+export declare const FEEDBACK_TEXT: {
+    filed: (p: {
+        number: number;
+        url: string;
+    }) => string;
+    commented: (p: {
+        number: number;
+        url: string;
+    }) => string;
+    unconfigured: string;
+    failed: string;
+    whatWentWrong: string;
+    whatWentWrongInGroup: (p: {
+        bot: string;
+    }) => string;
+    thumbReportFailed: string;
+    thumbsAsk: string;
+    thumbsUp: string;
+    thumbsDownAsk: string;
+    buttonInactive: string;
+    filing: string;
+    reportInactive: string;
+    reportInactiveNote: string;
+    reportNotAsker: string;
+    reportAsked: string;
+    offerAdded: (p: {
+        number: number;
+    }) => string;
+    offerDeclined: (p: {
+        number: number;
+    }) => string;
+    offerEmpty: (p: {
+        number: number;
+    }) => string;
+    offerInvalid: string;
+    offerRetry: string;
+};

package/dist/types/locales/group.d.ts

@@ -0,0 +1,33 @@
+/** What a group chat is told. Most of it is English only, as in the Python worker. */
+export declare const groupText: import("./catalog.js").Catalog<{
+    githubOneToOne: string;
+    oneToOneOnly: (p: {
+        word: string;
+    }) => string;
+    agentInGroup: string;
+    whoami: (p: {
+        name: string;
+        who: string;
+    }) => string;
+    whoamiUnknown: string;
+    targeted: (p: {
+        bot: string;
+    }) => string;
+    stopUnreachable: string;
+    stopNone: (p: {
+        number: number;
+    }) => string;
+    stopMany: (p: {
+        number: number;
+    }) => string;
+}>;
+/** Group onboarding of a member who has not connected (English only, as in the Python worker). */
+export declare const onboardingText: {
+    readonly inactive: "This button is no longer active. Mention me again to get a new one.";
+    readonly notYours: (name: string) => string;
+    readonly connected: (pending: boolean) => string;
+    readonly stepsSent: (bot: string) => string;
+    readonly noDm: (page: string) => string;
+    readonly resuming: (name: string, bot: string) => string;
+    readonly notResumed: "I could not start your request in the group chat. Mention me there again to run it.";
+};

package/dist/types/locales/guardrails.d.ts

@@ -0,0 +1,22 @@
+/** What a person is told (the operation names are keyed by `SensitiveOperation`) when a per-person limit of an operation that acts with their authority refused it. */
+export declare const guardrailsText: import("./catalog.js").Catalog<{
+    pr_review: string;
+    pr_merge: string;
+    approval: string;
+    remote_agent: string;
+    hours: (p: {
+        n: number;
+    }) => string;
+    minutes: (p: {
+        n: number;
+    }) => string;
+    seconds: (p: {
+        n: number;
+    }) => string;
+    refused: (p: {
+        count: number;
+        what: string;
+        window: string;
+        minutes: number;
+    }) => string;
+}>;