Skip to content

feat(agent): concise interface schema prompts#1036

Open
samchon wants to merge 20 commits intomainfrom
feat/interface-schema-prompts
Open

feat(agent): concise interface schema prompts#1036
samchon wants to merge 20 commits intomainfrom
feat/interface-schema-prompts

Conversation

@samchon
Copy link
Member

@samchon samchon commented Feb 4, 2026

This pull request introduces improvements to the interface schema documentation and the orchestration history logic for interface reviews. The most significant changes include refining the required fields for self-signup operations, enhancing type safety for session context fields, and ensuring system prompts are included in the review history.

Interface Schema Documentation Improvements:

  • Removed the reference to IUser.ICreate from the list of request DTOs required for self-signup operations, clarifying that only ICustomer.IJoin applies.
  • Updated the ICustomer.IJoin interface to enforce URI formatting for href and referrer, and to specify that ip should be an IPv4 string or nullable, improving type safety and documentation clarity.

Orchestration History Enhancements:

  • Added import of AutoBeSystemPromptConstant to support standardized system prompts in orchestration histories.
  • Modified transformInterfaceSchemaReviewHistory to prepend a system message containing the interface schema prompt, ensuring consistent context for review histories.

@samchon samchon requested review from 8471919, Copilot and k08200 February 4, 2026 15:48
@samchon samchon self-assigned this Feb 4, 2026
@samchon samchon added the documentation Improvements or additions to documentation label Feb 4, 2026
@samchon samchon added this to WrtnLabs Feb 4, 2026
@samchon samchon added the enhancement New feature or request label Feb 4, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances interface schema documentation and orchestration logic with a focus on conciseness and type safety. The changes streamline agent prompts while adding stronger type constraints for session context fields.

Changes:

  • Condensed four agent prompt files (SECURITY_REVIEW, REFINE, PHANTOM_REVIEW, CONTENT_REVIEW) by 72-88%, improving maintainability while preserving core instructions
  • Added AutoBeSystemPromptConstant.INTERFACE_SCHEMA to review history to provide schema generation context to review agents
  • Enhanced type safety for session context fields with URI and IPv4 format constraints

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated no comments.

Show a summary per file
File Description
transformInterfaceSchemaReviewHistory.ts Added INTERFACE_SCHEMA system prompt as first message in review history to provide base context
INTERFACE_SCHEMA.md Updated session context field types with Format tags (uri, ipv4) and removed IUser.ICreate reference
INTERFACE_SCHEMA_SECURITY_REVIEW.md Condensed from 1064 to 150 lines (~86% reduction) while preserving essential security rules
INTERFACE_SCHEMA_REFINE.md Condensed from 1157 to 324 lines (~72% reduction) focusing on core enrichment patterns
INTERFACE_SCHEMA_PHANTOM_REVIEW.md Condensed from 954 to 167 lines (~82% reduction) keeping phantom detection logic
INTERFACE_SCHEMA_CONTENT_REVIEW.md Condensed from 1126 to 135 lines (~88% reduction) maintaining completeness checks

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@samchon samchon marked this pull request as ready for review February 5, 2026 09:56
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 33 out of 34 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

packages/agent/src/orchestrate/interface/orchestrateInterfaceSchemaRefine.ts:1

  • The error handler decrements completed instead of total. Based on the pattern in orchestrateInterfaceSchemaWrite.ts (line 80) and orchestrateInterfaceSchemaReview.ts (line 89), this should decrement total to maintain accurate progress tracking when a schema fails to refine.
import { IAgenticaController } from "@agentica/core";

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant