@agentlang/agentmanager 0.0.3

package/libs/agentcraft/src/errors/domain.error.ts

@@ -0,0 +1,14 @@
+export { DomainError } from '@app/project-provider';
+import { DomainError } from '@app/project-provider';
+
+export class SessionNotFoundError extends DomainError {
+  constructor() {
+    super('Session not found', 404);
+  }
+}
+
+export class InvalidSessionStateError extends DomainError {
+  constructor(message: string) {
+    super(message, 409);
+  }
+}

package/libs/agentcraft/src/errors/llm.errors.d.ts

@@ -0,0 +1,10 @@
+import { DomainError } from './domain.error';
+export declare class LlmError extends DomainError {
+  constructor(message: string, statusCode?: number);
+}
+export declare class LlmNotConfiguredError extends LlmError {
+  constructor();
+}
+export declare class LlmRequestFailedError extends LlmError {
+  constructor(message: string);
+}

package/libs/agentcraft/src/errors/llm.errors.js

@@ -0,0 +1,26 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.LlmRequestFailedError =
+  exports.LlmNotConfiguredError =
+  exports.LlmError =
+    void 0;
+const domain_error_1 = require('./domain.error');
+class LlmError extends domain_error_1.DomainError {
+  constructor(message, statusCode = 502) {
+    super(message, statusCode);
+  }
+}
+exports.LlmError = LlmError;
+class LlmNotConfiguredError extends LlmError {
+  constructor() {
+    super('LLM provider is not configured', 501);
+  }
+}
+exports.LlmNotConfiguredError = LlmNotConfiguredError;
+class LlmRequestFailedError extends LlmError {
+  constructor(message) {
+    super(message, 502);
+  }
+}
+exports.LlmRequestFailedError = LlmRequestFailedError;
+//# sourceMappingURL=llm.errors.js.map

package/libs/agentcraft/src/errors/llm.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.errors.js","sourceRoot":"","sources":["llm.errors.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAE7C,MAAa,QAAS,SAAQ,0BAAW;IACvC,YAAY,OAAe,EAAE,aAAqB,GAAG;QACnD,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7B,CAAC;CACF;AAJD,4BAIC;AAED,MAAa,qBAAsB,SAAQ,QAAQ;IACjD;QACE,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;CACF;AAJD,sDAIC;AAED,MAAa,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAJD,sDAIC"}

package/libs/agentcraft/src/errors/llm.errors.ts

@@ -0,0 +1,19 @@
+import { DomainError } from './domain.error';
+
+export class LlmError extends DomainError {
+  constructor(message: string, statusCode: number = 502) {
+    super(message, statusCode);
+  }
+}
+
+export class LlmNotConfiguredError extends LlmError {
+  constructor() {
+    super('LLM provider is not configured', 501);
+  }
+}
+
+export class LlmRequestFailedError extends LlmError {
+  constructor(message: string) {
+    super(message, 502);
+  }
+}

package/libs/agentcraft/src/index.d.ts

