@linkshell/host 0.4.37 → 0.4.39

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

@@ -14,3 +14,4 @@ export * from "./async-questions.js";
 export * from "./questions.js";
 export * from "./acp.js";
 export * from "./editor.js";
+export * from "./live-activity.js";

package/dist/wire/src/index.js

@@ -14,4 +14,5 @@ export * from "./async-questions.js";
 export * from "./questions.js";
 export * from "./acp.js";
 export * from "./editor.js";
+export * from "./live-activity.js";
 //# sourceMappingURL=index.js.map

package/dist/wire/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../wire/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../wire/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/wire/src/live-activity.d.ts

@@ -0,0 +1,334 @@
+import { z } from "zod";
+import type { PendingPermissionSummary, PermissionOption, SessionActivity, SessionSummary, TerminalInfo, ToolKind } from "./model.js";
+export type AttentionPhase = "waiting_for_approval" | "waiting_for_input" | "failed" | "running" | "starting" | "completed" | "stale";
+export declare const liveActivityActionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    role: z.ZodEnum<["allow", "reject", "always", "stop", "choice"]>;
+    kind: z.ZodEnum<["permission", "answer", "async-answer"]>;
+    computerKey: z.ZodString;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    optionId: z.ZodString;
+    questionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "answer" | "permission" | "async-answer";
+    id: string;
+    role: "stop" | "choice" | "reject" | "allow" | "always";
+    requestId: string;
+    optionId: string;
+    label: string;
+    sessionId: string;
+    computerKey: string;
+    questionId?: string | undefined;
+}, {
+    kind: "answer" | "permission" | "async-answer";
+    id: string;
+    role: "stop" | "choice" | "reject" | "allow" | "always";
+    requestId: string;
+    optionId: string;
+    label: string;
+    sessionId: string;
+    computerKey: string;
+    questionId?: string | undefined;
+}>;
+export type LiveActivityAction = z.infer<typeof liveActivityActionSchema>;
+export declare const liveActivityTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["session", "terminal"]>;
+    phase: z.ZodEnum<["waiting_for_approval", "waiting_for_input", "failed", "running", "starting", "completed", "stale"]>;
+    title: z.ZodString;
+    subtitle: z.ZodString;
+    project: z.ZodString;
+    agent: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    agent: string;
+    kind: "terminal" | "session";
+    id: string;
+    phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+    subtitle: string;
+    project: string;
+}, {
+    title: string;
+    agent: string;
+    kind: "terminal" | "session";
+    id: string;
+    phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+    subtitle: string;
+    project: string;
+}>;
+export type LiveActivityTask = z.infer<typeof liveActivityTaskSchema>;
+/** A transition, rather than a heartbeat: the receiver can alert exactly once. */
+export declare const liveActivityNoticeSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodNumber;
+    task: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["session", "terminal"]>;
+        phase: z.ZodEnum<["waiting_for_approval", "waiting_for_input", "failed", "running", "starting", "completed", "stale"]>;
+        title: z.ZodString;
+        subtitle: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    }, {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    task: {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    };
+    createdAt: number;
+}, {
+    id: string;
+    task: {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    };
+    createdAt: number;
+}>;
+export type LiveActivityNotice = z.infer<typeof liveActivityNoticeSchema>;
+export declare const liveActivityContentSchema: z.ZodObject<{
+    phase: z.ZodEnum<["waiting_for_approval", "waiting_for_input", "failed", "running", "starting", "completed", "stale"]>;
+    title: z.ZodString;
+    subtitle: z.ZodString;
+    project: z.ZodString;
+    agent: z.ZodString;
+    agents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        role: z.ZodEnum<["allow", "reject", "always", "stop", "choice"]>;
+        kind: z.ZodEnum<["permission", "answer", "async-answer"]>;
+        computerKey: z.ZodString;
+        sessionId: z.ZodString;
+        requestId: z.ZodString;
+        optionId: z.ZodString;
+        questionId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "answer" | "permission" | "async-answer";
+        id: string;
+        role: "stop" | "choice" | "reject" | "allow" | "always";
+        requestId: string;
+        optionId: string;
+        label: string;
+        sessionId: string;
+        computerKey: string;
+        questionId?: string | undefined;
+    }, {
+        kind: "answer" | "permission" | "async-answer";
+        id: string;
+        role: "stop" | "choice" | "reject" | "allow" | "always";
+        requestId: string;
+        optionId: string;
+        label: string;
+        sessionId: string;
+        computerKey: string;
+        questionId?: string | undefined;
+    }>, "many">>;
+    hasMoreActions: z.ZodOptional<z.ZodBoolean>;
+    tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["session", "terminal"]>;
+        phase: z.ZodEnum<["waiting_for_approval", "waiting_for_input", "failed", "running", "starting", "completed", "stale"]>;
+        title: z.ZodString;
+        subtitle: z.ZodString;
+        project: z.ZodString;
+        agent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    }, {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    }>, "many">>;
+    noticeId: z.ZodOptional<z.ZodString>;
+    waitingCount: z.ZodNumber;
+    runningCount: z.ZodNumber;
+    failedCount: z.ZodNumber;
+    deepLink: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    agent: string;
+    phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+    subtitle: string;
+    project: string;
+    waitingCount: number;
+    runningCount: number;
+    failedCount: number;
+    deepLink: string;
+    agents?: string[] | undefined;
+    tasks?: {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    }[] | undefined;
+    actions?: {
+        kind: "answer" | "permission" | "async-answer";
+        id: string;
+        role: "stop" | "choice" | "reject" | "allow" | "always";
+        requestId: string;
+        optionId: string;
+        label: string;
+        sessionId: string;
+        computerKey: string;
+        questionId?: string | undefined;
+    }[] | undefined;
+    hasMoreActions?: boolean | undefined;
+    noticeId?: string | undefined;
+}, {
+    title: string;
+    agent: string;
+    phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+    subtitle: string;
+    project: string;
+    waitingCount: number;
+    runningCount: number;
+    failedCount: number;
+    deepLink: string;
+    agents?: string[] | undefined;
+    tasks?: {
+        title: string;
+        agent: string;
+        kind: "terminal" | "session";
+        id: string;
+        phase: "completed" | "failed" | "running" | "waiting_for_approval" | "waiting_for_input" | "starting" | "stale";
+        subtitle: string;
+        project: string;
+    }[] | undefined;
+    actions?: {
+        kind: "answer" | "permission" | "async-answer";
+        id: string;
+        role: "stop" | "choice" | "reject" | "allow" | "always";
+        requestId: string;
+        optionId: string;
+        label: string;
+        sessionId: string;
+        computerKey: string;
+        questionId?: string | undefined;
+    }[] | undefined;
+    hasMoreActions?: boolean | undefined;
+    noticeId?: string | undefined;
+}>;
+export type LiveActivityContentState = z.infer<typeof liveActivityContentSchema>;
+export interface LiveActivityPayload extends Partial<LiveActivityContentState> {
+    active: boolean;
+    computerName: string;
+    computerKey?: string;
+}
+export declare const liveActivityIdSchema: z.ZodString;
+export declare const liveActivitySubscriptionSchema: z.ZodObject<{
+    activityId: z.ZodString;
+    serviceUrl: z.ZodString;
+    grant: z.ZodString;
+    expiresAt: z.ZodNumber;
+    computerKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    computerKey: string;
+    activityId: string;
+    serviceUrl: string;
+    grant: string;
+    expiresAt: number;
+}, {
+    computerKey: string;
+    activityId: string;
+    serviceUrl: string;
+    grant: string;
+    expiresAt: number;
+}>;
+export type LiveActivitySubscription = z.infer<typeof liveActivitySubscriptionSchema>;
+export declare function liveActivityContent(payload: LiveActivityPayload): LiveActivityContentState;
+export declare const toolVerb: Record<ToolKind, string>;
+/** Drops the agent's own English verb and wrapping backticks from a tool title. */
+export declare function cleanToolTitle(title: string): string;
+/** Drops the shell wrapper and environment prefixes agents put around a command. */
+export declare function tidyCommand(command: string): string;
+export declare function activityText(activity: SessionActivity | undefined): string;
+export interface PermissionChoice {
+    option: PermissionOption;
+    label: string;
+    role: "allow" | "always" | "reject" | "stop";
+}
+/** Localized permission choices, in the order: reject, allow, then the rest. */
+export declare function permissionChoices(options: PermissionOption[]): PermissionChoice[];
+export declare function sessionTitle(session: Pick<SessionSummary, "title">): string;
+/** Markdown flattened to one line of plain text, for list previews. */
+export declare function plainPreview(text: string): string;
+/** Async questions need attention even while the agent keeps working. */
+export declare function needsUserInput(session: SessionSummary): boolean;
+export declare function needsAttention(session: SessionSummary): boolean;
+/**
+ * A start command as a one-line title. The UI font has no Nerd Font glyphs
+ * (private-use code points), which would show as boxes; the terminal itself
+ * draws them with its symbol font.
+ */
+export declare function commandTitle(command: string): string;
+/** How a terminal reads in a list: its title, what it's doing, and whether it has ended. */
+export declare function terminalState(terminal: TerminalInfo): {
+    title: string;
+    mono: boolean;
+    ended: boolean;
+    busy: boolean;
+    failed: boolean;
+    detail: string;
+};
+/** Classify a session into the 7-phase attention hierarchy (t3code model). */
+export declare function classifySessionPhase(session: SessionSummary, online?: boolean): AttentionPhase;
+export declare function phasePriority(phase: AttentionPhase): number;
+export declare function liveActivityActions(session: SessionSummary, computerKey: string): {
+    actions: LiveActivityAction[];
+    hasMoreActions: boolean;
+};
+/** Recheck against the connected host after waking the app, not the cached card. */
+export declare function isLiveActivityActionCurrent(action: LiveActivityAction, computerKey: string, session: SessionSummary | undefined, permissions?: PendingPermissionSummary[]): boolean;
+export declare function liveActivityDetailLink(computerKey: string, kind: "session" | "terminal", id: string): string;
+export declare function liveActivitySessionTask(session: SessionSummary, online?: boolean): LiveActivityTask;
+export declare function liveActivityTerminalTask(terminal: TerminalInfo, online?: boolean): LiveActivityTask;
+/**
+ * Builds the aggregated single-card iOS Live Activity / Dynamic Island payload
+ * for a computer. New progress brings its task and agent to the front together.
+ */
+export declare function buildLiveActivitySnapshot(computerName: string, sessions: SessionSummary[], terminals: TerminalInfo[], online: boolean, computerKey?: string, goals?: Record<string, {
+    status: string;
+    objective: string;
+}>): LiveActivityPayload;