@tangle-network/agent-app 0.16.1 → 0.19.0

package/dist/skills/index.d.ts

@@ -0,0 +1,136 @@
+import { AgentProfileFileMount } from '@tangle-network/sandbox';
+
+/**
+ * Unified skill + corpus mounter for agent products.
+ *
+ * Every agent product hand-rolls the same two file-mount systems and then
+ * drifts on the seams between them. (1) An ALWAYS-MOUNTED markdown corpus —
+ * (`skills/<slug>/SKILL.md`, `doctrine` and `knowledge` markdown trees) — discovered
+ * by a Vite `?raw` glob in the Worker bundle and by Node `fs` under the eval
+ * CLI, then projected into `resources.files`. (2) A TIER-GATED installable
+ * registry — a hand-authored array of `SkillEntry` whose free tier mounts at
+ * the harness skill-discovery path and whose paid tier is installed on demand.
+ * Both ride the same `resources.files` channel but use different provenance
+ * (file-backed vs inline), different mount paths (relative corpus path vs
+ * `~/.claude/skills/<id>/SKILL.md`), and different selection rules. This module
+ * makes both DATA: a corpus loader that accepts a Vite glob-result map (or an
+ * fs fallback), a registry adapter that tier-gates, and a single
+ * `composeShellResources` that projects either onto the SDK file-mount shape.
+ *
+ * Substrate-free over storage, exact over the SDK boundary: the only inbound
+ * seam is the glob-result map the consumer passes in (its call site keeps the
+ * literal `import.meta.glob` Vite must static-analyze); the only outbound seam
+ * is `@tangle-network/sandbox`'s `AgentProfileFileMount[]`, the exact shape the
+ * agent profile's `resources.files` consumes. Node builtins are resolved lazily
+ * via `process.getBuiltinModule` so a static `node:*` import never reaches the
+ * Vite SSR bundle.
+ */
+
+/** A Vite eager `?raw` glob result: glob key -> raw file body. The consumer
+ *  produces this by calling `import.meta.glob('<lit>', { eager: true, query:
+ *  '?raw', import: 'default' })` at its own call site — the literal must stay
+ *  literal so Vite can static-analyze it; passing the result here keeps that
+ *  constraint at the edge and the loader substrate-free. */
+type GlobModules = Record<string, string>;
+/** One markdown document discovered from the corpus. */
+interface CorpusEntry {
+    /** Slug derived from the glob key (folder slug for `SKILL.md` layouts, or the
+     *  normalized relative path for flat `*.md` layouts). */
+    id: string;
+    /** Glob/fs key the entry was loaded from, normalized to a stable relative
+     *  form (leading `./` and absolute prefixes stripped). */
+    key: string;
+    /** Raw markdown body (including any frontmatter). */
+    content: string;
+}
+/** A hand-authored, tier-gated installable skill. Mirrors the per-product
+ *  registry entry (gtm/insurance `SkillEntry`); the runtime's certified `skill`
+ *  artifact kind is unrelated. `skillMd` is the inline body — file provenance
+ *  does not apply to the registry. */
+interface SkillEntry {
+    id: string;
+    name: string;
+    description: string;
+    author?: {
+        name: string;
+        url?: string;
+    };
+    source?: string;
+    category?: string;
+    tags?: string[];
+    /** Gate keyword. `composeShellResources`/`registrySkills` treat `free` as
+     *  always-mounted; everything else is install-on-demand. */
+    tier: string;
+    skillMd: string;
+}
+/** Harness skill-discovery path the Claude Code / OpenCode backend reads
+ *  natively. The registry mounts here; the corpus mounts at its relative path. */
+declare function skillMountPath(id: string): string;
+/** Options for {@link loadMarkdownCorpus}. */
+interface LoadCorpusOptions {
+    /** The anchor folder name that appears in both glob keys and fs paths
+     *  (`skills`, `doctrine`, `knowledge`). Used to normalize keys + derive ids. */
+    anchor: string;
+    /** Vite glob-result map. When present and non-empty it is authoritative and
+     *  the fs path is skipped. Omit it (or pass an empty map) only outside Vite. */
+    globModules?: GlobModules;
+    /** Absolute or `import.meta.url`-relative base dir the fs fallback walks when
+     *  `globModules` is empty. Required for the fs path to run; without it the fs
+     *  fallback returns no entries (Workers never need it). */
+    fsBaseDir?: string;
+    /** Walk strategy for the fs fallback. `nested` finds `<dir>/<slug>/SKILL.md`
+     *  one level deep; `flat` recurses for every `*.md`. Default: `flat`. */
+    fsLayout?: 'nested' | 'flat';
+    /** Drop an entry by its normalized key after load. Covers the per-product
+     *  skip lists (corpus index/log files, scaffold templates, allow-lists). */
+    skip?: (normalizedKey: string) => boolean;
+}
+/** Outcome of {@link loadMarkdownCorpus}: the entries plus which path produced
+ *  them, so a caller can fail loud when both are empty rather than silently
+ *  mounting nothing. */
+interface CorpusLoadResult {
+    source: 'vite' | 'fs' | 'empty';
+    entries: CorpusEntry[];
+}
+/**
+ * Load a markdown corpus, preferring a Vite glob-result map and falling back to
+ * a Node fs walk. Selection is by non-empty glob result — never an env flag.
+ * Entries are normalized, optionally skip-filtered, and sorted by id for
+ * determinism. The `import.meta.glob` literal stays at the CONSUMER call site
+ * (passed in as `globModules`); this loader never constructs a glob.
+ */
+declare function loadMarkdownCorpus(options: LoadCorpusOptions, importMetaUrl?: string): CorpusLoadResult;
+/** Project corpus entries onto SDK file mounts at a relative path under
+ *  `<anchor>/`. Always-mounted: the corpus is the agent's baseline knowledge. */
+declare function corpusSkills(corpus: CorpusEntry[], anchor: string): AgentProfileFileMount[];
+/** Project the registry's free-tier (or `tier`-matched) entries onto SDK file
+ *  mounts at the harness skill-discovery path. Tier-gating is the registry's
+ *  only selection rule — paid skills are installed on demand, not at boot. */
+declare function registrySkills(registry: SkillEntry[], tier?: string): AgentProfileFileMount[];
+/** Inputs to {@link composeShellResources}. Each channel is optional so a
+ *  product mounts only the systems it has — corpus-only, registry-only, or
+ *  both — without conflating them. */
+interface ComposeShellResourcesInput {
+    /** Corpus mounts (always-mounted baseline). Pass the result of
+     *  {@link corpusSkills}, or a hand-built mount list. */
+    skills?: AgentProfileFileMount[];
+    /** Knowledge-corpus mounts (a second always-mounted corpus, e.g. a domain
+     *  knowledge pack distinct from the skills corpus). */
+    knowledge?: AgentProfileFileMount[];
+    /** Evolvable / learned-guidance mounts (single-file corpora). */
+    evolvable?: AgentProfileFileMount[];
+    /** Registry mounts (tier-gated). Pass the result of {@link registrySkills}. */
+    registry?: AgentProfileFileMount[];
+    /** Final skip filter applied to the composed mount list by mount `path`. */
+    predicate?: (mount: AgentProfileFileMount) => boolean;
+}
+/**
+ * Compose every mount channel into one `resources.files`-ready array. Corpus
+ * channels come first (baseline), the tier-gated registry last (so a registry
+ * entry can override a corpus entry that mounts at the same path). The result
+ * is exactly `AgentProfileFileMount[]` — assign it straight into
+ * `profile.resources.files` with no cast.
+ */
+declare function composeShellResources(input: ComposeShellResourcesInput): AgentProfileFileMount[];
+
+export { type ComposeShellResourcesInput, type CorpusEntry, type CorpusLoadResult, type GlobModules, type LoadCorpusOptions, type SkillEntry, composeShellResources, corpusSkills, loadMarkdownCorpus, registrySkills, skillMountPath };