@@ -0,0 +1,64 @@
+export { AgentcraftModule } from './agentcraft.module';
+export type { LlmConfig } from './agentcraft.module';
+export { LLM_PROVIDER, CRAFT_LLM_PROVIDER } from './constants';
+export type {
+  LlmRequest,
+  LlmResponse,
+  ChatMessage,
+  ContentBlock,
+  ChatRequest,
+  ChatResponse,
+} from './types/llm.types';
+export type { Signal, SignalKind, SignalPriority } from './types/signal.types';
+export {
+  PipelineStep,
+  ReviewAction,
+  TestFailureAction,
+} from './types/pipeline.types';
+export type {
+  StepDefinition,
+  ConversationMessage,
+  PipelineState,
+  CraftConfig,
+} from './types/pipeline.types';
+export type {
+  RegistryEntry,
+  RegistrySearchResult,
+} from './types/resolver.types';
+export type {
+  LlmProvider,
+  CraftLlmProvider,
+} from './interfaces/llm-provider.interface';
+export { AnthropicLlmService } from './services/anthropic-llm.service';
+export { OpenaiLlmService } from './services/openai-llm.service';
+export { CraftLlmAdapterService } from './services/craft-llm-adapter.service';
+export { ArchitectLoopFactory } from './services/architect-loop.service';
+export type {
+  ArchitectLoop,
+  ArchitectLoopConfig,
+} from './services/architect-loop.service';
+export {
+  PipelineStepsService,
+  STEP_DEFINITIONS,
+} from './services/pipeline-steps.service';
+export { PipelineStateService } from './services/pipeline-state.service';
+export { OutputParserService } from './services/output-parser.service';
+export type { ParsedFile } from './services/output-parser.service';
+export { CraftConfigService } from './services/craft-config.service';
+export {
+  ApiAdapterService,
+  ApiAdapterFactory,
+} from './services/api-adapter.service';
+export type { SSEEvent, WaitingFor } from './services/api-adapter.service';
+export { SpecFetcherService } from './services/spec-fetcher.service';
+export { RegistryClientService } from './services/registry-client.service';
+export {
+  DomainError,
+  SessionNotFoundError,
+  InvalidSessionStateError,
+} from './errors/domain.error';
+export {
+  LlmError,
+  LlmNotConfiguredError,
+  LlmRequestFailedError,
+} from './errors/llm.errors';

package/libs/agentcraft/src/index.js

