@kortix/ui 0.14.12 → 0.14.14

package/dist/i18n/ui-catalog/remaining-ui-translation-keys.generated.js

@@ -1,5 +1,19 @@
 // Generated from the final user-visible i18n audit. Keys are SHA-256(message)[0:12].
 export const REMAINING_UI_TRANSLATION_KEYS = {
+    "trigger": 'text683259feabbf',
+    "New trigger": 'texta38f4ea67a30',
+    "Search triggers": 'textcf789cba73dc',
+    "No triggers yet": 'text362ec1f12075',
+    "Start agents or wake sessions on a schedule or an event.": 'text8fbb8c347fc0',
+    "Create a trigger and your agent runs on its own, no prompt needed.": 'texte9acea9f91da',
+    "Have an agent run when a change request merges.": 'text0e8f0fa67e67',
+    "change request trigger": 'text20c14db54300',
+    "New change request trigger": 'textb0d2b95916ce',
+    "Search change request triggers": 'textd025f8dc1334',
+    "No change request triggers yet": 'text1bc4d0bc8d03',
+    "Create one to have an agent run when a change request merges.": 'text3c11a07619e0',
+    "Change request merged": 'text5ffd973e20ed',
+    "Branch": 'text52656e8104ee',
     "Connector events": 'text0ba357fa63f8',
     "Connector event": 'textca395c4d19b2',
     "connector event": 'text6064256ee716',
@@ -11,7 +25,7 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     "New App event": 'text064694999e1f',
     "Search App events": 'text1934aa0740bb',
     "No App events yet": 'text25db7e5609e5',
-    "An App starts agents by emitting events. Add a trigger with on: { event, app } in kortix.yaml.": 'text9f8f92588517',
+    "Create one to have an agent run when one of your Apps sends an event.": 'textd85b56df2c94',
     Drive: 'text6312b4b9baf1',
     Drives: 'text729fe0e7b138',
     '{label} has finished.': 'text27d628c8b427',
@@ -213,9 +227,7 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'Every tool runs without asking. Only the rules below can stop one.': 'texta63fb2eebd02',
     'Everything an owner can do except deleting the account or transferring ownership. Also Manager on every project.': 'textc8ef36aed650',
     Expired: 'text424a2551d356',
-    'Moves kortix.toml or a version 2 kortix.yaml to version 3: the project registers skills, tools, commands and extensions, and each agent enables them by name. Refreshes platform-managed skills and opens a change request for review.': 'text7823a1f3af93',
     Extensions: 'textfe3436af86b4',
-    'Upgrade manifest to v3 (kortix.yaml)': 'text08edd5b6dcdc',
     Failed: 'text031a8f0f659d',
     Favicon: 'text4295528943df',
     'Fetching deals updated ≤ 7d': 'text5bae674104b6',
@@ -283,6 +295,7 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'Loading your workspace': 'text22cd35468c29',
     Logo: 'textd707dc2f1936',
     Logs: 'textea2100dc89ae',
+    Loops: 'textc08f99e3947d',
     Machine: 'text8f1cc42d7c1c',
     macOS: 'textaed6b7aa2a05',
     Manager: 'text8b2085f74dfa',
@@ -387,7 +400,6 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'Requests are checked against the saved secret .': 'textc6fbb4b00507',
     'research/': 'text2f80158a9d89',
     'Reserving your computer': 'texta7d795204fda',
-    Reminders: 'text7971dd752669',
     Review: 'textaff0766a5290',
     Revoked: 'textf6f738d04392',
     Routing: 'textbcba696f3eb1',
@@ -515,7 +527,6 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'your-company/': 'text7a9f6daee641',
     '. The session keeps its id; the sandbox is rebuilt.': 'text09a3bb2aced6',
     '· grant no longer matches an agent': 'textc795f93da2e5',
-    "(kortix_version 2) to edit this agent's instructions, model, tool permissions and access here.": 'text479d92cbfaa1',
     ') stops running and is removed.': 'text3109205d1fc7',
     '@ already has access to this repo': 'texta9ab51e18b56',
     '⌘S': 'text8cd003e6301b',
@@ -559,7 +570,6 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'Can edit': 'text5abe9e1fbc5b',
     'Can view': 'text151dc282a69e',
     'Change what can do in .': 'text8c4e24be27f2',
-    'Changes an agent makes to this workspace. Every run opens a change request for you to review — nothing merges on its own.': 'textc6414eb01d9a',
     'Clear notifications': 'texte6f312c6b6ef',
     'Clone address': 'textac830bd3c755',
     'Clone command': 'text6264f3bfdd91',
@@ -757,7 +767,6 @@ export const REMAINING_UI_TRANSLATION_KEYS = {
     'Try a different term.': 'textce18e358bf01',
     'Try adjusting the filters or clearing the search.': 'text0713dbee5126',
     'Unsaved changes.': 'textefa5855ff509',
-    Upgrades: 'texte02a5941602a',
     'Use the agent's usual model': 'text6960ac83d152',
     'Use your own Git client': 'textd29222de0472',
     'Uses the selected agent, project, or platform default.': 'text4eb861e5d86e',

package/dist/internal/auth/auth-primitives.d.ts

@@ -23,7 +23,7 @@ export declare function Rise({ delay, className, children, }: {
  * traffic lights and the frame's Back control.
  */
 export declare function AuthMobileLogo(): import("react").JSX.Element;
-export declare function StepHeader({ title, tagline, description, mark, markOnMobile, }: {
+export declare function StepHeader({ title, description, mark, markOnMobile, }: {
     /** A string, or a string led by a status mark (a decided approval). */
     title: React.ReactNode;
     /**
@@ -35,8 +35,6 @@ export declare function StepHeader({ title, tagline, description, mark, markOnMo
     /** Show the mark below `md` too. For a header outside `AuthFrame` (a modal),
      *  where no corner logo stands in for it on mobile. */
     markOnMobile?: boolean;
-    /** Second line in the same size as the title, dimmed (entry step only). */
-    tagline?: string;
     description?: React.ReactNode;
 }): import("react").JSX.Element;
 export declare function FieldLabel({ htmlFor, children }: {

package/dist/internal/auth/auth-primitives.js

@@ -41,8 +41,8 @@ export function AuthMobileLogo() {
     const tHardcodedUi = useTranslations('hardcodedUi');
     return (_jsx("div", { className: "kx-auth-mobile-logo absolute top-6 left-6 z-10 md:hidden", children: _jsx(Link, { href: "/", "aria-label": tHardcodedUi.raw('i18nComplete.text7ecec93ed268'), className: "hit-area-3 inline-flex", children: _jsx(KortixLogo, { variant: "icon", size: 22, className: "text-foreground" }) }) }));
 }
-export function StepHeader({ title, tagline, description, mark, markOnMobile = false, }) {
-    return (_jsxs("div", { className: "mb-10", children: [mark ? (_jsx("div", { className: markOnMobile ? undefined : 'hidden md:block', children: mark })) : (_jsx(KortixLogo, { variant: "icon", size: 22, className: "text-foreground hidden md:block" })), _jsx("h1", { className: cn('text-foreground text-2xl font-medium tracking-tight md:mt-6', mark && markOnMobile && 'mt-6'), children: title }), tagline ? (_jsx("p", { className: "text-muted-foreground text-2xl font-medium tracking-tight text-balance", children: tagline })) : null, description ? (_jsx("p", { className: "text-muted-foreground mt-2 text-sm text-pretty", children: description })) : null] }));
+export function StepHeader({ title, description, mark, markOnMobile = false, }) {
+    return (_jsxs("div", { className: "mb-10", children: [mark ? (_jsx("div", { className: markOnMobile ? undefined : 'hidden md:block', children: mark })) : (_jsx(KortixLogo, { variant: "icon", size: 22, className: "text-foreground hidden md:block" })), _jsx("h1", { className: cn('text-foreground text-2xl font-medium tracking-tight md:mt-6', mark && markOnMobile && 'mt-6'), children: title }), description ? (_jsx("p", { className: "text-muted-foreground mt-2 text-sm text-pretty", children: description })) : null] }));
 }
 export function FieldLabel({ htmlFor, children }) {
     return (_jsx("label", { htmlFor: htmlFor, className: "text-muted-foreground text-sm font-medium", children: children }));

package/dist/internal/billing/session-cost-format.d.ts

@@ -1,4 +1,5 @@
 /** @internal Kortix apps only. No semver: it may change in any release. */
 export declare function formatSessionCostCredits(value: number, locale?: string): string;
 export declare function formatSessionCostExactCredits(value: number, locale?: string): string;
+export declare function formatSessionCostUsd(value: number, locale?: string): string;
 export declare function formatSessionCostDuration(value: number): string;

package/dist/internal/billing/session-cost-format.js

@@ -15,6 +15,17 @@ export function formatSessionCostExactCredits(value, locale = 'en-US') {
         maximumFractionDigits: Math.abs(credits) < 10 ? 8 : 2,
     });
 }
+// The session usage view reads model spend in US dollars, the unit the ledger
+// stores. Two decimals from $1 up, up to four below, and `<$0.0001` for a
+// non-zero amount under that, so a cheap model's session never reads $0.00.
+const SMALLEST_USD = 0.0001;
+export function formatSessionCostUsd(value, locale = 'en-US') {
+    const usd = Number.isFinite(value) ? value : 0;
+    const format = (amount, maximumFractionDigits) => new Intl.NumberFormat(locale, { style: 'currency', currency: 'USD', minimumFractionDigits: 2, maximumFractionDigits }).format(amount);
+    if (usd !== 0 && Math.abs(usd) < SMALLEST_USD)
+        return `<${format(SMALLEST_USD, 4)}`;
+    return format(usd, Math.abs(usd) < 1 ? 4 : 2);
+}
 export function formatSessionCostDuration(value) {
     let remaining = Math.max(0, Math.floor(Number.isFinite(value) ? value : 0));
     const units = [

package/dist/internal/components/agent-mark.d.ts

@@ -17,7 +17,11 @@ export type AgentMarkSize = keyof typeof TILE;
  * Set on the element that paints the tile; `AgentMarkGlyph` reads `--mark-ink`.
  */
 export declare function agentMarkVars(slug: string): CSSProperties;
-/** The bare pixel figure, painted with `--mark-ink` from an ancestor. */
+/** The tile's boundary: a hairline on the Kortix tile, none on a tinted one. */
+export declare function agentMarkTileClass(slug: string): string | undefined;
+/** The bare pixel figure, painted with `--mark-ink` from an ancestor. A 7 × 7
+ *  mark fills `size`; a wider reserved grid (My Kortix's 12 × 10 symbol) keeps
+ *  whole-pixel cells, `floor(size / 12)` px each. */
 export declare function AgentMarkGlyph({ slug, size }: {
     slug: string;
     size: AgentMarkSize;
@@ -35,4 +39,11 @@ export declare function AgentMark({ slug, size, tile, label, className, }: {
     label?: string;
     className?: string;
 }): import("react").JSX.Element;
+/**
+ * An agent's name as a person reads it: My Kortix for the built-in agent,
+ * otherwise the manifest key in sentence case with its separators as spaces
+ * (`session-reviewer` → "Session reviewer"). One helper, so the sidebar, the
+ * agent page, the index and the hover hint name an agent the same way.
+ */
+export declare function agentDisplayName(slug: string): string;
 export {};

package/dist/internal/components/agent-mark.js

@@ -1,9 +1,9 @@
 'use client';
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from '../lib/utils.js';
 import { Hint } from '../../primitives/hint.js';
-import { capitalizeWords, isMetaAgentName, META_AGENT_DISPLAY_NAME } from '../../_vendor/kortix-shared.js';
-import { PIXEL_MARK_SIZE, pixelMark } from '../lib/pixel-mark.js';
+import { isMyKortixAgentName, MY_KORTIX_DISPLAY_NAME } from '../../_vendor/kortix-shared.js';
+import { pixelMark } from '../lib/pixel-mark.js';
 /** Mark size → tile size. The mark is a multiple of 7, so each pixel lands on
  *  whole device pixels; any other size blurs the edges. Literal px because
  *  this repo's spacing scale is 0.23rem (`size-14` is 51.5px, not 56px). */
@@ -15,17 +15,31 @@ const TILE = { 14: 20, 21: 28, 28: 40, 42: 56, 56: 80 };
  */
 export function agentMarkVars(slug) {
     const { tone } = pixelMark(slug);
+    // The Kortix tile (My Kortix, the starter `kortix` agent) follows the Kortix
+    // tile rule: the page surface with a hairline, never an inverted black tile
+    // (decisions.md #8421). `agentMarkTileClass` adds the hairline.
+    if (tone.name === 'brand') {
+        return { '--mark-tile': 'var(--background)', '--mark-ink': 'var(--foreground)' };
+    }
     return {
         '--mark-tile': `light-dark(${tone.tile}, ${tone.tileDark})`,
         '--mark-ink': `light-dark(${tone.ink}, ${tone.inkDark})`,
     };
 }
-/** The bare pixel figure, painted with `--mark-ink` from an ancestor. */
+/** The tile's boundary: a hairline on the Kortix tile, none on a tinted one. */
+export function agentMarkTileClass(slug) {
+    return pixelMark(slug).tone.name === 'brand' ? 'ring-1 ring-inset ring-border' : undefined;
+}
+/** The bare pixel figure, painted with `--mark-ink` from an ancestor. A 7 × 7
+ *  mark fills `size`; a wider reserved grid (My Kortix's 12 × 10 symbol) keeps
+ *  whole-pixel cells, `floor(size / 12)` px each. */
 export function AgentMarkGlyph({ slug, size }) {
-    return (_jsx("svg", { "aria-hidden": true, width: size, height: size, 
+    const mark = pixelMark(slug);
+    const cell = mark.width === 7 ? size / 7 : Math.max(1, Math.floor(size / 12));
+    return (_jsxs("svg", { "aria-hidden": true, width: mark.width * cell, height: mark.height * cell, viewBox: `0 0 ${mark.width} ${mark.height}`, 
         // Inline, so a host's `[&_svg]:size-4` default (menu rows) cannot rescale
-        // the 7-pixel grid off whole device pixels.
-        style: { width: size, height: size }, viewBox: `0 0 ${PIXEL_MARK_SIZE} ${PIXEL_MARK_SIZE}`, shapeRendering: "crispEdges", className: "shrink-0", children: _jsx("path", { d: pixelMark(slug).path, className: "fill-(--mark-ink)" }) }));
+        // the pixel grid off whole device pixels.
+        style: { width: mark.width * cell, height: mark.height * cell }, shapeRendering: "crispEdges", className: "shrink-0", children: [_jsx("path", { d: mark.path, className: "fill-(--mark-ink)" }), mark.ditherPath ? (_jsx("path", { d: mark.ditherPath, className: "fill-(--mark-ink)", opacity: 0.5 })) : null] }));
 }
 /**
  * An agent's pixel mark on its tile — the agent's face wherever it appears:
@@ -33,9 +47,18 @@ export function AgentMarkGlyph({ slug, size }) {
  */
 export function AgentMark({ slug, size = 14, tile = TILE[size], label, className, }) {
     // A mark is a face, not a name: the hover hint says whose face it is.
-    const mark = (_jsx("span", { "aria-hidden": true, "data-slot": "agent-mark", style: { ...agentMarkVars(slug), width: tile, height: tile }, className: cn('inline-flex shrink-0 items-center justify-center bg-(--mark-tile)', size >= 28 ? 'rounded-md' : 'rounded-sm', className), children: _jsx(AgentMarkGlyph, { slug: slug, size: size }) }));
-    return (_jsx(Hint, { side: "top", sideOffset: 6, alignOffset: 0, label: label ?? agentLabel(slug), children: mark }));
+    const mark = (_jsx("span", { "aria-hidden": true, "data-slot": "agent-mark", style: { ...agentMarkVars(slug), width: tile, height: tile }, className: cn('inline-flex shrink-0 items-center justify-center bg-(--mark-tile)', size >= 28 ? 'rounded-md' : 'rounded-sm', agentMarkTileClass(slug), className), children: _jsx(AgentMarkGlyph, { slug: slug, size: size }) }));
+    return (_jsx(Hint, { side: "top", sideOffset: 6, alignOffset: 0, label: label ?? agentDisplayName(slug), children: mark }));
 }
-function agentLabel(slug) {
-    return isMetaAgentName(slug) ? META_AGENT_DISPLAY_NAME : capitalizeWords(slug);
+/**
+ * An agent's name as a person reads it: My Kortix for the built-in agent,
+ * otherwise the manifest key in sentence case with its separators as spaces
+ * (`session-reviewer` → "Session reviewer"). One helper, so the sidebar, the
+ * agent page, the index and the hover hint name an agent the same way.
+ */
+export function agentDisplayName(slug) {
+    if (isMyKortixAgentName(slug))
+        return MY_KORTIX_DISPLAY_NAME;
+    const words = slug.replace(/[-_]+/g, ' ').trim();
+    return words.charAt(0).toUpperCase() + words.slice(1);
 }

package/dist/internal/components/nav-rail.d.ts

@@ -0,0 +1,22 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+/**
+ * The one left-rail recipe: Project admin and the agent page. A rail is
+ * vertical `Tabs` whose rows are real links (the section is URL state),
+ * grouped under muted labels in the account hub's dialect
+ * (`account-settings-sidebar.tsx`).
+ */
+import type { ReactNode } from 'react';
+/**
+ * Each group is its own labelled tablist: arrow keys move inside a group, Tab
+ * moves to the next one. `after` sits below the list, outside it: a link that
+ * is not a tab. A group without `label` draws no heading.
+ */
+export declare function RailGroup({ label, children, after }: {
+    label?: string;
+    children: ReactNode;
+    after?: ReactNode;
+}): import("react").JSX.Element;
+/** A rail row: pass to `TabsTrigger` with `size="md"`. */
+export declare const RAIL_ROW_CLASS: string;
+/** The same row on the narrow-screen horizontal strip. */
+export declare const RAIL_HORIZONTAL_ROW_CLASS = "w-auto shrink-0 gap-2.5 px-3 py-0.75 whitespace-nowrap";

package/dist/internal/components/nav-rail.js

@@ -0,0 +1,16 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../lib/utils.js';
+import { TabsList } from '../../primitives/tabs.js';
+/**
+ * Each group is its own labelled tablist: arrow keys move inside a group, Tab
+ * moves to the next one. `after` sits below the list, outside it: a link that
+ * is not a tab. A group without `label` draws no heading.
+ */
+export function RailGroup({ label, children, after }) {
+    return (_jsxs("div", { children: [label ? _jsx("p", { className: "text-muted-foreground flex h-8 items-center px-2.5 text-xs font-medium", children: label }) : null, _jsx(TabsList, { orientation: "vertical", "aria-label": label, className: "w-full", children: children }), after] }));
+}
+/** A rail row: pass to `TabsTrigger` with `size="md"`. */
+export const RAIL_ROW_CLASS = cn('gap-2 px-2.5 py-1 font-normal transition-none has-[>svg]:px-2.5', 'text-foreground data-[state=inactive]:text-foreground hover:bg-hover hover:text-foreground', 'data-[state=active]:bg-active data-[state=active]:font-medium', '[&_svg]:text-muted-foreground data-[state=active]:[&_svg]:text-foreground');
+/** The same row on the narrow-screen horizontal strip. */
+export const RAIL_HORIZONTAL_ROW_CLASS = 'w-auto shrink-0 gap-2.5 px-3 py-0.75 whitespace-nowrap';

package/dist/internal/components/repository-disconnected.js

@@ -19,7 +19,7 @@ import { PlugsIcon } from '@phosphor-icons/react';
 import { useQuery } from '@tanstack/react-query';
 import { useState } from 'react';
 import { useTranslations } from '../../i18n/index.js';
-import { customizePath } from '../../lib/routes.js';
+import { adminPath } from '../../lib/routes.js';
 import { Button } from '../../primitives/button.js';
 import { InfoBanner } from '../../primitives/info-banner.js';
 import Loading from '../../primitives/loading.js';
@@ -62,7 +62,7 @@ export function ReconnectGitHubButton({ projectId, className }) {
             if (state.install_url)
                 window.open(state.install_url, '_blank', 'noopener,noreferrer');
             else
-                window.location.assign(customizePath(projectId, 'settings?section=git'));
+                window.location.assign(adminPath(projectId, 'git'));
         }
         catch {
             errorToast(t('reconnectError'));

package/dist/internal/goals/goal-meta.d.ts

@@ -21,8 +21,22 @@ export declare function goalProgress(goal: ProjectGoalDocument | null): {
 };
 /** Open asks for a person (not the agent): what the goal waits on someone for. */
 export declare function goalOpenAsks(goal: ProjectGoalDocument | null): ProjectGoalItem[];
-/** The goal needs a person: an open ask, or a health issue. */
+/** The goal waits on a person: its state is `waiting_on_user`, or it has an open ask. */
 export declare function goalNeedsYou(goal: ProjectGoal): boolean;
+/** The goal runs into a problem no person was asked about: a health issue (no heartbeat, a failed wake, …). */
+export declare function goalNeedsAttention(goal: ProjectGoal): boolean;
+/** When the goal last woke: the heartbeat's last run, else the wake GOAL.md records. */
+export declare function goalLastWake(goal: Pick<ProjectGoal, 'goal' | 'heartbeat'>): string | null;
+/** Who a goal is for, by name: "You", the member's email, else "A teammate". */
+export declare function useGoalPerson(projectId: string): (userId: string | null | undefined) => string | null;
+/**
+ * Start a goal from its outcome: a new session whose first message is the
+ * outcome plus `MAKE_GOAL_PROMPT`, so the agent writes GOAL.md and its done
+ * criteria.
+ */
+export declare function useStartGoal(projectId: string): (outcome: string) => void;
+/** The goal is for this person (GOAL.md `assigned_user`). */
+export declare function goalAssignedTo(goal: Pick<ProjectGoal, 'goal'>, userId: string | null | undefined): boolean;
 /** "in 33 min", "2 hr ago", "Tue 09:00": the reminders time format. */
 export declare function formatGoalTime(iso: string | null | undefined, locale: string, now: number): string;
 export declare function goalHref(projectId: string, goal: Pick<ProjectGoal, 'scope' | 'slug'>): string | null;

package/dist/internal/goals/goal-meta.js

@@ -4,6 +4,12 @@ import { formatFireTime } from '../reminders/reminder-format.js';
 import { useTranslations } from '../../i18n/index.js';
 import { StatusBadge, StatusDot } from '../../primitives/status.js';
 import { uiRoutes } from '../../lib/routes.js';
+import { useUiViewerId } from '../../providers/ui-provider.js';
+import { useAccountMembers } from '../account-hub/use-account-members.js';
+import { useNewProjectSession } from '../hooks/projects/use-new-project-session.js';
+import { MAKE_GOAL_PROMPT } from '@kortix/sdk';
+import { useProjectAccountId } from '@kortix/sdk/react';
+import { useCallback, useMemo } from 'react';
 const STATUS_TONE = {
     draft: 'neutral',
     active: 'info',
@@ -11,6 +17,7 @@ const STATUS_TONE = {
     waiting_external: 'neutral',
     verifying: 'info',
     done: 'success',
+    stopped: 'neutral',
     abandoned: 'neutral',
 };
 export function GoalStatusBadge({ status }) {
@@ -39,9 +46,42 @@ export function goalProgress(goal) {
 export function goalOpenAsks(goal) {
     return (goal?.items ?? []).filter((i) => i.kind === 'ask' && i.status === 'open' && i.owner !== 'agent');
 }
-/** The goal needs a person: an open ask, or a health issue. */
+/** The goal waits on a person: its state is `waiting_on_user`, or it has an open ask. */
 export function goalNeedsYou(goal) {
-    return goal.health.state === 'attention' || (goal.health.state !== 'closed' && goalOpenAsks(goal.goal).length > 0);
+    if (goal.health.state === 'closed')
+        return false;
+    return goal.goal?.status === 'waiting_on_user' || goalOpenAsks(goal.goal).length > 0;
+}
+/** The goal runs into a problem no person was asked about: a health issue (no heartbeat, a failed wake, …). */
+export function goalNeedsAttention(goal) {
+    return goal.health.state === 'attention' && !goalNeedsYou(goal);
+}
+/** When the goal last woke: the heartbeat's last run, else the wake GOAL.md records. */
+export function goalLastWake(goal) {
+    return goal.heartbeat?.last_fired_at ?? goal.goal?.last_wake_at ?? null;
+}
+/** Who a goal is for, by name: "You", the member's email, else "A teammate". */
+export function useGoalPerson(projectId) {
+    const t = useTranslations('goals');
+    const viewerId = useUiViewerId();
+    const members = useAccountMembers(useProjectAccountId(projectId) ?? undefined);
+    const emails = useMemo(() => new Map((members.data ?? []).map((m) => [m.user_id, m.email])), [members.data]);
+    return useCallback((userId) => !userId ? null : userId === viewerId ? t('you') : (emails.get(userId) ?? t('anotherMember')), [emails, viewerId, t]);
+}
+/**
+ * Start a goal from its outcome: a new session whose first message is the
+ * outcome plus `MAKE_GOAL_PROMPT`, so the agent writes GOAL.md and its done
+ * criteria.
+ */
+export function useStartGoal(projectId) {
+    const newSession = useNewProjectSession(projectId);
+    return useCallback((outcome) => newSession({
+        create: { pending_prompt: { text: `${outcome.trim()}\n\n${MAKE_GOAL_PROMPT}`, agent: null, model: null, variant: null } },
+    }), [newSession]);
+}
+/** The goal is for this person (GOAL.md `assigned_user`). */
+export function goalAssignedTo(goal, userId) {
+    return !!userId && goal.goal?.assigned_user === userId;
 }
 /** "in 33 min", "2 hr ago", "Tue 09:00": the reminders time format. */
 export function formatGoalTime(iso, locale, now) {

package/dist/internal/hooks/projects/use-agent-config.d.ts

@@ -8,7 +8,7 @@
  * reflects the fresh manifest.
  */
 import { type QueryClient } from '@tanstack/react-query';
-import { type AgentConfigBlock, type AgentConfigResponse, updateAgentConfig } from '@kortix/sdk';
+import { type AgentConfigBlock, updateAgentConfig } from '@kortix/sdk';
 export declare function agentConfigQueryKey(projectId: string, agentName: string): readonly ["agent-config", string, string];
 /**
  * Keyed on the route's agent name, not on project-detail having listed it, so
@@ -25,6 +25,7 @@ export declare function useAgentConfig(projectId: string | undefined, agentName:
     default_agent: string | null;
     harness?: string;
     ignored_settings?: string[];
+    builtin?: "my_kortix";
 }, Error>;
 /**
  * Start the agent page's config read before the navigation, on card intent.
@@ -32,12 +33,6 @@ export declare function useAgentConfig(projectId: string | undefined, agentName:
  * it; a fresh entry is not read again.
  */
 export declare function prefetchAgentConfig(queryClient: QueryClient, projectId: string, agentName: string): void;
-/**
- * The agent page offers the manifest upgrade only on a v1 project, where the
- * full editor does not exist. A v2 or v3 manifest is editable (the server
- * answers `editable`); a read-only v3 answer never reads as "upgrade to v2".
- */
-export declare function agentConfigNeedsUpgrade(response: AgentConfigResponse | undefined): boolean;
 type AgentConfigSaveResponse = Awaited<ReturnType<typeof updateAgentConfig>>;
 export declare function applyAgentConfigSaveResponse(queryClient: QueryClient, projectId: string, agentName: string, response: AgentConfigSaveResponse): void;
 export declare function useUpdateAgentConfig(projectId: string, agentName: string): import("@tanstack/react-query").UseMutationResult<{
@@ -46,4 +41,13 @@ export declare function useUpdateAgentConfig(projectId: string, agentName: strin
     agent: string;
     schema_version: number;
 }, Error, AgentConfigBlock, unknown>;
+export declare function agentCapabilitiesQueryKey(projectId: string, agentName: string): readonly ["agent-capabilities", string, string];
+/**
+ * The project's catalog: every tool, skill and extension any agent can be
+ * given (`getProjectCapabilities`). Under the project's key, so adding or
+ * removing a skill refreshes it. An agent's grants stay in its draft.
+ */
+export declare function useProjectCapabilities(projectId: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<import("@kortix/sdk").ProjectCapabilities, Error>;
+/** Every tool, skill and extension the agent can have (`getAgentCapabilities`). The grants stay in the draft. */
+export declare function useAgentCapabilities(projectId: string, agentName: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<import("@kortix/sdk").AgentCapabilities, Error>;
 export {};

package/dist/internal/hooks/projects/use-agent-config.js

@@ -8,8 +8,8 @@
  * reflects the fresh manifest.
  */
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
-import { getAgentConfig, updateAgentConfig, } from '@kortix/sdk';
-import { contract, invalidateProject } from '@kortix/sdk/react';
+import { getAgentCapabilities, getAgentConfig, getProjectCapabilities, updateAgentConfig, } from '@kortix/sdk';
+import { contract, invalidateProject, qk } from '@kortix/sdk/react';
 export function agentConfigQueryKey(projectId, agentName) {
     return ['agent-config', projectId, agentName];
 }
@@ -40,19 +40,11 @@ export function prefetchAgentConfig(queryClient, projectId, agentName) {
         ...contract('config'),
     });
 }
-/**
- * The agent page offers the manifest upgrade only on a v1 project, where the
- * full editor does not exist. A v2 or v3 manifest is editable (the server
- * answers `editable`); a read-only v3 answer never reads as "upgrade to v2".
- */
-export function agentConfigNeedsUpgrade(response) {
-    return response !== undefined && response.editable !== true && response.schema_version === 1;
-}
 export function applyAgentConfigSaveResponse(queryClient, projectId, agentName, response) {
     queryClient.setQueryData(agentConfigQueryKey(projectId, agentName), (current) => ({
         agent: response.agent,
         schema_version: response.schema_version,
-        // A save succeeds only on an editable manifest (v2 or v3); the server decides.
+        // A save succeeds only on an editable manifest; the server decides.
         editable: current?.editable ?? true,
         default_agent: current?.default_agent ?? null,
         block: response.block,
@@ -71,3 +63,28 @@ export function useUpdateAgentConfig(projectId, agentName) {
         },
     });
 }
+export function agentCapabilitiesQueryKey(projectId, agentName) {
+    return ['agent-capabilities', projectId, agentName];
+}
+/**
+ * The project's catalog: every tool, skill and extension any agent can be
+ * given (`getProjectCapabilities`). Under the project's key, so adding or
+ * removing a skill refreshes it. An agent's grants stay in its draft.
+ */
+export function useProjectCapabilities(projectId, enabled = true) {
+    return useQuery({
+        queryKey: [...qk.project.scope(projectId), 'capabilities'],
+        queryFn: () => getProjectCapabilities(projectId),
+        enabled: enabled && !!projectId,
+        ...contract('config'),
+    });
+}
+/** Every tool, skill and extension the agent can have (`getAgentCapabilities`). The grants stay in the draft. */
+export function useAgentCapabilities(projectId, agentName, enabled = true) {
+    return useQuery({
+        queryKey: agentCapabilitiesQueryKey(projectId, agentName),
+        queryFn: () => getAgentCapabilities(projectId, agentName),
+        enabled: enabled && !!projectId && !!agentName,
+        ...contract('config'),
+    });
+}

package/dist/internal/hooks/use-slash-focus.d.ts

@@ -11,5 +11,11 @@ export declare function isSlashFocusKey(event: Pick<KeyboardEvent, 'key' | 'meta
  * A page whose search field is its main control: the field is focused on
  * arrival, and "/" jumps back to it from anywhere on the page except another
  * text field. `enabled` turns both off while the field is not on screen.
+ * `focusOnArrival: false` keeps only the "/" key, for a page whose search is
+ * not its main control (the Agents index). A field inside an embedded resource
+ * screen (`[data-capability-embed]`, the agent page) is never focused on
+ * arrival either: there the screen is one view among the agent's tabs.
  */
-export declare function useSlashFocus(ref: RefObject<HTMLInputElement | null>, enabled?: boolean): void;
+export declare function useSlashFocus(ref: RefObject<HTMLInputElement | null>, enabled?: boolean, { focusOnArrival }?: {
+    focusOnArrival?: boolean;
+}): void;

package/dist/internal/hooks/use-slash-focus.js

@@ -18,13 +18,19 @@ export function isSlashFocusKey(event, openLayer) {
  * A page whose search field is its main control: the field is focused on
  * arrival, and "/" jumps back to it from anywhere on the page except another
  * text field. `enabled` turns both off while the field is not on screen.
+ * `focusOnArrival: false` keeps only the "/" key, for a page whose search is
+ * not its main control (the Agents index). A field inside an embedded resource
+ * screen (`[data-capability-embed]`, the agent page) is never focused on
+ * arrival either: there the screen is one view among the agent's tabs.
  */
-export function useSlashFocus(ref, enabled = true) {
+export function useSlashFocus(ref, enabled = true, { focusOnArrival = true } = {}) {
     useEffect(() => {
         if (!enabled || typeof window === 'undefined')
             return;
         // No autofocus on touch: it would open the on-screen keyboard on arrival.
-        if (window.matchMedia?.('(pointer: fine)').matches) {
+        if (focusOnArrival &&
+            !ref.current?.closest('[data-capability-embed]') &&
+            window.matchMedia?.('(pointer: fine)').matches) {
             ref.current?.focus({ preventScroll: true });
         }
         const onKeyDown = (event) => {
@@ -40,5 +46,5 @@ export function useSlashFocus(ref, enabled = true) {
         };
         window.addEventListener('keydown', onKeyDown);
         return () => window.removeEventListener('keydown', onKeyDown);
-    }, [ref, enabled]);
+    }, [ref, enabled, focusOnArrival]);
 }

package/dist/internal/layout/project-capability-nav.d.ts

@@ -0,0 +1,24 @@
+/** @internal Kortix apps only. No semver: it may change in any release. */
+import { useProjectConfig } from '@kortix/sdk/react';
+type Agent = NonNullable<ReturnType<typeof useProjectConfig>>['agents'][number];
+export declare const NewAgentContext: import("react").Context<(() => void) | null>;
+/** Opens the New agent modal mounted beside the sidebar; null outside `NewAgentModalProvider`. */
+export declare function useOpenNewAgent(): (() => void) | null;
+/** Every agent by display name, hidden agents last. */
+export declare function sortCustomizeAgents<T extends Pick<Agent, 'name'> & {
+    hidden?: boolean | null;
+}>(agents: readonly T[]): T[];
+/** Whether the pathname is a Project admin (Settings) page. The locale prefix
+ *  the host may not strip is tolerated. */
+export declare function isProjectAdminPath(pathname: string | null | undefined): boolean;
+/**
+ * What Customize opens to, kept short on purpose: most configuration happens
+ * by asking an agent in a session, so the sidebar lists only the agents you
+ * pinned (none pinned: the first five) and All agents when more exist, then Review (with its "needs you" count), Models, and Settings
+ * (Project admin, whose top bar holds every library and Members).
+ * The header's + and All agents buttons sit on the Customize row itself.
+ */
+export declare function ProjectCapabilityNav({ projectId }: {
+    projectId: string;
+}): import("react").JSX.Element | null;
+export {};