package/dist/skills/index.js

@@ -0,0 +1,15 @@
+import {
+  composeShellResources,
+  corpusSkills,
+  loadMarkdownCorpus,
+  registrySkills,
+  skillMountPath
+} from "../chunk-KOG473C4.js";
+export {
+  composeShellResources,
+  corpusSkills,
+  loadMarkdownCorpus,
+  registrySkills,
+  skillMountPath
+};
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/tools/index.d.ts

@@ -1,7 +1,8 @@
-import { b as AppToolName, f as ToolHeaderNames } from '../mcp-eZCmkgCF.js';
-export { A as APP_TOOL_NAMES, a as AppToolMcpServer, c as AuthenticateOptions, B as BuildHttpMcpServerOptions, d as BuildMcpServerOptions, D as DEFAULT_APP_TOOL_PATHS, e as DEFAULT_HEADER_NAMES, O as OpenAIFunctionTool, T as ToolAuthResult, g as authenticateToolRequest, h as buildAppToolMcpServer, i as buildAppToolOpenAITools, j as buildHttpMcpServer, k as isAppToolName, r as readToolArgs } from '../mcp-eZCmkgCF.js';
+import { a as AppToolName, c as ToolHeaderNames } from '../auth-BlS9GWfL.js';
+export { A as APP_TOOL_NAMES, b as AuthenticateOptions, D as DEFAULT_HEADER_NAMES, O as OpenAIFunctionTool, T as ToolAuthResult, d as authenticateToolRequest, e as buildAppToolOpenAITools, i as isAppToolName, r as readToolArgs } from '../auth-BlS9GWfL.js';
 import { f as AppToolTaxonomy, c as AppToolHandlers, b as AppToolContext, e as AppToolProducedEvent, d as AppToolOutcome } from '../types-2rOJo8Hc.js';
 export { A as AddCitationArgs, a as AddCitationResult, R as RenderUiArgs, g as RenderUiResult, S as ScheduleFollowupArgs, h as ScheduleFollowupResult, i as SubmitProposalArgs, j as SubmitProposalResult } from '../types-2rOJo8Hc.js';