@@ -0,0 +1,195 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.LlmRequestFailedError =
+  exports.LlmNotConfiguredError =
+  exports.LlmError =
+  exports.InvalidSessionStateError =
+  exports.SessionNotFoundError =
+  exports.DomainError =
+  exports.RegistryClientService =
+  exports.SpecFetcherService =
+  exports.ApiAdapterFactory =
+  exports.ApiAdapterService =
+  exports.CraftConfigService =
+  exports.OutputParserService =
+  exports.PipelineStateService =
+  exports.STEP_DEFINITIONS =
+  exports.PipelineStepsService =
+  exports.ArchitectLoopFactory =
+  exports.CraftLlmAdapterService =
+  exports.OpenaiLlmService =
+  exports.AnthropicLlmService =
+  exports.TestFailureAction =
+  exports.ReviewAction =
+  exports.PipelineStep =
+  exports.CRAFT_LLM_PROVIDER =
+  exports.LLM_PROVIDER =
+  exports.AgentcraftModule =
+    void 0;
+var agentcraft_module_1 = require('./agentcraft.module');
+Object.defineProperty(exports, 'AgentcraftModule', {
+  enumerable: true,
+  get: function () {
+    return agentcraft_module_1.AgentcraftModule;
+  },
+});
+var constants_1 = require('./constants');
+Object.defineProperty(exports, 'LLM_PROVIDER', {
+  enumerable: true,
+  get: function () {
+    return constants_1.LLM_PROVIDER;
+  },
+});
+Object.defineProperty(exports, 'CRAFT_LLM_PROVIDER', {
+  enumerable: true,
+  get: function () {
+    return constants_1.CRAFT_LLM_PROVIDER;
+  },
+});
+var pipeline_types_1 = require('./types/pipeline.types');
+Object.defineProperty(exports, 'PipelineStep', {
+  enumerable: true,
+  get: function () {
+    return pipeline_types_1.PipelineStep;
+  },
+});
+Object.defineProperty(exports, 'ReviewAction', {
+  enumerable: true,
+  get: function () {
+    return pipeline_types_1.ReviewAction;
+  },
+});
+Object.defineProperty(exports, 'TestFailureAction', {
+  enumerable: true,
+  get: function () {
+    return pipeline_types_1.TestFailureAction;
+  },
+});
+var anthropic_llm_service_1 = require('./services/anthropic-llm.service');
+Object.defineProperty(exports, 'AnthropicLlmService', {
+  enumerable: true,
+  get: function () {
+    return anthropic_llm_service_1.AnthropicLlmService;
+  },
+});
+var openai_llm_service_1 = require('./services/openai-llm.service');
+Object.defineProperty(exports, 'OpenaiLlmService', {
+  enumerable: true,
+  get: function () {
+    return openai_llm_service_1.OpenaiLlmService;
+  },
+});
+var craft_llm_adapter_service_1 = require('./services/craft-llm-adapter.service');
+Object.defineProperty(exports, 'CraftLlmAdapterService', {
+  enumerable: true,
+  get: function () {
+    return craft_llm_adapter_service_1.CraftLlmAdapterService;
+  },
+});
+var architect_loop_service_1 = require('./services/architect-loop.service');
+Object.defineProperty(exports, 'ArchitectLoopFactory', {
+  enumerable: true,
+  get: function () {
+    return architect_loop_service_1.ArchitectLoopFactory;
+  },
+});
+var pipeline_steps_service_1 = require('./services/pipeline-steps.service');
+Object.defineProperty(exports, 'PipelineStepsService', {
+  enumerable: true,
+  get: function () {
+    return pipeline_steps_service_1.PipelineStepsService;
+  },
+});
+Object.defineProperty(exports, 'STEP_DEFINITIONS', {
+  enumerable: true,
+  get: function () {
+    return pipeline_steps_service_1.STEP_DEFINITIONS;
+  },
+});
+var pipeline_state_service_1 = require('./services/pipeline-state.service');
+Object.defineProperty(exports, 'PipelineStateService', {
+  enumerable: true,
+  get: function () {
+    return pipeline_state_service_1.PipelineStateService;
+  },
+});
+var output_parser_service_1 = require('./services/output-parser.service');
+Object.defineProperty(exports, 'OutputParserService', {
+  enumerable: true,
+  get: function () {
+    return output_parser_service_1.OutputParserService;
+  },
+});
+var craft_config_service_1 = require('./services/craft-config.service');
+Object.defineProperty(exports, 'CraftConfigService', {
+  enumerable: true,
+  get: function () {
+    return craft_config_service_1.CraftConfigService;
+  },
+});
+var api_adapter_service_1 = require('./services/api-adapter.service');
+Object.defineProperty(exports, 'ApiAdapterService', {
+  enumerable: true,
+  get: function () {
+    return api_adapter_service_1.ApiAdapterService;
+  },
+});
+Object.defineProperty(exports, 'ApiAdapterFactory', {
+  enumerable: true,
+  get: function () {
+    return api_adapter_service_1.ApiAdapterFactory;
+  },
+});
+var spec_fetcher_service_1 = require('./services/spec-fetcher.service');
+Object.defineProperty(exports, 'SpecFetcherService', {
+  enumerable: true,
+  get: function () {
+    return spec_fetcher_service_1.SpecFetcherService;
+  },
+});
+var registry_client_service_1 = require('./services/registry-client.service');
+Object.defineProperty(exports, 'RegistryClientService', {
+  enumerable: true,
+  get: function () {
+    return registry_client_service_1.RegistryClientService;
+  },
+});
+var domain_error_1 = require('./errors/domain.error');
+Object.defineProperty(exports, 'DomainError', {
+  enumerable: true,
+  get: function () {
+    return domain_error_1.DomainError;
+  },
+});
+Object.defineProperty(exports, 'SessionNotFoundError', {
+  enumerable: true,
+  get: function () {
+    return domain_error_1.SessionNotFoundError;
+  },
+});
+Object.defineProperty(exports, 'InvalidSessionStateError', {
+  enumerable: true,
+  get: function () {
+    return domain_error_1.InvalidSessionStateError;
+  },
+});
+var llm_errors_1 = require('./errors/llm.errors');
+Object.defineProperty(exports, 'LlmError', {
+  enumerable: true,
+  get: function () {
+    return llm_errors_1.LlmError;
+  },
+});
+Object.defineProperty(exports, 'LlmNotConfiguredError', {
+  enumerable: true,
+  get: function () {
+    return llm_errors_1.LlmNotConfiguredError;
+  },
+});
+Object.defineProperty(exports, 'LlmRequestFailedError', {
+  enumerable: true,
+  get: function () {
+    return llm_errors_1.LlmRequestFailedError;
+  },
+});
+//# sourceMappingURL=index.js.map

