@promptbook/remote-client 0.112.0 → 0.113.0-1

package/umd/src/_packages/core.index.d.ts

@@ -1,4 +1,15 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { AGENT_VISIBILITY_VALUES } from '../book-2.0/agent-source/agentSourceVisibility';
+import type { AgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { DEFAULT_AGENT_VISIBILITY } from '../book-2.0/agent-source/agentSourceVisibility';
+import { isAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { normalizeAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { parseAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { parseAgentVisibilityStrict } from '../book-2.0/agent-source/agentSourceVisibility';
+import { parseAgentSourceVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { isPublicAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { getNextAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { setAgentSourceVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
 import { computeAgentHash } from '../book-2.0/agent-source/computeAgentHash';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
 import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
@@ -224,6 +235,17 @@ import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerpla
 import { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES } from '../../servers';
 import { PUBLIC_AGENTS_SERVERS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { AGENT_VISIBILITY_VALUES };
+export type { AgentVisibility };
+export { DEFAULT_AGENT_VISIBILITY };
+export { isAgentVisibility };
+export { normalizeAgentVisibility };
+export { parseAgentVisibility };
+export { parseAgentVisibilityStrict };
+export { parseAgentSourceVisibility };
+export { isPublicAgentVisibility };
+export { getNextAgentVisibility };
+export { setAgentSourceVisibility };
 export { computeAgentHash };
 export { createAgentModelRequirements };
 export type { CreateAgentModelRequirementsOptions };

package/umd/src/_packages/types.index.d.ts

@@ -2,6 +2,7 @@ import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformati
 import type { AgentCapability } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentModelRequirements } from '../book-2.0/agent-source/AgentModelRequirements';
+import type { AgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
 import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { BookNodeAgentSource } from '../book-3.0/BookNodeAgentSource';
@@ -444,6 +445,7 @@ export type { BookParameter };
 export type { AgentCapability };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
+export type { AgentVisibility };
 export type { CreateAgentModelRequirementsOptions };
 export type { string_book };
 export type { BookNodeAgentSource };

package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -4,6 +4,7 @@ import type { string_agent_url } from '../../types/string_agent_url';
 import type { string_fonts } from '../../types/string_markdown';
 import type { string_color } from '../../types/string_person_fullname';
 import type { string_url_image } from '../../types/string_url_image';
+import type { AgentVisibility } from './agentSourceVisibility';
 /**
  * Unified parameter representation that supports two different notations:
  * 1. @Parameter - single word parameter starting with @
@@ -97,6 +98,7 @@ export type AgentBasicInformation = {
         font?: string_fonts;
         color?: string_color;
         voice?: string;
+        visibility?: AgentVisibility;
         [key: string]: string | undefined;
     };
     /**

package/umd/src/book-2.0/agent-source/agentSourceVisibility.d.ts

@@ -0,0 +1,97 @@
+import type { string_book } from './string_book';
+/**
+ * Supported visibility states for persisted agents.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AGENT_VISIBILITY_VALUES: readonly ["PRIVATE", "UNLISTED", "PUBLIC"];
+/**
+ * Canonical visibility union for agents.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type AgentVisibility = (typeof AGENT_VISIBILITY_VALUES)[number];
+/**
+ * Fallback visibility used when no valid value is configured.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_AGENT_VISIBILITY: AgentVisibility;
+/**
+ * Returns `true` when the value is one of supported visibility states.
+ *
+ * @param value - Raw value to validate.
+ * @returns Whether the value is a valid `AgentVisibility`.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isAgentVisibility(value: unknown): value is AgentVisibility;
+/**
+ * Normalizes raw visibility text into a supported value.
+ *
+ * @param value - Raw visibility value.
+ * @returns Normalized visibility, or `null` when invalid.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function normalizeAgentVisibility(value: unknown): AgentVisibility | null;
+/**
+ * Parses visibility from an unknown value with a safe fallback.
+ *
+ * @param value - Raw visibility value.
+ * @param fallback - Fallback when the value is invalid.
+ * @returns Parsed visibility.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseAgentVisibility(value: unknown, fallback?: AgentVisibility): AgentVisibility;
+/**
+ * Parses visibility and throws when the value is not supported.
+ *
+ * @param value - Raw visibility value.
+ * @param sourceLabel - Human-readable source used in the error message.
+ * @returns Parsed visibility.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseAgentVisibilityStrict(value: unknown, sourceLabel?: string): AgentVisibility;
+/**
+ * Extracts the last `META VISIBILITY` value from an agent source.
+ *
+ * @param agentSource - Raw book source.
+ * @param options - Strict parsing options.
+ * @returns Normalized visibility, or `null` when no commitment is present.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseAgentSourceVisibility(agentSource: string_book, options?: {
+    readonly isStrict?: boolean;
+}): AgentVisibility | null;
+/**
+ * Returns whether an agent should be listed publicly in anonymous views.
+ *
+ * @param visibility - Agent visibility to evaluate.
+ * @returns `true` for publicly listed agents.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isPublicAgentVisibility(visibility: AgentVisibility | null | undefined): boolean;
+/**
+ * Returns the next visibility in UI rotation order.
+ *
+ * @param visibility - Current visibility.
+ * @returns Next visibility value.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getNextAgentVisibility(visibility: AgentVisibility | null | undefined): AgentVisibility;
+/**
+ * Inserts or replaces the `META VISIBILITY` commitment in a book source.
+ *
+ * @param agentSource - Raw book source.
+ * @param visibility - Visibility to persist.
+ * @returns Source with exactly one normalized `META VISIBILITY` line.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function setAgentSourceVisibility(agentSource: string_book, visibility: AgentVisibility): string_book;

package/umd/src/book-2.0/agent-source/agentSourceVisibility.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts

@@ -19,6 +19,7 @@ export declare const BookEditorMonacoTokenization: {
     AGENT_URL_REFERENCE_REGEX: RegExp;
     AGENT_REFERENCE_TOKEN_REGEX: RegExp;
     AGENT_REFERENCE_BRACED_REGEX: RegExp;
+    NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX: RegExp;
     AGENT_REFERENCE_HIGHLIGHT_REGEXES: readonly [RegExp, RegExp, RegExp];
     extractAgentReferenceValue: (token: string) => string;
     resolveAgentReferenceToUrl: (referenceValue: string) => string | null;

package/umd/src/book-components/Chat/Chat/CitationIframePreview.d.ts

@@ -9,8 +9,8 @@ export type CitationIframePreviewProps = {
 };
 /**
  * Renders a citation URL preview as an iframe when the target page allows embedding,
- * or falls back to a server-side screenshot with an "Open in new tab" link when it
- * does not (e.g. X-Frame-Options: DENY / SAMEORIGIN).
+ * or falls back to a live server-side browser preview with an "Open in new tab" link
+ * when it does not (e.g. X-Frame-Options: DENY / SAMEORIGIN).
  *
  * Embedding capability is determined by `GET /api/page-preview/check?url=<url>`.
  * If that endpoint is unavailable the component falls back to the iframe directly.

package/umd/src/book-components/Chat/utils/livePagePreviewConstants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Width of the browser viewport used for live knowledge previews.
+ *
+ * @private shared constant of Agents Server knowledge previews
+ */
+export declare const LIVE_PAGE_PREVIEW_VIEWPORT_WIDTH = 1280;
+/**
+ * Height of the browser viewport used for live knowledge previews.
+ *
+ * @private shared constant of Agents Server knowledge previews
+ */
+export declare const LIVE_PAGE_PREVIEW_VIEWPORT_HEIGHT = 800;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer.d.ts

@@ -6,6 +6,12 @@
  * @private internal constant of `ptbk agents-server`
  */
 export declare const PTBK_AGENTS_SERVER_NODE_MODULES_PATH_ENV = "PTBK_AGENTS_SERVER_NODE_MODULES_PATH";
+/**
+ * Environment variable consumed by `apps/agents-server/next.config.ts` to throttle build workers.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+export declare const PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV = "PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT";
 /**
  * Environment variable used only by the CLI-owned production build.
  *

package/umd/src/collection/agent-collection/CreateAgentInput.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import { type AgentVisibility } from '../../book-2.0/agent-source/agentSourceVisibility';
 import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
 /**
  * Supported visibility options for agent creation.
@@ -11,7 +12,7 @@ export declare const CREATE_AGENT_VISIBILITY_VALUES: readonly ["PRIVATE", "UNLIS
  *
  * @private shared create-agent contract
  */
-export type CreateAgentVisibility = (typeof CREATE_AGENT_VISIBILITY_VALUES)[number];
+export type CreateAgentVisibility = AgentVisibility;
 /**
  * Canonical input payload for creating one persisted agent entity.
  *

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts

@@ -1,6 +1,22 @@
 import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import { type AgentVisibility } from '../../../../book-2.0/agent-source/agentSourceVisibility';
 import type { string_book } from '../../../../book-2.0/agent-source/string_book';
 import type { string_agent_permanent_id } from '../../../../types/string_agent_name';
+/**
+ * Options used while preparing a source for persistence.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type PrepareAgentSourceForPersistenceOptions = {
+    /**
+     * Visibility value that should be written into the book when present.
+     */
+    readonly visibility?: AgentVisibility | null;
+    /**
+     * Whether `visibility` should replace an existing `META VISIBILITY` commitment.
+     */
+    readonly isVisibilityOverride?: boolean;
+};
 /**
  * Prepared agent source payload ready for database persistence.
  *
@@ -22,6 +38,10 @@ export type PreparedAgentSourceForPersistence = {
      * Permanent id extracted from the original source before stripping `META ID`.
      */
     readonly permanentId: string_agent_permanent_id | undefined;
+    /**
+     * Visibility parsed from the normalized source.
+     */
+    readonly visibility: AgentVisibility | undefined;
 };
 /**
  * Normalizes one agent source before persistence.
@@ -33,4 +53,4 @@ export type PreparedAgentSourceForPersistence = {
  *
  * @private shared persistence helper for `AgentCollectionInSupabase`
  */
-export declare function prepareAgentSourceForPersistence(agentSource: string_book): PreparedAgentSourceForPersistence;
+export declare function prepareAgentSourceForPersistence(agentSource: string_book, options?: PrepareAgentSourceForPersistenceOptions): PreparedAgentSourceForPersistence;

package/umd/src/commitments/META_VISIBILITY/META_VISIBILITY.d.ts

@@ -0,0 +1,27 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META VISIBILITY commitment definition.
+ *
+ * The `META VISIBILITY` commitment stores whether an agent is public, private, or unlisted.
+ * Agents Server mirrors this value into the database for efficient filtering, but the book
+ * commitment remains the editable source of truth.
+ *
+ * @private Metadata-only commitment used by Agents Server.
+ */
+export declare class MetaVisibilityCommitmentDefinition extends BaseCommitmentDefinition<'META VISIBILITY'> {
+    constructor();
+    /**
+     * Short one-line description of META VISIBILITY.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META VISIBILITY commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

package/umd/src/commitments/index.d.ts

@@ -25,6 +25,7 @@ import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
 import { MetaInputPlaceholderCommitmentDefinition } from './META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER';
 import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { MetaVisibilityCommitmentDefinition } from './META_VISIBILITY/META_VISIBILITY';
 import { MetaVoiceCommitmentDefinition } from './META_VOICE/META_VOICE';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
 import { NoteCommitmentDefinition } from './NOTE/NOTE';
@@ -61,4 +62,4 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-140`).
+ * It follows semantic versioning (e.g., `0.113.0-0`).
  *
  * @generated
  */