@promptbook/components 0.114.0-42 → 0.114.0-47

package/esm/src/cli/cli-commands/common/coderGitSyncCliOptions.d.ts

@@ -21,7 +21,7 @@ export declare const CODER_GIT_SYNC_DESCRIPTION: string;
  * Registers the shared `--commit`, `--auto-push` and `--auto-pull` flags on a `ptbk coder` command.
  *
  * Note: Unlike `ptbk coder run`, which commits by default and opts out through `--no-commit`,
- *       these commands never touch git unless the flags are used explicitly.
+ *       these commands only mutate Git when the flags are used explicitly. Workspace detection always runs.
  *
  * @private internal utility of `promptbookCli`
  */

package/esm/src/cli/cli-commands/common/resolveLocalAgentSource.d.ts

@@ -6,8 +6,12 @@ import type { string_book } from '../../../book-2.0/agent-source/string_book';
  * @private internal type of CLI agent resolution
  */
 export type ResolvedLocalAgentSource = {
+    /** Canonical identity used to bound recursive TEAM consultations. */
+    readonly agentUrl: string;
     readonly agentSource: string_book;
     readonly agentReferenceResolver: AgentReferenceResolver;
+    /** Resolves another Book in this collection, retaining its own inheritance and reference locations. */
+    readonly resolveAgentSource: (url: string, signal?: AbortSignal) => Promise<ResolvedLocalAgentSource>;
     /** Newly created books which the coder may include in its initialization commit. */
     readonly createdAgentBookPaths: ReadonlyArray<string>;
 };