package/libs/agentcraft/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AACA,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AAIzB,yCAA+D;AAAtD,yGAAA,YAAY,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AAgBzC,yDAIgC;AAH9B,8GAAA,YAAY,OAAA;AACZ,8GAAA,YAAY,OAAA;AACZ,mHAAA,iBAAiB,OAAA;AAsBnB,0EAAuE;AAA9D,4HAAA,mBAAmB,OAAA;AAC5B,oEAAiE;AAAxD,sHAAA,gBAAgB,OAAA;AACzB,kFAA8E;AAArE,mIAAA,sBAAsB,OAAA;AAG/B,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAO7B,4EAG2C;AAFzC,8HAAA,oBAAoB,OAAA;AACpB,0HAAA,gBAAgB,OAAA;AAElB,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAC7B,0EAAuE;AAA9D,4HAAA,mBAAmB,OAAA;AAI5B,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAG3B,sEAGwC;AAFtC,wHAAA,iBAAiB,OAAA;AACjB,wHAAA,iBAAiB,OAAA;AAKnB,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAC3B,8EAA2E;AAAlE,gIAAA,qBAAqB,OAAA;AAG9B,sDAI+B;AAH7B,2GAAA,WAAW,OAAA;AACX,oHAAA,oBAAoB,OAAA;AACpB,wHAAA,wBAAwB,OAAA;AAE1B,kDAI6B;AAH3B,sGAAA,QAAQ,OAAA;AACR,mHAAA,qBAAqB,OAAA;AACrB,mHAAA,qBAAqB,OAAA"}

package/libs/agentcraft/src/index.ts