+export { A as AppToolMcpServer, B as BuildHttpMcpServerOptions, a as BuildMcpServerOptions, D as DEFAULT_APP_TOOL_PATHS, b as buildAppToolMcpServer, c as buildHttpMcpServer } from '../mcp-BShTlESm.js';
 export { C as CreateMcpToolHandlerOptions, M as MCP_PROTOCOL_VERSIONS, a as McpProtocolVersion, b as McpServerInfo, c as McpToolDefinition, d as createMcpToolHandler } from '../mcp-rpc-DLw_r9PQ.js';
 
 /** A correctable bad-input error a tool handler throws; the HTTP layer maps it

package/dist/web-react/index.d.ts

@@ -197,6 +197,42 @@ interface AgentActivityPanelProps {
  */
 declare function AgentActivityPanel({ fetchActivity, renderMissionRef, title, emptyLabel }: AgentActivityPanelProps): react.JSX.Element;
 
+/**
+ * `SeatPaywall` — the shared "unlock this product" screen every agent app
+ * shows when a user has no active seat and has spent past the free tier. One
+ * component, adopted by all five products (gtm / creative / tax / legal /
+ * insurance) in ~2 lines.
+ *
+ * Copy contract (design §6.8): the included monthly AI usage is framed as a
+ * BENEFIT the buyer receives — never the ratio, never the word "margin", never
+ * "we debit 50%". Surface the allowance, hide the economics.
+ *
+ * Styling contract matches the rest of `web-react`: Tailwind classes over the
+ * shared design tokens (`bg-card`, `border-border`, `text-muted-foreground`,
+ * `bg-primary`, …); glyphs are inline SVGs; no icon or UI library.
+ */
+
+interface SeatPaywallProps {
+    /** Human product name shown in the headline, e.g. "Creative". */
+    product: string;
+    /** Fired when the user clicks the unlock CTA — route them to checkout. */
+    onCheckout: () => void;
+    /** Monthly seat price in whole dollars. Default 100. */
+    priceUsd?: number;
+    /** Included monthly AI usage in whole dollars. Default 50. */
+    includedUsageUsd?: number;
+    /** Optional one-line value prop under the headline. */
+    tagline?: string;
+    /** CTA label. Default "Unlock {product}". */
+    ctaLabel?: string;
+}
+/**
+ * Centered card paywall. The price line reads
+ * "$100/mo · includes $50/mo of AI usage" so the included allowance anchors the
+ * value without ever exposing the ratio.
+ */
+declare function SeatPaywall({ product, onCheckout, priceUsd, includedUsageUsd, tagline, ctaLabel, }: SeatPaywallProps): ReactNode;
+
 interface ChatMessageMetrics {
     modelUsed?: string;
     promptTokens?: number;
@@ -317,4 +353,4 @@ type ToolDetailRenderers = Record<string, (call: ChatToolCallInfo, message: Chat
  */
 declare function ChatMessages({ messages, models, renderMarkdown, renderExtras, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, }: ChatMessagesProps): react.JSX.Element;
 
-export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, type ChatMessageMetrics, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, type SmoothRevealOptions, type StreamChatOptions, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type WaterfallRow, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, useSmoothText, waterfallLayout };
+export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, type ChatMessageMetrics, ChatMessages, type ChatMessagesProps, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ConsumeChatStreamResult, EffortPicker, type EffortPickerProps, FlowWaterfall, type FlowWaterfallProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProviderLogo, type ProviderLogoProps, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SmoothRevealOptions, type StreamChatOptions, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type WaterfallRow, activityTone, consumeChatStream, dispatchChatStreamLine, formatActivityCost, formatActivityDuration, formatModelCost, formatTokensPerSecond, mergeActivityPages, nextRevealCount, pendingApprovalOf, streamChatTurn, useSmoothText, waterfallLayout };