@@ -16,4 +20,7 @@ export type ResolvedLocalAgentSource = {
  *
  * @private internal utility of CLI agent resolution
  */
-export declare function resolveLocalAgentSource(agentBookPath: string, currentWorkingDirectory: string): Promise<ResolvedLocalAgentSource>;
+export declare function resolveLocalAgentSource(agentBookPath: string, currentWorkingDirectory: string, options?: {
+    readonly isInitializationAllowed?: boolean;
+    readonly signal?: AbortSignal;
+}): Promise<ResolvedLocalAgentSource>;

package/esm/src/cli/cli-commands/common/validateCoderRunOptions.d.ts

@@ -0,0 +1,6 @@
+import type { RunOptions } from '../../../../scripts/run-codex-prompts/cli/RunOptions';
+/**
+ * Validates cross-flag constraints before workspace setup or the run starts.
+ * @private shared validation for Coder execution commands
+ */
+export declare function validateCoderRunOptions(options: RunOptions): void;

package/esm/src/cli/cli-commands/common/workspaceRepository.d.ts

@@ -0,0 +1,36 @@
+import type { NormalizedQuestionsCliOptions } from './questionsCliOptions';
+/**
+ * Resolved project directory and its enclosing working tree. Project artifacts belong to `projectPath`;
+ * Git paths and synchronization belong to `repositoryRoot`, which may be an enclosing monorepo.
+ *
+ * @private shared workspace context for Coder and workspace server commands
+ */
+export type WorkspaceRepositoryContext = {
+    readonly projectPath: string;
+    readonly repositoryRoot?: string;
+    readonly gitDirectory?: string;
+    readonly repositoryStatus: 'missing' | 'reused' | 'initialized';
+};
+/**
+ * Command policy is separate from discovery: previews never initialize; explicit init needs no confirmation.
+ *
+ * @private shared workspace policy for Coder and workspace server commands
+ */
+export type WorkspaceRepositoryPolicy = 'initialize' | 'mutate' | 'read-only';
+/**
+ * Resolves the requested project once and discovers Git using Git itself, without requiring `HEAD`.
+ * Broken metadata, bare repositories, ownership errors and unavailable Git are failures, not missing repositories.
+ *
+ * @private shared workspace discovery for CLI commands
+ */
+export declare function $resolveWorkspaceRepository(projectDirectory?: string): Promise<WorkspaceRepositoryContext>;
+/**
+ * Checks the shared prerequisite before any project writes, Git synchronization, installation or startup.
+ * Only an affirmative interactive answer or an explicit initializer authorizes `git init`.
+ *
+ * @private shared workspace preflight for Coder and workspace server commands
+ */
+export declare function $preflightWorkspaceRepository(options: {
+    readonly projectDirectory?: string;
+    readonly policy: WorkspaceRepositoryPolicy;
+} & Partial<NormalizedQuestionsCliOptions>): Promise<WorkspaceRepositoryContext>;

package/esm/src/cli/cli-commands/common/workspaceRepository.test.d.ts

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

package/esm/src/cli/cli-commands/common/workspaceRepositoryCliOptions.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+/**
+ * Shared explanation of the workspace prerequisite, independent of commit and synchronization settings.
+ * @private internal CLI help text
+ */
+export declare const WORKSPACE_REPOSITORY_DESCRIPTION: string;
+/**
+ * Adds shared Git help and the questions switch to every workspace command without duplicating existing options.
+ * @private internal registration helper for workspace CLI commands
+ */
+export declare function addWorkspaceRepositoryOptions(command: Command): void;

package/esm/src/commitments/TEAM/TEAM.test.d.ts

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

package/esm/src/conversion/archive/loadJsZipModule.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Loads the ZIP archive library (`jszip`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast
+ *
+ * @private internal utility of `loadArchive` and `saveArchive`
+ */
+export declare const loadJsZipModule: () => Promise<{
+    default: typeof import('jszip');
+}>;

package/esm/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.114.0-40`).
+ * It follows semantic versioning (e.g., `0.114.0-47`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/components",
-    "version": "0.114.0-42",
+    "version": "0.114.0-47",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -33,7 +33,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-42';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-47';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -13817,6 +13817,18 @@
 
             Registers teammate agents that the current agent can consult via tools.
 
+            The primary agent sends a question and relevant context to a teammate and receives an attributed answer.
+            Each teammate uses its own Book. Declaring a team makes advisers available when relevant; it does not
+            merge their rules into the primary agent or start every teammate automatically.
+
+            In \`ptbk coder run\` and \`ptbk coder plan\`, TEAM entries in the selected Book, its ancestors and imports
+            use the existing reference rules: \`@Name\`, \`{Agent Name}\`, \`{./lawyer.book}\`, project paths such as
+            \`{agents/lawyer.book}\`, and HTTP(S) Book URLs. Local advisers require no Agents Server. A remote Book
+            must be readable through its normal endpoint; private or inaccessible sources return errors.
+            Coding harnesses expose scoped command tools; planning uses restricted host tools and currently requires
+            OpenAI Codex. Planning restrictions apply to every adviser, including custom Developer Books.
+            The primary agent retains responsibility for the task, PRD proposals and final output.
+
             ## Examples
 
             \`\`\`book
@@ -13828,7 +13840,7 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
-            var _a, _b, _c;
+            var _a, _b, _c, _d;
             const trimmedContent = content.trim();
             if (!trimmedContent) {
                 return requirements;
@@ -13842,20 +13854,30 @@
             const existingTeammates = ((_b = requirements._metadata) === null || _b === void 0 ? void 0 : _b.teammates) || [];
             const preResolvedProfiles = (((_c = requirements._metadata) === null || _c === void 0 ? void 0 : _c.preResolvedTeammateProfiles) || {});
             const resolvedTeammates = resolveTeamTeammateLabels(trimmedContent, teammates);
+            const toolUrls = new Map(existingTeammates.map((teammate) => [teammate.toolName, teammate.url]));
             const teamEntries = resolvedTeammates.map((teammate) => {
                 const profile = preResolvedProfiles[teammate.url];
                 const resolvedLabel = (profile === null || profile === void 0 ? void 0 : profile.agentName) || teammate.label;
                 const existingTeammate = existingTeammates.find((entry) => entry.url === teammate.url);
+                const baseToolName = (existingTeammate === null || existingTeammate === void 0 ? void 0 : existingTeammate.toolName) || createTeamToolName(teammate.url, resolvedLabel);
+                let toolName = baseToolName;
+                let suffix = 1;
+                // Explicit paths can identify distinct Books with the same display name or normalized label.
+                while (toolUrls.has(toolName) && toolUrls.get(toolName) !== teammate.url) {
+                    toolName = `${baseToolName}_${++suffix}`;
+                }
+                toolUrls.set(toolName, teammate.url);
                 return {
-                    toolName: ((existingTeammate === null || existingTeammate === void 0 ? void 0 : existingTeammate.toolName) ||
-                        createTeamToolName(teammate.url, resolvedLabel)),
+                    toolName: toolName,
                     teammate: { ...teammate, label: resolvedLabel },
                     agentName,
                     description: (profile === null || profile === void 0 ? void 0 : profile.personaDescription) || null,
                 };
             });
-            for (const entry of teamEntries) {
-                registerTeamTool(entry);
+            if (!((_d = requirements._metadata) === null || _d === void 0 ? void 0 : _d.isTeamToolRegistrationDisabled)) {
+                for (const entry of teamEntries) {
+                    registerTeamTool(entry);
+                }
             }
             const existingTools = requirements.tools || [];
             const updatedTools = [...existingTools];
@@ -49812,9 +49834,15 @@
                 if (preResolvedTeammateProfiles[teammate.url]) {
                     continue;
                 }
-                const profile = await profileResolver.resolveTeammateProfile(teammate.url);
-                if (profile) {
-                    preResolvedTeammateProfiles[teammate.url] = profile;
+                try {
+                    const profile = await profileResolver.resolveTeammateProfile(teammate.url);
+                    if (profile) {
+                        preResolvedTeammateProfiles[teammate.url] = profile;
+                    }
+                }
+                catch (error) {
+                    // One inaccessible adviser must not erase the names and roles of other callable teammates.
+                    console.warn(`Failed to resolve TEAM profile for ${teammate.url}:`, error);
                 }
             }
             return {
@@ -50761,6 +50789,12 @@
         const parseResult = parseAgentSourceWithCommitments(agentSource);
         const filteredCommitments = filterCommitmentsForAgentModelRequirements(parseResult.commitments);
         let requirements = createInitialAgentModelRequirements(parseResult.agentName, modelName);
+        if (options === null || options === void 0 ? void 0 : options.isTeamToolRegistrationDisabled) {
+            requirements = {
+                ...requirements,
+                _metadata: { ...requirements._metadata, isTeamToolRegistrationDisabled: true },
+            };
+        }
         requirements = await applyCommitmentsToAgentModelRequirements(requirements, filteredCommitments, options);
         requirements = await augmentAgentModelRequirementsFromSource(requirements, parseResult, agentSource);
         requirements = await materializeInlineKnowledgeSources(requirements, options === null || options === void 0 ? void 0 : options.inlineKnowledgeSourceUploader);