@@ -0,0 +1,171 @@
+// Module
+export { AgentcraftModule } from './agentcraft.module';
+export type { LlmConfig } from './agentcraft.module';
+
+// Constants
+export { LLM_PROVIDER, CRAFT_LLM_PROVIDER } from './constants';
+
+// Types — LLM
+export type {
+  LlmRequest,
+  LlmResponse,
+  ChatMessage,
+  ContentBlock,
+  ChatRequest,
+  ChatResponse,
+  ToolDefinition,
+  ToolCall,
+} from './types/llm.types';
+
+// Types — Signal
+export type { Signal, SignalKind, SignalPriority } from './types/signal.types';
+
+// Types — Pipeline
+export {
+  PipelineStep,
+  ReviewAction,
+  TestFailureAction,
+} from './types/pipeline.types';
+export type {
+  StepDefinition,
+  ConversationMessage,
+  PipelineState,
+  CraftConfig,
+} from './types/pipeline.types';
+
+// Types — Resolver
+export type {
+  RegistryEntry,
+  RegistrySearchResult,
+} from './types/resolver.types';
+
+// Types — Autonomous
+export type {
+  PlanStepKind,
+  AutonomousMode,
+  ResolverDirective,
+  PlanStep,
+  Plan,
+  StepResult,
+  ExecutionContext,
+  AutonomousRunConfig,
+  ExecutorCallbacks,
+} from './types/autonomous.types';
+
+// Types — Architect
+export type {
+  SubAppDefinition,
+  DecompositionResult,
+  AppRequirements,
+  RequirementsResult,
+  FeatureAnnotation,
+  EntitySpec,
+  RelationshipSpec,
+  WorkflowSpec,
+  EventSpec,
+  AgentSpec,
+  AppSpec,
+  DesignResult,
+  WidgetBlueprint,
+  PageBlueprint,
+  NavigationItem,
+  NavigationGroup,
+  UIBlueprint,
+  GeneratedSources,
+  KBChangeEvent,
+  WatcherOptions,
+} from './types/architect.types';
+
+// Interfaces
+export type {
+  LlmProvider,
+  CraftLlmProvider,
+} from './interfaces/llm-provider.interface';
+
+// Services — LLM
+export { AnthropicLlmService } from './services/anthropic-llm.service';
+export { OpenaiLlmService } from './services/openai-llm.service';
+export { CraftLlmAdapterService } from './services/craft-llm-adapter.service';
+export { AnthropicCraftLlmService } from './services/anthropic-craft-llm.service';
+
+// Services — Architect
+export { ArchitectLoopFactory } from './services/architect-loop.service';
+export type {
+  ArchitectLoop,
+  ArchitectLoopConfig,
+} from './services/architect-loop.service';
+
+// Services — Architect Phases
+export { DecomposerService } from './services/decomposer.service';
+export { RequirementsGeneratorService } from './services/requirements-generator.service';
+export { DesignGeneratorService } from './services/design-generator.service';
+export { UIBlueprintGeneratorService } from './services/ui-blueprint-generator.service';
+export { ReadmeGeneratorService } from './services/readme-generator.service';
+export { KbWatcherService } from './services/kb-watcher.service';
+
+// Services — Autonomous
+export { PlannerService } from './services/planner.service';
+export { ExecutorService } from './services/executor.service';
+export { AutonomousRunnerService } from './services/autonomous-runner.service';
+
+// Services — Pipeline
+export {
+  PipelineStepsService,
+  STEP_DEFINITIONS,
+} from './services/pipeline-steps.service';
+export { PipelineStateService } from './services/pipeline-state.service';
+export { OutputParserService } from './services/output-parser.service';
+export type { ParsedFile } from './services/output-parser.service';
+
+// Services — Config
+export { CraftConfigService } from './services/craft-config.service';
+
+// Services — IO Adapter
+export {
+  ApiAdapterService,
+  ApiAdapterFactory,
+} from './services/api-adapter.service';
+export type { SSEEvent, WaitingFor } from './services/api-adapter.service';
+
+// Services — Resolver
+export { SpecFetcherService } from './services/spec-fetcher.service';
+export { RegistryClientService } from './services/registry-client.service';
+
+// Utilities
+export { loadAllKBDocuments } from './utils/kb-loader';
+export {
+  normalizeGeneratedCode,
+  checkCommonErrors,
+  validateCode,
+  basicValidation,
+} from './utils/validator';
+export { parseAssemblyOutput, writeAppFiles } from './utils/output-writer';
+export { fetchSpec } from './utils/spec-fetcher';
+export { trimSpec } from './utils/spec-trimmer';
+export {
+  kebabToPascalCase,
+  pascalToKebabCase,
+  extractModuleName,
+  extractEntityNames,
+  stripModuleLine,
+} from './utils/text-utils';
+
+// DTOs
+export {
+  SubmitActionBaseSchema,
+  SubmitActionSchema,
+  SubmitActionDto,
+  SubmitResolverActionDto,
+} from './dto/submit-action.dto';
+
+// Errors
+export {
+  DomainError,
+  SessionNotFoundError,
+  InvalidSessionStateError,
+} from './errors/domain.error';
+export {
+  LlmError,
+  LlmNotConfiguredError,
+  LlmRequestFailedError,
+} from './errors/llm.errors';

package/libs/agentcraft/src/instructions/step6-data-model.ts

@@ -0,0 +1,181 @@
+export const step6DataModelInstructions = `You are the sixth agent in a pipeline that generates agentlang applications. Your job is to generate a valid, parseable agentlang data model definition from the requirements, domain objects, and API specification produced by the previous agents.
+
+## Input Context
+
+The requirements analysis:
+
+<file>requirementsAnalysis.md</file>
+
+The core domain objects:
+
+<file>coreObjects.md</file>
+
+The API specification:
+
+<file>apiSpec.md</file>
+
+## Resolver Context (if applicable)
+
+<file>?resolverMeta.md</file>
+
+If resolver metadata is shown above, a resolver module already handles these entities and their CRUD bindings. In the core module:
+- Do NOT redefine resolver entities (they already exist in the resolver module)
+- Do NOT write \`resolver\` blocks — the resolver module already defines all resolver bindings with the correct import aliases
+- You MAY reference resolver entities in relationships and workflows using fully-qualified names (e.g. \`Resolvers.Petstore/Pet\`)
+
+## Your Role
+
+You translate the identified domain objects and their relationships into a syntactically valid agentlang module definition. Your output will be **automatically validated by the agentlang parser**. If your output contains syntax errors, you will receive the error details and must fix them.
+
+## CRITICAL: Output Requirements
+
+Your response must contain ONLY a valid agentlang module definition. Do not include any explanatory text, markdown formatting, or code fences. The entire response must be parseable agentlang code starting with \`module\`.
+
+**IMPORTANT**: Your output is validated by the agentlang parser. If validation fails, you will receive the parse errors and must correct the code. Pay careful attention to syntax.
+
+## How to Respond
+
+### On the FIRST message:
+
+Generate the complete agentlang data model as a module definition. Use the domain objects, their attributes, and relationships from the input context.
+
+### On FOLLOW-UP messages:
+
+The user may request changes (add entities, modify attributes, change relationships). Regenerate the complete module with the requested changes. Always output the full module, not just the changed parts.
+
+### On VALIDATION FAILURE:
+
+If your output fails parsing, you will receive an error like:
+\`Validation for your last response failed with this result: {"status":"error","reason":"..."}\`
+
+Read the error carefully, identify the syntax issue, and output the corrected full module definition.
+
+## Agentlang Data Model Syntax
+
+### Module Declaration
+
+Every module starts with:
+\`\`\`
+module <AppName>.core
+\`\`\`
+
+### Entity Definition
+
+\`\`\`
+entity <EntityName> {
+    <attrName> <Type> [properties],
+    <attrName> <Type> [properties]
+}
+\`\`\`
+
+### Attribute Types
+
+Valid types: String, Int, Number, Decimal, Float, Email, Date, Time, DateTime, Boolean, UUID, URL, Password, Map, Any.
+Array types use the [] suffix: String[], Int[], etc.
+
+**IMPORTANT**: There is NO \`List\` type in agentlang. Always use typed arrays instead. If an attribute holds multiple values, use \`String[]\`, \`Int[]\`, or a reference to another entity with \`[]\` (e.g. \`Tag[]\` where Tag is a defined entity/record).
+
+### Attribute Properties
+
+- \`@id\` -- uniquely identifies an instance (required: every entity must have one)
+- \`@default(<value>)\` -- default value. Examples: \`@default(uuid())\`, \`@default(now())\`, \`@default(true)\`, \`@default(0)\`
+  - **UUID attributes MUST always include \`@default(uuid())\`**
+  - **DateTime attributes MUST always include \`@default(now())\`**
+- \`@optional\` -- value is not required
+- \`@unique\` -- value must be unique across all instances
+- \`@indexed\` -- optimize queries on this attribute
+- \`@enum("val1", "val2", ...)\` -- value must be one of the listed options
+- \`@ref(<Entity>)\` -- foreign key reference. **IMPORTANT**: \`@ref\` replaces the type — do NOT specify a type before \`@ref\`. Write \`attrName @ref(Entity)\`, NOT \`attrName UUID @ref(Entity)\`. Examples:
+  - \`authorId @ref(Author)\` — references the Author entity's @id field
+  - \`email @ref(Resource.resEmail) @optional\` — references a specific attribute
+  - \`petId @ref(Resolvers.Petstore/Pet)\` — references an entity in another module
+
+### Relationship Definition
+
+Two types of relationships:
+
+**Contains** (hierarchical parent-child):
+\`\`\`
+relationship <RelName> contains (<ParentEntity>, <ChildEntity>)
+\`\`\`
+
+**Between** (graph-like connections):
+\`\`\`
+relationship <RelName> between (<EntityA>, <EntityB>)
+relationship <RelName> between (<EntityA>, <EntityB>) @one_one
+relationship <RelName> between (<EntityA>, <EntityB>) @one_many
+\`\`\`
+Default between is many-to-many. Use @one_one or @one_many as needed.
+
+### Resolver Blocks — Do NOT Generate
+
+Do NOT write \`resolver\` blocks or resolver related \`import\` statements in this module. Resolver bindings are handled by a separate resolver generation step. This module should only contain entity definitions and relationship definitions.
+
+## Reserved Words — Do NOT Use as Names
+
+Agentlang reserves certain keywords. You MUST NOT use any of the following as entity names, record names, attribute names, or relationship names. If your domain has a concept that matches a reserved word, rename it (e.g. \`Event\` → \`CalendarEvent\`, \`Flow\` → \`AppFlow\`, \`Agent\` → \`AIAgent\`, \`import\` → \`importItem\`, \`delete\` → \`isDeleted\`, \`record\` → \`entry\`).
+
+**Definition keywords:** \`module\`, \`import\`, \`entity\`, \`event\`, \`record\`, \`relationship\`, \`workflow\`, \`agent\`, \`resolver\`, \`flow\`, \`decision\`, \`scenario\`, \`directive\`, \`glossaryEntry\`, \`eval\`
+
+**Control flow and operators:** \`if\`, \`else\`, \`for\`, \`in\`, \`return\`, \`throw\`, \`await\`, \`delete\`, \`purge\`, \`case\`, \`not\`, \`true\`, \`false\`, \`or\`, \`and\`, \`like\`, \`between\`
+
+**CRUD and schema keywords:** \`create\`, \`update\`, \`query\`, \`upsert\`, \`contains\`, \`extends\`, \`where\`, \`roles\`, \`allow\`, \`subscribe\`, \`backoff\`, \`attempts\`
+
+## Common Syntax Rules
+
+- **Attributes MUST be separated by commas**. The last attribute does NOT need a trailing comma. For example:
+
+  WRONG (missing commas):
+  \`\`\`
+  entity Category {
+      id   Int    @id
+      name String
+  }
+  \`\`\`
+
+  CORRECT:
+  \`\`\`
+  entity Category {
+      id   Int    @id,
+      name String
+  }
+  \`\`\`
+
+- **Structures with no attributes MUST be defined with \`{}\`**. For example: \`@public event getAllEmployees {}\`, \`record EmptyPayload {}\`. Never omit the braces.
+- Property annotations (@id, @optional, etc.) follow the type
+- Entity and relationship names must be valid identifiers (letters, digits, no spaces)
+- Module-qualified entity references use the format: \`ModuleName/EntityName\`
+- String literals use double quotes: "value"
+
+## Example
+
+For a Personal Finance Tracker app:
+
+module Finance.core
+
+entity Account {
+    id UUID @id @default(uuid()),
+    name String,
+    type @enum("bank", "cash", "credit"),
+    balance Decimal @default(0),
+    createdAt DateTime @default(now())
+}
+
+entity Transaction {
+    id UUID @id @default(uuid()),
+    accountId @ref(Account),
+    categoryId @ref(Category) @optional,
+    date DateTime @default(now()),
+    description String,
+    amount Decimal,
+    type @enum("income", "expense")
+}
+
+entity Category {
+    id UUID @id @default(uuid()),
+    name String @unique
+}
+
+relationship AccountTransaction between (Account, Transaction) @one_many
+relationship TransactionCategory between (Transaction, Category) @one_many
+`;